@hivemagnus/ardent-studio 0.1.1 → 0.2.1

package/README.md

@@ -28,7 +28,7 @@ project event stream.
 | [Oathweave](https://github.com/ChefTaco/Oathweave) | Yes | Sign-in for people (audience `ardentstudio`) and ArdentStudio's own service identity. |
 | ChatterMost | No | Optional one-way announcements through an incoming webhook. |
 
-Node.js 24.22.1+ or 26.13.0+.
+Node.js 24.22.3+ or 26.13.1+.
 
 ## Architecture
 

package/dist/db/database.d.ts

@@ -1,6 +1,6 @@
-import Database from 'better-sqlite3';
+import Database from './sqlite.js';
 import { type Migration } from './migrations.js';
-export type Db = Database.Database;
+export type Db = Database;
 export declare class MigrationError extends Error {
     name: string;
 }

package/dist/db/database.js

@@ -1,7 +1,7 @@
 import { createHash } from 'node:crypto';
 import { chmodSync, mkdirSync } from 'node:fs';
 import { dirname } from 'node:path';
-import Database from 'better-sqlite3';
+import Database from './sqlite.js';
 import { MIGRATIONS } from './migrations.js';
 export class MigrationError extends Error {
     name = 'MigrationError';

package/dist/db/sqlite.d.ts

@@ -0,0 +1,30 @@
+import { StatementSync } from '@photostructure/sqlite';
+type Options = {
+    readonly?: boolean;
+    fileMustExist?: boolean;
+    timeout?: number;
+};
+export declare function assertPatchedSqliteVersion(version: unknown): void;
+/** Application storage boundary. Keep transaction ownership on the same connection. */
+declare class Statement {
+    private readonly statement;
+    constructor(statement: StatementSync);
+    run(...parameters: unknown[]): ReturnType<StatementSync['run']>;
+    get(...parameters: unknown[]): unknown;
+    all(...parameters: unknown[]): unknown[];
+    iterate(...parameters: unknown[]): IterableIterator<unknown>;
+}
+export declare class Database {
+    #private;
+    constructor(path: string, options?: Options);
+    get inTransaction(): boolean;
+    get open(): boolean;
+    prepare(sql: string): Statement;
+    exec(sql: string): this;
+    pragma(sql: string, options?: {
+        simple?: boolean;
+    }): unknown;
+    transaction<F extends (...args: never[]) => unknown>(fn: F): import("@photostructure/sqlite").TransactionFunction<F>;
+    close(): void;
+}
+export default Database;

package/dist/db/sqlite.js

@@ -0,0 +1,72 @@
+import { pathToFileURL } from 'node:url';
+// The native module bundles patched SQLite independently of the host Node version.
+import { DatabaseSync, enhance } from '@photostructure/sqlite';
+function sqliteOperation(action) {
+    try {
+        return action();
+    }
+    catch (error) {
+        if (error instanceof Error && 'sqliteCodeName' in error && typeof error.sqliteCodeName === 'string') {
+            // Preserve native numeric details while keeping existing busy/locked retry behavior.
+            Object.assign(error, { code: error.sqliteCodeName });
+        }
+        throw error;
+    }
+}
+export function assertPatchedSqliteVersion(version) {
+    const match = typeof version === 'string' ? /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)$/.exec(version) : null;
+    if (!match)
+        throw new Error('Cannot verify embedded SQLite version');
+    const [major, minor, patch] = match.slice(1).map(Number);
+    if (major === undefined || minor === undefined || patch === undefined ||
+        !(major > 3 || (major === 3 && (minor > 54 || (minor === 54 && patch >= 1))))) {
+        throw new Error('Embedded SQLite 3.54.1 or later is required');
+    }
+}
+/** Application storage boundary. Keep transaction ownership on the same connection. */
+class Statement {
+    statement;
+    constructor(statement) {
+        this.statement = statement;
+    }
+    run(...parameters) { return sqliteOperation(() => this.statement.run(...parameters)); }
+    get(...parameters) { return sqliteOperation(() => this.statement.get(...parameters)); }
+    all(...parameters) { return sqliteOperation(() => this.statement.all(...parameters)); }
+    iterate(...parameters) { return this.statement.iterate(...parameters); }
+}
+export class Database {
+    #database;
+    constructor(path, options = {}) {
+        let location = path;
+        if (options.fileMustExist) {
+            if (path === ':memory:')
+                throw new Error('An existing on-disk database is required');
+            const uri = pathToFileURL(path);
+            uri.searchParams.set('mode', options.readonly ? 'ro' : 'rw');
+            location = uri;
+        }
+        this.#database = enhance(new DatabaseSync(location, {
+            readOnly: options.readonly ?? false,
+            timeout: options.timeout ?? 5000,
+        }));
+        try {
+            const row = this.#database.prepare('SELECT sqlite_version() AS version').get();
+            assertPatchedSqliteVersion(row !== null && typeof row === 'object' && 'version' in row ? row.version : undefined);
+        }
+        catch (error) {
+            this.#database.close();
+            throw error;
+        }
+    }
+    get inTransaction() { return this.#database.isTransaction; }
+    get open() { return this.#database.isOpen; }
+    prepare(sql) { return new Statement(sqliteOperation(() => this.#database.prepare(sql))); }
+    exec(sql) { sqliteOperation(() => this.#database.exec(sql)); return this; }
+    pragma(sql, options) { return sqliteOperation(() => this.#database.pragma(sql, options)); }
+    transaction(fn) {
+        return this.#database.transaction(fn);
+    }
+    close() { if (this.#database.isOpen)
+        this.#database.close(); }
+}
+export default Database;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hivemagnus/ardent-studio",
-  "version": "0.1.1",
+  "version": "0.2.1",
   "description": "Ardent Project Studio service: projects, team assignment, conversation room and deliverable review for Ardent agents managed by Magnus",
   "keywords": [
     "ardent",
@@ -38,7 +38,7 @@
     }
   },
   "engines": {
-    "node": "^24.22.1 || ^26.13.0"
+    "node": "^24.22.3 || ^26.13.1"
   },
   "publishConfig": {
     "access": "public"
@@ -69,17 +69,16 @@
   "dependencies": {
     "@hivemagnus/magnus-contracts": "2.2.0",
     "@hono/node-server": "^2.1.5",
-    "better-sqlite3": "^13.0.3",
     "fflate": "^0.8.3",
-    "hono": "^4.13.17",
+    "hono": "^4.13.18",
     "jose": "^6.2.15",
     "pdfjs-dist": "^6.5.438",
     "yaml": "2.9.1",
-    "zod": "^4.6.7"
+    "zod": "^4.6.7",
+    "@photostructure/sqlite": "3.3.1"
   },
   "devDependencies": {
     "@apidevtools/swagger-parser": "^13.1.0",
-    "@types/better-sqlite3": "^9.6.0",
     "@types/node": "^24.19.2",
     "eslint": "10.14.0",
     "tsx": "^4.23.15",
@@ -88,8 +87,8 @@
     "vitest": "^5.0.5"
   },
   "allowScripts": {
-    "better-sqlite3@13.0.3": true,
-    "esbuild@0.28.2": true
+    "esbuild@0.28.2": true,
+    "@photostructure/sqlite@3.3.1": true
   },
   "overrides": {
     "minimatch": "11.0.5"