@microdelta/history 0.0.0 → 0.2.0

package/dist/src/durable/errors.d.ts

@@ -0,0 +1,94 @@
+/**
+ * Distinct failure classes of the durable History authority. Diagnostics must
+ * distinguish stale ownership, conflicting execution identity, invalid
+ * lifecycle transitions, unsupported storage, journal compare-and-set
+ * conflicts, undeclared journal record versions and integrity failures rather
+ * than report a generic miss (execution.md, required validation fixtures).
+ * None of these classes extends `TypeError`, so a reader never mistakes a
+ * storage failure for Value's rejection of a selection's shape.
+ * @packageDocumentation
+ */
+/**
+ * The store's contents contradict History's invariants or the caller's exact
+ * reference: a malformed, missing or wrong-scope reference, a dangling
+ * dependency, or index/payload content that does not match its digests.
+ * History never repairs such a failure by following a current pointer or
+ * recomputing.
+ * @alpha
+ */
+export declare class HistoryIntegrityError extends Error {
+    /** Create an integrity failure with a diagnostic message. */
+    constructor(message: string);
+}
+/**
+ * The SQLite file does not hold exactly History's supported schema for the
+ * requested logical store: unknown, incomplete, foreign or differently
+ * versioned storage is rejected before any work rather than migrated by guess.
+ * @alpha
+ */
+export declare class HistorySchemaError extends Error {
+    /** Create a schema rejection with a diagnostic message. */
+    constructor(message: string);
+}
+/**
+ * A presented writer lease no longer matches the durable holder, fence or
+ * unexpired lease, so the mutation was rejected with no change other than the
+ * observed clock high-water (PUB-002).
+ * @alpha
+ */
+export declare class StaleWriterError extends Error {
+    /** Create a stale-ownership rejection with a diagnostic message. */
+    constructor(message: string);
+}
+/**
+ * An attempt key is already bound to a different execution intent, version
+ * or scoped subject. The key identifies one execution; it cannot serve another.
+ * @alpha
+ */
+export declare class AttemptConflictError extends Error {
+    /** Create an execution-identity conflict with a diagnostic message. */
+    constructor(message: string);
+}
+/**
+ * A lifecycle operation was requested from a state that does not permit it,
+ * such as staging a completed attempt or publishing one that was never staged.
+ * @alpha
+ */
+export declare class AttemptStateError extends Error {
+    /** Create an invalid-transition rejection with a diagnostic message. */
+    constructor(message: string);
+}
+/**
+ * The injected clock failed to produce a nonnegative safe-integer epoch
+ * millisecond reading, so the time-dependent operation was refused unchanged.
+ * @alpha
+ */
+export declare class HistoryClockError extends Error {
+    /** Create a clock refusal with a diagnostic message. */
+    constructor(message: string);
+}
+/**
+ * A journal commit's compare-and-set expectation does not hold: the presented
+ * expected revision is not the key's current revision (a new-key expectation
+ * met an existing key, or an update met a later or absent revision). The
+ * whole commit was rolled back unchanged; the caller must re-read before
+ * deciding again.
+ * @alpha
+ */
+export declare class JournalConflictError extends Error {
+    /** Create a compare-and-set rejection with a diagnostic message. */
+    constructor(message: string);
+}
+/**
+ * A journal record's format or format version is not one the journal port
+ * declared. On a write the record is refused; on a read or list the stored
+ * record is refused rather than returned; a commit over a current revision of
+ * an undeclared version is refused rather than overwriting it. History never
+ * interprets or converts the content of another format version.
+ * @alpha
+ */
+export declare class JournalVersionError extends Error {
+    /** Create an undeclared-version refusal with a diagnostic message. */
+    constructor(message: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/src/durable/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/durable/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;;;;;;GAOG;AACH,qBAAa,qBAAsB,SAAQ,KAAK;IAC9C,6DAA6D;gBAC1C,OAAO,EAAE,MAAM;CAInC;AAED;;;;;GAKG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,2DAA2D;gBACxC,OAAO,EAAE,MAAM;CAInC;AAED;;;;;GAKG;AACH,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,oEAAoE;gBACjD,OAAO,EAAE,MAAM;CAInC;AAED;;;;GAIG;AACH,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C,uEAAuE;gBACpD,OAAO,EAAE,MAAM;CAInC;AAED;;;;GAIG;AACH,qBAAa,iBAAkB,SAAQ,KAAK;IAC1C,wEAAwE;gBACrD,OAAO,EAAE,MAAM;CAInC;AAED;;;;GAIG;AACH,qBAAa,iBAAkB,SAAQ,KAAK;IAC1C,wDAAwD;gBACrC,OAAO,EAAE,MAAM;CAInC;AAED;;;;;;;GAOG;AACH,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C,oEAAoE;gBACjD,OAAO,EAAE,MAAM;CAInC;AAED;;;;;;;GAOG;AACH,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,sEAAsE;gBACnD,OAAO,EAAE,MAAM;CAInC"}

package/dist/src/durable/errors.js

@@ -0,0 +1,118 @@
+/**
+ * Distinct failure classes of the durable History authority. Diagnostics must
+ * distinguish stale ownership, conflicting execution identity, invalid
+ * lifecycle transitions, unsupported storage, journal compare-and-set
+ * conflicts, undeclared journal record versions and integrity failures rather
+ * than report a generic miss (execution.md, required validation fixtures).
+ * None of these classes extends `TypeError`, so a reader never mistakes a
+ * storage failure for Value's rejection of a selection's shape.
+ * @packageDocumentation
+ */
+/**
+ * The store's contents contradict History's invariants or the caller's exact
+ * reference: a malformed, missing or wrong-scope reference, a dangling
+ * dependency, or index/payload content that does not match its digests.
+ * History never repairs such a failure by following a current pointer or
+ * recomputing.
+ * @alpha
+ */
+export class HistoryIntegrityError extends Error {
+    /** Create an integrity failure with a diagnostic message. */
+    constructor(message) {
+        super(message);
+        this.name = 'HistoryIntegrityError';
+    }
+}
+/**
+ * The SQLite file does not hold exactly History's supported schema for the
+ * requested logical store: unknown, incomplete, foreign or differently
+ * versioned storage is rejected before any work rather than migrated by guess.
+ * @alpha
+ */
+export class HistorySchemaError extends Error {
+    /** Create a schema rejection with a diagnostic message. */
+    constructor(message) {
+        super(message);
+        this.name = 'HistorySchemaError';
+    }
+}
+/**
+ * A presented writer lease no longer matches the durable holder, fence or
+ * unexpired lease, so the mutation was rejected with no change other than the
+ * observed clock high-water (PUB-002).
+ * @alpha
+ */
+export class StaleWriterError extends Error {
+    /** Create a stale-ownership rejection with a diagnostic message. */
+    constructor(message) {
+        super(message);
+        this.name = 'StaleWriterError';
+    }
+}
+/**
+ * An attempt key is already bound to a different execution intent, version
+ * or scoped subject. The key identifies one execution; it cannot serve another.
+ * @alpha
+ */
+export class AttemptConflictError extends Error {
+    /** Create an execution-identity conflict with a diagnostic message. */
+    constructor(message) {
+        super(message);
+        this.name = 'AttemptConflictError';
+    }
+}
+/**
+ * A lifecycle operation was requested from a state that does not permit it,
+ * such as staging a completed attempt or publishing one that was never staged.
+ * @alpha
+ */
+export class AttemptStateError extends Error {
+    /** Create an invalid-transition rejection with a diagnostic message. */
+    constructor(message) {
+        super(message);
+        this.name = 'AttemptStateError';
+    }
+}
+/**
+ * The injected clock failed to produce a nonnegative safe-integer epoch
+ * millisecond reading, so the time-dependent operation was refused unchanged.
+ * @alpha
+ */
+export class HistoryClockError extends Error {
+    /** Create a clock refusal with a diagnostic message. */
+    constructor(message) {
+        super(message);
+        this.name = 'HistoryClockError';
+    }
+}
+/**
+ * A journal commit's compare-and-set expectation does not hold: the presented
+ * expected revision is not the key's current revision (a new-key expectation
+ * met an existing key, or an update met a later or absent revision). The
+ * whole commit was rolled back unchanged; the caller must re-read before
+ * deciding again.
+ * @alpha
+ */
+export class JournalConflictError extends Error {
+    /** Create a compare-and-set rejection with a diagnostic message. */
+    constructor(message) {
+        super(message);
+        this.name = 'JournalConflictError';
+    }
+}
+/**
+ * A journal record's format or format version is not one the journal port
+ * declared. On a write the record is refused; on a read or list the stored
+ * record is refused rather than returned; a commit over a current revision of
+ * an undeclared version is refused rather than overwriting it. History never
+ * interprets or converts the content of another format version.
+ * @alpha
+ */
+export class JournalVersionError extends Error {
+    /** Create an undeclared-version refusal with a diagnostic message. */
+    constructor(message) {
+        super(message);
+        this.name = 'JournalVersionError';
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/src/durable/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/durable/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;;;;;;GAOG;AACH,MAAM,OAAO,qBAAsB,SAAQ,KAAK;IAC9C,6DAA6D;IAC7D,YAAmB,OAAe;QAChC,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;IACtC,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAC3C,2DAA2D;IAC3D,YAAmB,OAAe;QAChC,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IACzC,oEAAoE;IACpE,YAAmB,OAAe;QAChC,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IAC7C,uEAAuE;IACvE,YAAmB,OAAe;QAChC,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IAC1C,wEAAwE;IACxE,YAAmB,OAAe;QAChC,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;IAClC,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IAC1C,wDAAwD;IACxD,YAAmB,OAAe;QAChC,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;IAClC,CAAC;CACF;AAED;;;;;;;GAOG;AACH,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IAC7C,oEAAoE;IACpE,YAAmB,OAAe;QAChC,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;CACF;AAED;;;;;;;GAOG;AACH,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IAC5C,sEAAsE;IACtE,YAAmB,OAAe;QAChC,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF"}

package/dist/src/durable/index.d.ts

@@ -0,0 +1,9 @@
+import type { IDurableHistory, IDurableHistoryOptions } from './contracts.js';
+/**
+ * Open (creating when empty) the durable History store for one logical store.
+ * The file is rejected before any work unless it is empty or holds exactly
+ * this schema version for this logical store.
+ * @alpha
+ */
+export declare function openDurableHistory(options: IDurableHistoryOptions): IDurableHistory;
+//# sourceMappingURL=index.d.ts.map

package/dist/src/durable/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/durable/index.ts"],"names":[],"mappings":"AAyCA,OAAO,KAAK,EAQV,eAAe,EACf,sBAAsB,EAiBvB,MAAM,gBAAgB,CAAC;AAyDxB;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,sBAAsB,GAAG,eAAe,CAguBnF"}