dobo 2.30.7 → 2.32.0

package/docs/static/home.md

@@ -1,6 +1,8 @@
 ![Dobo DBMS](static/logo.png)
 
-### Dobo Database Management System for [Bajo](https://github.com/ardhi/bajo)
+### Dobo DBMS Framework for [Bajo](https://github.com/ardhi/bajo)
+
+The database management system (DBMS) for Bajo Framework. It provides a simple and easy-to-use interface for managing databases, tables, and records. It supports multiple database engines and can be easily extended to support new ones.
 
 ## Hire Me
 

package/extend/bajo/hook-docs.js

@@ -0,0 +1,238 @@
+/**
+ * Available hooks for Dobo's operations. You can use these hooks to customize the behavior of the model's CRUD operations.
+ *
+ * For any of the hooks below, you can also use the `modelName` in camelCase format to create a model-specific hook. If you
+ * choose to use this format, you must omit the first parameter (`model`) so that the hook function handler syntax will become like this:
+ *
+ * ```js
+ * dobo.{modelName}:beforeCreateRecord (body, options)
+ * dobo.{modelName}:afterCreateRecord (body, options)
+ * dobo.{modelName}:beforeFindRecord (filter, options)
+ * dobo.{modelName}:afterFindRecord (filter, result, options)
+ * ...
+ * ```
+ *
+ * You can use both formats simultaneously if you want. In that case, they will be executed in this order:
+ * ```js
+ * dobo:beforeCreateRecord (model, body, options)
+ * dobo.{modelName}:beforeCreateRecord (body, options)
+ * ...
+ * dobo.{modelName}:afterCreateRecord (body, result, options)
+ * dobo:afterCreateRecord (model, body, result, options)
+ * ```
+ *
+ * For both formats, there are their counterparts that run deep inside the adapter.
+ * Only use these hooks if you know what you are doing.
+ *
+ * Their syntax is similar to the above, with one exception: you need to put suffix `.adapter` after `dobo`:
+ *
+ * ```js
+ * dobo.adapter:beforeAdapterCreateRecord (model, body, options)
+ * dobo.adapter.{modelName}:beforeAdapterCreateRecord (body, options)
+ * ```
+ * @module Hook
+ */
+/**
+ * Hook that is called before creating a record.
+ *
+ * @memberof module:Hook
+ * @method
+ * @async
+ * @name dobo:beforeCreateRecord
+ * @param {DoboModel} model - The model instance
+ * @param {object} body - The body payload to be created
+ * @param {DoboModel.TOptions} options - The options object
+ */
+
+/**
+ * Hook that is called after creating a record.
+ *
+ * @memberof module:Hook
+ * @method
+ * @async
+ * @name dobo:afterCreateRecord
+ * @param {DoboModel} model - The model instance
+ * @param {object} body - The body payload to be created
+ * @param {DoboModel.TResultRecord} result - The result of the create operation
+ * @param {DoboModel.TOptions} options - The options object
+ */
+
+/**
+ * Hook that is called before finding records.
+ *
+ * @memberof module:Hook
+ * @method
+ * @async
+ * @name dobo:beforeFindRecord
+ * @param {DoboModel} model - The model instance
+ * @param {DoboModel.TFilter} filter - The filter criteria to apply when finding records
+ * @param {DoboModel.TOptions} options - The options object
+ */
+
+/**
+ * Hook that is called after finding records.
+ *
+ * @memberof module:Hook
+ * @method
+ * @async
+ * @name dobo:afterFindRecord
+ * @param {DoboModel} model - The model instance
+ * @param {DoboModel.TFilter} filter - The filter criteria applied when finding records
+ * @param {DoboModel.TResultFindRecord} result - The result of the find operation
+ * @param {DoboModel.TOptions} options - The options object
+ */
+
+/**
+ * Hook that is called before finding one record.
+ *
+ * @memberof module:Hook
+ * @method
+ * @async
+ * @name dobo:beforeFindOneRecord
+ * @param {DoboModel} model - The model instance
+ * @param {DoboModel.TFilter} filter - The filter criteria to apply when finding one record
+ * @param {DoboModel.TResultFindRecord} result - The result of the find operation
+ * @param {DoboModel.TOptions} options - The options object
+ */
+
+/**
+ * Hook that is called after finding one record.
+ *
+ * @memberof module:Hook
+ * @method
+ * @async
+ * @name dobo:afterFindOneRecord
+ * @param {DoboModel} model - The model instance
+ * @param {DoboModel.TFilter} filter - The filter criteria applied when finding one record
+ * @param {DoboModel.TResultFindOneRecord} result - The result of the find one operation
+ * @param {DoboModel.TOptions} options - The options object
+ */
+
+/**
+ * Hook that is called before finding all records.
+ *
+ * @memberof module:Hook
+ * @method
+ * @async
+ * @name dobo:beforeFindAllRecord
+ * @param {DoboModel} model - The model instance
+ * @param {DoboModel.TFilter} filter - The filter criteria to apply when finding all records
+ * @param {DoboModel.TOptions} options - The options object
+ */
+
+/**
+ * Hook that is called after finding all records.
+ *
+ * @memberof module:Hook
+ * @method
+ * @async
+ * @name dobo:afterFindAllRecord
+ * @param {DoboModel} model - The model instance
+ * @param {DoboModel.TFilter} filter - The filter criteria applied when finding all records
+ * @param {DoboModel.TResultFindAllRecord} result - The result of the find all operation
+ * @param {DoboModel.TOptions} options - The options object
+ */
+
+/**
+ * Hook that is called before updating a record.
+ *
+ * @memberof module:Hook
+ * @method
+ * @async
+ * @name dobo:beforeUpdateRecord
+ * @param {DoboModel} model - The model instance
+ * @param {string|number} id - The ID of the record to be updated
+ * @param {object} body - The body payload to be updated
+ * @param {DoboModel.TOptions} options - The options object
+ */
+
+/**
+ * Hook that is called after updating a record.
+ *
+ * @memberof module:Hook
+ * @method
+ * @async
+ * @name dobo:afterUpdateRecord
+ * @param {DoboModel} model - The model instance
+ * @param {string|number} id - The ID of the record that was updated
+ * @param {object} body - The body payload that was updated
+ * @param {DoboModel.TResultUpdateRecord} result - The result of the update operation
+ * @param {DoboModel.TOptions} options - The options object
+ */
+
+/**
+ * Hook that is called before removing a record.
+ *
+ * @memberof module:Hook
+ * @method
+ * @async
+ * @name dobo:beforeRemoveRecord
+ * @param {DoboModel} model - The model instance
+ * @param {string|number} id - The ID of the record to be removed
+ * @param {DoboModel.TOptions} options - The options object
+ */
+
+/**
+ * Hook that is called after removing a record.
+ *
+ * @memberof module:Hook
+ * @method
+ * @async
+ * @name dobo:afterRemoveRecord
+ * @param {DoboModel} model - The model instance
+ * @param {string|number} id - The ID of the record that was removed
+ * @param {DoboModel.TResultRemoveRecord} result - The result of the remove operation
+ * @param {DoboModel.TOptions} options - The options object
+ */
+
+/**
+ * Hook that is called before counting records.
+ *
+ * @memberof module:Hook
+ * @method
+ * @async
+ * @name dobo:beforeCountRecord
+ * @param {DoboModel} model - The model instance
+ * @param {DoboModel.TFilter} filter - The filter criteria to apply when counting records
+ * @param {DoboModel.TOptions} options - The options object
+ */
+
+/**
+ * Hook that is called after counting records.
+ *
+ * @memberof module:Hook
+ * @method
+ * @async
+ * @name dobo:afterCountRecord
+ * @param {DoboModel} model - The model instance
+ * @param {DoboModel.TFilter} filter - The filter criteria that was applied when counting records
+ * @param {DoboModel.TResultCountRecord} result - The result of the count operation
+ * @param {DoboModel.TOptions} options - The options object
+ */
+
+/**
+ * Hook that is called before getting a record by ID.
+ *
+ * @memberof module:Hook
+ * @method
+ * @async
+ * @name dobo:beforeGetRecord
+ * @param {DoboModel} model - The model instance
+ * @param {string|number} id - The ID of the record to be retrieved
+ * @param {DoboModel.TOptions} options - The options object
+ */
+
+/**
+ * Hook that is called after getting a record by ID.
+ *
+ * @memberof module:Hook
+ * @method
+ * @async
+ * @name dobo:afterGetRecord
+ * @param {DoboModel} model - The model instance
+ * @param {string|number} id - The ID of the record that was retrieved
+ * @param {DoboModel.TResultGetRecord} result - The result of the get operation
+ * @param {DoboModel.TOptions} options - The options object
+ */
+
+export default {}

