@iworkforces/tracelattice 2.0.3

package/dist/persistence/FileSnapshotValidation.d.ts

@@ -0,0 +1,15 @@
+import type { FileSnapshotV2 } from './FileSnapshotTypes.js';
+/**
+ * Validates semantic invariants that are stricter than the File v2 shape schema.
+ *
+ * @param snapshot - Parsed or canonical File v2 snapshot.
+ * @param sourcePath - Source path included in compatibility errors.
+ * @returns Nothing when all snapshot invariants hold.
+ *
+ * @example
+ * ```ts
+ * validateFileSnapshotV2(snapshot, '/data/snapshot.json');
+ * ```
+ */
+export declare function validateFileSnapshotV2(snapshot: FileSnapshotV2, sourcePath: string): void;
+//# sourceMappingURL=FileSnapshotValidation.d.ts.map

package/dist/persistence/FileSnapshotValidation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileSnapshotValidation.d.ts","sourceRoot":"","sources":["../../src/persistence/FileSnapshotValidation.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AA+D7D;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAgDzF"}

package/dist/persistence/FileSnapshotValidation.js

@@ -0,0 +1,64 @@
+import { PersistenceCompatibilityError } from "../errors.js";
+import { assertBranchScope, assertPersistableThoughtCollections, assertThoughtScope, compareCodePoint, compareCreatedThenId } from "./PersistenceScope.js";
+function assertUniqueOrderedRecords(records, sourcePath, label) {
+    for(let index = 0; index < records.length; index++){
+        const current = records[index];
+        const previous = records[index - 1];
+        if (void 0 !== current && void 0 !== previous && compareCodePoint(previous.sessionId, current.sessionId) >= 0) throw new PersistenceCompatibilityError(sourcePath, `${label} records are duplicate or out of order`);
+    }
+}
+function assertUniqueIds(values, sourcePath, label) {
+    const identifiers = new Set();
+    for (const value of values){
+        if (identifiers.has(value.id)) throw new PersistenceCompatibilityError(sourcePath, `duplicate ${label} id '${value.id}'`);
+        identifiers.add(value.id);
+    }
+}
+function assertSorted(values, sourcePath, label) {
+    for(let index = 1; index < values.length; index++){
+        const previous = values[index - 1];
+        const current = values[index];
+        if (void 0 !== previous && void 0 !== current && compareCreatedThenId(previous, current) > 0) throw new PersistenceCompatibilityError(sourcePath, `${label} records are out of order`);
+    }
+}
+function validateFileSnapshotV2(snapshot, sourcePath) {
+    assertUniqueOrderedRecords(snapshot.thoughts, sourcePath, 'thought');
+    assertUniqueOrderedRecords(snapshot.edges, sourcePath, 'edge');
+    assertUniqueOrderedRecords(snapshot.summaries, sourcePath, 'summary');
+    const thoughtCollections = [];
+    for (const record of snapshot.thoughts){
+        if (0 === record.thoughts.length) throw new PersistenceCompatibilityError(sourcePath, 'empty thought record');
+        for (const thought of record.thoughts)assertThoughtScope('saveThoughtForSession', record.sessionId, thought);
+        thoughtCollections.push({
+            sessionId: record.sessionId,
+            thoughts: record.thoughts
+        });
+    }
+    let previousBranchKey;
+    for (const record of snapshot.branches){
+        const branchKey = `${record.sessionId}\u0000${record.branchId}`;
+        if (void 0 !== previousBranchKey && compareCodePoint(previousBranchKey, branchKey) >= 0) throw new PersistenceCompatibilityError(sourcePath, 'branch records are duplicate or out of order');
+        previousBranchKey = branchKey;
+        assertBranchScope('saveBranchForSession', record.sessionId, record.branchId, record.thoughts);
+        thoughtCollections.push({
+            sessionId: record.sessionId,
+            thoughts: record.thoughts
+        });
+    }
+    assertPersistableThoughtCollections(thoughtCollections, sourcePath);
+    for (const record of snapshot.edges){
+        if (0 === record.edges.length) throw new PersistenceCompatibilityError(sourcePath, 'empty edge record');
+        assertUniqueIds(record.edges, sourcePath, 'edge');
+        if (record.edges.some((edge)=>edge.sessionId !== record.sessionId)) throw new PersistenceCompatibilityError(sourcePath, 'edge session does not match its record');
+        assertSorted(record.edges, sourcePath, 'edge');
+    }
+    for (const record of snapshot.summaries){
+        if (0 === record.summaries.length) throw new PersistenceCompatibilityError(sourcePath, 'empty summary record');
+        assertUniqueIds(record.summaries, sourcePath, 'summary');
+        if (record.summaries.some((summary)=>summary.sessionId !== record.sessionId)) throw new PersistenceCompatibilityError(sourcePath, 'summary session does not match its record');
+        assertSorted(record.summaries, sourcePath, 'summary');
+    }
+}
+export { validateFileSnapshotV2 };
+
+//# sourceMappingURL=FileSnapshotValidation.js.map

