mcard-js 2.1.34 → 2.1.36

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-814%20passed%20(52%20files)-brightgreen)](./tests)
+[![Tests](https://img.shields.io/badge/tests-864%20passed%20(54%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
-- **3 Interchangeable Storage Engines**: `IndexedDBEngine` (browser), `SqliteNodeEngine` (Node.js/better-sqlite3), `SqliteWasmEngine` (browser/sql.js) — verified by 162 cross-engine interchangeability tests
+- **5 Interchangeable Storage Engines**: `IndexedDBEngine` (browser), `SqliteNodeEngine` (Node.js/better-sqlite3), `SqliteWasmEngine` (browser/sql.js), `DuckDBNodeEngine` (Node.js/@duckdb/node-api), `DuckDBWasmEngine` (browser/@duckdb/duckdb-wasm)
 - **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)
@@ -99,6 +99,39 @@ const count = db.countSync();
 db.close();
 ```
 
+### DuckDB (Node.js — Alternative OLAP Engine)
+```typescript
+import { DuckDBNodeEngine } from './storage/DuckDBNodeEngine';
+
+// Async factory — in-memory or file-backed
+const db = await DuckDBNodeEngine.create(':memory:');
+// or: await DuckDBNodeEngine.create('./mcard.duckdb');
+
+// Same StorageEngine interface as SQLite
+const card = await MCard.create('Hello from DuckDB!');
+await db.add(card);
+
+const retrieved = await db.get(card.hash);
+console.log(retrieved?.getContentAsText());
+
+await db.close();
+```
+
+### DuckDB WASM (Browser — In-Browser OLAP)
+```typescript
+import { DuckDBWasmEngine } from './storage/DuckDBWasmEngine';
+
+// Runs DuckDB entirely in WebAssembly via Web Worker
+const db = new DuckDBWasmEngine();
+await db.init(); // Downloads WASM bundle from CDN
+
+// Same StorageEngine interface
+const card = await MCard.create('Hello from DuckDB WASM!');
+await db.add(card);
+
+await db.close();
+```
+
 ## Database Schema
 
 The SQLite backend uses schemas matching the Python implementation for full interoperability.

package/dist/CardCollection-WGCKKUOD.js

@@ -0,0 +1,9 @@
+import {
+  CardCollection
+} from "./chunk-5HXLTWYN.js";
+import "./chunk-5BIDGXA6.js";
+import "./chunk-7NKII2JA.js";
+import "./chunk-MLKGABMK.js";
+export {
+  CardCollection
+};

package/dist/LambdaRuntime-WNYDBTS6.js

@@ -0,0 +1,16 @@
+import {
+  LambdaRuntime,
+  parseLambdaExpression
+} from "./chunk-Z4BRNTO5.js";
+import "./chunk-MPMRBT5R.js";
+import "./chunk-2KADE3SE.js";
+import "./chunk-X42F7DE3.js";
+import "./chunk-WTNVQ5WS.js";
+import "./chunk-5HXLTWYN.js";
+import "./chunk-5BIDGXA6.js";
+import "./chunk-7NKII2JA.js";
+import "./chunk-MLKGABMK.js";
+export {
+  LambdaRuntime,
+  parseLambdaExpression
+};

package/dist/Loader-RT4NI6AT.js

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

package/dist/MCard-JOW6RBSO.js

@@ -0,0 +1,8 @@
+import {
+  MCard
+} from "./chunk-5BIDGXA6.js";
+import "./chunk-7NKII2JA.js";
+import "./chunk-MLKGABMK.js";
+export {
+  MCard
+};