stitchkit 0.104.2 → 0.105.0

package/dist/application/diagnostic-journal-read-contract.d.ts

@@ -1,4 +1,8 @@
 import { z } from 'zod';
+/**
+ * A damaged region found while reading a journal: file, offset, line, reason, whether it is at
+ * the tail, and how many bytes were skipped.
+ */
 export declare const DiagnosticJournalAnomalySchema: z.ZodReadonly<z.ZodObject<{
     file: z.ZodString;
     offset: z.ZodNumber;
@@ -19,7 +23,12 @@ export declare const DiagnosticJournalAnomalySchema: z.ZodReadonly<z.ZodObject<{
     terminated: z.ZodBoolean;
     skippedBytes: z.ZodNumber;
 }, z.core.$strict>>;
+/** A damaged region found while reading a journal; reading goes on after it. */
 export type DiagnosticJournalAnomaly = z.infer<typeof DiagnosticJournalAnomalySchema>;
+/**
+ * Builds the Zod schema of one read result for your event schema: a `frame` carrying a parsed
+ * event, or an `anomaly`.
+ */
 export declare function createDiagnosticJournalReadResultSchema<SCHEMA extends z.ZodType>(eventSchema: SCHEMA): z.ZodDiscriminatedUnion<[z.ZodReadonly<z.ZodObject<{
     file: z.ZodString;
     offset: z.ZodNumber;
@@ -55,7 +64,36 @@ export declare function createDiagnosticJournalReadResultSchema<SCHEMA extends z
         skippedBytes: z.ZodNumber;
     }, z.core.$strict>>;
 }, z.core.$strict>>], "type">;
+/**
+ * One item yielded by `readDiagnosticJournal`: a `frame` with its event and location, or an
+ * `anomaly` for a damaged region.
+ */
 export type DiagnosticJournalReadResult<SCHEMA extends z.ZodType> = z.output<ReturnType<typeof createDiagnosticJournalReadResultSchema<SCHEMA>>>;
+/**
+ * Why opening a journal could not keep a file in place: a torn active file with no retention slot
+ * to rotate it into, a retained name that is not a regular file, or a file that could not be read.
+ */
+export declare const DiagnosticJournalStartupRefusalReasonSchema: z.ZodEnum<{
+    "not-a-regular-file": "not-a-regular-file";
+    "torn-without-retention-slot": "torn-without-retention-slot";
+    unreadable: "unreadable";
+}>;
+/** The inferred value of {@link DiagnosticJournalStartupRefusalReasonSchema}. */
+export type DiagnosticJournalStartupRefusalReason = z.infer<typeof DiagnosticJournalStartupRefusalReasonSchema>;
+/**
+ * How many quarantined files one status lists. The rest are counted in `quarantinedUnlisted`, so a
+ * directory holding thousands of them cannot grow the status without bound.
+ */
+export declare const DIAGNOSTIC_JOURNAL_LISTED_QUARANTINE_LIMIT = 32;
+/**
+ * Counts from checking a journal at startup: files checked, anomalies found, bytes skipped, the
+ * first and last anomaly, and the quarantined files beside the journal.
+ *
+ * Stability: this schema follows the maturity of `stitchkit/application` (evolving). It is
+ * `.strict()`, so a reader parsing with an older copy refuses a status that carries a key it does
+ * not know: every change to its shape, an added optional field included, is listed under
+ * `⚠️ Breaking changes` in the changelog for consumers that embed it in their own protocol.
+ */
 export declare const DiagnosticJournalRecoveryStatusSchema: z.ZodReadonly<z.ZodObject<{
     filesChecked: z.ZodNumber;
     anomalies: z.ZodNumber;
@@ -100,11 +138,43 @@ export declare const DiagnosticJournalRecoveryStatusSchema: z.ZodReadonly<z.ZodO
         terminated: z.ZodBoolean;
         skippedBytes: z.ZodNumber;
     }, z.core.$strict>>>;