package/dist/persistence/FileSnapshotValidation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"persistence/FileSnapshotValidation.js","sources":["../../src/persistence/FileSnapshotValidation.ts"],"sourcesContent":["import type { SessionId } from '../contracts/ids.js';\nimport { PersistenceCompatibilityError } from '../errors.js';\nimport type { FileSnapshotV2 } from './FileSnapshotTypes.js';\nimport {\n\tassertBranchScope,\n\tassertPersistableThoughtCollections,\n\tassertThoughtScope,\n\tcompareCodePoint,\n\tcompareCreatedThenId,\n\ttype PersistedThoughtCollection,\n} from './PersistenceScope.js';\n\nfunction assertUniqueOrderedRecords(\n\trecords: readonly { readonly sessionId: SessionId }[],\n\tsourcePath: string,\n\tlabel: string\n): void {\n\tfor (let index = 0; index < records.length; index++) {\n\t\tconst current = records[index];\n\t\tconst previous = records[index - 1];\n\t\tif (\n\t\t\tcurrent !== undefined &&\n\t\t\tprevious !== undefined &&\n\t\t\tcompareCodePoint(previous.sessionId, current.sessionId) >= 0\n\t\t) {\n\t\t\tthrow new PersistenceCompatibilityError(\n\t\t\t\tsourcePath,\n\t\t\t\t`${label} records are duplicate or out of order`\n\t\t\t);\n\t\t}\n\t}\n}\n\nfunction assertUniqueIds(\n\tvalues: readonly { readonly id: string }[],\n\tsourcePath: string,\n\tlabel: string\n): void {\n\tconst identifiers = new Set<string>();\n\tfor (const value of values) {\n\t\tif (identifiers.has(value.id)) {\n\t\t\tthrow new PersistenceCompatibilityError(sourcePath, `duplicate ${label} id '${value.id}'`);\n\t\t}\n\t\tidentifiers.add(value.id);\n\t}\n}\n\nfunction assertSorted(\n\tvalues: readonly { readonly createdAt: number; readonly id: string }[],\n\tsourcePath: string,\n\tlabel: string\n): void {\n\tfor (let index = 1; index < values.length; index++) {\n\t\tconst previous = values[index - 1];\n\t\tconst current = values[index];\n\t\tif (\n\t\t\tprevious !== undefined &&\n\t\t\tcurrent !== undefined &&\n\t\t\tcompareCreatedThenId(previous, current) > 0\n\t\t) {\n\t\t\tthrow new PersistenceCompatibilityError(sourcePath, `${label} records are out of order`);\n\t\t}\n\t}\n}\n\n/**\n * Validates semantic invariants that are stricter than the File v2 shape schema.\n *\n * @param snapshot - Parsed or canonical File v2 snapshot.\n * @param sourcePath - Source path included in compatibility errors.\n * @returns Nothing when all snapshot invariants hold.\n *\n * @example\n * ```ts\n * validateFileSnapshotV2(snapshot, '/data/snapshot.json');\n * ```\n */\nexport function validateFileSnapshotV2(snapshot: FileSnapshotV2, sourcePath: string): void {\n\tassertUniqueOrderedRecords(snapshot.thoughts, sourcePath, 'thought');\n\tassertUniqueOrderedRecords(snapshot.edges, sourcePath, 'edge');\n\tassertUniqueOrderedRecords(snapshot.summaries, sourcePath, 'summary');\n\tconst thoughtCollections: PersistedThoughtCollection[] = [];\n\tfor (const record of snapshot.thoughts) {\n\t\tif (record.thoughts.length === 0)\n\t\t\tthrow new PersistenceCompatibilityError(sourcePath, 'empty thought record');\n\t\tfor (const thought of record.thoughts) {\n\t\t\tassertThoughtScope('saveThoughtForSession', record.sessionId, thought);\n\t\t}\n\t\tthoughtCollections.push({ sessionId: record.sessionId, thoughts: record.thoughts });\n\t}\n\tlet previousBranchKey: string | undefined;\n\tfor (const record of snapshot.branches) {\n\t\tconst branchKey = `${record.sessionId}\\u0000${record.branchId}`;\n\t\tif (previousBranchKey !== undefined && compareCodePoint(previousBranchKey, branchKey) >= 0) {\n\t\t\tthrow new PersistenceCompatibilityError(\n\t\t\t\tsourcePath,\n\t\t\t\t'branch records are duplicate or out of order'\n\t\t\t);\n\t\t}\n\t\tpreviousBranchKey = branchKey;\n\t\tassertBranchScope('saveBranchForSession', record.sessionId, record.branchId, record.thoughts);\n\t\tthoughtCollections.push({ sessionId: record.sessionId, thoughts: record.thoughts });\n\t}\n\tassertPersistableThoughtCollections(thoughtCollections, sourcePath);\n\tfor (const record of snapshot.edges) {\n\t\tif (record.edges.length === 0)\n\t\t\tthrow new PersistenceCompatibilityError(sourcePath, 'empty edge record');\n\t\tassertUniqueIds(record.edges, sourcePath, 'edge');\n\t\tif (record.edges.some((edge) => edge.sessionId !== record.sessionId)) {\n\t\t\tthrow new PersistenceCompatibilityError(sourcePath, 'edge session does not match its record');\n\t\t}\n\t\tassertSorted(record.edges, sourcePath, 'edge');\n\t}\n\tfor (const record of snapshot.summaries) {\n\t\tif (record.summaries.length === 0)\n\t\t\tthrow new PersistenceCompatibilityError(sourcePath, 'empty summary record');\n\t\tassertUniqueIds(record.summaries, sourcePath, 'summary');\n\t\tif (record.summaries.some((summary) => summary.sessionId !== record.sessionId)) {\n\t\t\tthrow new PersistenceCompatibilityError(\n\t\t\t\tsourcePath,\n\t\t\t\t'summary session does not match its record'\n\t\t\t);\n\t\t}\n\t\tassertSorted(record.summaries, sourcePath, 'summary');\n\t}\n}\n"],"names":["assertUniqueOrderedRecords","records","sourcePath","label","index","current","previous","undefined","compareCodePoint","PersistenceCompatibilityError","assertUniqueIds","values","identifiers","Set","value","assertSorted","compareCreatedThenId","validateFileSnapshotV2","snapshot","thoughtCollections","record","thought","assertThoughtScope","previousBranchKey","branchKey","assertBranchScope","assertPersistableThoughtCollections","edge","summary"],"mappings":"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"}

package/dist/persistence/FileWriter.d.ts

@@ -0,0 +1,30 @@
+export interface FileWriterOperations {
+    readonly mkdir: (path: string) => Promise<void>;
+    readonly mkdirExclusive: (path: string) => Promise<void>;
+    readonly realpath: (path: string) => Promise<string>;
+    readonly rename: (source: string, destination: string) => Promise<void>;
+    readonly rmdir: (path: string) => Promise<void>;
+    readonly unlink: (path: string) => Promise<void>;
+    readonly writeExclusiveUtf8: (path: string, content: string) => Promise<void>;
+}
+export declare const nodeFileWriterOperations: FileWriterOperations;
+export declare function isFileNotFound(error: unknown): boolean;
+export declare class FileWriter {
+    private readonly _configuredDataDir;
+    private readonly _operations;
+    private _ownershipPromise;
+    private _ownership;
+    private _tail;
+    private _closePromise;
+    private _state;
+    constructor(dataDir: string, operations?: FileWriterOperations);
+    ready(): Promise<void>;
+    run<T>(operation: (canonicalDataDir: string) => Promise<T>): Promise<T>;
+    publish(targetPath: string, content: string): Promise<void>;
+    close(): Promise<void>;
+    private _getOwnership;
+    private _acquireOwnership;
+    private _cleanupFailedAcquisition;
+    private _releaseOwnership;
+}
+//# sourceMappingURL=FileWriter.d.ts.map

