mcard-js 2.1.24 → 2.1.26

package/README.md

@@ -609,7 +609,7 @@ To run integration tests against a live Ollama instance:
     npx vitest tests/rag/Integration.test.ts
     ```
 
-## Version 0.1.42 / 2.1.24 Release Notes (January 13, 2026)
+## Version 0.1.44 / 2.1.24 Release Notes (January 13, 2026)
 > Single Source of Truth Schema Synchronization
 
 ### 🔄 Schema Synchronization

package/dist/scripts/docker-startup.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=docker-startup.d.ts.map

package/dist/scripts/docker-startup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docker-startup.d.ts","sourceRoot":"","sources":["../../scripts/docker-startup.ts"],"names":[],"mappings":""}

package/dist/scripts/docker-startup.js

@@ -0,0 +1,39 @@
+import { executeStaticServer } from '../src/ptr/node/clm/operations/static-server.js';
+import { executeWebSocketServer } from '../src/ptr/node/clm/operations/websocket-server.js';
+async function main() {
+    console.log("🚀 Starting MCard Polyglot Services...");
+    // 1. Static Server
+    console.log("▶ Deploying Static Server on port 5320...");
+    const staticResult = await executeStaticServer({
+        action: 'deploy',
+        port: 5320,
+        host: '0.0.0.0',
+        root_dir: '/app/public'
+    }, {}, process.cwd());
+    if (staticResult.success) {
+        console.log(`✅ Static Server running: ${staticResult.url}`);
+        console.log(`   Serving: ${staticResult.root_dir}`);
+    }
+    else {
+        console.error(`❌ Static Server failed: ${staticResult.error}`);
+    }
+    // 2. WebSocket Server
+    console.log("▶ Deploying WebSocket Server on port 5321...");
+    // Assuming similar signature for WebSocket server
+    const wsResult = await executeWebSocketServer({
+        action: 'deploy',
+        port: 5321,
+        host: '0.0.0.0'
+    }, {}, process.cwd());
+    if (wsResult.success) {
+        console.log(`✅ WebSocket Server running: ws://0.0.0.0:5321`);
+    }
+    else {
+        console.error(`❌ WebSocket Server failed: ${wsResult.error}`);
+    }
+    console.log("\nServices are active. Press Ctrl+C to stop.");
+    // Keep process alive
+    setInterval(() => { }, 1000 * 60 * 60);
+}
+main().catch(console.error);
+//# sourceMappingURL=docker-startup.js.map

package/dist/scripts/docker-startup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"docker-startup.js","sourceRoot":"","sources":["../../scripts/docker-startup.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,iDAAiD,CAAC;AACtF,OAAO,EAAE,sBAAsB,EAAE,MAAM,oDAAoD,CAAC;AAG5F,KAAK,UAAU,IAAI;IACf,OAAO,CAAC,GAAG,CAAC,wCAAwC,CAAC,CAAC;IAEtD,mBAAmB;IACnB,OAAO,CAAC,GAAG,CAAC,2CAA2C,CAAC,CAAC;IACzD,MAAM,YAAY,GAAG,MAAM,mBAAmB,CAAC;QAC3C,MAAM,EAAE,QAAQ;QAChB,IAAI,EAAE,IAAI;QACV,IAAI,EAAE,SAAS;QACf,QAAQ,EAAE,aAAa;KAC1B,EAAE,EAAE,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IAEtB,IAAI,YAAY,CAAC,OAAO,EAAE,CAAC;QACvB,OAAO,CAAC,GAAG,CAAC,4BAA4B,YAAY,CAAC,GAAG,EAAE,CAAC,CAAC;QAC5D,OAAO,CAAC,GAAG,CAAC,eAAe,YAAY,CAAC,QAAQ,EAAE,CAAC,CAAC;IACxD,CAAC;SAAM,CAAC;QACJ,OAAO,CAAC,KAAK,CAAC,2BAA2B,YAAY,CAAC,KAAK,EAAE,CAAC,CAAC;IACnE,CAAC;IAED,sBAAsB;IACtB,OAAO,CAAC,GAAG,CAAC,8CAA8C,CAAC,CAAC;IAC5D,kDAAkD;IAClD,MAAM,QAAQ,GAAG,MAAM,sBAAsB,CAAC;QAC1C,MAAM,EAAE,QAAQ;QAChB,IAAI,EAAE,IAAI;QACV,IAAI,EAAE,SAAS;KAClB,EAAE,EAAE,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IAEtB,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;QACnB,OAAO,CAAC,GAAG,CAAC,+CAA+C,CAAC,CAAC;IACjE,CAAC;SAAM,CAAC;QACJ,OAAO,CAAC,KAAK,CAAC,8BAA8B,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC;IAClE,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,8CAA8C,CAAC,CAAC;IAE5D,qBAAqB;IACrB,WAAW,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,IAAI,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC;AAC3C,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC"}

