acrylblends 0.7.4 → 0.7.6

package/lib/index-D4FAsBZu.d.ts

@@ -0,0 +1,85 @@
+//#region ../../plugins/acryl-db/src/facade/database.d.ts
+/** Values supported by the portable SQL drivers. */
+type SqlValue = null | number | bigint | string | Uint8Array;
+/**
+ * Asynchronous SQL operations shared by a database and its transaction handles.
+ *
+ * `exec` runs SQL text without bindings and may contain several statements. `run`, `get`, and `all`
+ * execute one statement with positional bindings. Adapters may cache prepared statements by SQL text,
+ * so callers pass values as bindings instead of interpolating them. `run` resolves the number of rows
+ * the statement changed.
+ */
+interface DbExecutor {
+  exec(sql: string): Promise<void>;
+  run(sql: string, ...params: SqlValue[]): Promise<{
+    readonly changes: number;
+  }>;
+  get<T extends object>(sql: string, ...params: SqlValue[]): Promise<T | undefined>;
+  all<T extends object>(sql: string, ...params: SqlValue[]): Promise<T[]>;
+}
+/**
+ * Minimal portable SQL database facade.
+ *
+ * All operations are asynchronous so adapters may execute outside the caller's runtime.
+ *
+ * `transaction` passes the callback a transaction handle. All work in the transaction
+ * must use that handle; the handle is invalid after the callback settles. Adapters must
+ * queue unrelated operations and other transactions until the transaction finishes. The
+ * returned promise settles after commit or rollback. Calling the database itself (including
+ * `transaction`) from inside a callback therefore waits for that transaction and
+ * never settles.
+ *
+ * When the callback rejects, the adapter must roll the transaction back before rejecting
+ * with that same error. If rollback fails, it must reject with a different error (for
+ * example an `AggregateError`) so callers cannot mistake the callback error for a
+ * guaranteed rollback.
+ *
+ * Closing is the adapter's: the plugin that opened a database closes it, so the facade an
+ * app receives has no `close`.
+ */
+interface Db extends DbExecutor {
+  transaction<T>(callback: (transaction: DbExecutor) => Promise<T>): Promise<T>;
+}
+//#endregion
+//#region ../../plugins/acryl-db/src/facade/migrations.d.ts
+type Migration = {
+  readonly version: number;
+  readonly statements: readonly string[];
+};
+/**
+ * Apply all pending migrations atomically, tracking their version in the named metadata table.
+ *
+ * The bookkeeping SQL runs unchanged on SQLite and Postgres: no `STRICT` table, `ON CONFLICT DO NOTHING`
+ * instead of `INSERT OR IGNORE`, and the version written as a checked integer rather than a binding,
+ * since the two dialects spell placeholders differently.
+ */
+declare function applyMigrations(database: Db, migrations: readonly Migration[], options: {
+  readonly table: string;
+}): Promise<void>;
+//#endregion
+//#region ../../plugins/acryl-db/src/facade/schema.d.ts
+/** Validate a prefix before using it as part of a SQL identifier. */
+declare function validateSchemaPrefix(prefix: string): void;
+//#endregion
+//#region ../../plugins/acryl-db/src/migration-files.d.ts
+/**
+ * Read every `NNN-name.sql` file of a folder, in number order.
+ * @throws when a `.sql` file is not named `NNN-name.sql`, or the numbers do not run 1, 2, 3, ... without gaps or repeats.
+ */
+declare function readMigrationFiles(folder: string | URL): Promise<Migration[]>;
+//#endregion
+//#region ../../plugins/acryl-db/src/index.d.ts
+/**
+ * The `db` port: what an app's code sees of its relational database, whichever provider (`acryl-db-sqlite`, `acryl-db-postgres`) serves
+ * it. Plain code (an acrylblends app) opens a database with a provider's `openDb`; a Cordis plugin declares `inject: ['db']`, imports
+ * `acryl-db/cordis` for the `ctx.db` type, and never imports a driver.
+ *
+ * Bindings are positional `?` placeholders on every provider; a provider whose database spells them differently translates them.
+ * This entry imports nothing from Cordis, at runtime or in its types.
+ */
+/** The service name every `db` provider registers. */
+declare const DB_SERVICE = "db";
+/** The table that records an app's migration version. */
+declare const MIGRATIONS_TABLE = "_migrations";
+//#endregion
+export { Migration as a, DbExecutor as c, validateSchemaPrefix as i, SqlValue as l, MIGRATIONS_TABLE as n, applyMigrations as o, readMigrationFiles as r, Db as s, DB_SERVICE as t };

