kiokuko 1.0.0

package/dist/db/capabilities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.js","sourceRoot":"","sources":["../../src/db/capabilities.ts"],"names":[],"mappings":"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"}

package/dist/db/connection.d.ts

@@ -0,0 +1,21 @@
+import { NodeSqliteAdapter } from './adapter.js';
+import { KiokukoError } from '../errors.js';
+import { type SqliteVecLoader } from '../embedding/sqlite-vec-loader.js';
+export interface DatabaseFileIdentity {
+    readonly device: bigint;
+    readonly inode: bigint;
+}
+export interface ConnectionOptions {
+    readonly readOnly?: boolean;
+    readonly expectedFileIdentity?: DatabaseFileIdentity;
+    readonly sqliteVecLoader?: SqliteVecLoader;
+}
+/** Internal discriminator for failures caused specifically by sqlite-vec loading. */
+export declare class SqliteVecLoadError extends KiokukoError {
+    constructor(message: string, cause?: unknown);
+}
+export declare function databaseFileIdentity(filePath: string): DatabaseFileIdentity;
+export declare function sameDatabaseFileIdentity(left: DatabaseFileIdentity, right: DatabaseFileIdentity): boolean;
+export declare function requireDatabaseFileIdentity(filePath: string, expected: DatabaseFileIdentity): void;
+export declare function openConnection(filePath: string, options?: ConnectionOptions): NodeSqliteAdapter;
+//# sourceMappingURL=connection.d.ts.map

package/dist/db/connection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../../src/db/connection.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEjD,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAEL,KAAK,eAAe,EACrB,MAAM,mCAAmC,CAAC;AAE3C,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;IACrD,QAAQ,CAAC,eAAe,CAAC,EAAE,eAAe,CAAC;CAC5C;AAED,qFAAqF;AACrF,qBAAa,kBAAmB,SAAQ,YAAY;gBACtC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAK7C;AAyCD,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,oBAAoB,CAM3E;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,oBAAoB,EAAE,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAEzG;AAED,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,oBAAoB,GAAG,IAAI,CAkBlG;AAMD,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,iBAAsB,GAAG,iBAAiB,CAyCnG"}

package/dist/db/connection.js

