@gitgov/core 2.2.0 → 2.3.0

package/dist/src/record_store-BXKWqon5.d.ts

@@ -0,0 +1,64 @@
+/**
+ * IdEncoder for transforming IDs to storage-safe filenames.
+ * Useful for characters not allowed in filesystem (e.g., `:` on Windows)
+ * or URL-unsafe characters in remote backends.
+ */
+interface IdEncoder {
+    /** Transform ID to storage-safe string */
+    encode: (id: string) => string;
+    /** Recover original ID from encoded string */
+    decode: (encoded: string) => string;
+}
+/**
+ * Default encoder: `:` → `_` (for IDs like "human:camilo")
+ * Reversible because IDs cannot contain `_` (see id_generator.ts)
+ */
+declare const DEFAULT_ID_ENCODER: IdEncoder;
+/**
+ * RecordStore<V, R, O> - Generic interface for record persistence
+ *
+ * Abstracts CRUD operations without assuming storage backend.
+ * Each implementation decides how to persist (fs, memory, db, remote).
+ *
+ * @typeParam V - Value type (the record being stored)
+ * @typeParam R - Return type for write operations (default: void for local, GitHubWriteResult for GitHub)
+ * @typeParam O - Options type for write operations (default: void for local, GitHubWriteOpts for GitHub)
+ */
+interface RecordStore<V, R = void, O = void> {
+    /**
+     * Gets a record by ID
+     * @returns The record or null if it doesn't exist
+     */
+    get(id: string): Promise<V | null>;
+    /**
+     * Persists a record
+     * @param id - Unique identifier
+     * @param value - The record to persist
+     */
+    put(id: string, value: V, ...opts: O extends void ? [] : [opts?: O]): Promise<R>;
+    /**
+     * Persists multiple records in a single operation.
+     * Local backends iterate sequentially; GitHub backend uses atomic commits.
+     */
+    putMany(entries: Array<{
+        id: string;
+        value: V;
+    }>, ...opts: O extends void ? [] : [opts?: O]): Promise<R>;
+    /**
+     * Deletes a record
+     * @param id - Identifier of the record to delete
+     */
+    delete(id: string, ...opts: O extends void ? [] : [opts?: O]): Promise<R>;
+    /**
+     * Lists all record IDs
+     * @returns Array of IDs
+     */
+    list(): Promise<string[]>;
+    /**
+     * Checks if a record exists
+     * @param id - Identifier to check
+     */
+    exists(id: string): Promise<boolean>;
+}
+
+export { DEFAULT_ID_ENCODER as D, type IdEncoder as I, type RecordStore as R };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gitgov/core",
-  "version": "2.2.0",
+  "version": "2.3.0",
   "description": "SDK for the GitGovernance ecosystem, providing a type-safe, local-first API to manage identities, agents, and workflows.",
   "type": "module",
   "main": "dist/src/index.js",
@@ -25,6 +25,10 @@
       "types": "./dist/src/github.d.ts",
       "import": "./dist/src/github.js"
     },
+    "./prisma": {
+      "types": "./dist/src/prisma.d.ts",
+      "import": "./dist/src/prisma.js"
+    },
     "./package.json": "./package.json"
   },
   "scripts": {