mcard-js 2.1.35 → 2.1.37

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-KDO4CQ4B.js

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

package/dist/CardCollection-PB7ZY73E.js

@@ -0,0 +1,9 @@
+import {
+  CardCollection
+} from "./chunk-WMJGGREP.js";
+import "./chunk-SOJ2UMO2.js";
+import "./chunk-7NKII2JA.js";
+import "./chunk-SIAA4J6H.js";
+export {
+  CardCollection
+};

package/dist/CardCollection-RK4DVH63.js

@@ -0,0 +1,9 @@
+import {
+  CardCollection
+} from "./chunk-QVGVU6OS.js";
+import "./chunk-4UIWXZHY.js";
+import "./chunk-7NKII2JA.js";
+import "./chunk-SIAA4J6H.js";
+export {
+  CardCollection
+};

package/dist/CardCollection-T376E3TS.js

@@ -0,0 +1,9 @@
+import {
+  CardCollection
+} from "./chunk-2VOQRXWH.js";
+import "./chunk-4UIWXZHY.js";
+import "./chunk-7NKII2JA.js";
+import "./chunk-MLKGABMK.js";
+export {
+  CardCollection
+};

package/dist/CardCollection-XON2IWDU.js

@@ -0,0 +1,9 @@
+import {
+  CardCollection
+} from "./chunk-4I5IZILN.js";
+import "./chunk-WVFWNVT2.js";
+import "./chunk-7NKII2JA.js";
+import "./chunk-MLKGABMK.js";
+export {
+  CardCollection
+};

package/dist/EventProducer-V7RY2KKR.js

@@ -0,0 +1,47 @@
+import {
+  ALGORITHM_HIERARCHY,
+  EVENT_CONSTANTS
+} from "./chunk-KEC7YFG3.js";
+import {
+  GTime,
+  HashValidator
+} from "./chunk-7NKII2JA.js";
+import "./chunk-SIAA4J6H.js";
+
+// src/model/EventProducer.ts
+async function generateCollisionEvent(card) {
+  const currentHashFunction = GTime.getHashAlgorithm(card.g_time);
+  const nextAlgo = nextHashFunction(currentHashFunction);
+  const upgradedHash = await HashValidator.computeHash(card.content, nextAlgo);
+  const event = {
+    [EVENT_CONSTANTS.TYPE]: EVENT_CONSTANTS.COLLISION_EVENT_TYPE,
+    [EVENT_CONSTANTS.HASH]: card.hash,
+    [EVENT_CONSTANTS.FIRST_G_TIME]: card.g_time,
+    [EVENT_CONSTANTS.COLLISION_TIME]: card.g_time,
+    // Using original card's time as per Python logic reference
+    [EVENT_CONSTANTS.CONTENT_SIZE]: card.content.length,
+    [EVENT_CONSTANTS.UPGRADED_FUNCTION]: nextAlgo,
+    [EVENT_CONSTANTS.UPGRADED_HASH]: upgradedHash
+  };
+  return JSON.stringify(event);
+}
+function generateDuplicationEvent(card) {
+  const event = {
+    [EVENT_CONSTANTS.TYPE]: EVENT_CONSTANTS.DUPLICATE_EVENT_TYPE,
+    [EVENT_CONSTANTS.HASH]: card.hash,
+    [EVENT_CONSTANTS.DUPLICATE_TIME]: card.g_time
+  };
+  return JSON.stringify(event);
+}
+function nextHashFunction(current) {
+  const currentLower = current.toLowerCase();
+  const entry = ALGORITHM_HIERARCHY[currentLower];
+  if (entry && entry.next) {
+    return entry.next;
+  }
+  return "sha256";
+}
+export {
+  generateCollisionEvent,
+  generateDuplicationEvent
+};

package/dist/IndexedDBEngine-7JI2CL32.js

@@ -0,0 +1,10 @@
+import {
+  IndexedDBEngine
+} from "./chunk-7V37AAPK.js";
+import "./chunk-NZ6OQ7UT.js";
+import "./chunk-WVFWNVT2.js";
+import "./chunk-7NKII2JA.js";
+import "./chunk-MLKGABMK.js";
+export {
+  IndexedDBEngine
+};

package/dist/IndexedDBEngine-7OHQIRTI.js

@@ -0,0 +1,10 @@
+import {
+  IndexedDBEngine
+} from "./chunk-RXL2CW64.js";
+import "./chunk-NZ6OQ7UT.js";
+import "./chunk-4UIWXZHY.js";
+import "./chunk-7NKII2JA.js";
+import "./chunk-MLKGABMK.js";
+export {
+  IndexedDBEngine
+};

package/dist/IndexedDBEngine-E5YJQG4U.js

@@ -0,0 +1,10 @@
+import {
+  IndexedDBEngine
+} from "./chunk-UFW2VW2D.js";
+import "./chunk-NZ6OQ7UT.js";
+import "./chunk-5BIDGXA6.js";
+import "./chunk-7NKII2JA.js";
+import "./chunk-SIAA4J6H.js";
+export {
+  IndexedDBEngine
+};