package/dist/src/hash/HashValidator.d.ts

@@ -0,0 +1,14 @@
+/**
+ * HashValidator - Computes SHA-256 hashes using Web Crypto API
+ */
+export declare class HashValidator {
+    /**
+     * Compute hash of content using specified algorithm
+     */
+    static computeHash(content: Uint8Array | string, algorithm?: string): Promise<string>;
+    /**
+     * Validate that content matches expected hash
+     */
+    static validate(content: Uint8Array | string, expectedHash: string): Promise<boolean>;
+}
+//# sourceMappingURL=HashValidator.d.ts.map

package/dist/src/hash/HashValidator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HashValidator.d.ts","sourceRoot":"","sources":["../../../src/hash/HashValidator.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,aAAa;IACtB;;OAEG;WACU,WAAW,CAAC,OAAO,EAAE,UAAU,GAAG,MAAM,EAAE,SAAS,GAAE,MAAiB,GAAG,OAAO,CAAC,MAAM,CAAC;IA4BrG;;OAEG;WACU,QAAQ,CAAC,OAAO,EAAE,UAAU,GAAG,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAI9F"}

package/dist/src/hash/HashValidator.js

@@ -0,0 +1,57 @@
+/**
+ * HashValidator - Computes SHA-256 hashes using Web Crypto API
+ */
+export class HashValidator {
+    /**
+     * Compute hash of content using specified algorithm
+     */
+    static async computeHash(content, algorithm = 'sha256') {
+        const data = typeof content === 'string'
+            ? new TextEncoder().encode(content)
+            : content;
+        let algoName = 'SHA-256';
+        switch (algorithm.toLowerCase()) {
+            case 'sha1':
+                algoName = 'SHA-1';
+                break;
+            case 'sha-1':
+                algoName = 'SHA-1';
+                break;
+            case 'sha256':
+                algoName = 'SHA-256';
+                break;
+            case 'sha-256':
+                algoName = 'SHA-256';
+                break;
+            case 'sha384':
+                algoName = 'SHA-384';
+                break;
+            case 'sha-384':
+                algoName = 'SHA-384';
+                break;
+            case 'sha512':
+                algoName = 'SHA-512';
+                break;
+            case 'sha-512':
+                algoName = 'SHA-512';
+                break;
+            default:
+                console.warn(`Algorithm ${algorithm} not natively supported or mapped, defaulting to SHA-256`);
+                algoName = 'SHA-256';
+        }
+        // Create a copy to ensure we have a standard ArrayBuffer (not SharedArrayBuffer)
+        const buffer = new Uint8Array(data).buffer;
+        const hashBuffer = await crypto.subtle.digest(algoName, buffer);
+        return Array.from(new Uint8Array(hashBuffer))
+            .map(b => b.toString(16).padStart(2, '0'))
+            .join('');
+    }
+    /**
+     * Validate that content matches expected hash
+     */
+    static async validate(content, expectedHash) {
+        const computedHash = await this.computeHash(content);
+        return computedHash === expectedHash;
+    }
+}
+//# sourceMappingURL=HashValidator.js.map