package/dist/persistence/FileWriter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileWriter.d.ts","sourceRoot":"","sources":["../../src/persistence/FileWriter.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,oBAAoB;IACpC,QAAQ,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAChD,QAAQ,CAAC,cAAc,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACzD,QAAQ,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACrD,QAAQ,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACxE,QAAQ,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAChD,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACjD,QAAQ,CAAC,kBAAkB,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9E;AAED,eAAO,MAAM,wBAAwB,EAAE,oBAYtC,CAAC;AAEF,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAEtD;AAkBD,qBAAa,UAAU;IACtB,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAS;IAC5C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAuB;IACnD,OAAO,CAAC,iBAAiB,CAA0C;IACnE,OAAO,CAAC,UAAU,CAAiC;IACnD,OAAO,CAAC,KAAK,CAAoC;IACjD,OAAO,CAAC,aAAa,CAA4B;IACjD,OAAO,CAAC,MAAM,CAAuB;gBAEzB,OAAO,EAAE,MAAM,EAAE,UAAU,GAAE,oBAA+C;IAK3E,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAO5B,GAAG,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,gBAAgB,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAgBjE,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA4BjE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAiB7B,OAAO,CAAC,aAAa;YAKP,iBAAiB;YA2BjB,yBAAyB;YAuBzB,iBAAiB;CAwB/B"}

package/dist/persistence/FileWriter.js

@@ -0,0 +1,155 @@
+import { mkdir, realpath, rename, rmdir, unlink, writeFile } from "node:fs/promises";
+import { randomUUID } from "node:crypto";
+import { basename, dirname, join } from "node:path";
+import { PersistenceClosedError, PersistenceOwnershipError, PersistencePublicationError } from "../errors.js";
+const WRITER_LOCK_NAME = '.tracelattice-writer.lock';
+const nodeFileWriterOperations = {
+    mkdir: async (path)=>{
+        await mkdir(path, {
+            recursive: true
+        });
+    },
+    mkdirExclusive: async (path)=>await mkdir(path),
+    realpath: async (path)=>await realpath(path),
+    rename: async (source, destination)=>await rename(source, destination),
+    rmdir: async (path)=>await rmdir(path),
+    unlink: async (path)=>await unlink(path),
+    writeExclusiveUtf8: async (path, content)=>{
+        await writeFile(path, content, {
+            encoding: 'utf-8',
+            flag: 'wx'
+        });
+    }
+};
+function isFileNotFound(error) {
+    return error instanceof Error && 'code' in error && 'ENOENT' === error.code;
+}
+function isFileAlreadyPresent(error) {
+    return error instanceof Error && 'code' in error && 'EEXIST' === error.code;
+}
+function isDirectoryNotEmpty(error) {
+    return error instanceof Error && 'code' in error && 'ENOTEMPTY' === error.code;
+}
+class FileWriter {
+    _configuredDataDir;
+    _operations;
+    _ownershipPromise;
+    _ownership;
+    _tail = Promise.resolve();
+    _closePromise;
+    _state = 'open';
+    constructor(dataDir, operations = nodeFileWriterOperations){
+        this._configuredDataDir = dataDir;
+        this._operations = operations;
+    }
+    async ready() {
+        if ('open' !== this._state) throw new PersistenceClosedError(this._configuredDataDir);
+        await this._getOwnership();
+    }
+    run(operation) {
+        if ('open' !== this._state) return Promise.reject(new PersistenceClosedError(this._configuredDataDir));
+        const queued = this._tail.then(async ()=>{
+            const ownership = await this._getOwnership();
+            return await operation(ownership.canonicalDataDir);
+        });
+        this._tail = queued.then(()=>void 0, ()=>void 0);
+        return queued;
+    }
+    async publish(targetPath, content) {
+        const temporaryPath = join(dirname(targetPath), `.${basename(targetPath)}.${process.pid}.${randomUUID()}.tmp`);
+        let stage = 'temporary-write';
+        try {
+            await this._operations.writeExclusiveUtf8(temporaryPath, content);
+            stage = 'atomic-replacement';
+            await this._operations.rename(temporaryPath, targetPath);
+        } catch (error) {
+            const publicationError = new PersistencePublicationError(targetPath, stage, error);
+            try {
+                await this._operations.unlink(temporaryPath);
+            } catch (cleanupError) {
+                if (!isFileNotFound(cleanupError)) throw new PersistencePublicationError(targetPath, 'cleanup', new AggregateError([
+                    publicationError,
+                    cleanupError
+                ]));
+            }
+            throw publicationError;
+        }
+    }
+    close() {
+        if (this._closePromise) return this._closePromise;
+        this._state = 'closing';
+        this._closePromise = (async ()=>{
+            try {
+                await this._tail;
+                await this._releaseOwnership();
+            } finally{
+                this._state = 'closed';
+            }
+        })();
+        return this._closePromise;
+    }
+    _getOwnership() {
+        this._ownershipPromise ??= this._acquireOwnership();
+        return this._ownershipPromise;
+    }
+    async _acquireOwnership() {
+        await this._operations.mkdir(this._configuredDataDir);
+        const canonicalDataDir = await this._operations.realpath(this._configuredDataDir);
+        const lockPath = join(canonicalDataDir, WRITER_LOCK_NAME);
+        const markerName = `${process.pid}-${randomUUID()}.owner`;
+        const markerPath = join(lockPath, markerName);
+        try {
+            await this._operations.mkdirExclusive(lockPath);
+        } catch (error) {
+            if (isFileAlreadyPresent(error)) throw new PersistenceOwnershipError(canonicalDataDir, lockPath, error);
+            throw error;
+        }
+        try {
+            await this._operations.writeExclusiveUtf8(markerPath, `${process.pid}\n`);
+        } catch (error) {
+            await this._cleanupFailedAcquisition(lockPath, markerPath, error);
+        }
+        const ownership = {
+            canonicalDataDir,
+            lockPath,
+            markerPath
+        };
+        this._ownership = ownership;
+        return ownership;
+    }
+    async _cleanupFailedAcquisition(lockPath, markerPath, acquisitionError) {
+        const failures = [
+            acquisitionError
+        ];
+        try {
+            await this._operations.unlink(markerPath);
+        } catch (unlinkError) {
+            if (!isFileNotFound(unlinkError)) failures.push(unlinkError);
+        }
+        try {
+            await this._operations.rmdir(lockPath);
+        } catch (removeDirectoryError) {
+            if (!isFileNotFound(removeDirectoryError) && !isDirectoryNotEmpty(removeDirectoryError)) failures.push(removeDirectoryError);
+        }
+        throw new PersistencePublicationError(lockPath, 'cleanup', new AggregateError(failures));
+    }
+    async _releaseOwnership() {
+        const ownership = this._ownership;
+        this._ownership = void 0;
+        if (!ownership) return;
+        try {
+            await this._operations.unlink(ownership.markerPath);
+        } catch (error) {
+            if (isFileNotFound(error)) return;
+            throw new PersistencePublicationError(ownership.markerPath, 'cleanup', error);
+        }
+        try {
+            await this._operations.rmdir(ownership.lockPath);
+        } catch (error) {
+            if (!isFileNotFound(error) && !isDirectoryNotEmpty(error)) throw new PersistencePublicationError(ownership.lockPath, 'cleanup', error);
+        }
+    }
+}
+export { FileWriter, isFileNotFound, nodeFileWriterOperations };
+
+//# sourceMappingURL=FileWriter.js.map

