@codetreker/daynight 0.29.0 → 0.31.0

package/dist/platform/sqlite-error.js

@@ -0,0 +1,36 @@
+export class SqliteAccessError extends Error {
+    kind;
+    context;
+    outcome;
+    connectionClosed;
+    constructor(kind, context, options = {}) {
+        const versions = context.fromVersion === undefined ? "" : ` from version ${context.fromVersion}${context.toVersion === undefined ? "" : ` to ${context.toVersion}`}`;
+        super(`SQLite ${context.database} ${context.phase}${versions}: ${kind}.`, options.cause === undefined ? undefined : { cause: options.cause });
+        this.name = "SqliteAccessError";
+        this.kind = kind;
+        this.context = context;
+        this.outcome = options.outcome === undefined ? "not-started" : options.outcome;
+        this.connectionClosed = options.connectionClosed === true;
+    }
+}
+const safeCode = (error) => {
+    if (typeof error !== "object" || error === null || !("code" in error) || typeof error.code !== "string")
+        return undefined;
+    return /^(SQLITE_[A-Z_]+|E[A-Z0-9]+)$/.test(error.code) ? error.code : undefined;
+};
+/** Raw parser and SQLite messages can contain stored values; retain them only in memory. */
+export const serializeSqliteError = (error, depth = 0) => {
+    const code = safeCode(error);
+    const base = { name: error instanceof Error ? error.name : "UnknownError", ...(code === undefined ? {} : { sqliteCode: code }) };
+    if (error instanceof SqliteAccessError)
+        Object.assign(base, { kind: error.kind, message: error.message, ...error.context, outcome: error.outcome });
+    if (depth < 6 && error instanceof Error) {
+        if (error.cause !== undefined)
+            base.cause = serializeSqliteError(error.cause, depth + 1);
+        if (error instanceof AggregateError)
+            base.errors = error.errors.map((item) => serializeSqliteError(item, depth + 1));
+    }
+    return base;
+};
+export const formatSqliteError = (error) => JSON.stringify(serializeSqliteError(error));
+//# sourceMappingURL=sqlite-error.js.map

package/dist/platform/sqlite-error.js.map

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

package/dist/platform/sqlite-format.d.ts

@@ -0,0 +1,31 @@
+import type Database from "better-sqlite3";
+export type SqliteMigration = {
+    readonly toVersion: number;
+    readonly up: (db: Database.Database) => undefined;
+};
+export type SqliteFormat = {
+    readonly name: string;
+    readonly baseline: {
+        readonly version: number;
+        readonly create: (db: Database.Database) => undefined;
+    };
+    readonly migrations: readonly SqliteMigration[];
+    readonly validateVersioned: (db: Database.Database, version: number) => undefined;
+};
+export type SqliteSource = {
+    readonly kind: "empty" | "unversioned";
+    readonly version: 0;
+} | {
+    readonly kind: "outdated" | "current";
+    readonly version: number;
+};
+export type SqliteTransition = {
+    readonly fromVersion: number;
+    readonly toVersion: number;
+    readonly initialized: boolean;
+    readonly reset: boolean;
+};
+export declare const currentSqliteVersion: (format: SqliteFormat) => number;
+export declare const inspectSqlite: (db: Database.Database, format: SqliteFormat) => SqliteSource;
+export declare const assertCurrentSqlite: (db: Database.Database, format: SqliteFormat) => undefined;
+export declare const upgradeSqlite: (db: Database.Database, format: SqliteFormat) => SqliteTransition | null;

package/dist/platform/sqlite-format.js