package/lib/src-MWcsMS8i.js

@@ -0,0 +1,85 @@
+import { readFile, readdir } from "node:fs/promises";
+import { join } from "node:path";
+import { fileURLToPath } from "node:url";
+//#region ../../plugins/acryl-db/src/facade/schema.ts
+/** Validate a prefix before using it as part of a SQL identifier. */
+function validateSchemaPrefix(prefix) {
+	if (!/^[A-Za-z_][A-Za-z0-9_]*$/.test(prefix)) throw new Error(`Invalid SQL schema prefix ${JSON.stringify(prefix)}`);
+	if (prefix.toLowerCase().startsWith("sqlite_")) throw new Error(`SQL schema prefix ${JSON.stringify(prefix)} is reserved`);
+}
+//#endregion
+//#region ../../plugins/acryl-db/src/facade/migrations.ts
+/**
+* Apply all pending migrations atomically, tracking their version in the named metadata table.
+*
+* The bookkeeping SQL runs unchanged on SQLite and Postgres: no `STRICT` table, `ON CONFLICT DO NOTHING`
+* instead of `INSERT OR IGNORE`, and the version written as a checked integer rather than a binding,
+* since the two dialects spell placeholders differently.
+*/
+async function applyMigrations(database, migrations, options) {
+	const { table } = options;
+	validateSchemaPrefix(table);
+	for (let index = 0; index < migrations.length; index++) if (migrations[index]?.version !== index + 1) throw new Error("Migrations must have contiguous versions starting at 1");
+	await database.transaction(async (transaction) => {
+		await transaction.exec(`CREATE TABLE IF NOT EXISTS ${table} (
+			singleton INTEGER PRIMARY KEY CHECK (singleton = 1),
+			version INTEGER NOT NULL CHECK (version >= 0)
+		)`);
+		await transaction.exec(`INSERT INTO ${table} (singleton, version) VALUES (1, 0) ON CONFLICT DO NOTHING`);
+		const row = await transaction.get(`SELECT version FROM ${table} WHERE singleton = 1`);
+		if (row === void 0) throw new Error("Schema metadata is missing");
+		const storedVersion = Number(row.version);
+		const currentVersion = migrations.at(-1)?.version ?? 0;
+		if (storedVersion > currentVersion) throw new Error(`Schema version ${storedVersion} is newer than supported version ${currentVersion}`);
+		for (const migration of migrations) {
+			if (migration.version <= storedVersion) continue;
+			for (const statement of migration.statements) await transaction.exec(statement);
+			await transaction.exec(`UPDATE ${table} SET version = ${String(migration.version)} WHERE singleton = 1`);
+		}
+	});
+}
+//#endregion
+//#region ../../plugins/acryl-db/src/migration-files.ts
+/**
+* An app's migrations as numbered SQL files: `migrations/001-notes.sql`, `002-tags.sql`, ... Each file is one migration, run as one
+* `exec` (so it may hold several statements), numbered from 1 with no gaps.
+*/
+const FILE = /^(\d+)-[a-z0-9][a-z0-9-]*\.sql$/u;
+/**
+* Read every `NNN-name.sql` file of a folder, in number order.
+* @throws when a `.sql` file is not named `NNN-name.sql`, or the numbers do not run 1, 2, 3, ... without gaps or repeats.
+*/
+async function readMigrationFiles(folder) {
+	const dir = typeof folder === "string" ? folder : fileURLToPath(folder);
+	const numbered = (await readdir(dir)).filter((name) => name.endsWith(".sql")).sort().map((name) => {
+		const match = FILE.exec(name);
+		if (match?.[1] === void 0) throw new Error(`acryl-db: migration file ${name} in ${dir} must be named NNN-name.sql, like 001-notes.sql`);
+		return {
+			name,
+			version: Number(match[1])
+		};
+	}).sort((a, b) => a.version - b.version);
+	numbered.forEach((file, index) => {
+		if (file.version !== index + 1) throw new Error(`acryl-db: migration ${file.name} in ${dir} should be number ${String(index + 1)}; the files must be numbered 1, 2, 3, ... with no gaps or repeats`);
+	});
+	return Promise.all(numbered.map(async (file) => ({
+		version: file.version,
+		statements: [await readFile(join(dir, file.name), "utf8")]
+	})));
+}
+//#endregion
+//#region ../../plugins/acryl-db/src/index.ts
+/**
+* The `db` port: what an app's code sees of its relational database, whichever provider (`acryl-db-sqlite`, `acryl-db-postgres`) serves
+* it. Plain code (an acrylblends app) opens a database with a provider's `openDb`; a Cordis plugin declares `inject: ['db']`, imports
+* `acryl-db/cordis` for the `ctx.db` type, and never imports a driver.
+*
+* Bindings are positional `?` placeholders on every provider; a provider whose database spells them differently translates them.
+* This entry imports nothing from Cordis, at runtime or in its types.
+*/
+/** The service name every `db` provider registers. */
+const DB_SERVICE = "db";
+/** The table that records an app's migration version. */
+const MIGRATIONS_TABLE = "_migrations";
+//#endregion
+export { validateSchemaPrefix as a, applyMigrations as i, MIGRATIONS_TABLE as n, readMigrationFiles as r, DB_SERVICE as t };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "acrylblends",
-  "version": "0.7.4",
+  "version": "0.7.6",
   "description": "The Acryl web framework (import { Acryl } from \"acrylblends\") and the acrylblends command that scaffolds Cordis apps.",
   "license": "MIT",
   "type": "module",