package/dist/IndexedDBEngine-NV625E7L.js

@@ -0,0 +1,10 @@
+import {
+  IndexedDBEngine
+} from "./chunk-4WBJPHZP.js";
+import "./chunk-NZ6OQ7UT.js";
+import "./chunk-WVFWNVT2.js";
+import "./chunk-7NKII2JA.js";
+import "./chunk-MLKGABMK.js";
+export {
+  IndexedDBEngine
+};

package/dist/IndexedDBEngine-RPQS7ILF.js

@@ -0,0 +1,10 @@
+import {
+  IndexedDBEngine
+} from "./chunk-UFW2VW2D.js";
+import "./chunk-NZ6OQ7UT.js";
+import "./chunk-5BIDGXA6.js";
+import "./chunk-7NKII2JA.js";
+import "./chunk-MLKGABMK.js";
+export {
+  IndexedDBEngine
+};

package/dist/IndexedDBEngine-S3ZWCSI7.js

@@ -0,0 +1,10 @@
+import {
+  IndexedDBEngine
+} from "./chunk-RXL2CW64.js";
+import "./chunk-NZ6OQ7UT.js";
+import "./chunk-4UIWXZHY.js";
+import "./chunk-7NKII2JA.js";
+import "./chunk-SIAA4J6H.js";
+export {
+  IndexedDBEngine
+};

package/dist/IndexedDBEngine-T7OC5GRR.js

@@ -0,0 +1,10 @@
+import {
+  IndexedDBEngine
+} from "./chunk-FXJYXHG6.js";
+import "./chunk-NZ6OQ7UT.js";
+import "./chunk-SOJ2UMO2.js";
+import "./chunk-7NKII2JA.js";
+import "./chunk-SIAA4J6H.js";
+export {
+  IndexedDBEngine
+};

package/dist/LLMRuntime-BQUUFLAB.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-SIAA4J6H.js";
+export {
+  LLMRuntime,
+  chatMonad,
+  get_provider,
+  promptMonad
+};

package/dist/LambdaRuntime-AL5SBDCA.js

@@ -0,0 +1,17 @@
+import {
+  LambdaRuntime,
+  parseLambdaExpression
+} from "./chunk-DEYMHG5A.js";
+import "./chunk-MPMRBT5R.js";
+import "./chunk-2KADE3SE.js";
+import "./chunk-V7VX5OJ6.js";
+import "./chunk-DWXNZ5AJ.js";
+import "./chunk-2VOQRXWH.js";
+import "./chunk-NZ6OQ7UT.js";
+import "./chunk-4UIWXZHY.js";
+import "./chunk-7NKII2JA.js";
+import "./chunk-MLKGABMK.js";
+export {
+  LambdaRuntime,
+  parseLambdaExpression
+};

package/dist/LambdaRuntime-BYBUI7H5.js

@@ -0,0 +1,17 @@
+import {
+  LambdaRuntime,
+  parseLambdaExpression
+} from "./chunk-TZFI54AU.js";
+import "./chunk-MPMRBT5R.js";
+import "./chunk-2KADE3SE.js";
+import "./chunk-IZWB5GCG.js";
+import "./chunk-DWXNZ5AJ.js";
+import "./chunk-T3AG6DXY.js";
+import "./chunk-NZ6OQ7UT.js";
+import "./chunk-5BIDGXA6.js";
+import "./chunk-7NKII2JA.js";
+import "./chunk-SIAA4J6H.js";
+export {
+  LambdaRuntime,
+  parseLambdaExpression
+};

package/dist/LambdaRuntime-JDZP3HIQ.js

@@ -0,0 +1,17 @@
+import {
+  LambdaRuntime,
+  parseLambdaExpression
+} from "./chunk-TXWGIEVH.js";
+import "./chunk-MPMRBT5R.js";
+import "./chunk-2KADE3SE.js";
+import "./chunk-QL2JFNA7.js";
+import "./chunk-DWXNZ5AJ.js";
+import "./chunk-4I5IZILN.js";
+import "./chunk-NZ6OQ7UT.js";
+import "./chunk-WVFWNVT2.js";
+import "./chunk-7NKII2JA.js";
+import "./chunk-MLKGABMK.js";
+export {
+  LambdaRuntime,
+  parseLambdaExpression
+};

package/dist/LambdaRuntime-LCTHBYMV.js

@@ -0,0 +1,17 @@
+import {
+  LambdaRuntime,
+  parseLambdaExpression
+} from "./chunk-2THXO6FH.js";
+import "./chunk-MPMRBT5R.js";
+import "./chunk-2KADE3SE.js";
+import "./chunk-A2ZJA2EV.js";
+import "./chunk-DWXNZ5AJ.js";
+import "./chunk-WMJGGREP.js";
+import "./chunk-NZ6OQ7UT.js";
+import "./chunk-SOJ2UMO2.js";
+import "./chunk-7NKII2JA.js";
+import "./chunk-SIAA4J6H.js";
+export {
+  LambdaRuntime,
+  parseLambdaExpression
+};