@@ -0,0 +1,98 @@
+import { SqliteAccessError } from "./sqlite-error.js";
+const validVersion = (value) => Number.isInteger(value) && value > 0 && value <= 2_147_483_647;
+export const currentSqliteVersion = (format) => {
+    if (!validVersion(format.baseline.version))
+        throw new TypeError("SQLite baseline must be a positive signed 32-bit integer.");
+    let current = format.baseline.version;
+    for (const migration of format.migrations) {
+        if (!validVersion(migration.toVersion) || migration.toVersion !== current + 1)
+            throw new TypeError("SQLite migration versions must be consecutive after the baseline.");
+        current = migration.toVersion;
+    }
+    return current;
+};
+const versionOf = (db) => db.pragma("user_version", { simple: true });
+const invalid = (format, version, cause) => new SqliteAccessError("invalid-format", { database: format.name, phase: "inspect", fromVersion: version, toVersion: currentSqliteVersion(format) }, cause === undefined ? {} : { cause });
+export const inspectSqlite = (db, format) => {
+    const target = currentSqliteVersion(format), version = versionOf(db);
+    if (!Number.isInteger(version) || version < 0 || version > target || version !== 0 && version < format.baseline.version)
+        throw new SqliteAccessError("unsupported-version", { database: format.name, phase: "inspect", fromVersion: version, toVersion: target });
+    try {
+        if (version === 0) {
+            const objects = db.prepare("SELECT name FROM sqlite_schema WHERE name NOT GLOB 'sqlite_*'").all();
+            return { kind: objects.length === 0 ? "empty" : "unversioned", version: 0 };
+        }
+        format.validateVersioned(db, version);
+        return { kind: version === target ? "current" : "outdated", version };
+    }
+    catch (cause) {
+        if (cause instanceof SqliteAccessError)
+            throw cause;
+        throw invalid(format, version, cause);
+    }
+};
+export const assertCurrentSqlite = (db, format) => {
+    if (!db.inTransaction)
+        throw new Error("SQLite format assertion requires a transaction.");
+    const version = versionOf(db), target = currentSqliteVersion(format);
+    if (version !== target)
+        throw new SqliteAccessError("unsupported-version", { database: format.name, phase: "assert-current", fromVersion: version, toVersion: target });
+};
+const quoteIdentifier = (name) => `"${name.replaceAll('"', '""')}"`;
+const resetUnversionedSqlite = (db) => {
+    if (db.pragma("foreign_keys", { simple: true }) !== 0)
+        throw new Error("SQLite unversioned reset requires foreign_keys=OFF before beginning the transaction.");
+    const objects = db.prepare("SELECT name, type FROM main.sqlite_schema WHERE type IN ('trigger', 'view') AND name NOT GLOB 'sqlite_*' ORDER BY type, name").all();
+    for (const object of objects)
+        db.exec(`DROP ${object.type.toUpperCase()} main.${quoteIdentifier(object.name)}`);
+    const virtualTables = db.pragma("main.table_list")
+        .filter(table => table.schema === "main" && !table.name.startsWith("sqlite_") && table.type === "virtual");
+    for (const table of virtualTables)
+        db.exec(`DROP TABLE main.${quoteIdentifier(table.name)}`);
+    if (virtualTables.length !== 0) {
+        // FTS5 external content can retain its cached shadow flag after its virtual table is dropped.
+        // RESET reloads the schema and keeps schema writes disabled: https://sqlite.org/pragma.html#pragma_writable_schema
+        db.pragma("writable_schema = RESET");
+    }
+    const tables = db.pragma("main.table_list")
+        .filter(table => table.schema === "main" && !table.name.startsWith("sqlite_") && (table.type === "table" || table.type === "shadow"));
+    for (const table of tables)
+        db.exec(`DROP TABLE main.${quoteIdentifier(table.name)}`);
+};
+export const upgradeSqlite = (db, format) => {
+    if (!db.inTransaction)
+        throw new Error("SQLite migration requires an immediate transaction.");
+    const source = inspectSqlite(db, format);
+    if (source.kind === "current")
+        return null;
+    let version = source.version;
+    if (source.kind === "empty" || source.kind === "unversioned") {
+        try {
+            if (source.kind === "unversioned")
+                resetUnversionedSqlite(db);
+            format.baseline.create(db);
+            format.validateVersioned(db, format.baseline.version);
+            db.pragma(`user_version = ${format.baseline.version}`);
+            version = format.baseline.version;
+        }
+        catch (cause) {
+            throw new SqliteAccessError("migration-failed", { database: format.name, phase: source.kind === "empty" ? "initialize" : "reset", fromVersion: source.version, toVersion: currentSqliteVersion(format), stepVersion: format.baseline.version }, { cause, outcome: "unknown" });
+        }
+    }
+    for (const migration of format.migrations) {
+        if (migration.toVersion <= version)
+            continue;
+        try {
+            migration.up(db);
+            format.validateVersioned(db, migration.toVersion);
+            db.pragma(`user_version = ${migration.toVersion}`);
+            version = migration.toVersion;
+        }
+        catch (cause) {
+            throw new SqliteAccessError("migration-failed", { database: format.name, phase: "migrate", fromVersion: source.version, toVersion: currentSqliteVersion(format), stepVersion: migration.toVersion }, { cause, outcome: "unknown" });
+        }
+    }
+    format.validateVersioned(db, version);
+    return { fromVersion: source.version, toVersion: version, initialized: source.kind === "empty", reset: source.kind === "unversioned" };
+};
+//# sourceMappingURL=sqlite-format.js.map

package/dist/platform/sqlite-format.js.map

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

package/dist/platform/sqlite-sql.d.ts