package/dist/src/hash/HashValidator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HashValidator.js","sourceRoot":"","sources":["../../../src/hash/HashValidator.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,OAAO,aAAa;IACtB;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,OAA4B,EAAE,YAAoB,QAAQ;QAC/E,MAAM,IAAI,GAAG,OAAO,OAAO,KAAK,QAAQ;YACpC,CAAC,CAAC,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC;YACnC,CAAC,CAAC,OAAO,CAAC;QAEd,IAAI,QAAQ,GAAG,SAAS,CAAC;QACzB,QAAQ,SAAS,CAAC,WAAW,EAAE,EAAE,CAAC;YAC9B,KAAK,MAAM;gBAAE,QAAQ,GAAG,OAAO,CAAC;gBAAC,MAAM;YACvC,KAAK,OAAO;gBAAE,QAAQ,GAAG,OAAO,CAAC;gBAAC,MAAM;YACxC,KAAK,QAAQ;gBAAE,QAAQ,GAAG,SAAS,CAAC;gBAAC,MAAM;YAC3C,KAAK,SAAS;gBAAE,QAAQ,GAAG,SAAS,CAAC;gBAAC,MAAM;YAC5C,KAAK,QAAQ;gBAAE,QAAQ,GAAG,SAAS,CAAC;gBAAC,MAAM;YAC3C,KAAK,SAAS;gBAAE,QAAQ,GAAG,SAAS,CAAC;gBAAC,MAAM;YAC5C,KAAK,QAAQ;gBAAE,QAAQ,GAAG,SAAS,CAAC;gBAAC,MAAM;YAC3C,KAAK,SAAS;gBAAE,QAAQ,GAAG,SAAS,CAAC;gBAAC,MAAM;YAC5C;gBACI,OAAO,CAAC,IAAI,CAAC,aAAa,SAAS,0DAA0D,CAAC,CAAC;gBAC/F,QAAQ,GAAG,SAAS,CAAC;QAC7B,CAAC;QAED,iFAAiF;QACjF,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC,MAAqB,CAAC;QAC1D,MAAM,UAAU,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QAChE,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,UAAU,CAAC,UAAU,CAAC,CAAC;aACxC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;aACzC,IAAI,CAAC,EAAE,CAAC,CAAC;IAClB,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,OAA4B,EAAE,YAAoB;QACpE,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;QACrD,OAAO,YAAY,KAAK,YAAY,CAAC;IACzC,CAAC;CACJ"}

package/dist/src/index.d.ts

@@ -0,0 +1,29 @@
+export { MCard } from './model/MCard';
+export { GTime } from './model/GTime';
+export { ContentHandle, validateHandle, HandleValidationError } from './model/Handle';
+export { CardCollection } from './model/CardCollection';
+export { ContentTypeInterpreter } from './model/detectors/ContentTypeInterpreter';
+export { EVENT_CONSTANTS, ALGORITHM_HIERARCHY } from './model/constants';
+export { StorageEngine, Page } from './storage/StorageAdapter';
+export { IndexedDBEngine } from './storage/IndexedDBEngine';
+export { SqliteWasmEngine } from './storage/SqliteWasmEngine';
+export { SqliteNodeEngine } from './storage/SqliteNodeEngine';
+export { HashValidator } from './hash/HashValidator';
+export { Maybe } from './monads/Maybe';
+export { Either } from './monads/Either';
+export { IO } from './monads/IO';
+export { Reader } from './monads/Reader';
+export { Writer } from './monads/Writer';
+export { State } from './monads/State';
+export { LensProtocol, JsonRpcRequest, JsonRpcResponse, ErrorCodes } from './ptr/LensProtocol';
+export { SandboxWorker } from './ptr/SandboxWorker';
+export * from './ptr/common_types';
+export { FaroSidecar, FaroSidecarConfig } from './ptr/FaroSidecar';
+import * as FileIO from './util/FileIO';
+import * as Loader from './util/Loader';
+export { FileIO, Loader };
+export { LLMRuntime, promptMonad, chatMonad } from './ptr/llm/LLMRuntime';
+export { LLMConfig } from './ptr/llm/Config';
+export * as Lambda from './ptr/lambda';
+export { LambdaRuntime } from './ptr/lambda/LambdaRuntime';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AACtC,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AACtC,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACtF,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,sBAAsB,EAAE,MAAM,0CAA0C,CAAC;AAClF,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAGzE,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAG9D,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAGrD,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AACvC,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACzC,OAAO,EAAE,EAAE,EAAE,MAAM,aAAa,CAAC;AACjC,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACzC,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACzC,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAGvC,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAC/F,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,cAAc,oBAAoB,CAAC;AACnC,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAInE,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;AAG1B,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAC1E,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAG7C,OAAO,KAAK,MAAM,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/src/index.js