package/extend/bajo/intl/en-US.json

@@ -86,7 +86,7 @@
   "methodUnsupported%s%s": "Method '%s@%s' is unsupported",
   "uniqueConstraintError": "Unique constraint error",
   "taskMustHaveModel%s": "Task must have %s model",
-  "driverNotInstalled%s": "Problem with '%s' driver file. Not installed yet?",
+  "adapterNotInstalled%s": "Problem with '%s' adapter file. Not installed yet?",
   "generalDbError": "General Database Error",
   "dbConstrainError": "Database Constraint Error",
   "onlySupportThese%s": "Only support one of these: %s",
@@ -97,9 +97,9 @@
   "addingMemoryPersistenceIgnored": "'%s' is a memory persistence model. Adding records from fixture is ignored!",
   "onlyOneConnType%s": "There could only be one connection type '%s'",
   "unsupportedDbType%s": "Unsupported DB type '%s'",
-  "driverMustProvideDbType": "A DB driver must provide at least one database type",
-  "driverMustHaveName": "A DB driver must have a driver name",
-  "dbTypeAlreadySupportedByDriver%s%s": "Database type '%s' already supported by driver '%s'",
+  "adapterMustProvideDbType": "A DB adapter must provide at least one database type",
+  "adapterMustHaveName": "A DB adapter must have a adapter name",
+  "dbTypeAlreadySupportedByAdapter%s%s": "Database type '%s' already supported by adapter '%s'",
   "invalidFeatureHandler%s%s": "Invalid handler for feature '%s:%s'",
   "unsupportedIndexType%s%s%s%s": "Unsupported index type %s for '%s@%s'. Allowed values: %s",
   "unknownFeature%s%s": "'Unknown feature '%s@%s'",
