@wjarka/cezarion 0.15.1 → 0.16.0

package/dist/runs/store-open-error.d.ts

@@ -0,0 +1,24 @@
+import { type RunDatabaseErrorKind } from './run-database.ts';
+/** Why a project's run store could not be opened (#779, plan step 4). */
+export type RunStoreOpenErrorKind = Exclude<RunDatabaseErrorKind, 'conflict'> | 'legacy-writer';
+/**
+ * A project's run store could not be opened, so there is no store: nothing about its runs can be
+ * read or saved until the cause is gone. Never "no runs" — a caller that treated it so would
+ * prune worktrees and scratch it took for orphans. `message` is for the user, as it stands: the
+ * cockpit shows it as the project's 409, the CLI prints it.
+ */
+export declare class RunStoreOpenError extends Error {
+    readonly kind: RunStoreOpenErrorKind;
+    /** The database the failure is about. */
+    readonly path: string;
+    constructor(kind: RunStoreOpenErrorKind, path: string, message: string, options?: {
+        cause?: unknown;
+    });
+}
+/**
+ * The user-facing failure for `error`, met while opening the store at `path`. `waitedMs` is how
+ * long a busy database was retried, if it was.
+ */
+export declare function toRunStoreOpenError(error: unknown, path: string, opts?: {
+    waitedMs?: number;
+}): RunStoreOpenError;

package/dist/runs/store-open-error.js

@@ -0,0 +1,61 @@
+import { dirname } from 'node:path';
+import { LegacyWriterError } from './legacy-index.js';
+import { RunDatabaseError, RunDatabaseUnsupportedSchemaError } from './run-database.js';
+/**
+ * A project's run store could not be opened, so there is no store: nothing about its runs can be
+ * read or saved until the cause is gone. Never "no runs" — a caller that treated it so would
+ * prune worktrees and scratch it took for orphans. `message` is for the user, as it stands: the
+ * cockpit shows it as the project's 409, the CLI prints it.
+ */
+export class RunStoreOpenError extends Error {
+    kind;
+    /** The database the failure is about. */
+    path;
+    constructor(kind, path, message, options = {}) {
+        super(message, options);
+        this.name = 'RunStoreOpenError';
+        this.kind = kind;
+        this.path = path;
+    }
+}
+/** File-system failures outside SQLite (creating the data directory, the backup). */
+function errnoKind(error) {
+    const code = error?.code;
+    if (code === 'EACCES' || code === 'EPERM' || code === 'EROFS')
+        return 'permission';
+    if (code === 'ENOSPC' || code === 'EDQUOT')
+        return 'disk-full';
+    return undefined;
+}
+/**
+ * The user-facing failure for `error`, met while opening the store at `path`. `waitedMs` is how
+ * long a busy database was retried, if it was.
+ */
+export function toRunStoreOpenError(error, path, opts = {}) {
+    if (error instanceof RunStoreOpenError)
+        return error;
+    const detail = error instanceof Error ? error.message : String(error);
+    const cause = { cause: error };
+    if (error instanceof LegacyWriterError)
+        return new RunStoreOpenError('legacy-writer', path, error.message, cause);
+    const kind = error instanceof RunDatabaseError ? error.kind : errnoKind(error) ?? 'other';
+    switch (kind) {
+        case 'corrupt':
+            return new RunStoreOpenError(kind, path, `${path} is damaged (${detail}). cezar left it and its -wal and -shm files exactly as they are: restore them from a backup, or rebuild them from runs.json.pre-sqlite.bak as BACKWARD_COMPATIBILITY.md §3 "Recovering run history" describes, then restart cezar.`, cause);
+        case 'busy': {
+            const held = opts.waitedMs ? ` for over ${(opts.waitedMs / 1000).toFixed(1)} s` : '';
+            return new RunStoreOpenError(kind, path, `${path} is busy: another cezar process has held its write lock${held}. Wait for it to finish, then restart cezar.`, cause);
+        }
+        case 'permission':
+            return new RunStoreOpenError(kind, path, `cezar cannot read or write ${path} (${detail}). Give your user read and write access to ${dirname(path)}, then restart cezar.`, cause);
+        case 'disk-full':
+            return new RunStoreOpenError(kind, path, `No space is left to write ${path} (${detail}). Free some disk space, then restart cezar.`, cause);
+        case 'unsupported-schema': {
+            const schema = error instanceof RunDatabaseUnsupportedSchemaError ? ` (schema ${error.found}; this cezar reads schema ${error.supported})` : '';
+            return new RunStoreOpenError(kind, path, `${path} was written by a newer cezar${schema}. Upgrade cezar to open this project's runs.`, cause);
+        }
+        default:
+            return new RunStoreOpenError('other', path, `${path} could not be opened (${detail}). Restart cezar to try again.`, cause);
+    }
+}
+//# sourceMappingURL=store-open-error.js.map

package/dist/runs/store-open-error.js.map

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