Macroable

> Extend class prototype in style 😎

[![gh-workflow-image]][gh-workflow-url] [![typescript-image]][typescript-url] [![npm-image]][npm-url] [![license-image]][license-url] [![synk-image]][synk-url]

Base class for exposing external API to extend the class prototype in a more declarative way.

Table of contents

- Traditional approach
- Using macroable
- Defining singleton getters
- Hydrating the class

Traditional approach

``js
class Foo {}
module.exports = Foo
`

Someone can extend it follows.

`js
const Foo = require('./Foo')
Foo.prototype.greet = function () {
return 'Hello!'
}

// or add getter as follow
Object.defineProperty(Foo.prototype, 'username', {
get: function () {
return 'virk'
},
})
`

Using macroable

`ts
import { Macroable } from 'macroable'

class Foo extends Macroable {}

Foo.macros = {}
Foo.getters = {}

export default Foo
`

`ts
import Foo from './Foo'

Foo.macro('greet', function () {
return 'Hello!'
})

Foo.getter('username', function () {
return 'virk'
})
`

You can see the API is simpler and less verbose. However, there are couple of extra benefits of using Macroable.

$3

Singleton getters are evaluated only once and then cached value is returned.

`js
Foo.getter('baseUrl', function () {
return lazilyEvaluateAndReturnUrl()
}, true) 👈
`

$3

Using the hydrate method, you can remove macros and getters added on a given class.

`js
Foo.macro('greet', function (name) {
return Hello ${name}!
})

Foo.getter('username', function () {
return 'virk'
})

Foo.hydrate() 👈
Foo.greet // undefined
Foo.username // undefined
``

[gh-workflow-image]: https://img.shields.io/github/workflow/status/poppinss/macroable/test?style=for-the-badge
[gh-workflow-url]: https://github.com/poppinss/macroable/actions/workflows/test.yml "Github action"

[typescript-image]: https://img.shields.io/badge/Typescript-294E80.svg?style=for-the-badge&logo=typescript
[typescript-url]: "typescript"

[npm-image]: https://img.shields.io/npm/v/macroable.svg?style=for-the-badge&logo=npm
[npm-url]: https://npmjs.org/package/macroable 'npm'

[license-image]: https://img.shields.io/npm/l/macroable?color=blueviolet&style=for-the-badge
[license-url]: LICENSE.md 'license'

[synk-image]: https://img.shields.io/snyk/vulnerabilities/github/poppinss/manager?label=Synk%20Vulnerabilities&style=for-the-badge
[synk-url]: https://snyk.io/test/github/poppinss/manager?targetFile=package.json "synk"