@@ -123,25 +123,25 @@
   "db": "DB",
   "invalidQuery": "Invalid Query",
   "noResultFound": "No result found",
-  "invalidDriverClassFactory%s%s": "Invalid driver class factory '%s:%s'",
-  "invalidDriverClass%s%s": "Invalid driver class '%s:%s'",
+  "invalidAdapterClassFactory%s%s": "Invalid adapter class factory '%s:%s'",
+  "invalidAdapterClass%s%s": "Invalid adapter class '%s:%s'",
   "multipleConnection%s": "Model '%s' is attached to more than one connection",
   "invalidFeature%s%s": "Invalid feature '%s@%s'",
   "invalidModelExtender%s%s": "Invalid model extender '%s' on '%s'",
-  "unknownDbDriver%s": "Unknown database driver '%s'",
+  "unknownDbAdapter%s": "Unknown database adapter '%s'",
   "unknownPropType%s%s": "Unknown property type '%s' on '%s'",
   "unknownIndexType%s%s": "Unknown index type '%s' on '%s'",
   "unknownPropNameOnIndex%s%s": "Unknown property name '%s' on index for '%s'",
   "unknownModelForRef%s%s%s": "Unknown model for reference '%s' on '%s:%s'",
   "unknownPropForRef%s%s%s": "Unknown property for reference '%s:%s' on '%s:%s'",