@@ -0,0 +1,38 @@
+// MCard JavaScript Library
+// Content-addressable storage for browsers
+// Core model
+export { MCard } from './model/MCard';
+export { GTime } from './model/GTime';
+export { ContentHandle, validateHandle, HandleValidationError } from './model/Handle';
+export { CardCollection } from './model/CardCollection';
+export { ContentTypeInterpreter } from './model/detectors/ContentTypeInterpreter';
+export { EVENT_CONSTANTS, ALGORITHM_HIERARCHY } from './model/constants';
+export { IndexedDBEngine } from './storage/IndexedDBEngine';
+export { SqliteWasmEngine } from './storage/SqliteWasmEngine';
+export { SqliteNodeEngine } from './storage/SqliteNodeEngine';
+// Hash
+export { HashValidator } from './hash/HashValidator';
+// Monads
+export { Maybe } from './monads/Maybe';
+export { Either } from './monads/Either';
+export { IO } from './monads/IO';
+export { Reader } from './monads/Reader';
+export { Writer } from './monads/Writer';
+export { State } from './monads/State';
+// PTR (Polynomial Type Runtime)
+export { LensProtocol, ErrorCodes } from './ptr/LensProtocol';
+export { SandboxWorker } from './ptr/SandboxWorker';
+export * from './ptr/common_types';
+export { FaroSidecar } from './ptr/FaroSidecar';
+// Utils
+// Note: Exporting as namespace to avoid naming collisions
+import * as FileIO from './util/FileIO';
+import * as Loader from './util/Loader';
+export { FileIO, Loader };
+// LLM
+export { LLMRuntime, promptMonad, chatMonad } from './ptr/llm/LLMRuntime';
+export { LLMConfig } from './ptr/llm/Config';
+// Lambda Calculus Runtime (α-β-η conversions)
+export * as Lambda from './ptr/lambda';
+export { LambdaRuntime } from './ptr/lambda/LambdaRuntime';
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,2BAA2B;AAC3B,2CAA2C;AAE3C,aAAa;AACb,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AACtC,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AACtC,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACtF,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,sBAAsB,EAAE,MAAM,0CAA0C,CAAC;AAClF,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAIzE,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAE9D,OAAO;AACP,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD,SAAS;AACT,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AACvC,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACzC,OAAO,EAAE,EAAE,EAAE,MAAM,aAAa,CAAC;AACjC,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACzC,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACzC,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAEvC,gCAAgC;AAChC,OAAO,EAAE,YAAY,EAAmC,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAC/F,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,cAAc,oBAAoB,CAAC;AACnC,OAAO,EAAE,WAAW,EAAqB,MAAM,mBAAmB,CAAC;AAEnE,QAAQ;AACR,0DAA0D;AAC1D,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;AAE1B,MAAM;AACN,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAC1E,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE7C,8CAA8C;AAC9C,OAAO,KAAK,MAAM,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/src/model/CardCollection.d.ts