+    quarantined: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodReadonly<z.ZodObject<{
+        file: z.ZodString;
+        quarantinedAs: z.ZodString;
+        reason: z.ZodOptional<z.ZodEnum<{
+            "not-a-regular-file": "not-a-regular-file";
+            "torn-without-retention-slot": "torn-without-retention-slot";
+            unreadable: "unreadable";
+        }>>;
+        code: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>>>;
+    quarantinedUnlisted: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strict>>;
+/**
+ * Counts from checking a journal at startup: files checked, anomalies found, bytes skipped,
+ * the first and last anomaly, and the quarantined files beside the journal.
+ */
 export type DiagnosticJournalRecoveryStatus = z.infer<typeof DiagnosticJournalRecoveryStatusSchema>;
-/** A single-file retention policy cannot preserve the torn file during startup rotation. */
+/** What a startup refusal names: the file, the reason and what was observed or failed. */
+export interface DiagnosticJournalRecoveryErrorOptions {
+    readonly reason: DiagnosticJournalStartupRefusalReason;
+    readonly file: string;
+    /** The inspection of a torn file, when the refusal is `torn-without-retention-slot`. */
+    readonly recovery?: DiagnosticJournalRecoveryStatus;
+    /** The refusal stands because moving the file aside failed; `cause` holds both errors. */
+    readonly quarantineFailed?: boolean;
+    readonly cause?: unknown;
+}
+/**
+ * Opening a journal refused a file it could not keep in place. Thrown under
+ * `onStartupRefusal: 'fail'`, and under `'quarantine'` when moving the file aside failed (then
+ * `quarantineFailed` is true). No evidence is removed and the lock is released.
+ */
 export declare class DiagnosticJournalRecoveryError extends Error {
-    readonly recovery: DiagnosticJournalRecoveryStatus;
-    constructor(recovery: DiagnosticJournalRecoveryStatus);
+    readonly reason: DiagnosticJournalStartupRefusalReason;
+    readonly file: string;
+    readonly recovery?: DiagnosticJournalRecoveryStatus;
+    readonly quarantineFailed: boolean;
+    constructor(options: DiagnosticJournalRecoveryErrorOptions);
 }
 //# sourceMappingURL=diagnostic-journal-read-contract.d.ts.map

package/dist/application/diagnostic-journal-read-contract.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"diagnostic-journal-read-contract.d.ts","sourceRoot":"","sources":["../../src/application/diagnostic-journal-read-contract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAUxB,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;mBAgB9B,CAAC;AACd,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC;AAEtF,wBAAgB,uCAAuC,CAAC,MAAM,SAAS,CAAC,CAAC,OAAO,EAC9E,WAAW,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;8BAepB;AACD,MAAM,MAAM,2BAA2B,CAAC,MAAM,SAAS,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,MAAM,CAC1E,UAAU,CAAC,OAAO,uCAAuC,CAAC,MAAM,CAAC,CAAC,CACnE,CAAC;AAEF,eAAO,MAAM,qCAAqC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mBASrC,CAAC;AACd,MAAM,MAAM,+BAA+B,GAAG,CAAC,CAAC,KAAK,CACnD,OAAO,qCAAqC,CAC7C,CAAC;AAEF,4FAA4F;AAC5F,qBAAa,8BAA+B,SAAQ,KAAK;aAC3B,QAAQ,EAAE,+BAA+B;IAArE,YAA4B,QAAQ,EAAE,+BAA+B,EAGpE;CACF"}
+{"version":3,"file":"diagnostic-journal-read-contract.d.ts","sourceRoot":"","sources":["../../src/application/diagnostic-journal-read-contract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAUxB;;;GAGG;AACH,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;mBAgB9B,CAAC;AACd,gFAAgF;AAChF,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC;AAEtF;;;GAGG;AACH,wBAAgB,uCAAuC,CAAC,MAAM,SAAS,CAAC,CAAC,OAAO,EAC9E,WAAW,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;8BAepB;AACD;;;GAGG;AACH,MAAM,MAAM,2BAA2B,CAAC,MAAM,SAAS,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,MAAM,CAC1E,UAAU,CAAC,OAAO,uCAAuC,CAAC,MAAM,CAAC,CAAC,CACnE,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,2CAA2C;;;;EAItD,CAAC;AACH,iFAAiF;AACjF,MAAM,MAAM,qCAAqC,GAAG,CAAC,CAAC,KAAK,CACzD,OAAO,2CAA2C,CACnD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,0CAA0C,KAAK,CAAC;AAmB7D;;;;;;;;GAQG;AACH,eAAO,MAAM,qCAAqC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mBAsBrC,CAAC;AACd;;;GAGG;AACH,MAAM,MAAM,+BAA+B,GAAG,CAAC,CAAC,KAAK,CACnD,OAAO,qCAAqC,CAC7C,CAAC;AAEF,0FAA0F;AAC1F,MAAM,WAAW,qCAAqC;IACpD,QAAQ,CAAC,MAAM,EAAE,qCAAqC,CAAC;IACvD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,wFAAwF;IACxF,QAAQ,CAAC,QAAQ,CAAC,EAAE,+BAA+B,CAAC;IACpD,0FAA0F;IAC1F,QAAQ,CAAC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IACpC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;CAC1B;AASD;;;;GAIG;AACH,qBAAa,8BAA+B,SAAQ,KAAK;IACvD,QAAQ,CAAC,MAAM,EAAE,qCAAqC,CAAC;IACvD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,CAAC,EAAE,+BAA+B,CAAC;IACpD,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;IAEnC,YAAY,OAAO,EAAE,qCAAqC,EAWzD;CACF"}

package/dist/application/diagnostic-journal-reader.d.ts

@@ -1,5 +1,9 @@
 import { z } from 'zod';
-import { type DiagnosticJournalReadResult } from './diagnostic-journal-read-contract.js';
+import { createDiagnosticJournalReadResultSchema, type DiagnosticJournalReadResult } from './diagnostic-journal-read-contract.js';
+/**
+ * Config for `readDiagnosticJournal`: the files to read in order, the schema each event must
+ * match, and a per-line byte limit.
+ */
 export interface DiagnosticJournalReaderConfig<SCHEMA extends z.ZodType> {
     /** Explicit operator-owned files, read in this order; missing files are I/O errors. */
     readonly paths: readonly string[];
@@ -8,6 +12,17 @@ export interface DiagnosticJournalReaderConfig<SCHEMA extends z.ZodType> {
     readonly maxLineBytes: number;
     readonly signal?: AbortSignal;
 }
-/** One finite file snapshot at a time. Corrupt rows are data; filesystem failures throw. */
+export interface LineLocation {
+    readonly file: string;
+    readonly offset: number;
+    readonly line: number;
+    readonly bytes: number;
+    readonly terminated: boolean;
+    readonly position: 'tail' | 'interior';
+}
+export declare function decodeLine<SCHEMA extends z.ZodType>(schema: ReturnType<typeof createDiagnosticJournalReadResultSchema<SCHEMA>>, location: LineLocation, body: Uint8Array | undefined): DiagnosticJournalReadResult<SCHEMA>[];
+/**
+ * One finite file snapshot at a time. Corrupt rows are data; filesystem failures throw.
+ */
 export declare function readDiagnosticJournal<SCHEMA extends z.ZodType>(config: DiagnosticJournalReaderConfig<SCHEMA>): AsyncGenerator<DiagnosticJournalReadResult<SCHEMA>, void, unknown>;
 //# sourceMappingURL=diagnostic-journal-reader.d.ts.map

package/dist/application/diagnostic-journal-reader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"diagnostic-journal-reader.d.ts","sourceRoot":"","sources":["../../src/application/diagnostic-journal-reader.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAGL,KAAK,2BAA2B,EACjC,MAAM,oCAAoC,CAAC;AAE5C,MAAM,WAAW,6BAA6B,CAAC,MAAM,SAAS,CAAC,CAAC,OAAO;IACrE,uFAAuF;IACvF,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,qEAAqE;IACrE,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;CAC/B;AAoFD,4FAA4F;AAC5F,wBAAuB,qBAAqB,CAAC,MAAM,SAAS,CAAC,CAAC,OAAO,EACnE,MAAM,EAAE,6BAA6B,CAAC,MAAM,CAAC,GAC5C,cAAc,CAAC,2BAA2B,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,CAsFpE"}
+{"version":3,"file":"diagnostic-journal-reader.d.ts","sourceRoot":"","sources":["../../src/application/diagnostic-journal-reader.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EACL,uCAAuC,EAEvC,KAAK,2BAA2B,EACjC,MAAM,oCAAoC,CAAC;AAE5C;;;GAGG;AACH,MAAM,WAAW,6BAA6B,CAAC,MAAM,SAAS,CAAC,CAAC,OAAO;IACrE,uFAAuF;IACvF,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,qEAAqE;IACrE,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;CAC/B;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,CAAC;CACxC;AAED,wBAAgB,UAAU,CAAC,MAAM,SAAS,CAAC,CAAC,OAAO,EACjD,MAAM,EAAE,UAAU,CAAC,OAAO,uCAAuC,CAAC,MAAM,CAAC,CAAC,EAC1E,QAAQ,EAAE,YAAY,EACtB,IAAI,EAAE,UAAU,GAAG,SAAS,GAC3B,2BAA2B,CAAC,MAAM,CAAC,EAAE,CA+CvC;AAED;;GAEG;AACH,wBAAuB,qBAAqB,CAAC,MAAM,SAAS,CAAC,CAAC,OAAO,EACnE,MAAM,EAAE,6BAA6B,CAAC,MAAM,CAAC,GAC5C,cAAc,CAAC,2BAA2B,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,CAsFpE"}

package/dist/application/diagnostic-journal-recovery.d.ts

@@ -1,4 +1,20 @@
+import type { DiagnosticJournalStartupScan } from './diagnostic-journal-contract.js';
 import { type DiagnosticJournalRecoveryStatus } from './diagnostic-journal-read-contract.js';
-/** Disk evidence is the persistent source; only counters and two locations are retained. */
-export declare function inspectDiagnosticJournalRecovery(paths: readonly string[], maxLineBytes: number): Promise<DiagnosticJournalRecoveryStatus>;
+interface RecoveryInspection {
+    readonly paths: readonly string[];
+    readonly maxLineBytes: number;
+    readonly scan: DiagnosticJournalStartupScan;
+    /**
+     * A file that could not be read to its end. Its findings are dropped and it is not counted
+     * as checked; the handler throws to refuse, or returns once the file is out of the way.
+     */
+    readonly onUnreadable?: (file: string, error: unknown) => Promise<void>;
+}
+/**
+ * Disk evidence is the persistent source; only counters and two locations are retained.
+ * `tails` checks the final line of every file, which is where a crash tears a
+ * journal; `full` reads and validates every line of every file.
+ */
+export declare function inspectDiagnosticJournalRecovery(inspection: RecoveryInspection): Promise<DiagnosticJournalRecoveryStatus>;
+export {};
 //# sourceMappingURL=diagnostic-journal-recovery.d.ts.map

package/dist/application/diagnostic-journal-recovery.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"diagnostic-journal-recovery.d.ts","sourceRoot":"","sources":["../../src/application/diagnostic-journal-recovery.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,+BAA+B,EAErC,MAAM,oCAAoC,CAAC;AAG5C,4FAA4F;AAC5F,wBAAsB,gCAAgC,CACpD,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,+BAA+B,CAAC,CAuB1C"}
+{"version":3,"file":"diagnostic-journal-recovery.d.ts","sourceRoot":"","sources":["../../src/application/diagnostic-journal-recovery.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,+BAA+B,CAAC;AAClF,OAAO,EAEL,KAAK,+BAA+B,EAErC,MAAM,oCAAoC,CAAC;AAI5C,UAAU,kBAAkB;IAC1B,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,IAAI,EAAE,4BAA4B,CAAC;IAC5C;;;OAGG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACzE;AAQD;;;;GAIG;AACH,wBAAsB,gCAAgC,CACpD,UAAU,EAAE,kBAAkB,GAC7B,OAAO,CAAC,+BAA+B,CAAC,CAsC1C"}

package/dist/application/diagnostic-journal-storage.d.ts

@@ -1,5 +1,5 @@
-import type { DiagnosticJournalFailurePhase, DiagnosticJournalLockPolicy } from './diagnostic-journal-contract.js';
-import { type DiagnosticJournalRecoveryStatus } from './diagnostic-journal-read-contract.js';
+import type { DiagnosticJournalFailurePhase, DiagnosticJournalLockPolicy, DiagnosticJournalStartupRefusalPolicy, DiagnosticJournalStartupScan } from './diagnostic-journal-contract.js';
+import type { DiagnosticJournalRecoveryStatus } from './diagnostic-journal-read-contract.js';
 export interface DiagnosticJournalStorageSnapshot {
     readonly currentFileBytes: number;
     readonly retainedFiles: number;
@@ -27,6 +27,10 @@ interface RotatingStorageConfig {
     readonly maxFiles: number;
     readonly mode: number;
     readonly lock: DiagnosticJournalLockPolicy;
+    readonly scan: DiagnosticJournalStartupScan;
+    readonly onStartupRefusal: DiagnosticJournalStartupRefusalPolicy;
+    /** The process epoch; it names the files this open moves aside. */
+    readonly epoch: string;
     readonly machineIdentity?: string;
 }
 /** One exclusive local writer. The lock is deliberately not a cross-crash lease. */

package/dist/application/diagnostic-journal-storage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"diagnostic-journal-storage.d.ts","sourceRoot":"","sources":["../../src/application/diagnostic-journal-storage.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,6BAA6B,EAC7B,2BAA2B,EAC5B,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EAEL,KAAK,+BAA+B,EACrC,MAAM,oCAAoC,CAAC;AAG5C,MAAM,WAAW,gCAAgC;IAC/C,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,CAAC,EAAE,+BAA+B,CAAC;CACrD;AAED,MAAM,WAAW,oCACf,SAAQ,gCAAgC;IACxC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,wBAAwB;IACvC,kFAAkF;IAClF,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,MAAM,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,oCAAoC,CAAC,CAAC;IACzE,QAAQ,IAAI,gCAAgC,CAAC;IAC7C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,qBAAa,6BAA8B,SAAQ,KAAK;aAEpC,KAAK,EAAE,6BAA6B;IADtD,YACkB,KAAK,EAAE,6BAA6B,EACpD,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,YAAY,EAIvB;CACF;AAED,UAAU,qBAAqB;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,2BAA2B,CAAC;IAC3C,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;CACnC;AA4CD,oFAAoF;AACpF,wBAAsB,sCAAsC,CAC1D,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,wBAAwB,CAAC,CA8KnC"}
+{"version":3,"file":"diagnostic-journal-storage.d.ts","sourceRoot":"","sources":["../../src/application/diagnostic-journal-storage.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,6BAA6B,EAC7B,2BAA2B,EAC3B,qCAAqC,EACrC,4BAA4B,EAC7B,MAAM,+BAA+B,CAAC;AAYvC,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,oCAAoC,CAAC;AAG1F,MAAM,WAAW,gCAAgC;IAC/C,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,CAAC,EAAE,+BAA+B,CAAC;CACrD;AAED,MAAM,WAAW,oCACf,SAAQ,gCAAgC;IACxC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,wBAAwB;IACvC,kFAAkF;IAClF,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,MAAM,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,oCAAoC,CAAC,CAAC;IACzE,QAAQ,IAAI,gCAAgC,CAAC;IAC7C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,qBAAa,6BAA8B,SAAQ,KAAK;aAEpC,KAAK,EAAE,6BAA6B;IADtD,YACkB,KAAK,EAAE,6BAA6B,EACpD,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,YAAY,EAIvB;CACF;AAED,UAAU,qBAAqB;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,2BAA2B,CAAC;IAC3C,QAAQ,CAAC,IAAI,EAAE,4BAA4B,CAAC;IAC5C,QAAQ,CAAC,gBAAgB,EAAE,qCAAqC,CAAC;IACjE,mEAAmE;IACnE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;CACnC;AAgCD,oFAAoF;AACpF,wBAAsB,sCAAsC,CAC1D,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,wBAAwB,CAAC,CAyLnC"}

package/dist/application/diagnostic-journal-tail.d.ts

@@ -0,0 +1,12 @@
+import { z } from 'zod';
+import { type DiagnosticJournalReadResult } from './diagnostic-journal-read-contract.js';
+declare const jsonSchema: z.ZodJSONSchema;
+/**
+ * The result of reading only the final line of each file, as the full reader
+ * would have reported it. Nothing before that line is parsed or validated: a
+ * file is read once in large blocks to count its line feeds, which is what puts
+ * the line number and byte offset on a finding.
+ */
+export declare function readDiagnosticJournalTails(paths: readonly string[], maxLineBytes: number): AsyncGenerator<DiagnosticJournalReadResult<typeof jsonSchema>>;
+export {};
+//# sourceMappingURL=diagnostic-journal-tail.d.ts.map

package/dist/application/diagnostic-journal-tail.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostic-journal-tail.d.ts","sourceRoot":"","sources":["../../src/application/diagnostic-journal-tail.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAEL,KAAK,2BAA2B,EACjC,MAAM,oCAAoC,CAAC;AAI5C,QAAA,MAAM,UAAU,iBAAW,CAAC;AAG5B;;;;;GAKG;AACH,wBAAuB,0BAA0B,CAC/C,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,YAAY,EAAE,MAAM,GACnB,cAAc,CAAC,2BAA2B,CAAC,OAAO,UAAU,CAAC,CAAC,CAiDhE"}

package/dist/application/diagnostic-journal.d.ts

@@ -8,6 +8,9 @@ import { type DiagnosticJournal, type DiagnosticJournalConfig } from './diagnost
  * behind. By default an operator removes it after proving the previous owner is gone; `lock:
  * 'reclaim-stale'` makes the journal prove that itself, which is what an unattended service
  * restarted by its supervisor needs.
+ *
+ * Opening moves a file it cannot keep in place aside and starts (`onStartupRefusal`, default
+ * `quarantine`); `getStatus().recovery` names what it found and moved.
  */
 export declare function createDiagnosticJournal<SCHEMA extends z.ZodType>(config: DiagnosticJournalConfig<SCHEMA>): Promise<DiagnosticJournal<z.input<SCHEMA>>>;
 //# sourceMappingURL=diagnostic-journal.d.ts.map

package/dist/application/diagnostic-journal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"diagnostic-journal.d.ts","sourceRoot":"","sources":["../../src/application/diagnostic-journal.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,uBAAuB,EAI7B,MAAM,+BAA+B,CAAC;AAIvC;;;;;;;;GAQG;AACH,wBAAsB,uBAAuB,CAAC,MAAM,SAAS,CAAC,CAAC,OAAO,EACpE,MAAM,EAAE,uBAAuB,CAAC,MAAM,CAAC,GACtC,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAqB7C"}
+{"version":3,"file":"diagnostic-journal.d.ts","sourceRoot":"","sources":["../../src/application/diagnostic-journal.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,uBAAuB,EAM7B,MAAM,+BAA+B,CAAC;AAIvC;;;;;;;;;;;GAWG;AACH,wBAAsB,uBAAuB,CAAC,MAAM,SAAS,CAAC,CAAC,OAAO,EACpE,MAAM,EAAE,uBAAuB,CAAC,MAAM,CAAC,GACtC,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CA2B7C"}

package/dist/application/directory-inbox-accept.d.ts

@@ -2,12 +2,12 @@ import type { z } from 'zod';
 import { type DirectoryInboxAccept, type DirectoryInboxAcceptResult } from './directory-inbox-contract.js';
 import { type InboxFiles } from './directory-inbox-files.js';
 import type { InboxStateAccess } from './directory-inbox-state.js';
-export declare function createInboxAccept<TEntry>(options: {
+export declare function createInboxAccept<TEntry, TInput>(options: {
     access: InboxStateAccess;
     files: () => InboxFiles;
     accepting: () => boolean;
-    schema: z.ZodType<TEntry>;
+    schema: z.ZodType<TEntry, TInput>;
     maxEntryBytes: number;
     maxPendingEntries: number;
-}): (input: DirectoryInboxAccept<TEntry>) => Promise<DirectoryInboxAcceptResult>;
+}): (input: DirectoryInboxAccept<TInput>) => Promise<DirectoryInboxAcceptResult>;
 //# sourceMappingURL=directory-inbox-accept.d.ts.map

package/dist/application/directory-inbox-accept.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"directory-inbox-accept.d.ts","sourceRoot":"","sources":["../../src/application/directory-inbox-accept.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,EACL,KAAK,oBAAoB,EACzB,KAAK,0BAA0B,EAEhC,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAEL,KAAK,UAAU,EAGhB,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,OAAO,EAAE;IACjD,MAAM,EAAE,gBAAgB,CAAC;IACzB,KAAK,EAAE,MAAM,UAAU,CAAC;IACxB,SAAS,EAAE,MAAM,OAAO,CAAC;IACzB,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,iBAAiB,EAAE,MAAM,CAAC;CAC3B,WACsB,oBAAoB,CAAC,MAAM,CAAC,KAAG,OAAO,CAAC,0BAA0B,CAAC,CAkCxF"}
+{"version":3,"file":"directory-inbox-accept.d.ts","sourceRoot":"","sources":["../../src/application/directory-inbox-accept.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,EACL,KAAK,oBAAoB,EACzB,KAAK,0BAA0B,EAEhC,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAEL,KAAK,UAAU,EAGhB,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE;IACzD,MAAM,EAAE,gBAAgB,CAAC;IACzB,KAAK,EAAE,MAAM,UAAU,CAAC;IACxB,SAAS,EAAE,MAAM,OAAO,CAAC;IACzB,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,aAAa,EAAE,MAAM,CAAC;IACtB,iBAAiB,EAAE,MAAM,CAAC;CAC3B,WACsB,oBAAoB,CAAC,MAAM,CAAC,KAAG,OAAO,CAAC,0BAA0B,CAAC,CAgCxF"}

package/dist/application/directory-inbox-contract.d.ts

@@ -1,11 +1,23 @@
 import { z } from 'zod';
 import type { ManagedResource, ManagedResourceDependency } from './resource.js';
 import type { StateStore } from './state-store.js';
+/**
+ * The identity of an inbox entry: `source` and `key`; a second entry with the same pair is a
+ * duplicate.
+ */
 export declare const DirectoryInboxIdentitySchema: z.ZodObject<{
     source: z.ZodString;
     key: z.ZodString;
 }, z.core.$strict>;
+/**
+ * The identity of an inbox entry: `source` and `key`; a second entry with the same pair is a
+ * duplicate.
+ */
 export type DirectoryInboxIdentity = z.infer<typeof DirectoryInboxIdentitySchema>;
+/**
+ * Result of accepting an entry: `accepted` for a new one, `duplicate` when that identity was
+ * already taken, plus the file name.
+ */
 export declare const DirectoryInboxAcceptResultSchema: z.ZodObject<{
     status: z.ZodEnum<{
         accepted: "accepted";
@@ -13,9 +25,17 @@ export declare const DirectoryInboxAcceptResultSchema: z.ZodObject<{
     }>;
     filename: z.ZodString;
 }, z.core.$strict>;
+/**
+ * Result of accepting an entry: `accepted` for a new one, `duplicate` when that identity was
+ * already taken, plus the file name.
+ */
 export type DirectoryInboxAcceptResult = z.infer<typeof DirectoryInboxAcceptResultSchema>;
-export interface DirectoryInboxAccept<TEntry> extends DirectoryInboxIdentity {
-    readonly entry: TEntry;
+/**
+ * A programmatic entry: what the schema accepts as input, stored as given and parsed on
+ * delivery.
+ */
+export interface DirectoryInboxAccept<TInput> extends DirectoryInboxIdentity {
+    readonly entry: TInput;
 }
 export declare const DirectoryInboxRejectionReasonSchema: z.ZodEnum<{
     "attempt-limit": "attempt-limit";
@@ -80,10 +100,11 @@ export interface DirectoryInboxDelivery<TEntry> {
     /** Aborted when the application is forced down mid-delivery. */
     readonly signal: AbortSignal;
 }
-export interface DirectoryInboxConfig<TEntry> {
+export interface DirectoryInboxConfig<TEntry, TInput = TEntry> {
     readonly id: string;
     readonly directory: string;
-    readonly schema: z.ZodType<TEntry>;
+    /** Parses every stored entry on delivery; `accept` takes its input type. */
+    readonly schema: z.ZodType<TEntry, TInput>;
     /** Throwing leaves the entry for a later attempt. */
     readonly handle: (delivery: DirectoryInboxDelivery<TEntry>) => void | Promise<void>;
     readonly dependsOn?: readonly ManagedResourceDependency[];
@@ -100,7 +121,11 @@ export interface DirectoryInboxConfig<TEntry> {
     readonly maxEntryBytes?: number;
     /** Programmatic acceptance refuses a full inbox without creating a file. Default 1 000. */
     readonly maxPendingEntries?: number;
-    /** Receipts and rejections kept. Default 1 000. */
+    /**
+     * Receipts and rejections kept, each list. Default 1 000. Every state update
+     * reads, validates and rewrites the whole state, so its cost grows with this
+     * number: keep it as small as duplicate detection needs.
+     */
     readonly retain?: number;
     /** An entry was set aside into `<directory>/rejected/`, with the reason. */
     readonly onRejected?: (rejection: DirectoryInboxRejection) => void | Promise<void>;
@@ -110,16 +135,16 @@ export interface DirectoryInboxConfig<TEntry> {
      */
     readonly onError?: (error: unknown) => void | Promise<void>;
 }
-export interface DirectoryInbox<TEntry = unknown> {
+export interface DirectoryInbox<TInput = unknown> {
     /** Durably buffer an entry before activation; duplicates never replace the first payload. */
-    accept(input: DirectoryInboxAccept<TEntry>): Promise<DirectoryInboxAcceptResult>;
+    accept(input: DirectoryInboxAccept<TInput>): Promise<DirectoryInboxAcceptResult>;
     /** Deliver every entry due now; resolves with how many were handled. */
     flush(): Promise<number>;
     state(): Promise<DirectoryInboxState>;
 }
-export interface DirectoryInboxResource<TEntry = unknown> extends ManagedResource {
+export interface DirectoryInboxResource<TInput = unknown> extends ManagedResource {
     start(): Promise<{
-        readonly value: DirectoryInbox<TEntry>;
+        readonly value: DirectoryInbox<TInput>;
     }>;
 }
 /** What the next step does with one entry of the directory. */
@@ -160,7 +185,10 @@ export declare function releaseEntry(state: DirectoryInboxState, claim: Director
 /** A expired or replaced owner cannot complete, reject, renew or release an entry. */
 export declare function ownsClaim(state: DirectoryInboxState, claim: DirectoryInboxClaim, now: Date): boolean;
 export declare function renewEntry(state: DirectoryInboxState, claim: DirectoryInboxClaim, now: Date, leaseMs: number): DirectoryInboxState;
-/** Records about entries that are gone from the directory, except a live lease. */
+/**
+ * Records about entries that are gone from the directory, except a live lease; the same state
+ * when none is.
+ */
 export declare function forgetMissing(state: DirectoryInboxState, present: ReadonlySet<string>, now: Date): DirectoryInboxState;
 export {};
 //# sourceMappingURL=directory-inbox-contract.d.ts.map

package/dist/application/directory-inbox-contract.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"directory-inbox-contract.d.ts","sourceRoot":"","sources":["../../src/application/directory-inbox-contract.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"directory-inbox-contract.d.ts","sourceRoot":"","sources":["../../src/application/directory-inbox-contract.ts"],"names":[],"mappings":"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"}

package/dist/application/directory-inbox-delivery.d.ts

@@ -1,8 +1,8 @@
 import { type DirectoryInboxClaim, type DirectoryInboxConfig } from './directory-inbox-contract.js';
-import type { InboxFiles } from './directory-inbox-files.js';
+import { type InboxFiles } from './directory-inbox-files.js';
 import { type InboxStateAccess } from './directory-inbox-state.js';
-export declare function createInboxDelivery<TEntry>(options: {
-    config: DirectoryInboxConfig<TEntry>;
+export declare function createInboxDelivery<TEntry, TInput>(options: {
+    config: DirectoryInboxConfig<TEntry, TInput>;
     access: InboxStateAccess;
     files: () => InboxFiles;
     clock: () => Date;

package/dist/application/directory-inbox-delivery.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"directory-inbox-delivery.d.ts","sourceRoot":"","sources":["../../src/application/directory-inbox-delivery.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EAM1B,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAqB,KAAK,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAInF,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,OAAO,EAAE;IACnD,MAAM,EAAE,oBAAoB,CAAC,MAAM,CAAC,CAAC;IACrC,MAAM,EAAE,gBAAgB,CAAC;IACzB,KAAK,EAAE,MAAM,UAAU,CAAC;IACxB,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,MAAM,EAAE,MAAM,WAAW,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3C,WAEsB,mBAAmB,KAAG,OAAO,CAAC,OAAO,CAAC,CAmH5D"}
+{"version":3,"file":"directory-inbox-delivery.d.ts","sourceRoot":"","sources":["../../src/application/directory-inbox-delivery.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EAM1B,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAmB,KAAK,UAAU,EAAkB,MAAM,yBAAyB,CAAC;AAC3F,OAAO,EAAqB,KAAK,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAInF,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE;IAC3D,MAAM,EAAE,oBAAoB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7C,MAAM,EAAE,gBAAgB,CAAC;IACzB,KAAK,EAAE,MAAM,UAAU,CAAC;IACxB,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,MAAM,EAAE,MAAM,WAAW,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3C,WAEsB,mBAAmB,KAAG,OAAO,CAAC,OAAO,CAAC,CAiI5D"}

package/dist/application/directory-inbox-files.d.ts

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { type FileObservation } from '../internal/bounded-file-read.js';
+import type { FileObservation } from '../internal/file-observation.js';
 import { type DirectoryInboxIdentity } from './directory-inbox-contract.js';
 import type { StateStoreUpdateContext } from './state-store.js';
 export type InboxRead<TEntry> = {
@@ -13,9 +13,24 @@ export type InboxRead<TEntry> = {
     observation?: FileObservation;
 } | null;
 export declare const missingInboxFile: (error: unknown) => boolean;
+/**
+ * A failure of one entry's own file. The pass reports it and moves on to the
+ * next entry; any other failure belongs to the state store or the directory and
+ * ends the pass.
+ */
+export declare class InboxEntryError extends Error {
+    readonly key: string;
+    constructor(key: string, cause: unknown);
+}
 export declare function inboxFilename(identity: DirectoryInboxIdentity): string;
 export declare function sameInboxIdentity(a: DirectoryInboxIdentity | undefined, b: DirectoryInboxIdentity): boolean;
-export declare function encodeInboxEntry<TEntry>(identity: DirectoryInboxIdentity, entry: TEntry, schema: z.ZodType<TEntry>, maxBytes: number): string;
+/**
+ * The envelope of a programmatic entry. The schema validates the entry, and
+ * what is stored is the entry itself — the schema's input — because delivery
+ * parses the stored file with the schema again and a transforming schema would
+ * not accept its own output.
+ */
+export declare function encodeInboxEntry<TEntry, TInput>(identity: DirectoryInboxIdentity, entry: TInput, schema: z.ZodType<TEntry, TInput>, maxBytes: number): string;
 export declare function createInboxFiles(directory: string, maxBytes: number): Promise<{
     names(limit?: number): Promise<string[]>;
     read<TEntry>(key: string, schema: z.ZodType<TEntry>): Promise<InboxRead<TEntry>>;

package/dist/application/directory-inbox-files.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"directory-inbox-files.d.ts","sourceRoot":"","sources":["../../src/application/directory-inbox-files.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAEL,KAAK,eAAe,EAErB,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EACL,KAAK,sBAAsB,EAE5B,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAY7D,MAAM,MAAM,SAAS,CAAC,MAAM,IACxB;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,sBAAsB,CAAC;IAAC,WAAW,EAAE,eAAe,CAAA;CAAE,GAClF;IACE,MAAM,EAAE,SAAS,GAAG,WAAW,CAAC;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,sBAAsB,CAAC;IAClC,WAAW,CAAC,EAAE,eAAe,CAAC;CAC/B,GACD,IAAI,CAAC;AAET,eAAO,MAAM,gBAAgB,UAAW,OAAO,KAAG,OACoB,CAAC;AAEvE,wBAAgB,aAAa,CAAC,QAAQ,EAAE,sBAAsB,GAAG,MAAM,CAQtE;AAED,wBAAgB,iBAAiB,CAC/B,CAAC,EAAE,sBAAsB,GAAG,SAAS,EACrC,CAAC,EAAE,sBAAsB,GACxB,OAAO,CAET;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EACrC,QAAQ,EAAE,sBAAsB,EAChC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,EACzB,QAAQ,EAAE,MAAM,GACf,MAAM,CAeR;AAED,wBAAsB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;kBA0BlD,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;SASnC,MAAM,OAAO,MAAM,UAAU,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;0BAuD1D,MAAM,GAAG,OAAO,CAAC,sBAAsB,GAAG,SAAS,CAAC;iBAezE,MAAM,SACJ,MAAM,WACJ,uBAAuB,GAC/B,OAAO,CAAC,IAAI,CAAC;gBAgBT,MAAM,WACF,uBAAuB,gBAClB,eAAe,GAC5B,OAAO,CAAC,IAAI,CAAC;kBAUT,MAAM,WACF,uBAAuB,gBAClB,eAAe,GAC5B,OAAO,CAAC,IAAI,CAAC;GAgBnB;AAED,MAAM,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC,CAAC"}
+{"version":3,"file":"directory-inbox-files.d.ts","sourceRoot":"","sources":["../../src/application/directory-inbox-files.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AASxB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAEpE,OAAO,EACL,KAAK,sBAAsB,EAE5B,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAY7D,MAAM,MAAM,SAAS,CAAC,MAAM,IACxB;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,sBAAsB,CAAC;IAAC,WAAW,EAAE,eAAe,CAAA;CAAE,GAClF;IACE,MAAM,EAAE,SAAS,GAAG,WAAW,CAAC;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,sBAAsB,CAAC;IAClC,WAAW,CAAC,EAAE,eAAe,CAAC;CAC/B,GACD,IAAI,CAAC;AAET,eAAO,MAAM,gBAAgB,UAAW,OAAO,KAAG,OACoB,CAAC;AAEvE;;;;GAIG;AACH,qBAAa,eAAgB,SAAQ,KAAK;IAEtC,QAAQ,CAAC,GAAG,EAAE,MAAM;IADtB,YACW,GAAG,EAAE,MAAM,EACpB,KAAK,EAAE,OAAO,EAIf;CACF;AA8CD,wBAAgB,aAAa,CAAC,QAAQ,EAAE,sBAAsB,GAAG,MAAM,CAQtE;AAED,wBAAgB,iBAAiB,CAC/B,CAAC,EAAE,sBAAsB,GAAG,SAAS,EACrC,CAAC,EAAE,sBAAsB,GACxB,OAAO,CAET;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAC7C,QAAQ,EAAE,sBAAsB,EAChC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,EACjC,QAAQ,EAAE,MAAM,GACf,MAAM,CAgBR;AAED,wBAAsB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;kBA0BlD,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;SASnC,MAAM,OAAO,MAAM,UAAU,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;0BA0D1D,MAAM,GAAG,OAAO,CAAC,sBAAsB,GAAG,SAAS,CAAC;iBAezE,MAAM,SACJ,MAAM,WACJ,uBAAuB,GAC/B,OAAO,CAAC,IAAI,CAAC;gBAgBT,MAAM,WACF,uBAAuB,gBAClB,eAAe,GAC5B,OAAO,CAAC,IAAI,CAAC;kBAMT,MAAM,WACF,uBAAuB,gBAClB,eAAe,GAC5B,OAAO,CAAC,IAAI,CAAC;GAyBnB;AAED,MAAM,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC,CAAC"}

package/dist/application/directory-inbox-state.d.ts

@@ -1,4 +1,4 @@
-import type { FileObservation } from '../internal/bounded-file-read.js';
+import type { FileObservation } from '../internal/file-observation.js';
 import { type DirectoryInboxRejection, type DirectoryInboxState } from './directory-inbox-contract.js';
 import type { InboxFiles } from './directory-inbox-files.js';
 import type { StateStore, StateStoreUpdate, StateStoreUpdateContext } from './state-store.js';

package/dist/application/directory-inbox-state.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"directory-inbox-state.d.ts","sourceRoot":"","sources":["../../src/application/directory-inbox-state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,EACL,KAAK,uBAAuB,EAC5B,KAAK,mBAAmB,EAGzB,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAE3F,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,OAAO,EACZ,UAAU,EAAE,CACV,KAAK,EAAE,mBAAmB,EAC1B,OAAO,EAAE,uBAAuB,KAE9B,gBAAgB,CAAC,mBAAmB,EAAE,OAAO,CAAC,GAC9C,OAAO,CAAC,gBAAgB,CAAC,mBAAmB,EAAE,OAAO,CAAC,CAAC,GAC1D,OAAO,CAAC,OAAO,CAAC,CAAC;IACpB,IAAI,IAAI,OAAO,CAAC,mBAAmB,CAAC,CAAC;CACtC;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,UAAU,CAAC,mBAAmB,CAAC,GAAG,gBAAgB,CAQzF;AAED,gGAAgG;AAChG,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,gBAAgB,EACxB,KAAK,EAAE,UAAU,EACjB,GAAG,EAAE,MAAM,EACX,UAAU,EAAE;IAAE,WAAW,EAAE,MAAM,CAAA;CAAE,GAAG,uBAAuB,EAC7D,WAAW,CAAC,EAAE,eAAe,GAC5B,OAAO,CAAC,IAAI,CAAC,CAsBf"}
+{"version":3,"file":"directory-inbox-state.d.ts","sourceRoot":"","sources":["../../src/application/directory-inbox-state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,EACL,KAAK,uBAAuB,EAC5B,KAAK,mBAAmB,EAGzB,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAE3F,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,OAAO,EACZ,UAAU,EAAE,CACV,KAAK,EAAE,mBAAmB,EAC1B,OAAO,EAAE,uBAAuB,KAE9B,gBAAgB,CAAC,mBAAmB,EAAE,OAAO,CAAC,GAC9C,OAAO,CAAC,gBAAgB,CAAC,mBAAmB,EAAE,OAAO,CAAC,CAAC,GAC1D,OAAO,CAAC,OAAO,CAAC,CAAC;IACpB,IAAI,IAAI,OAAO,CAAC,mBAAmB,CAAC,CAAC;CACtC;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,UAAU,CAAC,mBAAmB,CAAC,GAAG,gBAAgB,CAezF;AAED,gGAAgG;AAChG,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,gBAAgB,EACxB,KAAK,EAAE,UAAU,EACjB,GAAG,EAAE,MAAM,EACX,UAAU,EAAE;IAAE,WAAW,EAAE,MAAM,CAAA;CAAE,GAAG,uBAAuB,EAC7D,WAAW,CAAC,EAAE,eAAe,GAC5B,OAAO,CAAC,IAAI,CAAC,CAsBf"}

package/dist/application/directory-inbox.d.ts

@@ -1,4 +1,4 @@
 import { type DirectoryInboxConfig, type DirectoryInboxResource } from './directory-inbox-contract.js';
 /** One file-backed intake engine for atomically dropped and programmatically accepted entries. */
-export declare function createDirectoryInbox<TEntry>(config: DirectoryInboxConfig<TEntry>): DirectoryInboxResource<TEntry>;
+export declare function createDirectoryInbox<TEntry, TInput = TEntry>(config: DirectoryInboxConfig<TEntry, TInput>): DirectoryInboxResource<TInput>;
 //# sourceMappingURL=directory-inbox.d.ts.map

package/dist/application/directory-inbox.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"directory-inbox.d.ts","sourceRoot":"","sources":["../../src/application/directory-inbox.ts"],"names":[],"mappings":"AAIA,OAAO,EAGL,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,EAG5B,MAAM,4BAA4B,CAAC;AAkCpC,kGAAkG;AAClG,wBAAgB,oBAAoB,CAAC,MAAM,EACzC,MAAM,EAAE,oBAAoB,CAAC,MAAM,CAAC,GACnC,sBAAsB,CAAC,MAAM,CAAC,CAuJhC"}
+{"version":3,"file":"directory-inbox.d.ts","sourceRoot":"","sources":["../../src/application/directory-inbox.ts"],"names":[],"mappings":"AAKA,OAAO,EAGL,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,EAG5B,MAAM,4BAA4B,CAAC;AA8CpC,kGAAkG;AAClG,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAC1D,MAAM,EAAE,oBAAoB,CAAC,MAAM,EAAE,MAAM,CAAC,GAC3C,sBAAsB,CAAC,MAAM,CAAC,CAoKhC"}

package/dist/application/file-state-store.d.ts

@@ -1,4 +1,6 @@
 import type { z } from 'zod';
+import { writeAtomicFileData } from '../internal/atomic-file.js';
+import { withExclusiveLock } from '../internal/with-exclusive-lock.js';
 import type { StateStore } from './state-store.js';
 export interface FileStateStoreCorruption {
     readonly path: string;
@@ -11,7 +13,25 @@ export interface FileStateStoreOptions<TState> {
     readonly onCorrupt?: (failure: FileStateStoreCorruption) => void | Promise<void>;
     /** Maximum wait to acquire the lock; never revokes a live transition. Default 10 s. */
     readonly lockTimeoutMs?: number;
+    /**
+     * Largest state file a read accepts, in bytes; a larger file is refused before
+     * it is parsed and is not treated as corruption. Every update reads, validates
+     * and rewrites the whole file, so state that grows toward this size makes each
+     * update proportionally slower. Default 64 MiB.
+     */
+    readonly maxBytes?: number;
 }
-/** One durable atomic state transition under the canonical process-instance lock. */
+/** The write and the lock a store runs on; the seam where tests count work. */
+export interface FileStateStoreIO {
+    readonly write: typeof writeAtomicFileData;
+    readonly lock: typeof withExclusiveLock;
+}
+/**
+ * One durable atomic state transition under the canonical process-instance lock.
+ * A transition whose resulting state encodes to the bytes it started from
+ * changes nothing and writes nothing.
+ */
 export declare function createFileStateStore<TState>(path: string, options: FileStateStoreOptions<TState>): StateStore<TState>;
+/** {@link createFileStateStore} over an explicit write and lock. */
+export declare function createFileStateStoreOn<TState>(path: string, options: FileStateStoreOptions<TState>, io: FileStateStoreIO): StateStore<TState>;
 //# sourceMappingURL=file-state-store.d.ts.map

package/dist/application/file-state-store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"file-state-store.d.ts","sourceRoot":"","sources":["../../src/application/file-state-store.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAI7B,OAAO,KAAK,EAAE,UAAU,EAA2B,MAAM,eAAe,CAAC;AAEzE,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,qBAAqB,CAAC,MAAM;IAC3C,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACnC,uFAAuF;IACvF,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;IACrC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,wBAAwB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjF,uFAAuF;IACvF,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;CACjC;AAKD,qFAAqF;AACrF,wBAAgB,oBAAoB,CAAC,MAAM,EACzC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,qBAAqB,CAAC,MAAM,CAAC,GACrC,UAAU,CAAC,MAAM,CAAC,CAmEpB"}
+{"version":3,"file":"file-state-store.d.ts","sourceRoot":"","sources":["../../src/application/file-state-store.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAI9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,KAAK,EAAE,UAAU,EAA2B,MAAM,eAAe,CAAC;AAEzE,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,qBAAqB,CAAC,MAAM;IAC3C,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACnC,uFAAuF;IACvF,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;IACrC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,wBAAwB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjF,uFAAuF;IACvF,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,+EAA+E;AAC/E,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,KAAK,EAAE,OAAO,mBAAmB,CAAC;IAC3C,QAAQ,CAAC,IAAI,EAAE,OAAO,iBAAiB,CAAC;CACzC;AAUD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EACzC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,qBAAqB,CAAC,MAAM,CAAC,GACrC,UAAU,CAAC,MAAM,CAAC,CAEpB;AAED,oEAAoE;AACpE,wBAAgB,sBAAsB,CAAC,MAAM,EAC3C,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,qBAAqB,CAAC,MAAM,CAAC,EACtC,EAAE,EAAE,gBAAgB,GACnB,UAAU,CAAC,MAAM,CAAC,CAyEpB"}

package/dist/application/grammy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"grammy.d.ts","sourceRoot":"","sources":["../../src/application/grammy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,GAAG,EAAE,OAAO,EAAE,KAAK,cAAc,EAAE,KAAK,oBAAoB,EAAE,MAAM,QAAQ,CAAC;AAC3F,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9C,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,yBAAyB,EAC/B,MAAM,YAAY,CAAC;AAMpB,MAAM,WAAW,2BAA2B,CAAC,CAAC,SAAS,OAAO;IAC5D,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;IACrB,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,yBAAyB,EAAE,CAAC;IAC1D,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,cAAc,EAAE,SAAS,CAAC,CAAC;IACnD,QAAQ,CAAC,OAAO,CAAC,EAAE,cAAc,CAAC,SAAS,CAAC,CAAC;IAC7C,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5D;;;;;;OAMG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,gBAAgB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACpE;AAED,6FAA6F;AAC7F,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;CAC1B;AAgCD;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,SAAS,OAAO,EACrD,MAAM,EAAE,2BAA2B,CAAC,CAAC,CAAC,GACrC,eAAe,CA4EjB;AAED,MAAM,MAAM,YAAY,CAAC,CAAC,SAAS,OAAO,GAAG,OAAO,IAAI,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAE9F,MAAM,WAAW,2BAA2B,CAAC,CAAC,SAAS,OAAO;IAC5D,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;IACrB,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,yBAAyB,EAAE,CAAC;IAC1D,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7D;AAED,MAAM,WAAW,qBAAqB,CAAC,CAAC,SAAS,OAAO;IACtD,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;IACnC,YAAY,CACV,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,EACvB,oBAAoB,CAAC,EAAE,oBAAoB,GAC1C,OAAO,CAAC,IAAI,CAAC,CAAC;CAClB;AAaD;;;;;;;;;;;GAWG;AACH,qBAAa,6BAA8B,SAAQ,QAAQ,CAAC,8BAA8B,CAAC;IACzF,cAOC;CACF;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,CAAC,SAAS,OAAO,EAC3D,MAAM,EAAE,2BAA2B,CAAC,CAAC,CAAC,GACrC,qBAAqB,CAAC,CAAC,CAAC,CAiE1B"}
+{"version":3,"file":"grammy.d.ts","sourceRoot":"","sources":["../../src/application/grammy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,GAAG,EAAE,OAAO,EAAE,KAAK,cAAc,EAAE,KAAK,oBAAoB,EAAE,MAAM,QAAQ,CAAC;AAC3F,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9C,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,yBAAyB,EAC/B,MAAM,YAAY,CAAC;AAMpB,MAAM,WAAW,2BAA2B,CAAC,CAAC,SAAS,OAAO;IAC5D,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;IACrB,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,yBAAyB,EAAE,CAAC;IAC1D,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,cAAc,EAAE,SAAS,CAAC,CAAC;IACnD,QAAQ,CAAC,OAAO,CAAC,EAAE,cAAc,CAAC,SAAS,CAAC,CAAC;IAC7C,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5D;;;;;;OAMG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,gBAAgB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACpE;AAED,6FAA6F;AAC7F,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;CAC1B;AAgCD;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,SAAS,OAAO,EACrD,MAAM,EAAE,2BAA2B,CAAC,CAAC,CAAC,GACrC,eAAe,CA4EjB;AAED,MAAM,MAAM,YAAY,CAAC,CAAC,SAAS,OAAO,GAAG,OAAO,IAAI,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAE9F,MAAM,WAAW,2BAA2B,CAAC,CAAC,SAAS,OAAO;IAC5D,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;IACrB,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,yBAAyB,EAAE,CAAC;IAC1D,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7D;AAED,MAAM,WAAW,qBAAqB,CAAC,CAAC,SAAS,OAAO;IACtD,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;IACnC,YAAY,CACV,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,EACvB,oBAAoB,CAAC,EAAE,oBAAoB,GAC1C,OAAO,CAAC,IAAI,CAAC,CAAC;CAClB;AAaD;;;;;;;;;;;GAWG;AACH,qBAAa,6BAA8B,SAAQ,QAAQ,CAAC,8BAA8B,CAAC;IACzF,cAMC;CACF;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,CAAC,SAAS,OAAO,EAC3D,MAAM,EAAE,2BAA2B,CAAC,CAAC,CAAC,GACrC,qBAAqB,CAAC,CAAC,CAAC,CAiE1B"}

package/dist/application/kernel-contract.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"kernel-contract.d.ts","sourceRoot":"","sources":["../../src/application/kernel-contract.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"kernel-contract.d.ts","sourceRoot":"","sources":["../../src/application/kernel-contract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,KAAK,EACV,2BAA2B,EAC3B,yBAAyB,EACzB,mBAAmB,EACpB,MAAM,WAAW,CAAC;AAEnB,6EAA6E;AAC7E,MAAM,MAAM,wBAAwB,GAAG,2BAA2B,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;AAEvF,wEAAwE;AACxE,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,wBAAwB,CAAC;IACzC,8DAA8D;IAC9D,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,gCAAgC;;;;iBAI3C,CAAC;AACH,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gCAAgC,CAAC,CAAC;AAE1F;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,+BAA+B;;;iBAG1C,CAAC;AACH,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC;AAExF,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,eAAe,EAAE,CAAC;IAChD;;;OAGG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,yBAAyB,CAAC;IAC9C,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,mBAAmB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9E;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,QAAQ,CAAC,iBAAiB,CAAC,EAAE,CAAC,OAAO,EAAE,0BAA0B,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5F;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,IAAI,yBAAyB,GAAG,IAAI,CAAC;IAC5C,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CAChD;AAED,eAAO,MAAM,6BAA6B;;;;mBAe7B,CAAC;AACd,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC;AAEpF,eAAO,MAAM,+BAA+B;;;;EAA6C,CAAC;AAC1F,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC;AAExF,eAAO,MAAM,8BAA8B;;;;;;;;;;mBAmB9B,CAAC;AACd,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC;AAEtF,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,SAAS,EAAE,oBAAoB,CAAC;IACzC,KAAK,IAAI,OAAO,CAAC,mBAAmB,CAAC,CAAC;IACtC,WAAW,IAAI,mBAAmB,CAAC;IACnC,SAAS,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,mBAAmB,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IACzE,QAAQ,CAAC,OAAO,CAAC,EAAE,0BAA0B,GAAG,OAAO,CAAC,yBAAyB,CAAC,CAAC;IACnF;;;;;;;;OAQG;IACH,OAAO,CAAC,KAAK,EAAE,uBAAuB,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAAC;CAC5E;AAED;;;;;;;;;GASG;AACH,qBAAa,yBAA0B,SAAQ,QAAQ,CAAC,2BAA2B,CAAC;IAClF,cAMC;CACF"}

package/dist/application/revision-signal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"revision-signal.d.ts","sourceRoot":"","sources":["../../src/application/revision-signal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,eAAO,MAAM,yBAAyB;;;EAA6B,CAAC;AACpE,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E,eAAO,MAAM,+BAA+B;;;;;;EAM1C,CAAC;AACH,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC;AAExF,eAAO,MAAM,8BAA8B;;;;;;;;;mBAM9B,CAAC;AACd,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC;AAEtF,eAAO,MAAM,iCAAiC;;;;;;mBAMjC,CAAC;AACd,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iCAAiC,CAAC,CAAC;AAE5F,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;mBAiB5B,CAAC;AACd,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAElF,MAAM,WAAW,mBAAmB;IAClC,MAAM,IAAI,IAAI,CAAC;CAChB;AAED,0DAA0D;AAC1D,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,QAAQ,EAAE,MAAM,IAAI,EAAE,OAAO,EAAE,MAAM,GAAG,mBAAmB,CAAC;CACtE;AAED,MAAM,WAAW,oBAAoB;IACnC,2CAA2C;IAC3C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,sCAAsC;IACtC,QAAQ,CAAC,KAAK,CAAC,EAAE,mBAAmB,CAAC;CACtC;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAC9B,0DAA0D;IAC1D,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,cAAc;IAC7B,6EAA6E;IAC7E,OAAO,IAAI,2BAA2B,CAAC;IACvC;;;;;OAKG;IACH,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,yBAAyB,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAAC;IAC5F,KAAK,IAAI,sBAAsB,CAAC;IAChC,WAAW,IAAI,sBAAsB,CAAC;CACvC;AAaD,4EAA4E;AAC5E,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,oBAAoB,GAAG,cAAc,CAoHjF"}
+{"version":3,"file":"revision-signal.d.ts","sourceRoot":"","sources":["../../src/application/revision-signal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB,eAAO,MAAM,yBAAyB;;;EAA6B,CAAC;AACpE,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E,eAAO,MAAM,+BAA+B;;;;;;EAM1C,CAAC;AACH,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC;AAExF,eAAO,MAAM,8BAA8B;;;;;;;;;mBAM9B,CAAC;AACd,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC;AAEtF,eAAO,MAAM,iCAAiC;;;;;;mBAMjC,CAAC;AACd,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iCAAiC,CAAC,CAAC;AAE5F,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;mBAiB5B,CAAC;AACd,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAElF,MAAM,WAAW,mBAAmB;IAClC,MAAM,IAAI,IAAI,CAAC;CAChB;AAED,0DAA0D;AAC1D,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,QAAQ,EAAE,MAAM,IAAI,EAAE,OAAO,EAAE,MAAM,GAAG,mBAAmB,CAAC;CACtE;AAED,MAAM,WAAW,oBAAoB;IACnC,2CAA2C;IAC3C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,sCAAsC;IACtC,QAAQ,CAAC,KAAK,CAAC,EAAE,mBAAmB,CAAC;CACtC;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAC9B,0DAA0D;IAC1D,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,cAAc;IAC7B,6EAA6E;IAC7E,OAAO,IAAI,2BAA2B,CAAC;IACvC;;;;;OAKG;IACH,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,yBAAyB,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAAC;IAC5F,KAAK,IAAI,sBAAsB,CAAC;IAChC,WAAW,IAAI,sBAAsB,CAAC;CACvC;AAaD,4EAA4E;AAC5E,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,oBAAoB,GAAG,cAAc,CAoHjF"}

package/dist/application/state-store.d.ts

@@ -15,6 +15,9 @@ export interface StateStoreUpdateContext {
  * on the store, rather than building it from public `read` and `write` calls,
  * is what lets file and database adapters protect two application processes
  * from silently overwriting one another.
+ *
+ * A transition whose resulting state equals the state it started from changes nothing: an
+ * adapter may commit no write for it.
  */
 export interface StateStore<TState> {
     read(): Promise<TState | null>;

package/dist/application/state-store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"state-store.d.ts","sourceRoot":"","sources":["../../src/application/state-store.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,MAAM,WAAW,gBAAgB,CAAC,MAAM,EAAE,OAAO;IAC/C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B;AAED,2EAA2E;AAC3E,MAAM,WAAW,uBAAuB;IACtC,8EAA8E;IAC9E,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7B;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,UAAU,CAAC,MAAM;IAChC,IAAI,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC/B,MAAM,CAAC,OAAO,EACZ,UAAU,EAAE,CACV,OAAO,EAAE,MAAM,GAAG,IAAI,EACtB,OAAO,EAAE,uBAAuB,KAC7B,gBAAgB,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,gBAAgB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAClF,OAAO,CAAC,OAAO,CAAC,CAAC;CACrB"}
+{"version":3,"file":"state-store.d.ts","sourceRoot":"","sources":["../../src/application/state-store.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,MAAM,WAAW,gBAAgB,CAAC,MAAM,EAAE,OAAO;IAC/C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B;AAED,2EAA2E;AAC3E,MAAM,WAAW,uBAAuB;IACtC,8EAA8E;IAC9E,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7B;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,UAAU,CAAC,MAAM;IAChC,IAAI,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC/B,MAAM,CAAC,OAAO,EACZ,UAAU,EAAE,CACV,OAAO,EAAE,MAAM,GAAG,IAAI,EACtB,OAAO,EAAE,uBAAuB,KAC7B,gBAAgB,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,gBAAgB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAClF,OAAO,CAAC,OAAO,CAAC,CAAC;CACrB"}