package/dist/persistence/FileWriter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"persistence/FileWriter.js","sources":["../../src/persistence/FileWriter.ts"],"sourcesContent":["import { mkdir, realpath, rename, rmdir, unlink, writeFile } from 'node:fs/promises';\nimport { randomUUID } from 'node:crypto';\nimport { basename, dirname, join } from 'node:path';\nimport {\n\tPersistenceClosedError,\n\tPersistenceOwnershipError,\n\tPersistencePublicationError,\n} from '../errors.js';\n\nconst WRITER_LOCK_NAME = '.tracelattice-writer.lock';\n\nexport interface FileWriterOperations {\n\treadonly mkdir: (path: string) => Promise<void>;\n\treadonly mkdirExclusive: (path: string) => Promise<void>;\n\treadonly realpath: (path: string) => Promise<string>;\n\treadonly rename: (source: string, destination: string) => Promise<void>;\n\treadonly rmdir: (path: string) => Promise<void>;\n\treadonly unlink: (path: string) => Promise<void>;\n\treadonly writeExclusiveUtf8: (path: string, content: string) => Promise<void>;\n}\n\nexport const nodeFileWriterOperations: FileWriterOperations = {\n\tmkdir: async (path) => {\n\t\tawait mkdir(path, { recursive: true });\n\t},\n\tmkdirExclusive: async (path) => await mkdir(path),\n\trealpath: async (path) => await realpath(path),\n\trename: async (source, destination) => await rename(source, destination),\n\trmdir: async (path) => await rmdir(path),\n\tunlink: async (path) => await unlink(path),\n\twriteExclusiveUtf8: async (path, content) => {\n\t\tawait writeFile(path, content, { encoding: 'utf-8', flag: 'wx' });\n\t},\n};\n\nexport function isFileNotFound(error: unknown): boolean {\n\treturn error instanceof Error && 'code' in error && error.code === 'ENOENT';\n}\n\nfunction isFileAlreadyPresent(error: unknown): boolean {\n\treturn error instanceof Error && 'code' in error && error.code === 'EEXIST';\n}\n\nfunction isDirectoryNotEmpty(error: unknown): boolean {\n\treturn error instanceof Error && 'code' in error && error.code === 'ENOTEMPTY';\n}\n\ntype DirectoryOwnership = {\n\treadonly canonicalDataDir: string;\n\treadonly lockPath: string;\n\treadonly markerPath: string;\n};\n\ntype WriterState = 'open' | 'closing' | 'closed';\n\nexport class FileWriter {\n\tprivate readonly _configuredDataDir: string;\n\tprivate readonly _operations: FileWriterOperations;\n\tprivate _ownershipPromise: Promise<DirectoryOwnership> | undefined;\n\tprivate _ownership: DirectoryOwnership | undefined;\n\tprivate _tail: Promise<void> = Promise.resolve();\n\tprivate _closePromise: Promise<void> | undefined;\n\tprivate _state: WriterState = 'open';\n\n\tconstructor(dataDir: string, operations: FileWriterOperations = nodeFileWriterOperations) {\n\t\tthis._configuredDataDir = dataDir;\n\t\tthis._operations = operations;\n\t}\n\n\tpublic async ready(): Promise<void> {\n\t\tif (this._state !== 'open') {\n\t\t\tthrow new PersistenceClosedError(this._configuredDataDir);\n\t\t}\n\t\tawait this._getOwnership();\n\t}\n\n\tpublic run<T>(operation: (canonicalDataDir: string) => Promise<T>): Promise<T> {\n\t\tif (this._state !== 'open') {\n\t\t\treturn Promise.reject(new PersistenceClosedError(this._configuredDataDir));\n\t\t}\n\n\t\tconst queued = this._tail.then(async () => {\n\t\t\tconst ownership = await this._getOwnership();\n\t\t\treturn await operation(ownership.canonicalDataDir);\n\t\t});\n\t\tthis._tail = queued.then(\n\t\t\t() => undefined,\n\t\t\t() => undefined\n\t\t);\n\t\treturn queued;\n\t}\n\n\tpublic async publish(targetPath: string, content: string): Promise<void> {\n\t\tconst temporaryPath = join(\n\t\t\tdirname(targetPath),\n\t\t\t`.${basename(targetPath)}.${process.pid}.${randomUUID()}.tmp`\n\t\t);\n\t\tlet stage: 'temporary-write' | 'atomic-replacement' = 'temporary-write';\n\n\t\ttry {\n\t\t\tawait this._operations.writeExclusiveUtf8(temporaryPath, content);\n\t\t\tstage = 'atomic-replacement';\n\t\t\tawait this._operations.rename(temporaryPath, targetPath);\n\t\t} catch (error) {\n\t\t\tconst publicationError = new PersistencePublicationError(targetPath, stage, error);\n\t\t\ttry {\n\t\t\t\tawait this._operations.unlink(temporaryPath);\n\t\t\t} catch (cleanupError) {\n\t\t\t\tif (!isFileNotFound(cleanupError)) {\n\t\t\t\t\tthrow new PersistencePublicationError(\n\t\t\t\t\t\ttargetPath,\n\t\t\t\t\t\t'cleanup',\n\t\t\t\t\t\tnew AggregateError([publicationError, cleanupError])\n\t\t\t\t\t);\n\t\t\t\t}\n\t\t\t}\n\t\t\tthrow publicationError;\n\t\t}\n\t}\n\n\tpublic close(): Promise<void> {\n\t\tif (this._closePromise) {\n\t\t\treturn this._closePromise;\n\t\t}\n\n\t\tthis._state = 'closing';\n\t\tthis._closePromise = (async () => {\n\t\t\ttry {\n\t\t\t\tawait this._tail;\n\t\t\t\tawait this._releaseOwnership();\n\t\t\t} finally {\n\t\t\t\tthis._state = 'closed';\n\t\t\t}\n\t\t})();\n\t\treturn this._closePromise;\n\t}\n\n\tprivate _getOwnership(): Promise<DirectoryOwnership> {\n\t\tthis._ownershipPromise ??= this._acquireOwnership();\n\t\treturn this._ownershipPromise;\n\t}\n\n\tprivate async _acquireOwnership(): Promise<DirectoryOwnership> {\n\t\tawait this._operations.mkdir(this._configuredDataDir);\n\t\tconst canonicalDataDir = await this._operations.realpath(this._configuredDataDir);\n\t\tconst lockPath = join(canonicalDataDir, WRITER_LOCK_NAME);\n\t\tconst markerName = `${process.pid}-${randomUUID()}.owner`;\n\t\tconst markerPath = join(lockPath, markerName);\n\n\t\ttry {\n\t\t\tawait this._operations.mkdirExclusive(lockPath);\n\t\t} catch (error) {\n\t\t\tif (isFileAlreadyPresent(error)) {\n\t\t\t\tthrow new PersistenceOwnershipError(canonicalDataDir, lockPath, error);\n\t\t\t}\n\t\t\tthrow error;\n\t\t}\n\n\t\ttry {\n\t\t\tawait this._operations.writeExclusiveUtf8(markerPath, `${process.pid}\\n`);\n\t\t} catch (error) {\n\t\t\tawait this._cleanupFailedAcquisition(lockPath, markerPath, error);\n\t\t}\n\n\t\tconst ownership = { canonicalDataDir, lockPath, markerPath } satisfies DirectoryOwnership;\n\t\tthis._ownership = ownership;\n\t\treturn ownership;\n\t}\n\n\tprivate async _cleanupFailedAcquisition(\n\t\tlockPath: string,\n\t\tmarkerPath: string,\n\t\tacquisitionError: unknown\n\t): Promise<never> {\n\t\tconst failures: unknown[] = [acquisitionError];\n\t\ttry {\n\t\t\tawait this._operations.unlink(markerPath);\n\t\t} catch (unlinkError) {\n\t\t\tif (!isFileNotFound(unlinkError)) {\n\t\t\t\tfailures.push(unlinkError);\n\t\t\t}\n\t\t}\n\t\ttry {\n\t\t\tawait this._operations.rmdir(lockPath);\n\t\t} catch (removeDirectoryError) {\n\t\t\tif (!isFileNotFound(removeDirectoryError) && !isDirectoryNotEmpty(removeDirectoryError)) {\n\t\t\t\tfailures.push(removeDirectoryError);\n\t\t\t}\n\t\t}\n\t\tthrow new PersistencePublicationError(lockPath, 'cleanup', new AggregateError(failures));\n\t}\n\n\tprivate async _releaseOwnership(): Promise<void> {\n\t\tconst ownership = this._ownership;\n\t\tthis._ownership = undefined;\n\t\tif (!ownership) {\n\t\t\treturn;\n\t\t}\n\n\t\ttry {\n\t\t\tawait this._operations.unlink(ownership.markerPath);\n\t\t} catch (error) {\n\t\t\tif (isFileNotFound(error)) {\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tthrow new PersistencePublicationError(ownership.markerPath, 'cleanup', error);\n\t\t}\n\n\t\ttry {\n\t\t\tawait this._operations.rmdir(ownership.lockPath);\n\t\t} catch (error) {\n\t\t\tif (!isFileNotFound(error) && !isDirectoryNotEmpty(error)) {\n\t\t\t\tthrow new PersistencePublicationError(ownership.lockPath, 'cleanup', error);\n\t\t\t}\n\t\t}\n\t}\n}\n"],"names":["WRITER_LOCK_NAME","nodeFileWriterOperations","path","mkdir","realpath","source","destination","rename","rmdir","unlink","content","writeFile","isFileNotFound","error","Error","isFileAlreadyPresent","isDirectoryNotEmpty","FileWriter","Promise","dataDir","operations","PersistenceClosedError","operation","queued","ownership","undefined","targetPath","temporaryPath","join","dirname","basename","process","randomUUID","stage","publicationError","PersistencePublicationError","cleanupError","AggregateError","canonicalDataDir","lockPath","markerName","markerPath","PersistenceOwnershipError","acquisitionError","failures","unlinkError","removeDirectoryError"],"mappings":"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"}

