@nklisch/pi-enhanced 0.1.1 → 0.1.2

package/node_modules/@nklisch/pi-plugins/dist/infrastructure/state/sqlite-open.d.ts

@@ -0,0 +1,23 @@
+import { DatabaseSync } from "node:sqlite";
+export type OpenSqliteDatabase = Readonly<{
+    database: DatabaseSync;
+    close(): void;
+}>;
+/**
+ * Open (creating when absent) a SQLite database and validate its schema.
+ * Schema inspection, first-use initialization, and validation run inside one
+ * exclusive transaction so concurrent first-use processes serialize on the
+ * database itself; no sidecar marker or claim files exist to drift, go stale,
+ * or strand a later process. Busy contention retries with backoff until the
+ * caller's signal aborts or the budget is exhausted.
+ */
+export declare function openSqliteDatabase(input: Readonly<{
+    path: string;
+    signal: AbortSignal;
+    busyTimeoutMs?: number;
+    /** Connection and journal pragmas, executed once after open before any transaction. */
+    configure?(database: DatabaseSync): void;
+    /** First-use schema and seed data (DDL/DML only — no journal pragmas). */
+    initialize(database: DatabaseSync): void;
+    validate(database: DatabaseSync): void;
+}>): Promise<OpenSqliteDatabase>;

package/node_modules/@nklisch/pi-plugins/dist/infrastructure/state/sqlite-open.js

@@ -0,0 +1,80 @@
+import { chmodSync, lstatSync } from "node:fs";
+import { DatabaseSync } from "node:sqlite";
+import { LOCAL_LOCK_DATABASE_MODE } from "./local-lock-filesystem.js";
+const SQLITE_BUSY = 5;
+// Waiting out a busy database must tolerate loaded hosts (parallel test
+// runners, several Pi sessions on one agent dir); the budget below totals
+// roughly five seconds while staying sub-second locally.
+const MAX_RETRIES = 24;
+function isBusy(error) {
+    return typeof error === "object" && error !== null && error.errcode === SQLITE_BUSY;
+}
+async function wait(signal, attempt) {
+    signal.throwIfAborted();
+    const delay = Math.min(250, 2 ** Math.min(attempt, 8));
+    await new Promise((resolve, reject) => {
+        const timer = setTimeout(() => { signal.removeEventListener("abort", onAbort); resolve(); }, delay);
+        const onAbort = () => { clearTimeout(timer); signal.removeEventListener("abort", onAbort); reject(signal.reason); };
+        signal.addEventListener("abort", onAbort, { once: true });
+    });
+}
+function assertRegularFile(path) {
+    const stats = lstatSync(path);
+    if (!stats.isFile() || stats.isSymbolicLink())
+        throw new Error("SQLite database path is not a regular file");
+}
+/**
+ * Open (creating when absent) a SQLite database and validate its schema.
+ * Schema inspection, first-use initialization, and validation run inside one
+ * exclusive transaction so concurrent first-use processes serialize on the
+ * database itself; no sidecar marker or claim files exist to drift, go stale,
+ * or strand a later process. Busy contention retries with backoff until the
+ * caller's signal aborts or the budget is exhausted.
+ */
+export async function openSqliteDatabase(input) {
+    const busyTimeoutMs = input.busyTimeoutMs ?? 0;
+    if (!Number.isInteger(busyTimeoutMs) || busyTimeoutMs < 0 || busyTimeoutMs > 60_000)
+        throw new TypeError("SQLite busy timeout is invalid");
+    for (let attempt = 0; attempt <= MAX_RETRIES; attempt += 1) {
+        input.signal.throwIfAborted();
+        const database = new DatabaseSync(input.path, { allowExtension: false, defensive: true, enableForeignKeyConstraints: true, timeout: busyTimeoutMs });
+        try {
+            input.configure?.(database);
+            assertRegularFile(input.path);
+            chmodSync(input.path, LOCAL_LOCK_DATABASE_MODE);
+            database.exec("BEGIN EXCLUSIVE");
+            try {
+                const objects = database.prepare("SELECT name FROM sqlite_master WHERE name NOT LIKE 'sqlite_%'").all();
+                if (objects.length === 0)
+                    input.initialize(database);
+                input.validate(database);
+                database.exec("COMMIT");
+            }
+            catch (error) {
+                try {
+                    if (database.isTransaction)
+                        database.exec("ROLLBACK");
+                }
+                catch { /* preserve primary failure */ }
+                throw error;
+            }
+            let closed = false;
+            return Object.freeze({
+                database,
+                close() { if (closed)
+                    return; closed = true; database.close(); },
+            });
+        }
+        catch (error) {
+            try {
+                database.close();
+            }
+            catch { /* preserve primary failure */ }
+            if (!isBusy(error) || attempt === MAX_RETRIES)
+                throw error;
+            await wait(input.signal, attempt);
+        }
+    }
+    throw new Error("SQLite database open retry budget exhausted");
+}
+//# sourceMappingURL=sqlite-open.js.map

package/node_modules/@nklisch/pi-plugins/dist/infrastructure/state/sqlite-open.js.map

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

package/node_modules/@nklisch/pi-plugins/dist/infrastructure/state/sqlite-scope-lock.d.ts

@@ -1,10 +1,5 @@
 import { type ScopeReference } from "../../domain/state/scope.js";
 import type { ScopeLockManager } from "../../application/ports/scope-lock.js";
-type InitializationMarkerReadHook = (context: Readonly<{
-    path: string;
-    databaseName: string;
-    markerState: "absent" | "initializing" | "ready";
-}>) => Promise<void> | void;
 export type SqliteScopeLockOptions = Readonly<{
     lockRoot: string;
     retryDelayMs: Readonly<{
@@ -13,13 +8,8 @@ export type SqliteScopeLockOptions = Readonly<{
     }>;
     random?: () => number;
     verifyLocalFilesystem?: (root: string) => Promise<void>;
-    /** Test seam for forcing a cross-process marker/path interleaving. */
-    initializationMarkerRead?: InitializationMarkerReadHook;
 }>;
 declare function scopeDatabaseName(scope: ScopeReference): string;
-/**
- * Create a scope lock manager after proving the configured root has the
- * capabilities this safety boundary needs. No process-local fallback exists.
- */
+/** Create a scope lock manager rooted at a private, local-filesystem directory. */
 export declare function createSqliteScopeLockManager(options: SqliteScopeLockOptions): Promise<ScopeLockManager>;
 export { scopeDatabaseName };