@lmzhen/dsh-evolution-state-json 0.31.0 → 0.32.0

package/lib/index.js

@@ -2,6 +2,54 @@ import z from "@deepseek-ai/schemastery";
 import { evolutionHome, isAbsent, isPresent, isRecord, isUnknown, makeSerialQueue, probeText, transactIo, transactTaskGuard } from "@lmzhen/dsh-evolution-core";
 import { CURATOR_STATE_FILE, CURATOR_STATE_KEY, CURATOR_STATE_TABLE, PENDING_ARCHIVE_BAK_FILE, PENDING_ARCHIVE_FILE, PENDING_LEGACY_FILE, PENDING_RESOLVED_CAP, PENDING_STATE_FILE, PENDING_TABLE, PROVIDER_JSON, REVIEW_STATE_FILE, REVIEW_STATE_SESSION_CAP, REVIEW_STATE_TABLE, assertCloneable, canClaimPending, canResolvePending, cloneRecord, recordIssue, releasedStatus, selectPendingOverflow, selectSessionOverflow } from "@lmzhen/dsh-evolution-state-storage";
 import { basename, dirname, isAbsolute, join } from "node:path";
+//#region lib/types/state-store.js
+const safeName = (collection) => String(collection).replace(/[^a-zA-Z0-9._-]/g, "_");
+var JsonStateStore = class {
+	name = "json-state-store";
+	capabilities = { crossProcess: false };
+	io;
+	root;
+	serial = makeSerialQueue();
+	constructor(io, root) {
+		this.io = io;
+		this.root = root;
+	}
+	path(collection) {
+		return join(this.root, "state-store", safeName(collection) + ".json");
+	}
+	async load(collection) {
+		const text = await this.io.readText(this.path(collection));
+		if (text === null) return {
+			schemaVersion: 1,
+			records: {}
+		};
+		const parsed = JSON.parse(text);
+		if (parsed.schemaVersion !== 1 || parsed.records === null || typeof parsed.records !== "object" || Array.isArray(parsed.records)) throw new Error("state-store collection is corrupt: " + String(collection));
+		return parsed;
+	}
+	async read(collection, key) {
+		return (await this.load(collection)).records[key];
+	}
+	async transact(collection, key, fn) {
+		return this.serial(async () => {
+			let next;
+			await transactIo(this.io, this.path(collection), async (current) => {
+				const file = current === null ? {
+					schemaVersion: 1,
+					records: {}
+				} : JSON.parse(current);
+				next = await fn(file.records[key]);
+				file.records[key] = next;
+				return JSON.stringify(file);
+			});
+			return next;
+		});
+	}
+	async list(collection) {
+		return Object.values((await this.load(collection)).records);
+	}
+};
+//#endregion
 //#region lib/types/index.js
 /**
 * JSON-file evolution state provider over the IO seam.
@@ -704,6 +752,7 @@ function apply(ctx, rawConfig = {}) {
 		}
 	};
 	ctx.effect(() => ctx.evolutionStateStorage.registerProvider(provider), "evolution-state-json.provider");
+	ctx.provide("evolutionStateStore", new JsonStateStore(io(), root));
 }
 //#endregion
-export { Config, apply, inject, jsonTransact, name, newQuarantineMemory };
+export { Config, JsonStateStore, apply, inject, jsonTransact, name, newQuarantineMemory };

package/lib/types/index.d.ts

@@ -57,4 +57,5 @@ export declare function jsonTransact<T>(ctx: Context, io: () => EvolutionIoLike,
     memory: QuarantineMemory;
 }): Promise<void>;
 export declare function apply(ctx: Context, rawConfig?: Config): void;
+export { JsonStateStore } from './state-store.ts';
 //# sourceMappingURL=index.d.ts.map

package/lib/types/state-store.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Generic JSON-file implementation of the contract StateStore.
+ *
+ * One file per collection; records use a key map. `transact` delegates to the
+ * IO seam's transact, so the medium's serialization/CAS behavior is preserved.
+ * The node backend is process-local, so capabilities.crossProcess is false.
+ */
+import type { EvolutionCollection, EvolutionStateCapabilities, EvolutionStateStore } from '@lmzhen/dsh-evolution-contract';
+import { type EvolutionIoLike } from '@lmzhen/dsh-evolution-core';
+export declare class JsonStateStore implements EvolutionStateStore {
+    readonly name = "json-state-store";
+    readonly capabilities: EvolutionStateCapabilities;
+    private readonly io;
+    private readonly root;
+    private readonly serial;
+    constructor(io: EvolutionIoLike, root: string);
+    private path;
+    private load;
+    read<T>(collection: EvolutionCollection, key: string): Promise<T | undefined>;
+    transact<T>(collection: EvolutionCollection, key: string, fn: (current: T | undefined) => Promise<T>): Promise<T>;
+    list<T>(collection: EvolutionCollection): Promise<T[]>;
+}
+//# sourceMappingURL=state-store.d.ts.map

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@lmzhen/dsh-evolution-state-json",
   "description": "JSON-file evolution state provider over the IO seam (community build)",
-  "version": "0.31.0",
+  "version": "0.32.0",
   "publishConfig": {
     "access": "public"
   },
@@ -27,17 +27,18 @@
   "license": "MIT",
   "dependencies": {
     "@deepseek-ai/schemastery": "^3.18.5",
-    "@lmzhen/dsh-evolution-core": "^0.31.0"
+    "@lmzhen/dsh-evolution-contract": "^0.32.0",
+    "@lmzhen/dsh-evolution-core": "^0.32.0"
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.5",
-    "@lmzhen/dsh-evolution-io": "^0.31.0",
-    "@lmzhen/dsh-evolution-state-storage": "^0.31.0"
+    "@lmzhen/dsh-evolution-io": "^0.32.0",
+    "@lmzhen/dsh-evolution-state-storage": "^0.32.0"
   },
   "devDependencies": {
-    "@lmzhen/dsh-evolution-io": "^0.31.0",
-    "@lmzhen/dsh-evolution-state-storage": "^0.31.0",
-    "@lmzhen/dsh-evolution-io-node": "^0.31.0"
+    "@lmzhen/dsh-evolution-io": "^0.32.0",
+    "@lmzhen/dsh-evolution-state-storage": "^0.32.0",
+    "@lmzhen/dsh-evolution-io-node": "^0.32.0"
   },
   "engines": {
     "dsh": ">=0.2.1-rc.2 <0.2.2-0"