v0.4.0 — Moleculer 0.15 + Node 22+

.github/workflows/integration.yml

@@ -27,7 +27,7 @@ jobs:
 
     strategy:
       matrix:
-        node-version: [20.x, 22.x, 24.x]
+        node-version: [22.x, 24.x]
         adapter: ["NeDB", "MongoDB", "Knex-SQLite", "Knex-Postgresql", "Knex-MySQL", "Knex-MySQL2", "Knex-MSSQL"]
       fail-fast: false
     steps:
@@ -39,7 +39,7 @@ jobs:
         node-version: ${{ matrix.node-version }}
 
     - name: Install dependencies
-      run: npm ci
+      run: npm install
 
     - name: Start containers for ${{ matrix.adapter }} adapter
       run: docker compose up -d mongo && sleep 30

.github/workflows/typecheck.yml

@@ -0,0 +1,31 @@
+name: TypeScript Type Check
+
+on:
+  push: {}
+  pull_request: {}
+
+jobs:
+  typecheck:
+    runs-on: ubuntu-latest
+
+    strategy:
+      matrix:
+        node-version: [22.x, 24.x]
+
+    steps:
+    - name: Checkout repository
+      uses: actions/checkout@v4
+
+    - name: Setup Node.js ${{ matrix.node-version }}
+      uses: actions/setup-node@v4
+      with:
+        node-version: ${{ matrix.node-version }}
+
+    - name: Install dependencies
+      run: npm install
+
+    - name: Typecheck
+      run: npm run typecheck
+
+    - name: Test TS
+      run: npm run test:ts

.github/workflows/unit.yml

@@ -27,7 +27,7 @@ jobs:
 
     strategy:
       matrix:
-        node-version: [20.x, 22.x, 24.x]
+        node-version: [22.x, 24.x]
       fail-fast: false
     steps:
     - uses: actions/checkout@v4
@@ -38,7 +38,7 @@ jobs:
         node-version: ${{ matrix.node-version }}
 
     - name: Install dependencies
-      run: npm ci
+      run: npm install
 
     - name: Run unit tests
       run: npm run test:unit

.gitignore

@@ -107,3 +107,6 @@ dist
 *.db-journal
 *.sqlite3
 *.sqlite3-journal
+
+# Claude Code local settings
+.claude/settings.local.json

CHANGELOG.md

