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

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.4",
+  "version": "0.1.2-alpha.5",
   "publishConfig": {
     "access": "public"
   },