-  "noConnectionUsingDriver%s": "No connection using driver '%s'. To save resource, disabling this driver/plugin is recommended",
+  "noConnectionUsingAdapter%s": "No connection using adapter '%s'. To save resource, disabling this adapter/plugin is recommended",
   "keyIsRequired%s%s%s": "Key '%s' on %s|toLower '%s' is required",
   "enterRecordId": "Enter record ID:",
   "allowedPropType%s%s": "Allowed property type for field '%s': %s",
   "invalidIdType%s%s": "Invalid ID type for '%s'. Please only use one of these: %s",
   "noDefaultConnection": "No default connection found. All models will use the built-in memory database instead",
   "recordImmutable%s%s": "Record with ID: '%s' & model: '%s' is immutable and can't be modified or deleted",
-  "notSupportedDriver%s%s%s": "%s|upperFirst '%s' is not supported by driver '%s'",
+  "notSupportedAdapter%s%s%s": "%s|upperFirst '%s' is not supported by adapter '%s'",
   "inMemoryDb%s%s": "'%s' is an in-memory database, %s is not allowed",
   "buildOp": "'build' operation",
   "dropOp": "'drop' operation",

package/extend/bajo/intl/id.json

@@ -85,7 +85,7 @@
   "methodUnsupported%s%s": "Method '%s@%s' is unsupported",
   "uniqueConstraintError": "Unique constraint error",
   "taskMustHaveModel%s": "Task must have %s model",
-  "driverNotInstalled%s": "Problem with '%s' driver file. Not installed yet?",
+  "adapterNotInstalled%s": "Problem with '%s' adapter file. Not installed yet?",
   "generalDbError": "General Database Error",
   "dbConstrainError": "Database Constraint Error",
   "onlySupportThese%s": "Only support one of these: %s",
@@ -96,9 +96,9 @@
   "addingMemoryPersistenceIgnored": "'%s' is a memory persistence model. Adding records from fixture is ignored!",
   "onlyOneConnType%s": "There could only be one connection type '%s'",
   "unsupportedDbType%s": "Unsupported DB type '%s'",
-  "driverMustProvideDbType": "A DB driver must provide at least one database type",
-  "driverMustHaveName": "A DB driver must have a driver name",
-  "dbTypeAlreadySupportedByDriver%s%s": "Database type '%s' already supported by driver '%s'",
+  "adapterMustProvideDbType": "A DB adapter must provide at least one database type",
+  "adapterMustHaveName": "A DB adapter must have a adapter name",
+  "dbTypeAlreadySupportedByAdapter%s%s": "Database type '%s' already supported by adapter '%s'",
   "invalidFeatureHandler%s%s": "Handler untuk fitur '%s:%s' tidak valid",
   "unsupportedIndexType%s%s%s%s": "Unsupported index type %s for '%s@%s'. Allowed values: %s",
   "unknownFeature%s%s": "'Unknown feature '%s@%s'",
@@ -122,25 +122,25 @@
   "db": "DB",
   "invalidQuery": "Kueri Tidak Valid",
   "noResultFound": "Tidak ditemukan hasil",
-  "invalidDriverClass%s%s": "Kelas driver '%s:%s' tidak valid",
-  "invalidDriverClassFactory%s%s": "Faktori kelas driver '%s:%s' tidak valid",
+  "invalidAdapterClass%s%s": "Kelas adapter '%s:%s' tidak valid",
+  "invalidAdapterClassFactory%s%s": "Faktori kelas adapter '%s:%s' tidak valid",
   "multipleConnection%s": "Model '%s' terhubung dengan lebih dari satu koneksi",
   "invalidFeature%s%s": "Fitur tidak '%s@%s' valid",
   "invalidModelExtender%s%s": "Extender skema '%s@%s' tidak valid",