@@ -1,3 +1,29 @@
+<a name="v0.4.0"></a>
+
+# [0.4.0](https://github.com/moleculerjs/database/compare/v0.3.0...v0.4.0) (2026-03-27)
+
+**Breaking changes**
+- minimum Node.js version bumped to 22.
+- add Moleculer 0.15 support (peer dependency: `^0.14.12 || ^0.15.0`).
+- upgrade ESLint to 10 with flat config (`.eslintrc.js` → `eslint.config.js`).
+- upgrade TypeScript to 6.
+- remove `eslint-plugin-promise` (not compatible with ESLint 10).
+- replace deprecated `eslint-plugin-node` with `eslint-plugin-n`.
+
+**TypeScript**
+- fix types for Moleculer 0.15 compatibility (remove `ServiceEvents`, `GenericObject` imports).
+- fix `logger` type from `Loggers` namespace to `Logger` interface.
+- add TypeScript type definitions (`index.d.ts`).
+
+**Other changes**
+- upgrade `mongodb` driver from 6.x to 7.x (accept both `^6.0.0` and `^7.0.0`).
+- upgrade `sqlite3` from 5.x to 6.x.
+- upgrade `tedious` from 18.x to 19.x.
+- upgrade `globals` from 16.x to 17.x.
+- upgrade `npm-check-updates` from 16.x to 19.x.
+- update all other dependencies to latest minor/patch versions.
+- CI: use `npm install` instead of `npm ci` to work around Node 24 fsevents lockfile bug ([npm/cli#8805](https://github.com/npm/cli/issues/8805)).
+
 <a name="v0.3.0"></a>
 
 # [0.3.0](https://github.com/moleculerjs/database/compare/v0.2.1...v0.3.0) (2025-05-31)

docs/README.md

@@ -1340,7 +1340,7 @@ Update an existing entity. Only the specified fields will be updated.
 | `opts.raw` | `Boolean` | `false` | If `true`, the `params` is passed directly to the database client. |
 | `opts.transform` | `Boolean` | `true` | If `false`, the result won't be transformed. |
 | `opts.permissive` | `Boolean` | `false` | If `true`, readonly and immutable fields can be set and update and field permission is not checked. |
-| `opts.scope` | `String|Array<String>|Boolean` | `null` |Scopes for the query. If false, the default scopes are disabled. |
+| `opts.scope` | `String\|Array<String>\|Boolean` | `null` |Scopes for the query. If false, the default scopes are disabled. |
 
 It returns the updated entity.
 
@@ -1356,7 +1356,7 @@ Update multiple entities by a query. Only the specified fields will be updated.
 | `params` | `Object` | `null` | Parameters for method. |
 | `params.query` | `Object` | `null` | The query for finding entities. |
 | `params.changes` | `Object` | `null` | It contains the changed field values. |
-| `params.scope` | `String|Array<String>|Boolean` | `null` |Scopes for the query. If false, the default scopes are disabled. |
+| `params.scope` | `String\|Array<String>\|Boolean` | `null` |Scopes for the query. If false, the default scopes are disabled. |
 | `opts` | `Object` | `{}` | Other options for internal methods. |
 | `opts.raw` | `Boolean` | `false` | If `true`, the `params` is passed directly to the database client. |
 | `opts.transform` | `Boolean` | `true` | If `false`, the result won't be transformed. |
@@ -1377,7 +1377,7 @@ Replace an existing entity.
 | `opts` | `Object` | `{}` | Other options for internal methods. |
 | `opts.transform` | `Boolean` | `true` | If `false`, the result won't be transformed. |
 | `opts.permissive` | `Boolean` | `false` | If `true`, readonly and immutable fields can be set and update and field permission is not checked. |
-| `opts.scope` | `String|Array<String>|Boolean` | `null` |Scopes for the query. If false, the default scopes are disabled. |
+| `opts.scope` | `String\|Array<String>\|Boolean` | `null` |Scopes for the query. If false, the default scopes are disabled. |
 
 It returns the replaced entity.
 
@@ -1393,7 +1393,7 @@ Delete an entity by ID.
 | `params` | `Object` | `null` | It contains the entity ID. |
 | `opts` | `Object` | `{}` | Other options for internal methods. |
 | `opts.transform` | `Boolean` | `true` | If `false`, the result won't be transformed. |
-| `opts.scope` | `String|Array<String>|Boolean` | `null` |Scopes for the query. If false, the default scopes are disabled. |
+| `opts.scope` | `String\|Array<String>\|Boolean` | `null` |Scopes for the query. If false, the default scopes are disabled. |
 | `opts.softDelete` | `Boolean` | `null` | Disable the enabled soft-delete feature. Only `false` value is acceptable. |
 
 The method returns only the ID of the deleted entity.
@@ -1409,7 +1409,7 @@ Delete multiple entities by a query.
 | `ctx` | `Context` | `null` | Moleculer `Context` instance. It can be `null`. |
 | `params` | `Object` | `null` | Parameters for method. |
 | `params.query` | `Object` | `null` | The query for finding entities. |
-| `params.scope` | `String|Array<String>|Boolean` | `null` |Scopes for the query. If false, the default scopes are disabled. |
+| `params.scope` | `String\|Array<String>\|Boolean` | `null` |Scopes for the query. If false, the default scopes are disabled. |
 | `opts` | `Object` | `{}` | Other options for internal methods. |
 | `opts.transform` | `Boolean` | `true` | If `false`, the result won't be transformed. |
 | `opts.softDelete` | `Boolean` | `null` | Disable the enabled soft-delete feature. Only `false` value is acceptable. |

eslint.config.js

@@ -0,0 +1,40 @@
+const js = require("@eslint/js");
+const globals = require("globals");
+const pluginN = require("eslint-plugin-n");
+const pluginSecurity = require("eslint-plugin-security");
+const prettier = require("eslint-config-prettier");
+
+module.exports = [
+	js.configs.recommended,
+	pluginSecurity.configs.recommended,
+	prettier,
+	{
+		plugins: {
+			n: pluginN,
+			security: pluginSecurity
+		},
+		languageOptions: {
+			ecmaVersion: 2020,
+			sourceType: "commonjs",
+			globals: {
+				...globals.node,
+				...globals.jest,
+				...globals.jasmine
+			}
+		},
+		rules: {
+			"no-var": "error",
+			"no-console": "warn",
+			"no-unused-vars": "warn",
+			"no-trailing-spaces": "error",
+			"security/detect-object-injection": "off",
+			"security/detect-non-literal-require": "off",
+			"security/detect-non-literal-fs-filename": "off",
+			"no-process-exit": "off",
+			"n/no-unpublished-require": "off",
+			"require-atomic-updates": "off",
+			"object-curly-spacing": ["warn", "always"],
+			"no-useless-assignment": "off"
+		}
+	}
+];