@deepseek-ai/dsh-storage 0.1.2-alpha.3 → 0.1.2-alpha.5

package/README.i18n.yaml

@@ -2,5 +2,5 @@
 # side as of the last confirmed-consistent state. Both languages carry equal authority;
 # after editing either side, bring the other along and re-record with:
 #   pnpm run verify-translation-pairing --write packages/storage/storage/README.md
-README.md: d81dbe8f99ae7594b8f33a389deec77259bbd610
-README.zh.md: 9d1078782e3e09d3f9b8925e87c9b2f40085daca
+README.md: 27034b7d3fa67216e777d31c54ceb96dc6c16338
+README.zh.md: 595070f2f2e5f7628063cfa442ea924becf3b4e8

package/README.md

@@ -86,7 +86,7 @@ The hub is a pure registration table with two faces, designed so backends and da
 | [`src/registry.ts`](src/registry.ts) | `BackendRegistry`: name → backend table, registration disposers |
 | [`src/backend.ts`](src/backend.ts) | The backend contract: facets, units, `UNIT_NAME_RE` |
 | [`src/error.ts`](src/error.ts) | `StorageError` codes shared by the hub and every backend |
-| [`src/invariant.ts`](src/invariant.ts) | Invariant companion (no runtime invariant: a pure registration table) |
+| — | No runtime invariant companion is published; the hub is a pure registration table (names → backends, forms → facilities) whose consistency is fully enforced at the call sites (duplicate/missing entries fail loud synchronously); it owns no event stream or mutable medium to cross-check. |
 | [`tests/contract.ts`](tests/contract.ts) | The shared conformance suite run against each backend |
 
 </details>

package/README.zh.md

@@ -86,7 +86,7 @@ kind: "package-reference"
 | [`src/registry.ts`](src/registry.ts) | `BackendRegistry`：名称 → 后端表、注册资源释放函数 |
 | [`src/backend.ts`](src/backend.ts) | 后端约定：分面、单元、`UNIT_NAME_RE` |
 | [`src/error.ts`](src/error.ts) | 枢纽与每个后端共享的 `StorageError` 代码 |
-| [`src/invariant.ts`](src/invariant.ts) | 不变式伴生插件（无运行时不变式：纯注册表） |
+| — | 不发布运行时不变式伴生入口；纯注册表。 |
 | [`tests/contract.ts`](tests/contract.ts) | 针对每个后端运行的共享一致性套件 |
 
 </details>

package/lib/types/backend.d.ts

@@ -56,6 +56,16 @@ export interface KvUnitDescriptor {
      * foreign documents.
      */
     readonly layout?: 'single' | 'per-record';
+    /**
+     * Older unit versions whose stored records are also readable under the
+     * declaring owner's current record schemas (the owner vouches for that —
+     * typically by declaring the fields old records lack as optional). Reads of
+     * a `per-record` unit accept documents stamped with any listed version, and
+     * the legacy whole-unit bootstrap accepts a legacy file stamped with one;
+     * writes always stamp {@link version}. `single`-layout reads stay
+     * exact-version.
+     */
+    readonly compatibleVersions?: readonly number[];
 }
 /**
  * One opened unit. Values are opaque JSON to this layer: no schema, no
@@ -93,6 +103,18 @@ export interface KvUnit {
      * @returns resolution after durability.
      */
     deleteRecord(table: string, key: string): Promise<void>;
+    /**
+     * Move one record's stored document out of the unit's readable set,
+     * preserving its bytes for inspection instead of deleting them. Backends
+     * whose medium has no per-record document to move (the `single` layout, a
+     * row store) omit this member, and the caller falls back to its
+     * reject-loud path. Absent after the move: a later {@link loadAll} reads
+     * the key as missing and a later {@link putRecord} recreates it fresh.
+     * @param table - Declared table name.
+     * @param key - Record key.
+     * @returns the medium location the document was moved to (diagnostics).
+     */
+    backupRecord?(table: string, key: string): Promise<string>;
     /**
      * Write the global singleton durably. Only valid when the descriptor
      * declared `hasGlobal`.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@deepseek-ai/dsh-storage",
   "description": "Storage hub (ctx.storage): named backend registry plus mounted data-form facilities for the DeepSeek Harness",
-  "version": "0.1.2-alpha.3",
+  "version": "0.1.2-alpha.5",
   "publishConfig": {
     "access": "public"
   },
@@ -18,25 +18,18 @@
       "types": "./lib/types/index.d.ts",
       "default": "./lib/index.js"
     },
-    "./invariant": {
-      "types": "./lib/types/invariant.d.ts",
-      "default": "./lib/invariant.js"
-    },
     "./src/*": "./src/*",
     "./package.json": "./package.json"
   },
   "files": [
     "lib/index.js",
-    "lib/invariant.js",
     "lib/types/**/*.d.ts"
   ],
   "license": "MIT",
   "peerDependencies": {
-    "@deepseek-ai/cordis": "^4.0.2",
-    "@deepseek-ai/dsh-invariants": "^0.1.2-alpha.3"
+    "@deepseek-ai/cordis": "^4.0.2"
   },
   "devDependencies": {
-    "@deepseek-ai/dsh-invariants": "^0.1.2-alpha.3",
     "@deepseek-ai/cordis": "^4.0.2"
   }
 }

package/lib/invariant.js

@@ -1,25 +0,0 @@
-//#region lib/types/invariant.js
-/**
-* Package-owned invariant companion for `@deepseek-ai/dsh-storage`.
-* @module @deepseek-ai/dsh-storage/invariant
-*/
-const PACKAGE_NAME = "@deepseek-ai/dsh-storage";
-/** Cordis companion plugin name. */
-const name = "storage-invariant";
-/** Service required before the companion can reserve package ownership. */
-const inject = ["invariants"];
-/**
-* No runtime invariant: the hub is a pure registration table (names →
-* backends, forms → facilities) whose consistency is fully enforced at the
-* call sites (duplicate/missing entries fail loud synchronously); it owns no
-* event stream or mutable medium to cross-check.
-*/
-const install = () => {};
-/**
-* Register this package's invariant companion.
-* @param ctx - Cordis context carrying the invariant service.
-* @returns the installed registration's disposer after setup succeeds.
-*/
-const apply = (ctx) => Promise.resolve(ctx.invariants.register(PACKAGE_NAME, install));
-//#endregion
-export { apply, inject, name };

package/lib/types/invariant.d.ts

@@ -1,16 +0,0 @@
-/**
- * Package-owned invariant companion for `@deepseek-ai/dsh-storage`.
- * @module @deepseek-ai/dsh-storage/invariant
- */
-import type { Context } from '@deepseek-ai/cordis';
-/** Cordis companion plugin name. */
-export declare const name = "storage-invariant";
-/** Service required before the companion can reserve package ownership. */
-export declare const inject: string[];
-/**
- * Register this package's invariant companion.
- * @param ctx - Cordis context carrying the invariant service.
- * @returns the installed registration's disposer after setup succeeds.
- */
-export declare const apply: (ctx: Context) => Promise<() => void>;
-//# sourceMappingURL=invariant.d.ts.map