@@ -0,0 +1,147 @@
+import { MCard } from './MCard';
+import { StorageEngine, Page } from '../storage/StorageAdapter';
+import { Maybe } from '../monads/Maybe';
+/**
+ * CardCollection - High-level interface for MCard operations with monadic API
+ *
+ * ## DOTS Vocabulary Role: CARRIER CATEGORY Car(S)
+ *
+ * CardCollection is the **Carrier Category** in the Double Operadic Theory of Systems.
+ * - **Objects**: Individual MCards (data artifacts)
+ * - **Morphisms**: Hash references between MCards (content-addressable links)
+ * - **Composition**: Morphisms compose via hash chains (Merkle-DAG structure)
+ *
+ * The Carrier is where **actual systems live**. While the Target (CLM design space)
+ * defines possible interfaces and interactions, the Carrier holds the real data.
+ *
+ * ## The Action: Loose(I) ⊛ Car(S) → Car(S)
+ *
+ * In DOTS, the **Action** is how interactions (from Target) act on systems (in Carrier)
+ * to produce new systems. For CardCollection:
+ * - PCard (Chart/Lens) defines the interaction pattern
+ * - CardCollection.add() produces new MCard in the Carrier
+ * - The result is a new Object in Car(S)
+ *
+ * ## Empty Schema Principle
+ *
+ * CardCollection embodies the Wordless Book principle:
+ * - At t₀: Empty collection = "Wordless Book"
+ * - At t_n: Billions of cards = "Infinite Library"
+ * - Schema (structure) never changes; only data (content) grows
+ *
+ * ## CRD-Only Operations (No UPDATE)
+ *
+ * Following MCard design principles, this collection supports only:
+ * - **C**reate: `add()`, `addWithHandle()`
+ * - **R**ead: `get()`, `getByHandle()`, `getPage()`, `search*()`
+ * - **D**elete: `delete()`, `clear()`
+ *
+ * There is NO `update()` method. Instead, to "update":
+ * 1. Create a new MCard with new content
+ * 2. Use `updateHandle()` to point the handle to the new hash
+ * 3. The old MCard remains in the collection (immutable history)
+ *
+ * ## CRDT Foundation (G-Set)
+ *
+ * CardCollection implements **Grow-Only Set (G-Set) CRDT** semantics:
+ * - **Commutative**: merge(A, B) = merge(B, A)
+ * - **Associative**: merge(A, merge(B, C)) = merge(merge(A, B), C)
+ * - **Idempotent**: merge(A, A) = A (same hash = same card)
+ *
+ * This enables **Strong Eventual Consistency** without coordination.
+ *
+ * ## Monadic API
+ *
+ * The `*M` methods (getM, getByHandleM, etc.) return Maybe<T> monads
+ * for composable, null-safe operations following functional programming patterns.
+ *
+ * @see {@link MCard} for the individual Carrier objects
+ * @see {@link DOTSRole.CARRIER} for DOTS vocabulary definition
+ * @see docs/WorkingNotes/Permanent/Projects/PKC Kernel/MCard.md for full specification
+ */
+export declare class CardCollection {
+    private engine;
+    constructor(engine: StorageEngine);
+    /**
+     * Add a card to the collection
+     * Handles duplicates (same content, same hash) and collisions (diff content, same hash)
+     */
+    add(card: MCard): Promise<string>;
+    private areContentsEqual;
+    /**
+     * Get a card by hash
+     */
+    get(hash: string): Promise<MCard | null>;
+    /**
+     * Delete a card by hash
+     */
+    delete(hash: string): Promise<void>;
+    /**
+     * Get a page of cards
+     */
+    getPage(pageNumber?: number, pageSize?: number): Promise<Page<MCard>>;
+    /**
+     * Count total cards
+     */
+    count(): Promise<number>;
+    /**
+     * Add a card and register a handle for it
+     */
+    addWithHandle(card: MCard, handle: string): Promise<string>;
+    /**
+     * Get card by handle
+     */
+    getByHandle(handle: string): Promise<MCard | null>;
+    /**
+     * Resolve handle to hash
+     */
+    resolveHandle(handle: string): Promise<string | null>;
+    /**
+     * Update handle to point to new card
+     */
+    updateHandle(handle: string, newCard: MCard): Promise<string>;
+    /**
+     * Get version history for a handle
+     */
+    getHandleHistory(handle: string): Promise<{
+        previousHash: string;
+        changedAt: string;
+    }[]>;
+    /**
+     * Monadic get - returns Maybe<MCard>
+     */
+    getM(hash: string): Promise<Maybe<MCard>>;
+    /**
+     * Monadic getByHandle - returns Maybe<MCard>
+     */
+    getByHandleM(handle: string): Promise<Maybe<MCard>>;
+    /**
+     * Monadic resolveHandle - returns Maybe<string>
+     */
+    resolveHandleM(handle: string): Promise<Maybe<string>>;
+    /**
+     * Resolve handle and get card in one monadic operation
+     */
+    resolveAndGetM(handle: string): Promise<Maybe<MCard>>;
+    /**
+     * Prune version history for a handle.
+     * @param handle The handle string.
+     * @param options Options for pruning (olderThan date, or deleteAll).
+     * @returns Number of deleted entries.
+     */
+    pruneHandleHistory(handle: string, options?: {
+        olderThan?: string;
+        deleteAll?: boolean;
+    }): Promise<number>;
+    clear(): Promise<void>;
+    searchByString(query: string, pageNumber?: number, pageSize?: number): Promise<Page<MCard>>;
+    searchByContent(query: string, pageNumber?: number, pageSize?: number): Promise<Page<MCard>>;
+    searchByHash(hashPrefix: string): Promise<MCard[]>;
+    getAllMCardsRaw(): Promise<MCard[]>;
+    getAllCards(pageSize?: number, processCallback?: (card: MCard) => any): Promise<{
+        cards: MCard[];
+        total: number;
+    }>;
+    printAllCards(): Promise<void>;
+}
+//# sourceMappingURL=CardCollection.d.ts.map

