@lmzhen/dsh-evolution-state-domain 0.3.51 → 0.3.52

package/lib/index.js

@@ -1,6 +1,6 @@
 import { z } from "zod";
 import { DomainError, defineDomain, domainTable } from "@deepseek-ai/dsh-storage-domain";
-import { canClaimPending, canResolvePending, releasedStatus } from "@lmzhen/dsh-evolution-state-storage";
+import { CURATOR_STATE_KEY, CURATOR_STATE_TABLE, PENDING_TABLE, PROVIDER_DOMAIN, REVIEW_STATE_TABLE, canClaimPending, canResolvePending, releasedStatus } from "@lmzhen/dsh-evolution-state-storage";
 //#region lib/types/index.js
 /**
 * storage-domain provider for evolution state.
@@ -13,11 +13,22 @@ import { canClaimPending, canResolvePending, releasedStatus } from "@lmzhen/dsh-
 */
 const name = "evolution-state-domain";
 const inject = ["evolutionStateStorage", "storageDomain"];
+/**
+* Review-state record schema of the storage-domain table.
+* @internal Referenced only by this package's own tests and EVOLUTION_DOMAIN
+* below — not public API surface (audit v10 S-03); the record contract lives
+* in `@lmzhen/dsh-evolution-state-storage` types.
+*/
 const reviewStateSchema = z.object({
 	turnsSinceMemory: z.number().int().nonnegative(),
 	turnsSinceSkill: z.number().int().nonnegative(),
 	lastTurn: z.number().int().nonnegative()
 });