package/dist/persistence/MemoryPersistence.d.ts

@@ -0,0 +1,45 @@
+import type { ThoughtData } from '../core/thought.js';
+import type { Edge } from '../core/graph/Edge.js';
+import type { Summary } from '../core/compression/Summary.js';
+import type { SessionScopedPersistenceBackend } from '../contracts/PersistenceBackend.js';
+import { type BranchId, type SessionId } from '../contracts/ids.js';
+export interface MemoryPersistenceOptions {
+    maxSize?: number;
+    maxHistorySize?: number;
+    persistBranches?: boolean;
+}
+export declare class MemoryPersistence implements SessionScopedPersistenceBackend {
+    private readonly _histories;
+    private readonly _branches;
+    private readonly _edges;
+    private readonly _summaries;
+    private readonly _maxSize;
+    private readonly _persistBranches;
+    constructor(options?: MemoryPersistenceOptions);
+    saveThought(thought: ThoughtData): Promise<void>;
+    saveThoughtForSession(sessionId: SessionId, thought: ThoughtData, operation?: 'saveThought' | 'saveThoughtForSession'): Promise<void>;
+    loadHistory(): Promise<ThoughtData[]>;
+    loadHistoryForSession(sessionId: SessionId): Promise<ThoughtData[]>;
+    saveBranch(branchId: BranchId, thoughts: ThoughtData[]): Promise<void>;
+    saveBranchForSession(sessionId: SessionId, branchId: BranchId, thoughts: readonly ThoughtData[], operation?: 'saveBranch' | 'saveBranchForSession'): Promise<void>;
+    deleteBranch(branchId: BranchId): Promise<void>;
+    deleteBranchForSession(sessionId: SessionId, branchId: BranchId): Promise<void>;
+    loadBranch(branchId: BranchId): Promise<ThoughtData[] | undefined>;
+    loadBranchForSession(sessionId: SessionId, branchId: BranchId): Promise<ThoughtData[] | undefined>;
+    listBranches(): Promise<BranchId[]>;
+    listBranchesForSession(sessionId: SessionId): Promise<BranchId[]>;
+    listSessions(): Promise<SessionId[]>;
+    healthy(): Promise<boolean>;
+    clear(): Promise<void>;
+    clearSession(sessionId: SessionId): Promise<void>;
+    close(): Promise<void>;
+    saveEdges(sessionId: SessionId, edges: readonly Edge[]): Promise<void>;
+    loadEdges(sessionId: SessionId): Promise<Edge[]>;
+    listEdgeSessions(): Promise<SessionId[]>;
+    saveSummaries(sessionId: SessionId, summaries: readonly Summary[]): Promise<void>;
+    loadSummaries(sessionId: SessionId): Promise<Summary[]>;
+    getHistorySize(): number;
+    getBranchCount(): number;
+    getBranchIds(): BranchId[];
+}
+//# sourceMappingURL=MemoryPersistence.d.ts.map

package/dist/persistence/MemoryPersistence.d.ts.map

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

package/dist/persistence/MemoryPersistence.js

