mcard-js 1.0.0 → 2.0.0

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2025 Ben Koo
+Copyright (c) 2024-2025 Ben Koo
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -1,117 +1,428 @@
-# MCard JS
+# MCard JavaScript / TypeScript
 
-A JavaScript implementation of MCard, a data model for persistently storing content with cryptographic hashing and timestamping.
+Full-featured TypeScript implementation of MCard content-addressable storage, supporting both browser and Node.js environments.
 
-## Overview
+[![Tests](https://img.shields.io/badge/tests-117%20passed-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/)
 
-MCard JS provides a cross-environment implementation that works in both Node.js and browser environments. The library offers functionality for:
+## Features
 
-- Creating and managing content cards with cryptographic hashing
-- Storing structured data with timestamps
-- Searching and retrieving cards by various criteria
-- Synchronizing data with persistence providers
-- Redux middleware for persisting application state
+- **Content Addressing**: SHA-256 via Web Crypto API (browser) or Node.js crypto
+- **Dual Storage**: IndexedDB (browser) + SQLite via better-sqlite3 (Node.js)
+- **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)
+- **LLM Integration**: Ollama provider for local LLM execution
+- **Vector Search**: sqlite-vec extension for semantic similarity search
 
-## Key Components
+## Quick Start
 
-### Core
+### Browser (IndexedDB)
+```typescript
+import { MCard, IndexedDBEngine, CardCollection } from 'mcard-js';
 
-- **MCard**: Core data structure that wraps content with hash, timestamp, and metadata
-- **CardCollection**: Manages multiple MCards, providing search and retrieval capabilities
-- **GTime**: Handles global timestamping with region-aware formatting
+const db = new IndexedDBEngine();
+await db.init();
 
-### Middleware
+const collection = new CardCollection(db);
+const card = await MCard.create('Hello, 世界!');
+await collection.addWithHandle(card, 'greeting');
 
-- **mcardPersistenceMiddleware**: Redux middleware for persisting actions and state snapshots
+// Monadic retrieval
+const result = await collection.getByHandleM('greeting');
+if (result.isJust) {
+  console.log(result.value.getContentAsText());
+}
+```
 
-### Utilities
+### Node.js (SQLite)
+```typescript
+import { MCard } from './model/MCard';
+import { SqliteNodeEngine } from './storage/SqliteNodeEngine';
 
-- **SafeBuffer**: Cross-environment Buffer implementation for Node.js and browsers
-- **Content Type Detection**: Automated detection and handling of various content types
-- **Cryptographic Utilities**: Hash generation and validation
+// File-based or in-memory database
+const engine = new SqliteNodeEngine('./data/mcard.db');
+// or: const engine = new SqliteNodeEngine(':memory:');
 
-## Cross-Environment Compatibility
+// Store a card
+const card = await MCard.create('Hello from Node.js!');
+await engine.save(card);
 
-MCard JS is designed to work in both Node.js and browser environments through:
+// Retrieve by hash
+const retrieved = await engine.get(card.hash);
+console.log(retrieved?.getContentAsText());
 
-- Buffer polyfills for browser compatibility
-- Environment detection for optimal feature usage
-- TextEncoder/TextDecoder polyfills
+// Search
+const results = engine.searchByString('Hello');
+console.log(`Found ${results.totalItems} cards`);
 
-## Recent Updates
+// Clean up
+engine.close();
+```
 
-### Redux Middleware Improvements
+## Storage Backends
 
-- Enhanced middleware implementation following the Redux pattern (store => next => action)
-- Support for both named and default exports for compatibility
-- Graceful handling when storage service is unavailable
-- Better test coverage (93.75% statements, 100% functions)
+### IndexedDB (Browser)
+```typescript
+const db = new IndexedDBEngine();
+await db.init();
+```
 
-### Buffer Compatibility Fixes
+### SQLite WASM (Browser)
+```typescript
+const db = new SqliteWasmEngine();
+await db.init();
+const data = db.export(); // Persist to IndexedDB
+```
 
-- Cross-environment support for Buffer/Uint8Array content handling
-- Improved content access and conversion
-- Robust test suite for both Node.js and browser environments
+### SQLite Node.js (Server)
+```typescript
+import { SqliteNodeEngine } from './storage/SqliteNodeEngine';
 
-## Getting Started
+const db = new SqliteNodeEngine('./mcard.db');
 
-### Installation
+// Synchronous API available for performance
+db.saveSync(card);
+const card = db.getSync(hash);
+const count = db.countSync();
 
-```bash
-npm install @benkoo/mcard
+db.close();
 ```
 
-### Basic Usage
+## Database Schema
 
-```javascript
-import { MCard, CardCollection } from '@benkoo/mcard';
+The SQLite backend uses schemas matching the Python implementation for full interoperability.
+Schemas are defined in `src/storage/schema.ts` and mirror `mcard/model/schema.py` and `mcard/rag/*/schema.py`.
 
-// Create a card with content
-const card = new MCard('Hello, World!');
+### Core Storage (matches `mcard/model/schema.py`)
 
-// Create a collection and add the card
-const collection = new CardCollection();
-collection.add(card);
+```sql
+-- Content-addressable card storage
+CREATE TABLE card (
+  hash TEXT PRIMARY KEY,
+  content BLOB NOT NULL,
+  g_time TEXT NOT NULL
+);
 
-// Retrieve by hash
-const retrievedCard = collection.get(card.hash);
+-- Handle registry (UTF-8 string → hash mapping)
+CREATE TABLE handle_registry (
+  handle TEXT PRIMARY KEY,
+  current_hash TEXT NOT NULL,
+  created_at TEXT NOT NULL,
+  updated_at TEXT NOT NULL,
+  FOREIGN KEY (current_hash) REFERENCES card(hash)
+);
 
-// Search by content
-const searchResults = collection.search_by_string('Hello');
+-- Handle version history
+CREATE TABLE handle_history (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  handle TEXT NOT NULL,
+  previous_hash TEXT NOT NULL,
+  changed_at TEXT NOT NULL,
+  FOREIGN KEY (handle) REFERENCES handle_registry(handle),
+  FOREIGN KEY (previous_hash) REFERENCES card(hash)
+);
 ```
 
-### Redux Integration
+### Vector Storage (matches `mcard/rag/vector/schema.py`)
+
+```sql
+-- Vector metadata
+CREATE TABLE mcard_vector_metadata (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  hash TEXT NOT NULL,
+  model_name TEXT NOT NULL,
+  dimensions INTEGER NOT NULL,
+  chunk_index INTEGER DEFAULT 0,
+  chunk_total INTEGER DEFAULT 1,
+  chunk_text TEXT,
+  created_at TEXT NOT NULL,
+  UNIQUE(hash, chunk_index)
+);
 
-```javascript
-import { createStore, applyMiddleware } from 'redux';
-import { mcardPersistenceMiddleware } from '@benkoo/mcard';
-import McardStorageService from './mcardStorageService';
-import rootReducer from './reducers';
+-- Fallback embeddings (when sqlite-vec unavailable)
+CREATE TABLE mcard_embeddings (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  metadata_id INTEGER NOT NULL REFERENCES mcard_vector_metadata(id),
+  embedding BLOB NOT NULL,
+  UNIQUE(metadata_id)
+);
 
-const store = createStore(
-  rootReducer,
-  applyMiddleware(
-    mcardPersistenceMiddleware(McardStorageService)
-  )
+-- FTS5 for hybrid search
+CREATE VIRTUAL TABLE mcard_fts USING fts5(
+  hash, content, tokenize='porter unicode61'
+);
+
+-- sqlite-vec virtual table (when extension available)
+CREATE VIRTUAL TABLE mcard_vec USING vec0(
+  metadata_id INTEGER PRIMARY KEY,
+  embedding float[768]
 );
 ```
 
-## Development
+### Graph Storage (matches `mcard/rag/graph/schema.py`)
+
+```sql
+-- Knowledge graph entities
+CREATE TABLE graph_entities (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  name TEXT NOT NULL,
+  type TEXT NOT NULL,
+  description TEXT,
+  source_hash TEXT NOT NULL,
+  embedding BLOB,
+  created_at TEXT NOT NULL,
+  UNIQUE(name, type, source_hash)
+);
+
+-- Knowledge graph relationships
+CREATE TABLE graph_relationships (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  source_entity_id INTEGER NOT NULL,
+  target_entity_id INTEGER NOT NULL,
+  relationship TEXT NOT NULL,
+  description TEXT,
+  weight REAL DEFAULT 1.0,
+  source_hash TEXT NOT NULL,
+  created_at TEXT NOT NULL
+);
+```
+
+## Monads
+
+```typescript
+import { Maybe, Either, IO } from 'mcard-js';
+
+// Maybe - optional values
+Maybe.just(5).bind(x => Maybe.just(x * 2)); // Just(10)
+Maybe.nothing().map(x => x * 2);            // Nothing
+
+// Either - error handling
+Either.right(5).map(x => x * 2);            // Right(10)
+Either.left('error').map(x => x * 2);       // Left('error')
+
+// IO - deferred side effects
+const io = IO.of(() => fetch('/api'));
+await io.run();
+```
+
+## PTR (Polynomial Type Runtime)
+
+### CLM Execution
+```typescript
+import { CLMRunner } from './ptr/node/CLMRunner';
+import { CLMLoader } from './ptr/node/CLMLoader';
+
+const runner = new CLMRunner();
+const loader = new CLMLoader();
+
+// Load and execute a CLM specification
+const clm = loader.load('chapters/chapter_01_arithmetic/addition.yaml');
+const result = await runner.executeCLM(clm, './chapters/chapter_01_arithmetic', { a: 10, b: 20 });
+
+console.log(result.result); // 30
+```
+
+### Recursive CLM (Meta-Execution)
+```typescript
+// CLM files can reference other CLM files as their runtime
+// runtime: meta.clm  → loads and executes meta.clm with original context
+
+const clm = {
+  chapter: { title: 'Orchestrator' },
+  clm: {
+    concrete: { runtime: 'meta.clm' }  // Recursive execution
+  }
+};
+
+const result = await runner.executeCLM(clm, chapterDir, input);
+```
+
+### Polyglot Runtimes
+```typescript
+import { RuntimeFactory } from './ptr/node/Runtimes';
+
+// Available runtimes
+const jsRuntime = RuntimeFactory.getRuntime('javascript');
+const pyRuntime = RuntimeFactory.getRuntime('python');
+const rustRuntime = RuntimeFactory.getRuntime('rust');
+const cRuntime = RuntimeFactory.getRuntime('c');
+const wasmRuntime = RuntimeFactory.getRuntime('wasm');
+const leanRuntime = RuntimeFactory.getRuntime('lean');
+const llmRuntime = RuntimeFactory.getRuntime('llm');
+const loaderRuntime = RuntimeFactory.getRuntime('loader');
+
+// Check availability
+const available = RuntimeFactory.getAvailableRuntimes();
+```
+
+### File Loader Runtime
+
+The `LoaderRuntime` provides high-performance directory loading using native Node.js APIs:
+
+```typescript
+// CLM files can use operation: loader for built-in file loading
+// Example CLM:
+// concrete:
+//   runtime: python
+//   operation: loader
+// balanced:
+//   input_arguments:
+//     source_dir: "path/to/files"
+//     recursive: true
+
+// Features:
+// - Recursive/flat directory traversal
+// - SHA-256 content hashing
+// - MIME type detection (extension + magic bytes)
+// - Problematic file filtering (>50MB, binary garbage)
+// - ~5000 files/sec performance
+```
+
+### LLM Runtime (Ollama)
+```typescript
+import { LLMRuntime } from './ptr/node/llm/LLMRuntime';
+import { OllamaProvider } from './ptr/node/llm/providers/OllamaProvider';
 
-### Testing
+const provider = new OllamaProvider({ model: 'gemma3:latest' });
+const runtime = new LLMRuntime(provider);
 
-Run the test suite with:
+const result = await runtime.execute('prompt', { question: 'What is 2+2?' }, config, dir);
+```
 
+### Node.js CLI
 ```bash
-npm test
+# Run a CLM file
+npx tsx src/ptr/node/cli.ts run chapters/chapter_01_arithmetic/addition.yaml
+
+# Check runtime status
+npx tsx src/ptr/node/cli.ts status
+
+# List available CLM files
+npx tsx src/ptr/node/cli.ts list
+```
+
+## Vector Search (sqlite-vec)
+
+The `MCardVectorStore` provides semantic search using the sqlite-vec extension:
+
+```typescript
+import { MCardVectorStore } from './storage/VectorStore';
+
+// Initialize vector store
+const store = new MCardVectorStore('./vectors.db', {
+    embeddingModel: 'nomic-embed-text',
+    dimensions: 768,
+    ollamaBaseUrl: 'http://localhost:11434'
+});
+
+// Index content
+await store.index('abc123...', 'MCard provides content-addressable storage...');
+
+// Search similar content
+const results = await store.search('What is MCard?', 5);
+for (const result of results) {
+    console.log(`${result.hash}: ${result.score}`);
+}
+
+// Hybrid search (vector + FTS)
+const hybridResults = await store.hybridSearch('content storage', 5, 0.7);
+
+// Check if sqlite-vec is available
+console.log('Has vec extension:', store.hasVectorExtension());
+
+store.close();
+```
+
+### Features
+- **sqlite-vec extension**: Native KNN search with vec0 virtual tables
+- **Fallback mode**: Brute-force cosine similarity when extension unavailable
+- **Chunking**: Automatic text splitting with overlap
+- **Hybrid search**: Combined vector + FTS5 full-text search
+- **Ollama integration**: Embedding generation via local LLM
+
+## Recent Bug Fixes (December 2025)
+
+### SQLite Foreign Key Constraint Fix
+
+**Problem**: `clearSync()` was deleting tables in wrong order, causing `SQLITE_CONSTRAINT_FOREIGNKEY` errors.
+
+**Solution**: Delete child tables before parent tables:
+```typescript
+clearSync(): void {
+    // FK-safe order: children first, then parents
+    this.db.exec('DELETE FROM handle_history');   // ✓ Child
+    this.db.exec('DELETE FROM handle_registry');  // ✓ Child
+    this.db.exec('DELETE FROM card');             // ✓ Parent
+}
 ```
 
-### Building
+**Impact**: All 117 tests pass ✅
+
+### CLMRunner Recursive Runtime Fix
+
+**Problem**: Test mocks for recursive runtime execution weren't wiring correctly due to Vitest module path resolution.
+
+**Solution**: Verified `executeRecursive()` implementation correctly calls `this.loader.load()` for meta CLM files.
+
+**Impact**: Both CLMRunner tests pass ✅
+
+## Development
 
 ```bash
+# Install dependencies
+npm install
+
+# Run tests (Vitest)
+npm test
+
+# Run tests in watch mode
+npm run test:watch
+
+# Type checking
+npx tsc --noEmit
+
+# Build
 npm run build
 ```
 
+## Project Structure
+
+```
+mcard-js/
+├── src/
+│   ├── model/
+│   │   ├── MCard.ts          # Core MCard implementation
+│   │   ├── Handle.ts         # Handle validation & normalization
+│   │   └── GTime.ts          # Global time ordering
+│   ├── storage/
+│   │   ├── StorageAdapter.ts # Storage interface
+│   │   ├── SqliteNodeEngine.ts # Node.js SQLite (better-sqlite3)
+│   │   ├── IndexedDBEngine.ts  # Browser IndexedDB
+│   │   └── SqliteWasmEngine.ts # Browser SQLite (sql.js)
+│   ├── ptr/
+│   │   └── node/
+│   │       ├── CLMLoader.ts   # YAML CLM parser
+│   │       ├── CLMRunner.ts   # CLM execution engine
+│   │       ├── Runtimes.ts    # Polyglot runtime factory
+│   │       ├── cli.ts         # Node.js CLI
+│   │       └── llm/           # LLM runtime (Ollama)
+│   ├── hash/
+│   │   └── HashValidator.ts   # SHA-256 validation
+│   └── monads/
+│       └── Monads.ts          # Maybe, Either, IO
+├── tests/
+│   ├── storage/
+│   │   └── SqliteNodeEngine.test.ts
+│   ├── ptr/
+│   │   ├── CLMLoader.test.ts
+│   │   └── CLMRunner.test.ts
+│   └── ...
+└── package.json
+```
+
 ## License
 
-MIT
+MIT
+

package/dist/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/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/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/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/index.d.ts

@@ -0,0 +1,21 @@
+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';
+//# sourceMappingURL=index.d.ts.map

package/dist/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"}

package/dist/index.js

@@ -1,10 +1,26 @@
-// mcard - Monadic Card Library
-
-// Placeholder for your library's main functionality
-function exampleFunction() {
-  console.log('mcard library is ready!');
-}
-module.exports = {
-  exampleFunction
-};
+// 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';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["exampleFunction","console","log","module","exports"],"sources":["../src/index.js"],"sourcesContent":["// mcard - Monadic Card Library\n\n// Placeholder for your library's main functionality\nfunction exampleFunction() {\n  console.log('mcard library is ready!');\n}\n\nmodule.exports = {\n  exampleFunction\n};"],"mappings":"AAAA;;AAEA;AACA,SAASA,eAAeA,CAAA,EAAG;EACzBC,OAAO,CAACC,GAAG,CAAC,yBAAyB,CAAC;AACxC;AAEAC,MAAM,CAACC,OAAO,GAAG;EACfJ;AACF,CAAC","ignoreList":[]}
+{"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"}