@@ -418,6 +418,14 @@
       "types": "./lib/node-server/register.d.ts",
       "default": "./lib/node-server/register.js"
     },
+    "./db": {
+      "types": "./lib/db.d.ts",
+      "default": "./lib/db.js"
+    },
+    "./db/sqlite": {
+      "types": "./lib/db/sqlite.d.ts",
+      "default": "./lib/db/sqlite.js"
+    },
     "./package.json": "./package.json",
     "./cli": {
       "types": "./dist/index.d.ts",

package/plugins/acryl-db/LICENSE

@@ -0,0 +1,47 @@
+MIT License
+
+Copyright (c) 2026 WebBoxes s.r.o.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+---
+
+The files under src/facade are derived from the SQLite facade of chord in pi (https://github.com/earendil-works/pi, packages/chord, commit d5b3de22d0e24a3e9c38a9410d3329b099717283), used under this license:
+
+MIT License
+
+Copyright (c) 2025 Mario Zechner
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/plugins/acryl-db/plugin.json

@@ -0,0 +1,12 @@
+{
+  "name": "acryl-db",
+  "description": "The db port: the relational database an app plugin sees through inject: ['db'], with numbered SQL migrations. Types and the migration runner; a provider (acryl-db-sqlite) serves it. Vendored from ACRYL.",
+  "requires": [],
+  "inject": [],
+  "provides": [],
+  "dependencies": {
+    "@deepseek-ai/cordis": "4.0.4"
+  },
+  "mount": "it is the port, not a service: a plugin declares inject: ['db'] and imports its types from './plugins/acryl-db/src/index.ts' (or the ctx.db type from './plugins/acryl-db/src/cordis.ts'); add acryl-db-sqlite to provide it",
+  "omit": ["src/conformance.ts", "**/*.test.*", "**/*.case.ts"]
+}

package/plugins/acryl-db/src/cordis.ts

@@ -0,0 +1,13 @@
+/**
+ * The `ctx.db` type for Cordis plugins: `import type {} from 'acryl-db/cordis'` beside `inject: ['db']`. Kept out of the root entry, so
+ * plain code that uses the port never names Cordis.
+ */
+
+import type {} from '@deepseek-ai/cordis'
+import type { Db } from './facade/database.ts'
+
+declare module '@deepseek-ai/cordis' {
+  interface Context {
+    db: Db
+  }
+}

package/plugins/acryl-db/src/facade/database.ts

@@ -0,0 +1,41 @@
+/** Values supported by the portable SQL drivers. */
+export type SqlValue = null | number | bigint | string | Uint8Array;
+
+/**
+ * Asynchronous SQL operations shared by a database and its transaction handles.
+ *
+ * `exec` runs SQL text without bindings and may contain several statements. `run`, `get`, and `all`
+ * execute one statement with positional bindings. Adapters may cache prepared statements by SQL text,
+ * so callers pass values as bindings instead of interpolating them. `run` resolves the number of rows
+ * the statement changed.
+ */
+export interface DbExecutor {
+	exec(sql: string): Promise<void>;
+	run(sql: string, ...params: SqlValue[]): Promise<{ readonly changes: number }>;
+	get<T extends object>(sql: string, ...params: SqlValue[]): Promise<T | undefined>;
+	all<T extends object>(sql: string, ...params: SqlValue[]): Promise<T[]>;
+}
+
+/**
+ * Minimal portable SQL database facade.
+ *
+ * All operations are asynchronous so adapters may execute outside the caller's runtime.
+ *
+ * `transaction` passes the callback a transaction handle. All work in the transaction
+ * must use that handle; the handle is invalid after the callback settles. Adapters must
+ * queue unrelated operations and other transactions until the transaction finishes. The
+ * returned promise settles after commit or rollback. Calling the database itself (including
+ * `transaction`) from inside a callback therefore waits for that transaction and
+ * never settles.
+ *
+ * When the callback rejects, the adapter must roll the transaction back before rejecting
+ * with that same error. If rollback fails, it must reject with a different error (for
+ * example an `AggregateError`) so callers cannot mistake the callback error for a
+ * guaranteed rollback.
+ *
+ * Closing is the adapter's: the plugin that opened a database closes it, so the facade an
+ * app receives has no `close`.
+ */
+export interface Db extends DbExecutor {
+	transaction<T>(callback: (transaction: DbExecutor) => Promise<T>): Promise<T>;
+}

package/plugins/acryl-db/src/facade/migrations.ts

@@ -0,0 +1,50 @@
+import type { Db } from "./database.ts";
+import { validateSchemaPrefix } from "./schema.ts";
+
+export type Migration = {
+	readonly version: number;
+	readonly statements: readonly string[];
+};
+
+type SchemaRow = { readonly version: number | bigint };
+
+/**
+ * Apply all pending migrations atomically, tracking their version in the named metadata table.
+ *
+ * The bookkeeping SQL runs unchanged on SQLite and Postgres: no `STRICT` table, `ON CONFLICT DO NOTHING`
+ * instead of `INSERT OR IGNORE`, and the version written as a checked integer rather than a binding,
+ * since the two dialects spell placeholders differently.
+ */
+export async function applyMigrations(
+	database: Db,
+	migrations: readonly Migration[],
+	options: { readonly table: string },
+): Promise<void> {
+	const { table } = options;
+	validateSchemaPrefix(table);
+	for (let index = 0; index < migrations.length; index++) {
+		if (migrations[index]?.version !== index + 1) {
+			throw new Error("Migrations must have contiguous versions starting at 1");
+		}
+	}
+
+	await database.transaction(async (transaction) => {
+		await transaction.exec(`CREATE TABLE IF NOT EXISTS ${table} (
+			singleton INTEGER PRIMARY KEY CHECK (singleton = 1),
+			version INTEGER NOT NULL CHECK (version >= 0)
+		)`);
+		await transaction.exec(`INSERT INTO ${table} (singleton, version) VALUES (1, 0) ON CONFLICT DO NOTHING`);
+		const row = await transaction.get<SchemaRow>(`SELECT version FROM ${table} WHERE singleton = 1`);
+		if (row === undefined) throw new Error("Schema metadata is missing");
+		const storedVersion = Number(row.version);
+		const currentVersion = migrations.at(-1)?.version ?? 0;
+		if (storedVersion > currentVersion) {
+			throw new Error(`Schema version ${storedVersion} is newer than supported version ${currentVersion}`);
+		}
+		for (const migration of migrations) {
+			if (migration.version <= storedVersion) continue;
+			for (const statement of migration.statements) await transaction.exec(statement);
+			await transaction.exec(`UPDATE ${table} SET version = ${String(migration.version)} WHERE singleton = 1`);
+		}
+	});
+}

package/plugins/acryl-db/src/facade/schema.ts

@@ -0,0 +1,9 @@
+/** Validate a prefix before using it as part of a SQL identifier. */
+export function validateSchemaPrefix(prefix: string): void {
+	if (!/^[A-Za-z_][A-Za-z0-9_]*$/.test(prefix)) {
+		throw new Error(`Invalid SQL schema prefix ${JSON.stringify(prefix)}`);
+	}
+	if (prefix.toLowerCase().startsWith("sqlite_")) {
+		throw new Error(`SQL schema prefix ${JSON.stringify(prefix)} is reserved`);
+	}
+}

package/plugins/acryl-db/src/index.ts

@@ -0,0 +1,19 @@
+/**
+ * The `db` port: what an app's code sees of its relational database, whichever provider (`acryl-db-sqlite`, `acryl-db-postgres`) serves
+ * it. Plain code (an acrylblends app) opens a database with a provider's `openDb`; a Cordis plugin declares `inject: ['db']`, imports
+ * `acryl-db/cordis` for the `ctx.db` type, and never imports a driver.
+ *
+ * Bindings are positional `?` placeholders on every provider; a provider whose database spells them differently translates them.
+ * This entry imports nothing from Cordis, at runtime or in its types.
+ */
+
+/** The service name every `db` provider registers. */
+export const DB_SERVICE = 'db'
+
+/** The table that records an app's migration version. */
+export const MIGRATIONS_TABLE = '_migrations'
+
+export type { Db, DbExecutor, SqlValue } from './facade/database.ts'
+export { applyMigrations, type Migration } from './facade/migrations.ts'
+export { validateSchemaPrefix } from './facade/schema.ts'
+export { readMigrationFiles } from './migration-files.ts'

package/plugins/acryl-db/src/migration-files.ts

@@ -0,0 +1,31 @@
+/**
+ * An app's migrations as numbered SQL files: `migrations/001-notes.sql`, `002-tags.sql`, ... Each file is one migration, run as one
+ * `exec` (so it may hold several statements), numbered from 1 with no gaps.
+ */
+
+import { readdir, readFile } from 'node:fs/promises'
+import { join } from 'node:path'
+import { fileURLToPath } from 'node:url'
+import type { Migration } from './facade/migrations.ts'
+
+const FILE = /^(\d+)-[a-z0-9][a-z0-9-]*\.sql$/u
+
+/**
+ * Read every `NNN-name.sql` file of a folder, in number order.
+ * @throws when a `.sql` file is not named `NNN-name.sql`, or the numbers do not run 1, 2, 3, ... without gaps or repeats.
+ */
+export async function readMigrationFiles(folder: string | URL): Promise<Migration[]> {
+  const dir = typeof folder === 'string' ? folder : fileURLToPath(folder)
+  const files = (await readdir(dir)).filter(name => name.endsWith('.sql')).sort()
+  const numbered = files.map(name => {
+    const match = FILE.exec(name)
+    if (match?.[1] === undefined) throw new Error(`acryl-db: migration file ${name} in ${dir} must be named NNN-name.sql, like 001-notes.sql`)
+    return { name, version: Number(match[1]) }
+  }).sort((a, b) => a.version - b.version)
+  numbered.forEach((file, index) => {
+    if (file.version !== index + 1) {
+      throw new Error(`acryl-db: migration ${file.name} in ${dir} should be number ${String(index + 1)}; the files must be numbered 1, 2, 3, ... with no gaps or repeats`)
+    }
+  })
+  return Promise.all(numbered.map(async file => ({ version: file.version, statements: [await readFile(join(dir, file.name), 'utf8')] })))
+}

package/plugins/acryl-db/upstream.json

@@ -0,0 +1,18 @@
+{
+  "source": {
+    "repo": "acryldev/acryl",
+    "path": "plugins/acryl-db",
+    "commit": "8e23e14336647943d4232047e3ea253e434535d3"
+  },
+  "vendored": [
+    "src",
+    "tests",
+    "LICENSE"
+  ],
+  "rewrittenSpecifiers": 0,
+  "digest": "sha256:51e5613457498bfab7c281e0c6443c4f7535401c16520ac44624dc8791a90fa6",
+  "testsNotRun": {},
+  "notice": [
+    "LICENSE"
+  ]
+}

package/plugins/acryl-db-sqlite/LICENSE

@@ -0,0 +1,47 @@
+MIT License
+
+Copyright (c) 2026 WebBoxes s.r.o.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+---
+
+The files under src/facade and tests/facade are derived from the SQLite facade of chord in pi (https://github.com/earendil-works/pi, packages/chord, commit d5b3de22d0e24a3e9c38a9410d3329b099717283), used under this license:
+
+MIT License
+
+Copyright (c) 2025 Mario Zechner
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/plugins/acryl-db-sqlite/plugin.json

@@ -0,0 +1,13 @@
+{
+  "name": "acryl-db-sqlite",
+  "description": "The SQLite provider of the db port: one node:sqlite file in the app home (WAL), the app's numbered migrations applied on start, db provided to plugins. Vendored from ACRYL.",
+  "requires": ["acryl-db", "instance"],
+  "inject": [],
+  "provides": ["db"],
+  "dependencies": {
+    "@deepseek-ai/cordis": "4.0.4",
+    "@deepseek-ai/schemastery": "3.18.4"
+  },
+  "mount": "mount it after instance: root.plugin(dbSqlite, { migrations: 'migrations' }) with the migrations/ folder (001-name.sql, ...) next to src/; then a plugin that declares inject: ['db'] calls await ctx.db.all('SELECT ...', value)",
+  "omit": ["**/*.test.*", "**/*.spec.*", "**/*.case.ts"]
+}