seegno/objection-guid

Automatic guid for Objection.js

Automatic guid for Objection.js

This plugin adds an automatic guid to your Objection.js models using the uuid package for guid generation.

Installation

NPM

npm i objection-guid

Yarn

yarn add objection-guid

Usage

Generate guid

// Import the plugin.
const guid = require('objection-guid')();
const Model = require('objection').Model;

// Mixin the plugin.
class Item extends guid(Model) {
  static get tableName() {
    return 'Item';
  }
}

const item = await Item.query().insert({
  name: 'foo'
});

console.log(item.id);
// bbbe64b0-61a3-11e7-879a-67bb027591aa

Custom values

If your model already has a value for the configured field, the value is not overwritten.

Options

field: Overrides the default field name of the generated guid. (Default: id)

generateGuid: Overrides the default function that generates a guid. This function can be a promise. (Default: generates UUIDs v4)

These options can be provided when instantiating the plugin:

const guid = require('objection-guid')({
  field: 'foo',
  generateGuid: () => 'bar'
});

Tests

Run the tests from the root directory:

npm test

You can find Jest documentation here.

Contributing & Development

Contributing

Found a bug or want to suggest something? Take a look first on the current and closed issues. If it is something new, please submit an issue.

Develop

It will be awesome if you can help us evolve objection-guid. Want to help?

1. Fork it.
2. npm install.
3. Hack away.
4. Run the tests: npm test.
5. Create a Pull Request.

objection-guid's Issues

Model extension should be anonymous

Hi!

First of all, thank you for building this plugin for objection. Having a collection of good quality plugins such as this one for the most common problems will do a lot of good for the objection ecosystem.

Objection changed its best practices regarding the name of the extending class returned from the mixin function. The class should not have a name. The reason for this change is explained in this issue.

Please consider updating your plugin to follow the updated practices.

$beforeInsert(co...<omitted>... } is not a constructor or null

I'm getting this error ($beforeInsert(co...... } is not a constructor or null) when using objection-guid in my project, it's still happening even if i add $beforeInsert in the model

is it bug?

TypeScript types declaration file

This npm package needs a TypeScript types declaration file so that developers who enjoy writing with TS can use it with this package and have a better development experience. Would you like me to write one?

Conflict with models that already define `$beforeInsert()`

If the model already has a $beforeInsert() method, the UUID isn't applied to the model.

I suppose this could be fixed with some crafty duck punching?