@@ -0,0 +1,180 @@
+import { GLOBAL_SESSION_ID, asSessionId } from "../contracts/ids.js";
+import { assertBranchScope, assertEdgeScopes, assertPersistableThoughtCollections, assertSummaryScopes, assertThoughtScope, assertUniqueRecordIds, compareCodePoint, compareCreatedThenId, parsePersistenceBranchId } from "./PersistenceScope.js";
+class MemoryPersistence {
+    _histories = new Map();
+    _branches = new Map();
+    _edges = new Map();
+    _summaries = new Map();
+    _maxSize;
+    _persistBranches;
+    constructor(options = {}){
+        const configuredSize = options.maxHistorySize ?? options.maxSize;
+        this._maxSize = void 0 !== configuredSize && configuredSize > 0 ? configuredSize : void 0;
+        this._persistBranches = options.persistBranches ?? true;
+    }
+    async saveThought(thought) {
+        await this.saveThoughtForSession(GLOBAL_SESSION_ID, thought, 'saveThought');
+    }
+    async saveThoughtForSession(sessionId, thought, operation = 'saveThoughtForSession') {
+        const validatedSessionId = asSessionId(sessionId);
+        assertThoughtScope(operation, validatedSessionId, thought);
+        const history = [
+            ...this._histories.get(validatedSessionId) ?? [],
+            thought
+        ];
+        const collections = [
+            {
+                sessionId: validatedSessionId,
+                thoughts: history
+            }
+        ];
+        for (const branch of this._branches.get(validatedSessionId)?.values() ?? [])collections.push({
+            sessionId: validatedSessionId,
+            thoughts: branch
+        });
+        assertPersistableThoughtCollections(collections, `${validatedSessionId}/thoughts`);
+        this._histories.set(validatedSessionId, void 0 === this._maxSize ? history : history.slice(-this._maxSize));
+    }
+    async loadHistory() {
+        return await this.loadHistoryForSession(GLOBAL_SESSION_ID);
+    }
+    async loadHistoryForSession(sessionId) {
+        return [
+            ...this._histories.get(asSessionId(sessionId)) ?? []
+        ];
+    }
+    async saveBranch(branchId, thoughts) {
+        await this.saveBranchForSession(GLOBAL_SESSION_ID, branchId, thoughts, 'saveBranch');
+    }
+    async saveBranchForSession(sessionId, branchId, thoughts, operation = 'saveBranchForSession') {
+        const validatedSessionId = asSessionId(sessionId);
+        const validatedBranchId = parsePersistenceBranchId(branchId, `${validatedSessionId}/branches`);
+        assertBranchScope(operation, validatedSessionId, validatedBranchId, thoughts);
+        const branches = new Map(this._branches.get(validatedSessionId) ?? []);
+        branches.set(validatedBranchId, [
+            ...thoughts
+        ]);
+        const collections = [
+            {
+                sessionId: validatedSessionId,
+                thoughts: this._histories.get(validatedSessionId) ?? []
+            }
+        ];
+        for (const branch of branches.values())collections.push({
+            sessionId: validatedSessionId,
+            thoughts: branch
+        });
+        assertPersistableThoughtCollections(collections, `${validatedSessionId}/branches/${validatedBranchId}`);
+        if (!this._persistBranches) return;
+        this._branches.set(validatedSessionId, branches);
+    }
+    async deleteBranch(branchId) {
+        await this.deleteBranchForSession(GLOBAL_SESSION_ID, branchId);
+    }
+    async deleteBranchForSession(sessionId, branchId) {
+        if (!this._persistBranches) return;
+        const validatedSessionId = asSessionId(sessionId);
+        const validatedBranchId = parsePersistenceBranchId(branchId, `${validatedSessionId}/branches`);
+        const branches = this._branches.get(validatedSessionId);
+        if (void 0 === branches) return;
+        branches.delete(validatedBranchId);
+        if (0 === branches.size) this._branches.delete(validatedSessionId);
+    }
+    async loadBranch(branchId) {
+        return await this.loadBranchForSession(GLOBAL_SESSION_ID, branchId);
+    }
+    async loadBranchForSession(sessionId, branchId) {
+        if (!this._persistBranches) return;
+        const validatedSessionId = asSessionId(sessionId);
+        const validatedBranchId = parsePersistenceBranchId(branchId, `${validatedSessionId}/branches`);
+        const branch = this._branches.get(validatedSessionId)?.get(validatedBranchId);
+        return void 0 === branch ? void 0 : [
+            ...branch
+        ];
+    }
+    async listBranches() {
+        return await this.listBranchesForSession(GLOBAL_SESSION_ID);
+    }
+    async listBranchesForSession(sessionId) {
+        if (!this._persistBranches) return [];
+        return [
+            ...this._branches.get(asSessionId(sessionId))?.keys() ?? []
+        ].sort(compareCodePoint);
+    }
+    async listSessions() {
+        const sessions = new Set();
+        for (const namespace of [
+            this._histories,
+            this._branches,
+            this._edges,
+            this._summaries
+        ])for (const sessionId of namespace.keys())sessions.add(sessionId);
+        return [
+            ...sessions
+        ].sort(compareCodePoint);
+    }
+    async healthy() {
+        return true;
+    }
+    async clear() {
+        this._histories.clear();
+        this._branches.clear();
+        this._edges.clear();
+        this._summaries.clear();
+    }
+    async clearSession(sessionId) {
+        const validatedSessionId = asSessionId(sessionId);
+        this._histories.delete(validatedSessionId);
+        this._branches.delete(validatedSessionId);
+        this._edges.delete(validatedSessionId);
+        this._summaries.delete(validatedSessionId);
+    }
+    async close() {}
+    async saveEdges(sessionId, edges) {
+        const validatedSessionId = asSessionId(sessionId);
+        assertEdgeScopes(validatedSessionId, edges);
+        assertUniqueRecordIds(edges, `${validatedSessionId}/edges`, 'edge');
+        if (0 === edges.length) this._edges.delete(validatedSessionId);
+        else this._edges.set(validatedSessionId, [
+            ...edges
+        ].sort(compareCreatedThenId));
+    }
+    async loadEdges(sessionId) {
+        return [
+            ...this._edges.get(asSessionId(sessionId)) ?? []
+        ].sort(compareCreatedThenId);
+    }
+    async listEdgeSessions() {
+        return [
+            ...this._edges.keys()
+        ].sort(compareCodePoint);
+    }
+    async saveSummaries(sessionId, summaries) {
+        const validatedSessionId = asSessionId(sessionId);
+        assertSummaryScopes(validatedSessionId, summaries);
+        assertUniqueRecordIds(summaries, `${validatedSessionId}/summaries`, 'summary');
+        if (0 === summaries.length) this._summaries.delete(validatedSessionId);
+        else this._summaries.set(validatedSessionId, [
+            ...summaries
+        ].sort(compareCreatedThenId));
+    }
+    async loadSummaries(sessionId) {
+        return [
+            ...this._summaries.get(asSessionId(sessionId)) ?? []
+        ].sort(compareCreatedThenId);
+    }
+    getHistorySize() {
+        return this._histories.get(GLOBAL_SESSION_ID)?.length ?? 0;
+    }
+    getBranchCount() {
+        return this._branches.get(GLOBAL_SESSION_ID)?.size ?? 0;
+    }
+    getBranchIds() {
+        return [
+            ...this._branches.get(GLOBAL_SESSION_ID)?.keys() ?? []
+        ].sort(compareCodePoint);
+    }
+}
+export { MemoryPersistence };
+
+//# sourceMappingURL=MemoryPersistence.js.map