-  "unknownDbDriver%s": "Driver database '%s' tidak dikenal",
+  "unknownDbAdapter%s": "Adapter database '%s' tidak dikenal",
   "unknownPropType%s%s": "Tipe properti '%s' di '%s' tidak dikenal",
   "unknownIndexType%s%s": "Tipe index '%s' di '%s' tidak dikenal",
   "unknownPropNameOnIndex%s%s": "Nama properti '%s' di index untuk '%s' tidak dikenal",
   "unknownModelForRef%s%s%s": "Unknown model for reference '%s' on '%s:%s'",
   "unknownPropForRef%s%s%s": "Unknown property for reference '%s:%s' on '%s:%s'",
-  "noConnectionUsingDriver%s": "No connection using driver '%s'. To save resource, disabling this driver/plugin is recommended",
+  "noConnectionUsingAdapter%s": "No connection using adapter '%s'. To save resource, disabling this adapter/plugin is recommended",
   "keyIsRequired%s%s%s": "Key '%s' on %s|toLower '%s' is required",
   "enterRecordId": "Enter record ID:",
   "allowedPropType%s%s": "Allowed property type for field '%s': %s",
   "invalidIdType%s%s": "Invalid ID type for '%s'. Please only use one of these: %s",
   "noDefaultConnection": "No default connection found. All models will use the built-in memory database instead",
   "recordImmutable%s%s": "Data dengan ID: '%s' & model: '%s' adalah immutable dan tidak bisa diubah atau dihapus",
-  "notSupportedDriver%s%s%s": "%s|upperFirst '%s' tidak didukung oleh driver '%s'",
+  "notSupportedAdapter%s%s%s": "%s|upperFirst '%s' tidak didukung oleh adapter '%s'",
   "inMemoryDb%s%s": "'%s' adalah database in-memory, %s tidak diizinkan",
   "buildOp": "operasi 'build'",
   "dropOp": "operasi 'drop'",

package/extend/bajoCli/applet/rebuild-model.js