+/**
+* Curator-state record schema of the storage-domain table.
+* @internal Referenced only by this package's own tests and EVOLUTION_DOMAIN
+* below — not public API surface (audit v10 S-03).
+*/
 const curatorStateSchema = z.object({
 	/** Optional record-shape version; legacy records without it stay compatible. */
 	schemaVersion: z.number().int().nonnegative().optional(),
@@ -26,6 +37,11 @@ const curatorStateSchema = z.object({
 	lastSummary: z.string(),
 	paused: z.boolean()
 });
+/**
+* Pending record schema of the storage-domain table.
+* @internal Referenced only by this package's own tests and EVOLUTION_DOMAIN
+* below — not public API surface (audit v10 S-03).
+*/
 const pendingSchema = z.object({
 	id: z.string(),
 	kind: z.union([
@@ -48,13 +64,18 @@ const pendingSchema = z.object({
 	origin: z.string().optional(),
 	sessionId: z.string().optional()
 });
+/**
+* The evolution storage-domain spec: three schema-validated KV tables.
+* @internal Referenced only by this package's own tests and `open()` — not
+* public API surface (audit v10 S-03).
+*/
 const EVOLUTION_DOMAIN = defineDomain({
 	name: "evolution",
 	version: 1,
 	tables: {
-		review_state: domainTable(reviewStateSchema),
-		curator_state: domainTable(curatorStateSchema),
-		pending: domainTable(pendingSchema)
+		[REVIEW_STATE_TABLE]: domainTable(reviewStateSchema),
+		[CURATOR_STATE_TABLE]: domainTable(curatorStateSchema),
+		[PENDING_TABLE]: domainTable(pendingSchema)
 	}
 });
 /**
@@ -93,41 +114,45 @@ function apply(ctx) {
 		return domain;
 	}
 	const provider = {
-		name: "domain",
+		name: PROVIDER_DOMAIN,
 		async loadReviewState(sessionId) {
-			return (await ensure()).table("review_state").get(sessionId) ?? null;
+			return (await ensure()).table(REVIEW_STATE_TABLE).get(sessionId) ?? null;
 		},
 		async saveReviewState(sessionId, record) {
-			await (await ensure()).table("review_state").put(sessionId, record);
+			await (await ensure()).table(REVIEW_STATE_TABLE).put(sessionId, record);
 		},
 		async loadCuratorState() {
-			return (await ensure()).table("curator_state").get("primary") ?? null;
+			return (await ensure()).table(CURATOR_STATE_TABLE).get(CURATOR_STATE_KEY) ?? null;
 		},
 		async saveCuratorState(record) {
-			await (await ensure()).table("curator_state").put("primary", record);
+			await (await ensure()).table(CURATOR_STATE_TABLE).put(CURATOR_STATE_KEY, record);
 		},
 		async transactCuratorState(task) {
-			const table = (await ensure()).table("curator_state");
+			const table = (await ensure()).table(CURATOR_STATE_TABLE);
 			try {
-				await table.update("primary", (current) => task(current) ?? current);
+				await table.update(CURATOR_STATE_KEY, (current) => task(current) ?? current);
+				return;
 			} catch (error) {
-				if (error instanceof DomainError && error.code === "missing-key") {
-					const next = task(null);
-					if (next !== null) await table.put("primary", next);
-					else await table.delete("primary");
-					return;
-				}
-				throw error;
+				if (!(error instanceof DomainError && error.code === "missing-key")) throw error;
+			}
+			try {
+				await table.update(CURATOR_STATE_KEY, (current) => task(current) ?? current);
+				return;
+			} catch (error) {
+				if (!(error instanceof DomainError && error.code === "missing-key")) throw error;
 			}
+			const next = task(null);
+			if (next !== null) await table.put(CURATOR_STATE_KEY, next);
+			else await table.delete(CURATOR_STATE_KEY);
 		},
 		async listPending(status = "pending") {
-			return [...(await ensure()).table("pending").entries()].map(([, value]) => value).filter((record) => record.status === status);
+			return [...(await ensure()).table(PENDING_TABLE).entries()].map(([, value]) => value).filter((record) => record.status === status);
 		},
 		async savePending(record) {
-			await (await ensure()).table("pending").put(record.id, record);
+			await (await ensure()).table(PENDING_TABLE).put(record.id, record);
 		},
 		async claimPending(id, claimId) {
-			const table = (await ensure()).table("pending");
+			const table = (await ensure()).table(PENDING_TABLE);
 			try {
 				const slot = { record: null };
 				const now = Date.now();
@@ -148,7 +173,7 @@ function apply(ctx) {
 			}
 		},
 		async releasePendingClaim(id, claimId) {
-			const table = (await ensure()).table("pending");
+			const table = (await ensure()).table(PENDING_TABLE);
 			try {
 				await table.update(id, (current) => {
 					if (current.status !== "pending" && current.status !== "executing") return current;
@@ -167,7 +192,7 @@ function apply(ctx) {
 			}
 		},
 		async tryResolvePending(id, status) {
-			const table = (await ensure()).table("pending");
+			const table = (await ensure()).table(PENDING_TABLE);
 			try {
 				const resolved = { record: null };
 				const rawRecord = await table.update(id, (current) => {

package/lib/types/index.d.ts

@@ -12,11 +12,22 @@ import { z } from 'zod';
 import { type CuratorStateRecord, type PendingRecord, type ReviewStateRecord } from '@lmzhen/dsh-evolution-state-storage';
 export declare const name = "evolution-state-domain";
 export declare const inject: string[];
+/**
+ * Review-state record schema of the storage-domain table.
+ * @internal Referenced only by this package's own tests and EVOLUTION_DOMAIN
+ * below — not public API surface (audit v10 S-03); the record contract lives
+ * in `@lmzhen/dsh-evolution-state-storage` types.
+ */
 export declare const reviewStateSchema: z.ZodObject<{
     turnsSinceMemory: z.ZodNumber;
     turnsSinceSkill: z.ZodNumber;
     lastTurn: z.ZodNumber;
 }, z.core.$strip>;
+/**
+ * Curator-state record schema of the storage-domain table.
+ * @internal Referenced only by this package's own tests and EVOLUTION_DOMAIN
+ * below — not public API surface (audit v10 S-03).
+ */
 export declare const curatorStateSchema: z.ZodObject<{
     schemaVersion: z.ZodOptional<z.ZodNumber>;
     lastRunAt: z.ZodNumber;
@@ -24,6 +35,11 @@ export declare const curatorStateSchema: z.ZodObject<{
     lastSummary: z.ZodString;
     paused: z.ZodBoolean;
 }, z.core.$strip>;
+/**
+ * Pending record schema of the storage-domain table.
+ * @internal Referenced only by this package's own tests and EVOLUTION_DOMAIN
+ * below — not public API surface (audit v10 S-03).
+ */
 export declare const pendingSchema: z.ZodObject<{
     id: z.ZodString;
     kind: z.ZodUnion<readonly [z.ZodLiteral<"memory">, z.ZodLiteral<"skill">, z.ZodLiteral<"capability">]>;
@@ -37,6 +53,11 @@ export declare const pendingSchema: z.ZodObject<{
     origin: z.ZodOptional<z.ZodString>;
     sessionId: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
+/**
+ * The evolution storage-domain spec: three schema-validated KV tables.
+ * @internal Referenced only by this package's own tests and `open()` — not
+ * public API surface (audit v10 S-03).
+ */
 export declare const EVOLUTION_DOMAIN: {
     name: string;
     version: number;

package/package.json

@@ -1,14 +1,14 @@
 {
   "name": "@lmzhen/dsh-evolution-state-domain",
   "description": "storage-domain provider for evolution state (community build)",
-  "version": "0.3.51",
+  "version": "0.3.52",
   "publishConfig": {
     "access": "public"
   },
   "repository": {
     "type": "git",
     "url": "git+https://github.com/lmzhen/dsh-evolution.git",
-    "directory": "packages/dsh-evolution-state-domain"
+    "directory": "packages/evolution-state-domain"
   },
   "type": "module",
   "main": "lib/index.js",
@@ -36,13 +36,13 @@
     "@deepseek-ai/dsh-invariants": "^0.1.1-rc.2",
     "@deepseek-ai/cordis": "^4.0.1",
     "@deepseek-ai/dsh-storage-domain": "^0.1.1-rc.2",
-    "@lmzhen/dsh-evolution-state-storage": "^0.3.51"
+    "@lmzhen/dsh-evolution-state-storage": "^0.3.52"
   },
   "devDependencies": {
     "@deepseek-ai/dsh-invariants": "^0.1.1-rc.2",
     "@deepseek-ai/dsh-storage-domain": "^0.1.1-rc.2",
     "@deepseek-ai/dsh-storage": "^0.1.1-rc.2",
     "@deepseek-ai/dsh-storage-json": "^0.1.1-rc.2",
-    "@lmzhen/dsh-evolution-state-storage": "^0.3.51"
+    "@lmzhen/dsh-evolution-state-storage": "^0.3.52"
   }
 }