package/dist/persistence/MemoryPersistence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"persistence/MemoryPersistence.js","sources":["../../src/persistence/MemoryPersistence.ts"],"sourcesContent":["import type { ThoughtData } from '../core/thought.js';\nimport type { Edge } from '../core/graph/Edge.js';\nimport type { Summary } from '../core/compression/Summary.js';\nimport type { SessionScopedPersistenceBackend } from '../contracts/PersistenceBackend.js';\nimport { asSessionId, GLOBAL_SESSION_ID, type BranchId, type SessionId } from '../contracts/ids.js';\nimport {\n\tassertBranchScope,\n\tassertEdgeScopes,\n\tassertPersistableThoughtCollections,\n\tassertSummaryScopes,\n\tassertThoughtScope,\n\tassertUniqueRecordIds,\n\tcompareCodePoint,\n\tcompareCreatedThenId,\n\tparsePersistenceBranchId,\n\ttype PersistedThoughtCollection,\n} from './PersistenceScope.js';\n\nexport interface MemoryPersistenceOptions {\n\tmaxSize?: number;\n\tmaxHistorySize?: number;\n\tpersistBranches?: boolean;\n}\n\nexport class MemoryPersistence implements SessionScopedPersistenceBackend {\n\tprivate readonly _histories = new Map<SessionId, ThoughtData[]>();\n\tprivate readonly _branches = new Map<SessionId, Map<BranchId, ThoughtData[]>>();\n\tprivate readonly _edges = new Map<SessionId, Edge[]>();\n\tprivate readonly _summaries = new Map<SessionId, Summary[]>();\n\tprivate readonly _maxSize: number | undefined;\n\tprivate readonly _persistBranches: boolean;\n\n\tconstructor(options: MemoryPersistenceOptions = {}) {\n\t\tconst configuredSize = options.maxHistorySize ?? options.maxSize;\n\t\tthis._maxSize = configuredSize !== undefined && configuredSize > 0 ? configuredSize : undefined;\n\t\tthis._persistBranches = options.persistBranches ?? true;\n\t}\n\n\tpublic async saveThought(thought: ThoughtData): Promise<void> {\n\t\tawait this.saveThoughtForSession(GLOBAL_SESSION_ID, thought, 'saveThought');\n\t}\n\n\tpublic async saveThoughtForSession(\n\t\tsessionId: SessionId,\n\t\tthought: ThoughtData,\n\t\toperation: 'saveThought' | 'saveThoughtForSession' = 'saveThoughtForSession'\n\t): Promise<void> {\n\t\tconst validatedSessionId = asSessionId(sessionId);\n\t\tassertThoughtScope(operation, validatedSessionId, thought);\n\t\tconst history = [...(this._histories.get(validatedSessionId) ?? []), thought];\n\t\tconst collections: PersistedThoughtCollection[] = [\n\t\t\t{ sessionId: validatedSessionId, thoughts: history },\n\t\t];\n\t\tfor (const branch of this._branches.get(validatedSessionId)?.values() ?? []) {\n\t\t\tcollections.push({ sessionId: validatedSessionId, thoughts: branch });\n\t\t}\n\t\tassertPersistableThoughtCollections(collections, `${validatedSessionId}/thoughts`);\n\t\tthis._histories.set(\n\t\t\tvalidatedSessionId,\n\t\t\tthis._maxSize === undefined ? history : history.slice(-this._maxSize)\n\t\t);\n\t}\n\n\tpublic async loadHistory(): Promise<ThoughtData[]> {\n\t\treturn await this.loadHistoryForSession(GLOBAL_SESSION_ID);\n\t}\n\n\tpublic async loadHistoryForSession(sessionId: SessionId): Promise<ThoughtData[]> {\n\t\treturn [...(this._histories.get(asSessionId(sessionId)) ?? [])];\n\t}\n\n\tpublic async saveBranch(branchId: BranchId, thoughts: ThoughtData[]): Promise<void> {\n\t\tawait this.saveBranchForSession(GLOBAL_SESSION_ID, branchId, thoughts, 'saveBranch');\n\t}\n\n\tpublic async saveBranchForSession(\n\t\tsessionId: SessionId,\n\t\tbranchId: BranchId,\n\t\tthoughts: readonly ThoughtData[],\n\t\toperation: 'saveBranch' | 'saveBranchForSession' = 'saveBranchForSession'\n\t): Promise<void> {\n\t\tconst validatedSessionId = asSessionId(sessionId);\n\t\tconst validatedBranchId = parsePersistenceBranchId(branchId, `${validatedSessionId}/branches`);\n\t\tassertBranchScope(operation, validatedSessionId, validatedBranchId, thoughts);\n\t\tconst branches = new Map(this._branches.get(validatedSessionId) ?? []);\n\t\tbranches.set(validatedBranchId, [...thoughts]);\n\t\tconst collections: PersistedThoughtCollection[] = [\n\t\t\t{\n\t\t\t\tsessionId: validatedSessionId,\n\t\t\t\tthoughts: this._histories.get(validatedSessionId) ?? [],\n\t\t\t},\n\t\t];\n\t\tfor (const branch of branches.values()) {\n\t\t\tcollections.push({ sessionId: validatedSessionId, thoughts: branch });\n\t\t}\n\t\tassertPersistableThoughtCollections(\n\t\t\tcollections,\n\t\t\t`${validatedSessionId}/branches/${validatedBranchId}`\n\t\t);\n\t\tif (!this._persistBranches) return;\n\t\tthis._branches.set(validatedSessionId, branches);\n\t}\n\n\tpublic async deleteBranch(branchId: BranchId): Promise<void> {\n\t\tawait this.deleteBranchForSession(GLOBAL_SESSION_ID, branchId);\n\t}\n\n\tpublic async deleteBranchForSession(sessionId: SessionId, branchId: BranchId): Promise<void> {\n\t\tif (!this._persistBranches) return;\n\t\tconst validatedSessionId = asSessionId(sessionId);\n\t\tconst validatedBranchId = parsePersistenceBranchId(branchId, `${validatedSessionId}/branches`);\n\t\tconst branches = this._branches.get(validatedSessionId);\n\t\tif (branches === undefined) return;\n\t\tbranches.delete(validatedBranchId);\n\t\tif (branches.size === 0) this._branches.delete(validatedSessionId);\n\t}\n\n\tpublic async loadBranch(branchId: BranchId): Promise<ThoughtData[] | undefined> {\n\t\treturn await this.loadBranchForSession(GLOBAL_SESSION_ID, branchId);\n\t}\n\n\tpublic async loadBranchForSession(\n\t\tsessionId: SessionId,\n\t\tbranchId: BranchId\n\t): Promise<ThoughtData[] | undefined> {\n\t\tif (!this._persistBranches) return undefined;\n\t\tconst validatedSessionId = asSessionId(sessionId);\n\t\tconst validatedBranchId = parsePersistenceBranchId(branchId, `${validatedSessionId}/branches`);\n\t\tconst branch = this._branches.get(validatedSessionId)?.get(validatedBranchId);\n\t\treturn branch === undefined ? undefined : [...branch];\n\t}\n\n\tpublic async listBranches(): Promise<BranchId[]> {\n\t\treturn await this.listBranchesForSession(GLOBAL_SESSION_ID);\n\t}\n\n\tpublic async listBranchesForSession(sessionId: SessionId): Promise<BranchId[]> {\n\t\tif (!this._persistBranches) return [];\n\t\treturn [...(this._branches.get(asSessionId(sessionId))?.keys() ?? [])].sort(compareCodePoint);\n\t}\n\n\tpublic async listSessions(): Promise<SessionId[]> {\n\t\tconst sessions = new Set<SessionId>();\n\t\tfor (const namespace of [this._histories, this._branches, this._edges, this._summaries]) {\n\t\t\tfor (const sessionId of namespace.keys()) sessions.add(sessionId);\n\t\t}\n\t\treturn [...sessions].sort(compareCodePoint);\n\t}\n\n\tpublic async healthy(): Promise<boolean> {\n\t\treturn true;\n\t}\n\n\tpublic async clear(): Promise<void> {\n\t\tthis._histories.clear();\n\t\tthis._branches.clear();\n\t\tthis._edges.clear();\n\t\tthis._summaries.clear();\n\t}\n\n\tpublic async clearSession(sessionId: SessionId): Promise<void> {\n\t\tconst validatedSessionId = asSessionId(sessionId);\n\t\tthis._histories.delete(validatedSessionId);\n\t\tthis._branches.delete(validatedSessionId);\n\t\tthis._edges.delete(validatedSessionId);\n\t\tthis._summaries.delete(validatedSessionId);\n\t}\n\n\tpublic async close(): Promise<void> {}\n\n\tpublic async saveEdges(sessionId: SessionId, edges: readonly Edge[]): Promise<void> {\n\t\tconst validatedSessionId = asSessionId(sessionId);\n\t\tassertEdgeScopes(validatedSessionId, edges);\n\t\tassertUniqueRecordIds(edges, `${validatedSessionId}/edges`, 'edge');\n\t\tif (edges.length === 0) this._edges.delete(validatedSessionId);\n\t\telse this._edges.set(validatedSessionId, [...edges].sort(compareCreatedThenId));\n\t}\n\n\tpublic async loadEdges(sessionId: SessionId): Promise<Edge[]> {\n\t\treturn [...(this._edges.get(asSessionId(sessionId)) ?? [])].sort(compareCreatedThenId);\n\t}\n\n\tpublic async listEdgeSessions(): Promise<SessionId[]> {\n\t\treturn [...this._edges.keys()].sort(compareCodePoint);\n\t}\n\n\tpublic async saveSummaries(sessionId: SessionId, summaries: readonly Summary[]): Promise<void> {\n\t\tconst validatedSessionId = asSessionId(sessionId);\n\t\tassertSummaryScopes(validatedSessionId, summaries);\n\t\tassertUniqueRecordIds(summaries, `${validatedSessionId}/summaries`, 'summary');\n\t\tif (summaries.length === 0) this._summaries.delete(validatedSessionId);\n\t\telse this._summaries.set(validatedSessionId, [...summaries].sort(compareCreatedThenId));\n\t}\n\n\tpublic async loadSummaries(sessionId: SessionId): Promise<Summary[]> {\n\t\treturn [...(this._summaries.get(asSessionId(sessionId)) ?? [])].sort(compareCreatedThenId);\n\t}\n\n\tpublic getHistorySize(): number {\n\t\treturn this._histories.get(GLOBAL_SESSION_ID)?.length ?? 0;\n\t}\n\n\tpublic getBranchCount(): number {\n\t\treturn this._branches.get(GLOBAL_SESSION_ID)?.size ?? 0;\n\t}\n\n\tpublic getBranchIds(): BranchId[] {\n\t\treturn [...(this._branches.get(GLOBAL_SESSION_ID)?.keys() ?? [])].sort(compareCodePoint);\n\t}\n}\n"],"names":["MemoryPersistence","Map","options","configuredSize","undefined","thought","GLOBAL_SESSION_ID","sessionId","operation","validatedSessionId","asSessionId","assertThoughtScope","history","collections","branch","assertPersistableThoughtCollections","branchId","thoughts","validatedBranchId","parsePersistenceBranchId","assertBranchScope","branches","compareCodePoint","sessions","Set","namespace","edges","assertEdgeScopes","assertUniqueRecordIds","compareCreatedThenId","summaries","assertSummaryScopes"],"mappings":"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"}

package/dist/persistence/PersistenceCodec.d.ts

@@ -0,0 +1,7 @@
+import type { Summary } from '../core/compression/Summary.js';
+import type { Edge } from '../core/graph/Edge.js';
+import type { ThoughtData } from '../core/thought.js';
+export declare function parseThoughtData(raw: unknown, sourcePath: string): ThoughtData;
+export declare function parseEdge(raw: unknown): Edge;
+export declare function parseSummary(raw: unknown, sourcePath: string): Summary;
+//# sourceMappingURL=PersistenceCodec.d.ts.map

package/dist/persistence/PersistenceCodec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PersistenceCodec.d.ts","sourceRoot":"","sources":["../../src/persistence/PersistenceCodec.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gCAAgC,CAAC;AAE9D,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AA2FtD,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,GAAG,WAAW,CAkC9E;AAED,wBAAgB,SAAS,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAS5C;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAkBtE"}