mnemocyte 0.3.0 → 0.5.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mnemocyte",
-  "version": "0.3.0",
+  "version": "0.5.0",
   "description": "Persistent memory for TypeScript AI apps.",
   "type": "module",
   "sideEffects": false,
@@ -21,6 +21,10 @@
     "./embedders/*": {
       "types": "./dist/embedders/*.d.mts",
       "import": "./dist/embedders/*.mjs"
+    },
+    "./stores/*": {
+      "types": "./dist/stores/*.d.mts",
+      "import": "./dist/stores/*.mjs"
     }
   },
   "types": "./dist/index.d.mts",
@@ -64,8 +68,8 @@
     "vitest": "4.1.6"
   },
   "scripts": {
-    "build": "tsdown src/index.ts \"src/embedders/*.ts\"",
-    "dev": "tsdown src/index.ts \"src/embedders/*.ts\" --watch",
+    "build": "tsdown src/index.ts \"src/embedders/*.ts\" \"src/stores/*.ts\"",
+    "dev": "tsdown src/index.ts \"src/embedders/*.ts\" \"src/stores/*.ts\" --watch",
     "checktypes": "tsc --noEmit && tsc --noEmit --project tsconfig.test.json",
     "test": "pnpm run test:ci",
     "test:ci": "pnpm build && vitest run --typecheck --project unit --project package",

package/dist/errors-B_7ZdjEO.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"errors-B_7ZdjEO.mjs","names":[],"sources":["../src/errors.ts"],"sourcesContent":["/**\n * Stable, machine-readable error code attached to every {@link MnemocyteError}.\n *\n * - `\"CONFIG\"` — invalid client configuration (e.g. missing or malformed embedder).\n * - `\"VALIDATION\"` — invalid argument passed to a client method.\n * - `\"DB\"` — Postgres or driver-level failure.\n * - `\"EMBEDDING\"` — embedder threw or returned an invalid vector.\n * - `\"NOT_FOUND\"` — referenced memory or entity does not exist.\n * - `\"MIGRATION\"` — schema/migration check failed against the target database.\n * - `\"TIMEOUT\"` — a provider call exceeded its configured timeout.\n * - `\"ABORTED\"` — the operation was cancelled via an `AbortSignal`.\n */\nexport type MnemocyteErrorCode =\n\t| \"CONFIG\"\n\t| \"VALIDATION\"\n\t| \"DB\"\n\t| \"EMBEDDING\"\n\t| \"NOT_FOUND\"\n\t| \"MIGRATION\"\n\t| \"TIMEOUT\"\n\t| \"ABORTED\";\n\n/**\n * Error type thrown by every public Mnemocyte API.\n *\n * Use the {@link MnemocyteError.code} property — not the message — to branch\n * on failure modes, or call {@link isMnemocyteError} as a type guard when\n * working with `unknown` errors.\n *\n * @example\n * ```ts\n * try {\n *   await client.recall({ entityId: \"u1\", query: \"hi\" });\n * } catch (err) {\n *   if (isMnemocyteError(err) && err.code === \"DB\") {\n *     // handle database failure\n *   }\n *   throw err;\n * }\n * ```\n */\nexport class MnemocyteError extends Error {\n\t/** Stable, machine-readable failure code. See {@link MnemocyteErrorCode}. */\n\treadonly code: MnemocyteErrorCode;\n\t/** Underlying cause, if any (e.g. an original driver or embedder error). */\n\toverride readonly cause?: unknown;\n\n\t/**\n\t * @param message - Human-readable error message.\n\t * @param code - Stable failure code; see {@link MnemocyteErrorCode}.\n\t * @param cause - Optional underlying cause (driver error, network error, etc.).\n\t */\n\tconstructor(message: string, code: MnemocyteErrorCode, cause?: unknown) {\n\t\tsuper(message);\n\t\tthis.name = \"MnemocyteError\";\n\t\tthis.code = code;\n\t\tthis.cause = cause;\n\t}\n}\n\n/**\n * Type guard for {@link MnemocyteError}.\n *\n * This guard uses `instanceof` and recognizes errors created by the same loaded\n * Mnemocyte class. It does not recognize structurally similar errors or errors\n * created by another installed copy of the package.\n *\n * @param error - Value to test (typically a caught `unknown`).\n * @returns `true` if `error` is a {@link MnemocyteError}.\n */\nexport function isMnemocyteError(error: unknown): error is MnemocyteError {\n\treturn error instanceof MnemocyteError;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAyCA,IAAa,iBAAb,cAAoC,MAAM;;CAEzC;;CAEA;;;;;;CAOA,YAAY,SAAiB,MAA0B,OAAiB;EACvE,MAAM,OAAO;EACb,KAAK,OAAO;EACZ,KAAK,OAAO;EACZ,KAAK,QAAQ;CACd;AACD;;;;;;;;;;;AAYA,SAAgB,iBAAiB,OAAyC;CACzE,OAAO,iBAAiB;AACzB"}

package/dist/types-gOPLre4V.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"types-gOPLre4V.d.mts","names":[],"sources":["../src/types.ts"],"mappings":"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"}