package/dist/LambdaRuntime-OFOTT464.js

@@ -0,0 +1,17 @@
+import {
+  LambdaRuntime,
+  parseLambdaExpression
+} from "./chunk-JIK2G3EH.js";
+import "./chunk-MPMRBT5R.js";
+import "./chunk-2KADE3SE.js";
+import "./chunk-A2ZJA2EV.js";
+import "./chunk-DWXNZ5AJ.js";
+import "./chunk-WMJGGREP.js";
+import "./chunk-NZ6OQ7UT.js";
+import "./chunk-SOJ2UMO2.js";
+import "./chunk-7NKII2JA.js";
+import "./chunk-SIAA4J6H.js";
+export {
+  LambdaRuntime,
+  parseLambdaExpression
+};

package/dist/LambdaRuntime-UKUOKJIW.js

@@ -0,0 +1,17 @@
+import {
+  LambdaRuntime,
+  parseLambdaExpression
+} from "./chunk-5FA54AMM.js";
+import "./chunk-MPMRBT5R.js";
+import "./chunk-2KADE3SE.js";
+import "./chunk-2VNRWIBZ.js";
+import "./chunk-DWXNZ5AJ.js";
+import "./chunk-4I5IZILN.js";
+import "./chunk-NZ6OQ7UT.js";
+import "./chunk-WVFWNVT2.js";
+import "./chunk-7NKII2JA.js";
+import "./chunk-MLKGABMK.js";
+export {
+  LambdaRuntime,
+  parseLambdaExpression
+};

package/dist/LambdaRuntime-VKLON4IB.js

@@ -0,0 +1,17 @@
+import {
+  LambdaRuntime,
+  parseLambdaExpression
+} from "./chunk-52UNWVOD.js";
+import "./chunk-MPMRBT5R.js";
+import "./chunk-2KADE3SE.js";
+import "./chunk-KYXZHRUG.js";
+import "./chunk-DWXNZ5AJ.js";
+import "./chunk-QVGVU6OS.js";
+import "./chunk-NZ6OQ7UT.js";
+import "./chunk-4UIWXZHY.js";
+import "./chunk-7NKII2JA.js";
+import "./chunk-SIAA4J6H.js";
+export {
+  LambdaRuntime,
+  parseLambdaExpression
+};

package/dist/LambdaRuntime-WPTX76CX.js

@@ -0,0 +1,17 @@
+import {
+  LambdaRuntime,
+  parseLambdaExpression
+} from "./chunk-UTAOS5Y7.js";
+import "./chunk-MPMRBT5R.js";
+import "./chunk-2KADE3SE.js";
+import "./chunk-ZXQELXXO.js";
+import "./chunk-DWXNZ5AJ.js";
+import "./chunk-5HXLTWYN.js";
+import "./chunk-NZ6OQ7UT.js";
+import "./chunk-5BIDGXA6.js";
+import "./chunk-7NKII2JA.js";
+import "./chunk-MLKGABMK.js";
+export {
+  LambdaRuntime,
+  parseLambdaExpression
+};

package/dist/Loader-4P7PEBCL.js

@@ -0,0 +1,11 @@
+import {
+  loadFileToCollection,
+  processAndStoreFile
+} from "./chunk-6SEX42H2.js";
+import "./chunk-SOJ2UMO2.js";
+import "./chunk-7NKII2JA.js";
+import "./chunk-SIAA4J6H.js";
+export {
+  loadFileToCollection,
+  processAndStoreFile
+};

package/dist/Loader-BM56B2TX.js

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

package/dist/Loader-NCATGB67.js

@@ -0,0 +1,11 @@
+import {
+  loadFileToCollection,
+  processAndStoreFile
+} from "./chunk-TPCNKMGZ.js";
+import "./chunk-4UIWXZHY.js";
+import "./chunk-7NKII2JA.js";
+import "./chunk-SIAA4J6H.js";
+export {
+  loadFileToCollection,
+  processAndStoreFile
+};

package/dist/Loader-WECRIXQW.js

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

package/dist/Loader-XFBIHCQF.js

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

package/dist/MCard-4J6WSBRF.js

@@ -0,0 +1,8 @@
+import {
+  MCard
+} from "./chunk-4UIWXZHY.js";
+import "./chunk-7NKII2JA.js";
+import "./chunk-SIAA4J6H.js";
+export {
+  MCard
+};

package/dist/MCard-5LIREV2B.js

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

package/dist/MCard-G4HUWHY5.js

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

package/dist/MCard-M4LKN4U2.js

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

package/dist/MCard-VB7UDUTN.js

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