@@ -0,0 +1,129 @@
+import { DatabaseSync } from 'node:sqlite';
+import { dirname } from 'node:path';
+import { chmodSync, lstatSync, mkdirSync } from 'node:fs';
+import { NodeSqliteAdapter } from './adapter.js';
+import { withSqliteLockRetry } from './sqlite-retry.js';
+import { KiokukoError } from '../errors.js';
+import { isSqliteVecLoader, } from '../embedding/sqlite-vec-loader.js';
+/** Internal discriminator for failures caused specifically by sqlite-vec loading. */
+export class SqliteVecLoadError extends KiokukoError {
+    constructor(message, cause) {
+        super('SERVICE_UNAVAILABLE', message);
+        this.name = 'SqliteVecLoadError';
+        if (cause !== undefined)
+            Object.defineProperty(this, 'cause', { value: cause });
+    }
+}
+function requireSqliteVecLoader(value) {
+    if (value === undefined)
+        return undefined;
+    if (!isSqliteVecLoader(value)) {
+        throw new KiokukoError('VALIDATION_ERROR', 'The SQLite extension loader is not the known sqlite-vec loader');
+    }
+    return value;
+}
+function loadSqliteVec(database, loader) {
+    let failure;
+    let failed = false;
+    let loadingDisabled = false;
+    try {
+        loader.load(database);
+        database.enableLoadExtension(false);
+        loadingDisabled = true;
+        const version = database.prepare('SELECT vec_version() AS version').get()?.version;
+        if (version !== loader.extensionVersion) {
+            throw new SqliteVecLoadError('The loaded sqlite-vec version is unsupported');
+        }
+    }
+    catch (error) {
+        failure = error;
+        failed = true;
+    }
+    if (!loadingDisabled) {
+        try {
+            database.enableLoadExtension(false);
+        }
+        catch (disableError) {
+            failure = failed
+                ? new AggregateError([failure, disableError], 'sqlite-vec loading failed and disabling extension loading also failed')
+                : disableError;
+            failed = true;
+        }
+    }
+    if (!failed)
+        return;
+    if (failure instanceof SqliteVecLoadError)
+        throw failure;
+    throw new SqliteVecLoadError('The sqlite-vec extension could not be loaded', failure);
+}
+export function databaseFileIdentity(filePath) {
+    const status = lstatSync(filePath, { bigint: true });
+    if (!status.isFile()) {
+        throw new KiokukoError('INTEGRITY_ERROR', 'SQLite database path is not a regular non-symbolic-link file');
+    }
+    return Object.freeze({ device: status.dev, inode: status.ino });
+}
+export function sameDatabaseFileIdentity(left, right) {
+    return left.device === right.device && left.inode === right.inode;
+}
+export function requireDatabaseFileIdentity(filePath, expected) {
+    let actual;
+    try {
+        actual = databaseFileIdentity(filePath);
+    }
+    catch (error) {
+        const failure = new KiokukoError('CONFLICT', 'SQLite database file identity changed during initialization');
+        Object.defineProperty(failure, 'cause', { value: error });
+        throw failure;
+    }
+    if (!sameDatabaseFileIdentity(actual, expected)) {
+        throw new KiokukoError('CONFLICT', 'SQLite database file identity changed during initialization');
+    }
+}
+function configureJournalMode(database) {
+    withSqliteLockRetry(() => database.exec('PRAGMA journal_mode = WAL;'));
+}
+export function openConnection(filePath, options = {}) {
+    const sqliteVecLoader = requireSqliteVecLoader(options.sqliteVecLoader);
+    if (filePath !== ':memory:') {
+        mkdirSync(dirname(filePath), { recursive: true, mode: 0o700 });
+    }
+    const database = new DatabaseSync(filePath, {
+        enableForeignKeyConstraints: true,
+        timeout: 5000,
+        ...(sqliteVecLoader === undefined ? {} : { allowExtension: true }),
+        ...(options.readOnly === undefined ? {} : { readOnly: options.readOnly }),
+    });
+    try {
+        if (options.expectedFileIdentity !== undefined) {
+            if (filePath === ':memory:') {
+                throw new KiokukoError('VALIDATION_ERROR', 'An in-memory database cannot have a file identity');
+            }
+            // This check deliberately precedes chmod and every writable PRAGMA.
+            requireDatabaseFileIdentity(filePath, options.expectedFileIdentity);
+        }
+        if (filePath !== ':memory:' && !options.readOnly)
+            chmodSync(filePath, 0o600);
+        database.exec(`
+      PRAGMA foreign_keys = ON;
+      PRAGMA busy_timeout = 5000;
+    `);
+        if (!options.readOnly) {
+            configureJournalMode(database);
+            database.exec('PRAGMA synchronous = NORMAL;');
+        }
+        if (sqliteVecLoader !== undefined)
+            loadSqliteVec(database, sqliteVecLoader);
+        return new NodeSqliteAdapter(filePath, database);
+    }
+    catch (error) {
+        try {
+            database.close();
+        }
+        catch (closeError) {
+            throw new AggregateError([error, closeError], 'SQLite connection initialization failed and closing it also failed');
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=connection.js.map

package/dist/db/connection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.js","sourceRoot":"","sources":["../../src/db/connection.ts"],"names":[],"mappings":"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"}

package/dist/db/inspection-snapshot.d.ts

@@ -0,0 +1,4 @@
+import { type DatabaseFileIdentity, openConnection } from './connection.js';
+/** Retry only a snapshot invalidated by ordinary concurrent SQLite writes. */
+export declare function inspectDatabaseWithoutSideEffects<T>(source: string, identity: DatabaseFileIdentity, inspect: (database: ReturnType<typeof openConnection>) => T): Promise<T>;
+//# sourceMappingURL=inspection-snapshot.d.ts.map

package/dist/db/inspection-snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspection-snapshot.d.ts","sourceRoot":"","sources":["../../src/db/inspection-snapshot.ts"],"names":[],"mappings":"AAKA,OAAO,EAAqD,KAAK,oBAAoB,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAgE/H,8EAA8E;AAC9E,wBAAsB,iCAAiC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,oBAAoB,EAAE,OAAO,EAAE,CAAC,QAAQ,EAAE,UAAU,CAAC,OAAO,cAAc,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAQlL"}

package/dist/db/inspection-snapshot.js

@@ -0,0 +1,86 @@
+import { setTimeout as delay } from 'node:timers/promises';
+import { copyFileSync, lstatSync, mkdtempSync, rmSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import path from 'node:path';
+import { KiokukoError } from '../errors.js';
+import { databaseFileIdentity, requireDatabaseFileIdentity, openConnection } from './connection.js';
+function fileState(file) {
+    try {
+        const state = lstatSync(file, { bigint: true });
+        if (!state.isFile() || state.isSymbolicLink())
+            throw new KiokukoError('INTEGRITY_ERROR', 'Database inspection requires regular database and WAL files');
+        return state;
+    }
+    catch (error) {
+        if (error instanceof Error && 'code' in error && error.code === 'ENOENT')
+            return undefined;
+        throw error;
+    }
+}
+function unchanged(before, after) {
+    if (before === undefined || after === undefined)
+        return before === after;
+    return before.dev === after.dev && before.ino === after.ino && before.size === after.size
+        && before.mtimeNs === after.mtimeNs && before.ctimeNs === after.ctimeNs;
+}
+/**
+ * Inspect an isolated database/WAL copy. SQLite read-only connections still
+ * update shared-memory read marks, so opening the source would violate the
+ * no-side-effects contract for unsupported databases. A concurrent writer or
+ * checkpoint makes the snapshot uncertain and must force a fresh attempt.
+ */
+function inspectSnapshot(source, identity, inspect) {
+    requireDatabaseFileIdentity(source, identity);
+    const before = [fileState(source), fileState(`${source}-wal`)];
+    const directory = mkdtempSync(path.join(tmpdir(), 'kiokuko-db-inspection-'));
+    const target = path.join(directory, 'database.sqlite3');
+    let database;
+    try {
+        copyFileSync(source, target);
+        if (before[1] !== undefined) {
+            try {
+                copyFileSync(`${source}-wal`, `${target}-wal`);
+            }
+            catch (error) {
+                if (error instanceof Error && 'code' in error && error.code === 'ENOENT') {
+                    requireDatabaseFileIdentity(source, identity);
+                    if (!unchanged(before[1], fileState(`${source}-wal`))) {
+                        // Closing the last writer can checkpoint and remove the WAL after
+                        // stat. The main copy may predate that checkpoint, so retry both.
+                        throw new KiokukoError('CONFLICT', 'Database changed during read-only inspection; retry', { retryInspection: true });
+                    }
+                }
+                throw error;
+            }
+        }
+        requireDatabaseFileIdentity(source, identity);
+        const after = [fileState(source), fileState(`${source}-wal`)];
+        if (!before.every((state, index) => unchanged(state, after[index]))) {
+            throw new KiokukoError('CONFLICT', 'Database changed during read-only inspection; retry', { retryInspection: true });
+        }
+        database = openConnection(target, { readOnly: true, expectedFileIdentity: databaseFileIdentity(target) });
+        return inspect(database);
+    }
+    finally {
+        try {
+            database?.close();
+        }
+        finally {
+            rmSync(directory, { recursive: true, force: true });
+        }
+    }
+}
+/** Retry only a snapshot invalidated by ordinary concurrent SQLite writes. */
+export async function inspectDatabaseWithoutSideEffects(source, identity, inspect) {
+    for (let attempt = 0;; attempt += 1) {
+        try {
+            return inspectSnapshot(source, identity, inspect);
+        }
+        catch (error) {
+            if (!(error instanceof KiokukoError) || error.code !== 'CONFLICT' || error.details.retryInspection !== true || attempt >= 7)
+                throw error;
+            await delay(Math.min(50, 5 * 2 ** attempt));
+        }
+    }
+}
+//# sourceMappingURL=inspection-snapshot.js.map

package/dist/db/inspection-snapshot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspection-snapshot.js","sourceRoot":"","sources":["../../src/db/inspection-snapshot.ts"],"names":[],"mappings":"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"}

package/dist/db/migrate.d.ts

@@ -0,0 +1,37 @@
+import type { SqliteDatabase } from './adapter.js';
+export interface MigrationResult {
+    applied: number[];
+    currentVersion: number;
+}
+export interface MigrationPlan {
+    readonly applied: readonly number[];
+    readonly pending: readonly number[];
+    readonly databaseVersion: number;
+    readonly currentVersion: number;
+    readonly migrations: readonly MigrationSource[];
+}
+export interface MigrationIdentity {
+    readonly version: number;
+    readonly name: string;
+}
+export interface MigrationSource extends MigrationIdentity {
+    readonly checksum: string;
+    readonly sql: string;
+}
+export interface MigrationSnapshot {
+    readonly migrations: readonly MigrationSource[];
+}
+export interface MigrationHooks {
+    /**
+     * Runs after a pending migration's SQL and before its schema marker is
+     * written. The hook is inside the same SQLite transaction as both steps.
+     */
+    readonly beforeMarkApplied?: (database: SqliteDatabase, migration: MigrationIdentity) => void;
+}
+export declare function defaultMigrationsDirectory(): string;
+export declare function loadMigrationSnapshot(directory?: string): MigrationSnapshot;
+export declare function inspectMigrationSnapshot(database: SqliteDatabase, snapshot: MigrationSnapshot): MigrationPlan;
+/** Apply an already-loaded migration snapshot inside a transaction owned by the caller. */
+export declare function migrateDatabaseSnapshotInTransaction(database: SqliteDatabase, snapshot: MigrationSnapshot, hooks?: MigrationHooks): MigrationResult;
+export declare function migrateDatabase(database: SqliteDatabase, directory?: string, hooks?: MigrationHooks): MigrationResult;
+//# sourceMappingURL=migrate.d.ts.map

package/dist/db/migrate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate.d.ts","sourceRoot":"","sources":["../../src/db/migrate.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,cAAc,EAAa,MAAM,cAAc,CAAC;AAG9D,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,UAAU,EAAE,SAAS,eAAe,EAAE,CAAC;CACjD;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,eAAgB,SAAQ,iBAAiB;IACxD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,UAAU,EAAE,SAAS,eAAe,EAAE,CAAC;CACjD;AAED,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,QAAQ,CAAC,iBAAiB,CAAC,EAAE,CAAC,QAAQ,EAAE,cAAc,EAAE,SAAS,EAAE,iBAAiB,KAAK,IAAI,CAAC;CAC/F;AAYD,wBAAgB,0BAA0B,IAAI,MAAM,CAEnD;AAED,wBAAgB,qBAAqB,CAAC,SAAS,SAA+B,GAAG,iBAAiB,CA4EjG;AAuGD,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,cAAc,EAAE,QAAQ,EAAE,iBAAiB,GAAG,aAAa,CAE7G;AAsDD,2FAA2F;AAC3F,wBAAgB,oCAAoC,CAClD,QAAQ,EAAE,cAAc,EACxB,QAAQ,EAAE,iBAAiB,EAC3B,KAAK,GAAE,cAAmB,GACzB,eAAe,CAEjB;AAED,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,cAAc,EACxB,SAAS,SAA+B,EACxC,KAAK,GAAE,cAAmB,GACzB,eAAe,CASjB"}

package/dist/db/migrate.js

@@ -0,0 +1,202 @@
+import { createHash } from 'node:crypto';
+import { readFileSync, readdirSync } from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { TextDecoder } from 'node:util';
+import { KiokukoError } from '../errors.js';
+import { withImmediateTransaction } from './transaction.js';
+const MIGRATION_FILE = /^([0-9]{3})_([a-z0-9_-]+)\.sql$/;
+const loadedMigrationSnapshots = new WeakSet();
+const fatalUtf8Decoder = new TextDecoder('utf-8', { fatal: true, ignoreBOM: true });
+export function defaultMigrationsDirectory() {
+    return fileURLToPath(new URL('../../migrations/', import.meta.url));
+}
+export function loadMigrationSnapshot(directory = defaultMigrationsDirectory()) {
+    const migrations = readdirSync(directory)
+        .map((name) => {
+        const match = MIGRATION_FILE.exec(name);
+        if (!match) {
+            if (/\.sql$/iu.test(name)) {
+                throw new KiokukoError('INTEGRITY_ERROR', `Migration filename is not canonical: ${name}`, { name });
+            }
+            return undefined;
+        }
+        const version = Number(match[1]);
+        const bytes = readFileSync(path.join(directory, name));
+        if (bytes.subarray(0, 3).equals(Buffer.from([0xEF, 0xBB, 0xBF]))) {
+            throw new KiokukoError('INTEGRITY_ERROR', `Migration file ${name} has a non-canonical UTF-8 BOM`);
+        }
+        let sql;
+        try {
+            sql = fatalUtf8Decoder.decode(bytes);
+        }
+        catch (error) {
+            const failure = new KiokukoError('INTEGRITY_ERROR', `Migration file ${name} is not valid UTF-8`);
+            Object.defineProperty(failure, 'cause', { value: error });
+            throw failure;
+        }
+        if (sql.includes('\r')) {
+            throw new KiokukoError('INTEGRITY_ERROR', `Migration file ${name} has non-canonical line endings; use LF only`);
+        }
+        return {
+            version,
+            name,
+            sql,
+            checksum: createHash('sha256').update(bytes).digest('hex'),
+        };
+    })
+        .filter((migration) => migration !== undefined)
+        .sort((left, right) => left.version - right.version);
+    if (migrations.length === 0) {
+        throw new KiokukoError('INTEGRITY_ERROR', 'Migration directory contains no versioned migration files');
+    }
+    const versions = new Set();
+    for (const migration of migrations) {
+        if (!Number.isSafeInteger(migration.version) || migration.version < 1) {
+            throw new KiokukoError('INTEGRITY_ERROR', `Migration version is invalid for ${migration.name}`);
+        }
+        if (versions.has(migration.version)) {
+            throw new KiokukoError('INTEGRITY_ERROR', `Migration version ${migration.version} is duplicated`);
+        }
+        versions.add(migration.version);
+    }
+    for (const [index, migration] of migrations.entries()) {
+        const expectedVersion = index + 1;
+        if (migration.version !== expectedVersion) {
+            throw new KiokukoError('INTEGRITY_ERROR', `Migration files must form an exact contiguous sequence starting at version 1; expected ${expectedVersion} but found ${migration.version}`, { expectedVersion, actualVersion: migration.version, name: migration.name });
+        }
+    }
+    const snapshot = Object.freeze({
+        migrations: Object.freeze(migrations.map((migration) => Object.freeze(migration))),
+    });
+    loadedMigrationSnapshots.add(snapshot);
+    return snapshot;
+}
+function requireLoadedMigrationSnapshot(snapshot) {
+    if (!loadedMigrationSnapshots.has(snapshot)) {
+        throw new KiokukoError('INTEGRITY_ERROR', 'Migration snapshot was not produced by the validated snapshot loader');
+    }
+    return snapshot.migrations;
+}
+function hasMigrationTable(database) {
+    return Boolean(database.prepare(`
+    SELECT 1 AS present
+    FROM sqlite_master
+    WHERE type = 'table' AND name = 'schema_migrations'
+  `).get());
+}
+function appliedMigrationRows(database) {
+    if (!hasMigrationTable(database))
+        return [];
+    return database.prepare(`
+    SELECT version, name, checksum
+    FROM schema_migrations
+    ORDER BY version
+  `).all();
+}
+function appliedMigrationVersion(value) {
+    if (typeof value === 'number' && Number.isSafeInteger(value) && value >= 1)
+        return value;
+    throw new KiokukoError('INTEGRITY_ERROR', 'Database migration history contains an invalid version');
+}
+function migrationPlan(database, migrations) {
+    const currentVersion = migrations.at(-1)?.version ?? 0;
+    const byVersion = new Map(migrations.map((migration) => [migration.version, migration]));
+    const rows = appliedMigrationRows(database);
+    if (rows.length === 0 && database.prepare("SELECT 1 FROM sqlite_schema WHERE name NOT LIKE 'sqlite_%' LIMIT 1").get()) {
+        // The migration table itself is created only after this check. An empty
+        // history on an existing non-empty database is not a fresh installation.
+        const other = database.prepare("SELECT 1 FROM sqlite_schema WHERE name NOT LIKE 'sqlite_%' AND name != 'schema_migrations' LIMIT 1").get();
+        if (other || hasMigrationTable(database))
+            throw new KiokukoError('INTEGRITY_ERROR', 'Database has no supported migration history; initialize a new database');
+    }
+    const applied = [];
+    const seenVersions = new Set();
+    for (const row of rows) {
+        const version = appliedMigrationVersion(row.version);
+        if (seenVersions.has(version)) {
+            throw new KiokukoError('INTEGRITY_ERROR', `Database migration history contains duplicate version ${version}`, { version });
+        }
+        seenVersions.add(version);
+        const migration = byVersion.get(version);
+        if (!migration) {
+            if (version > currentVersion) {
+                throw new KiokukoError('INTEGRITY_ERROR', `Database schema version ${version} is newer than this Kiokuko binary supports (${currentVersion})`, { databaseVersion: version, supportedVersion: currentVersion });
+            }
+            throw new KiokukoError('INTEGRITY_ERROR', `Database migration version ${version} is not supported by this Kiokuko binary`);
+        }
+        if (typeof row.name !== 'string' || typeof row.checksum !== 'string') {
+            throw new KiokukoError('INTEGRITY_ERROR', `Database migration history contains invalid metadata for version ${version}`, { version });
+        }
+        if (row.name !== migration.name || row.checksum !== migration.checksum) {
+            throw new KiokukoError('INTEGRITY_ERROR', `Migration checksum mismatch for ${migration.name}`, { version: migration.version, name: migration.name });
+        }
+        applied.push(version);
+    }
+    for (const [index, version] of applied.entries()) {
+        const expectedVersion = index + 1;
+        if (version !== expectedVersion) {
+            throw new KiokukoError('INTEGRITY_ERROR', 'Database migration history is not a contiguous prefix');
+        }
+    }
+    const appliedSet = new Set(applied);
+    return {
+        applied: Object.freeze(applied),
+        pending: Object.freeze(migrations.filter((migration) => !appliedSet.has(migration.version)).map((migration) => migration.version)),
+        databaseVersion: applied.at(-1) ?? 0,
+        currentVersion,
+        migrations,
+    };
+}
+export function inspectMigrationSnapshot(database, snapshot) {
+    return migrationPlan(database, requireLoadedMigrationSnapshot(snapshot));
+}
+function applyOneInTransaction(database, migration, hooks) {
+    const existing = database
+        .prepare('SELECT checksum FROM schema_migrations WHERE version = ?')
+        .get(migration.version);
+    if (existing) {
+        if (typeof existing.checksum !== 'string' || existing.checksum !== migration.checksum) {
+            throw new KiokukoError('INTEGRITY_ERROR', `Migration checksum mismatch for ${migration.name}`, { version: migration.version, name: migration.name });
+        }
+        return { applied: false };
+    }
+    database.exec(migration.sql);
+    hooks.beforeMarkApplied?.(database, { version: migration.version, name: migration.name });
+    database
+        .prepare('INSERT INTO schema_migrations (version, name, checksum, applied_at) VALUES (?, ?, ?, ?)')
+        .run(migration.version, migration.name, migration.checksum, new Date().toISOString());
+    return { applied: true };
+}
+function applyMigrationSetInTransaction(database, migrations, hooks) {
+    // Revalidate the database state after the writer transaction begins.
+    migrationPlan(database, migrations);
+    database.exec(`
+    CREATE TABLE IF NOT EXISTS schema_migrations (
+      version INTEGER PRIMARY KEY,
+      name TEXT NOT NULL,
+      checksum TEXT NOT NULL,
+      applied_at TEXT NOT NULL
+    );
+  `);
+    const applied = [];
+    for (const migration of migrations) {
+        const result = applyOneInTransaction(database, migration, hooks);
+        if (result.applied)
+            applied.push(migration.version);
+    }
+    const currentVersion = migrations.at(-1)?.version ?? 0;
+    return { applied, currentVersion };
+}
+/** Apply an already-loaded migration snapshot inside a transaction owned by the caller. */
+export function migrateDatabaseSnapshotInTransaction(database, snapshot, hooks = {}) {
+    return applyMigrationSetInTransaction(database, requireLoadedMigrationSnapshot(snapshot), hooks);
+}
+export function migrateDatabase(database, directory = defaultMigrationsDirectory(), hooks = {}) {
+    const migrations = loadMigrationSnapshot(directory).migrations;
+    // Fail on unsupported history before beginning a write transaction, then
+    // repeat the check under the lock in applyMigrationSetInTransaction.
+    migrationPlan(database, migrations);
+    return withImmediateTransaction(database, () => applyMigrationSetInTransaction(database, migrations, hooks));
+}
+//# sourceMappingURL=migrate.js.map

package/dist/db/migrate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate.js","sourceRoot":"","sources":["../../src/db/migrate.ts"],"names":[],"mappings":"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"}

package/dist/db/serialized-backup.d.ts

@@ -0,0 +1,58 @@
+import { constants } from 'node:fs';
+import type { SqliteSerializationDatabase } from './adapter.js';
+export interface BackupArtifactAttestation {
+    readonly device: bigint;
+    readonly inode: bigint;
+    readonly owner: bigint;
+    readonly group: bigint;
+    readonly mode: bigint;
+    readonly size: bigint;
+    readonly linkCount: bigint;
+    readonly sha256: string;
+}
+export interface BackupDirectoryAttestation {
+    readonly path: string;
+    readonly device: bigint;
+    readonly inode: bigint;
+    readonly owner: bigint;
+    readonly group: bigint;
+    readonly mode: bigint;
+}
+export interface SerializedBackupArtifact {
+    readonly path: string;
+    readonly directory: BackupDirectoryAttestation;
+    readonly artifact: BackupArtifactAttestation;
+}
+export interface BackupCreationHooks {
+    /** Runs immediately before serializing the already-open source connection. */
+    readonly beforeSerialization?: () => void | Promise<void>;
+    /** Runs after the backup directory inode is bound, before the backup worker starts. */
+    readonly afterDirectoryBound?: () => void | Promise<void>;
+    /** Runs with the unpredictable output name before its create-only open. */
+    readonly beforeArtifactWrite?: (output: string) => void | Promise<void>;
+    /** Runs after the worker attests the artifact, before it is handed to init. */
+    readonly afterArtifactWritten?: (output: string) => void | Promise<void>;
+}
+export interface SerializedBackupCreationHooks extends BackupCreationHooks {
+    /** Runs with the canonical output path before source serialization or filesystem mutation. */
+    readonly validateDestination?: (output: string) => void | Promise<void>;
+}
+export interface PosixBackupOpenFlags {
+    readonly directory: number;
+    readonly noFollow: number;
+    readonly nonBlock: number;
+}
+type BackupOpenFlagConstants = Pick<typeof constants, 'O_DIRECTORY' | 'O_NOFOLLOW' | 'O_NONBLOCK'>;
+/**
+ * Resolve the pathname-safety flags as one mandatory POSIX capability. A
+ * supported non-Windows runtime must provide every flag; dropping one to zero
+ * would silently remove the directory, no-follow, or nonblocking guarantee.
+ */
+export declare function requirePosixBackupOpenFlags(platform?: NodeJS.Platform, openFlags?: Partial<BackupOpenFlagConstants>): PosixBackupOpenFlags | undefined;
+/**
+ * Serialize the exact already-open source and install one create-only backup.
+ * The output directory must already exist and is never chmodded by this path.
+ */
+export declare function createSerializedBackupArtifact(database: SqliteSerializationDatabase, destination: string, hooks?: SerializedBackupCreationHooks): Promise<SerializedBackupArtifact>;
+export {};
+//# sourceMappingURL=serialized-backup.d.ts.map

package/dist/db/serialized-backup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialized-backup.d.ts","sourceRoot":"","sources":["../../src/db/serialized-backup.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAMpC,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,cAAc,CAAC;AAahE,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,0BAA0B,CAAC;IAC/C,QAAQ,CAAC,QAAQ,EAAE,yBAAyB,CAAC;CAC9C;AAED,MAAM,WAAW,mBAAmB;IAClC,8EAA8E;IAC9E,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D,uFAAuF;IACvF,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D,2EAA2E;IAC3E,QAAQ,CAAC,mBAAmB,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxE,+EAA+E;IAC/E,QAAQ,CAAC,oBAAoB,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1E;AAED,MAAM,WAAW,6BAA8B,SAAQ,mBAAmB;IACxE,8FAA8F;IAC9F,QAAQ,CAAC,mBAAmB,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACzE;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,KAAK,uBAAuB,GAAG,IAAI,CACjC,OAAO,SAAS,EAChB,aAAa,GAAG,YAAY,GAAG,YAAY,CAC5C,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,2BAA2B,CACzC,QAAQ,GAAE,MAAM,CAAC,QAA2B,EAC5C,SAAS,GAAE,OAAO,CAAC,uBAAuB,CAAa,GACtD,oBAAoB,GAAG,SAAS,CAkBlC;AAknBD;;;GAGG;AACH,wBAAsB,8BAA8B,CAClD,QAAQ,EAAE,2BAA2B,EACrC,WAAW,EAAE,MAAM,EACnB,KAAK,GAAE,6BAAkC,GACxC,OAAO,CAAC,wBAAwB,CAAC,CA2CnC"}