Need private packages and team management tools?Check out npm Teams »

This package has been deprecated

Author message:

move to @the-/db ( https://github.com/the-labo/the/tree/master/packages/db#readme )

the-db

11.0.11 • Public • Published

the-db

Build Status npm Version JS Standard

DB for the-framework

Installation

$ npm install the-db --save

Usage

Basic Usage

'use strict'
 
const {TheDB} = require('the-db')
const {
  TheResource,
  DataTypes: {STRING} 
= require('the-resource-base')
 
// Define a resource class
// See https://github.com/realglobe-Inc/clay-resource for more detail
class UserResource extends TheResource {
  // Convert entity attributes on inbound
  static inbound (attributes) {
    const digest = (password) => { /* ... */ }
    attributes.passwordHash = digest(attributes.password)
    return attributes
  }
 
  // Convert entity attributes on outbound
  static outbound (attributes) {
    delete attributes.password
    return attributes
  }
 
  // Resource policy
  // https://github.com/realglobe-Inc/clay-policy#usage
  static get policy () {
    return {
      username: {type: STRING},
      password: {type: STRING},
    }
  }
 
  // Create index to enable filter/sort with nested attributes
  static get indices () {
    return ['profile.name', 'profile.email']
  }
 
  // Enhance entity class
  static entityClass (ResourceEntity) {
    return class UserResourceEntity extends ResourceEntity {
      get fullName () {
        let {firstName, lastName} = this
        return [firstName, lastName].filter(Boolean).join(' ')
      }
    }
  }
 
  // Hook after entity create
  static onCreate (created) {
    console.log('Entity created:', created)
  }
 
  // Hook after entity update
  static onUpdate (updated) {
    console.log('Entity updated:', updated)
  }
 
  // Hook after entity destroy
  static onDestroyed (destroyed) {
    console.log('Entity destroyed:', destroyed)
  }
}
 
const db = new TheDB({
  dialect: 'sqlite', // Uses "clay-driver-sqlite" package
  storage: 'var/my-app.db' // File path to save
})
 
db.load(UserResource, 'User')
 
// Using defined database
 
async function tryExample () {
  // Use the connected resource
  const {User} = db.resources
  let user = await User.create({username: 'Black Fire', password: 'Super Cool'})
  /* ... */
}
 
tryExample().catch((err) => console.error(err))
 
 
 

Dialect Examples

env.dialect option decides where to store data with Clay-Driver.

'use strict'
 
const {TheDB} = require('the-db')
 
// Using sqlite
{
  const sqlite = new TheDB({
    dialect: 'sqlite', // Uses "clay-driver-sqlite" package
    storage: 'var/my-app.db' // File path to save
  })
}
 
// Using json
{
  const json = new TheDB({
    dialect: 'json', // Uses "clay-driver-json" package
    storage: 'var/my-app.json' // File path to save
  })
}
 
// Using mysql
{
  const mysql = TheDB({
    dialect: 'mysql', // Uses "clay-driver-mysql" package
    database: 'my-app',
    username: 'user01',
    password: 'xxxxxxxxxxx'
  })
}
 

Data migrations

'use strict'
 
const {TheDB} = require('the-db')
const {
  TheResource,
  DataTypes: {STRING, /*....*/},
} = require('the-resource-base')
 
class UserResource extends TheResource {
  /* ... */
}
 
const db = new TheDB({/* ... */})
 
db.load(UserResource, 'User')
 
// Using defined database
 
async function tryExample () {
 
  // Migration scripts
  const migrations = {
 
    // Called only if no migration has ever executed
    async 'none' (db) {
      const {User} = db.resources
 
      // Migration scripts
      await User.each(async (user) => {
        const {username} = user
        await user.update({name: username, username: null})
      })
      /* ... */
 
      await db.updateVersion('1.0.0') // Update to next version
    },
 
    async '1.0.0' (db) {
      /* ... */
      await db.updateVersion('1.0.1')
    }
  }
  await db.migrate(migrations)
}
 
tryExample().catch((err) => console.error(err))
 
 
 

API Guide

License

This software is released under the MIT License.

Links

Keywords

Install

npm i the-db

DownloadsWeekly Downloads

16

Version

11.0.11

License

MIT

Unpacked Size

681 kB

Total Files

133

Last publish

Collaborators

  • avatar
  • avatar