mcard-js 2.1.32 → 2.1.34

package/README.md

@@ -2,14 +2,14 @@
 
 Full-featured TypeScript implementation of MCard content-addressable storage, supporting both browser and Node.js environments.
 
-[![Tests](https://img.shields.io/badge/tests-155%20passed-brightgreen)](./tests)
+[![Tests](https://img.shields.io/badge/tests-814%20passed%20(52%20files)-brightgreen)](./tests)
 [![TypeScript](https://img.shields.io/badge/TypeScript-5.x-blue)](https://www.typescriptlang.org/)
 [![Node.js](https://img.shields.io/badge/Node.js-18%2B-green)](https://nodejs.org/)
 
 ## Features
 
 - **Content Addressing**: SHA-256 via Web Crypto API (browser) or Node.js crypto
-- **Dual Storage**: IndexedDB (browser) + SQLite via better-sqlite3 (Node.js)
+- **3 Interchangeable Storage Engines**: `IndexedDBEngine` (browser), `SqliteNodeEngine` (Node.js/better-sqlite3), `SqliteWasmEngine` (browser/sql.js) — verified by 162 cross-engine interchangeability tests
 - **UTF-8 Handles**: International support (文檔, مستند, ドキュメント, документ)
 - **Monadic API**: Maybe, Either, IO monads for functional composition
 - **PTR Runtime**: Polynomial Type Runtime with polyglot execution (JS, Python, Rust, C, WASM, Lean)
@@ -617,6 +617,31 @@ To run integration tests against a live Ollama instance:
     npx vitest tests/rag/Integration.test.ts
     ```
 
+## Version 0.1.50 / 2.1.32 Release Notes (March 12, 2026)
+> StorageEngine Interchangeability, FK Fix, Security, Code Quality
+
+### 🔄 StorageEngine Interchangeability
+*   **162-Test Cross-Engine Suite**: New `StorageEngine.Interchangeability.test.ts` runs identical tests against all 3 engines (`IndexedDBEngine`, `SqliteNodeEngine`, `SqliteWasmEngine`), covering Card CRUD, queries, pagination, handle lifecycle, rename, prune, history deletion, and cross-cutting scenarios (Unicode handles, 50-card batch pagination, multi-alias).
+*   **`fake-indexeddb`**: Added as a dev dependency to enable `IndexedDBEngine` testing in Node.js.
+
+### 🐛 Bug Fix — Foreign Key Constraint in `renameHandle`
+*   **Root Cause**: `SqliteNodeEngine.renameHandleSync` updated `handle_registry` before `handle_history`, violating the FK constraint `handle_history.handle → handle_registry.handle` since both tables reference each other.
+*   **Fix**: Added `PRAGMA defer_foreign_keys = ON` inside the transaction so FK checks are deferred until commit, when both tables are consistent.
+
+### 🔒 Security — SQL Injection Prevention
+*   Replaced 6 string-interpolated SQL queries in `SqliteWasmEngine` with parameterized `prepare`/`bind`/`step`.
+
+### 📦 Code Quality
+*   **`rowToCard()` helper** (`SqliteNodeEngine`): 9 inline hydration patterns → 1.
+*   **`createPage()` factory** (`StorageAdapter`): Eliminated ~10 duplicated `Page` constructions across all 3 engines.
+*   Implemented `pruneHandleHistory` in `SqliteWasmEngine` and `IndexedDBEngine`.
+
+### 🧪 Test Results
+*   814 passed, 23 skipped, 0 failures (52 test files)
+*   `tsc --noEmit` clean
+
+---
+
 ## Version 0.1.47 / 2.1.28 Release Notes (January 17, 2026)
 > Directory Structure Alignment, Strict Schema, and Store Refactoring
 

package/dist/CardCollection-GUEYGN2Y.js

@@ -0,0 +1,9 @@
+import {
+  CardCollection
+} from "./chunk-3JBSRALP.js";
+import "./chunk-QPZ2HNSU.js";
+import "./chunk-7NKII2JA.js";
+import "./chunk-MLKGABMK.js";
+export {
+  CardCollection
+};

package/dist/LLMRuntime-GIGDMDEZ.js

@@ -0,0 +1,16 @@
+import {
+  LLMRuntime,
+  chatMonad,
+  get_provider,
+  promptMonad
+} from "./chunk-XPG6B5IW.js";
+import "./chunk-DOC55MPG.js";
+import "./chunk-MPMRBT5R.js";
+import "./chunk-2KADE3SE.js";
+import "./chunk-MLKGABMK.js";
+export {
+  LLMRuntime,
+  chatMonad,
+  get_provider,
+  promptMonad
+};

package/dist/LambdaRuntime-LDA3G7IR.js

@@ -0,0 +1,16 @@
+import {
+  LambdaRuntime,
+  parseLambdaExpression
+} from "./chunk-QA2XQMMJ.js";
+import "./chunk-MPMRBT5R.js";
+import "./chunk-2KADE3SE.js";
+import "./chunk-YSVHXKSZ.js";
+import "./chunk-WTNVQ5WS.js";
+import "./chunk-3JBSRALP.js";
+import "./chunk-QPZ2HNSU.js";
+import "./chunk-7NKII2JA.js";
+import "./chunk-MLKGABMK.js";
+export {
+  LambdaRuntime,
+  parseLambdaExpression
+};

package/dist/LambdaRuntime-O7JBVHO2.js

@@ -0,0 +1,16 @@
+import {
+  LambdaRuntime,
+  parseLambdaExpression
+} from "./chunk-J4HOFUKM.js";
+import "./chunk-MPMRBT5R.js";
+import "./chunk-2KADE3SE.js";
+import "./chunk-YSVHXKSZ.js";
+import "./chunk-WTNVQ5WS.js";
+import "./chunk-3JBSRALP.js";
+import "./chunk-QPZ2HNSU.js";
+import "./chunk-7NKII2JA.js";
+import "./chunk-MLKGABMK.js";
+export {
+  LambdaRuntime,
+  parseLambdaExpression
+};

package/dist/LambdaRuntime-Q6ISCHAD.js

@@ -0,0 +1,16 @@
+import {
+  LambdaRuntime,
+  parseLambdaExpression
+} from "./chunk-DP7HBRDL.js";
+import "./chunk-MPMRBT5R.js";
+import "./chunk-2KADE3SE.js";
+import "./chunk-37EEYISR.js";
+import "./chunk-WTNVQ5WS.js";
+import "./chunk-3JBSRALP.js";
+import "./chunk-QPZ2HNSU.js";
+import "./chunk-7NKII2JA.js";
+import "./chunk-MLKGABMK.js";
+export {
+  LambdaRuntime,
+  parseLambdaExpression
+};

package/dist/Loader-HQ3QKMYM.js

@@ -0,0 +1,11 @@
+import {
+  loadFileToCollection,
+  processAndStoreFile
+} from "./chunk-HGENNKOJ.js";
+import "./chunk-QPZ2HNSU.js";
+import "./chunk-7NKII2JA.js";
+import "./chunk-MLKGABMK.js";
+export {
+  loadFileToCollection,
+  processAndStoreFile
+};