package/dist/src/model/CardCollection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CardCollection.d.ts","sourceRoot":"","sources":["../../../src/model/CardCollection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAGxC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyDG;AACH,qBAAa,cAAc;IACvB,OAAO,CAAC,MAAM,CAAgB;gBAElB,MAAM,EAAE,aAAa;IAMjC;;;OAGG;IACG,GAAG,CAAC,IAAI,EAAE,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC;IA4CvC,OAAO,CAAC,gBAAgB;IAQxB;;OAEG;IACG,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC;IAI9C;;OAEG;IACG,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzC;;OAEG;IACG,OAAO,CAAC,UAAU,GAAE,MAAU,EAAE,QAAQ,GAAE,MAAW,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAIlF;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC;IAM9B;;OAEG;IACG,aAAa,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAMjE;;OAEG;IACG,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC;IAIxD;;OAEG;IACG,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAI3D;;OAEG;IACG,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC;IAMnE;;OAEG;IACG,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAM9F;;OAEG;IACG,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAK/C;;OAEG;IACG,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAKzD;;OAEG;IACG,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAK5D;;OAEG;IACG,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAM3D;;;;;OAKG;IACG,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,OAAO,CAAA;KAAO,GAAG,OAAO,CAAC,MAAM,CAAC;IAS9G,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAItB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,GAAE,MAAU,EAAE,QAAQ,GAAE,MAAW,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAIlG,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,GAAE,MAAU,EAAE,QAAQ,GAAE,MAAW,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAInG,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAIlD,eAAe,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;IAInC,WAAW,CAAC,QAAQ,GAAE,MAAW,EAAE,eAAe,CAAC,EAAE,CAAC,IAAI,EAAE,KAAK,KAAK,GAAG,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,KAAK,EAAE,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAwBtH,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;CAevC"}

package/dist/src/model/CardCollection.js

