@framers/sql-storage-adapter 0.5.3 → 0.6.1

package/README.md

@@ -19,7 +19,7 @@
 
 The SQL Storage Adapter provides a single, ergonomic interface over SQLite (native and WASM), PostgreSQL, Capacitor, IndexedDB, and in-memory stores. It handles adapter discovery, capability detection, and advanced features like cloud backups so you can focus on your application logic.
 
-**🆕 NEW in v0.5.1:** Electron adapter with IPC bridge + Cross-platform real-time sync!
+**🆕 NEW in v0.6.0:** SQL Dialect abstractions for SQLite/Postgres parity + Cross-platform BLOB codec + Full-text search interface!
 
 ---
 
@@ -31,6 +31,7 @@ The SQL Storage Adapter provides a single, ergonomic interface over SQLite (nati
 - [Cross-Platform Sync](#cross-platform-sync)
 - [Configuration & Resolution](#configuration--resolution)
 - [Platform Strategy](#platform-strategy)
+- [SQL Dialect & Feature Abstractions](#sql-dialect--feature-abstractions)
 - [CI, Releases, and Badges](#ci-releases-and-badges)
 - [Contributing](#contributing)
 - [License](#license)
@@ -48,6 +49,10 @@ The SQL Storage Adapter provides a single, ergonomic interface over SQLite (nati
 - **Portable packaging** – optional native dependencies; falls back to pure TypeScript/WASM adapters when native modules are unavailable.
 - **Browser-friendly** – Dynamic imports prevent bundlers from including server-only dependencies (`pg`, `path`) in browser builds.
 - **Mobile/Offline Parity** – Same APIs work across desktop, mobile (Capacitor), and browser with automatic sync support.
+- **🆕 SQL Dialect** – Write cross-platform SQL with `SqlDialect` interface. Automatically translates `INSERT OR IGNORE`, `json_extract`, `ifnull`, `PRAGMA` between SQLite and PostgreSQL.
+- **🆕 Full-Text Search** – `IFullTextSearch` interface abstracts FTS5 (SQLite) and tsvector/GIN (PostgreSQL) with unified `createIndex`, `matchClause`, `rankExpression`, and `rebuildCommand` APIs.
+- **🆕 BLOB Codec** – `IBlobCodec` for cross-platform binary vector storage. `NodeBlobCodec` (Buffer) for server, `BrowserBlobCodec` (DataView) for web.
+- **🆕 Database Export** – `IDatabaseExporter` with `SqliteFileExporter` (VACUUM INTO) and `PostgresExporter` (pg_dump).
 - **CI-first design** – Vitest coverage, Codecov integration, and GitHub Actions workflows for linting, testing, releasing, and npm publish/tag automation.
 
 ## Installation
@@ -398,6 +403,101 @@ const db = await createDatabase({
 
 See [**guides/OPTIMIZATION_GUIDE.md**](./guides/OPTIMIZATION_GUIDE.md) for complete configuration options.
 
+## SQL Dialect & Feature Abstractions
+
+Write cross-platform SQL that works on both SQLite and PostgreSQL without changing your application code.
+
+### StorageFeatures Factory
+
+```typescript
+import { resolveStorageAdapter, createStorageFeatures } from '@framers/sql-storage-adapter';
+
+const adapter = await resolveStorageAdapter({ filePath: './app.db' });
+const features = createStorageFeatures(adapter);
+// features.dialect  → SqliteDialect or PostgresDialect
+// features.fts      → SqliteFts5 or PostgresFts
+// features.blobCodec → NodeBlobCodec or BrowserBlobCodec
+// features.exporter → SqliteFileExporter or PostgresExporter
+```
+
+### SqlDialect — Cross-Platform SQL
+
+```typescript
+const { dialect } = features;
+
+// INSERT OR IGNORE (SQLite) → ON CONFLICT DO NOTHING (Postgres)
+const sql = dialect.insertOrIgnore('users', ['id', 'name'], ['?', '?']);
+
+// INSERT OR REPLACE (SQLite) → ON CONFLICT DO UPDATE (Postgres)
+const upsert = dialect.insertOrReplace('users', ['id', 'name'], ['?', '?'], 'id');
+
+// json_extract(col, '$.key') (SQLite) → (col::jsonb)->>'key' (Postgres)
+const expr = dialect.jsonExtract('metadata', '$.theme');
+
+// ifnull(expr, fallback) (SQLite) → COALESCE(expr, fallback) (Postgres)
+const safe = dialect.ifnull(dialect.jsonExtract('config', '$.lang'), "'en'");
+
+// PRAGMA (SQLite) → null/no-op (Postgres)
+const pragma = dialect.pragma('journal_mode', 'WAL');
+if (pragma) await adapter.exec(pragma);
+```
+
+### IFullTextSearch — FTS5 & tsvector
+
+```typescript
+const { fts } = features;
+
+// Create index: FTS5 virtual table (SQLite) or tsvector + GIN (Postgres)
+await adapter.exec(fts.createIndex({
+  table: 'docs_fts',
+  columns: ['title', 'body'],
+  contentTable: 'documents',
+  tokenizer: 'porter ascii',
+}));
+
+// Search query
+const sql = `
+  SELECT t.*
+  FROM ${fts.joinClause('documents', 't', 'fts', 'docs_fts')}
+  WHERE ${fts.matchClause('docs_fts', '?')}
+  ORDER BY ${fts.rankExpression('fts')}
+`;
+
+// Rebuild index
+await adapter.exec(fts.rebuildCommand('docs_fts'));
+```
+
+### IBlobCodec — Cross-Platform Binary Encoding
+
+```typescript
+const { blobCodec } = features;
+
+// Encode a float vector for storage
+const blob = blobCodec.encode([0.1, 0.2, -0.5, 1.0]);
+await adapter.run('INSERT INTO embeddings (vec) VALUES (?)', [blob]);
+
+// Decode a stored vector
+const row = await adapter.get<{ vec: Uint8Array }>('SELECT vec FROM embeddings WHERE id = ?', [id]);
+const vector = blobCodec.decode(row!.vec);
+
+// Cross-platform SHA-256
+const hash = await blobCodec.sha256('content to hash');
+```
+
+### IDatabaseExporter — Portable Backups
+
+```typescript
+const { exporter } = features;
+
+// Export to file (VACUUM INTO on SQLite, pg_dump on Postgres)
+await exporter.exportToFile('/backups/snapshot.db');
+
+// Export to bytes (for browser download or cloud upload)
+const bytes = await exporter.exportToBytes();
+```
+
+On Postgres, `features.exporter` requires a Node runtime plus an adapter that was created with a connection string in `adapter.options.connectionString`, since `pg_dump` runs out-of-process.
+
 ## CI, Releases, and Badges
 
 - GitHub Actions workflows:

package/dist/adapters/betterSqliteAdapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"betterSqliteAdapter.d.ts","sourceRoot":"","sources":["../../src/adapters/betterSqliteAdapter.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAiDjK;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH;;;;;;;;;;;GAWG;AACH,qBAAa,mBAAoB,YAAW,cAAc;IAsB5C,OAAO,CAAC,QAAQ,CAAC,eAAe;IArB5C,SAAgB,IAAI,oBAAoB;IACxC,SAAgB,YAAY,EAAE,WAAW,CAAC,iBAAiB,CAAC,CAQzD;IAEH,OAAO,CAAC,MAAM,CAAmC;IACjD,OAAO,CAAC,EAAE,CAAqC;IAC/C,OAAO,CAAC,kBAAkB,CAA4C;IAEtE;;;;;OAKG;gBAC0B,eAAe,EAAE,MAAM;IAEpD;;;;OAIG;IACU,IAAI,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAgCjD,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAOjF,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAOtF,GAAG,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;IAOvE,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKnC,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAenE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IASnC;;;;;;;;OAQG;IACU,KAAK,CAAC,UAAU,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC,WAAW,CAAC;IA+CtE,OAAO,CAAC,eAAe;IAWvB,OAAO,CAAC,UAAU;CAKnB;AAED;;GAEG;AACH;;;;;;;;GAQG;AACH,eAAO,MAAM,yBAAyB,aAAc,MAAM,KAAG,cAQ5D,CAAC"}
+{"version":3,"file":"betterSqliteAdapter.d.ts","sourceRoot":"","sources":["../../src/adapters/betterSqliteAdapter.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAiDjK;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH;;;;;;;;;;;GAWG;AACH,qBAAa,mBAAoB,YAAW,cAAc;IAsB5C,OAAO,CAAC,QAAQ,CAAC,eAAe;IArB5C,SAAgB,IAAI,oBAAoB;IACxC,SAAgB,YAAY,EAAE,WAAW,CAAC,iBAAiB,CAAC,CAQzD;IAEH,OAAO,CAAC,MAAM,CAAmC;IACjD,OAAO,CAAC,EAAE,CAAqC;IAC/C,OAAO,CAAC,kBAAkB,CAA4C;IAEtE;;;;;OAKG;gBAC0B,eAAe,EAAE,MAAM;IAEpD;;;;OAIG;IACU,IAAI,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAgCjD,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAOjF,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAOtF,GAAG,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;IAOvE,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKnC,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAenE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IASnC;;;;;;;;OAQG;IACU,KAAK,CAAC,UAAU,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC,WAAW,CAAC;IA+CtE,OAAO,CAAC,eAAe;IAWvB,OAAO,CAAC,UAAU;CAKnB;AAED;;GAEG;AACH;;;;;;;;GAQG;AACH,eAAO,MAAM,yBAAyB,GAAI,UAAU,MAAM,KAAG,cAQ5D,CAAC"}

package/dist/adapters/capacitorSqliteAdapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"capacitorSqliteAdapter.d.ts","sourceRoot":"","sources":["../../src/adapters/capacitorSqliteAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,gBAAgB,EACjB,MAAM,mBAAmB,CAAC;AAK3B,MAAM,WAAW,uBAAuB;IACtC;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAuCD;;GAEG;AACH,qBAAa,sBAAuB,YAAW,cAAc;IAa/C,OAAO,CAAC,QAAQ,CAAC,OAAO;IAZpC,SAAgB,IAAI,sBAAsB;IAC1C,SAAgB,YAAY,EAAE,WAAW,CAAC,iBAAiB,CAAC,CAKzD;IAEH,OAAO,CAAC,MAAM,CAAsC;IACpD,OAAO,CAAC,UAAU,CAAmC;IACrD,OAAO,CAAC,MAAM,CAAS;gBAEM,OAAO,GAAE,uBAA4B;IAIrD,IAAI,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IA2BjD,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAOjF,GAAG,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAK5E,GAAG,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;IAOvE,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKnC,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAanE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAOnC,OAAO,CAAC,gBAAgB;CAMzB;AAED,eAAO,MAAM,4BAA4B,aAAc,uBAAuB,KAAG,cAC5C,CAAC"}
+{"version":3,"file":"capacitorSqliteAdapter.d.ts","sourceRoot":"","sources":["../../src/adapters/capacitorSqliteAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,gBAAgB,EACjB,MAAM,mBAAmB,CAAC;AAK3B,MAAM,WAAW,uBAAuB;IACtC;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAuCD;;GAEG;AACH,qBAAa,sBAAuB,YAAW,cAAc;IAa/C,OAAO,CAAC,QAAQ,CAAC,OAAO;IAZpC,SAAgB,IAAI,sBAAsB;IAC1C,SAAgB,YAAY,EAAE,WAAW,CAAC,iBAAiB,CAAC,CAKzD;IAEH,OAAO,CAAC,MAAM,CAAsC;IACpD,OAAO,CAAC,UAAU,CAAmC;IACrD,OAAO,CAAC,MAAM,CAAS;gBAEM,OAAO,GAAE,uBAA4B;IAIrD,IAAI,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IA2BjD,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAOjF,GAAG,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAK5E,GAAG,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;IAOvE,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKnC,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAanE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAOnC,OAAO,CAAC,gBAAgB;CAMzB;AAED,eAAO,MAAM,4BAA4B,GAAI,UAAU,uBAAuB,KAAG,cAC5C,CAAC"}

package/dist/adapters/electron/preload.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"preload.d.ts","sourceRoot":"","sources":["../../../src/adapters/electron/preload.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAIH,OAAO,KAAK,EAOV,kBAAkB,EAElB,UAAU,EACV,aAAa,EACd,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EACV,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,EACjB,cAAc,EACd,WAAW,EACX,iBAAiB,EAClB,MAAM,sBAAsB,CAAC;AA4C9B;;GAEG;AACH,QAAA,MAAM,aAAa;IAKjB;;OAEG;mBACkB,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAKvD;;OAEG;aACY,OAAO,CAAC,IAAI,CAAC;IAI5B;;OAEG;cACa,OAAO,CAAC,OAAO,CAAC;IAIhC;;OAEG;uBACsB,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAIrD;;OAEG;mBACkB,MAAM,eAAe,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAKvF;;OAEG;QACO,CAAC,uBAAuB,MAAM,eAAe,iBAAiB,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAK5F;;OAEG;QACO,CAAC,uBAAuB,MAAM,eAAe,iBAAiB,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;IAKvF;;OAEG;iBACgB,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKzC;;OAEG;sBACqB,cAAc,EAAE,GAAG,OAAO,CAAC,WAAW,CAAC;IAS/D;;OAEG;wBACuB,OAAO,CAAC,kBAAkB,CAAC;IAIrD;;OAEG;qCACoC,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7D;;OAEG;uCACsC,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI/D;;OAEG;wCAEc,MAAM,aACV,MAAM,eACJ,iBAAiB,GAC7B,OAAO,CAAC,gBAAgB,GAAG,OAAO,EAAE,CAAC;IAQxC;;;OAGG;gBACe,CAAC,MACb,CAAC,GAAG,EAAE;QACR,GAAG,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,iBAAiB,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAC;QACtF,GAAG,EAAE,CAAC,CAAW,GAAP,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,iBAAiB,KAAK,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;QAC3F,GAAG,EAAE,CAAC,CAAW,GAAP,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,iBAAiB,KAAK,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;KACvF,KAAK,OAAO,CAAC,CAAC,CAAC,GACf,OAAO,CAAC,CAAC,CAAC;IAkCb;;OAEG;qBACoB,OAAO,CAAC,UAAU,CAAC;IAI1C;;OAEG;mBACkB,OAAO,CAAC,IAAI,CAAC;IAQlC;;OAEG;+BACwB,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,GAAG,MAAM,IAAI;IAQtE;;OAEG;6BACsB,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,GAAG,MAAM,IAAI;IAQhE;;OAEG;6BACsB,MAAM,IAAI,GAAG,MAAM,IAAI;IAMhD;;OAEG;0BACmB,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,MAAM,IAAI;CAO1D,CAAC;AAMF;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,OAAO,aAAa,CAAC;AAQjD,OAAO,EAAE,aAAa,EAAE,CAAC;AAMzB,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,UAAU,EAAE,aAAa,CAAC;KAC3B;CACF"}
+{"version":3,"file":"preload.d.ts","sourceRoot":"","sources":["../../../src/adapters/electron/preload.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAIH,OAAO,KAAK,EAOV,kBAAkB,EAElB,UAAU,EACV,aAAa,EACd,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EACV,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,EACjB,cAAc,EACd,WAAW,EACX,iBAAiB,EAClB,MAAM,sBAAsB,CAAC;AA4C9B;;GAEG;AACH,QAAA,MAAM,aAAa;IAKjB;;OAEG;mBACkB,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAKvD;;OAEG;aACY,OAAO,CAAC,IAAI,CAAC;IAI5B;;OAEG;cACa,OAAO,CAAC,OAAO,CAAC;IAIhC;;OAEG;uBACsB,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAIrD;;OAEG;mBACkB,MAAM,eAAe,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAKvF;;OAEG;QACO,CAAC,uBAAuB,MAAM,eAAe,iBAAiB,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAK5F;;OAEG;QACO,CAAC,uBAAuB,MAAM,eAAe,iBAAiB,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;IAKvF;;OAEG;iBACgB,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKzC;;OAEG;sBACqB,cAAc,EAAE,GAAG,OAAO,CAAC,WAAW,CAAC;IAS/D;;OAEG;wBACuB,OAAO,CAAC,kBAAkB,CAAC;IAIrD;;OAEG;qCACoC,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7D;;OAEG;uCACsC,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI/D;;OAEG;wCAEc,MAAM,aACV,MAAM,eACJ,iBAAiB,GAC7B,OAAO,CAAC,gBAAgB,GAAG,OAAO,EAAE,CAAC;IAQxC;;;OAGG;gBACe,CAAC,MACb,CAAC,GAAG,EAAE;QACR,GAAG,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,iBAAiB,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAC;QACtF,GAAG,EAAE,CAAC,CAAC,GAAG,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,iBAAiB,KAAK,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;QAC3F,GAAG,EAAE,CAAC,CAAC,GAAG,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,iBAAiB,KAAK,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;KACvF,KAAK,OAAO,CAAC,CAAC,CAAC,GACf,OAAO,CAAC,CAAC,CAAC;IAkCb;;OAEG;qBACoB,OAAO,CAAC,UAAU,CAAC;IAI1C;;OAEG;mBACkB,OAAO,CAAC,IAAI,CAAC;IAQlC;;OAEG;+BACwB,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,GAAG,MAAM,IAAI;IAQtE;;OAEG;6BACsB,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,GAAG,MAAM,IAAI;IAQhE;;OAEG;6BACsB,MAAM,IAAI,GAAG,MAAM,IAAI;IAMhD;;OAEG;0BACmB,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,MAAM,IAAI;CAO1D,CAAC;AAMF;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,OAAO,aAAa,CAAC;AAQjD,OAAO,EAAE,aAAa,EAAE,CAAC;AAMzB,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,UAAU,EAAE,aAAa,CAAC;KAC3B;CACF"}

package/dist/adapters/sqlJsAdapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sqlJsAdapter.d.ts","sourceRoot":"","sources":["../../src/adapters/sqlJsAdapter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAe,WAAW,EAA6B,MAAM,QAAQ,CAAC;AAGlF,OAAO,KAAK,EAAE,cAAc,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAGpI,KAAK,mBAAmB,GAAG,WAAW,CAAC;AAqCvC;;GAEG;AACH,qBAAa,YAAa,YAAW,cAAc;IAQrC,OAAO,CAAC,QAAQ,CAAC,cAAc;IAP3C,SAAgB,IAAI,WAAW;IAC/B,SAAgB,YAAY,EAAE,WAAW,CAAC,iBAAiB,CAAC,CAAC;IAE7D,OAAO,CAAC,GAAG,CAA4B;IACvC,OAAO,CAAC,EAAE,CAA8B;IACxC,OAAO,CAAC,QAAQ,CAAC,CAAS;gBAEG,cAAc,GAAE,mBAAwB;IAQxD,IAAI,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBjD,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAsBjF,GAAG,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAK5E,GAAG,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;IAwBvE,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMnC,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAcnE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAQnC,OAAO,CAAC,eAAe;IAKvB,OAAO,CAAC,UAAU;YAMJ,eAAe;CAW9B;AAED,eAAO,MAAM,kBAAkB,aAAc,mBAAmB,KAAG,cAA2C,CAAC"}
+{"version":3,"file":"sqlJsAdapter.d.ts","sourceRoot":"","sources":["../../src/adapters/sqlJsAdapter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAe,WAAW,EAA6B,MAAM,QAAQ,CAAC;AAGlF,OAAO,KAAK,EAAE,cAAc,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAGpI,KAAK,mBAAmB,GAAG,WAAW,CAAC;AAqCvC;;GAEG;AACH,qBAAa,YAAa,YAAW,cAAc;IAQrC,OAAO,CAAC,QAAQ,CAAC,cAAc;IAP3C,SAAgB,IAAI,WAAW;IAC/B,SAAgB,YAAY,EAAE,WAAW,CAAC,iBAAiB,CAAC,CAAC;IAE7D,OAAO,CAAC,GAAG,CAA4B;IACvC,OAAO,CAAC,EAAE,CAA8B;IACxC,OAAO,CAAC,QAAQ,CAAC,CAAS;gBAEG,cAAc,GAAE,mBAAwB;IAQxD,IAAI,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBjD,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAsBjF,GAAG,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAK5E,GAAG,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;IAwBvE,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMnC,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAcnE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAQnC,OAAO,CAAC,eAAe;IAKvB,OAAO,CAAC,UAAU;YAMJ,eAAe;CAW9B;AAED,eAAO,MAAM,kBAAkB,GAAI,UAAU,mBAAmB,KAAG,cAA2C,CAAC"}

package/dist/codecs/BrowserBlobCodec.d.ts

@@ -0,0 +1,14 @@
+import type { IBlobCodec } from '../core/contracts/blobCodec.js';
+/**
+ * Browser-compatible BLOB codec using typed arrays.
+ *
+ * Encodes number[] vectors as Float32Array binary BLOBs and computes
+ * SHA-256 hashes via `crypto.subtle` (with a Node.js fallback for
+ * test environments where SubtleCrypto may not be available).
+ */
+export declare class BrowserBlobCodec implements IBlobCodec {
+    encode(vec: number[]): Uint8Array;
+    decode(blob: Uint8Array | ArrayBufferLike): number[];
+    sha256(input: string): Promise<string>;
+}
+//# sourceMappingURL=BrowserBlobCodec.d.ts.map

package/dist/codecs/BrowserBlobCodec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BrowserBlobCodec.d.ts","sourceRoot":"","sources":["../../src/codecs/BrowserBlobCodec.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AAEjE;;;;;;GAMG;AACH,qBAAa,gBAAiB,YAAW,UAAU;IACjD,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,UAAU;IAKjC,MAAM,CAAC,IAAI,EAAE,UAAU,GAAG,eAAe,GAAG,MAAM,EAAE;IAU9C,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAW7C"}

package/dist/codecs/BrowserBlobCodec.js

@@ -0,0 +1,30 @@
+/**
+ * Browser-compatible BLOB codec using typed arrays.
+ *
+ * Encodes number[] vectors as Float32Array binary BLOBs and computes
+ * SHA-256 hashes via `crypto.subtle` (with a Node.js fallback for
+ * test environments where SubtleCrypto may not be available).
+ */
+export class BrowserBlobCodec {
+    encode(vec) {
+        const f32 = new Float32Array(vec);
+        return new Uint8Array(f32.buffer);
+    }
+    decode(blob) {
+        const bytes = blob instanceof Uint8Array ? blob : new Uint8Array(blob);
+        const f32 = new Float32Array(bytes.buffer, bytes.byteOffset, bytes.byteLength / 4);
+        return Array.from(f32);
+    }
+    async sha256(input) {
+        if (typeof globalThis.crypto?.subtle?.digest === 'function') {
+            const encoded = new TextEncoder().encode(input);
+            const hashBuffer = await globalThis.crypto.subtle.digest('SHA-256', encoded);
+            const hashArray = new Uint8Array(hashBuffer);
+            return Array.from(hashArray).map((b) => b.toString(16).padStart(2, '0')).join('');
+        }
+        // Fallback for Node.js test environments
+        const { createHash } = await import('node:crypto');
+        return createHash('sha256').update(input, 'utf8').digest('hex');
+    }
+}
+//# sourceMappingURL=BrowserBlobCodec.js.map

package/dist/codecs/BrowserBlobCodec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BrowserBlobCodec.js","sourceRoot":"","sources":["../../src/codecs/BrowserBlobCodec.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,MAAM,OAAO,gBAAgB;IAC3B,MAAM,CAAC,GAAa;QAClB,MAAM,GAAG,GAAG,IAAI,YAAY,CAAC,GAAG,CAAC,CAAC;QAClC,OAAO,IAAI,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACpC,CAAC;IAED,MAAM,CAAC,IAAkC;QACvC,MAAM,KAAK,GAAG,IAAI,YAAY,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC;QACvE,MAAM,GAAG,GAAG,IAAI,YAAY,CAC1B,KAAK,CAAC,MAAM,EACZ,KAAK,CAAC,UAAU,EAChB,KAAK,CAAC,UAAU,GAAG,CAAC,CACrB,CAAC;QACF,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACzB,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,KAAa;QACxB,IAAI,OAAO,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,UAAU,EAAE,CAAC;YAC5D,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAChD,MAAM,UAAU,GAAG,MAAM,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;YAC7E,MAAM,SAAS,GAAG,IAAI,UAAU,CAAC,UAAU,CAAC,CAAC;YAC7C,OAAO,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACpF,CAAC;QACD,yCAAyC;QACzC,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;QACnD,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAClE,CAAC;CACF"}

package/dist/codecs/NodeBlobCodec.d.ts

@@ -0,0 +1,14 @@
+import type { IBlobCodec } from '../core/contracts/blobCodec.js';
+/**
+ * Node.js Buffer-based BLOB codec.
+ *
+ * Encodes number[] vectors as Float32 little-endian binary BLOBs using
+ * `Buffer.writeFloatLE` / `Buffer.readFloatLE`, and computes SHA-256
+ * hashes using the `node:crypto` module.
+ */
+export declare class NodeBlobCodec implements IBlobCodec {
+    encode(vec: number[]): Uint8Array;
+    decode(blob: Uint8Array | ArrayBufferLike): number[];
+    sha256(input: string): Promise<string>;
+}
+//# sourceMappingURL=NodeBlobCodec.d.ts.map

package/dist/codecs/NodeBlobCodec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NodeBlobCodec.d.ts","sourceRoot":"","sources":["../../src/codecs/NodeBlobCodec.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AAEjE;;;;;;GAMG;AACH,qBAAa,aAAc,YAAW,UAAU;IAC9C,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,UAAU;IAQjC,MAAM,CAAC,IAAI,EAAE,UAAU,GAAG,eAAe,GAAG,MAAM,EAAE;IAW9C,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAG7C"}

package/dist/codecs/NodeBlobCodec.js

@@ -0,0 +1,31 @@
+import crypto from 'node:crypto';
+/**
+ * Node.js Buffer-based BLOB codec.
+ *
+ * Encodes number[] vectors as Float32 little-endian binary BLOBs using
+ * `Buffer.writeFloatLE` / `Buffer.readFloatLE`, and computes SHA-256
+ * hashes using the `node:crypto` module.
+ */
+export class NodeBlobCodec {
+    encode(vec) {
+        const buf = Buffer.alloc(vec.length * 4);
+        for (let i = 0; i < vec.length; i++) {
+            buf.writeFloatLE(vec[i], i * 4);
+        }
+        return new Uint8Array(buf.buffer, buf.byteOffset, buf.byteLength);
+    }
+    decode(blob) {
+        const bytes = blob instanceof Uint8Array ? blob : new Uint8Array(blob);
+        const buf = Buffer.from(bytes.buffer, bytes.byteOffset, bytes.byteLength);
+        const count = buf.length / 4;
+        const vec = new Array(count);
+        for (let i = 0; i < count; i++) {
+            vec[i] = buf.readFloatLE(i * 4);
+        }
+        return vec;
+    }
+    async sha256(input) {
+        return crypto.createHash('sha256').update(input, 'utf8').digest('hex');
+    }
+}
+//# sourceMappingURL=NodeBlobCodec.js.map

package/dist/codecs/NodeBlobCodec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NodeBlobCodec.js","sourceRoot":"","sources":["../../src/codecs/NodeBlobCodec.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,aAAa,CAAC;AAGjC;;;;;;GAMG;AACH,MAAM,OAAO,aAAa;IACxB,MAAM,CAAC,GAAa;QAClB,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QACzC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACpC,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAE,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;QACnC,CAAC;QACD,OAAO,IAAI,UAAU,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,UAAU,EAAE,GAAG,CAAC,UAAU,CAAC,CAAC;IACpE,CAAC;IAED,MAAM,CAAC,IAAkC;QACvC,MAAM,KAAK,GAAG,IAAI,YAAY,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC;QACvE,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;QAC1E,MAAM,KAAK,GAAG,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC;QAC7B,MAAM,GAAG,GAAa,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC;QACvC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC;YAC/B,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAClC,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,KAAa;QACxB,OAAO,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACzE,CAAC;CACF"}

package/dist/core/contracts/blobCodec.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Binary BLOB codec for encoding/decoding vectors and computing hashes.
+ *
+ * Node.js implementations use Buffer.
+ * Browser implementations use Uint8Array + DataView.
+ */
+export interface IBlobCodec {
+    /** Encode a number[] vector to a binary BLOB value (Float32 little-endian). */
+    encode(vec: number[]): Uint8Array;
+    /** Decode a BLOB column value back to number[]. */
+    decode(blob: Uint8Array | ArrayBufferLike): number[];
+    /** SHA-256 hex digest. Async to support crypto.subtle in browsers. */
+    sha256(input: string): Promise<string>;
+}
+//# sourceMappingURL=blobCodec.d.ts.map

package/dist/core/contracts/blobCodec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blobCodec.d.ts","sourceRoot":"","sources":["../../../src/core/contracts/blobCodec.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,UAAU;IACzB,+EAA+E;IAC/E,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC;IAElC,mDAAmD;IACnD,MAAM,CAAC,IAAI,EAAE,UAAU,GAAG,eAAe,GAAG,MAAM,EAAE,CAAC;IAErD,sEAAsE;IACtE,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACxC"}

package/dist/core/contracts/blobCodec.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=blobCodec.js.map

package/dist/core/contracts/blobCodec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"blobCodec.js","sourceRoot":"","sources":["../../../src/core/contracts/blobCodec.ts"],"names":[],"mappings":""}

package/dist/core/contracts/dialect.d.ts

@@ -0,0 +1,55 @@
+/**
+ * SQL dialect abstraction for cross-platform SQL generation.
+ *
+ * Each method returns a SQL string fragment or full statement.
+ * Implementations are pure string transformers — no database calls.
+ */
+export interface SqlDialect {
+    /** Dialect identifier. */
+    readonly name: 'sqlite' | 'postgres';
+    /**
+     * Generate an INSERT OR IGNORE statement.
+     * SQLite: `INSERT OR IGNORE INTO t (a, b) VALUES (?, ?)`
+     * Postgres: `INSERT INTO t (a, b) VALUES ($1, $2) ON CONFLICT DO NOTHING`
+     */
+    insertOrIgnore(table: string, columns: string[], placeholders: string[]): string;
+    /**
+     * Generate an INSERT OR REPLACE (upsert) statement.
+     * SQLite: `INSERT OR REPLACE INTO t (a, b) VALUES (?, ?)`
+     * Postgres: `INSERT INTO t (a, b) VALUES ($1, $2) ON CONFLICT (pk) DO UPDATE SET ...`
+     *
+     * @param primaryKey - Required for Postgres ON CONFLICT clause. Defaults to first column.
+     */
+    insertOrReplace(table: string, columns: string[], placeholders: string[], primaryKey?: string): string;
+    /**
+     * Generate a JSON field extraction expression.
+     * SQLite: `json_extract(col, '$.key')`
+     * Postgres: `(col::jsonb)->>'key'`
+     */
+    jsonExtract(column: string, jsonPath: string): string;
+    /**
+     * Generate a null-coalesce expression.
+     * SQLite: `ifnull(expr, fallback)`
+     * Postgres: `COALESCE(expr, fallback)`
+     */
+    ifnull(expr: string, fallback: string): string;
+    /**
+     * Column definition for an auto-incrementing integer primary key.
+     * SQLite: `INTEGER PRIMARY KEY AUTOINCREMENT`
+     * Postgres: `INTEGER GENERATED ALWAYS AS IDENTITY PRIMARY KEY`
+     */
+    autoIncrementPrimaryKey(): string;
+    /**
+     * Generate a PRAGMA statement or equivalent.
+     * SQLite: `PRAGMA key = value`
+     * Postgres: returns null (skip — Postgres enforces FKs by default, etc.)
+     */
+    pragma(key: string, value: string): string | null;
+    /**
+     * Parameter placeholder for the given 0-based index.
+     * SQLite: `?`
+     * Postgres: `$1`, `$2`, etc.
+     */
+    placeholder(index: number): string;
+}
+//# sourceMappingURL=dialect.d.ts.map

package/dist/core/contracts/dialect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dialect.d.ts","sourceRoot":"","sources":["../../../src/core/contracts/dialect.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,UAAU;IACzB,0BAA0B;IAC1B,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,UAAU,CAAC;IAErC;;;;OAIG;IACH,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,YAAY,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;IAEjF;;;;;;OAMG;IACH,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,YAAY,EAAE,MAAM,EAAE,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAEvG;;;;OAIG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC;IAEtD;;;;OAIG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC;IAE/C;;;;OAIG;IACH,uBAAuB,IAAI,MAAM,CAAC;IAElC;;;;OAIG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAElD;;;;OAIG;IACH,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;CACpC"}

package/dist/core/contracts/dialect.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=dialect.js.map

package/dist/core/contracts/dialect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dialect.js","sourceRoot":"","sources":["../../../src/core/contracts/dialect.ts"],"names":[],"mappings":""}

package/dist/core/contracts/exporter.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Database export abstraction.
+ *
+ * SQLite: VACUUM INTO or db.export().
+ * Postgres: pg_dump via child_process.
+ */
+export interface IDatabaseExporter {
+    /** Export the full database to a file at the given path. */
+    exportToFile(outputPath: string): Promise<void>;
+    /** Export the full database as raw bytes. */
+    exportToBytes(): Promise<Uint8Array>;
+}
+//# sourceMappingURL=exporter.d.ts.map

package/dist/core/contracts/exporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exporter.d.ts","sourceRoot":"","sources":["../../../src/core/contracts/exporter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,4DAA4D;IAC5D,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEhD,6CAA6C;IAC7C,aAAa,IAAI,OAAO,CAAC,UAAU,CAAC,CAAC;CACtC"}

package/dist/core/contracts/exporter.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=exporter.js.map

package/dist/core/contracts/exporter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exporter.js","sourceRoot":"","sources":["../../../src/core/contracts/exporter.ts"],"names":[],"mappings":""}

package/dist/core/contracts/features.d.ts

@@ -0,0 +1,25 @@
+import type { SqlDialect } from './dialect.js';
+import type { IFullTextSearch } from './fts.js';
+import type { IBlobCodec } from './blobCodec.js';
+import type { IDatabaseExporter } from './exporter.js';
+import type { StorageAdapter } from './index.js';
+/**
+ * Bundle of platform-aware database features.
+ *
+ * Created by `createStorageFeatures(adapter)` — consumers use this
+ * instead of writing raw platform-specific SQL.
+ */
+export interface StorageFeatures {
+    readonly dialect: SqlDialect;
+    readonly fts: IFullTextSearch;
+    readonly blobCodec: IBlobCodec;
+    readonly exporter: IDatabaseExporter;
+}
+/**
+ * Create a platform-aware feature bundle for the given storage adapter.
+ *
+ * Inspects `adapter.kind` and the runtime environment to select the right
+ * dialect, FTS, BLOB codec, and exporter implementations.
+ */
+export declare function createStorageFeatures(adapter: StorageAdapter): StorageFeatures;
+//# sourceMappingURL=features.d.ts.map

package/dist/core/contracts/features.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"features.d.ts","sourceRoot":"","sources":["../../../src/core/contracts/features.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAChD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAmCjD;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAC7B,QAAQ,CAAC,GAAG,EAAE,eAAe,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,UAAU,CAAC;IAC/B,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAC;CACtC;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,cAAc,GAAG,eAAe,CAa9E"}

package/dist/core/contracts/features.js

@@ -0,0 +1,44 @@
+import { SqliteDialect } from '../../dialects/SqliteDialect.js';
+import { PostgresDialect } from '../../dialects/PostgresDialect.js';
+import { SqliteFts5 } from '../../fts/SqliteFts5.js';
+import { PostgresFts } from '../../fts/PostgresFts.js';
+import { NodeBlobCodec } from '../../codecs/NodeBlobCodec.js';
+import { BrowserBlobCodec } from '../../codecs/BrowserBlobCodec.js';
+import { SqliteFileExporter } from '../../exporters/SqliteFileExporter.js';
+import { PostgresExporter } from '../../exporters/PostgresExporter.js';
+function extractPostgresConnectionString(adapter) {
+    const options = adapter.options;
+    if (!options)
+        return undefined;
+    if (options.connectionString)
+        return options.connectionString;
+    if (!options.database)
+        return undefined;
+    const host = options.host ?? 'localhost';
+    const port = options.port ?? 5432;
+    const user = options.user ? encodeURIComponent(options.user) : '';
+    const password = options.password ? `:${encodeURIComponent(options.password)}` : '';
+    const auth = user ? `${user}${password}@` : '';
+    const sslQuery = options.ssl ? '?sslmode=require' : '';
+    return `postgresql://${auth}${host}:${port}/${options.database}${sslQuery}`;
+}
+/**
+ * Create a platform-aware feature bundle for the given storage adapter.
+ *
+ * Inspects `adapter.kind` and the runtime environment to select the right
+ * dialect, FTS, BLOB codec, and exporter implementations.
+ */
+export function createStorageFeatures(adapter) {
+    const isPostgres = adapter.kind === 'postgres';
+    const isBrowser = typeof window !== 'undefined' && typeof window.document !== 'undefined';
+    const postgresConnectionString = isPostgres ? extractPostgresConnectionString(adapter) : undefined;
+    return {
+        dialect: isPostgres ? new PostgresDialect() : new SqliteDialect(),
+        fts: isPostgres ? new PostgresFts() : new SqliteFts5(),
+        blobCodec: isBrowser ? new BrowserBlobCodec() : new NodeBlobCodec(),
+        exporter: isPostgres
+            ? new PostgresExporter(postgresConnectionString)
+            : new SqliteFileExporter(adapter),
+    };
+}
+//# sourceMappingURL=features.js.map

package/dist/core/contracts/features.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"features.js","sourceRoot":"","sources":["../../../src/core/contracts/features.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AACpE,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACpE,OAAO,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAC3E,OAAO,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AAYvE,SAAS,+BAA+B,CAAC,OAAuB;IAC9D,MAAM,OAAO,GAAI,OAAqE,CAAC,OAAO,CAAC;IAC/F,IAAI,CAAC,OAAO;QAAE,OAAO,SAAS,CAAC;IAC/B,IAAI,OAAO,CAAC,gBAAgB;QAAE,OAAO,OAAO,CAAC,gBAAgB,CAAC;IAC9D,IAAI,CAAC,OAAO,CAAC,QAAQ;QAAE,OAAO,SAAS,CAAC;IAExC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,WAAW,CAAC;IACzC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,IAAI,CAAC;IAClC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,kBAAkB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAClE,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,kBAAkB,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACpF,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,QAAQ,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IAC/C,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,EAAE,CAAC;IACvD,OAAO,gBAAgB,IAAI,GAAG,IAAI,IAAI,IAAI,IAAI,OAAO,CAAC,QAAQ,GAAG,QAAQ,EAAE,CAAC;AAC9E,CAAC;AAeD;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAAuB;IAC3D,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,KAAK,UAAU,CAAC;IAC/C,MAAM,SAAS,GAAG,OAAO,MAAM,KAAK,WAAW,IAAI,OAAO,MAAM,CAAC,QAAQ,KAAK,WAAW,CAAC;IAC1F,MAAM,wBAAwB,GAAG,UAAU,CAAC,CAAC,CAAC,+BAA+B,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAEnG,OAAO;QACL,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,IAAI,eAAe,EAAE,CAAC,CAAC,CAAC,IAAI,aAAa,EAAE;QACjE,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC,IAAI,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI,UAAU,EAAE;QACtD,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC,IAAI,gBAAgB,EAAE,CAAC,CAAC,CAAC,IAAI,aAAa,EAAE;QACnE,QAAQ,EAAE,UAAU;YAClB,CAAC,CAAC,IAAI,gBAAgB,CAAC,wBAAwB,CAAC;YAChD,CAAC,CAAC,IAAI,kBAAkB,CAAC,OAAO,CAAC;KACpC,CAAC;AACJ,CAAC"}

package/dist/core/contracts/fts.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Full-text search abstraction.
+ *
+ * SQLite implementations use FTS5 virtual tables.
+ * Postgres implementations use tsvector columns with GIN indexes.
+ * Methods return SQL strings — no database calls.
+ */
+export interface IFullTextSearch {
+    /**
+     * Generate DDL to create the full-text search index.
+     *
+     * @param config.table - Name for the FTS index/virtual table.
+     * @param config.columns - Columns to index.
+     * @param config.contentTable - Source table (for external-content FTS5).
+     * @param config.tokenizer - Tokenizer config (e.g. 'porter ascii').
+     */
+    createIndex(config: {
+        table: string;
+        columns: string[];
+        contentTable?: string;
+        tokenizer?: string;
+    }): string;
+    /**
+     * Generate a WHERE clause fragment for full-text matching.
+     * SQLite: `memory_traces_fts MATCH ?`
+     * Postgres: `memory_traces._tsv @@ plainto_tsquery('english', $1)`
+     */
+    matchClause(indexName: string, queryPlaceholder: string): string;
+    /**
+     * Generate an ORDER BY rank expression.
+     * SQLite: `memory_traces_fts.rank`
+     * Postgres: `ts_rank(memory_traces._tsv, plainto_tsquery('english', $1))`
+     */
+    rankExpression(indexName: string, queryPlaceholder?: string): string;
+    /**
+     * Generate the rebuild/reindex command.
+     * SQLite: `INSERT INTO fts_table(fts_table) VALUES('rebuild')`
+     * Postgres: `UPDATE content_table SET _tsv = to_tsvector('english', col1 || ' ' || col2)`
+     */
+    rebuildCommand(indexName: string): string;
+    /**
+     * Generate an INSERT to sync external-content FTS after a row insert.
+     * SQLite: `INSERT INTO fts_table (rowid, col1, col2) VALUES (expr, ?, ?)`
+     * Postgres: `UPDATE content_table SET _tsv = to_tsvector(...) WHERE ...`
+     */
+    syncInsert(indexName: string, rowIdExpr: string, columns: string[]): string;
+    /**
+     * Sanitize natural-language input into a safe search query.
+     * SQLite: wraps words in quotes, strips FTS5 operators.
+     * Postgres: pass-through (plainto_tsquery handles it).
+     */
+    sanitizeQuery(input: string): string;
+    /**
+     * Generate a SELECT joining the FTS index to the content table.
+     * This handles the structural difference between FTS5 (separate virtual table
+     * joined via rowid) and Postgres (tsvector column on the content table itself).
+     *
+     * @param contentTable - The base table (e.g. 'memory_traces').
+     * @param contentAlias - Alias for the content table (e.g. 't').
+     * @param ftsAlias - Alias for the FTS table/column (e.g. 'fts').
+     * @param indexName - FTS index/virtual table name.
+     * @returns FROM/JOIN clause fragment.
+     */
+    joinClause(contentTable: string, contentAlias: string, ftsAlias: string, indexName: string): string;
+}
+//# sourceMappingURL=fts.d.ts.map

package/dist/core/contracts/fts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fts.d.ts","sourceRoot":"","sources":["../../../src/core/contracts/fts.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;;;;OAOG;IACH,WAAW,CAAC,MAAM,EAAE;QAClB,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,EAAE,CAAC;QAClB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,GAAG,MAAM,CAAC;IAEX;;;;OAIG;IACH,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,GAAG,MAAM,CAAC;IAEjE;;;;OAIG;IACH,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,gBAAgB,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAErE;;;;OAIG;IACH,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC;IAE1C;;;;OAIG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;IAE5E;;;;OAIG;IACH,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IAErC;;;;;;;;;;OAUG;IACH,UAAU,CAAC,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC;CACrG"}

package/dist/core/contracts/fts.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=fts.js.map

package/dist/core/contracts/fts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fts.js","sourceRoot":"","sources":["../../../src/core/contracts/fts.ts"],"names":[],"mappings":""}

package/dist/core/contracts/index.d.ts

@@ -242,4 +242,10 @@ export * from './performance';
  * Designed for RAG integration, analytics, and auditing.
  */
 export * from './hooks';
+export type { SqlDialect } from './dialect.js';
+export type { IFullTextSearch } from './fts.js';
+export type { IBlobCodec } from './blobCodec.js';
+export type { IDatabaseExporter } from './exporter.js';
+export type { StorageFeatures } from './features.js';
+export { createStorageFeatures } from './features.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/core/contracts/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/contracts/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/contracts/index.ts"],"names":[],"mappings":"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"}

package/dist/core/contracts/index.js

@@ -28,4 +28,5 @@ export * from './performance.js';
  * Designed for RAG integration, analytics, and auditing.
  */
 export * from './hooks.js';
+export { createStorageFeatures } from './features.js';
 //# sourceMappingURL=index.js.map

package/dist/core/contracts/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/contracts/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA6PH;;GAEG;AACH,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IAC/C,YAAY,OAAe,EAAW,SAAoB,EAAE;QAC1D,KAAK,CAAC,OAAO,CAAC,CAAC;QADqB,WAAM,GAAN,MAAM,CAAgB;QAE1D,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;IACvC,CAAC;CACF;AAED,+EAA+E;AAC/E,wCAAwC;AACxC,+EAA+E;AAE/E;;;GAGG;AACH,cAAc,eAAe,CAAC;AAE9B;;;GAGG;AACH,cAAc,SAAS,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/contracts/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA6PH;;GAEG;AACH,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IAC/C,YAAY,OAAe,EAAW,SAAoB,EAAE;QAC1D,KAAK,CAAC,OAAO,CAAC,CAAC;QADqB,WAAM,GAAN,MAAM,CAAgB;QAE1D,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;IACvC,CAAC;CACF;AAED,+EAA+E;AAC/E,wCAAwC;AACxC,+EAA+E;AAE/E;;;GAGG;AACH,cAAc,eAAe,CAAC;AAE9B;;;GAGG;AACH,cAAc,SAAS,CAAC;AAQxB,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC"}

package/dist/core/resolver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolver.d.ts","sourceRoot":"","sources":["../../src/core/resolver.ts"],"names":[],"mappings":"AAyCA,OAAO,KAAK,EAAE,cAAc,EAAyB,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAE7F,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAGvD,OAAO,EAAgC,KAAK,uBAAuB,EAAE,MAAM,oCAAoC,CAAC;AAEhH,OAAO,EAAoB,KAAK,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAG9F,YAAY,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD,MAAM,WAAW,wBAAwB;IACvC,iGAAiG;IACjG,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAC;IACzB,+CAA+C;IAC/C,SAAS,CAAC,EAAE,uBAAuB,CAAC;IACpC,8CAA8C;IAC9C,QAAQ,CAAC,EAAE;QAAE,gBAAgB,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACzC,qEAAqE;IACrE,SAAS,CAAC,EAAE,uBAAuB,CAAC;IACpC,yCAAyC;IACzC,WAAW,CAAC,EAAE,kBAAkB,CAAC;IACjC,iFAAiF;IACjF,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAyCD;;;GAGG;AACH,eAAO,MAAM,qBAAqB,aAAmB,wBAAwB,KAAQ,OAAO,CAAC,cAAc,CAuH1G,CAAC"}
+{"version":3,"file":"resolver.d.ts","sourceRoot":"","sources":["../../src/core/resolver.ts"],"names":[],"mappings":"AAyCA,OAAO,KAAK,EAAE,cAAc,EAAyB,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAE7F,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAGvD,OAAO,EAAgC,KAAK,uBAAuB,EAAE,MAAM,oCAAoC,CAAC;AAEhH,OAAO,EAAoB,KAAK,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAG9F,YAAY,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD,MAAM,WAAW,wBAAwB;IACvC,iGAAiG;IACjG,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAC;IACzB,+CAA+C;IAC/C,SAAS,CAAC,EAAE,uBAAuB,CAAC;IACpC,8CAA8C;IAC9C,QAAQ,CAAC,EAAE;QAAE,gBAAgB,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACzC,qEAAqE;IACrE,SAAS,CAAC,EAAE,uBAAuB,CAAC;IACpC,yCAAyC;IACzC,WAAW,CAAC,EAAE,kBAAkB,CAAC;IACjC,iFAAiF;IACjF,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAyCD;;;GAGG;AACH,eAAO,MAAM,qBAAqB,GAAU,UAAS,wBAA6B,KAAG,OAAO,CAAC,cAAc,CAuH1G,CAAC"}