@@ -35,7 +35,7 @@ async function modelRebuild (path, ...args) {
   for (const s of names) {
     const model = this.getModel(s)
     const spin = this.print.spinner().start('rebuilding%s', model.name)
-    if (model.driver.memory) {
+    if (model.adapter.memory) {
       spin.warn('memoryDbSkipped%s', model.name)
       continue
     }
@@ -71,7 +71,7 @@ async function modelRebuild (path, ...args) {
   for (const s of without(names, ...skipped)) {
     const model = this.getModel(s)
     const spin = this.print.spinner().start('addingFixture%s', model.name)
-    if (model.driver.memory) {
+    if (model.adapter.memory) {
       spin.warn('memoryDbSkipped%s', model.name)
       continue
     }

package/extend/dobo/{driver → adapter}/memory.js

@@ -1,11 +1,11 @@
 import { Query } from 'mingo'
 
-async function memoryDriverFactory () {
-  const { DoboDriver } = this.app.baseClass
+async function memoryAdapterFactory () {
+  const { DoboAdapter } = this.app.baseClass
   const { findIndex, pullAt, omit, has } = this.app.lib._
   const { defaultsDeep } = this.app.lib.aneka
 
-  class DoboMemoryDriver extends DoboDriver {
+  class DoboMemoryAdapter extends DoboAdapter {
     constructor (plugin, name, options) {
       super(plugin, name, options)
       this.idGenerator = 'ulid'
@@ -165,8 +165,8 @@ async function memoryDriverFactory () {
     }
   }
 
-  this.app.baseClass.DoboMemoryDriver = DoboMemoryDriver
-  return DoboMemoryDriver
+  this.app.baseClass.DoboMemoryAdapter = DoboMemoryAdapter
+  return DoboMemoryAdapter
 }
 
-export default memoryDriverFactory
+export default memoryAdapterFactory

package/extend/dobo/feature/immutable.js

@@ -1,7 +1,7 @@
 async function beforeRemoveRecord (id, opts, options) {
   const { get } = this.app.lib._
   if (get(options, 'req.user.isXSiteAdmin')) return
-  const record = await this.driver.getRecord(this, id)
+  const record = await this.adapter.getRecord(this, id)
   const immutable = get(record.data, opts.field)
   if (immutable.length === 1 && immutable[0] === '*') throw this.plugin.error('recordImmutable%s%s', id, this.name, { statusCode: 423 })
 }
@@ -9,7 +9,7 @@ async function beforeRemoveRecord (id, opts, options) {
 async function beforeUpdateRecord (id, body, opts, options) {
   const { get } = this.app.lib._
   if (get(options, 'req.user.isXSiteAdmin')) return
-  const record = await this.driver.getRecord(this, id)
+  const record = await this.adapter.getRecord(this, id)
   const immutable = get(record.data, opts.field)
   if (immutable.length === 0) return
   const fields = []

package/extend/dobo/feature/removed-at.js

@@ -60,7 +60,7 @@ async function removedAt (opts = {}) {
       handler: async function (id, options) {
         const { set } = this.app.lib._
         const body = set({}, opts.field, new Date())
-        const record = await this.driver.recordUpdate(this, id, body, { noResult: false })
+        const record = await this.adapter.recordUpdate(this, id, body, { noResult: false })
         options.record = { oldData: record.oldData }
       }
     }]

package/index.js

@@ -1,11 +1,11 @@
 import nql from '@tryghost/nql'
-import collectConnections from './lib/collect-connections.js'
-import collectDrivers from './lib/collect-drivers.js'
-import collectFeatures from './lib/collect-features.js'
-import collectModels from './lib/collect-models.js'
+import {
+  collectConnections, collectAdapters, collectFeatures, collectModels
+} from './lib/helper.js'
 
 /**
  * @typedef {Object} TPropertyType
+ * @memberof DoboModel
  * @property {Object} integer
  * @property {string} [integer.validator=number]
  * @property {Object} smallint
@@ -87,6 +87,9 @@ const commonPropertyTypes = ['name', 'type', 'required', 'rules', 'validator', '
 /**
  * Plugin factory
  *
+ * @name pluginFactory
+ * @async
+ * @method
  * @param {string} pkgName - NPM package name
  * @returns {class}
  */
@@ -99,7 +102,7 @@ async function factory (pkgName) {
   /**
    * Dobo Database Framework for {@link https://github.com/ardhi/bajo|Bajo}.
    *
-   * See {@tutorial ecosystem} for available drivers & tools
+   * See {@tutorial ecosystem} for available adapters & tools
    *
    * @class
    */
@@ -174,7 +177,7 @@ async function factory (pkgName) {
       /**
        * @type {Object[]}
        */
-      this.drivers = []
+      this.adapters = []
 
       /**
        * @type {Object[]}
@@ -213,19 +216,19 @@ async function factory (pkgName) {
      * @returns {string[]}
      */
 
-    getAllPropertyKeys = (driver) => {
+    getAllPropertyKeys = (adapter) => {
       const { uniq, isEmpty } = this.app.lib._
       const keys = [...commonPropertyTypes]
       for (const type in propertyType) {
         keys.push(...Object.keys(propertyType[type]))
       }
-      if (driver && !isEmpty(driver.constructor.propertyKeys)) keys.push(...driver.constructor.propertyKeys)
+      if (adapter && !isEmpty(adapter.constructor.propertyKeys)) keys.push(...adapter.constructor.propertyKeys)
       return uniq(keys)
     }
 
     /**
      * Initialize plugin and performing the following tasks:
-     * - {@link module:Lib.collectDrivers|Collecting all drivers}
+     * - {@link module:Lib.collectAdapters|Collecting all adapters}
      * - {@link module:Lib.collectConnections|Collecting all connections}
      * - {@link module:Lib.collectFeatures|Collecting all features}
      * - {@link module:Lib.collectModels|Collecting all models}
@@ -234,7 +237,7 @@ async function factory (pkgName) {
      */
     init = async () => {
       const { fs } = this.app.lib
-      await collectDrivers.call(this)
+      await collectAdapters.call(this)
       await collectConnections.call(this)
       await collectFeatures.call(this)
       await collectModels.call(this)
@@ -257,7 +260,7 @@ async function factory (pkgName) {
       this.log.debug('dbInit')
       for (const connection of conns) {
         await connection.connect(noRebuild)
-        this.log.trace('dbInit%s%s%s', connection.driver.plugin.ns, connection.driver.name, connection.name)
+        this.log.trace('dbInit%s%s%s', connection.adapter.plugin.ns, connection.adapter.name, connection.name)
       }
     }
 
@@ -266,7 +269,7 @@ async function factory (pkgName) {
      *
      * @param {string} name - Connection name
      * @param {boolean} [silent] - If ```true``` and connection is not found, it won't throw error
-     * @returns {Driver} Return connection instance or ```undefined``` if silent is ```true```
+     * @returns {Adapter} Return connection instance or ```undefined``` if silent is ```true```
      */
     getConnection = (name, silent) => {
       const conn = find(this.connections, { name })
@@ -275,35 +278,35 @@ async function factory (pkgName) {
     }
 
     /**
-     * Get driver by name. It returns the first driver named after "{name}"
+     * Get adapter by name. It returns the first adapter named after "{name}"
      *
-     * Also support NsPath format for those who load the same named driver but from different provider/plugin.
+     * Also support NsPath format for those who load the same named adapter but from different provider/plugin.
      *
-     * @param {string} name - Driver name
-     * @param {boolean} [silent] - If ```true``` and driver is not found, it won't throw error
-     * @returns {Driver} Returns driver instance or ```undefined``` if silent is ```true```
+     * @param {string} name - Adapter name
+     * @param {boolean} [silent] - If ```true``` and adapter is not found, it won't throw error
+     * @returns {Adapter} Returns adapter instance or ```undefined``` if silent is ```true```
      */
-    getDriver = (name, silent) => {
+    getAdapter = (name, silent) => {
       const { breakNsPath } = this.app.bajo
-      let driver
+      let adapter
       if (!name.includes(':')) {
-        driver = find(this.drivers, { name })
-        if (driver) return driver
-        driver = filter(this.drivers, d => d.plugin.ns === name)
-        if (driver.length === 1) return driver[0]
-        if (!silent) throw this.error('unknown%s%s', this.t('driver'), name)
+        adapter = find(this.adapters, { name })
+        if (adapter) return adapter
+        adapter = filter(this.adapters, d => d.plugin.ns === name)
+        if (adapter.length === 1) return adapter[0]
+        if (!silent) throw this.error('unknown%s%s', this.t('adapter'), name)
         return
       }
       const { ns, path } = breakNsPath(name)
-      driver = find(this.drivers, d => d.name === path && d.plugin.ns === ns)
-      if (!driver && !silent) throw this.error('unknown%s%s', this.t('driver'), name)
-      return driver
+      adapter = find(this.adapters, d => d.name === path && d.plugin.ns === ns)
+      if (!adapter && !silent) throw this.error('unknown%s%s', this.t('adapter'), name)
+      return adapter
     }
 
     /**
-     * Get feature by name. It returns the first driver named after "{name}"
+     * Get feature by name. It returns the first adapter named after "{name}"
      *
-     * Also support NsPath format for those who load the same named driver but from different provider/plugin.
+     * Also support NsPath format for those who load the same named adapter but from different provider/plugin.
      *
      * @param {string} - Feature name
      * @returns {Feature} Return feature instance
@@ -591,7 +594,7 @@ async function factory (pkgName) {
         }
       }
       let strQ = this.replaceRegexInJson(result)
-      if (model && model.driver.idField.name !== 'id') strQ = strQ.replaceAll('"id"', `"${model.driver.idField.name}"`)
+      if (model && model.adapter.idField.name !== 'id') strQ = strQ.replaceAll('"id"', `"${model.adapter.idField.name}"`)
       try {
         result = this.reviveRegexInJson(strQ)
       } catch (err) {}