@@ -0,0 +1,272 @@
+import { MCard } from './MCard';
+import { Maybe } from '../monads/Maybe';
+/**
+ * CardCollection - High-level interface for MCard operations with monadic API
+ *
+ * ## DOTS Vocabulary Role: CARRIER CATEGORY Car(S)
+ *
+ * CardCollection is the **Carrier Category** in the Double Operadic Theory of Systems.
+ * - **Objects**: Individual MCards (data artifacts)
+ * - **Morphisms**: Hash references between MCards (content-addressable links)
+ * - **Composition**: Morphisms compose via hash chains (Merkle-DAG structure)
+ *
+ * The Carrier is where **actual systems live**. While the Target (CLM design space)
+ * defines possible interfaces and interactions, the Carrier holds the real data.
+ *
+ * ## The Action: Loose(I) ⊛ Car(S) → Car(S)
+ *
+ * In DOTS, the **Action** is how interactions (from Target) act on systems (in Carrier)
+ * to produce new systems. For CardCollection:
+ * - PCard (Chart/Lens) defines the interaction pattern
+ * - CardCollection.add() produces new MCard in the Carrier
+ * - The result is a new Object in Car(S)
+ *
+ * ## Empty Schema Principle
+ *
+ * CardCollection embodies the Wordless Book principle:
+ * - At t₀: Empty collection = "Wordless Book"
+ * - At t_n: Billions of cards = "Infinite Library"
+ * - Schema (structure) never changes; only data (content) grows
+ *
+ * ## CRD-Only Operations (No UPDATE)
+ *
+ * Following MCard design principles, this collection supports only:
+ * - **C**reate: `add()`, `addWithHandle()`
+ * - **R**ead: `get()`, `getByHandle()`, `getPage()`, `search*()`
+ * - **D**elete: `delete()`, `clear()`
+ *
+ * There is NO `update()` method. Instead, to "update":
+ * 1. Create a new MCard with new content
+ * 2. Use `updateHandle()` to point the handle to the new hash
+ * 3. The old MCard remains in the collection (immutable history)
+ *
+ * ## CRDT Foundation (G-Set)
+ *
+ * CardCollection implements **Grow-Only Set (G-Set) CRDT** semantics:
+ * - **Commutative**: merge(A, B) = merge(B, A)
+ * - **Associative**: merge(A, merge(B, C)) = merge(merge(A, B), C)
+ * - **Idempotent**: merge(A, A) = A (same hash = same card)
+ *
+ * This enables **Strong Eventual Consistency** without coordination.
+ *
+ * ## Monadic API
+ *
+ * The `*M` methods (getM, getByHandleM, etc.) return Maybe<T> monads
+ * for composable, null-safe operations following functional programming patterns.
+ *
+ * @see {@link MCard} for the individual Carrier objects
+ * @see {@link DOTSRole.CARRIER} for DOTS vocabulary definition
+ * @see docs/WorkingNotes/Permanent/Projects/PKC Kernel/MCard.md for full specification
+ */
+export class CardCollection {
+    engine;
+    constructor(engine) {
+        this.engine = engine;
+    }
+    // =========== Standard Operations ===========
+    /**
+     * Add a card to the collection
+     * Handles duplicates (same content, same hash) and collisions (diff content, same hash)
+     */
+    async add(card) {
+        // Check existing by hash
+        const existingCard = await this.engine.get(card.hash);
+        if (existingCard) {
+            // Compare content
+            const isDuplicate = this.areContentsEqual(existingCard.content, card.content);
+            if (isDuplicate) {
+                // Duplicate detected
+                // console.debug(`Duplicate detected for hash ${card.hash}`);
+                const { generateDuplicationEvent } = await import('./EventProducer');
+                const eventStr = generateDuplicationEvent(card);
+                const eventCard = await MCard.create(eventStr);
+                // Store duplicate event but do not overwrite original card
+                await this.engine.add(eventCard);
+                return card.hash;
+            }
+            else {
+                // Collision detected
+                // console.warn(`Collision detected for hash ${card.hash}`);
+                const { generateCollisionEvent } = await import('./EventProducer');
+                const eventStr = await generateCollisionEvent(card);
+                // Store collision event
+                const eventCard = await MCard.create(eventStr);
+                await this.engine.add(eventCard);
+                // Store colliding card with upgraded hash function
+                const eventObj = JSON.parse(eventStr);
+                const nextAlgo = eventObj.upgraded_function;
+                if (!nextAlgo) {
+                    throw new Error("Failed to determine next hash algorithm for collision");
+                }
+                const upgradedCard = await MCard.create(card.content, nextAlgo);
+                return this.engine.add(upgradedCard);
+            }
+        }
+        return this.engine.add(card);
+    }
+    areContentsEqual(a, b) {
+        if (a.length !== b.length)
+            return false;
+        for (let i = 0; i < a.length; i++) {
+            if (a[i] !== b[i])
+                return false;
+        }
+        return true;
+    }
+    /**
+     * Get a card by hash
+     */
+    async get(hash) {
+        return this.engine.get(hash);
+    }
+    /**
+     * Delete a card by hash
+     */
+    async delete(hash) {
+        return this.engine.delete(hash);
+    }
+    /**
+     * Get a page of cards
+     */
+    async getPage(pageNumber = 1, pageSize = 10) {
+        return this.engine.getPage(pageNumber, pageSize);
+    }
+    /**
+     * Count total cards
+     */
+    async count() {
+        return this.engine.count();
+    }
+    // =========== Handle Operations ===========
+    /**
+     * Add a card and register a handle for it
+     */
+    async addWithHandle(card, handle) {
+        const hash = await this.add(card);
+        await this.engine.registerHandle(handle, hash);
+        return hash;
+    }
+    /**
+     * Get card by handle
+     */
+    async getByHandle(handle) {
+        return this.engine.getByHandle(handle);
+    }
+    /**
+     * Resolve handle to hash
+     */
+    async resolveHandle(handle) {
+        return this.engine.resolveHandle(handle);
+    }
+    /**
+     * Update handle to point to new card
+     */
+    async updateHandle(handle, newCard) {
+        const hash = await this.add(newCard);
+        await this.engine.updateHandle(handle, hash);
+        return hash;
+    }
+    /**
+     * Get version history for a handle
+     */
+    async getHandleHistory(handle) {
+        return this.engine.getHandleHistory(handle);
+    }
+    // =========== Monadic Operations ===========
+    /**
+     * Monadic get - returns Maybe<MCard>
+     */
+    async getM(hash) {
+        const card = await this.get(hash);
+        return card ? Maybe.just(card) : Maybe.nothing();
+    }
+    /**
+     * Monadic getByHandle - returns Maybe<MCard>
+     */
+    async getByHandleM(handle) {
+        const card = await this.getByHandle(handle);
+        return card ? Maybe.just(card) : Maybe.nothing();
+    }
+    /**
+     * Monadic resolveHandle - returns Maybe<string>
+     */
+    async resolveHandleM(handle) {
+        const hash = await this.resolveHandle(handle);
+        return hash ? Maybe.just(hash) : Maybe.nothing();
+    }
+    /**
+     * Resolve handle and get card in one monadic operation
+     */
+    async resolveAndGetM(handle) {
+        const maybeHash = await this.resolveHandleM(handle);
+        if (maybeHash.isNothing)
+            return Maybe.nothing();
+        return this.getM(maybeHash.value);
+    }
+    /**
+     * Prune version history for a handle.
+     * @param handle The handle string.
+     * @param options Options for pruning (olderThan date, or deleteAll).
+     * @returns Number of deleted entries.
+     */
+    async pruneHandleHistory(handle, options = {}) {
+        if (this.engine.pruneHandleHistory) {
+            return this.engine.pruneHandleHistory(handle, options);
+        }
+        return 0; // Or throw error if engine doesn't support it
+    }
+    // =========== Search & Bulk Operations ===========
+    async clear() {
+        return this.engine.clear();
+    }
+    async searchByString(query, pageNumber = 1, pageSize = 10) {
+        return this.engine.search(query, pageNumber, pageSize);
+    }
+    async searchByContent(query, pageNumber = 1, pageSize = 10) {
+        return this.engine.search(query, pageNumber, pageSize);
+    }
+    async searchByHash(hashPrefix) {
+        return this.engine.searchByHash(hashPrefix);
+    }
+    async getAllMCardsRaw() {
+        return this.engine.getAll();
+    }
+    async getAllCards(pageSize = 10, processCallback) {
+        const cards = [];
+        let pageNumber = 1;
+        let total = 0;
+        while (true) {
+            const page = await this.getPage(pageNumber, pageSize);
+            if (!page.items || page.items.length === 0)
+                break;
+            for (const card of page.items) {
+                if (processCallback) {
+                    processCallback(card);
+                }
+                cards.push(card);
+            }
+            total = page.totalItems;
+            if (!page.hasNext)
+                break;
+            pageNumber++;
+        }
+        return { cards, total };
+    }
+    async printAllCards() {
+        const cards = await this.getAllMCardsRaw();
+        cards.forEach(card => {
+            console.log(`Hash: ${card.hash}`);
+            // Try to print as text if possible
+            try {
+                const text = new TextDecoder().decode(card.content);
+                const preview = text.slice(0, 100).replace(/\n/g, ' ');
+                console.log(`Content: ${preview}${text.length > 100 ? '...' : ''}`);
+            }
+            catch {
+                console.log(`Content (binary): ${card.content.length} bytes`);
+            }
+            console.log('---');
+        });
+    }
+}
+//# sourceMappingURL=CardCollection.js.map

package/dist/src/model/CardCollection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CardCollection.js","sourceRoot":"","sources":["../../../src/model/CardCollection.ts"],"names":[],"mappings":"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"}