@@ -0,0 +1,12 @@
+export type SqliteSchemaObject = {
+    readonly name: string;
+    readonly type: string;
+    readonly sql: string | null;
+};
+export type SqliteSchemaStep = {
+    readonly version: number;
+    readonly sql: string;
+};
+export declare const loadSqliteSql: (resource: URL) => string;
+export declare const loadSqliteSequence: (directory: URL) => readonly [SqliteSchemaStep, ...SqliteSchemaStep[]];
+export declare const sqliteSchemaSnapshots: (steps: readonly SqliteSchemaStep[]) => ReadonlyMap<number, readonly SqliteSchemaObject[]>;

package/dist/platform/sqlite-sql.js

@@ -0,0 +1,61 @@
+import { readFileSync, readdirSync } from "node:fs";
+import path from "node:path";
+import { fileURLToPath, pathToFileURL } from "node:url";
+import Database from "better-sqlite3";
+export const loadSqliteSql = (resource) => {
+    const sql = readFileSync(resource, "utf8");
+    if (sql.trim().length === 0)
+        throw new Error(`SQLite SQL resource is empty: ${resource.href}`);
+    return sql;
+};
+export const loadSqliteSequence = (directory) => {
+    const files = readdirSync(directory, { withFileTypes: true }).filter(entry => entry.name.toLowerCase().endsWith(".sql")).sort((a, b) => a.name < b.name ? -1 : a.name === b.name ? 0 : 1);
+    if (files.length === 0)
+        throw new Error(`SQLite SQL sequence is empty: ${directory.href}`);
+    let width, previous;
+    const resources = files.map(entry => {
+        const resource = pathToFileURL(path.join(fileURLToPath(directory), entry.name));
+        const match = /^([0-9]{3,})-([a-z][a-z0-9]*(?:-[a-z0-9]+)*)\.sql$/.exec(entry.name);
+        if (!entry.isFile() || match === null)
+            throw new Error(`Invalid SQLite SQL filename: ${resource.href}`);
+        const prefix = match[1], version = Number(prefix);
+        if (!Number.isInteger(version) || version < 1 || version > 2_147_483_647)
+            throw new Error(`SQLite SQL version must be a positive signed 32-bit integer: ${resource.href}`);
+        if (width !== undefined && prefix.length !== width)
+            throw new Error(`SQLite SQL version prefixes must use the same zero-padding width: ${resource.href}`);
+        if (version === previous)
+            throw new Error(`Duplicate SQLite SQL version: ${resource.href}`);
+        if (previous !== undefined && version !== previous + 1)
+            throw new Error(`SQLite SQL versions must be consecutive after the baseline: ${resource.href}`);
+        width = prefix.length;
+        previous = version;
+        return { version, resource };
+    });
+    const steps = resources.map(({ version, resource }) => Object.freeze({ version, sql: loadSqliteSql(resource) }));
+    return Object.freeze(steps);
+};
+export const sqliteSchemaSnapshots = (steps) => {
+    const db = new Database(":memory:"), snapshots = new Map();
+    let failed = false, failure;
+    try {
+        for (const step of steps) {
+            db.exec(step.sql);
+            const objects = db.prepare("SELECT name, type, sql FROM sqlite_schema WHERE name NOT GLOB 'sqlite_*' ORDER BY name").all();
+            snapshots.set(step.version, Object.freeze(objects.map(object => Object.freeze(object))));
+        }
+    }
+    catch (cause) {
+        failed = true;
+        failure = cause;
+    }
+    try {
+        db.close();
+    }
+    catch (close) {
+        throw failed ? new AggregateError([failure, close], "SQLite reference schema construction and connection shutdown failed.") : close;
+    }
+    if (failed)
+        throw failure;
+    return snapshots;
+};
+//# sourceMappingURL=sqlite-sql.js.map

package/dist/platform/sqlite-sql.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codetreker/daynight",
-  "version": "0.29.0",
+  "version": "0.31.0",
   "description": "A client command toolkit for development workflows",
   "repository": {
     "type": "git",
@@ -20,7 +20,7 @@
     "node": ">=22"
   },
   "scripts": {
-    "build": "node scripts/clean-dist.ts && tsc -p tsconfig.build.json && node scripts/copy-skills.ts",
+    "build": "node scripts/clean-dist.ts && tsc -p tsconfig.build.json && node scripts/copy-resources.ts",
     "typecheck": "tsc --noEmit",
     "test": "pnpm run build && vitest run",
     "test:apfs": "DAYNIGHT_TEST_APFS=1 vitest run test/commands/review/apfs.test.ts",
@@ -54,5 +54,5 @@
     "vite": "8.3.4",
     "vitest": "5.0.5"
   },
-  "gitHead": "829423d4ac66f9228b0f28b3095eb4c06437e5b3"
+  "gitHead": "4fde16f3609bcaf91f3f7bbedb68df2665744db8"
 }