@orkestrel/database 0.0.4 → 0.0.6

package/dist/src/server/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":["#path","#memory","#schema","#load","#deferring","#flush","#meta","#chain","#serialize","#flushCount","#path","#options","#guard","#database","#schema","#table","#require","#key","#transacting","#applyPlan"],"sources":["../../../src/server/helpers.ts","../../../src/server/compilers.ts","../../../src/server/constants.ts","../../../src/server/drivers/JSONDriver.ts","../../../src/server/drivers/SQLiteDriver.ts","../../../src/server/factories.ts"],"sourcesContent":["import type {\n\tAggregateFunction,\n\tColumnType,\n\tCondition,\n\tCriteria,\n\tMigrationStep,\n\tOrder,\n\tRow,\n\tTableSchema,\n} from '@src/core'\nimport type { FieldPath } from '@orkestrel/contract'\nimport type { SQLiteRow, SQLiteValue } from './types.js'\nimport { isBoolean, isFiniteNumber, isString } from '@orkestrel/contract'\nimport { randomUUID } from 'node:crypto'\n\n// The server's key-minting `KeyFunction` implementation — `core` mints no keys\n// itself (AGENTS §1: cross-environment code touches no `node:*`), so a server\n// consumer wires this in as `DatabaseOptions.key`.\n//\n// Below it: the SQLite ↔ JS bridge for the driver. Every helper is pure and\n// total — it narrows with `typeof` / `instanceof`, never `as` (AGENTS §1, §14):\n// a value that does not fit its column's storage type encodes to `null` rather\n// than throwing, and `decodeValue` is the exact inverse. `encodeRow` /\n// `decodeRow` lift the per-cell codecs across a whole schema; the SQL\n// identifier / type helpers (`quote`, `columnSQL`, `fieldColumn`) build the\n// static parts of a statement. `schemaToTable` / `schemaToIndexes` are pure\n// projections of the CREATE TABLE / CREATE INDEX DDL a SQLite driver's `open`\n// issues. This module speaks pure strings/values only — it imports no SQLite\n// package.\n\n/**\n * Generate a fresh unique key — a v4 UUID string, backed by `node:crypto`.\n *\n * @remarks\n * Supply this as {@link import('@orkestrel/database').DatabaseOptions.key} so a table mints\n * a key when a written row lacks its primary-key value. Strings work as keys on\n * every backend; supply your own key values directly to use numeric keys instead.\n *\n * @returns A new UUID string\n *\n * @example\n * ```ts\n * const db = createDatabase({ driver, tables, key: generateKey })\n * ```\n */\nexport function generateKey(): string {\n\treturn randomUUID()\n}\n\n// === Exactness (native ↔ engine parity gating)\n//\n// SQLiteDriver's `records` / `count` / `aggregate` / `stream` compile a\n// `Criteria` straight to SQL with NO engine re-filter — a huge perf win, but\n// only sound for a condition/order whose compiled SQL provably matches the\n// core engine's `matchesCondition` / `sortRows` semantics for every value a\n// contract-validated write can store (\"declared-type trust\"). These guards\n// decide, per condition/order/criteria, whether that proof holds; when it does\n// not, the driver falls back to a full scan refined through the same core\n// engine every scan-only driver (`MemoryDriver`, `JSONDriver`) already uses —\n// exact → native, otherwise → refine, never a silent semantics drift.\n\n/**\n * The declared {@link ColumnType}s whose SQL EQUALITY comparisons (`equals` /\n * `not` / `any` / `none`) and `starts` / `ends` compiles are provably\n * engine-exact under declared-type trust — `text` / `integer` / `real` /\n * `boolean`; a `json` or `blob` column always refines instead.\n *\n * @remarks\n * This set governs equality and prefix/suffix matching only. RANGE\n * comparisons (`above` / `below` / `from` / `to` / `between`) and `ORDER BY`\n * are exact for `integer` / `real` / `boolean` but NOT for `text`: compiled\n * SQL orders/ranges under SQLite's default BINARY collation, which compares\n * TEXT byte-for-byte as UTF-8 — equivalent to Unicode CODE-POINT order —\n * while the core engine's `compareValues` orders JS strings with `<`, which\n * compares UTF-16 CODE-UNIT order. The two orders diverge for supplementary-\n * plane characters (code points ≥ U+10000, e.g. many emoji): a lead surrogate\n * (`\\uD800`–`\\uDBFF`) sorts BELOW ``–`￿` in code-unit order, while\n * its code point sorts ABOVE them. So `isExactCondition`'s range family and\n * `isExactOrder` exclude `text`, refining through the core engine instead. A\n * future opt-in \"trusted collation\" mode (the caller vouches the column's\n * values are BMP-only, or a custom SQLite collation matching `compareValues`\n * is registered) could restore native text ranges/ordering.\n */\nexport const EXACT_COLUMN_TYPES: readonly ColumnType[] = ['text', 'integer', 'real', 'boolean']\n\n/**\n * The declared {@link ColumnType}s whose SQL RANGE comparisons\n * (`above` / `below` / `from` / `to` / `between`) and `ORDER BY` compiles are\n * provably engine-exact — `integer` / `real` / `boolean` only. `text` is\n * excluded: see {@link EXACT_COLUMN_TYPES}'s remarks for the BINARY-collation\n * (code-point) vs. JS `<` (code-unit) divergence on supplementary-plane\n * characters.\n */\nexport const EXACT_RANGE_COLUMN_TYPES: readonly ColumnType[] = ['integer', 'real', 'boolean']\n\n/**\n * Whether a value's runtime type matches a column's declared exact type —\n * the operand side of the declared-type-trust proof.\n *\n * @remarks\n * `text` ↔ string, `integer` / `real` ↔ FINITE number (`NaN` / `±Infinity`\n * fail), `boolean` ↔ boolean. Backs {@link isExactCondition}'s operand checks.\n *\n * @param value - The condition operand to test\n * @param type - The column's declared portable type\n * @returns `true` when the operand's runtime type matches the declared type\n *\n * @example\n * ```ts\n * matchesDeclaredType('Ada', 'text') // true\n * matchesDeclaredType(Number.NaN, 'integer') // false — only finite numbers\n * ```\n */\nexport function matchesDeclaredType(value: unknown, type: ColumnType): boolean {\n\tif (type === 'text') return isString(value)\n\tif (type === 'boolean') return isBoolean(value)\n\treturn isFiniteNumber(value)\n}\n\n/**\n * Whether one {@link Condition} compiles to SQL that is PROVABLY identical to\n * the core engine's `matchesCondition` for every value its column's declared\n * type can store.\n *\n * @remarks\n * `false` for a nested `FieldPath` (an array), a column absent from `schema`,\n * or a column whose declared type is not `text` / `integer` / `real` /\n * `boolean` (a `json` / `blob` column) — EXCEPT `absent` / `present`, which\n * compile to `IS NULL` / `IS NOT NULL` and match `decodeRow`'s \"a stored NULL\n * decodes to `undefined`\" rule for every column type, so they are exact\n * regardless of declared type. `equals` / `not` require a operand matching the\n * column's declared type (a `null` / `undefined` operand is never exact here —\n * `encodeRow` stores both an explicit `null` and an absent field as SQL NULL,\n * so native `IS NULL` semantics cannot match the engine's `deepEqual`-over-\n * decoded-rows truth). `above` / `below` / `from` / `to` / `between` are exact\n * ONLY for a declared type in {@link EXACT_RANGE_COLUMN_TYPES} (`integer` /\n * `real` / `boolean`) — a `text` column's range conditions REFINE, because\n * SQLite's default BINARY collation orders TEXT by Unicode CODE POINT while\n * the core engine's `compareValues` orders JS strings by UTF-16 CODE UNIT,\n * and the two diverge for supplementary-plane characters (see\n * {@link EXACT_COLUMN_TYPES}'s remarks for the full rationale).\n * `any` / `none` require a NON-EMPTY list where every element matches (an empty\n * list is exact under neither: the engine's `any([])` matches nothing while\n * `none([])` matches everything, and SQL `IN ()` is a syntax error) — these\n * stay exact on `text` (byte equality is collation-independent and engine-\n * identical). `starts` / `ends` are exact only on a `text` column with a\n * string operand (case-sensitive `substr` compile, see {@link fragment}) —\n * likewise collation-independent. `like` / `glob` are NEVER exact — SQLite\n * `LIKE` folds case ASCII-only against the engine's Unicode fold, and `GLOB`\n * has character classes the engine treats literally.\n *\n * @param condition - The condition to test\n * @param schema - The table's schema\n * @returns Whether `condition` is exact\n */\nexport function isExactCondition(condition: Condition, schema: TableSchema): boolean {\n\tif (!isString(condition.column)) return false\n\tconst column = schema.columns.find((candidate) => candidate.name === condition.column)\n\tif (column === undefined) return false\n\tif (condition.operator === 'absent' || condition.operator === 'present') return true\n\tif (!EXACT_COLUMN_TYPES.some((type) => type === column.type)) return false\n\tconst first = condition.values[0]\n\tconst second = condition.values[1]\n\tswitch (condition.operator) {\n\t\tcase 'equals':\n\t\tcase 'not':\n\t\t\treturn matchesDeclaredType(first, column.type)\n\t\tcase 'above':\n\t\tcase 'below':\n\t\tcase 'from':\n\t\tcase 'to':\n\t\t\treturn (\n\t\t\t\tEXACT_RANGE_COLUMN_TYPES.some((type) => type === column.type) &&\n\t\t\t\tmatchesDeclaredType(first, column.type)\n\t\t\t)\n\t\tcase 'between':\n\t\t\treturn (\n\t\t\t\tEXACT_RANGE_COLUMN_TYPES.some((type) => type === column.type) &&\n\t\t\t\tmatchesDeclaredType(first, column.type) &&\n\t\t\t\tmatchesDeclaredType(second, column.type)\n\t\t\t)\n\t\tcase 'any':\n\t\tcase 'none':\n\t\t\treturn (\n\t\t\t\tcondition.values.length > 0 &&\n\t\t\t\tcondition.values.every((value) => matchesDeclaredType(value, column.type))\n\t\t\t)\n\t\tcase 'starts':\n\t\tcase 'ends':\n\t\t\treturn column.type === 'text' && isString(first)\n\t\tcase 'like':\n\t\tcase 'glob':\n\t\t\treturn false\n\t}\n}\n\n/**\n * Whether one {@link Order} term's column compiles to an `ORDER BY` that\n * matches the engine's {@link import('@src/core').sortRows} exactly.\n *\n * @remarks\n * `false` for a nested `FieldPath`, a column absent from `schema`, or a\n * declared type outside {@link EXACT_RANGE_COLUMN_TYPES} (`integer` / `real` /\n * `boolean`). `text` is NOT exact here: SQLite's default BINARY collation\n * orders TEXT by Unicode code point while the core engine's `compareValues`\n * orders JS strings by UTF-16 code unit, and the two diverge for\n * supplementary-plane characters (see {@link EXACT_COLUMN_TYPES}'s remarks) —\n * a `text` order term REFINES through the core engine instead.\n *\n * @param order - The order term to test\n * @param schema - The table's schema\n * @returns Whether `order` is exact\n */\nexport function isExactOrder(order: Order, schema: TableSchema): boolean {\n\tif (!isString(order.column)) return false\n\tconst column = schema.columns.find((candidate) => candidate.name === order.column)\n\tif (column === undefined) return false\n\treturn EXACT_RANGE_COLUMN_TYPES.some((type) => type === column.type)\n}\n\n/**\n * Whether a whole {@link Criteria} is exact — every condition and every order\n * term is exact. `limit` / `offset` never affect exactness (SQL `LIMIT` /\n * `OFFSET` are always engine-identical).\n *\n * @param criteria - The criteria to test\n * @param schema - The table's schema\n * @returns Whether every part of `criteria` is exact\n */\nexport function isExactCriteria(criteria: Criteria, schema: TableSchema): boolean {\n\tconst conditions = criteria.conditions ?? []\n\tconst order = criteria.order ?? []\n\treturn (\n\t\tconditions.every((condition) => isExactCondition(condition, schema)) &&\n\t\torder.every((term) => isExactOrder(term, schema))\n\t)\n}\n\n// === SQL identifiers & types\n\n/**\n * Map a portable {@link ColumnType} to its SQLite column type.\n *\n * @remarks\n * `text` / `json` → `TEXT` (JSON is stored as text and read back with\n * `json_extract` for nested-field queries); `integer` / `boolean` → `INTEGER`\n * (a boolean stores `1` / `0`); `real` → `REAL`; `blob` → `BLOB`. No `NOT NULL`\n * is ever emitted — the contract validates required-ness; the database is just\n * storage (AGENTS §14, the typed layer above imposes the shape).\n *\n * @param type - The portable column type\n * @returns The SQLite column type keyword\n *\n * @example\n * ```ts\n * columnSQL('integer') // 'INTEGER'\n * columnSQL('json') // 'TEXT'\n * ```\n */\nexport function columnSQL(type: ColumnType): string {\n\tswitch (type) {\n\t\tcase 'text':\n\t\tcase 'json':\n\t\t\treturn 'TEXT'\n\t\tcase 'integer':\n\t\tcase 'boolean':\n\t\t\treturn 'INTEGER'\n\t\tcase 'real':\n\t\t\treturn 'REAL'\n\t\tcase 'blob':\n\t\t\treturn 'BLOB'\n\t}\n}\n\n/**\n * Quote a SQL identifier (a table or column name) so any characters are literal.\n *\n * @remarks\n * Wraps the name in double quotes and doubles any embedded quote — the standard\n * SQL identifier-quoting that lets a column named `order` or `from` be referenced\n * safely. Identifiers cannot be bound as parameters, so they are quoted instead.\n *\n * @param identifier - The raw identifier\n * @returns The double-quoted identifier\n *\n * @example\n * ```ts\n * quote('order') // '\"order\"'\n * ```\n */\nexport function quote(identifier: string): string {\n\treturn '\"' + identifier.replaceAll('\"', '\"\"') + '\"'\n}\n\n/**\n * Compile a {@link FieldPath} to the SQL expression that reads it.\n *\n * @remarks\n * A single string is ONE column — `quote(path)`. An array descends a JSON column:\n * the first element is the (quoted) column, the rest a `json_extract` path\n * (`json_extract(\"payload\", '$.user.id')`), matching the guide's nested-field\n * examples (simple identifier keys). The string's value is never split on `.`\n * (AGENTS — `FieldPath` semantics): a dotted string is one column literally.\n *\n * @param path - The field path (a column, or a column + nested keys)\n * @returns The SQL expression selecting the value\n *\n * @example\n * ```ts\n * fieldColumn('payload') // '\"payload\"'\n * fieldColumn(['payload', 'user', 'id']) // 'json_extract(\"payload\", \\'$.user.id\\')'\n * ```\n */\nexport function fieldColumn(path: FieldPath): string {\n\tif (isString(path)) return quote(path)\n\tconst rest = path\n\t\t.slice(1)\n\t\t.map((key) => '.' + key.replaceAll(\"'\", \"''\"))\n\t\t.join('')\n\treturn 'json_extract(' + quote(path[0]) + \", '$\" + rest + \"')\"\n}\n\n/**\n * Compile an {@link AggregateFunction} over a {@link FieldPath} to its SQL\n * aggregate expression — the SELECT body the SQLite driver's native `aggregate`\n * runs.\n *\n * @remarks\n * `count` → `COUNT(*)` (counting all matched ROWS, not non-null column values —\n * mirroring the engine's `computeAggregate('count')`, which is `rows.length`); the\n * numeric aggregates wrap the column's read expression (a flat column, or a nested\n * `json_extract` path) in `SUM` / `AVG` / `MIN` / `MAX`. Over zero matched rows\n * `COUNT(*)` is `0` and the numeric aggregates are SQL `NULL` (→ `undefined`),\n * matching the engine.\n *\n * @param operation - The aggregate to compute\n * @param column - The column (or nested path) to aggregate\n * @returns The SQL aggregate expression\n *\n * @example\n * ```ts\n * aggregateSQL('count', 'age') // 'COUNT(*)'\n * aggregateSQL('sum', 'age') // 'SUM(\"age\")'\n * aggregateSQL('average', ['payload', 'score']) // 'AVG(json_extract(\"payload\", \\'$.score\\'))'\n * ```\n */\nexport function aggregateSQL(operation: AggregateFunction, column: FieldPath): string {\n\tswitch (operation) {\n\t\tcase 'count':\n\t\t\treturn 'COUNT(*)'\n\t\tcase 'sum':\n\t\t\treturn 'SUM(' + fieldColumn(column) + ')'\n\t\tcase 'average':\n\t\t\treturn 'AVG(' + fieldColumn(column) + ')'\n\t\tcase 'minimum':\n\t\t\treturn 'MIN(' + fieldColumn(column) + ')'\n\t\tcase 'maximum':\n\t\t\treturn 'MAX(' + fieldColumn(column) + ')'\n\t}\n}\n\n// === Value codecs\n\n/**\n * Encode a JS value to its stored {@link SQLiteValue} for a column's type.\n *\n * @remarks\n * The forward half of the bridge, total (AGENTS §14): a value that does not fit\n * its column's storage type encodes to `null` rather than throwing. A `boolean`\n * column stores `1` / `0` (and `null` / `undefined` → `null`); a `json` column\n * stores `JSON.stringify` (or `null` for `null` / `undefined`); `integer` /\n * `real` keep a `number` / `bigint`, else `null`; `text` keeps a `string`, else\n * `null`; `blob` keeps a `Uint8Array`, else `null`. Narrowed with `typeof` /\n * `instanceof`, never `as`.\n *\n * @param value - The JS value to store\n * @param type - The column's portable storage type\n * @returns The value SQLite stores\n *\n * @example\n * ```ts\n * encodeValue(true, 'boolean') // 1\n * encodeValue({ a: 1 }, 'json') // '{\"a\":1}'\n * ```\n */\nexport function encodeValue(value: unknown, type: ColumnType): SQLiteValue {\n\tswitch (type) {\n\t\tcase 'boolean':\n\t\t\treturn value === undefined || value === null ? null : value === true ? 1 : 0\n\t\tcase 'json':\n\t\t\treturn value === undefined || value === null ? null : JSON.stringify(value)\n\t\tcase 'integer':\n\t\tcase 'real':\n\t\t\treturn typeof value === 'number' || typeof value === 'bigint' ? value : null\n\t\tcase 'text':\n\t\t\treturn typeof value === 'string' ? value : null\n\t\tcase 'blob':\n\t\t\treturn value instanceof Uint8Array ? value : null\n\t}\n}\n\n/**\n * Decode a stored {@link SQLiteValue} back to its JS value for a column's type —\n * the exact inverse of {@link encodeValue}.\n *\n * @remarks\n * A `boolean` column reads `1` / `0` back to `true` / `false` (a stored `null`\n * → `undefined`); a `json` column `JSON.parse`s a string (anything else →\n * `undefined`); every other type passes the value through, mapping a stored\n * `NULL` to `undefined`. NULL decodes to `undefined` so {@link decodeRow} can\n * omit absent columns.\n *\n * @param value - The stored SQLite value\n * @param type - The column's portable storage type\n * @returns The decoded JS value (`undefined` for a stored `NULL`)\n *\n * @example\n * ```ts\n * decodeValue(1, 'boolean') // true\n * decodeValue('{\"a\":1}', 'json') // { a: 1 }\n * ```\n */\nexport function decodeValue(value: SQLiteValue, type: ColumnType): unknown {\n\tswitch (type) {\n\t\tcase 'boolean':\n\t\t\treturn value === null ? undefined : value !== 0\n\t\tcase 'json':\n\t\t\treturn typeof value === 'string' ? JSON.parse(value) : undefined\n\t\tdefault:\n\t\t\treturn value === null ? undefined : value\n\t}\n}\n\n/**\n * Encode a whole {@link Row} to a {@link SQLiteRow} by its table's schema.\n *\n * @remarks\n * Encodes each declared column's value with {@link encodeValue}; columns the row\n * does not carry encode from `undefined` (so they store `null`). Only the\n * schema's columns appear in the result — an extra row key is dropped.\n *\n * @param row - The JS row to store\n * @param schema - The table's schema\n * @returns The storable SQLite row\n *\n * @example\n * ```ts\n * encodeRow({ id: 'u1', active: true }, schema) // { id: 'u1', active: 1, ... }\n * ```\n */\nexport function encodeRow(row: Row, schema: TableSchema): SQLiteRow {\n\tconst result: SQLiteRow = {}\n\tfor (const column of schema.columns) {\n\t\tresult[column.name] = encodeValue(row[column.name], column.type)\n\t}\n\treturn result\n}\n\n/**\n * Decode a stored {@link SQLiteRow} back to a {@link Row} by its table's schema.\n *\n * @remarks\n * Decodes each declared column with {@link decodeValue} and **omits** any column\n * whose decoded value is `undefined` — so an absent / `NULL` optional column does\n * not surface as `{ bio: undefined }`, matching how the contract's optional\n * columns expect absence. A known, documented edge: a non-optional `nullableShape`\n * column storing `null` round-trips to absent (a `null` cell decodes to\n * `undefined`, and an `undefined` value is omitted).\n *\n * @param row - The stored SQLite row\n * @param schema - The table's schema\n * @returns The decoded JS row (absent columns omitted)\n *\n * @example\n * ```ts\n * decodeRow({ id: 'u1', active: 1, bio: null }, schema) // { id: 'u1', active: true }\n * ```\n */\nexport function decodeRow(row: SQLiteRow, schema: TableSchema): Row {\n\tconst result: Row = {}\n\tfor (const column of schema.columns) {\n\t\tconst decoded = decodeValue(row[column.name], column.type)\n\t\tif (decoded !== undefined) result[column.name] = decoded\n\t}\n\treturn result\n}\n\n// === DDL projections\n\n/**\n * Project a {@link TableSchema} to the `CREATE TABLE IF NOT EXISTS` statement a\n * SQLite driver's `open` issues for it.\n *\n * @remarks\n * Each column compiles to `<quoted name> <columnSQL(type)>`; the statement ends\n * with `PRIMARY KEY (<quoted primary>)`. No `NOT NULL` is emitted — the contract\n * validates required-ness, the database is just storage (AGENTS §14).\n *\n * @param schema - The table's schema\n * @returns The `CREATE TABLE IF NOT EXISTS …` statement\n *\n * @example\n * ```ts\n * schemaToTable(schema)\n * // 'CREATE TABLE IF NOT EXISTS \"users\" (\"id\" TEXT, \"age\" INTEGER, PRIMARY KEY (\"id\"))'\n * ```\n */\nexport function schemaToTable(schema: TableSchema): string {\n\tconst columns = schema.columns.map((column) => quote(column.name) + ' ' + columnSQL(column.type))\n\treturn (\n\t\t'CREATE TABLE IF NOT EXISTS ' +\n\t\tquote(schema.name) +\n\t\t' (' +\n\t\tcolumns.join(', ') +\n\t\t', PRIMARY KEY (' +\n\t\tquote(schema.primary) +\n\t\t'))'\n\t)\n}\n\n/**\n * Build a collision-free SQL index name for a table + column-group index —\n * shared by {@link schemaToIndexes} (an `open`-time `CREATE INDEX`) and\n * {@link stepToSQL}'s `index.add` / `index.remove` (a migration-time DDL),\n * so a plan-built index name always matches one `open` would have created.\n *\n * @remarks\n * A naive `idx_<table>_<cols joined by _>` is AMBIGUOUS: table `'a_b'` with\n * column `'c'` and table `'a'` with columns `['b', 'c']` both produce\n * `idx_a_b_c`. This encodes each part (the table name, then each column name)\n * length-prefixed (`<len>_<part>`) so the boundary between parts is always\n * unambiguous, however the names themselves are punctuated.\n *\n * @param table - The table name\n * @param columns - The index's column names, in order\n * @returns The deterministic, collision-free index identifier (unquoted)\n *\n * @example\n * ```ts\n * indexName('users', ['name']) // 'idx_5_users_4_name'\n * indexName('a_b', ['c']) // 'idx_3_a_b_1_c'\n * indexName('a', ['b', 'c']) // 'idx_1_a_1_b_1_c'\n * ```\n */\nexport function indexName(table: string, columns: readonly string[]): string {\n\tconst parts = [table, ...columns].map((part) => String(part.length) + '_' + part)\n\treturn 'idx_' + parts.join('_')\n}\n\n/**\n * Project a {@link TableSchema} to the `CREATE INDEX IF NOT EXISTS` statements a\n * SQLite driver's `open` issues for its declared indexes.\n *\n * @remarks\n * One statement per index group; the index name is built by {@link indexName}\n * (collision-free and deterministic), matching the driver's naming so a\n * repeated `open` is idempotent.\n *\n * @param schema - The table's schema\n * @returns One `CREATE INDEX IF NOT EXISTS …` statement per declared index\n *\n * @example\n * ```ts\n * schemaToIndexes(schema)\n * // ['CREATE INDEX IF NOT EXISTS \"idx_5_users_4_name\" ON \"users\" (\"name\")']\n * ```\n */\nexport function schemaToIndexes(schema: TableSchema): readonly string[] {\n\treturn schema.indexes.map(\n\t\t(group) =>\n\t\t\t'CREATE INDEX IF NOT EXISTS ' +\n\t\t\tquote(indexName(schema.name, group)) +\n\t\t\t' ON ' +\n\t\t\tquote(schema.name) +\n\t\t\t' (' +\n\t\t\tgroup.map(quote).join(', ') +\n\t\t\t')',\n\t)\n}\n\n/**\n * Project one {@link MigrationStep} to the DDL statement(s) a SQLite driver's\n * `migrate` executes for it.\n *\n * @remarks\n * `table.add` emits the `CREATE TABLE` plus one `CREATE INDEX` per declared\n * index (via {@link schemaToTable} / {@link schemaToIndexes}); `table.remove`\n * emits `DROP TABLE IF EXISTS`; `column.add` / `column.remove` emit `ALTER\n * TABLE … ADD COLUMN` / `… DROP COLUMN`; `index.add` / `index.remove` emit\n * `CREATE INDEX IF NOT EXISTS` / `DROP INDEX IF EXISTS`, naming the index the\n * same way `schemaToIndexes` does (`idx_<table>_<columns joined by _>`) so a\n * plan-built index matches one `open` would have created. Whether the named\n * table actually exists is the caller's concern (a driver's `migrate` checks\n * its own declared schema before running these statements) — this projection\n * is pure and never inspects live state.\n *\n * @param step - The migration step to project\n * @returns The DDL statement(s) that apply the step\n *\n * @example\n * ```ts\n * stepToSQL({ operation: 'column.remove', table: 'users', column: 'legacy' })\n * // ['ALTER TABLE \"users\" DROP COLUMN \"legacy\"']\n * ```\n */\nexport function stepToSQL(step: MigrationStep): readonly string[] {\n\tswitch (step.operation) {\n\t\tcase 'table.add':\n\t\t\treturn [schemaToTable(step.table), ...schemaToIndexes(step.table)]\n\t\tcase 'table.remove':\n\t\t\treturn ['DROP TABLE IF EXISTS ' + quote(step.table)]\n\t\tcase 'column.add':\n\t\t\treturn [\n\t\t\t\t'ALTER TABLE ' +\n\t\t\t\t\tquote(step.table) +\n\t\t\t\t\t' ADD COLUMN ' +\n\t\t\t\t\tquote(step.column.name) +\n\t\t\t\t\t' ' +\n\t\t\t\t\tcolumnSQL(step.column.type),\n\t\t\t]\n\t\tcase 'column.remove':\n\t\t\treturn ['ALTER TABLE ' + quote(step.table) + ' DROP COLUMN ' + quote(step.column)]\n\t\tcase 'index.add':\n\t\t\treturn [\n\t\t\t\t'CREATE INDEX IF NOT EXISTS ' +\n\t\t\t\t\tquote(indexName(step.table, step.index)) +\n\t\t\t\t\t' ON ' +\n\t\t\t\t\tquote(step.table) +\n\t\t\t\t\t' (' +\n\t\t\t\t\tstep.index.map(quote).join(', ') +\n\t\t\t\t\t')',\n\t\t\t]\n\t\tcase 'index.remove':\n\t\t\treturn ['DROP INDEX IF EXISTS ' + quote(indexName(step.table, step.index))]\n\t}\n}\n\n/**\n * Project one {@link MigrationStep} onto its table's declared {@link TableSchema}\n * — the bookkeeping counterpart to {@link stepToSQL} (which projects the DDL a\n * driver's `migrate` runs against the live database).\n *\n * @remarks\n * `column.add` / `column.remove` add / filter the named column;\n * `index.add` / `index.remove` add / filter the matching index group (an exact\n * ordered match on `index`). `table.add` / `table.remove` act on a WHOLE\n * schema map rather than one table's shape, so they are the caller's concern\n * (a driver's `migrate` applies them directly against its table map) — passed\n * here, they return `schema` unchanged.\n *\n * @param schema - The table's current declared schema\n * @param step - The migration step to project onto it\n * @returns The table's schema after the step\n *\n * @example\n * ```ts\n * stepToSchema(schema, { operation: 'column.remove', table: 'users', column: 'legacy' })\n * // schema with the 'legacy' column dropped from `columns`\n * ```\n */\nexport function stepToSchema(schema: TableSchema, step: MigrationStep): TableSchema {\n\tswitch (step.operation) {\n\t\tcase 'column.add':\n\t\t\treturn { ...schema, columns: [...schema.columns, step.column] }\n\t\tcase 'column.remove':\n\t\t\treturn { ...schema, columns: schema.columns.filter((column) => column.name !== step.column) }\n\t\tcase 'index.add':\n\t\t\treturn { ...schema, indexes: [...schema.indexes, step.index] }\n\t\tcase 'index.remove':\n\t\t\treturn {\n\t\t\t\t...schema,\n\t\t\t\tindexes: schema.indexes.filter(\n\t\t\t\t\t(group) =>\n\t\t\t\t\t\t!(\n\t\t\t\t\t\t\tgroup.length === step.index.length &&\n\t\t\t\t\t\t\tgroup.every((name, position) => name === step.index[position])\n\t\t\t\t\t\t),\n\t\t\t\t),\n\t\t\t}\n\t\tcase 'table.add':\n\t\tcase 'table.remove':\n\t\t\treturn schema\n\t}\n}\n","import type { ColumnType, Condition, Criteria, Order, TableSchema } from '@src/core'\nimport type { CompiledSQL, SQLiteValue } from './types.js'\nimport { isString } from '@orkestrel/contract'\nimport { encodeValue, fieldColumn, quote } from './helpers.js'\n\n/**\n * Compile a NESTED {@link FieldPath} to the `json_type(<col>, <path>)` SQL\n * expression — the {@link fieldColumn} `json_extract` sibling used to tell a\n * PRESENT JSON `null` apart from an ABSENT path (both read back as SQL `NULL`\n * through `json_extract`, but `json_type` reports `'null'` for the former and\n * SQL `NULL` for the latter).\n *\n * @param path - The nested field path (a column plus its JSON keys)\n * @returns The SQL expression reading the value's JSON type\n *\n * @example\n * ```ts\n * jsonTypeColumn(['payload', 'user', 'id']) // \"json_type(\\\"payload\\\", '$.user.id')\"\n * ```\n */\nexport function jsonTypeColumn(path: readonly string[]): string {\n\tconst rest = path\n\t\t.slice(1)\n\t\t.map((key) => '.' + key.replaceAll(\"'\", \"''\"))\n\t\t.join('')\n\treturn 'json_type(' + quote(path[0]) + \", '$\" + rest + \"')\"\n}\n\n// The `Criteria` → parameterized SQL compiler — the native-query payoff. It turns\n// a portable `Criteria` (the same one the core engine's `applyCriteria` folds)\n// into the `WHERE` / `ORDER BY` / `LIMIT` tail of a `SELECT`, with bound `?`\n// params in clause order. Its WHERE fold parenthesizes LEFT-TO-RIGHT to match the\n// engine's `matchesCriteria` exactly (NOT SQL's AND-over-OR precedence), so a\n// native read and an engine read agree on every query (the parity test). Branches\n// are centralized and public per AGENTS §5 — no operator logic buried in closures.\n// This module speaks pure strings/values only — it imports no SQLite package.\n\n/**\n * Escape `\\`, `%`, and `_` (each with a leading `\\`) so a `starts` / `ends`\n * operand is matched literally under the `LIKE … ESCAPE '\\'` clause.\n *\n * @param text - The raw operand text\n * @returns The text with LIKE metacharacters escaped\n *\n * @example\n * ```ts\n * escapeLike('50%_off') // '50\\\\%\\\\_off'\n * ```\n */\nexport function escapeLike(text: string): string {\n\treturn text.replaceAll('\\\\', '\\\\\\\\').replaceAll('%', '\\\\%').replaceAll('_', '\\\\_')\n}\n\n/**\n * The declared storage type of a flat (string) column, read from the schema.\n *\n * @param column - The column name\n * @param schema - The table's schema\n * @returns The column's {@link ColumnType}, or `undefined` if the schema does not carry it\n *\n * @example\n * ```ts\n * declaredType('age', schema) // 'integer'\n * ```\n */\nexport function declaredType(column: string, schema: TableSchema): ColumnType | undefined {\n\treturn schema.columns.find((candidate) => candidate.name === column)?.type\n}\n\n/**\n * The storage type a nested (`json_extract`) operand encodes as, derived from its\n * RUNTIME value — NOT `json`.\n *\n * @remarks\n * `json_extract` returns the unquoted, natively-typed scalar (a JSON boolean as\n * `1` / `0`, a number as-is, a string as-is), so the operand must encode to that\n * same scalar to compare. A boolean → `'boolean'` (→ `1` / `0`); a number →\n * `'integer'` / `'real'`; a bigint → `'integer'`; a string → `'text'`; `null` /\n * `undefined` → `'text'` (encodes to `null`); an object / array → `'json'` (the\n * edge of comparing against a json subtree).\n *\n * @param value - The runtime operand value\n * @returns The {@link ColumnType} to encode it as\n *\n * @example\n * ```ts\n * valueType(true) // 'boolean'\n * valueType(9) // 'integer'\n * ```\n */\nexport function valueType(value: unknown): ColumnType {\n\tif (typeof value === 'boolean') return 'boolean'\n\tif (typeof value === 'number') return Number.isInteger(value) ? 'integer' : 'real'\n\tif (typeof value === 'bigint') return 'integer'\n\tif (typeof value === 'object' && value !== null) return 'json'\n\treturn 'text'\n}\n\n/**\n * Compile one condition to its `<column> <operator>` SQL fragment and the params\n * it binds — engine-exact under SQL's three-valued NULL logic.\n *\n * @remarks\n * Every operand is run through `encodeValue`, so a bound value matches the SQL\n * the column side compiles to. A flat column encodes operands with its DECLARED\n * schema type (a flat `json` column → `JSON.stringify`); a nested `FieldPath`\n * encodes each operand as the NATIVE scalar `json_extract` returns, derived from\n * the operand's runtime type (per-operand, since `between` / `any` / `none` can\n * mix types). `any` / `none` collapse an empty list to a constant (`0` matches\n * nothing, `1` matches all) with no params.\n *\n * The core engine's total order ranks `undefined` (rank 0) BELOW `null`\n * (rank 1) (see `compareValues`), so a MISSING/`NULL` column MATCHES\n * `below` / `to` / a scalar `not` / `none` — the opposite of raw SQL, where a\n * comparison against `NULL` is `NULL` (excluded). This fragment replicates the\n * engine exactly. Truth table (`value` = the engine's decoded field read; a\n * FLAT column's stored `NULL` decodes to `undefined` per `decodeRow`, so a\n * flat `value` is NEVER a present `null` — only a NESTED path can be\n * present-but-`null`):\n *\n * ```text\n * operator            | value=undefined (absent)      | value=null (nested only) | value=scalar\n * --------------------|--------------------------------|---------------------------|-------------\n * equals, first=null  | no match                       | MATCH                     | no match\n * equals, first=X     | no match                       | no match                  | value===X\n * not, first=null     | MATCH (flat: unconditionally;  | no match                  | MATCH\n *                     |   nested: absent still matches)|                           |\n * not, first=X        | MATCH                          | MATCH                     | value!==X\n * below/to, first=X   | MATCH (rank 0 < rank(X))       | MATCH (rank 1 < rank(X))  | rank compare\n * none, list=[…]       | MATCH (no scalar rank-equal)   | MATCH                     | not-in-list\n * any, list=[…]        | no match                       | no match                  | in-list\n * above/from/between  | no match                       | no match                  | rank compare\n * like/glob/starts/…  | no match (not a string)        | no match                  | string test\n * present              | false                          | false                     | true\n * absent                | true                           | true                      | false\n * ```\n *\n * Because a flat column's `NULL` always decodes to `undefined`, `equals`\n * against a `null` operand needs no special flat compilation (`col = ?`\n * binding a `NULL` param is already always-false in SQL, matching \"no match\"\n * above) — but flat `not` against `null` must match EVERY row (both the\n * absent and the scalar rows), which `col != ? OR col IS NULL` cannot express\n * (it only catches the `IS NULL` row), so a flat `not`-with-`null`-operand\n * compiles to the constant `1`.\n *\n * A NESTED path can be present-but-`null` (a stored JSON `null`), which\n * `json_extract` reads back as SQL `NULL` — indistinguishable from an ABSENT\n * path. `json_type(col, path)` disambiguates them (`'null'` for present-null,\n * SQL `NULL` for absent), so nested `equals` / `not` against a `null` operand\n * compile through `json_type` instead of `IS NULL` / `IS NOT NULL`.\n *\n * Every other MATCH-on-null-or-absent row is expressed uniformly (flat and\n * nested alike) as `(<column> <op> ? OR <column> IS NULL)` — for a nested\n * path, `json_extract` already collapses BOTH absent and present-null to SQL\n * `NULL`, so `IS NULL` catches both in one clause; for a flat column there is\n * only the absent case to catch.\n *\n * @param condition - The condition to compile\n * @param schema - The table's schema (for declared column types)\n * @returns The SQL fragment and its bound parameters\n *\n * @example\n * ```ts\n * fragment({ column: 'age', operator: 'above', values: [18], connector: 'and' }, schema)\n * // { sql: '\"age\" > ?', params: [18] }\n * fragment({ column: 'age', operator: 'below', values: [18], connector: 'and' }, schema)\n * // { sql: '(\"age\" < ? OR \"age\" IS NULL)', params: [18] }\n * ```\n */\nexport function fragment(condition: Condition, schema: TableSchema): CompiledSQL {\n\tconst column = fieldColumn(condition.column)\n\tconst nested = !isString(condition.column)\n\tconst declared = isString(condition.column) ? declaredType(condition.column, schema) : undefined\n\tconst encode = (value: unknown): SQLiteValue =>\n\t\tencodeValue(value, nested ? valueType(value) : (declared ?? 'json'))\n\tconst first = condition.values[0]\n\tconst second = condition.values[1]\n\tconst nullOperand = first === null || first === undefined\n\t// The nested `json_type` read — built only when `condition.column` is an\n\t// array (a nested path) — disambiguates a present JSON `null` from an\n\t// absent path under `equals` / `not` (see the truth table above).\n\tconst jsonType = !isString(condition.column) ? jsonTypeColumn(condition.column) : ''\n\tswitch (condition.operator) {\n\t\tcase 'equals':\n\t\t\tif (nullOperand && nested) return { sql: jsonType + \" = 'null'\", params: [] }\n\t\t\treturn { sql: column + ' = ?', params: [encode(first)] }\n\t\tcase 'not':\n\t\t\tif (nullOperand) {\n\t\t\t\tif (nested) {\n\t\t\t\t\treturn {\n\t\t\t\t\t\tsql: '(' + jsonType + ' IS NULL OR ' + jsonType + \" != 'null')\",\n\t\t\t\t\t\tparams: [],\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t\t// A flat column's decoded value is never a present null, so\n\t\t\t\t// `compareValues(value, null)` is nonzero for EVERY row (absent or\n\t\t\t\t// scalar) — the engine's `not null` matches unconditionally.\n\t\t\t\treturn { sql: '1', params: [] }\n\t\t\t}\n\t\t\treturn { sql: '(' + column + ' != ? OR ' + column + ' IS NULL)', params: [encode(first)] }\n\t\tcase 'above':\n\t\t\treturn { sql: column + ' > ?', params: [encode(first)] }\n\t\tcase 'below':\n\t\t\treturn { sql: '(' + column + ' < ? OR ' + column + ' IS NULL)', params: [encode(first)] }\n\t\tcase 'from':\n\t\t\treturn { sql: column + ' >= ?', params: [encode(first)] }\n\t\tcase 'to':\n\t\t\treturn { sql: '(' + column + ' <= ? OR ' + column + ' IS NULL)', params: [encode(first)] }\n\t\tcase 'between':\n\t\t\treturn { sql: column + ' BETWEEN ? AND ?', params: [encode(first), encode(second)] }\n\t\tcase 'like':\n\t\t\treturn { sql: column + ' LIKE ?', params: [encode(first)] }\n\t\tcase 'glob':\n\t\t\treturn { sql: column + ' GLOB ?', params: [encode(first)] }\n\t\tcase 'starts': {\n\t\t\t// Case-sensitive, exact compile (replaces the old LIKE-based one, which\n\t\t\t// was ASCII-only case-INsensitive — a mismatch with the engine's\n\t\t\t// case-sensitive `String.startsWith`). `substr` counts CODE POINTS, so\n\t\t\t// the length is a code-point count (`Array.from`), not `.length`. An\n\t\t\t// empty operand matches every text-column value (the engine: every\n\t\t\t// string starts with '').\n\t\t\tconst text = isString(first) ? first : ''\n\t\t\tif (text === '') return { sql: 'typeof(' + column + \") = 'text'\", params: [] }\n\t\t\tconst length = Array.from(text).length\n\t\t\treturn {\n\t\t\t\tsql: '(typeof(' + column + \") = 'text' AND substr(\" + column + ', 1, ' + length + ') = ?)',\n\t\t\t\tparams: [encode(first)],\n\t\t\t}\n\t\t}\n\t\tcase 'ends': {\n\t\t\t// Mirror of `starts`: `substr(<col>, -N)` (SQLite's 2-arg form counts\n\t\t\t// from the right when N is negative) reads the last N code points.\n\t\t\tconst text = isString(first) ? first : ''\n\t\t\tif (text === '') return { sql: 'typeof(' + column + \") = 'text'\", params: [] }\n\t\t\tconst length = Array.from(text).length\n\t\t\treturn {\n\t\t\t\tsql: '(typeof(' + column + \") = 'text' AND substr(\" + column + ', -' + length + ') = ?)',\n\t\t\t\tparams: [encode(first)],\n\t\t\t}\n\t\t}\n\t\tcase 'any':\n\t\t\tif (condition.values.length === 0) return { sql: '0', params: [] }\n\t\t\treturn {\n\t\t\t\tsql: column + ' IN (' + condition.values.map(() => '?').join(', ') + ')',\n\t\t\t\tparams: condition.values.map(encode),\n\t\t\t}\n\t\tcase 'none':\n\t\t\tif (condition.values.length === 0) return { sql: '1', params: [] }\n\t\t\treturn {\n\t\t\t\tsql:\n\t\t\t\t\t'(' +\n\t\t\t\t\tcolumn +\n\t\t\t\t\t' NOT IN (' +\n\t\t\t\t\tcondition.values.map(() => '?').join(', ') +\n\t\t\t\t\t') OR ' +\n\t\t\t\t\tcolumn +\n\t\t\t\t\t' IS NULL)',\n\t\t\t\tparams: condition.values.map(encode),\n\t\t\t}\n\t\tcase 'absent':\n\t\t\treturn { sql: column + ' IS NULL', params: [] }\n\t\tcase 'present':\n\t\t\treturn { sql: column + ' IS NOT NULL', params: [] }\n\t}\n}\n\n/**\n * Fold the conditions into one WHERE clause, parenthesizing progressively\n * left-to-right so the grouping matches the engine's `matchesCriteria` fold.\n *\n * @remarks\n * The first condition's connector is ignored, per the {@link Condition} types.\n * Every fragment (see {@link fragment}'s truth table) replicates the core\n * engine's total order EXACTLY under SQL's three-valued NULL logic, so this\n * clause matches `applyCriteria` row-for-row over the same table — a native\n * `records` / `count` read never disagrees with a scan-and-filter fallback.\n *\n * @param conditions - The conditions to fold\n * @param schema - The table's schema\n * @returns The `WHERE …` clause and its bound parameters, or an empty clause for zero conditions\n *\n * @example\n * ```ts\n * compileWhere([{ column: 'age', operator: 'from', values: [18], connector: 'and' }], schema)\n * // { sql: 'WHERE \"age\" >= ?', params: [18] }\n * ```\n */\nexport function compileWhere(conditions: readonly Condition[], schema: TableSchema): CompiledSQL {\n\tif (conditions.length === 0) return { sql: '', params: [] }\n\tconst head = fragment(conditions[0], schema)\n\tlet clause = head.sql\n\tconst params: SQLiteValue[] = [...head.params]\n\tfor (let index = 1; index < conditions.length; index += 1) {\n\t\tconst next = fragment(conditions[index], schema)\n\t\tconst operator = conditions[index].connector === 'or' ? 'OR' : 'AND'\n\t\tclause = '(' + clause + ' ' + operator + ' ' + next.sql + ')'\n\t\tparams.push(...next.params)\n\t}\n\treturn { sql: 'WHERE ' + clause, params }\n}\n\n/**\n * Compile the ORDER BY clause from the order terms, always ending with the\n * primary key as the final determinant.\n *\n * @remarks\n * The native `records` read then resolves ties in key order, matching a\n * primary-key-ordered `scan` and the core engine's stable `sortRows` over a\n * key-ordered scan (and IndexedDB's key-ordered reads), so a native read equals\n * the scan path (AGENTS §21 / §22 native ↔ engine parity). SQLite without an\n * `ORDER BY` returns rowid (insertion) order, and an explicit order alone breaks\n * ties by rowid too — both diverge from every key-ordered backend. The\n * tie-breaker is ASCENDING regardless of the explicit directions: the engine's\n * stable sort runs over key-ascending input, so equal rows stay in\n * ascending-key order whichever way the explicit terms point. Skipped when the\n * primary is already an explicit order term (no double-append).\n *\n * @param order - The explicit order terms, or `undefined`\n * @param schema - The table's schema (for the primary key)\n * @returns The `ORDER BY …` clause, or an empty string when there is nothing to order by\n *\n * @example\n * ```ts\n * compileOrder([{ column: 'age', direction: 'descending' }], schema)\n * // 'ORDER BY \"age\" DESC, \"id\"'\n * ```\n */\nexport function compileOrder(order: readonly Order[] | undefined, schema: TableSchema): string {\n\tconst terms = (order ?? []).map(\n\t\t(term) => fieldColumn(term.column) + (term.direction === 'descending' ? ' DESC' : ' ASC'),\n\t)\n\tconst ordersByPrimary = (order ?? []).some(\n\t\t(term) => isString(term.column) && term.column === schema.primary,\n\t)\n\tif (!ordersByPrimary) terms.push(quote(schema.primary))\n\treturn terms.length === 0 ? '' : 'ORDER BY ' + terms.join(', ')\n}\n\n/**\n * Compile the LIMIT / OFFSET clause.\n *\n * @remarks\n * An offset without a limit uses `LIMIT -1` (SQLite's \"no limit\") so OFFSET is\n * still honored.\n *\n * @param limit - The maximum row count, or `undefined`\n * @param offset - The row count to skip, or `undefined`\n * @returns The `LIMIT …` clause and its bound parameters, or an empty clause when neither is set\n *\n * @example\n * ```ts\n * compilePage(undefined, 5) // { sql: 'LIMIT -1 OFFSET ?', params: [5] }\n * ```\n */\nexport function compilePage(limit: number | undefined, offset: number | undefined): CompiledSQL {\n\tif (limit !== undefined && offset !== undefined) {\n\t\treturn { sql: 'LIMIT ? OFFSET ?', params: [limit, offset] }\n\t}\n\tif (limit !== undefined) return { sql: 'LIMIT ?', params: [limit] }\n\tif (offset !== undefined) return { sql: 'LIMIT -1 OFFSET ?', params: [offset] }\n\treturn { sql: '', params: [] }\n}\n\n/**\n * Compile a {@link Criteria} into the SQL clause that follows a table name, with\n * its bound parameters in clause order.\n *\n * @remarks\n * The driver's native `records` / `count` path: it assembles\n * `[where, orderBy, limitOffset]` (each possibly empty) into one clause so a\n * `SELECT * FROM <table> <clause>` runs the whole read in the engine instead of\n * over a JS `scan`. The WHERE fold is parenthesized **left-to-right** to mirror\n * the core engine's `matchesCriteria` (not SQL's native AND-over-OR precedence),\n * so a native and an engine read return identical rows. Each operand is encoded\n * via `encodeValue`: a flat column uses its declared schema type, while a nested\n * `FieldPath` (a `json_extract` read) encodes each operand as the native scalar\n * the extract returns — derived from the operand's runtime type — so it compares.\n * The 15 operators map per the databases guide's operator table, with\n * `starts` / `ends` using `LIKE … ESCAPE '\\'` and an empty `any` / `none` list\n * collapsing to a constant. A `undefined` criteria (or one with no parts)\n * compiles to an empty clause.\n *\n * @param criteria - The read specification, or `undefined` for all rows\n * @param schema - The table's schema (column types for operand encoding)\n * @returns The SQL tail and its bound parameters\n *\n * @example\n * ```ts\n * compileCriteria({ conditions: [{ column: 'age', operator: 'from', values: [18], connector: 'and' }] }, schema)\n * // { sql: 'WHERE \"age\" >= ? ORDER BY \"id\"', params: [18] }\n * ```\n */\nexport function compileCriteria(criteria: Criteria | undefined, schema: TableSchema): CompiledSQL {\n\tconst where = compileWhere(criteria?.conditions ?? [], schema)\n\tconst orderBy = compileOrder(criteria?.order, schema)\n\tconst page = compilePage(criteria?.limit, criteria?.offset)\n\tconst sql = [where.sql, orderBy, page.sql].filter((part) => part !== '').join(' ')\n\treturn { sql, params: [...where.params, ...page.params] }\n}\n","// The server surface's shared constants — reserved names its drivers claim.\n\n/**\n * The reserved metadata table the {@link SQLiteDriver} creates on `open` to\n * persist its stamped `DriverMeta` (`version` + declared schema JSON) — the\n * SQLite realization of the `meta` / `stamp` driver hooks.\n *\n * @remarks\n * A single-row table (`id = 1`). A user table named `_meta` collides with the\n * reservation — the caller's concern to avoid, documented on the driver class.\n */\nexport const META_TABLE = '_meta'\n","import type {\n\tCriteria,\n\tDriverInterface,\n\tDriverMeta,\n\tKey,\n\tMigration,\n\tRow,\n\tTableSchema,\n\tTransactionInterface,\n} from '@src/core'\nimport { DatabaseError, MemoryDriver, extractKey, isDriverMeta } from '@src/core'\nimport { isRecord } from '@orkestrel/contract'\nimport { mkdir, readFile, rename, rm, writeFile } from 'node:fs/promises'\nimport { dirname } from 'node:path'\n\n/**\n * A persistent {@link DriverInterface} backed by a single JSON file — the\n * reference {@link MemoryDriver} plus file load / flush.\n *\n * @remarks\n * A decorator, not a reimplementation: every primitive delegates to an inner\n * {@link MemoryDriver}, so querying, key-order `scan` / `keys`, and capture-replay\n * `snapshot` are inherited unchanged — this layer adds only persistence. `open`\n * loads the file into memory; every mutation (`write` / `delete` / `clear`) flushes\n * the whole store back. The file is one JSON object, `{ meta?: DriverMeta, tables: {\n * [name]: rows } }` — `meta` is present only once the store has been `stamp`ed\n * (an unstamped store serializes the old `{ tables }` shape, preserving\n * backward compatibility); a per-table array of rows, each row carrying its own\n * primary (the table contract), so the key is recovered on load with\n * {@link extractKey} and the file need not store it. The parsed JSON crosses the\n * boundary as `unknown` and is narrowed with {@link isRecord} / {@link extractKey},\n * never asserted (AGENTS §14): a missing, corrupt, or wrong-shaped file starts\n * empty rather than throwing, and a malformed row (or malformed `meta`) is\n * skipped/dropped rather than thrown on. It is scan-only — it implements none of\n * the optional native `records` / `count` / `aggregate` hooks, so the core engine\n * over `scan` answers every query. For development, small datasets, and portable /\n * inspectable data; for large or concurrent workloads reach for a SQLite-backed\n * driver.\n *\n * A failure in the write path ({@link JSONDriver.#serialize} — `mkdir` /\n * `writeFile` / `rename`) is wrapped and rethrown as `DatabaseError` `DRIVER`,\n * carrying the target `path` in its context; the read path ({@link\n * JSONDriver.#load}) tolerance above is a separate, deliberate contract and is\n * never touched by this wrapping.\n */\nexport class JSONDriver implements DriverInterface {\n\treadonly #path: string\n\treadonly #memory = new MemoryDriver()\n\t#schema: readonly TableSchema[] = []\n\t#meta: DriverMeta | undefined\n\t#flushCount = 0\n\t// Serializes #flush calls — each queued flush awaits the prior one before\n\t// serializing state, so the persisted snapshot always reflects the latest\n\t// memory state (see #flush @remarks).\n\t#chain: Promise<void> = Promise.resolve()\n\t// Set while a transaction() handle is active — suppresses #flush from\n\t// write/delete/clear so N mutations under the handle cost one file write\n\t// (on commit) instead of N (see transaction @remarks). Cleared by\n\t// commit/rollback, which is also how double-settle is detected.\n\t#deferring = false\n\n\tconstructor(path: string) {\n\t\tthis.#path = path\n\t}\n\n\tasync open(schema: readonly TableSchema[]): Promise<void> {\n\t\tthis.#schema = schema\n\t\tawait this.#memory.open(schema)\n\t\tawait this.#load()\n\t}\n\n\tasync close(): Promise<void> {\n\t\tawait this.#memory.close()\n\t}\n\n\tasync read(table: string, key: Key): Promise<Row | undefined> {\n\t\treturn this.#memory.read(table, key)\n\t}\n\n\tasync write(table: string, key: Key, row: Row): Promise<void> {\n\t\tawait this.#memory.write(table, key, row)\n\t\tif (!this.#deferring) await this.#flush()\n\t}\n\n\tasync delete(table: string, key: Key): Promise<boolean> {\n\t\tconst removed = await this.#memory.delete(table, key)\n\t\tif (!this.#deferring) await this.#flush()\n\t\treturn removed\n\t}\n\n\tkeys(table: string): Promise<readonly Key[]> {\n\t\treturn this.#memory.keys(table)\n\t}\n\n\tscan(table: string): AsyncIterable<Row> {\n\t\treturn this.#memory.scan(table)\n\t}\n\n\t/**\n\t * Natively filtered lazy iteration — delegates to the inner {@link MemoryDriver}.\n\t *\n\t * @remarks\n\t * Semantics are the memory driver's own: `criteria.conditions` filters, `offset`\n\t * / `limit` page lazily, and `criteria.order` is ignored (streaming yields key\n\t * order; sorted output is `records()`'s job).\n\t *\n\t * @param table - The table to stream\n\t * @param criteria - The filter / offset / limit to apply lazily\n\t */\n\tstream(table: string, criteria: Criteria): AsyncIterable<Row> {\n\t\treturn this.#memory.stream(table, criteria)\n\t}\n\n\tasync clear(table: string): Promise<void> {\n\t\tawait this.#memory.clear(table)\n\t\tif (!this.#deferring) await this.#flush()\n\t}\n\n\t/**\n\t * Begin a native transaction — flush-coalescing over the inner {@link MemoryDriver}.\n\t *\n\t * @remarks\n\t * Single-writer: throws `DatabaseError` `CONFLICT` if a transaction is already\n\t * active — this driver does not support nesting. On begin, captures the inner\n\t * memory rollback thunk via `#memory.snapshot()` and suppresses per-mutation\n\t * `#flush` — `write` / `delete` / `clear` still mutate memory but no longer\n\t * touch the file, so N mutations under the handle cost ONE file write instead\n\t * of N. `commit()` releases the suppression and performs that one atomic\n\t * `#flush()`, persisting the transaction's net state. `rollback()` restores\n\t * memory via the captured snapshot thunk, then `#flush()`s so the file reflects\n\t * the restored state. Outside a transaction, behavior is unchanged — every\n\t * mutation flushes on its own. Calling `commit` / `rollback` a second time (on\n\t * either method, in either order) throws `DatabaseError` `CONFLICT`.\n\t *\n\t * @returns A {@link TransactionInterface} handle to `commit` or `rollback`\n\t */\n\tasync transaction(): Promise<TransactionInterface> {\n\t\tif (this.#deferring) {\n\t\t\tthrow new DatabaseError('CONFLICT', 'A transaction is already active on this driver', {})\n\t\t}\n\t\tconst rollback = await this.#memory.snapshot()\n\t\tthis.#deferring = true\n\t\tlet settled = false\n\t\treturn {\n\t\t\tcommit: async () => {\n\t\t\t\tif (settled) {\n\t\t\t\t\tthrow new DatabaseError('CONFLICT', 'Transaction already settled', {})\n\t\t\t\t}\n\t\t\t\tsettled = true\n\t\t\t\tthis.#deferring = false\n\t\t\t\tawait this.#flush()\n\t\t\t},\n\t\t\trollback: async () => {\n\t\t\t\tif (settled) {\n\t\t\t\t\tthrow new DatabaseError('CONFLICT', 'Transaction already settled', {})\n\t\t\t\t}\n\t\t\t\tsettled = true\n\t\t\t\tawait rollback()\n\t\t\t\tthis.#deferring = false\n\t\t\t\tawait this.#flush()\n\t\t\t},\n\t\t}\n\t}\n\n\tasync snapshot(tables?: readonly string[]): Promise<() => Promise<void>> {\n\t\tconst rollback = await this.#memory.snapshot(tables)\n\t\t// Restore the in-memory state, then re-persist it — the file was rewritten\n\t\t// on each write during the scope, so a rollback must flush the restored state.\n\t\treturn async () => {\n\t\t\tawait rollback()\n\t\t\tawait this.#flush()\n\t\t}\n\t}\n\n\tasync meta(): Promise<DriverMeta | undefined> {\n\t\treturn this.#meta\n\t}\n\n\t/**\n\t * Persist `meta` verbatim for a later `meta()` to return.\n\t *\n\t * @remarks\n\t * Respects the same defer-flush suppression as `write` / `delete` / `clear`\n\t * (see {@link JSONDriver.transaction} @remarks) — stamping inside an active\n\t * transaction updates memory but does not flush until the transaction settles.\n\t *\n\t * @param meta - The {@link DriverMeta} to persist\n\t */\n\tasync stamp(meta: DriverMeta): Promise<void> {\n\t\tthis.#meta = meta\n\t\tif (!this.#deferring) await this.#flush()\n\t}\n\n\t/**\n\t * Apply a {@link Migration} plan by delegating to the inner {@link MemoryDriver},\n\t * then persist the migrated state.\n\t *\n\t * @remarks\n\t * The inner `MemoryDriver.migrate` applies each step (adding/removing tables,\n\t * adding/removing columns from stored rows, no-op index steps) and throws\n\t * `DatabaseError` `MIGRATION` for a step referencing an unknown table — that\n\t * error propagates untouched. `table.add` / `table.remove` steps also update\n\t * this driver's own declared `#schema`, mirroring the bookkeeping `open` does,\n\t * so a subsequent `#flush` / `#load` round-trip includes (or drops) the table.\n\t * A successful migration ends with one atomic `#flush()` so the new state\n\t * survives a close and reopen. A multi-step plan applies its steps\n\t * sequentially and is NOT atomic — a failure partway through a plan leaves\n\t * the earlier steps already applied.\n\t *\n\t * @param plan - The migration plan to apply\n\t */\n\tasync migrate(plan: Migration): Promise<void> {\n\t\tawait this.#memory.migrate?.(plan)\n\t\tlet schema = this.#schema\n\t\tfor (const step of plan.steps) {\n\t\t\tif (step.operation === 'table.add') {\n\t\t\t\tschema = schema.some((table) => table.name === step.table.name)\n\t\t\t\t\t? schema\n\t\t\t\t\t: [...schema, step.table]\n\t\t\t} else if (step.operation === 'table.remove') {\n\t\t\t\tschema = schema.filter((table) => table.name !== step.table)\n\t\t\t}\n\t\t}\n\t\tthis.#schema = schema\n\t\tawait this.#flush()\n\t}\n\n\t// === Private\n\n\t// Load the file into memory; a missing / corrupt / wrong-shaped file starts\n\t// empty (never throws). Each entry is narrowed via isRecord and its key recovered\n\t// with extractKey from the schema's primary column; bad entries are skipped. A\n\t// `meta` block is narrowed with the same tolerance — a malformed or absent\n\t// `meta` leaves #meta undefined (unstamped) rather than throwing, which is how\n\t// an old-format file (no `meta` key) is distinguished from a stamped one.\n\tasync #load(): Promise<void> {\n\t\tlet raw: string\n\t\ttry {\n\t\t\traw = await readFile(this.#path, 'utf-8')\n\t\t} catch {\n\t\t\treturn\n\t\t}\n\t\tlet parsed: unknown\n\t\ttry {\n\t\t\tparsed = JSON.parse(raw)\n\t\t} catch {\n\t\t\treturn\n\t\t}\n\t\tif (!isRecord(parsed) || !isRecord(parsed.tables)) return\n\t\tconst tables = parsed.tables\n\t\tfor (const table of this.#schema) {\n\t\t\tconst rows = tables[table.name]\n\t\t\tif (!Array.isArray(rows)) continue\n\t\t\tfor (const entry of rows) {\n\t\t\t\tif (!isRecord(entry)) continue\n\t\t\t\tconst key = extractKey(entry, table.primary)\n\t\t\t\tif (key === undefined) continue\n\t\t\t\tawait this.#memory.write(table.name, key, entry)\n\t\t\t}\n\t\t}\n\t\tif (isDriverMeta(parsed.meta)) this.#meta = parsed.meta\n\t}\n\n\t// Queue a flush behind #chain — see #flush @remarks for why.\n\tasync #flush(): Promise<void> {\n\t\tconst next = this.#chain.then(() => this.#serialize())\n\t\t// Swallow so a failed flush doesn't leave #chain permanently rejected and\n\t\t// block every later flush; the caller of THIS #flush still observes the\n\t\t// rejection via `next` below.\n\t\tthis.#chain = next.catch(() => {})\n\t\tawait next\n\t}\n\n\t// Drain every declared table's rows from memory (in key order) and write the\n\t// whole store back as one pretty-printed JSON object, creating the directory.\n\t//\n\t// @remarks\n\t// Written atomically: the payload lands in a sibling temp file (same directory,\n\t// so the platform rename is atomic) and is then renamed onto `#path`. A crash\n\t// mid-flush can no longer truncate or corrupt the previous good file — POSIX\n\t// `rename` replaces the destination in one indivisible step, so a reader always\n\t// sees either the old file or the fully-written new one, never a partial write.\n\t// `#flush` serializes calls to this method through `#chain` — each flush AWAITS\n\t// its predecessor before draining `#memory` and writing, so the payload always\n\t// reflects the latest memory state. Without this, overlapping flushes triggered\n\t// by non-awaited concurrent mutations could serialize out of order and persist a\n\t// stale snapshot as the \"latest\" file. `meta` is included in the payload only\n\t// once the store has been stamped, so an unstamped store keeps serializing the\n\t// old `{ tables }` shape (backward compat). Any failure in this write path\n\t// (`mkdir` / `writeFile` / `rename`) is wrapped as `DatabaseError` `DRIVER`\n\t// carrying `path` in its context, after the temp-file cleanup below runs.\n\tasync #serialize(): Promise<void> {\n\t\tconst tables: Record<string, readonly Row[]> = {}\n\t\tfor (const table of this.#schema) {\n\t\t\tconst rows: Row[] = []\n\t\t\tfor await (const row of this.#memory.scan(table.name)) rows.push(row)\n\t\t\ttables[table.name] = rows\n\t\t}\n\t\tthis.#flushCount += 1\n\t\tconst temp = `${this.#path}.${process.pid}.${this.#flushCount}.tmp`\n\t\tconst payload = this.#meta === undefined ? { tables } : { meta: this.#meta, tables }\n\t\ttry {\n\t\t\tawait mkdir(dirname(this.#path), { recursive: true })\n\t\t\tawait writeFile(temp, JSON.stringify(payload, null, 2), 'utf-8')\n\t\t\tawait rename(temp, this.#path)\n\t\t} catch (error) {\n\t\t\tawait rm(temp, { force: true }).catch(() => {})\n\t\t\tthrow new DatabaseError('DRIVER', 'Failed to persist the database file', {\n\t\t\t\tpath: this.#path,\n\t\t\t\tcause: error,\n\t\t\t})\n\t\t}\n\t}\n}\n","import type {\n\tAggregateFunction,\n\tCriteria,\n\tDriverInterface,\n\tDriverMeta,\n\tKey,\n\tMigration,\n\tRow,\n\tTableSchema,\n\tTransactionInterface,\n} from '@src/core'\nimport type { FieldPath } from '@orkestrel/contract'\nimport type { SQLiteDatabaseInterface, SQLiteRow, SQLiteValue } from '@orkestrel/sqlite'\nimport type { SQLiteDriverOptions } from '../types.js'\nimport {\n\tapplyCriteria,\n\tcomputeAggregate,\n\tDatabaseError,\n\tfilterRows,\n\tisDriverMeta,\n\tmatchesCriteria,\n} from '@src/core'\nimport { isString } from '@orkestrel/contract'\nimport { createSQLiteDatabase, isSQLiteError } from '@orkestrel/sqlite'\nimport { compileCriteria, compileWhere } from '../compilers.js'\nimport {\n\taggregateSQL,\n\tdecodeRow,\n\tencodeRow,\n\tencodeValue,\n\tisExactCondition,\n\tisExactCriteria,\n\tquote,\n\tschemaToIndexes,\n\tschemaToTable,\n\tstepToSchema,\n\tstepToSQL,\n} from '../helpers.js'\nimport { META_TABLE } from '../constants.js'\n\n/**\n * The SQLite {@link DriverInterface} — the server-native, trusted-mode backend\n * built on the published `@orkestrel/sqlite` synchronous wrapper.\n *\n * @remarks\n * A thin adapter: it implements the storage primitives the core database layer\n * needs by delegating to the wrapper's prepared statements — it never touches\n * raw `node:sqlite`. `open` issues `CREATE TABLE IF NOT EXISTS` with real typed\n * columns (mapped from each {@link TableSchema}'s portable column types) and a\n * `PRIMARY KEY`, plus a `CREATE INDEX IF NOT EXISTS` per declared index (both\n * reopen-safe), and readies a reserved `_meta` single-row table `meta()` /\n * `stamp()` read and write — **a user table named `_meta` collides with it**;\n * avoid the name. Rows cross the boundary through the codecs in `helpers.ts`\n * (`json` columns store / parse JSON text, a `boolean` stores `1` / `0`), so the\n * typed layer above imposes the exact shape (AGENTS §14). `write` is an\n * `INSERT OR REPLACE` upsert — the `Table` layer detects a `CONFLICT` via a\n * prior `has`, so this never translates a constraint error; a backend\n * `SQLiteError` otherwise propagates unchanged. Querying, ordering, paging, and\n * aggregation are native: `records` / `count` / `stream` compile a `Criteria`\n * to SQL with `compileCriteria`, and `aggregate` runs a SQL\n * `COUNT`/`SUM`/`AVG`/`MIN`/`MAX` (via `aggregateSQL`) over the same compiled\n * WHERE. `transaction` wraps native `BEGIN` / `COMMIT` / `ROLLBACK` with\n * double-settle guards. `migrate` runs the plan's projected DDL\n * ({@link import('../helpers.js').stepToSQL}) inside whichever native\n * transaction is active: joined into an already-open `transaction()` handle\n * when one exists (the core's versioned reconcile path wraps migrate + stamp\n * in one native `BEGIN`, and node:sqlite rejects a nested `BEGIN`), or inside\n * its own `database.transaction` otherwise — a mid-plan failure rolls back\n * atomically either way, an improvement over the non-atomic `MemoryDriver` /\n * `JSONDriver` migrate; a step referencing an undeclared table throws\n * `DatabaseError` `MIGRATION` before any DDL for that step runs. `snapshot` is\n * capture-replay (SELECT the\n * named tables' rows, replay via DELETE + INSERT OR REPLACE inside a native\n * transaction on rollback) rather than a SQL `SAVEPOINT`, since the core\n * `transaction` calls the rollback thunk only on failure with no commit-on-\n * success signal — a long-lived `SAVEPOINT` would leave the connection\n * uncommitted (lost on close). Every backend interaction runs through `#guard`,\n * which maps a thrown backend `SQLiteError` (or any unexpected non-`SQLiteError`\n * throw) to a typed {@link DatabaseError} — never a raw backend error escapes\n * `DriverInterface`: `CONSTRAINT` → `CONFLICT`, the wrapper's own `CLOSED` →\n * `CLOSED`, `BUSY` (a locked database that outlasted the configured `timeout`)\n * → a retryable `DRIVER` (`context.retryable` is `true`), and `UNKNOWN` / any\n * other throw → `DRIVER`. The original error is preserved as `context.cause`.\n * A `DatabaseError` this driver throws directly (`CLOSED` from the `#require`\n * gate, `NOT_FOUND` from `#table`, `MIGRATION` from a migration-plan fault)\n * passes through `#guard` unchanged, never re-wrapped.\n */\nexport class SQLiteDriver implements DriverInterface {\n\treadonly #path: string\n\treadonly #options: SQLiteDriverOptions\n\t#database: SQLiteDatabaseInterface | undefined\n\t#schema = new Map<string, TableSchema>()\n\t#transacting = false\n\n\tconstructor(path: string, options?: SQLiteDriverOptions) {\n\t\tthis.#path = path\n\t\tthis.#options = options ?? {}\n\t}\n\n\tasync open(schema: readonly TableSchema[]): Promise<void> {\n\t\tif (schema.some((table) => table.name === META_TABLE)) {\n\t\t\tthrow new DatabaseError(\n\t\t\t\t'VALIDATION',\n\t\t\t\t`A declared table cannot be named '${META_TABLE}' — it is reserved for driver metadata`,\n\t\t\t\t{ table: META_TABLE },\n\t\t\t)\n\t\t}\n\t\tthis.#guard(() => {\n\t\t\tthis.#database?.close()\n\t\t\tconst database = createSQLiteDatabase({\n\t\t\t\tpath: this.#path,\n\t\t\t\treadonly: this.#options.readonly,\n\t\t\t\ttimeout: this.#options.timeout,\n\t\t\t\tforeignKeys: this.#options.foreignKeys,\n\t\t\t})\n\t\t\tdatabase.connect()\n\t\t\tfor (const [name, value] of Object.entries(this.#options.pragmas ?? {})) {\n\t\t\t\tdatabase.pragma(name, value)\n\t\t\t}\n\t\t\tconst map = new Map<string, TableSchema>()\n\t\t\tfor (const table of schema) {\n\t\t\t\tmap.set(table.name, table)\n\t\t\t\tdatabase.exec(schemaToTable(table))\n\t\t\t\tfor (const sql of schemaToIndexes(table)) database.exec(sql)\n\t\t\t}\n\t\t\tdatabase.exec(\n\t\t\t\t'CREATE TABLE IF NOT EXISTS ' +\n\t\t\t\t\tquote(META_TABLE) +\n\t\t\t\t\t' (\"id\" INTEGER, \"version\" INTEGER, \"schema\" TEXT, PRIMARY KEY (\"id\"))',\n\t\t\t)\n\t\t\tthis.#schema = map\n\t\t\tthis.#database = database\n\t\t})\n\t}\n\n\tasync close(): Promise<void> {\n\t\tthis.#database?.close()\n\t\tthis.#database = undefined\n\t}\n\n\tasync read(table: string, key: Key): Promise<Row | undefined> {\n\t\tconst schema = this.#table(table)\n\t\treturn this.#guard(() => {\n\t\t\tconst row = this.#require()\n\t\t\t\t.prepare('SELECT * FROM ' + quote(table) + ' WHERE ' + quote(schema.primary) + ' = ?')\n\t\t\t\t.get([this.#key(key, schema)])\n\t\t\treturn row === undefined ? undefined : decodeRow(row, schema)\n\t\t})\n\t}\n\n\tasync write(table: string, key: Key, row: Row): Promise<void> {\n\t\tconst schema = this.#table(table)\n\t\tthis.#guard(() => {\n\t\t\tconst encoded = encodeRow({ ...row, [schema.primary]: key }, schema)\n\t\t\tconst names = schema.columns.map((column) => column.name)\n\t\t\tconst values = names.map((name) => encoded[name])\n\t\t\tthis.#require()\n\t\t\t\t.prepare(\n\t\t\t\t\t'INSERT OR REPLACE INTO ' +\n\t\t\t\t\t\tquote(table) +\n\t\t\t\t\t\t' (' +\n\t\t\t\t\t\tnames.map(quote).join(', ') +\n\t\t\t\t\t\t') VALUES (' +\n\t\t\t\t\t\tnames.map(() => '?').join(', ') +\n\t\t\t\t\t\t')',\n\t\t\t\t)\n\t\t\t\t.run(values)\n\t\t})\n\t}\n\n\tasync delete(table: string, key: Key): Promise<boolean> {\n\t\tconst schema = this.#table(table)\n\t\treturn this.#guard(() => {\n\t\t\tconst result = this.#require()\n\t\t\t\t.prepare('DELETE FROM ' + quote(table) + ' WHERE ' + quote(schema.primary) + ' = ?')\n\t\t\t\t.run([this.#key(key, schema)])\n\t\t\treturn result.changes > 0\n\t\t})\n\t}\n\n\tasync keys(table: string): Promise<readonly Key[]> {\n\t\tconst schema = this.#table(table)\n\t\treturn this.#guard(() => {\n\t\t\tconst primary = quote(schema.primary)\n\t\t\t// ORDER BY the primary key: the contract lists keys in key order, and\n\t\t\t// SQLite returns rows in rowid (insertion) order without it.\n\t\t\tconst rows = this.#require()\n\t\t\t\t.prepare('SELECT ' + primary + ' FROM ' + quote(table) + ' ORDER BY ' + primary)\n\t\t\t\t.all()\n\t\t\tconst keys: Key[] = []\n\t\t\tfor (const row of rows) {\n\t\t\t\tconst value = row[schema.primary]\n\t\t\t\tif (typeof value === 'string' || typeof value === 'number') keys.push(value)\n\t\t\t}\n\t\t\treturn keys\n\t\t})\n\t}\n\n\tasync *scan(table: string): AsyncIterable<Row> {\n\t\tconst schema = this.#table(table)\n\t\t// ORDER BY the primary key so the scan yields rows in key order (the engine\n\t\t// and cursors depend on it), not SQLite's default rowid order. Every step —\n\t\t// the iterator setup, each `next()` pull, and each row's decode — runs\n\t\t// through #guard, so a mid-iteration backend fault (not just the initial\n\t\t// call) surfaces as a mapped DatabaseError rather than leaking raw.\n\t\tconst iterator = this.#guard(() =>\n\t\t\tthis.#require()\n\t\t\t\t.prepare('SELECT * FROM ' + quote(table) + ' ORDER BY ' + quote(schema.primary))\n\t\t\t\t.iterate(),\n\t\t)[Symbol.iterator]()\n\t\twhile (true) {\n\t\t\tconst step = this.#guard(() => iterator.next())\n\t\t\tif (step.done === true) return\n\t\t\tyield this.#guard(() => decodeRow(step.value, schema))\n\t\t}\n\t}\n\n\tasync clear(table: string): Promise<void> {\n\t\tthis.#table(table)\n\t\tthis.#guard(() => {\n\t\t\tthis.#require()\n\t\t\t\t.prepare('DELETE FROM ' + quote(table))\n\t\t\t\t.run()\n\t\t})\n\t}\n\n\t// Doctrine (AGENTS §5, the audit's keystone fix): a Criteria whose compiled\n\t// SQL is PROVABLY identical to the core engine's semantics (see\n\t// `isExactCondition` / `isExactOrder` / `isExactCriteria`) runs the fast\n\t// native path; otherwise this driver fetches a full scan and refines it\n\t// through the SAME core engine every scan-only driver (`MemoryDriver`,\n\t// `JSONDriver`) already uses — exact → native, otherwise → refine, never a\n\t// silent semantics drift between backends. A native `WHERE` that is a\n\t// PROVABLE SUPERSET of the engine's match set (compile natively, then\n\t// engine-refine only the returned rows) is a possible future optimization,\n\t// not implemented here.\n\tasync records(table: string, criteria: Criteria): Promise<readonly Row[]> {\n\t\tconst schema = this.#table(table)\n\t\tif (isExactCriteria(criteria, schema)) {\n\t\t\treturn this.#guard(() => {\n\t\t\t\tconst { sql, params } = compileCriteria(criteria, schema)\n\t\t\t\tconst rows = this.#require()\n\t\t\t\t\t.prepare('SELECT * FROM ' + quote(table) + (sql === '' ? '' : ' ' + sql))\n\t\t\t\t\t.all(params)\n\t\t\t\treturn rows.map((row) => decodeRow(row, schema))\n\t\t\t})\n\t\t}\n\t\tconst rows: Row[] = []\n\t\tfor await (const row of this.scan(table)) rows.push(row)\n\t\treturn applyCriteria(rows, criteria)\n\t}\n\n\tasync count(table: string, criteria: Criteria): Promise<number> {\n\t\tconst schema = this.#table(table)\n\t\tconst conditions = criteria.conditions ?? []\n\t\tif (conditions.every((condition) => isExactCondition(condition, schema))) {\n\t\t\treturn this.#guard(() => {\n\t\t\t\t// Compile only the WHERE clause — no ORDER BY, no LIMIT/OFFSET — so a\n\t\t\t\t// direct call with `criteria.offset` set never skips the single\n\t\t\t\t// aggregate row (`compileCriteria`'s paging would otherwise apply\n\t\t\t\t// OFFSET/LIMIT to the one-row COUNT result).\n\t\t\t\tconst { sql, params } = compileWhere(conditions, schema)\n\t\t\t\tconst row = this.#require()\n\t\t\t\t\t.prepare('SELECT COUNT(*) AS count FROM ' + quote(table) + (sql === '' ? '' : ' ' + sql))\n\t\t\t\t\t.get(params)\n\t\t\t\tconst value = row?.count\n\t\t\t\treturn typeof value === 'number' || typeof value === 'bigint' ? Number(value) : 0\n\t\t\t})\n\t\t}\n\t\tconst rows: Row[] = []\n\t\tfor await (const row of this.scan(table)) rows.push(row)\n\t\treturn filterRows(rows, conditions).length\n\t}\n\n\tasync aggregate(\n\t\ttable: string,\n\t\toperation: AggregateFunction,\n\t\tcolumn: FieldPath,\n\t\tcriteria: Criteria,\n\t): Promise<number | undefined> {\n\t\tconst schema = this.#table(table)\n\t\tconst conditions = criteria.conditions ?? []\n\t\tconst conditionsExact = conditions.every((condition) => isExactCondition(condition, schema))\n\t\t// `count` ignores `column` entirely (COUNT(*) over rows), so only the\n\t\t// conditions need to be exact; every other aggregate coerces the column\n\t\t// numerically (parseNumber) — only a flat, declared integer/real column\n\t\t// is provably exact (a text/json/blob column may hold non-numeric cells\n\t\t// the engine skips via parseNumber, which SQL's numeric aggregates do not).\n\t\tconst columnExact =\n\t\t\toperation === 'count' ||\n\t\t\t(isString(column) &&\n\t\t\t\tschema.columns.some(\n\t\t\t\t\t(candidate) =>\n\t\t\t\t\t\tcandidate.name === column &&\n\t\t\t\t\t\t(candidate.type === 'integer' || candidate.type === 'real'),\n\t\t\t\t))\n\t\tif (conditionsExact && columnExact) {\n\t\t\treturn this.#guard(() => {\n\t\t\t\t// WHERE-only compile — same rationale as `count`: paging must never\n\t\t\t\t// apply to the single aggregate row.\n\t\t\t\tconst { sql, params } = compileWhere(conditions, schema)\n\t\t\t\tconst value = this.#require()\n\t\t\t\t\t.prepare(\n\t\t\t\t\t\t'SELECT ' +\n\t\t\t\t\t\t\taggregateSQL(operation, column) +\n\t\t\t\t\t\t\t' AS value FROM ' +\n\t\t\t\t\t\t\tquote(table) +\n\t\t\t\t\t\t\t(sql === '' ? '' : ' ' + sql),\n\t\t\t\t\t)\n\t\t\t\t\t.get(params)?.value\n\t\t\t\t// Over zero matched rows SUM/AVG/MIN/MAX are SQL NULL → undefined (the\n\t\t\t\t// engine agrees); COUNT(*) is 0. A clean numeric column coerces as the\n\t\t\t\t// engine does.\n\t\t\t\treturn value === null || value === undefined ? undefined : Number(value)\n\t\t\t})\n\t\t}\n\t\tconst rows: Row[] = []\n\t\tfor await (const row of this.scan(table)) rows.push(row)\n\t\treturn computeAggregate(filterRows(rows, conditions), operation, column)\n\t}\n\n\t// `order` is intentionally IGNORED (per DriverInterface.stream — streaming\n\t// yields unsorted), so the native gate checks only `conditions`; `offset` /\n\t// `limit` are always engine-identical under either path.\n\tasync *stream(table: string, criteria: Criteria): AsyncIterable<Row> {\n\t\tconst schema = this.#table(table)\n\t\tconst conditions = criteria.conditions ?? []\n\t\tif (conditions.every((condition) => isExactCondition(condition, schema))) {\n\t\t\tconst compiled = compileCriteria(\n\t\t\t\t{ conditions, limit: criteria.limit, offset: criteria.offset },\n\t\t\t\tschema,\n\t\t\t)\n\t\t\tfor (const row of this.#require()\n\t\t\t\t.prepare('SELECT * FROM ' + quote(table) + (compiled.sql === '' ? '' : ' ' + compiled.sql))\n\t\t\t\t.iterate(compiled.params)) {\n\t\t\t\tyield decodeRow(row, schema)\n\t\t\t}\n\t\t\treturn\n\t\t}\n\t\tconst offset = criteria.offset ?? 0\n\t\tconst limit = criteria.limit\n\t\tlet skipped = 0\n\t\tlet yielded = 0\n\t\tfor await (const row of this.scan(table)) {\n\t\t\tif (limit !== undefined && yielded >= limit) return\n\t\t\tif (conditions.length > 0 && !matchesCriteria(row, conditions)) continue\n\t\t\tif (skipped < offset) {\n\t\t\t\tskipped += 1\n\t\t\t\tcontinue\n\t\t\t}\n\t\t\tyield row\n\t\t\tyielded += 1\n\t\t}\n\t}\n\n\t/**\n\t * Begin a native transaction — real `BEGIN`, `COMMIT`, `ROLLBACK`.\n\t *\n\t * @remarks\n\t * Calling `commit` or `rollback` a second time (on either method, in either\n\t * order) throws `DatabaseError` `CONFLICT`.\n\t *\n\t * @returns A {@link TransactionInterface} handle to `commit` or `rollback`\n\t */\n\tasync transaction(): Promise<TransactionInterface> {\n\t\tconst database = this.#require()\n\t\tthis.#guard(() => database.exec('BEGIN'))\n\t\tlet settled = false\n\t\tthis.#transacting = true\n\t\treturn {\n\t\t\tcommit: async () => {\n\t\t\t\tif (settled) {\n\t\t\t\t\tthrow new DatabaseError('CONFLICT', 'Transaction already settled', {})\n\t\t\t\t}\n\t\t\t\tsettled = true\n\t\t\t\tthis.#transacting = false\n\t\t\t\tthis.#guard(() => database.exec('COMMIT'))\n\t\t\t},\n\t\t\trollback: async () => {\n\t\t\t\tif (settled) {\n\t\t\t\t\tthrow new DatabaseError('CONFLICT', 'Transaction already settled', {})\n\t\t\t\t}\n\t\t\t\tsettled = true\n\t\t\t\tthis.#transacting = false\n\t\t\t\tthis.#guard(() => database.exec('ROLLBACK'))\n\t\t\t},\n\t\t}\n\t}\n\n\t/**\n\t * Apply a {@link Migration} plan by executing each step's projected DDL\n\t * ({@link import('../helpers.js').stepToSQL}).\n\t *\n\t * @remarks\n\t * Atomicity is provided by whichever native transaction is active: when\n\t * this driver's own `transaction()` hook already has a handle open (the\n\t * core's versioned reconcile / migrate path joins migrate + stamp under\n\t * one native `BEGIN`), the plan's DDL runs directly inside that enclosing\n\t * transaction — a mid-plan failure propagates out and the CALLER's\n\t * `commit`/`rollback` provides atomicity. node:sqlite (and SQLite\n\t * generally) rejects a nested `BEGIN`, so this driver must never open a\n\t * second native transaction while one is already open. Otherwise (no\n\t * enclosing transaction), `migrate` wraps the plan in its own native\n\t * `database.transaction` — atomic on its own: a mid-plan failure rolls\n\t * back every DDL statement already applied by the plan. A step\n\t * referencing a table not in this driver's declared schema (and that is\n\t * not itself a `table.add`) throws `DatabaseError` `MIGRATION` before any\n\t * DDL for that step runs, propagating out of whichever transaction is\n\t * active (which rolls back on a throw).\n\t *\n\t * @param plan - The migration plan to apply\n\t */\n\tasync migrate(plan: Migration): Promise<void> {\n\t\tconst database = this.#require()\n\t\tconst schema = new Map(this.#schema)\n\t\tthis.#guard(() => {\n\t\t\tif (this.#transacting) {\n\t\t\t\tthis.#applyPlan(database, plan, schema)\n\t\t\t} else {\n\t\t\t\tdatabase.transaction(() => this.#applyPlan(database, plan, schema))\n\t\t\t}\n\t\t})\n\t\tthis.#schema = schema\n\t}\n\n\t/**\n\t * Read the persisted {@link DriverMeta} from the reserved `_meta` table.\n\t *\n\t * @returns The last-stamped `DriverMeta`, or `undefined` when never stamped\n\t *   (or the stored row is malformed)\n\t */\n\tasync meta(): Promise<DriverMeta | undefined> {\n\t\tconst row = this.#guard(() =>\n\t\t\tthis.#require()\n\t\t\t\t.prepare('SELECT \"version\", \"schema\" FROM ' + quote(META_TABLE) + ' WHERE \"id\" = 1')\n\t\t\t\t.get(),\n\t\t)\n\t\tif (row === undefined) return undefined\n\t\tconst version = row.version\n\t\tconst text = row.schema\n\t\tif (typeof text !== 'string') return undefined\n\t\tif (typeof version !== 'number' && typeof version !== 'bigint') return undefined\n\t\tlet parsed: unknown\n\t\ttry {\n\t\t\tparsed = JSON.parse(text)\n\t\t} catch {\n\t\t\treturn undefined\n\t\t}\n\t\tconst candidate = { version: Number(version), schema: parsed }\n\t\tif (!isDriverMeta(candidate)) return undefined\n\t\treturn candidate\n\t}\n\n\t/**\n\t * Persist `meta` verbatim (as JSON) into the reserved `_meta` table's single\n\t * row.\n\t *\n\t * @param meta - The {@link DriverMeta} to persist\n\t */\n\tasync stamp(meta: DriverMeta): Promise<void> {\n\t\tthis.#guard(() => {\n\t\t\tthis.#require()\n\t\t\t\t.prepare(\n\t\t\t\t\t'INSERT OR REPLACE INTO ' +\n\t\t\t\t\t\tquote(META_TABLE) +\n\t\t\t\t\t\t' (\"id\", \"version\", \"schema\") VALUES (1, ?, ?)',\n\t\t\t\t)\n\t\t\t\t.run([meta.version, JSON.stringify(meta.schema)])\n\t\t})\n\t}\n\n\tasync snapshot(tables?: readonly string[]): Promise<() => Promise<void>> {\n\t\tconst database = this.#require()\n\t\t// Capture-replay rather than a SQL SAVEPOINT: the core `transaction` calls\n\t\t// the rollback thunk only on failure, with no commit-on-success signal — a\n\t\t// long-lived SAVEPOINT would leave the connection in an uncommitted\n\t\t// transaction (lost on close). Captured rows are already encoded, so they\n\t\t// reinsert directly. `tables` omitted captures/restores the whole schema.\n\t\tconst names = tables ?? [...this.#schema.keys()]\n\t\tconst captured = new Map<\n\t\t\tstring,\n\t\t\t{ readonly names: readonly string[]; readonly rows: readonly SQLiteRow[] }\n\t\t>()\n\t\tfor (const name of names) {\n\t\t\tconst schema = this.#schema.get(name)\n\t\t\tif (schema === undefined) continue\n\t\t\tcaptured.set(name, {\n\t\t\t\tnames: schema.columns.map((column) => column.name),\n\t\t\t\trows: database.prepare('SELECT * FROM ' + quote(name)).all(),\n\t\t\t})\n\t\t}\n\t\treturn async () => {\n\t\t\tconst current = this.#require()\n\t\t\tcurrent.transaction(() => {\n\t\t\t\tfor (const [name, snapshot] of captured) {\n\t\t\t\t\tcurrent.exec('DELETE FROM ' + quote(name))\n\t\t\t\t\tconst statement = current.prepare(\n\t\t\t\t\t\t'INSERT OR REPLACE INTO ' +\n\t\t\t\t\t\t\tquote(name) +\n\t\t\t\t\t\t\t' (' +\n\t\t\t\t\t\t\tsnapshot.names.map(quote).join(', ') +\n\t\t\t\t\t\t\t') VALUES (' +\n\t\t\t\t\t\t\tsnapshot.names.map(() => '?').join(', ') +\n\t\t\t\t\t\t\t')',\n\t\t\t\t\t)\n\t\t\t\t\tfor (const row of snapshot.rows) {\n\t\t\t\t\t\tstatement.run(snapshot.names.map((column) => row[column]))\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t})\n\t\t}\n\t}\n\n\t// === Private\n\n\t// Run a synchronous backend interaction, mapping any `SQLiteError` (or\n\t// unexpected non-`SQLiteError` throw) to a typed `DatabaseError` so a\n\t// backend fault never leaks through `DriverInterface` unwrapped: a\n\t// `CONSTRAINT` violation becomes `CONFLICT`; the wrapper's own `CLOSED`\n\t// passes through as `CLOSED`; a `BUSY` (a locked database that outlasted\n\t// the configured `timeout`) becomes a `DRIVER` error whose context marks it\n\t// `retryable`; `UNKNOWN` and any non-`SQLiteError` throw become `DRIVER`.\n\t// A `DatabaseError` already thrown by this driver itself (the `#require`\n\t// `CLOSED` gate, `#table`'s `NOT_FOUND`, a `MIGRATION` step fault) passes\n\t// through unchanged — it is never re-wrapped. The original error is kept\n\t// as `context.cause` for diagnostics.\n\t#guard<T>(run: () => T): T {\n\t\ttry {\n\t\t\treturn run()\n\t\t} catch (error) {\n\t\t\tif (error instanceof DatabaseError) throw error\n\t\t\tif (isSQLiteError(error)) {\n\t\t\t\tif (error.code === 'CONSTRAINT') {\n\t\t\t\t\tthrow new DatabaseError('CONFLICT', error.message, { cause: error, code: error.code })\n\t\t\t\t}\n\t\t\t\tif (error.code === 'CLOSED') {\n\t\t\t\t\tthrow new DatabaseError('CLOSED', error.message, { cause: error, code: error.code })\n\t\t\t\t}\n\t\t\t\tif (error.code === 'BUSY') {\n\t\t\t\t\tthrow new DatabaseError('DRIVER', error.message, {\n\t\t\t\t\t\tcause: error,\n\t\t\t\t\t\tcode: error.code,\n\t\t\t\t\t\tretryable: true,\n\t\t\t\t\t})\n\t\t\t\t}\n\t\t\t\tthrow new DatabaseError('DRIVER', error.message, { cause: error, code: error.code })\n\t\t\t}\n\t\t\tthrow new DatabaseError('DRIVER', error instanceof Error ? error.message : String(error), {\n\t\t\t\tcause: error,\n\t\t\t})\n\t\t}\n\t}\n\n\t#require(): SQLiteDatabaseInterface {\n\t\tif (this.#database === undefined) {\n\t\t\tthrow new DatabaseError('CLOSED', `SQLite database '${this.#path}' is not open`, {\n\t\t\t\tpath: this.#path,\n\t\t\t})\n\t\t}\n\t\treturn this.#database\n\t}\n\n\t// Require the database open and resolve a declared table's schema.\n\t#table(name: string): TableSchema {\n\t\tthis.#require()\n\t\tconst schema = this.#schema.get(name)\n\t\tif (schema === undefined) {\n\t\t\tthrow new DatabaseError('NOT_FOUND', `Table '${name}' is not in the schema`, { table: name })\n\t\t}\n\t\treturn schema\n\t}\n\n\t// Encode a primary key for binding against its column's stored type.\n\t#key(key: Key, schema: TableSchema): SQLiteValue {\n\t\tconst primary = schema.columns.find((column) => column.name === schema.primary)\n\t\treturn encodeValue(key, primary === undefined ? 'text' : primary.type)\n\t}\n\n\t// Walk a migration plan's steps, executing each one's projected DDL and updating\n\t// the working `schema` copy in place — shared by both `migrate`'s joined-transaction\n\t// (native handle already open) and self-wrapped (own `database.transaction`) paths.\n\t#applyPlan(\n\t\tdatabase: SQLiteDatabaseInterface,\n\t\tplan: Migration,\n\t\tschema: Map<string, TableSchema>,\n\t): void {\n\t\tfor (const step of plan.steps) {\n\t\t\tconst table = step.operation === 'table.add' ? step.table.name : step.table\n\t\t\tif (step.operation !== 'table.add' && !schema.has(table)) {\n\t\t\t\tthrow new DatabaseError('MIGRATION', `migrate: unknown table '${table}'`, { table })\n\t\t\t}\n\t\t\tfor (const sql of stepToSQL(step)) database.exec(sql)\n\t\t\tif (step.operation === 'table.add') {\n\t\t\t\tschema.set(step.table.name, step.table)\n\t\t\t} else if (step.operation === 'table.remove') {\n\t\t\t\tschema.delete(step.table)\n\t\t\t} else {\n\t\t\t\tconst existing = schema.get(table)\n\t\t\t\tif (existing !== undefined) schema.set(table, stepToSchema(existing, step))\n\t\t\t}\n\t\t}\n\t}\n}\n","import type { DriverInterface } from '@src/core'\nimport type { SQLiteDriverOptions } from './types.js'\nimport { isString } from '@orkestrel/contract'\nimport { JSONDriver } from './drivers/JSONDriver.js'\nimport { SQLiteDriver } from './drivers/SQLiteDriver.js'\n\n/**\n * Create a persistent JSON-file {@link DriverInterface} for the core database layer.\n *\n * @remarks\n * Pass it to `createDatabase` from `@orkestrel/database` to run the whole typed database +\n * relations stack against a single JSON file instead of memory — the `Database` /\n * `Table` / `Query` / relations API is unchanged; only where the bytes live changes.\n * The driver is the reference `MemoryDriver` plus JSON-file persistence: `open` loads\n * the file, every mutation flushes the whole store back, and querying runs through\n * the core engine over `scan` (it is scan-only — no native `records` / `count` /\n * `aggregate`). A missing, corrupt, or wrong-shaped file starts empty rather than\n * throwing.\n *\n * @param path - The JSON file path data is loaded from and flushed to\n * @returns A {@link DriverInterface} backed by a JSON file\n *\n * @example\n * ```ts\n * import { createDatabase } from '@orkestrel/database'\n * import { stringShape } from '@orkestrel/contract'\n * import { createJSONDriver } from '@orkestrel/database/server'\n *\n * const db = createDatabase({\n * \tdriver: createJSONDriver('data/app.json'),\n * \ttables: { users: { id: stringShape(), name: stringShape() } },\n * })\n * await db.table('users').set({ id: 'u1', name: 'Ada' }) // persisted to app.json\n * ```\n */\nexport function createJSONDriver(path: string): DriverInterface {\n\treturn new JSONDriver(path)\n}\n\n/**\n * Create a trusted-mode SQLite {@link DriverInterface} for the core database layer.\n *\n * @remarks\n * Pass it to `createDatabase` from `@orkestrel/database` to run the whole typed database +\n * relations stack against a real SQLite database — the `Database` / `Table` /\n * `Query` / relations API is unchanged; only where the bytes live changes. Built\n * on the published `@orkestrel/sqlite` synchronous wrapper: `open` issues real\n * typed `CREATE TABLE` / `CREATE INDEX` statements (reopen-safe) plus a reserved\n * `_meta` table for `meta()` / `stamp()` — avoid naming a table `_meta`.\n * Querying, paging, and aggregation run natively (`records` / `count` /\n * `aggregate` / `stream`); `transaction` and `migrate` use real `BEGIN` /\n * `COMMIT` / `ROLLBACK`, so `migrate` is atomic even mid-plan.\n *\n * @param options - A bare database file path (`':memory:'` by default, for\n *   back-compat), or a full {@link SQLiteDriverOptions} bag (`path`,\n *   `readonly`, `timeout`, `foreignKeys`, `pragmas`)\n * @returns A {@link DriverInterface} backed by SQLite\n *\n * @example\n * ```ts\n * import { createDatabase } from '@orkestrel/database'\n * import { stringShape } from '@orkestrel/contract'\n * import { createSQLiteDriver } from '@orkestrel/database/server'\n *\n * const db = createDatabase({\n * \tdriver: createSQLiteDriver('data/app.sqlite'),\n * \ttables: { users: { id: stringShape(), name: stringShape() } },\n * })\n * await db.table('users').set({ id: 'u1', name: 'Ada' }) // persisted to app.sqlite\n *\n * // Or with options:\n * createSQLiteDriver({ path: 'data/app.sqlite', pragmas: { journal_mode: 'WAL' } })\n * ```\n */\nexport function createSQLiteDriver(\n\toptions: string | SQLiteDriverOptions = ':memory:',\n): DriverInterface {\n\tconst resolved: SQLiteDriverOptions = isString(options) ? { path: options } : options\n\treturn new SQLiteDriver(resolved.path ?? ':memory:', resolved)\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.cjs","names":["#path","#memory","#schema","#load","#deferring","#flush","#transaction","#commit","#rollback","#meta","#chain","#serialize","#flushCount","#path","#options","#guard","#database","#schema","#table","#require","#key","#transaction","#commit","#rollback","#applyPlan"],"sources":["../../../src/server/constants.ts","../../../src/server/helpers.ts","../../../src/server/compilers.ts","../../../src/server/drivers/JSONDriver.ts","../../../src/server/drivers/SQLiteDriver.ts","../../../src/server/factories.ts"],"sourcesContent":["import type { ColumnType } from '@src/core'\n\n// The server surface's shared constants — reserved names its drivers claim and\n// the declared column groups that SQLite can query without engine refinement.\n\n/**\n * The declared {@link ColumnType}s whose SQL EQUALITY comparisons (`equals` /\n * `not` / `any` / `none`) and `starts` / `ends` compiles are provably\n * engine-exact under declared-type trust — `text` / `integer` / `real` /\n * `boolean`; a `json` or `blob` column always refines instead.\n *\n * @remarks\n * This set governs equality and prefix/suffix matching only. RANGE\n * comparisons (`above` / `below` / `from` / `to` / `between`) and `ORDER BY`\n * are exact for `integer` / `real` / `boolean` but NOT for `text`: compiled\n * SQL orders/ranges under SQLite's default BINARY collation, which compares\n * TEXT byte-for-byte as UTF-8 — equivalent to Unicode CODE-POINT order —\n * while the core engine's `compareValues` orders JS strings with `<`, which\n * compares UTF-16 CODE-UNIT order. The two orders diverge for supplementary-\n * plane characters (code points ≥ U+10000, e.g. many emoji): a lead surrogate\n * (`\\uD800`–`\\uDBFF`) sorts BELOW ``–`￿` in code-unit order, while\n * its code point sorts ABOVE them. So `isExactCondition`'s range family and\n * `isExactOrder` exclude `text`, refining through the core engine instead. A\n * future opt-in \"trusted collation\" mode (the caller vouches the column's\n * values are BMP-only, or a custom SQLite collation matching `compareValues`\n * is registered) could restore native text ranges/ordering.\n */\nexport const EXACT_COLUMN_TYPES: readonly ColumnType[] = Object.freeze([\n\t'text',\n\t'integer',\n\t'real',\n\t'boolean',\n])\n\n/**\n * The declared {@link ColumnType}s whose SQL RANGE comparisons\n * (`above` / `below` / `from` / `to` / `between`) and `ORDER BY` compiles are\n * provably engine-exact — `integer` / `real` / `boolean` only. `text` is\n * excluded: see {@link EXACT_COLUMN_TYPES}'s remarks for the BINARY-collation\n * (code-point) vs. JS `<` (code-unit) divergence on supplementary-plane\n * characters.\n */\nexport const EXACT_RANGE_COLUMN_TYPES: readonly ColumnType[] = Object.freeze([\n\t'integer',\n\t'real',\n\t'boolean',\n])\n\n/**\n * The reserved metadata table the {@link SQLiteDriver} creates on `open` to\n * persist its stamped `DriverMeta` (`version` + declared schema JSON) — the\n * SQLite realization of the `meta` / `stamp` driver hooks.\n *\n * @remarks\n * A single-row table (`id = 1`). A user table named `_meta` collides with the\n * reservation — the caller's concern to avoid, documented on the driver class.\n */\nexport const META_TABLE = '_meta'\n","import type {\n\tAggregateFunction,\n\tColumnType,\n\tCondition,\n\tCriteria,\n\tMigrationStep,\n\tOrder,\n\tRow,\n\tTableSchema,\n} from '@src/core'\nimport type { FieldPath } from '@orkestrel/contract'\nimport type { SQLiteRow, SQLiteValue } from './types.js'\nimport { DatabaseError } from '@src/core'\nimport { isBoolean, isFiniteNumber, isString } from '@orkestrel/contract'\nimport { randomUUID } from 'node:crypto'\nimport { EXACT_COLUMN_TYPES, EXACT_RANGE_COLUMN_TYPES } from './constants.js'\n\n// The server's key-minting `KeyFunction` implementation — `core` mints no keys\n// itself (AGENTS §1: cross-environment code touches no `node:*`), so a server\n// consumer wires this in as `DatabaseOptions.key`.\n//\n// Below it: the SQLite ↔ JS bridge for the driver. Every helper is pure and\n// total — it narrows with `typeof` / `instanceof`, never `as` (AGENTS §1, §14):\n// a value that does not fit its column's storage type encodes to `null` rather\n// than throwing, and `decodeValue` is the exact inverse. `encodeRow` /\n// `decodeRow` lift the per-cell codecs across a whole schema; the SQL\n// identifier / type helpers (`quote`, `columnSQL`, `fieldColumn`) build the\n// static parts of a statement. `schemaToTable` / `schemaToIndexes` are pure\n// projections of the CREATE TABLE / CREATE INDEX DDL a SQLite driver's `open`\n// issues. This module speaks pure strings/values only — it imports no SQLite\n// package.\n\n/**\n * Generate a fresh unique key — a v4 UUID string, backed by `node:crypto`.\n *\n * @remarks\n * Supply this as {@link import('@orkestrel/database').DatabaseOptions.key} so a table mints\n * a key when a written row lacks its primary-key value. Strings work as keys on\n * every backend; supply your own key values directly to use numeric keys instead.\n *\n * @returns A new UUID string\n *\n * @example\n * ```ts\n * const db = createDatabase({ driver, tables, key: generateKey })\n * ```\n */\nexport function generateKey(): string {\n\treturn randomUUID()\n}\n\n// === Exactness (native ↔ engine parity gating)\n//\n// SQLiteDriver's `records` / `count` / `aggregate` / `stream` compile a\n// `Criteria` straight to SQL with NO engine re-filter — a huge perf win, but\n// only sound for a condition/order whose compiled SQL provably matches the\n// core engine's `matchesCondition` / `sortRows` semantics for every value a\n// contract-validated write can store (\"declared-type trust\"). These guards\n// decide, per condition/order/criteria, whether that proof holds; when it does\n// not, the driver falls back to a full scan refined through the same core\n// engine every scan-only driver (`MemoryDriver`, `JSONDriver`) already uses —\n// exact → native, otherwise → refine, never a silent semantics drift.\n\n/**\n * Whether a value's runtime type matches a column's declared exact type —\n * the operand side of the declared-type-trust proof.\n *\n * @remarks\n * `text` ↔ string, `integer` / `real` ↔ FINITE number (`NaN` / `±Infinity`\n * fail), `boolean` ↔ boolean. Backs {@link isExactCondition}'s operand checks.\n *\n * @param value - The condition operand to test\n * @param type - The column's declared portable type\n * @returns `true` when the operand's runtime type matches the declared type\n *\n * @example\n * ```ts\n * matchesDeclaredType('Ada', 'text') // true\n * matchesDeclaredType(Number.NaN, 'integer') // false — only finite numbers\n * ```\n */\nexport function matchesDeclaredType(value: unknown, type: ColumnType): boolean {\n\tif (type === 'text') return isString(value)\n\tif (type === 'boolean') return isBoolean(value)\n\treturn isFiniteNumber(value)\n}\n\n/**\n * Whether one {@link Condition} compiles to SQL that is PROVABLY identical to\n * the core engine's `matchesCondition` for every value its column's declared\n * type can store.\n *\n * @remarks\n * `false` for a nested `FieldPath` (an array), a column absent from `schema`,\n * or a column whose declared type is not `text` / `integer` / `real` /\n * `boolean` (a `json` / `blob` column) — EXCEPT `absent` / `present`, which\n * compile to `IS NULL` / `IS NOT NULL` and match `decodeRow`'s \"a stored NULL\n * decodes to `undefined`\" rule for every column type, so they are exact\n * regardless of declared type. `equals` / `not` require a operand matching the\n * column's declared type (a `null` / `undefined` operand is never exact here —\n * `encodeRow` stores both an explicit `null` and an absent field as SQL NULL,\n * so native `IS NULL` semantics cannot match the engine's `deepEqual`-over-\n * decoded-rows truth). `above` / `below` / `from` / `to` / `between` are exact\n * ONLY for a declared type in {@link EXACT_RANGE_COLUMN_TYPES} (`integer` /\n * `real` / `boolean`) — a `text` column's range conditions REFINE, because\n * SQLite's default BINARY collation orders TEXT by Unicode CODE POINT while\n * the core engine's `compareValues` orders JS strings by UTF-16 CODE UNIT,\n * and the two diverge for supplementary-plane characters (see\n * {@link EXACT_COLUMN_TYPES}'s remarks for the full rationale).\n * `any` / `none` require a NON-EMPTY list where every element matches (an empty\n * list is exact under neither: the engine's `any([])` matches nothing while\n * `none([])` matches everything, and SQL `IN ()` is a syntax error) — these\n * stay exact on `text` (byte equality is collation-independent and engine-\n * identical). `starts` / `ends` are exact only on a `text` column with a\n * string operand (case-sensitive `substr` compile, see {@link fragment}) —\n * likewise collation-independent. `like` / `glob` are NEVER exact — SQLite\n * `LIKE` folds case ASCII-only against the engine's Unicode fold, and `GLOB`\n * has character classes the engine treats literally.\n *\n * @param condition - The condition to test\n * @param schema - The table's schema\n * @returns Whether `condition` is exact\n */\nexport function isExactCondition(condition: Condition, schema: TableSchema): boolean {\n\tif (!isString(condition.column)) return false\n\tconst column = schema.columns.find((candidate) => candidate.name === condition.column)\n\tif (column === undefined) return false\n\tif (condition.operator === 'absent' || condition.operator === 'present') return true\n\tif (!EXACT_COLUMN_TYPES.some((type) => type === column.type)) return false\n\tconst first = condition.values[0]\n\tconst second = condition.values[1]\n\tswitch (condition.operator) {\n\t\tcase 'equals':\n\t\tcase 'not':\n\t\t\treturn matchesDeclaredType(first, column.type)\n\t\tcase 'above':\n\t\tcase 'below':\n\t\tcase 'from':\n\t\tcase 'to':\n\t\t\treturn (\n\t\t\t\tEXACT_RANGE_COLUMN_TYPES.some((type) => type === column.type) &&\n\t\t\t\tmatchesDeclaredType(first, column.type)\n\t\t\t)\n\t\tcase 'between':\n\t\t\treturn (\n\t\t\t\tEXACT_RANGE_COLUMN_TYPES.some((type) => type === column.type) &&\n\t\t\t\tmatchesDeclaredType(first, column.type) &&\n\t\t\t\tmatchesDeclaredType(second, column.type)\n\t\t\t)\n\t\tcase 'any':\n\t\tcase 'none':\n\t\t\treturn (\n\t\t\t\tcondition.values.length > 0 &&\n\t\t\t\tcondition.values.every((value) => matchesDeclaredType(value, column.type))\n\t\t\t)\n\t\tcase 'starts':\n\t\tcase 'ends':\n\t\t\treturn column.type === 'text' && isString(first)\n\t\tcase 'like':\n\t\tcase 'glob':\n\t\t\treturn false\n\t}\n}\n\n/**\n * Whether one {@link Order} term's column compiles to an `ORDER BY` that\n * matches the engine's {@link import('@src/core').sortRows} exactly.\n *\n * @remarks\n * `false` for a nested `FieldPath`, a column absent from `schema`, or a\n * declared type outside {@link EXACT_RANGE_COLUMN_TYPES} (`integer` / `real` /\n * `boolean`). `text` is NOT exact here: SQLite's default BINARY collation\n * orders TEXT by Unicode code point while the core engine's `compareValues`\n * orders JS strings by UTF-16 code unit, and the two diverge for\n * supplementary-plane characters (see {@link EXACT_COLUMN_TYPES}'s remarks) —\n * a `text` order term REFINES through the core engine instead.\n *\n * @param order - The order term to test\n * @param schema - The table's schema\n * @returns Whether `order` is exact\n */\nexport function isExactOrder(order: Order, schema: TableSchema): boolean {\n\tif (!isString(order.column)) return false\n\tconst column = schema.columns.find((candidate) => candidate.name === order.column)\n\tif (column === undefined) return false\n\treturn EXACT_RANGE_COLUMN_TYPES.some((type) => type === column.type)\n}\n\n/**\n * Whether a whole {@link Criteria} is exact — every condition and every order\n * term is exact. `limit` / `offset` never affect exactness (SQL `LIMIT` /\n * `OFFSET` are always engine-identical).\n *\n * @param criteria - The criteria to test\n * @param schema - The table's schema\n * @returns Whether every part of `criteria` is exact\n */\nexport function isExactCriteria(criteria: Criteria, schema: TableSchema): boolean {\n\tconst conditions = criteria.conditions ?? []\n\tconst order = criteria.order ?? []\n\treturn (\n\t\tconditions.every((condition) => isExactCondition(condition, schema)) &&\n\t\torder.every((term) => isExactOrder(term, schema))\n\t)\n}\n\n// === SQL identifiers & types\n\n/**\n * Map a portable {@link ColumnType} to its SQLite column type.\n *\n * @remarks\n * `text` / `json` → `TEXT` (JSON is stored as text and read back with\n * `json_extract` for nested-field queries); `integer` / `boolean` → `INTEGER`\n * (a boolean stores `1` / `0`); `real` → `REAL`; `blob` → `BLOB`. No `NOT NULL`\n * is ever emitted — the contract validates required-ness; the database is just\n * storage (AGENTS §14, the typed layer above imposes the shape).\n *\n * @param type - The portable column type\n * @returns The SQLite column type keyword\n *\n * @example\n * ```ts\n * columnSQL('integer') // 'INTEGER'\n * columnSQL('json') // 'TEXT'\n * ```\n */\nexport function columnSQL(type: ColumnType): string {\n\tswitch (type) {\n\t\tcase 'text':\n\t\tcase 'json':\n\t\t\treturn 'TEXT'\n\t\tcase 'integer':\n\t\tcase 'boolean':\n\t\t\treturn 'INTEGER'\n\t\tcase 'real':\n\t\t\treturn 'REAL'\n\t\tcase 'blob':\n\t\t\treturn 'BLOB'\n\t}\n}\n\n/**\n * Quote a SQL identifier (a table or column name) so any characters are literal.\n *\n * @remarks\n * Wraps the name in double quotes and doubles any embedded quote — the standard\n * SQL identifier-quoting that lets a column named `order` or `from` be referenced\n * safely. Identifiers cannot be bound as parameters, so they are quoted instead.\n *\n * @param identifier - The raw identifier\n * @returns The double-quoted identifier\n *\n * @example\n * ```ts\n * quote('order') // '\"order\"'\n * ```\n */\nexport function quote(identifier: string): string {\n\treturn '\"' + identifier.replaceAll('\"', '\"\"') + '\"'\n}\n\n/**\n * Compile a {@link FieldPath} to the SQL expression that reads it.\n *\n * @remarks\n * A single string is ONE column — `quote(path)`. An array descends a JSON column:\n * the first element is the (quoted) column, the rest a `json_extract` path\n * (`json_extract(\"payload\", '$.user.id')`), matching the guide's nested-field\n * examples (simple identifier keys). The string's value is never split on `.`\n * (AGENTS — `FieldPath` semantics): a dotted string is one column literally.\n *\n * @param path - The field path (a column, or a column + nested keys)\n * @returns The SQL expression selecting the value\n *\n * @example\n * ```ts\n * fieldColumn('payload') // '\"payload\"'\n * fieldColumn(['payload', 'user', 'id']) // 'json_extract(\"payload\", \\'$.user.id\\')'\n * ```\n */\nexport function fieldColumn(path: FieldPath): string {\n\tif (isString(path)) return quote(path)\n\tconst [column, ...nested] = path\n\tif (column === undefined) {\n\t\tthrow new DatabaseError('VALIDATION', 'A field path must contain at least one column')\n\t}\n\tconst rest = nested.map((key) => '.' + key.replaceAll(\"'\", \"''\")).join('')\n\treturn 'json_extract(' + quote(column) + \", '$\" + rest + \"')\"\n}\n\n/**\n * Compile an {@link AggregateFunction} over a {@link FieldPath} to its SQL\n * aggregate expression — the SELECT body the SQLite driver's native `aggregate`\n * runs.\n *\n * @remarks\n * `count` → `COUNT(*)` (counting all matched ROWS, not non-null column values —\n * mirroring the engine's `computeAggregate('count')`, which is `rows.length`); the\n * numeric aggregates wrap the column's read expression (a flat column, or a nested\n * `json_extract` path) in `SUM` / `AVG` / `MIN` / `MAX`. Over zero matched rows\n * `COUNT(*)` is `0` and the numeric aggregates are SQL `NULL` (→ `undefined`),\n * matching the engine.\n *\n * @param operation - The aggregate to compute\n * @param column - The column (or nested path) to aggregate\n * @returns The SQL aggregate expression\n *\n * @example\n * ```ts\n * aggregateSQL('count', 'age') // 'COUNT(*)'\n * aggregateSQL('sum', 'age') // 'SUM(\"age\")'\n * aggregateSQL('average', ['payload', 'score']) // 'AVG(json_extract(\"payload\", \\'$.score\\'))'\n * ```\n */\nexport function aggregateSQL(operation: AggregateFunction, column: FieldPath): string {\n\tswitch (operation) {\n\t\tcase 'count':\n\t\t\treturn 'COUNT(*)'\n\t\tcase 'sum':\n\t\t\treturn 'SUM(' + fieldColumn(column) + ')'\n\t\tcase 'average':\n\t\t\treturn 'AVG(' + fieldColumn(column) + ')'\n\t\tcase 'minimum':\n\t\t\treturn 'MIN(' + fieldColumn(column) + ')'\n\t\tcase 'maximum':\n\t\t\treturn 'MAX(' + fieldColumn(column) + ')'\n\t}\n}\n\n// === Value codecs\n\n/**\n * Encode a JS value to its stored {@link SQLiteValue} for a column's type.\n *\n * @remarks\n * The forward half of the bridge, total (AGENTS §14): a value that does not fit\n * its column's storage type encodes to `null` rather than throwing. A `boolean`\n * column stores `1` / `0` (and `null` / `undefined` → `null`); a `json` column\n * stores `JSON.stringify` (or `null` for `null` / `undefined`); `integer` /\n * `real` keep a `number` / `bigint`, else `null`; `text` keeps a `string`, else\n * `null`; `blob` keeps a `Uint8Array`, else `null`. Narrowed with `typeof` /\n * `instanceof`, never `as`.\n *\n * @param value - The JS value to store\n * @param type - The column's portable storage type\n * @returns The value SQLite stores\n *\n * @example\n * ```ts\n * encodeValue(true, 'boolean') // 1\n * encodeValue({ a: 1 }, 'json') // '{\"a\":1}'\n * ```\n */\nexport function encodeValue(value: unknown, type: ColumnType): SQLiteValue {\n\tswitch (type) {\n\t\tcase 'boolean':\n\t\t\treturn value === undefined || value === null ? null : value === true ? 1 : 0\n\t\tcase 'json':\n\t\t\treturn value === undefined || value === null ? null : JSON.stringify(value)\n\t\tcase 'integer':\n\t\tcase 'real':\n\t\t\treturn typeof value === 'number' || typeof value === 'bigint' ? value : null\n\t\tcase 'text':\n\t\t\treturn typeof value === 'string' ? value : null\n\t\tcase 'blob':\n\t\t\treturn value instanceof Uint8Array ? value : null\n\t}\n}\n\n/**\n * Decode a stored {@link SQLiteValue} back to its JS value for a column's type —\n * the exact inverse of {@link encodeValue}.\n *\n * @remarks\n * A `boolean` column reads `1` / `0` back to `true` / `false` (a stored `null`\n * → `undefined`); a `json` column `JSON.parse`s a string (anything else →\n * `undefined`); every other type passes the value through, mapping a stored\n * `NULL` to `undefined`. NULL decodes to `undefined` so {@link decodeRow} can\n * omit absent columns.\n *\n * @param value - The stored SQLite value\n * @param type - The column's portable storage type\n * @returns The decoded JS value (`undefined` for a stored `NULL`)\n *\n * @example\n * ```ts\n * decodeValue(1, 'boolean') // true\n * decodeValue('{\"a\":1}', 'json') // { a: 1 }\n * ```\n */\nexport function decodeValue(value: SQLiteValue, type: ColumnType): unknown {\n\tswitch (type) {\n\t\tcase 'boolean':\n\t\t\treturn value === null ? undefined : value !== 0\n\t\tcase 'json':\n\t\t\treturn typeof value === 'string' ? JSON.parse(value) : undefined\n\t\tdefault:\n\t\t\treturn value === null ? undefined : value\n\t}\n}\n\n/**\n * Encode a whole {@link Row} to a {@link SQLiteRow} by its table's schema.\n *\n * @remarks\n * Encodes each declared column's value with {@link encodeValue}; columns the row\n * does not carry encode from `undefined` (so they store `null`). Only the\n * schema's columns appear in the result — an extra row key is dropped.\n *\n * @param row - The JS row to store\n * @param schema - The table's schema\n * @returns The storable SQLite row\n *\n * @example\n * ```ts\n * encodeRow({ id: 'u1', active: true }, schema) // { id: 'u1', active: 1, ... }\n * ```\n */\nexport function encodeRow(row: Row, schema: TableSchema): SQLiteRow {\n\tconst result: SQLiteRow = {}\n\tfor (const column of schema.columns) {\n\t\tresult[column.name] = encodeValue(row[column.name], column.type)\n\t}\n\treturn result\n}\n\n/**\n * Extract a stored row's values in a declared positional order.\n *\n * @remarks\n * SQLite statements bind arrays positionally. Every requested column must be\n * present in `row`; an incomplete backend row is a typed `DRIVER` fault carrying\n * the table and missing column in its context.\n *\n * @param row - The stored SQLite row\n * @param names - The column names in binding order\n * @param table - The owning table name for fault context\n * @returns The row values in the same order as `names`\n * @throws A `DRIVER` {@link DatabaseError} when a requested column is missing\n *\n * @example\n * ```ts\n * extractValues({ id: 'u1', age: 36 }, ['age', 'id'], 'users') // [36, 'u1']\n * ```\n */\nexport function extractValues(\n\trow: SQLiteRow,\n\tnames: readonly string[],\n\ttable: string,\n): readonly SQLiteValue[] {\n\tconst values: SQLiteValue[] = []\n\tfor (const name of names) {\n\t\tconst value = row[name]\n\t\tif (value === undefined) {\n\t\t\tthrow new DatabaseError('DRIVER', 'SQLite row is missing a declared column', {\n\t\t\t\ttable,\n\t\t\t\tcolumn: name,\n\t\t\t})\n\t\t}\n\t\tvalues.push(value)\n\t}\n\treturn values\n}\n\n/**\n * Decode a stored {@link SQLiteRow} back to a {@link Row} by its table's schema.\n *\n * @remarks\n * Decodes each declared column with {@link decodeValue} and **omits** any column\n * whose decoded value is `undefined` — so an absent / `NULL` optional column does\n * not surface as `{ bio: undefined }`, matching how the contract's optional\n * columns expect absence. A known, documented edge: a non-optional `nullableShape`\n * column storing `null` round-trips to absent (a `null` cell decodes to\n * `undefined`, and an `undefined` value is omitted).\n *\n * @param row - The stored SQLite row\n * @param schema - The table's schema\n * @returns The decoded JS row (absent columns omitted)\n *\n * @example\n * ```ts\n * decodeRow({ id: 'u1', active: 1, bio: null }, schema) // { id: 'u1', active: true }\n * ```\n */\nexport function decodeRow(row: SQLiteRow, schema: TableSchema): Row {\n\tconst result: Row = {}\n\tfor (const column of schema.columns) {\n\t\tconst value = row[column.name]\n\t\tif (value === undefined) continue\n\t\tconst decoded = decodeValue(value, column.type)\n\t\tif (decoded !== undefined) result[column.name] = decoded\n\t}\n\treturn result\n}\n\n// === DDL projections\n\n/**\n * Project a {@link TableSchema} to the `CREATE TABLE IF NOT EXISTS` statement a\n * SQLite driver's `open` issues for it.\n *\n * @remarks\n * Each column compiles to `<quoted name> <columnSQL(type)>`; the statement ends\n * with `PRIMARY KEY (<quoted primary>)`. No `NOT NULL` is emitted — the contract\n * validates required-ness, the database is just storage (AGENTS §14).\n *\n * @param schema - The table's schema\n * @returns The `CREATE TABLE IF NOT EXISTS …` statement\n *\n * @example\n * ```ts\n * schemaToTable(schema)\n * // 'CREATE TABLE IF NOT EXISTS \"users\" (\"id\" TEXT, \"age\" INTEGER, PRIMARY KEY (\"id\"))'\n * ```\n */\nexport function schemaToTable(schema: TableSchema): string {\n\tconst columns = schema.columns.map((column) => quote(column.name) + ' ' + columnSQL(column.type))\n\treturn (\n\t\t'CREATE TABLE IF NOT EXISTS ' +\n\t\tquote(schema.name) +\n\t\t' (' +\n\t\tcolumns.join(', ') +\n\t\t', PRIMARY KEY (' +\n\t\tquote(schema.primary) +\n\t\t'))'\n\t)\n}\n\n/**\n * Build a collision-free SQL index name for a table + column-group index —\n * shared by {@link schemaToIndexes} (an `open`-time `CREATE INDEX`) and\n * {@link stepToSQL}'s `index.add` / `index.remove` (a migration-time DDL),\n * so a plan-built index name always matches one `open` would have created.\n *\n * @remarks\n * A naive `idx_<table>_<cols joined by _>` is AMBIGUOUS: table `'a_b'` with\n * column `'c'` and table `'a'` with columns `['b', 'c']` both produce\n * `idx_a_b_c`. This encodes each part (the table name, then each column name)\n * length-prefixed (`<len>_<part>`) so the boundary between parts is always\n * unambiguous, however the names themselves are punctuated.\n *\n * @param table - The table name\n * @param columns - The index's column names, in order\n * @returns The deterministic, collision-free index identifier (unquoted)\n *\n * @example\n * ```ts\n * indexName('users', ['name']) // 'idx_5_users_4_name'\n * indexName('a_b', ['c']) // 'idx_3_a_b_1_c'\n * indexName('a', ['b', 'c']) // 'idx_1_a_1_b_1_c'\n * ```\n */\nexport function indexName(table: string, columns: readonly string[]): string {\n\tconst parts = [table, ...columns].map((part) => String(part.length) + '_' + part)\n\treturn 'idx_' + parts.join('_')\n}\n\n/**\n * Project a {@link TableSchema} to the `CREATE INDEX IF NOT EXISTS` statements a\n * SQLite driver's `open` issues for its declared indexes.\n *\n * @remarks\n * One statement per index group; the index name is built by {@link indexName}\n * (collision-free and deterministic), matching the driver's naming so a\n * repeated `open` is idempotent.\n *\n * @param schema - The table's schema\n * @returns One `CREATE INDEX IF NOT EXISTS …` statement per declared index\n *\n * @example\n * ```ts\n * schemaToIndexes(schema)\n * // ['CREATE INDEX IF NOT EXISTS \"idx_5_users_4_name\" ON \"users\" (\"name\")']\n * ```\n */\nexport function schemaToIndexes(schema: TableSchema): readonly string[] {\n\treturn schema.indexes.map(\n\t\t(group) =>\n\t\t\t'CREATE INDEX IF NOT EXISTS ' +\n\t\t\tquote(indexName(schema.name, group)) +\n\t\t\t' ON ' +\n\t\t\tquote(schema.name) +\n\t\t\t' (' +\n\t\t\tgroup.map(quote).join(', ') +\n\t\t\t')',\n\t)\n}\n\n/**\n * Project one {@link MigrationStep} to the DDL statement(s) a SQLite driver's\n * `migrate` executes for it.\n *\n * @remarks\n * `table.add` emits the `CREATE TABLE` plus one `CREATE INDEX` per declared\n * index (via {@link schemaToTable} / {@link schemaToIndexes}); `table.remove`\n * emits `DROP TABLE IF EXISTS`; `column.add` / `column.remove` emit `ALTER\n * TABLE … ADD COLUMN` / `… DROP COLUMN`; `index.add` / `index.remove` emit\n * `CREATE INDEX IF NOT EXISTS` / `DROP INDEX IF EXISTS`, naming the index the\n * same way `schemaToIndexes` does (`idx_<table>_<columns joined by _>`) so a\n * plan-built index matches one `open` would have created. Whether the named\n * table actually exists is the caller's concern (a driver's `migrate` checks\n * its own declared schema before running these statements) — this projection\n * is pure and never inspects live state.\n *\n * @param step - The migration step to project\n * @returns The DDL statement(s) that apply the step\n *\n * @example\n * ```ts\n * stepToSQL({ operation: 'column.remove', table: 'users', column: 'legacy' })\n * // ['ALTER TABLE \"users\" DROP COLUMN \"legacy\"']\n * ```\n */\nexport function stepToSQL(step: MigrationStep): readonly string[] {\n\tswitch (step.operation) {\n\t\tcase 'table.add':\n\t\t\treturn [schemaToTable(step.table), ...schemaToIndexes(step.table)]\n\t\tcase 'table.remove':\n\t\t\treturn ['DROP TABLE IF EXISTS ' + quote(step.table)]\n\t\tcase 'column.add':\n\t\t\treturn [\n\t\t\t\t'ALTER TABLE ' +\n\t\t\t\t\tquote(step.table) +\n\t\t\t\t\t' ADD COLUMN ' +\n\t\t\t\t\tquote(step.column.name) +\n\t\t\t\t\t' ' +\n\t\t\t\t\tcolumnSQL(step.column.type),\n\t\t\t]\n\t\tcase 'column.remove':\n\t\t\treturn ['ALTER TABLE ' + quote(step.table) + ' DROP COLUMN ' + quote(step.column)]\n\t\tcase 'index.add':\n\t\t\treturn [\n\t\t\t\t'CREATE INDEX IF NOT EXISTS ' +\n\t\t\t\t\tquote(indexName(step.table, step.index)) +\n\t\t\t\t\t' ON ' +\n\t\t\t\t\tquote(step.table) +\n\t\t\t\t\t' (' +\n\t\t\t\t\tstep.index.map(quote).join(', ') +\n\t\t\t\t\t')',\n\t\t\t]\n\t\tcase 'index.remove':\n\t\t\treturn ['DROP INDEX IF EXISTS ' + quote(indexName(step.table, step.index))]\n\t}\n}\n\n/**\n * Project one {@link MigrationStep} onto its table's declared {@link TableSchema}\n * — the bookkeeping counterpart to {@link stepToSQL} (which projects the DDL a\n * driver's `migrate` runs against the live database).\n *\n * @remarks\n * `column.add` / `column.remove` add / filter the named column;\n * `index.add` / `index.remove` add / filter the matching index group (an exact\n * ordered match on `index`). `table.add` / `table.remove` act on a WHOLE\n * schema map rather than one table's shape, so they are the caller's concern\n * (a driver's `migrate` applies them directly against its table map) — passed\n * here, they return `schema` unchanged.\n *\n * @param schema - The table's current declared schema\n * @param step - The migration step to project onto it\n * @returns The table's schema after the step\n *\n * @example\n * ```ts\n * stepToSchema(schema, { operation: 'column.remove', table: 'users', column: 'legacy' })\n * // schema with the 'legacy' column dropped from `columns`\n * ```\n */\nexport function stepToSchema(schema: TableSchema, step: MigrationStep): TableSchema {\n\tswitch (step.operation) {\n\t\tcase 'column.add':\n\t\t\treturn { ...schema, columns: [...schema.columns, step.column] }\n\t\tcase 'column.remove':\n\t\t\treturn { ...schema, columns: schema.columns.filter((column) => column.name !== step.column) }\n\t\tcase 'index.add':\n\t\t\treturn { ...schema, indexes: [...schema.indexes, step.index] }\n\t\tcase 'index.remove':\n\t\t\treturn {\n\t\t\t\t...schema,\n\t\t\t\tindexes: schema.indexes.filter(\n\t\t\t\t\t(group) =>\n\t\t\t\t\t\t!(\n\t\t\t\t\t\t\tgroup.length === step.index.length &&\n\t\t\t\t\t\t\tgroup.every((name, position) => name === step.index[position])\n\t\t\t\t\t\t),\n\t\t\t\t),\n\t\t\t}\n\t\tcase 'table.add':\n\t\tcase 'table.remove':\n\t\t\treturn schema\n\t}\n}\n","import type { ColumnType, Condition, Criteria, Order, TableSchema } from '@src/core'\nimport type { CompiledSQL, SQLiteValue } from './types.js'\nimport { DatabaseError } from '@src/core'\nimport { isString } from '@orkestrel/contract'\nimport { encodeValue, fieldColumn, quote } from './helpers.js'\n\n/**\n * Compile a NESTED {@link FieldPath} to the `json_type(<col>, <path>)` SQL\n * expression — the {@link fieldColumn} `json_extract` sibling used to tell a\n * PRESENT JSON `null` apart from an ABSENT path (both read back as SQL `NULL`\n * through `json_extract`, but `json_type` reports `'null'` for the former and\n * SQL `NULL` for the latter).\n *\n * @param path - The nested field path (a column plus its JSON keys)\n * @returns The SQL expression reading the value's JSON type\n *\n * @example\n * ```ts\n * jsonTypeColumn(['payload', 'user', 'id']) // \"json_type(\\\"payload\\\", '$.user.id')\"\n * ```\n */\nexport function jsonTypeColumn(path: readonly string[]): string {\n\tconst [column, ...nested] = path\n\tif (column === undefined) {\n\t\tthrow new DatabaseError('VALIDATION', 'A field path must contain at least one column')\n\t}\n\tconst rest = nested.map((key) => '.' + key.replaceAll(\"'\", \"''\")).join('')\n\treturn 'json_type(' + quote(column) + \", '$\" + rest + \"')\"\n}\n\n// The `Criteria` → parameterized SQL compiler — the native-query payoff. It turns\n// a portable `Criteria` (the same one the core engine's `applyCriteria` folds)\n// into the `WHERE` / `ORDER BY` / `LIMIT` tail of a `SELECT`, with bound `?`\n// params in clause order. Its WHERE fold parenthesizes LEFT-TO-RIGHT to match the\n// engine's `matchesCriteria` exactly (NOT SQL's AND-over-OR precedence), so a\n// native read and an engine read agree on every query (the parity test). Branches\n// are centralized and public per AGENTS §5 — no operator logic buried in closures.\n// This module speaks pure strings/values only — it imports no SQLite package.\n\n/**\n * Escape `\\`, `%`, and `_` (each with a leading `\\`) so a `starts` / `ends`\n * operand is matched literally under the `LIKE … ESCAPE '\\'` clause.\n *\n * @param text - The raw operand text\n * @returns The text with LIKE metacharacters escaped\n *\n * @example\n * ```ts\n * escapeLike('50%_off') // '50\\\\%\\\\_off'\n * ```\n */\nexport function escapeLike(text: string): string {\n\treturn text.replaceAll('\\\\', '\\\\\\\\').replaceAll('%', '\\\\%').replaceAll('_', '\\\\_')\n}\n\n/**\n * The declared storage type of a flat (string) column, read from the schema.\n *\n * @param column - The column name\n * @param schema - The table's schema\n * @returns The column's {@link ColumnType}, or `undefined` if the schema does not carry it\n *\n * @example\n * ```ts\n * declaredType('age', schema) // 'integer'\n * ```\n */\nexport function declaredType(column: string, schema: TableSchema): ColumnType | undefined {\n\treturn schema.columns.find((candidate) => candidate.name === column)?.type\n}\n\n/**\n * The storage type a nested (`json_extract`) operand encodes as, derived from its\n * RUNTIME value — NOT `json`.\n *\n * @remarks\n * `json_extract` returns the unquoted, natively-typed scalar (a JSON boolean as\n * `1` / `0`, a number as-is, a string as-is), so the operand must encode to that\n * same scalar to compare. A boolean → `'boolean'` (→ `1` / `0`); a number →\n * `'integer'` / `'real'`; a bigint → `'integer'`; a string → `'text'`; `null` /\n * `undefined` → `'text'` (encodes to `null`); an object / array → `'json'` (the\n * edge of comparing against a json subtree).\n *\n * @param value - The runtime operand value\n * @returns The {@link ColumnType} to encode it as\n *\n * @example\n * ```ts\n * valueType(true) // 'boolean'\n * valueType(9) // 'integer'\n * ```\n */\nexport function valueType(value: unknown): ColumnType {\n\tif (typeof value === 'boolean') return 'boolean'\n\tif (typeof value === 'number') return Number.isInteger(value) ? 'integer' : 'real'\n\tif (typeof value === 'bigint') return 'integer'\n\tif (typeof value === 'object' && value !== null) return 'json'\n\treturn 'text'\n}\n\n/**\n * Compile one condition to its `<column> <operator>` SQL fragment and the params\n * it binds — engine-exact under SQL's three-valued NULL logic.\n *\n * @remarks\n * Every operand is run through `encodeValue`, so a bound value matches the SQL\n * the column side compiles to. A flat column encodes operands with its DECLARED\n * schema type (a flat `json` column → `JSON.stringify`); a nested `FieldPath`\n * encodes each operand as the NATIVE scalar `json_extract` returns, derived from\n * the operand's runtime type (per-operand, since `between` / `any` / `none` can\n * mix types). `any` / `none` collapse an empty list to a constant (`0` matches\n * nothing, `1` matches all) with no params.\n *\n * The core engine's total order ranks `undefined` (rank 0) BELOW `null`\n * (rank 1) (see `compareValues`), so a MISSING/`NULL` column MATCHES\n * `below` / `to` / a scalar `not` / `none` — the opposite of raw SQL, where a\n * comparison against `NULL` is `NULL` (excluded). This fragment replicates the\n * engine exactly. Truth table (`value` = the engine's decoded field read; a\n * FLAT column's stored `NULL` decodes to `undefined` per `decodeRow`, so a\n * flat `value` is NEVER a present `null` — only a NESTED path can be\n * present-but-`null`):\n *\n * ```text\n * operator            | value=undefined (absent)      | value=null (nested only) | value=scalar\n * --------------------|--------------------------------|---------------------------|-------------\n * equals, first=null  | no match                       | MATCH                     | no match\n * equals, first=X     | no match                       | no match                  | value===X\n * not, first=null     | MATCH (flat: unconditionally;  | no match                  | MATCH\n *                     |   nested: absent still matches)|                           |\n * not, first=X        | MATCH                          | MATCH                     | value!==X\n * below/to, first=X   | MATCH (rank 0 < rank(X))       | MATCH (rank 1 < rank(X))  | rank compare\n * none, list=[…]       | MATCH (no scalar rank-equal)   | MATCH                     | not-in-list\n * any, list=[…]        | no match                       | no match                  | in-list\n * above/from/between  | no match                       | no match                  | rank compare\n * like/glob/starts/…  | no match (not a string)        | no match                  | string test\n * present              | false                          | false                     | true\n * absent                | true                           | true                      | false\n * ```\n *\n * Because a flat column's `NULL` always decodes to `undefined`, `equals`\n * against a `null` operand needs no special flat compilation (`col = ?`\n * binding a `NULL` param is already always-false in SQL, matching \"no match\"\n * above) — but flat `not` against `null` must match EVERY row (both the\n * absent and the scalar rows), which `col != ? OR col IS NULL` cannot express\n * (it only catches the `IS NULL` row), so a flat `not`-with-`null`-operand\n * compiles to the constant `1`.\n *\n * A NESTED path can be present-but-`null` (a stored JSON `null`), which\n * `json_extract` reads back as SQL `NULL` — indistinguishable from an ABSENT\n * path. `json_type(col, path)` disambiguates them (`'null'` for present-null,\n * SQL `NULL` for absent), so nested `equals` / `not` against a `null` operand\n * compile through `json_type` instead of `IS NULL` / `IS NOT NULL`.\n *\n * Every other MATCH-on-null-or-absent row is expressed uniformly (flat and\n * nested alike) as `(<column> <op> ? OR <column> IS NULL)` — for a nested\n * path, `json_extract` already collapses BOTH absent and present-null to SQL\n * `NULL`, so `IS NULL` catches both in one clause; for a flat column there is\n * only the absent case to catch.\n *\n * @param condition - The condition to compile\n * @param schema - The table's schema (for declared column types)\n * @returns The SQL fragment and its bound parameters\n *\n * @example\n * ```ts\n * fragment({ column: 'age', operator: 'above', values: [18], connector: 'and' }, schema)\n * // { sql: '\"age\" > ?', params: [18] }\n * fragment({ column: 'age', operator: 'below', values: [18], connector: 'and' }, schema)\n * // { sql: '(\"age\" < ? OR \"age\" IS NULL)', params: [18] }\n * ```\n */\nexport function fragment(condition: Condition, schema: TableSchema): CompiledSQL {\n\tconst column = fieldColumn(condition.column)\n\tconst nested = !isString(condition.column)\n\tconst declared = isString(condition.column) ? declaredType(condition.column, schema) : undefined\n\tconst first = condition.values[0]\n\tconst second = condition.values[1]\n\tconst nullOperand = first === null || first === undefined\n\t// The nested `json_type` read — built only when `condition.column` is an\n\t// array (a nested path) — disambiguates a present JSON `null` from an\n\t// absent path under `equals` / `not` (see the truth table above).\n\tconst jsonType = !isString(condition.column) ? jsonTypeColumn(condition.column) : ''\n\tlet sql: string\n\tlet values: readonly unknown[]\n\tswitch (condition.operator) {\n\t\tcase 'equals':\n\t\t\tif (nullOperand && nested) return { sql: jsonType + \" = 'null'\", params: [] }\n\t\t\tsql = column + ' = ?'\n\t\t\tvalues = [first]\n\t\t\tbreak\n\t\tcase 'not':\n\t\t\tif (nullOperand) {\n\t\t\t\tif (nested) {\n\t\t\t\t\treturn {\n\t\t\t\t\t\tsql: '(' + jsonType + ' IS NULL OR ' + jsonType + \" != 'null')\",\n\t\t\t\t\t\tparams: [],\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t\t// A flat column's decoded value is never a present null, so\n\t\t\t\t// `compareValues(value, null)` is nonzero for EVERY row (absent or\n\t\t\t\t// scalar) — the engine's `not null` matches unconditionally.\n\t\t\t\treturn { sql: '1', params: [] }\n\t\t\t}\n\t\t\tsql = '(' + column + ' != ? OR ' + column + ' IS NULL)'\n\t\t\tvalues = [first]\n\t\t\tbreak\n\t\tcase 'above':\n\t\t\tsql = column + ' > ?'\n\t\t\tvalues = [first]\n\t\t\tbreak\n\t\tcase 'below':\n\t\t\tsql = '(' + column + ' < ? OR ' + column + ' IS NULL)'\n\t\t\tvalues = [first]\n\t\t\tbreak\n\t\tcase 'from':\n\t\t\tsql = column + ' >= ?'\n\t\t\tvalues = [first]\n\t\t\tbreak\n\t\tcase 'to':\n\t\t\tsql = '(' + column + ' <= ? OR ' + column + ' IS NULL)'\n\t\t\tvalues = [first]\n\t\t\tbreak\n\t\tcase 'between':\n\t\t\tsql = column + ' BETWEEN ? AND ?'\n\t\t\tvalues = [first, second]\n\t\t\tbreak\n\t\tcase 'like':\n\t\t\tsql = column + ' LIKE ?'\n\t\t\tvalues = [first]\n\t\t\tbreak\n\t\tcase 'glob':\n\t\t\tsql = column + ' GLOB ?'\n\t\t\tvalues = [first]\n\t\t\tbreak\n\t\tcase 'starts': {\n\t\t\t// Case-sensitive, exact compile (replaces the old LIKE-based one, which\n\t\t\t// was ASCII-only case-INsensitive — a mismatch with the engine's\n\t\t\t// case-sensitive `String.startsWith`). `substr` counts CODE POINTS, so\n\t\t\t// the length is a code-point count (`Array.from`), not `.length`. An\n\t\t\t// empty operand matches every text-column value (the engine: every\n\t\t\t// string starts with '').\n\t\t\tconst text = isString(first) ? first : ''\n\t\t\tif (text === '') return { sql: 'typeof(' + column + \") = 'text'\", params: [] }\n\t\t\tconst length = Array.from(text).length\n\t\t\tsql = '(typeof(' + column + \") = 'text' AND substr(\" + column + ', 1, ' + length + ') = ?)'\n\t\t\tvalues = [first]\n\t\t\tbreak\n\t\t}\n\t\tcase 'ends': {\n\t\t\t// Mirror of `starts`: `substr(<col>, -N)` (SQLite's 2-arg form counts\n\t\t\t// from the right when N is negative) reads the last N code points.\n\t\t\tconst text = isString(first) ? first : ''\n\t\t\tif (text === '') return { sql: 'typeof(' + column + \") = 'text'\", params: [] }\n\t\t\tconst length = Array.from(text).length\n\t\t\tsql = '(typeof(' + column + \") = 'text' AND substr(\" + column + ', -' + length + ') = ?)'\n\t\t\tvalues = [first]\n\t\t\tbreak\n\t\t}\n\t\tcase 'any':\n\t\t\tif (condition.values.length === 0) return { sql: '0', params: [] }\n\t\t\tsql = column + ' IN (' + condition.values.map(() => '?').join(', ') + ')'\n\t\t\tvalues = condition.values\n\t\t\tbreak\n\t\tcase 'none':\n\t\t\tif (condition.values.length === 0) return { sql: '1', params: [] }\n\t\t\tsql =\n\t\t\t\t'(' +\n\t\t\t\tcolumn +\n\t\t\t\t' NOT IN (' +\n\t\t\t\tcondition.values.map(() => '?').join(', ') +\n\t\t\t\t') OR ' +\n\t\t\t\tcolumn +\n\t\t\t\t' IS NULL)'\n\t\t\tvalues = condition.values\n\t\t\tbreak\n\t\tcase 'absent':\n\t\t\treturn { sql: column + ' IS NULL', params: [] }\n\t\tcase 'present':\n\t\t\treturn { sql: column + ' IS NOT NULL', params: [] }\n\t}\n\treturn {\n\t\tsql,\n\t\tparams: values.map((value) =>\n\t\t\tencodeValue(value, nested ? valueType(value) : (declared ?? 'json')),\n\t\t),\n\t}\n}\n\n/**\n * Fold the conditions into one WHERE clause, parenthesizing progressively\n * left-to-right so the grouping matches the engine's `matchesCriteria` fold.\n *\n * @remarks\n * The first condition's connector is ignored, per the {@link Condition} types.\n * Every fragment (see {@link fragment}'s truth table) replicates the core\n * engine's total order EXACTLY under SQL's three-valued NULL logic, so this\n * clause matches `applyCriteria` row-for-row over the same table — a native\n * `records` / `count` read never disagrees with a scan-and-filter fallback.\n *\n * @param conditions - The conditions to fold\n * @param schema - The table's schema\n * @returns The `WHERE …` clause and its bound parameters, or an empty clause for zero conditions\n *\n * @example\n * ```ts\n * compileWhere([{ column: 'age', operator: 'from', values: [18], connector: 'and' }], schema)\n * // { sql: 'WHERE \"age\" >= ?', params: [18] }\n * ```\n */\nexport function compileWhere(conditions: readonly Condition[], schema: TableSchema): CompiledSQL {\n\tconst [first, ...remaining] = conditions\n\tif (first === undefined) return { sql: '', params: [] }\n\tconst head = fragment(first, schema)\n\tlet clause = head.sql\n\tconst params: SQLiteValue[] = [...head.params]\n\tfor (const condition of remaining) {\n\t\tconst next = fragment(condition, schema)\n\t\tconst operator = condition.connector === 'or' ? 'OR' : 'AND'\n\t\tclause = '(' + clause + ' ' + operator + ' ' + next.sql + ')'\n\t\tparams.push(...next.params)\n\t}\n\treturn { sql: 'WHERE ' + clause, params }\n}\n\n/**\n * Compile the ORDER BY clause from the order terms, always ending with the\n * primary key as the final determinant.\n *\n * @remarks\n * The native `records` read then resolves ties in key order, matching a\n * primary-key-ordered `scan` and the core engine's stable `sortRows` over a\n * key-ordered scan (and IndexedDB's key-ordered reads), so a native read equals\n * the scan path (AGENTS §21 / §22 native ↔ engine parity). SQLite without an\n * `ORDER BY` returns rowid (insertion) order, and an explicit order alone breaks\n * ties by rowid too — both diverge from every key-ordered backend. The\n * tie-breaker is ASCENDING regardless of the explicit directions: the engine's\n * stable sort runs over key-ascending input, so equal rows stay in\n * ascending-key order whichever way the explicit terms point. Skipped when the\n * primary is already an explicit order term (no double-append).\n *\n * @param order - The explicit order terms, or `undefined`\n * @param schema - The table's schema (for the primary key)\n * @returns The `ORDER BY …` clause, or an empty string when there is nothing to order by\n *\n * @example\n * ```ts\n * compileOrder([{ column: 'age', direction: 'descending' }], schema)\n * // 'ORDER BY \"age\" DESC, \"id\"'\n * ```\n */\nexport function compileOrder(order: readonly Order[] | undefined, schema: TableSchema): string {\n\tconst terms = (order ?? []).map(\n\t\t(term) => fieldColumn(term.column) + (term.direction === 'descending' ? ' DESC' : ' ASC'),\n\t)\n\tconst ordersByPrimary = (order ?? []).some(\n\t\t(term) => isString(term.column) && term.column === schema.primary,\n\t)\n\tif (!ordersByPrimary) terms.push(quote(schema.primary))\n\treturn terms.length === 0 ? '' : 'ORDER BY ' + terms.join(', ')\n}\n\n/**\n * Compile the LIMIT / OFFSET clause.\n *\n * @remarks\n * An offset without a limit uses `LIMIT -1` (SQLite's \"no limit\") so OFFSET is\n * still honored.\n *\n * @param limit - The maximum row count, or `undefined`\n * @param offset - The row count to skip, or `undefined`\n * @returns The `LIMIT …` clause and its bound parameters, or an empty clause when neither is set\n *\n * @example\n * ```ts\n * compilePage(undefined, 5) // { sql: 'LIMIT -1 OFFSET ?', params: [5] }\n * ```\n */\nexport function compilePage(limit: number | undefined, offset: number | undefined): CompiledSQL {\n\tif (limit !== undefined && offset !== undefined) {\n\t\treturn { sql: 'LIMIT ? OFFSET ?', params: [limit, offset] }\n\t}\n\tif (limit !== undefined) return { sql: 'LIMIT ?', params: [limit] }\n\tif (offset !== undefined) return { sql: 'LIMIT -1 OFFSET ?', params: [offset] }\n\treturn { sql: '', params: [] }\n}\n\n/**\n * Compile a {@link Criteria} into the SQL clause that follows a table name, with\n * its bound parameters in clause order.\n *\n * @remarks\n * The driver's native `records` / `count` path: it assembles\n * `[where, orderBy, limitOffset]` (each possibly empty) into one clause so a\n * `SELECT * FROM <table> <clause>` runs the whole read in the engine instead of\n * over a JS `scan`. The WHERE fold is parenthesized **left-to-right** to mirror\n * the core engine's `matchesCriteria` (not SQL's native AND-over-OR precedence),\n * so a native and an engine read return identical rows. Each operand is encoded\n * via `encodeValue`: a flat column uses its declared schema type, while a nested\n * `FieldPath` (a `json_extract` read) encodes each operand as the native scalar\n * the extract returns — derived from the operand's runtime type — so it compares.\n * The 15 operators map per the databases guide's operator table, with\n * `starts` / `ends` using `LIKE … ESCAPE '\\'` and an empty `any` / `none` list\n * collapsing to a constant. A `undefined` criteria (or one with no parts)\n * compiles to an empty clause.\n *\n * @param criteria - The read specification, or `undefined` for all rows\n * @param schema - The table's schema (column types for operand encoding)\n * @returns The SQL tail and its bound parameters\n *\n * @example\n * ```ts\n * compileCriteria({ conditions: [{ column: 'age', operator: 'from', values: [18], connector: 'and' }] }, schema)\n * // { sql: 'WHERE \"age\" >= ? ORDER BY \"id\"', params: [18] }\n * ```\n */\nexport function compileCriteria(criteria: Criteria | undefined, schema: TableSchema): CompiledSQL {\n\tconst where = compileWhere(criteria?.conditions ?? [], schema)\n\tconst orderBy = compileOrder(criteria?.order, schema)\n\tconst page = compilePage(criteria?.limit, criteria?.offset)\n\tconst sql = [where.sql, orderBy, page.sql].filter((part) => part !== '').join(' ')\n\treturn { sql, params: [...where.params, ...page.params] }\n}\n","import type {\n\tCriteria,\n\tDriverInterface,\n\tDriverMeta,\n\tKey,\n\tMigration,\n\tRow,\n\tTableSchema,\n\tTransactionInterface,\n} from '@src/core'\nimport { DatabaseError, MemoryDriver, extractKey, isDriverMeta } from '@src/core'\nimport { isRecord } from '@orkestrel/contract'\nimport { mkdir, readFile, rename, rm, writeFile } from 'node:fs/promises'\nimport { dirname } from 'node:path'\n\n/**\n * A persistent {@link DriverInterface} backed by a single JSON file — the\n * reference {@link MemoryDriver} plus file load / flush.\n *\n * @remarks\n * A decorator, not a reimplementation: every primitive delegates to an inner\n * {@link MemoryDriver}, so querying, key-order `scan` / `keys`, and capture-replay\n * `snapshot` are inherited unchanged — this layer adds only persistence. `open`\n * loads the file into memory; every mutation (`write` / `delete` / `clear`) flushes\n * the whole store back. The file is one JSON object, `{ meta?: DriverMeta, tables: {\n * [name]: rows } }` — `meta` is present only once the store has been `stamp`ed\n * (an unstamped store serializes the old `{ tables }` shape, preserving\n * backward compatibility); a per-table array of rows, each row carrying its own\n * primary (the table contract), so the key is recovered on load with\n * {@link extractKey} and the file need not store it. The parsed JSON crosses the\n * boundary as `unknown` and is narrowed with {@link isRecord} / {@link extractKey},\n * never asserted (AGENTS §14): a missing, corrupt, or wrong-shaped file starts\n * empty rather than throwing, and a malformed row (or malformed `meta`) is\n * skipped/dropped rather than thrown on. It is scan-only — it implements none of\n * the optional native `records` / `count` / `aggregate` hooks, so the core engine\n * over `scan` answers every query. For development, small datasets, and portable /\n * inspectable data; for large or concurrent workloads reach for a SQLite-backed\n * driver.\n *\n * A failure in the write path ({@link JSONDriver.#serialize} — `mkdir` /\n * `writeFile` / `rename`) is wrapped and rethrown as `DatabaseError` `DRIVER`,\n * carrying the target `path` in its context; the read path ({@link\n * JSONDriver.#load}) tolerance above is a separate, deliberate contract and is\n * never touched by this wrapping.\n */\nexport class JSONDriver implements DriverInterface {\n\treadonly #path: string\n\treadonly #memory = new MemoryDriver()\n\t#schema: readonly TableSchema[] = []\n\t#meta: DriverMeta | undefined\n\t#flushCount = 0\n\t// Serializes #flush calls — each queued flush awaits the prior one before\n\t// serializing state, so the persisted snapshot always reflects the latest\n\t// memory state (see #flush @remarks).\n\t#chain: Promise<void> = Promise.resolve()\n\t// Set while a transaction() handle is active — suppresses #flush from\n\t// write/delete/clear so N mutations under the handle cost one file write\n\t// (on commit) instead of N (see transaction @remarks). Cleared by\n\t// commit/rollback, which is also how double-settle is detected.\n\t#deferring = false\n\t#transaction: object | undefined\n\n\tconstructor(path: string) {\n\t\tthis.#path = path\n\t}\n\n\tasync open(schema: readonly TableSchema[]): Promise<void> {\n\t\tthis.#schema = schema\n\t\tawait this.#memory.open(schema)\n\t\tawait this.#load()\n\t}\n\n\tasync close(): Promise<void> {\n\t\tawait this.#memory.close()\n\t}\n\n\tasync read(table: string, key: Key): Promise<Row | undefined> {\n\t\treturn this.#memory.read(table, key)\n\t}\n\n\tasync write(table: string, key: Key, row: Row): Promise<void> {\n\t\tawait this.#memory.write(table, key, row)\n\t\tif (!this.#deferring) await this.#flush()\n\t}\n\n\tasync delete(table: string, key: Key): Promise<boolean> {\n\t\tconst removed = await this.#memory.delete(table, key)\n\t\tif (!this.#deferring) await this.#flush()\n\t\treturn removed\n\t}\n\n\tkeys(table: string): Promise<readonly Key[]> {\n\t\treturn this.#memory.keys(table)\n\t}\n\n\tscan(table: string): AsyncIterable<Row> {\n\t\treturn this.#memory.scan(table)\n\t}\n\n\t/**\n\t * Natively filtered lazy iteration — delegates to the inner {@link MemoryDriver}.\n\t *\n\t * @remarks\n\t * Semantics are the memory driver's own: `criteria.conditions` filters, `offset`\n\t * / `limit` page lazily, and `criteria.order` is ignored (streaming yields key\n\t * order; sorted output is `records()`'s job).\n\t *\n\t * @param table - The table to stream\n\t * @param criteria - The filter / offset / limit to apply lazily\n\t */\n\tstream(table: string, criteria: Criteria): AsyncIterable<Row> {\n\t\treturn this.#memory.stream(table, criteria)\n\t}\n\n\tasync clear(table: string): Promise<void> {\n\t\tawait this.#memory.clear(table)\n\t\tif (!this.#deferring) await this.#flush()\n\t}\n\n\t/**\n\t * Begin a native transaction — flush-coalescing over the inner {@link MemoryDriver}.\n\t *\n\t * @remarks\n\t * Single-writer: throws `DatabaseError` `CONFLICT` if a transaction is already\n\t * active — this driver does not support nesting. On begin, captures the inner\n\t * memory rollback thunk via `#memory.snapshot()` and suppresses per-mutation\n\t * `#flush` — `write` / `delete` / `clear` still mutate memory but no longer\n\t * touch the file, so N mutations under the handle cost ONE file write instead\n\t * of N. `commit()` releases the suppression and performs that one atomic\n\t * `#flush()`, persisting the transaction's net state. `rollback()` restores\n\t * memory via the captured snapshot thunk, then `#flush()`s so the file reflects\n\t * the restored state. Outside a transaction, behavior is unchanged — every\n\t * mutation flushes on its own. Calling `commit` / `rollback` a second time (on\n\t * either method, in either order) throws `DatabaseError` `CONFLICT`.\n\t *\n\t * @returns A {@link TransactionInterface} handle to `commit` or `rollback`\n\t */\n\tasync transaction(): Promise<TransactionInterface> {\n\t\tif (this.#deferring) {\n\t\t\tthrow new DatabaseError('CONFLICT', 'A transaction is already active on this driver', {})\n\t\t}\n\t\tconst rollback = await this.#memory.snapshot()\n\t\tconst token = {}\n\t\tthis.#deferring = true\n\t\tthis.#transaction = token\n\t\treturn {\n\t\t\tcommit: this.#commit.bind(this, token),\n\t\t\trollback: this.#rollback.bind(this, token, rollback),\n\t\t}\n\t}\n\n\tasync snapshot(tables?: readonly string[]): Promise<() => Promise<void>> {\n\t\tconst rollback = await this.#memory.snapshot(tables)\n\t\t// Restore the in-memory state, then re-persist it — the file was rewritten\n\t\t// on each write during the scope, so a rollback must flush the restored state.\n\t\treturn async () => {\n\t\t\tawait rollback()\n\t\t\tawait this.#flush()\n\t\t}\n\t}\n\n\tasync meta(): Promise<DriverMeta | undefined> {\n\t\treturn this.#meta\n\t}\n\n\t/**\n\t * Persist `meta` verbatim for a later `meta()` to return.\n\t *\n\t * @remarks\n\t * Respects the same defer-flush suppression as `write` / `delete` / `clear`\n\t * (see {@link JSONDriver.transaction} @remarks) — stamping inside an active\n\t * transaction updates memory but does not flush until the transaction settles.\n\t *\n\t * @param meta - The {@link DriverMeta} to persist\n\t */\n\tasync stamp(meta: DriverMeta): Promise<void> {\n\t\tthis.#meta = meta\n\t\tif (!this.#deferring) await this.#flush()\n\t}\n\n\t/**\n\t * Apply a {@link Migration} plan by delegating to the inner {@link MemoryDriver},\n\t * then persist the migrated state.\n\t *\n\t * @remarks\n\t * The inner `MemoryDriver.migrate` applies each step (adding/removing tables,\n\t * adding/removing columns from stored rows, no-op index steps) and throws\n\t * `DatabaseError` `MIGRATION` for a step referencing an unknown table — that\n\t * error propagates untouched. `table.add` / `table.remove` steps also update\n\t * this driver's own declared `#schema`, mirroring the bookkeeping `open` does,\n\t * so a subsequent `#flush` / `#load` round-trip includes (or drops) the table.\n\t * A successful migration ends with one atomic `#flush()` so the new state\n\t * survives a close and reopen. A multi-step plan applies its steps\n\t * sequentially and is NOT atomic — a failure partway through a plan leaves\n\t * the earlier steps already applied.\n\t *\n\t * @param plan - The migration plan to apply\n\t */\n\tasync migrate(plan: Migration): Promise<void> {\n\t\tawait this.#memory.migrate?.(plan)\n\t\tlet schema = this.#schema\n\t\tfor (const step of plan.steps) {\n\t\t\tif (step.operation === 'table.add') {\n\t\t\t\tschema = schema.some((table) => table.name === step.table.name)\n\t\t\t\t\t? schema\n\t\t\t\t\t: [...schema, step.table]\n\t\t\t} else if (step.operation === 'table.remove') {\n\t\t\t\tschema = schema.filter((table) => table.name !== step.table)\n\t\t\t}\n\t\t}\n\t\tthis.#schema = schema\n\t\tawait this.#flush()\n\t}\n\n\t// === Private\n\n\tasync #commit(token: object): Promise<void> {\n\t\tif (this.#transaction !== token) {\n\t\t\tthrow new DatabaseError('CONFLICT', 'Transaction already settled', {})\n\t\t}\n\t\tthis.#transaction = undefined\n\t\tthis.#deferring = false\n\t\tawait this.#flush()\n\t}\n\n\tasync #rollback(token: object, rollback: () => Promise<void>): Promise<void> {\n\t\tif (this.#transaction !== token) {\n\t\t\tthrow new DatabaseError('CONFLICT', 'Transaction already settled', {})\n\t\t}\n\t\tthis.#transaction = undefined\n\t\tawait rollback()\n\t\tthis.#deferring = false\n\t\tawait this.#flush()\n\t}\n\n\t// Load the file into memory; a missing / corrupt / wrong-shaped file starts\n\t// empty (never throws). Each entry is narrowed via isRecord and its key recovered\n\t// with extractKey from the schema's primary column; bad entries are skipped. A\n\t// `meta` block is narrowed with the same tolerance — a malformed or absent\n\t// `meta` leaves #meta undefined (unstamped) rather than throwing, which is how\n\t// an old-format file (no `meta` key) is distinguished from a stamped one.\n\tasync #load(): Promise<void> {\n\t\tlet raw: string\n\t\ttry {\n\t\t\traw = await readFile(this.#path, 'utf-8')\n\t\t} catch {\n\t\t\treturn\n\t\t}\n\t\tlet parsed: unknown\n\t\ttry {\n\t\t\tparsed = JSON.parse(raw)\n\t\t} catch {\n\t\t\treturn\n\t\t}\n\t\tif (!isRecord(parsed) || !isRecord(parsed.tables)) return\n\t\tconst tables = parsed.tables\n\t\tfor (const table of this.#schema) {\n\t\t\tconst rows = tables[table.name]\n\t\t\tif (!Array.isArray(rows)) continue\n\t\t\tfor (const entry of rows) {\n\t\t\t\tif (!isRecord(entry)) continue\n\t\t\t\tconst key = extractKey(entry, table.primary)\n\t\t\t\tif (key === undefined) continue\n\t\t\t\tawait this.#memory.write(table.name, key, entry)\n\t\t\t}\n\t\t}\n\t\tif (isDriverMeta(parsed.meta)) this.#meta = parsed.meta\n\t}\n\n\t// Queue a flush behind #chain — see #flush @remarks for why.\n\tasync #flush(): Promise<void> {\n\t\tconst next = this.#chain.then(() => this.#serialize())\n\t\t// Swallow so a failed flush doesn't leave #chain permanently rejected and\n\t\t// block every later flush; the caller of THIS #flush still observes the\n\t\t// rejection via `next` below.\n\t\tthis.#chain = next.catch(() => {})\n\t\tawait next\n\t}\n\n\t// Drain every declared table's rows from memory (in key order) and write the\n\t// whole store back as one pretty-printed JSON object, creating the directory.\n\t//\n\t// @remarks\n\t// Written atomically: the payload lands in a sibling temp file (same directory,\n\t// so the platform rename is atomic) and is then renamed onto `#path`. A crash\n\t// mid-flush can no longer truncate or corrupt the previous good file — POSIX\n\t// `rename` replaces the destination in one indivisible step, so a reader always\n\t// sees either the old file or the fully-written new one, never a partial write.\n\t// `#flush` serializes calls to this method through `#chain` — each flush AWAITS\n\t// its predecessor before draining `#memory` and writing, so the payload always\n\t// reflects the latest memory state. Without this, overlapping flushes triggered\n\t// by non-awaited concurrent mutations could serialize out of order and persist a\n\t// stale snapshot as the \"latest\" file. `meta` is included in the payload only\n\t// once the store has been stamped, so an unstamped store keeps serializing the\n\t// old `{ tables }` shape (backward compat). Any failure in this write path\n\t// (`mkdir` / `writeFile` / `rename`) is wrapped as `DatabaseError` `DRIVER`\n\t// carrying `path` in its context, after the temp-file cleanup below runs.\n\tasync #serialize(): Promise<void> {\n\t\tconst tables: Record<string, readonly Row[]> = {}\n\t\tfor (const table of this.#schema) {\n\t\t\tconst rows: Row[] = []\n\t\t\tfor await (const row of this.#memory.scan(table.name)) rows.push(row)\n\t\t\ttables[table.name] = rows\n\t\t}\n\t\tthis.#flushCount += 1\n\t\tconst temp = `${this.#path}.${process.pid}.${this.#flushCount}.tmp`\n\t\tconst payload = this.#meta === undefined ? { tables } : { meta: this.#meta, tables }\n\t\ttry {\n\t\t\tawait mkdir(dirname(this.#path), { recursive: true })\n\t\t\tawait writeFile(temp, JSON.stringify(payload, null, 2), 'utf-8')\n\t\t\tawait rename(temp, this.#path)\n\t\t} catch (error) {\n\t\t\tawait rm(temp, { force: true }).catch(() => {})\n\t\t\tthrow new DatabaseError('DRIVER', 'Failed to persist the database file', {\n\t\t\t\tpath: this.#path,\n\t\t\t\tcause: error,\n\t\t\t})\n\t\t}\n\t}\n}\n","import type {\n\tAggregateFunction,\n\tCriteria,\n\tDriverInterface,\n\tDriverMeta,\n\tKey,\n\tMigration,\n\tRow,\n\tTableSchema,\n\tTransactionInterface,\n} from '@src/core'\nimport type { FieldPath } from '@orkestrel/contract'\nimport type { SQLiteDatabaseInterface, SQLiteRow, SQLiteValue } from '@orkestrel/sqlite'\nimport type { SQLiteDriverOptions } from '../types.js'\nimport {\n\tapplyCriteria,\n\tcomputeAggregate,\n\tDatabaseError,\n\tfilterRows,\n\tisDriverMeta,\n\tmatchesCriteria,\n} from '@src/core'\nimport { isString } from '@orkestrel/contract'\nimport { createSQLiteDatabase, isSQLiteError } from '@orkestrel/sqlite'\nimport { compileCriteria, compileWhere } from '../compilers.js'\nimport {\n\taggregateSQL,\n\tdecodeRow,\n\tencodeRow,\n\tencodeValue,\n\textractValues,\n\tisExactCondition,\n\tisExactCriteria,\n\tquote,\n\tschemaToIndexes,\n\tschemaToTable,\n\tstepToSchema,\n\tstepToSQL,\n} from '../helpers.js'\nimport { META_TABLE } from '../constants.js'\n\n/**\n * The SQLite {@link DriverInterface} — the server-native, trusted-mode backend\n * built on the published `@orkestrel/sqlite` synchronous wrapper.\n *\n * @remarks\n * A thin adapter: it implements the storage primitives the core database layer\n * needs by delegating to the wrapper's prepared statements — it never touches\n * raw `node:sqlite`. `open` issues `CREATE TABLE IF NOT EXISTS` with real typed\n * columns (mapped from each {@link TableSchema}'s portable column types) and a\n * `PRIMARY KEY`, plus a `CREATE INDEX IF NOT EXISTS` per declared index (both\n * reopen-safe), and readies a reserved `_meta` single-row table `meta()` /\n * `stamp()` read and write — **a user table named `_meta` collides with it**;\n * avoid the name. Rows cross the boundary through the codecs in `helpers.ts`\n * (`json` columns store / parse JSON text, a `boolean` stores `1` / `0`), so the\n * typed layer above imposes the exact shape (AGENTS §14). `write` is an\n * `INSERT OR REPLACE` upsert — the `Table` layer detects a `CONFLICT` via a\n * prior `has`, so this never translates a constraint error; a backend\n * `SQLiteError` otherwise propagates unchanged. Querying, ordering, paging, and\n * aggregation are native: `records` / `count` / `stream` compile a `Criteria`\n * to SQL with `compileCriteria`, and `aggregate` runs a SQL\n * `COUNT`/`SUM`/`AVG`/`MIN`/`MAX` (via `aggregateSQL`) over the same compiled\n * WHERE. `transaction` wraps native `BEGIN` / `COMMIT` / `ROLLBACK` with\n * double-settle guards. `migrate` runs the plan's projected DDL\n * ({@link import('../helpers.js').stepToSQL}) inside whichever native\n * transaction is active: joined into an already-open `transaction()` handle\n * when one exists (the core's versioned reconcile path wraps migrate + stamp\n * in one native `BEGIN`, and node:sqlite rejects a nested `BEGIN`), or inside\n * its own `database.transaction` otherwise — a mid-plan failure rolls back\n * atomically either way, an improvement over the non-atomic `MemoryDriver` /\n * `JSONDriver` migrate; a step referencing an undeclared table throws\n * `DatabaseError` `MIGRATION` before any DDL for that step runs. `snapshot` is\n * capture-replay (SELECT the\n * named tables' rows, replay via DELETE + INSERT OR REPLACE inside a native\n * transaction on rollback) rather than a SQL `SAVEPOINT`, since the core\n * `transaction` calls the rollback thunk only on failure with no commit-on-\n * success signal — a long-lived `SAVEPOINT` would leave the connection\n * uncommitted (lost on close). Every backend interaction runs through `#guard`,\n * which maps a thrown backend `SQLiteError` (or any unexpected non-`SQLiteError`\n * throw) to a typed {@link DatabaseError} — never a raw backend error escapes\n * `DriverInterface`: `CONSTRAINT` → `CONFLICT`, the wrapper's own `CLOSED` →\n * `CLOSED`, `BUSY` (a locked database that outlasted the configured `timeout`)\n * → a retryable `DRIVER` (`context.retryable` is `true`), and `UNKNOWN` / any\n * other throw → `DRIVER`. The original error is preserved as `context.cause`.\n * A `DatabaseError` this driver throws directly (`CLOSED` from the `#require`\n * gate, `NOT_FOUND` from `#table`, `MIGRATION` from a migration-plan fault)\n * passes through `#guard` unchanged, never re-wrapped.\n */\nexport class SQLiteDriver implements DriverInterface {\n\treadonly #path: string\n\treadonly #options: SQLiteDriverOptions\n\t#database: SQLiteDatabaseInterface | undefined\n\t#schema = new Map<string, TableSchema>()\n\t#transaction: object | undefined\n\n\tconstructor(path: string, options?: SQLiteDriverOptions) {\n\t\tthis.#path = path\n\t\tthis.#options = options ?? {}\n\t}\n\n\tasync open(schema: readonly TableSchema[]): Promise<void> {\n\t\tif (schema.some((table) => table.name === META_TABLE)) {\n\t\t\tthrow new DatabaseError(\n\t\t\t\t'VALIDATION',\n\t\t\t\t`A declared table cannot be named '${META_TABLE}' — it is reserved for driver metadata`,\n\t\t\t\t{ table: META_TABLE },\n\t\t\t)\n\t\t}\n\t\tthis.#guard(() => {\n\t\t\tthis.#database?.close()\n\t\t\tconst database = createSQLiteDatabase({\n\t\t\t\tpath: this.#path,\n\t\t\t\t...(this.#options.readonly !== undefined ? { readonly: this.#options.readonly } : {}),\n\t\t\t\t...(this.#options.timeout !== undefined ? { timeout: this.#options.timeout } : {}),\n\t\t\t\t...(this.#options.foreignKeys !== undefined\n\t\t\t\t\t? { foreignKeys: this.#options.foreignKeys }\n\t\t\t\t\t: {}),\n\t\t\t})\n\t\t\tdatabase.connect()\n\t\t\tfor (const [name, value] of Object.entries(this.#options.pragmas ?? {})) {\n\t\t\t\tdatabase.pragma(name, value)\n\t\t\t}\n\t\t\tconst map = new Map<string, TableSchema>()\n\t\t\tfor (const table of schema) {\n\t\t\t\tmap.set(table.name, table)\n\t\t\t\tdatabase.exec(schemaToTable(table))\n\t\t\t\tfor (const sql of schemaToIndexes(table)) database.exec(sql)\n\t\t\t}\n\t\t\tdatabase.exec(\n\t\t\t\t'CREATE TABLE IF NOT EXISTS ' +\n\t\t\t\t\tquote(META_TABLE) +\n\t\t\t\t\t' (\"id\" INTEGER, \"version\" INTEGER, \"schema\" TEXT, PRIMARY KEY (\"id\"))',\n\t\t\t)\n\t\t\tthis.#schema = map\n\t\t\tthis.#database = database\n\t\t})\n\t}\n\n\tasync close(): Promise<void> {\n\t\tthis.#database?.close()\n\t\tthis.#database = undefined\n\t}\n\n\tasync read(table: string, key: Key): Promise<Row | undefined> {\n\t\tconst schema = this.#table(table)\n\t\treturn this.#guard(() => {\n\t\t\tconst row = this.#require()\n\t\t\t\t.prepare('SELECT * FROM ' + quote(table) + ' WHERE ' + quote(schema.primary) + ' = ?')\n\t\t\t\t.get([this.#key(key, schema)])\n\t\t\treturn row === undefined ? undefined : decodeRow(row, schema)\n\t\t})\n\t}\n\n\tasync write(table: string, key: Key, row: Row): Promise<void> {\n\t\tconst schema = this.#table(table)\n\t\tthis.#guard(() => {\n\t\t\tconst encoded = encodeRow({ ...row, [schema.primary]: key }, schema)\n\t\t\tconst names = schema.columns.map((column) => column.name)\n\t\t\tconst values = extractValues(encoded, names, table)\n\t\t\tthis.#require()\n\t\t\t\t.prepare(\n\t\t\t\t\t'INSERT OR REPLACE INTO ' +\n\t\t\t\t\t\tquote(table) +\n\t\t\t\t\t\t' (' +\n\t\t\t\t\t\tnames.map(quote).join(', ') +\n\t\t\t\t\t\t') VALUES (' +\n\t\t\t\t\t\tnames.map(() => '?').join(', ') +\n\t\t\t\t\t\t')',\n\t\t\t\t)\n\t\t\t\t.run(values)\n\t\t})\n\t}\n\n\tasync delete(table: string, key: Key): Promise<boolean> {\n\t\tconst schema = this.#table(table)\n\t\treturn this.#guard(() => {\n\t\t\tconst result = this.#require()\n\t\t\t\t.prepare('DELETE FROM ' + quote(table) + ' WHERE ' + quote(schema.primary) + ' = ?')\n\t\t\t\t.run([this.#key(key, schema)])\n\t\t\treturn result.changes > 0\n\t\t})\n\t}\n\n\tasync keys(table: string): Promise<readonly Key[]> {\n\t\tconst schema = this.#table(table)\n\t\treturn this.#guard(() => {\n\t\t\tconst primary = quote(schema.primary)\n\t\t\t// ORDER BY the primary key: the contract lists keys in key order, and\n\t\t\t// SQLite returns rows in rowid (insertion) order without it.\n\t\t\tconst rows = this.#require()\n\t\t\t\t.prepare('SELECT ' + primary + ' FROM ' + quote(table) + ' ORDER BY ' + primary)\n\t\t\t\t.all()\n\t\t\tconst keys: Key[] = []\n\t\t\tfor (const row of rows) {\n\t\t\t\tconst value = row[schema.primary]\n\t\t\t\tif (typeof value === 'string' || typeof value === 'number') keys.push(value)\n\t\t\t}\n\t\t\treturn keys\n\t\t})\n\t}\n\n\tasync *scan(table: string): AsyncIterable<Row> {\n\t\tconst schema = this.#table(table)\n\t\t// ORDER BY the primary key so the scan yields rows in key order (the engine\n\t\t// and cursors depend on it), not SQLite's default rowid order. Every step —\n\t\t// the iterator setup, each `next()` pull, and each row's decode — runs\n\t\t// through #guard, so a mid-iteration backend fault (not just the initial\n\t\t// call) surfaces as a mapped DatabaseError rather than leaking raw.\n\t\tconst iterator = this.#guard(() =>\n\t\t\tthis.#require()\n\t\t\t\t.prepare('SELECT * FROM ' + quote(table) + ' ORDER BY ' + quote(schema.primary))\n\t\t\t\t.iterate(),\n\t\t)[Symbol.iterator]()\n\t\twhile (true) {\n\t\t\tconst step = this.#guard(() => iterator.next())\n\t\t\tif (step.done === true) return\n\t\t\tyield this.#guard(() => decodeRow(step.value, schema))\n\t\t}\n\t}\n\n\tasync clear(table: string): Promise<void> {\n\t\tthis.#table(table)\n\t\tthis.#guard(() => {\n\t\t\tthis.#require()\n\t\t\t\t.prepare('DELETE FROM ' + quote(table))\n\t\t\t\t.run()\n\t\t})\n\t}\n\n\t// Doctrine (AGENTS §5, the audit's keystone fix): a Criteria whose compiled\n\t// SQL is PROVABLY identical to the core engine's semantics (see\n\t// `isExactCondition` / `isExactOrder` / `isExactCriteria`) runs the fast\n\t// native path; otherwise this driver fetches a full scan and refines it\n\t// through the SAME core engine every scan-only driver (`MemoryDriver`,\n\t// `JSONDriver`) already uses — exact → native, otherwise → refine, never a\n\t// silent semantics drift between backends. A native `WHERE` that is a\n\t// PROVABLE SUPERSET of the engine's match set (compile natively, then\n\t// engine-refine only the returned rows) is a possible future optimization,\n\t// not implemented here.\n\tasync records(table: string, criteria: Criteria): Promise<readonly Row[]> {\n\t\tconst schema = this.#table(table)\n\t\tif (isExactCriteria(criteria, schema)) {\n\t\t\treturn this.#guard(() => {\n\t\t\t\tconst { sql, params } = compileCriteria(criteria, schema)\n\t\t\t\tconst rows = this.#require()\n\t\t\t\t\t.prepare('SELECT * FROM ' + quote(table) + (sql === '' ? '' : ' ' + sql))\n\t\t\t\t\t.all(params)\n\t\t\t\treturn rows.map((row) => decodeRow(row, schema))\n\t\t\t})\n\t\t}\n\t\tconst rows: Row[] = []\n\t\tfor await (const row of this.scan(table)) rows.push(row)\n\t\treturn applyCriteria(rows, criteria)\n\t}\n\n\tasync count(table: string, criteria: Criteria): Promise<number> {\n\t\tconst schema = this.#table(table)\n\t\tconst conditions = criteria.conditions ?? []\n\t\tif (conditions.every((condition) => isExactCondition(condition, schema))) {\n\t\t\treturn this.#guard(() => {\n\t\t\t\t// Compile only the WHERE clause — no ORDER BY, no LIMIT/OFFSET — so a\n\t\t\t\t// direct call with `criteria.offset` set never skips the single\n\t\t\t\t// aggregate row (`compileCriteria`'s paging would otherwise apply\n\t\t\t\t// OFFSET/LIMIT to the one-row COUNT result).\n\t\t\t\tconst { sql, params } = compileWhere(conditions, schema)\n\t\t\t\tconst row = this.#require()\n\t\t\t\t\t.prepare('SELECT COUNT(*) AS count FROM ' + quote(table) + (sql === '' ? '' : ' ' + sql))\n\t\t\t\t\t.get(params)\n\t\t\t\tconst value = row?.count\n\t\t\t\treturn typeof value === 'number' || typeof value === 'bigint' ? Number(value) : 0\n\t\t\t})\n\t\t}\n\t\tconst rows: Row[] = []\n\t\tfor await (const row of this.scan(table)) rows.push(row)\n\t\treturn filterRows(rows, conditions).length\n\t}\n\n\tasync aggregate(\n\t\ttable: string,\n\t\toperation: AggregateFunction,\n\t\tcolumn: FieldPath,\n\t\tcriteria: Criteria,\n\t): Promise<number | undefined> {\n\t\tconst schema = this.#table(table)\n\t\tconst conditions = criteria.conditions ?? []\n\t\tconst conditionsExact = conditions.every((condition) => isExactCondition(condition, schema))\n\t\t// `count` ignores `column` entirely (COUNT(*) over rows), so only the\n\t\t// conditions need to be exact; every other aggregate coerces the column\n\t\t// numerically (parseNumber) — only a flat, declared integer/real column\n\t\t// is provably exact (a text/json/blob column may hold non-numeric cells\n\t\t// the engine skips via parseNumber, which SQL's numeric aggregates do not).\n\t\tconst columnExact =\n\t\t\toperation === 'count' ||\n\t\t\t(isString(column) &&\n\t\t\t\tschema.columns.some(\n\t\t\t\t\t(candidate) =>\n\t\t\t\t\t\tcandidate.name === column &&\n\t\t\t\t\t\t(candidate.type === 'integer' || candidate.type === 'real'),\n\t\t\t\t))\n\t\tif (conditionsExact && columnExact) {\n\t\t\treturn this.#guard(() => {\n\t\t\t\t// WHERE-only compile — same rationale as `count`: paging must never\n\t\t\t\t// apply to the single aggregate row.\n\t\t\t\tconst { sql, params } = compileWhere(conditions, schema)\n\t\t\t\tconst value = this.#require()\n\t\t\t\t\t.prepare(\n\t\t\t\t\t\t'SELECT ' +\n\t\t\t\t\t\t\taggregateSQL(operation, column) +\n\t\t\t\t\t\t\t' AS value FROM ' +\n\t\t\t\t\t\t\tquote(table) +\n\t\t\t\t\t\t\t(sql === '' ? '' : ' ' + sql),\n\t\t\t\t\t)\n\t\t\t\t\t.get(params)?.value\n\t\t\t\t// Over zero matched rows SUM/AVG/MIN/MAX are SQL NULL → undefined (the\n\t\t\t\t// engine agrees); COUNT(*) is 0. A clean numeric column coerces as the\n\t\t\t\t// engine does.\n\t\t\t\treturn value === null || value === undefined ? undefined : Number(value)\n\t\t\t})\n\t\t}\n\t\tconst rows: Row[] = []\n\t\tfor await (const row of this.scan(table)) rows.push(row)\n\t\treturn computeAggregate(filterRows(rows, conditions), operation, column)\n\t}\n\n\t// `order` is intentionally IGNORED (per DriverInterface.stream — streaming\n\t// yields unsorted), so the native gate checks only `conditions`; `offset` /\n\t// `limit` are always engine-identical under either path.\n\tasync *stream(table: string, criteria: Criteria): AsyncIterable<Row> {\n\t\tconst schema = this.#table(table)\n\t\tconst conditions = criteria.conditions ?? []\n\t\tif (conditions.every((condition) => isExactCondition(condition, schema))) {\n\t\t\tconst compiled = compileCriteria(\n\t\t\t\t{\n\t\t\t\t\tconditions,\n\t\t\t\t\t...(criteria.limit !== undefined ? { limit: criteria.limit } : {}),\n\t\t\t\t\t...(criteria.offset !== undefined ? { offset: criteria.offset } : {}),\n\t\t\t\t},\n\t\t\t\tschema,\n\t\t\t)\n\t\t\tfor (const row of this.#require()\n\t\t\t\t.prepare('SELECT * FROM ' + quote(table) + (compiled.sql === '' ? '' : ' ' + compiled.sql))\n\t\t\t\t.iterate(compiled.params)) {\n\t\t\t\tyield decodeRow(row, schema)\n\t\t\t}\n\t\t\treturn\n\t\t}\n\t\tconst offset = criteria.offset ?? 0\n\t\tconst limit = criteria.limit\n\t\tlet skipped = 0\n\t\tlet yielded = 0\n\t\tfor await (const row of this.scan(table)) {\n\t\t\tif (limit !== undefined && yielded >= limit) return\n\t\t\tif (conditions.length > 0 && !matchesCriteria(row, conditions)) continue\n\t\t\tif (skipped < offset) {\n\t\t\t\tskipped += 1\n\t\t\t\tcontinue\n\t\t\t}\n\t\t\tyield row\n\t\t\tyielded += 1\n\t\t}\n\t}\n\n\t/**\n\t * Begin a native transaction — real `BEGIN`, `COMMIT`, `ROLLBACK`.\n\t *\n\t * @remarks\n\t * Calling `commit` or `rollback` a second time (on either method, in either\n\t * order) throws `DatabaseError` `CONFLICT`.\n\t *\n\t * @returns A {@link TransactionInterface} handle to `commit` or `rollback`\n\t */\n\tasync transaction(): Promise<TransactionInterface> {\n\t\tconst database = this.#require()\n\t\tthis.#guard(() => database.exec('BEGIN'))\n\t\tconst token = {}\n\t\tthis.#transaction = token\n\t\treturn {\n\t\t\tcommit: this.#commit.bind(this, token, database),\n\t\t\trollback: this.#rollback.bind(this, token, database),\n\t\t}\n\t}\n\n\t/**\n\t * Apply a {@link Migration} plan by executing each step's projected DDL\n\t * ({@link import('../helpers.js').stepToSQL}).\n\t *\n\t * @remarks\n\t * Atomicity is provided by whichever native transaction is active: when\n\t * this driver's own `transaction()` hook already has a handle open (the\n\t * core's versioned reconcile / migrate path joins migrate + stamp under\n\t * one native `BEGIN`), the plan's DDL runs directly inside that enclosing\n\t * transaction — a mid-plan failure propagates out and the CALLER's\n\t * `commit`/`rollback` provides atomicity. node:sqlite (and SQLite\n\t * generally) rejects a nested `BEGIN`, so this driver must never open a\n\t * second native transaction while one is already open. Otherwise (no\n\t * enclosing transaction), `migrate` wraps the plan in its own native\n\t * `database.transaction` — atomic on its own: a mid-plan failure rolls\n\t * back every DDL statement already applied by the plan. A step\n\t * referencing a table not in this driver's declared schema (and that is\n\t * not itself a `table.add`) throws `DatabaseError` `MIGRATION` before any\n\t * DDL for that step runs, propagating out of whichever transaction is\n\t * active (which rolls back on a throw).\n\t *\n\t * @param plan - The migration plan to apply\n\t */\n\tasync migrate(plan: Migration): Promise<void> {\n\t\tconst database = this.#require()\n\t\tconst schema = new Map(this.#schema)\n\t\tthis.#guard(() => {\n\t\t\tif (this.#transaction !== undefined) {\n\t\t\t\tthis.#applyPlan(database, plan, schema)\n\t\t\t} else {\n\t\t\t\tdatabase.transaction(() => this.#applyPlan(database, plan, schema))\n\t\t\t}\n\t\t})\n\t\tthis.#schema = schema\n\t}\n\n\t/**\n\t * Read the persisted {@link DriverMeta} from the reserved `_meta` table.\n\t *\n\t * @returns The last-stamped `DriverMeta`, or `undefined` when never stamped\n\t *   (or the stored row is malformed)\n\t */\n\tasync meta(): Promise<DriverMeta | undefined> {\n\t\tconst row = this.#guard(() =>\n\t\t\tthis.#require()\n\t\t\t\t.prepare('SELECT \"version\", \"schema\" FROM ' + quote(META_TABLE) + ' WHERE \"id\" = 1')\n\t\t\t\t.get(),\n\t\t)\n\t\tif (row === undefined) return undefined\n\t\tconst version = row.version\n\t\tconst text = row.schema\n\t\tif (typeof text !== 'string') return undefined\n\t\tif (typeof version !== 'number' && typeof version !== 'bigint') return undefined\n\t\tlet parsed: unknown\n\t\ttry {\n\t\t\tparsed = JSON.parse(text)\n\t\t} catch {\n\t\t\treturn undefined\n\t\t}\n\t\tconst candidate = { version: Number(version), schema: parsed }\n\t\tif (!isDriverMeta(candidate)) return undefined\n\t\treturn candidate\n\t}\n\n\t/**\n\t * Persist `meta` verbatim (as JSON) into the reserved `_meta` table's single\n\t * row.\n\t *\n\t * @param meta - The {@link DriverMeta} to persist\n\t */\n\tasync stamp(meta: DriverMeta): Promise<void> {\n\t\tthis.#guard(() => {\n\t\t\tthis.#require()\n\t\t\t\t.prepare(\n\t\t\t\t\t'INSERT OR REPLACE INTO ' +\n\t\t\t\t\t\tquote(META_TABLE) +\n\t\t\t\t\t\t' (\"id\", \"version\", \"schema\") VALUES (1, ?, ?)',\n\t\t\t\t)\n\t\t\t\t.run([meta.version, JSON.stringify(meta.schema)])\n\t\t})\n\t}\n\n\tasync snapshot(tables?: readonly string[]): Promise<() => Promise<void>> {\n\t\tconst database = this.#require()\n\t\t// Capture-replay rather than a SQL SAVEPOINT: the core `transaction` calls\n\t\t// the rollback thunk only on failure, with no commit-on-success signal — a\n\t\t// long-lived SAVEPOINT would leave the connection in an uncommitted\n\t\t// transaction (lost on close). Captured rows are already encoded, so they\n\t\t// reinsert directly. `tables` omitted captures/restores the whole schema.\n\t\tconst names = tables ?? [...this.#schema.keys()]\n\t\tconst captured = new Map<\n\t\t\tstring,\n\t\t\t{ readonly names: readonly string[]; readonly rows: readonly SQLiteRow[] }\n\t\t>()\n\t\tfor (const name of names) {\n\t\t\tconst schema = this.#schema.get(name)\n\t\t\tif (schema === undefined) continue\n\t\t\tcaptured.set(name, {\n\t\t\t\tnames: schema.columns.map((column) => column.name),\n\t\t\t\trows: database.prepare('SELECT * FROM ' + quote(name)).all(),\n\t\t\t})\n\t\t}\n\t\treturn async () => {\n\t\t\tconst current = this.#require()\n\t\t\tcurrent.transaction(() => {\n\t\t\t\tfor (const [name, snapshot] of captured) {\n\t\t\t\t\tcurrent.exec('DELETE FROM ' + quote(name))\n\t\t\t\t\tconst statement = current.prepare(\n\t\t\t\t\t\t'INSERT OR REPLACE INTO ' +\n\t\t\t\t\t\t\tquote(name) +\n\t\t\t\t\t\t\t' (' +\n\t\t\t\t\t\t\tsnapshot.names.map(quote).join(', ') +\n\t\t\t\t\t\t\t') VALUES (' +\n\t\t\t\t\t\t\tsnapshot.names.map(() => '?').join(', ') +\n\t\t\t\t\t\t\t')',\n\t\t\t\t\t)\n\t\t\t\t\tfor (const row of snapshot.rows) {\n\t\t\t\t\t\tstatement.run(extractValues(row, snapshot.names, name))\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t})\n\t\t}\n\t}\n\n\t// === Private\n\n\tasync #commit(token: object, database: SQLiteDatabaseInterface): Promise<void> {\n\t\tif (this.#transaction !== token) {\n\t\t\tthrow new DatabaseError('CONFLICT', 'Transaction already settled', {})\n\t\t}\n\t\tthis.#transaction = undefined\n\t\tthis.#guard(() => database.exec('COMMIT'))\n\t}\n\n\tasync #rollback(token: object, database: SQLiteDatabaseInterface): Promise<void> {\n\t\tif (this.#transaction !== token) {\n\t\t\tthrow new DatabaseError('CONFLICT', 'Transaction already settled', {})\n\t\t}\n\t\tthis.#transaction = undefined\n\t\tthis.#guard(() => database.exec('ROLLBACK'))\n\t}\n\n\t// Run a synchronous backend interaction, mapping any `SQLiteError` (or\n\t// unexpected non-`SQLiteError` throw) to a typed `DatabaseError` so a\n\t// backend fault never leaks through `DriverInterface` unwrapped: a\n\t// `CONSTRAINT` violation becomes `CONFLICT`; the wrapper's own `CLOSED`\n\t// passes through as `CLOSED`; a `BUSY` (a locked database that outlasted\n\t// the configured `timeout`) becomes a `DRIVER` error whose context marks it\n\t// `retryable`; `UNKNOWN` and any non-`SQLiteError` throw become `DRIVER`.\n\t// A `DatabaseError` already thrown by this driver itself (the `#require`\n\t// `CLOSED` gate, `#table`'s `NOT_FOUND`, a `MIGRATION` step fault) passes\n\t// through unchanged — it is never re-wrapped. The original error is kept\n\t// as `context.cause` for diagnostics.\n\t#guard<T>(run: () => T): T {\n\t\ttry {\n\t\t\treturn run()\n\t\t} catch (error) {\n\t\t\tif (error instanceof DatabaseError) throw error\n\t\t\tif (isSQLiteError(error)) {\n\t\t\t\tif (error.code === 'CONSTRAINT') {\n\t\t\t\t\tthrow new DatabaseError('CONFLICT', error.message, { cause: error, code: error.code })\n\t\t\t\t}\n\t\t\t\tif (error.code === 'CLOSED') {\n\t\t\t\t\tthrow new DatabaseError('CLOSED', error.message, { cause: error, code: error.code })\n\t\t\t\t}\n\t\t\t\tif (error.code === 'BUSY') {\n\t\t\t\t\tthrow new DatabaseError('DRIVER', error.message, {\n\t\t\t\t\t\tcause: error,\n\t\t\t\t\t\tcode: error.code,\n\t\t\t\t\t\tretryable: true,\n\t\t\t\t\t})\n\t\t\t\t}\n\t\t\t\tthrow new DatabaseError('DRIVER', error.message, { cause: error, code: error.code })\n\t\t\t}\n\t\t\tthrow new DatabaseError('DRIVER', error instanceof Error ? error.message : String(error), {\n\t\t\t\tcause: error,\n\t\t\t})\n\t\t}\n\t}\n\n\t#require(): SQLiteDatabaseInterface {\n\t\tif (this.#database === undefined) {\n\t\t\tthrow new DatabaseError('CLOSED', `SQLite database '${this.#path}' is not open`, {\n\t\t\t\tpath: this.#path,\n\t\t\t})\n\t\t}\n\t\treturn this.#database\n\t}\n\n\t// Require the database open and resolve a declared table's schema.\n\t#table(name: string): TableSchema {\n\t\tthis.#require()\n\t\tconst schema = this.#schema.get(name)\n\t\tif (schema === undefined) {\n\t\t\tthrow new DatabaseError('NOT_FOUND', `Table '${name}' is not in the schema`, { table: name })\n\t\t}\n\t\treturn schema\n\t}\n\n\t// Encode a primary key for binding against its column's stored type.\n\t#key(key: Key, schema: TableSchema): SQLiteValue {\n\t\tconst primary = schema.columns.find((column) => column.name === schema.primary)\n\t\treturn encodeValue(key, primary === undefined ? 'text' : primary.type)\n\t}\n\n\t// Walk a migration plan's steps, executing each one's projected DDL and updating\n\t// the working `schema` copy in place — shared by both `migrate`'s joined-transaction\n\t// (native handle already open) and self-wrapped (own `database.transaction`) paths.\n\t#applyPlan(\n\t\tdatabase: SQLiteDatabaseInterface,\n\t\tplan: Migration,\n\t\tschema: Map<string, TableSchema>,\n\t): void {\n\t\tfor (const step of plan.steps) {\n\t\t\tconst table = step.operation === 'table.add' ? step.table.name : step.table\n\t\t\tif (step.operation !== 'table.add' && !schema.has(table)) {\n\t\t\t\tthrow new DatabaseError('MIGRATION', `migrate: unknown table '${table}'`, { table })\n\t\t\t}\n\t\t\tfor (const sql of stepToSQL(step)) database.exec(sql)\n\t\t\tif (step.operation === 'table.add') {\n\t\t\t\tschema.set(step.table.name, step.table)\n\t\t\t} else if (step.operation === 'table.remove') {\n\t\t\t\tschema.delete(step.table)\n\t\t\t} else {\n\t\t\t\tconst existing = schema.get(table)\n\t\t\t\tif (existing !== undefined) schema.set(table, stepToSchema(existing, step))\n\t\t\t}\n\t\t}\n\t}\n}\n","import type { DriverInterface } from '@src/core'\nimport type { SQLiteDriverOptions } from './types.js'\nimport { isString } from '@orkestrel/contract'\nimport { JSONDriver } from './drivers/JSONDriver.js'\nimport { SQLiteDriver } from './drivers/SQLiteDriver.js'\n\n/**\n * Create a persistent JSON-file {@link DriverInterface} for the core database layer.\n *\n * @remarks\n * Pass it to `createDatabase` from `@orkestrel/database` to run the whole typed database +\n * relations stack against a single JSON file instead of memory — the `Database` /\n * `Table` / `Query` / relations API is unchanged; only where the bytes live changes.\n * The driver is the reference `MemoryDriver` plus JSON-file persistence: `open` loads\n * the file, every mutation flushes the whole store back, and querying runs through\n * the core engine over `scan` (it is scan-only — no native `records` / `count` /\n * `aggregate`). A missing, corrupt, or wrong-shaped file starts empty rather than\n * throwing.\n *\n * @param path - The JSON file path data is loaded from and flushed to\n * @returns A {@link DriverInterface} backed by a JSON file\n *\n * @example\n * ```ts\n * import { createDatabase } from '@orkestrel/database'\n * import { stringShape } from '@orkestrel/contract'\n * import { createJSONDriver } from '@orkestrel/database/server'\n *\n * const db = createDatabase({\n * \tdriver: createJSONDriver('data/app.json'),\n * \ttables: { users: { id: stringShape(), name: stringShape() } },\n * })\n * await db.table('users').set({ id: 'u1', name: 'Ada' }) // persisted to app.json\n * ```\n */\nexport function createJSONDriver(path: string): DriverInterface {\n\treturn new JSONDriver(path)\n}\n\n/**\n * Create a trusted-mode SQLite {@link DriverInterface} for the core database layer.\n *\n * @remarks\n * Pass it to `createDatabase` from `@orkestrel/database` to run the whole typed database +\n * relations stack against a real SQLite database — the `Database` / `Table` /\n * `Query` / relations API is unchanged; only where the bytes live changes. Built\n * on the published `@orkestrel/sqlite` synchronous wrapper: `open` issues real\n * typed `CREATE TABLE` / `CREATE INDEX` statements (reopen-safe) plus a reserved\n * `_meta` table for `meta()` / `stamp()` — avoid naming a table `_meta`.\n * Querying, paging, and aggregation run natively (`records` / `count` /\n * `aggregate` / `stream`); `transaction` and `migrate` use real `BEGIN` /\n * `COMMIT` / `ROLLBACK`, so `migrate` is atomic even mid-plan.\n *\n * @param options - A bare database file path (`':memory:'` by default, for\n *   back-compat), or a full {@link SQLiteDriverOptions} bag (`path`,\n *   `readonly`, `timeout`, `foreignKeys`, `pragmas`)\n * @returns A {@link DriverInterface} backed by SQLite\n *\n * @example\n * ```ts\n * import { createDatabase } from '@orkestrel/database'\n * import { stringShape } from '@orkestrel/contract'\n * import { createSQLiteDriver } from '@orkestrel/database/server'\n *\n * const db = createDatabase({\n * \tdriver: createSQLiteDriver('data/app.sqlite'),\n * \ttables: { users: { id: stringShape(), name: stringShape() } },\n * })\n * await db.table('users').set({ id: 'u1', name: 'Ada' }) // persisted to app.sqlite\n *\n * // Or with options:\n * createSQLiteDriver({ path: 'data/app.sqlite', pragmas: { journal_mode: 'WAL' } })\n * ```\n */\nexport function createSQLiteDriver(\n\toptions: string | SQLiteDriverOptions = ':memory:',\n): DriverInterface {\n\tconst resolved: SQLiteDriverOptions = isString(options) ? { path: options } : options\n\treturn new SQLiteDriver(resolved.path ?? ':memory:', resolved)\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA2BA,IAAa,qBAA4C,OAAO,OAAO;CACtE;CACA;CACA;CACA;AACD,CAAC;;;;;;;;;AAUD,IAAa,2BAAkD,OAAO,OAAO;CAC5E;CACA;CACA;AACD,CAAC;;;;;;;;;;AAWD,IAAa,aAAa;;;;;;;;;;;;;;;;;;ACV1B,SAAgB,cAAsB;CACrC,QAAA,GAAA,YAAA,WAAA,CAAkB;AACnB;;;;;;;;;;;;;;;;;;;AAgCA,SAAgB,oBAAoB,OAAgB,MAA2B;CAC9E,IAAI,SAAS,QAAQ,QAAA,GAAA,oBAAA,SAAA,CAAgB,KAAK;CAC1C,IAAI,SAAS,WAAW,QAAA,GAAA,oBAAA,UAAA,CAAiB,KAAK;CAC9C,QAAA,GAAA,oBAAA,eAAA,CAAsB,KAAK;AAC5B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAsCA,SAAgB,iBAAiB,WAAsB,QAA8B;CACpF,IAAI,EAAA,GAAA,oBAAA,SAAA,CAAU,UAAU,MAAM,GAAG,OAAO;CACxC,MAAM,SAAS,OAAO,QAAQ,MAAM,cAAc,UAAU,SAAS,UAAU,MAAM;CACrF,IAAI,WAAW,KAAA,GAAW,OAAO;CACjC,IAAI,UAAU,aAAa,YAAY,UAAU,aAAa,WAAW,OAAO;CAChF,IAAI,CAAC,mBAAmB,MAAM,SAAS,SAAS,OAAO,IAAI,GAAG,OAAO;CACrE,MAAM,QAAQ,UAAU,OAAO;CAC/B,MAAM,SAAS,UAAU,OAAO;CAChC,QAAQ,UAAU,UAAlB;EACC,KAAK;EACL,KAAK,OACJ,OAAO,oBAAoB,OAAO,OAAO,IAAI;EAC9C,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK,MACJ,OACC,yBAAyB,MAAM,SAAS,SAAS,OAAO,IAAI,KAC5D,oBAAoB,OAAO,OAAO,IAAI;EAExC,KAAK,WACJ,OACC,yBAAyB,MAAM,SAAS,SAAS,OAAO,IAAI,KAC5D,oBAAoB,OAAO,OAAO,IAAI,KACtC,oBAAoB,QAAQ,OAAO,IAAI;EAEzC,KAAK;EACL,KAAK,QACJ,OACC,UAAU,OAAO,SAAS,KAC1B,UAAU,OAAO,OAAO,UAAU,oBAAoB,OAAO,OAAO,IAAI,CAAC;EAE3E,KAAK;EACL,KAAK,QACJ,OAAO,OAAO,SAAS,WAAA,GAAA,oBAAA,SAAA,CAAmB,KAAK;EAChD,KAAK;EACL,KAAK,QACJ,OAAO;CACT;AACD;;;;;;;;;;;;;;;;;;AAmBA,SAAgB,aAAa,OAAc,QAA8B;CACxE,IAAI,EAAA,GAAA,oBAAA,SAAA,CAAU,MAAM,MAAM,GAAG,OAAO;CACpC,MAAM,SAAS,OAAO,QAAQ,MAAM,cAAc,UAAU,SAAS,MAAM,MAAM;CACjF,IAAI,WAAW,KAAA,GAAW,OAAO;CACjC,OAAO,yBAAyB,MAAM,SAAS,SAAS,OAAO,IAAI;AACpE;;;;;;;;;;AAWA,SAAgB,gBAAgB,UAAoB,QAA8B;CACjF,MAAM,aAAa,SAAS,cAAc,CAAC;CAC3C,MAAM,QAAQ,SAAS,SAAS,CAAC;CACjC,OACC,WAAW,OAAO,cAAc,iBAAiB,WAAW,MAAM,CAAC,KACnE,MAAM,OAAO,SAAS,aAAa,MAAM,MAAM,CAAC;AAElD;;;;;;;;;;;;;;;;;;;;AAuBA,SAAgB,UAAU,MAA0B;CACnD,QAAQ,MAAR;EACC,KAAK;EACL,KAAK,QACJ,OAAO;EACR,KAAK;EACL,KAAK,WACJ,OAAO;EACR,KAAK,QACJ,OAAO;EACR,KAAK,QACJ,OAAO;CACT;AACD;;;;;;;;;;;;;;;;;AAkBA,SAAgB,MAAM,YAA4B;CACjD,OAAO,OAAM,WAAW,WAAW,MAAK,MAAI,IAAI;AACjD;;;;;;;;;;;;;;;;;;;;AAqBA,SAAgB,YAAY,MAAyB;CACpD,KAAA,GAAA,oBAAA,SAAA,CAAa,IAAI,GAAG,OAAO,MAAM,IAAI;CACrC,MAAM,CAAC,QAAQ,GAAG,UAAU;CAC5B,IAAI,WAAW,KAAA,GACd,MAAM,IAAI,UAAA,cAAc,cAAc,+CAA+C;CAEtF,MAAM,OAAO,OAAO,KAAK,QAAQ,MAAM,IAAI,WAAW,KAAK,IAAI,CAAC,CAAC,CAAC,KAAK,EAAE;CACzE,OAAO,kBAAkB,MAAM,MAAM,IAAI,SAAS,OAAO;AAC1D;;;;;;;;;;;;;;;;;;;;;;;;;AA0BA,SAAgB,aAAa,WAA8B,QAA2B;CACrF,QAAQ,WAAR;EACC,KAAK,SACJ,OAAO;EACR,KAAK,OACJ,OAAO,SAAS,YAAY,MAAM,IAAI;EACvC,KAAK,WACJ,OAAO,SAAS,YAAY,MAAM,IAAI;EACvC,KAAK,WACJ,OAAO,SAAS,YAAY,MAAM,IAAI;EACvC,KAAK,WACJ,OAAO,SAAS,YAAY,MAAM,IAAI;CACxC;AACD;;;;;;;;;;;;;;;;;;;;;;;AA0BA,SAAgB,YAAY,OAAgB,MAA+B;CAC1E,QAAQ,MAAR;EACC,KAAK,WACJ,OAAO,UAAU,KAAA,KAAa,UAAU,OAAO,OAAO,UAAU,OAAO,IAAI;EAC5E,KAAK,QACJ,OAAO,UAAU,KAAA,KAAa,UAAU,OAAO,OAAO,KAAK,UAAU,KAAK;EAC3E,KAAK;EACL,KAAK,QACJ,OAAO,OAAO,UAAU,YAAY,OAAO,UAAU,WAAW,QAAQ;EACzE,KAAK,QACJ,OAAO,OAAO,UAAU,WAAW,QAAQ;EAC5C,KAAK,QACJ,OAAO,iBAAiB,aAAa,QAAQ;CAC/C;AACD;;;;;;;;;;;;;;;;;;;;;;AAuBA,SAAgB,YAAY,OAAoB,MAA2B;CAC1E,QAAQ,MAAR;EACC,KAAK,WACJ,OAAO,UAAU,OAAO,KAAA,IAAY,UAAU;EAC/C,KAAK,QACJ,OAAO,OAAO,UAAU,WAAW,KAAK,MAAM,KAAK,IAAI,KAAA;EACxD,SACC,OAAO,UAAU,OAAO,KAAA,IAAY;CACtC;AACD;;;;;;;;;;;;;;;;;;AAmBA,SAAgB,UAAU,KAAU,QAAgC;CACnE,MAAM,SAAoB,CAAC;CAC3B,KAAK,MAAM,UAAU,OAAO,SAC3B,OAAO,OAAO,QAAQ,YAAY,IAAI,OAAO,OAAO,OAAO,IAAI;CAEhE,OAAO;AACR;;;;;;;;;;;;;;;;;;;;AAqBA,SAAgB,cACf,KACA,OACA,OACyB;CACzB,MAAM,SAAwB,CAAC;CAC/B,KAAK,MAAM,QAAQ,OAAO;EACzB,MAAM,QAAQ,IAAI;EAClB,IAAI,UAAU,KAAA,GACb,MAAM,IAAI,UAAA,cAAc,UAAU,2CAA2C;GAC5E;GACA,QAAQ;EACT,CAAC;EAEF,OAAO,KAAK,KAAK;CAClB;CACA,OAAO;AACR;;;;;;;;;;;;;;;;;;;;;AAsBA,SAAgB,UAAU,KAAgB,QAA0B;CACnE,MAAM,SAAc,CAAC;CACrB,KAAK,MAAM,UAAU,OAAO,SAAS;EACpC,MAAM,QAAQ,IAAI,OAAO;EACzB,IAAI,UAAU,KAAA,GAAW;EACzB,MAAM,UAAU,YAAY,OAAO,OAAO,IAAI;EAC9C,IAAI,YAAY,KAAA,GAAW,OAAO,OAAO,QAAQ;CAClD;CACA,OAAO;AACR;;;;;;;;;;;;;;;;;;;AAsBA,SAAgB,cAAc,QAA6B;CAC1D,MAAM,UAAU,OAAO,QAAQ,KAAK,WAAW,MAAM,OAAO,IAAI,IAAI,MAAM,UAAU,OAAO,IAAI,CAAC;CAChG,OACC,gCACA,MAAM,OAAO,IAAI,IACjB,OACA,QAAQ,KAAK,IAAI,IACjB,oBACA,MAAM,OAAO,OAAO,IACpB;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;AA0BA,SAAgB,UAAU,OAAe,SAAoC;CAE5E,OAAO,SADO,CAAC,OAAO,GAAG,OAAO,CAAC,CAAC,KAAK,SAAS,OAAO,KAAK,MAAM,IAAI,MAAM,IAC5D,CAAA,CAAM,KAAK,GAAG;AAC/B;;;;;;;;;;;;;;;;;;;AAoBA,SAAgB,gBAAgB,QAAwC;CACvE,OAAO,OAAO,QAAQ,KACpB,UACA,gCACA,MAAM,UAAU,OAAO,MAAM,KAAK,CAAC,IACnC,SACA,MAAM,OAAO,IAAI,IACjB,OACA,MAAM,IAAI,KAAK,CAAC,CAAC,KAAK,IAAI,IAC1B,GACF;AACD;;;;;;;;;;;;;;;;;;;;;;;;;;AA2BA,SAAgB,UAAU,MAAwC;CACjE,QAAQ,KAAK,WAAb;EACC,KAAK,aACJ,OAAO,CAAC,cAAc,KAAK,KAAK,GAAG,GAAG,gBAAgB,KAAK,KAAK,CAAC;EAClE,KAAK,gBACJ,OAAO,CAAC,0BAA0B,MAAM,KAAK,KAAK,CAAC;EACpD,KAAK,cACJ,OAAO,CACN,iBACC,MAAM,KAAK,KAAK,IAChB,iBACA,MAAM,KAAK,OAAO,IAAI,IACtB,MACA,UAAU,KAAK,OAAO,IAAI,CAC5B;EACD,KAAK,iBACJ,OAAO,CAAC,iBAAiB,MAAM,KAAK,KAAK,IAAI,kBAAkB,MAAM,KAAK,MAAM,CAAC;EAClF,KAAK,aACJ,OAAO,CACN,gCACC,MAAM,UAAU,KAAK,OAAO,KAAK,KAAK,CAAC,IACvC,SACA,MAAM,KAAK,KAAK,IAChB,OACA,KAAK,MAAM,IAAI,KAAK,CAAC,CAAC,KAAK,IAAI,IAC/B,GACF;EACD,KAAK,gBACJ,OAAO,CAAC,0BAA0B,MAAM,UAAU,KAAK,OAAO,KAAK,KAAK,CAAC,CAAC;CAC5E;AACD;;;;;;;;;;;;;;;;;;;;;;;;AAyBA,SAAgB,aAAa,QAAqB,MAAkC;CACnF,QAAQ,KAAK,WAAb;EACC,KAAK,cACJ,OAAO;GAAE,GAAG;GAAQ,SAAS,CAAC,GAAG,OAAO,SAAS,KAAK,MAAM;EAAE;EAC/D,KAAK,iBACJ,OAAO;GAAE,GAAG;GAAQ,SAAS,OAAO,QAAQ,QAAQ,WAAW,OAAO,SAAS,KAAK,MAAM;EAAE;EAC7F,KAAK,aACJ,OAAO;GAAE,GAAG;GAAQ,SAAS,CAAC,GAAG,OAAO,SAAS,KAAK,KAAK;EAAE;EAC9D,KAAK,gBACJ,OAAO;GACN,GAAG;GACH,SAAS,OAAO,QAAQ,QACtB,UACA,EACC,MAAM,WAAW,KAAK,MAAM,UAC5B,MAAM,OAAO,MAAM,aAAa,SAAS,KAAK,MAAM,SAAS,EAEhE;EACD;EACD,KAAK;EACL,KAAK,gBACJ,OAAO;CACT;AACD;;;;;;;;;;;;;;;;;;AC/pBA,SAAgB,eAAe,MAAiC;CAC/D,MAAM,CAAC,QAAQ,GAAG,UAAU;CAC5B,IAAI,WAAW,KAAA,GACd,MAAM,IAAI,UAAA,cAAc,cAAc,+CAA+C;CAEtF,MAAM,OAAO,OAAO,KAAK,QAAQ,MAAM,IAAI,WAAW,KAAK,IAAI,CAAC,CAAC,CAAC,KAAK,EAAE;CACzE,OAAO,eAAe,MAAM,MAAM,IAAI,SAAS,OAAO;AACvD;;;;;;;;;;;;;AAuBA,SAAgB,WAAW,MAAsB;CAChD,OAAO,KAAK,WAAW,MAAM,MAAM,CAAC,CAAC,WAAW,KAAK,KAAK,CAAC,CAAC,WAAW,KAAK,KAAK;AAClF;;;;;;;;;;;;;AAcA,SAAgB,aAAa,QAAgB,QAA6C;CACzF,OAAO,OAAO,QAAQ,MAAM,cAAc,UAAU,SAAS,MAAM,CAAC,EAAE;AACvE;;;;;;;;;;;;;;;;;;;;;;AAuBA,SAAgB,UAAU,OAA4B;CACrD,IAAI,OAAO,UAAU,WAAW,OAAO;CACvC,IAAI,OAAO,UAAU,UAAU,OAAO,OAAO,UAAU,KAAK,IAAI,YAAY;CAC5E,IAAI,OAAO,UAAU,UAAU,OAAO;CACtC,IAAI,OAAO,UAAU,YAAY,UAAU,MAAM,OAAO;CACxD,OAAO;AACR;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyEA,SAAgB,SAAS,WAAsB,QAAkC;CAChF,MAAM,SAAS,YAAY,UAAU,MAAM;CAC3C,MAAM,SAAS,EAAA,GAAA,oBAAA,SAAA,CAAU,UAAU,MAAM;CACzC,MAAM,YAAA,GAAA,oBAAA,SAAA,CAAoB,UAAU,MAAM,IAAI,aAAa,UAAU,QAAQ,MAAM,IAAI,KAAA;CACvF,MAAM,QAAQ,UAAU,OAAO;CAC/B,MAAM,SAAS,UAAU,OAAO;CAChC,MAAM,cAAc,UAAU,QAAQ,UAAU,KAAA;CAIhD,MAAM,WAAW,EAAA,GAAA,oBAAA,SAAA,CAAU,UAAU,MAAM,IAAI,eAAe,UAAU,MAAM,IAAI;CAClF,IAAI;CACJ,IAAI;CACJ,QAAQ,UAAU,UAAlB;EACC,KAAK;GACJ,IAAI,eAAe,QAAQ,OAAO;IAAE,KAAK,WAAW;IAAa,QAAQ,CAAC;GAAE;GAC5E,MAAM,SAAS;GACf,SAAS,CAAC,KAAK;GACf;EACD,KAAK;GACJ,IAAI,aAAa;IAChB,IAAI,QACH,OAAO;KACN,KAAK,MAAM,WAAW,iBAAiB,WAAW;KAClD,QAAQ,CAAC;IACV;IAKD,OAAO;KAAE,KAAK;KAAK,QAAQ,CAAC;IAAE;GAC/B;GACA,MAAM,MAAM,SAAS,cAAc,SAAS;GAC5C,SAAS,CAAC,KAAK;GACf;EACD,KAAK;GACJ,MAAM,SAAS;GACf,SAAS,CAAC,KAAK;GACf;EACD,KAAK;GACJ,MAAM,MAAM,SAAS,aAAa,SAAS;GAC3C,SAAS,CAAC,KAAK;GACf;EACD,KAAK;GACJ,MAAM,SAAS;GACf,SAAS,CAAC,KAAK;GACf;EACD,KAAK;GACJ,MAAM,MAAM,SAAS,cAAc,SAAS;GAC5C,SAAS,CAAC,KAAK;GACf;EACD,KAAK;GACJ,MAAM,SAAS;GACf,SAAS,CAAC,OAAO,MAAM;GACvB;EACD,KAAK;GACJ,MAAM,SAAS;GACf,SAAS,CAAC,KAAK;GACf;EACD,KAAK;GACJ,MAAM,SAAS;GACf,SAAS,CAAC,KAAK;GACf;EACD,KAAK,UAAU;GAOd,MAAM,QAAA,GAAA,oBAAA,SAAA,CAAgB,KAAK,IAAI,QAAQ;GACvC,IAAI,SAAS,IAAI,OAAO;IAAE,KAAK,YAAY,SAAS;IAAc,QAAQ,CAAC;GAAE;GAC7E,MAAM,SAAS,MAAM,KAAK,IAAI,CAAC,CAAC;GAChC,MAAM,aAAa,SAAS,2BAA2B,SAAS,UAAU,SAAS;GACnF,SAAS,CAAC,KAAK;GACf;EACD;EACA,KAAK,QAAQ;GAGZ,MAAM,QAAA,GAAA,oBAAA,SAAA,CAAgB,KAAK,IAAI,QAAQ;GACvC,IAAI,SAAS,IAAI,OAAO;IAAE,KAAK,YAAY,SAAS;IAAc,QAAQ,CAAC;GAAE;GAC7E,MAAM,SAAS,MAAM,KAAK,IAAI,CAAC,CAAC;GAChC,MAAM,aAAa,SAAS,2BAA2B,SAAS,QAAQ,SAAS;GACjF,SAAS,CAAC,KAAK;GACf;EACD;EACA,KAAK;GACJ,IAAI,UAAU,OAAO,WAAW,GAAG,OAAO;IAAE,KAAK;IAAK,QAAQ,CAAC;GAAE;GACjE,MAAM,SAAS,UAAU,UAAU,OAAO,UAAU,GAAG,CAAC,CAAC,KAAK,IAAI,IAAI;GACtE,SAAS,UAAU;GACnB;EACD,KAAK;GACJ,IAAI,UAAU,OAAO,WAAW,GAAG,OAAO;IAAE,KAAK;IAAK,QAAQ,CAAC;GAAE;GACjE,MACC,MACA,SACA,cACA,UAAU,OAAO,UAAU,GAAG,CAAC,CAAC,KAAK,IAAI,IACzC,UACA,SACA;GACD,SAAS,UAAU;GACnB;EACD,KAAK,UACJ,OAAO;GAAE,KAAK,SAAS;GAAY,QAAQ,CAAC;EAAE;EAC/C,KAAK,WACJ,OAAO;GAAE,KAAK,SAAS;GAAgB,QAAQ,CAAC;EAAE;CACpD;CACA,OAAO;EACN;EACA,QAAQ,OAAO,KAAK,UACnB,YAAY,OAAO,SAAS,UAAU,KAAK,IAAK,YAAY,MAAO,CACpE;CACD;AACD;;;;;;;;;;;;;;;;;;;;;;AAuBA,SAAgB,aAAa,YAAkC,QAAkC;CAChG,MAAM,CAAC,OAAO,GAAG,aAAa;CAC9B,IAAI,UAAU,KAAA,GAAW,OAAO;EAAE,KAAK;EAAI,QAAQ,CAAC;CAAE;CACtD,MAAM,OAAO,SAAS,OAAO,MAAM;CACnC,IAAI,SAAS,KAAK;CAClB,MAAM,SAAwB,CAAC,GAAG,KAAK,MAAM;CAC7C,KAAK,MAAM,aAAa,WAAW;EAClC,MAAM,OAAO,SAAS,WAAW,MAAM;EACvC,MAAM,WAAW,UAAU,cAAc,OAAO,OAAO;EACvD,SAAS,MAAM,SAAS,MAAM,WAAW,MAAM,KAAK,MAAM;EAC1D,OAAO,KAAK,GAAG,KAAK,MAAM;CAC3B;CACA,OAAO;EAAE,KAAK,WAAW;EAAQ;CAAO;AACzC;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4BA,SAAgB,aAAa,OAAqC,QAA6B;CAC9F,MAAM,SAAS,SAAS,CAAC,EAAA,CAAG,KAC1B,SAAS,YAAY,KAAK,MAAM,KAAK,KAAK,cAAc,eAAe,UAAU,OACnF;CAIA,IAAI,EAHqB,SAAS,CAAC,EAAA,CAAG,MACpC,UAAA,GAAA,oBAAA,SAAA,CAAkB,KAAK,MAAM,KAAK,KAAK,WAAW,OAAO,OAEtD,GAAiB,MAAM,KAAK,MAAM,OAAO,OAAO,CAAC;CACtD,OAAO,MAAM,WAAW,IAAI,KAAK,cAAc,MAAM,KAAK,IAAI;AAC/D;;;;;;;;;;;;;;;;;AAkBA,SAAgB,YAAY,OAA2B,QAAyC;CAC/F,IAAI,UAAU,KAAA,KAAa,WAAW,KAAA,GACrC,OAAO;EAAE,KAAK;EAAoB,QAAQ,CAAC,OAAO,MAAM;CAAE;CAE3D,IAAI,UAAU,KAAA,GAAW,OAAO;EAAE,KAAK;EAAW,QAAQ,CAAC,KAAK;CAAE;CAClE,IAAI,WAAW,KAAA,GAAW,OAAO;EAAE,KAAK;EAAqB,QAAQ,CAAC,MAAM;CAAE;CAC9E,OAAO;EAAE,KAAK;EAAI,QAAQ,CAAC;CAAE;AAC9B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+BA,SAAgB,gBAAgB,UAAgC,QAAkC;CACjG,MAAM,QAAQ,aAAa,UAAU,cAAc,CAAC,GAAG,MAAM;CAC7D,MAAM,UAAU,aAAa,UAAU,OAAO,MAAM;CACpD,MAAM,OAAO,YAAY,UAAU,OAAO,UAAU,MAAM;CAE1D,OAAO;EAAE,KADG;GAAC,MAAM;GAAK;GAAS,KAAK;EAAG,CAAC,CAAC,QAAQ,SAAS,SAAS,EAAE,CAAC,CAAC,KAAK,GACrE;EAAK,QAAQ,CAAC,GAAG,MAAM,QAAQ,GAAG,KAAK,MAAM;CAAE;AACzD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;ACxXA,IAAa,aAAb,MAAmD;CAClD;CACA,UAAmB,IAAI,UAAA,aAAa;CACpC,UAAkC,CAAC;CACnC;CACA,cAAc;CAId,SAAwB,QAAQ,QAAQ;CAKxC,aAAa;CACb;CAEA,YAAY,MAAc;EACzB,KAAKA,QAAQ;CACd;CAEA,MAAM,KAAK,QAA+C;EACzD,KAAKE,UAAU;EACf,MAAM,KAAKD,QAAQ,KAAK,MAAM;EAC9B,MAAM,KAAKE,MAAM;CAClB;CAEA,MAAM,QAAuB;EAC5B,MAAM,KAAKF,QAAQ,MAAM;CAC1B;CAEA,MAAM,KAAK,OAAe,KAAoC;EAC7D,OAAO,KAAKA,QAAQ,KAAK,OAAO,GAAG;CACpC;CAEA,MAAM,MAAM,OAAe,KAAU,KAAyB;EAC7D,MAAM,KAAKA,QAAQ,MAAM,OAAO,KAAK,GAAG;EACxC,IAAI,CAAC,KAAKG,YAAY,MAAM,KAAKC,OAAO;CACzC;CAEA,MAAM,OAAO,OAAe,KAA4B;EACvD,MAAM,UAAU,MAAM,KAAKJ,QAAQ,OAAO,OAAO,GAAG;EACpD,IAAI,CAAC,KAAKG,YAAY,MAAM,KAAKC,OAAO;EACxC,OAAO;CACR;CAEA,KAAK,OAAwC;EAC5C,OAAO,KAAKJ,QAAQ,KAAK,KAAK;CAC/B;CAEA,KAAK,OAAmC;EACvC,OAAO,KAAKA,QAAQ,KAAK,KAAK;CAC/B;;;;;;;;;;;;CAaA,OAAO,OAAe,UAAwC;EAC7D,OAAO,KAAKA,QAAQ,OAAO,OAAO,QAAQ;CAC3C;CAEA,MAAM,MAAM,OAA8B;EACzC,MAAM,KAAKA,QAAQ,MAAM,KAAK;EAC9B,IAAI,CAAC,KAAKG,YAAY,MAAM,KAAKC,OAAO;CACzC;;;;;;;;;;;;;;;;;;;CAoBA,MAAM,cAA6C;EAClD,IAAI,KAAKD,YACR,MAAM,IAAI,UAAA,cAAc,YAAY,kDAAkD,CAAC,CAAC;EAEzF,MAAM,WAAW,MAAM,KAAKH,QAAQ,SAAS;EAC7C,MAAM,QAAQ,CAAC;EACf,KAAKG,aAAa;EAClB,KAAKE,eAAe;EACpB,OAAO;GACN,QAAQ,KAAKC,QAAQ,KAAK,MAAM,KAAK;GACrC,UAAU,KAAKC,UAAU,KAAK,MAAM,OAAO,QAAQ;EACpD;CACD;CAEA,MAAM,SAAS,QAA0D;EACxE,MAAM,WAAW,MAAM,KAAKP,QAAQ,SAAS,MAAM;EAGnD,OAAO,YAAY;GAClB,MAAM,SAAS;GACf,MAAM,KAAKI,OAAO;EACnB;CACD;CAEA,MAAM,OAAwC;EAC7C,OAAO,KAAKI;CACb;;;;;;;;;;;CAYA,MAAM,MAAM,MAAiC;EAC5C,KAAKA,QAAQ;EACb,IAAI,CAAC,KAAKL,YAAY,MAAM,KAAKC,OAAO;CACzC;;;;;;;;;;;;;;;;;;;CAoBA,MAAM,QAAQ,MAAgC;EAC7C,MAAM,KAAKJ,QAAQ,UAAU,IAAI;EACjC,IAAI,SAAS,KAAKC;EAClB,KAAK,MAAM,QAAQ,KAAK,OACvB,IAAI,KAAK,cAAc,aACtB,SAAS,OAAO,MAAM,UAAU,MAAM,SAAS,KAAK,MAAM,IAAI,IAC3D,SACA,CAAC,GAAG,QAAQ,KAAK,KAAK;OACnB,IAAI,KAAK,cAAc,gBAC7B,SAAS,OAAO,QAAQ,UAAU,MAAM,SAAS,KAAK,KAAK;EAG7D,KAAKA,UAAU;EACf,MAAM,KAAKG,OAAO;CACnB;CAIA,MAAME,QAAQ,OAA8B;EAC3C,IAAI,KAAKD,iBAAiB,OACzB,MAAM,IAAI,UAAA,cAAc,YAAY,+BAA+B,CAAC,CAAC;EAEtE,KAAKA,eAAe,KAAA;EACpB,KAAKF,aAAa;EAClB,MAAM,KAAKC,OAAO;CACnB;CAEA,MAAMG,UAAU,OAAe,UAA8C;EAC5E,IAAI,KAAKF,iBAAiB,OACzB,MAAM,IAAI,UAAA,cAAc,YAAY,+BAA+B,CAAC,CAAC;EAEtE,KAAKA,eAAe,KAAA;EACpB,MAAM,SAAS;EACf,KAAKF,aAAa;EAClB,MAAM,KAAKC,OAAO;CACnB;CAQA,MAAMF,QAAuB;EAC5B,IAAI;EACJ,IAAI;GACH,MAAM,OAAA,GAAA,iBAAA,SAAA,CAAe,KAAKH,OAAO,OAAO;EACzC,QAAQ;GACP;EACD;EACA,IAAI;EACJ,IAAI;GACH,SAAS,KAAK,MAAM,GAAG;EACxB,QAAQ;GACP;EACD;EACA,IAAI,EAAA,GAAA,oBAAA,SAAA,CAAU,MAAM,KAAK,EAAA,GAAA,oBAAA,SAAA,CAAU,OAAO,MAAM,GAAG;EACnD,MAAM,SAAS,OAAO;EACtB,KAAK,MAAM,SAAS,KAAKE,SAAS;GACjC,MAAM,OAAO,OAAO,MAAM;GAC1B,IAAI,CAAC,MAAM,QAAQ,IAAI,GAAG;GAC1B,KAAK,MAAM,SAAS,MAAM;IACzB,IAAI,EAAA,GAAA,oBAAA,SAAA,CAAU,KAAK,GAAG;IACtB,MAAM,OAAA,GAAA,UAAA,WAAA,CAAiB,OAAO,MAAM,OAAO;IAC3C,IAAI,QAAQ,KAAA,GAAW;IACvB,MAAM,KAAKD,QAAQ,MAAM,MAAM,MAAM,KAAK,KAAK;GAChD;EACD;EACA,KAAA,GAAA,UAAA,aAAA,CAAiB,OAAO,IAAI,GAAG,KAAKQ,QAAQ,OAAO;CACpD;CAGA,MAAMJ,SAAwB;EAC7B,MAAM,OAAO,KAAKK,OAAO,WAAW,KAAKC,WAAW,CAAC;EAIrD,KAAKD,SAAS,KAAK,YAAY,CAAC,CAAC;EACjC,MAAM;CACP;CAoBA,MAAMC,aAA4B;EACjC,MAAM,SAAyC,CAAC;EAChD,KAAK,MAAM,SAAS,KAAKT,SAAS;GACjC,MAAM,OAAc,CAAC;GACrB,WAAW,MAAM,OAAO,KAAKD,QAAQ,KAAK,MAAM,IAAI,GAAG,KAAK,KAAK,GAAG;GACpE,OAAO,MAAM,QAAQ;EACtB;EACA,KAAKW,eAAe;EACpB,MAAM,OAAO,GAAG,KAAKZ,MAAM,GAAG,QAAQ,IAAI,GAAG,KAAKY,YAAY;EAC9D,MAAM,UAAU,KAAKH,UAAU,KAAA,IAAY,EAAE,OAAO,IAAI;GAAE,MAAM,KAAKA;GAAO;EAAO;EACnF,IAAI;GACH,OAAA,GAAA,iBAAA,MAAA,EAAA,GAAA,UAAA,QAAA,CAAoB,KAAKT,KAAK,GAAG,EAAE,WAAW,KAAK,CAAC;GACpD,OAAA,GAAA,iBAAA,UAAA,CAAgB,MAAM,KAAK,UAAU,SAAS,MAAM,CAAC,GAAG,OAAO;GAC/D,OAAA,GAAA,iBAAA,OAAA,CAAa,MAAM,KAAKA,KAAK;EAC9B,SAAS,OAAO;GACf,OAAA,GAAA,iBAAA,GAAA,CAAS,MAAM,EAAE,OAAO,KAAK,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC;GAC9C,MAAM,IAAI,UAAA,cAAc,UAAU,uCAAuC;IACxE,MAAM,KAAKA;IACX,OAAO;GACR,CAAC;EACF;CACD;AACD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;ACvOA,IAAa,eAAb,MAAqD;CACpD;CACA;CACA;CACA,0BAAU,IAAI,IAAyB;CACvC;CAEA,YAAY,MAAc,SAA+B;EACxD,KAAKa,QAAQ;EACb,KAAKC,WAAW,WAAW,CAAC;CAC7B;CAEA,MAAM,KAAK,QAA+C;EACzD,IAAI,OAAO,MAAM,UAAU,MAAM,SAAA,OAAmB,GACnD,MAAM,IAAI,UAAA,cACT,cACA,qCAAqC,WAAW,yCAChD,EAAE,OAAO,WAAW,CACrB;EAED,KAAKC,aAAa;GACjB,KAAKC,WAAW,MAAM;GACtB,MAAM,YAAA,GAAA,kBAAA,qBAAA,CAAgC;IACrC,MAAM,KAAKH;IACX,GAAI,KAAKC,SAAS,aAAa,KAAA,IAAY,EAAE,UAAU,KAAKA,SAAS,SAAS,IAAI,CAAC;IACnF,GAAI,KAAKA,SAAS,YAAY,KAAA,IAAY,EAAE,SAAS,KAAKA,SAAS,QAAQ,IAAI,CAAC;IAChF,GAAI,KAAKA,SAAS,gBAAgB,KAAA,IAC/B,EAAE,aAAa,KAAKA,SAAS,YAAY,IACzC,CAAC;GACL,CAAC;GACD,SAAS,QAAQ;GACjB,KAAK,MAAM,CAAC,MAAM,UAAU,OAAO,QAAQ,KAAKA,SAAS,WAAW,CAAC,CAAC,GACrE,SAAS,OAAO,MAAM,KAAK;GAE5B,MAAM,sBAAM,IAAI,IAAyB;GACzC,KAAK,MAAM,SAAS,QAAQ;IAC3B,IAAI,IAAI,MAAM,MAAM,KAAK;IACzB,SAAS,KAAK,cAAc,KAAK,CAAC;IAClC,KAAK,MAAM,OAAO,gBAAgB,KAAK,GAAG,SAAS,KAAK,GAAG;GAC5D;GACA,SAAS,KACR,gCACC,MAAM,UAAU,IAChB,+EACF;GACA,KAAKG,UAAU;GACf,KAAKD,YAAY;EAClB,CAAC;CACF;CAEA,MAAM,QAAuB;EAC5B,KAAKA,WAAW,MAAM;EACtB,KAAKA,YAAY,KAAA;CAClB;CAEA,MAAM,KAAK,OAAe,KAAoC;EAC7D,MAAM,SAAS,KAAKE,OAAO,KAAK;EAChC,OAAO,KAAKH,aAAa;GACxB,MAAM,MAAM,KAAKI,SAAS,CAAC,CACzB,QAAQ,mBAAmB,MAAM,KAAK,IAAI,YAAY,MAAM,OAAO,OAAO,IAAI,MAAM,CAAC,CACrF,IAAI,CAAC,KAAKC,KAAK,KAAK,MAAM,CAAC,CAAC;GAC9B,OAAO,QAAQ,KAAA,IAAY,KAAA,IAAY,UAAU,KAAK,MAAM;EAC7D,CAAC;CACF;CAEA,MAAM,MAAM,OAAe,KAAU,KAAyB;EAC7D,MAAM,SAAS,KAAKF,OAAO,KAAK;EAChC,KAAKH,aAAa;GACjB,MAAM,UAAU,UAAU;IAAE,GAAG;KAAM,OAAO,UAAU;GAAI,GAAG,MAAM;GACnE,MAAM,QAAQ,OAAO,QAAQ,KAAK,WAAW,OAAO,IAAI;GACxD,MAAM,SAAS,cAAc,SAAS,OAAO,KAAK;GAClD,KAAKI,SAAS,CAAC,CACb,QACA,4BACC,MAAM,KAAK,IACX,OACA,MAAM,IAAI,KAAK,CAAC,CAAC,KAAK,IAAI,IAC1B,eACA,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,IAAI,IAC9B,GACF,CAAC,CACA,IAAI,MAAM;EACb,CAAC;CACF;CAEA,MAAM,OAAO,OAAe,KAA4B;EACvD,MAAM,SAAS,KAAKD,OAAO,KAAK;EAChC,OAAO,KAAKH,aAAa;GAIxB,OAHe,KAAKI,SAAS,CAAC,CAC5B,QAAQ,iBAAiB,MAAM,KAAK,IAAI,YAAY,MAAM,OAAO,OAAO,IAAI,MAAM,CAAC,CACnF,IAAI,CAAC,KAAKC,KAAK,KAAK,MAAM,CAAC,CACtB,CAAA,CAAO,UAAU;EACzB,CAAC;CACF;CAEA,MAAM,KAAK,OAAwC;EAClD,MAAM,SAAS,KAAKF,OAAO,KAAK;EAChC,OAAO,KAAKH,aAAa;GACxB,MAAM,UAAU,MAAM,OAAO,OAAO;GAGpC,MAAM,OAAO,KAAKI,SAAS,CAAC,CAC1B,QAAQ,YAAY,UAAU,WAAW,MAAM,KAAK,IAAI,eAAe,OAAO,CAAC,CAC/E,IAAI;GACN,MAAM,OAAc,CAAC;GACrB,KAAK,MAAM,OAAO,MAAM;IACvB,MAAM,QAAQ,IAAI,OAAO;IACzB,IAAI,OAAO,UAAU,YAAY,OAAO,UAAU,UAAU,KAAK,KAAK,KAAK;GAC5E;GACA,OAAO;EACR,CAAC;CACF;CAEA,OAAO,KAAK,OAAmC;EAC9C,MAAM,SAAS,KAAKD,OAAO,KAAK;EAMhC,MAAM,WAAW,KAAKH,aACrB,KAAKI,SAAS,CAAC,CACb,QAAQ,mBAAmB,MAAM,KAAK,IAAI,eAAe,MAAM,OAAO,OAAO,CAAC,CAAC,CAC/E,QAAQ,CACX,CAAC,CAAC,OAAO,SAAS,CAAC;EACnB,OAAO,MAAM;GACZ,MAAM,OAAO,KAAKJ,aAAa,SAAS,KAAK,CAAC;GAC9C,IAAI,KAAK,SAAS,MAAM;GACxB,MAAM,KAAKA,aAAa,UAAU,KAAK,OAAO,MAAM,CAAC;EACtD;CACD;CAEA,MAAM,MAAM,OAA8B;EACzC,KAAKG,OAAO,KAAK;EACjB,KAAKH,aAAa;GACjB,KAAKI,SAAS,CAAC,CACb,QAAQ,iBAAiB,MAAM,KAAK,CAAC,CAAC,CACtC,IAAI;EACP,CAAC;CACF;CAYA,MAAM,QAAQ,OAAe,UAA6C;EACzE,MAAM,SAAS,KAAKD,OAAO,KAAK;EAChC,IAAI,gBAAgB,UAAU,MAAM,GACnC,OAAO,KAAKH,aAAa;GACxB,MAAM,EAAE,KAAK,WAAW,gBAAgB,UAAU,MAAM;GAIxD,OAHa,KAAKI,SAAS,CAAC,CAC1B,QAAQ,mBAAmB,MAAM,KAAK,KAAK,QAAQ,KAAK,KAAK,MAAM,IAAI,CAAC,CACxE,IAAI,MACC,CAAA,CAAK,KAAK,QAAQ,UAAU,KAAK,MAAM,CAAC;EAChD,CAAC;EAEF,MAAM,OAAc,CAAC;EACrB,WAAW,MAAM,OAAO,KAAK,KAAK,KAAK,GAAG,KAAK,KAAK,GAAG;EACvD,QAAA,GAAA,UAAA,cAAA,CAAqB,MAAM,QAAQ;CACpC;CAEA,MAAM,MAAM,OAAe,UAAqC;EAC/D,MAAM,SAAS,KAAKD,OAAO,KAAK;EAChC,MAAM,aAAa,SAAS,cAAc,CAAC;EAC3C,IAAI,WAAW,OAAO,cAAc,iBAAiB,WAAW,MAAM,CAAC,GACtE,OAAO,KAAKH,aAAa;GAKxB,MAAM,EAAE,KAAK,WAAW,aAAa,YAAY,MAAM;GAIvD,MAAM,QAHM,KAAKI,SAAS,CAAC,CACzB,QAAQ,mCAAmC,MAAM,KAAK,KAAK,QAAQ,KAAK,KAAK,MAAM,IAAI,CAAC,CACxF,IAAI,MACQ,CAAA,EAAK;GACnB,OAAO,OAAO,UAAU,YAAY,OAAO,UAAU,WAAW,OAAO,KAAK,IAAI;EACjF,CAAC;EAEF,MAAM,OAAc,CAAC;EACrB,WAAW,MAAM,OAAO,KAAK,KAAK,KAAK,GAAG,KAAK,KAAK,GAAG;EACvD,QAAA,GAAA,UAAA,WAAA,CAAkB,MAAM,UAAU,CAAC,CAAC;CACrC;CAEA,MAAM,UACL,OACA,WACA,QACA,UAC8B;EAC9B,MAAM,SAAS,KAAKD,OAAO,KAAK;EAChC,MAAM,aAAa,SAAS,cAAc,CAAC;EAC3C,MAAM,kBAAkB,WAAW,OAAO,cAAc,iBAAiB,WAAW,MAAM,CAAC;EAM3F,MAAM,cACL,cAAc,YAAA,GAAA,oBAAA,SAAA,CACJ,MAAM,KACf,OAAO,QAAQ,MACb,cACA,UAAU,SAAS,WAClB,UAAU,SAAS,aAAa,UAAU,SAAS,OACtD;EACF,IAAI,mBAAmB,aACtB,OAAO,KAAKH,aAAa;GAGxB,MAAM,EAAE,KAAK,WAAW,aAAa,YAAY,MAAM;GACvD,MAAM,QAAQ,KAAKI,SAAS,CAAC,CAC3B,QACA,YACC,aAAa,WAAW,MAAM,IAC9B,oBACA,MAAM,KAAK,KACV,QAAQ,KAAK,KAAK,MAAM,IAC3B,CAAC,CACA,IAAI,MAAM,CAAC,EAAE;GAIf,OAAO,UAAU,QAAQ,UAAU,KAAA,IAAY,KAAA,IAAY,OAAO,KAAK;EACxE,CAAC;EAEF,MAAM,OAAc,CAAC;EACrB,WAAW,MAAM,OAAO,KAAK,KAAK,KAAK,GAAG,KAAK,KAAK,GAAG;EACvD,QAAA,GAAA,UAAA,iBAAA,EAAA,GAAA,UAAA,WAAA,CAAmC,MAAM,UAAU,GAAG,WAAW,MAAM;CACxE;CAKA,OAAO,OAAO,OAAe,UAAwC;EACpE,MAAM,SAAS,KAAKD,OAAO,KAAK;EAChC,MAAM,aAAa,SAAS,cAAc,CAAC;EAC3C,IAAI,WAAW,OAAO,cAAc,iBAAiB,WAAW,MAAM,CAAC,GAAG;GACzE,MAAM,WAAW,gBAChB;IACC;IACA,GAAI,SAAS,UAAU,KAAA,IAAY,EAAE,OAAO,SAAS,MAAM,IAAI,CAAC;IAChE,GAAI,SAAS,WAAW,KAAA,IAAY,EAAE,QAAQ,SAAS,OAAO,IAAI,CAAC;GACpE,GACA,MACD;GACA,KAAK,MAAM,OAAO,KAAKC,SAAS,CAAC,CAC/B,QAAQ,mBAAmB,MAAM,KAAK,KAAK,SAAS,QAAQ,KAAK,KAAK,MAAM,SAAS,IAAI,CAAC,CAC1F,QAAQ,SAAS,MAAM,GACxB,MAAM,UAAU,KAAK,MAAM;GAE5B;EACD;EACA,MAAM,SAAS,SAAS,UAAU;EAClC,MAAM,QAAQ,SAAS;EACvB,IAAI,UAAU;EACd,IAAI,UAAU;EACd,WAAW,MAAM,OAAO,KAAK,KAAK,KAAK,GAAG;GACzC,IAAI,UAAU,KAAA,KAAa,WAAW,OAAO;GAC7C,IAAI,WAAW,SAAS,KAAK,EAAA,GAAA,UAAA,gBAAA,CAAiB,KAAK,UAAU,GAAG;GAChE,IAAI,UAAU,QAAQ;IACrB,WAAW;IACX;GACD;GACA,MAAM;GACN,WAAW;EACZ;CACD;;;;;;;;;;CAWA,MAAM,cAA6C;EAClD,MAAM,WAAW,KAAKA,SAAS;EAC/B,KAAKJ,aAAa,SAAS,KAAK,OAAO,CAAC;EACxC,MAAM,QAAQ,CAAC;EACf,KAAKM,eAAe;EACpB,OAAO;GACN,QAAQ,KAAKC,QAAQ,KAAK,MAAM,OAAO,QAAQ;GAC/C,UAAU,KAAKC,UAAU,KAAK,MAAM,OAAO,QAAQ;EACpD;CACD;;;;;;;;;;;;;;;;;;;;;;;;CAyBA,MAAM,QAAQ,MAAgC;EAC7C,MAAM,WAAW,KAAKJ,SAAS;EAC/B,MAAM,SAAS,IAAI,IAAI,KAAKF,OAAO;EACnC,KAAKF,aAAa;GACjB,IAAI,KAAKM,iBAAiB,KAAA,GACzB,KAAKG,WAAW,UAAU,MAAM,MAAM;QAEtC,SAAS,kBAAkB,KAAKA,WAAW,UAAU,MAAM,MAAM,CAAC;EAEpE,CAAC;EACD,KAAKP,UAAU;CAChB;;;;;;;CAQA,MAAM,OAAwC;EAC7C,MAAM,MAAM,KAAKF,aAChB,KAAKI,SAAS,CAAC,CACb,QAAQ,yCAAqC,MAAM,UAAU,IAAI,mBAAiB,CAAC,CACnF,IAAI,CACP;EACA,IAAI,QAAQ,KAAA,GAAW,OAAO,KAAA;EAC9B,MAAM,UAAU,IAAI;EACpB,MAAM,OAAO,IAAI;EACjB,IAAI,OAAO,SAAS,UAAU,OAAO,KAAA;EACrC,IAAI,OAAO,YAAY,YAAY,OAAO,YAAY,UAAU,OAAO,KAAA;EACvE,IAAI;EACJ,IAAI;GACH,SAAS,KAAK,MAAM,IAAI;EACzB,QAAQ;GACP;EACD;EACA,MAAM,YAAY;GAAE,SAAS,OAAO,OAAO;GAAG,QAAQ;EAAO;EAC7D,IAAI,EAAA,GAAA,UAAA,aAAA,CAAc,SAAS,GAAG,OAAO,KAAA;EACrC,OAAO;CACR;;;;;;;CAQA,MAAM,MAAM,MAAiC;EAC5C,KAAKJ,aAAa;GACjB,KAAKI,SAAS,CAAC,CACb,QACA,4BACC,MAAM,UAAU,IAChB,qDACF,CAAC,CACA,IAAI,CAAC,KAAK,SAAS,KAAK,UAAU,KAAK,MAAM,CAAC,CAAC;EAClD,CAAC;CACF;CAEA,MAAM,SAAS,QAA0D;EACxE,MAAM,WAAW,KAAKA,SAAS;EAM/B,MAAM,QAAQ,UAAU,CAAC,GAAG,KAAKF,QAAQ,KAAK,CAAC;EAC/C,MAAM,2BAAW,IAAI,IAGnB;EACF,KAAK,MAAM,QAAQ,OAAO;GACzB,MAAM,SAAS,KAAKA,QAAQ,IAAI,IAAI;GACpC,IAAI,WAAW,KAAA,GAAW;GAC1B,SAAS,IAAI,MAAM;IAClB,OAAO,OAAO,QAAQ,KAAK,WAAW,OAAO,IAAI;IACjD,MAAM,SAAS,QAAQ,mBAAmB,MAAM,IAAI,CAAC,CAAC,CAAC,IAAI;GAC5D,CAAC;EACF;EACA,OAAO,YAAY;GAClB,MAAM,UAAU,KAAKE,SAAS;GAC9B,QAAQ,kBAAkB;IACzB,KAAK,MAAM,CAAC,MAAM,aAAa,UAAU;KACxC,QAAQ,KAAK,iBAAiB,MAAM,IAAI,CAAC;KACzC,MAAM,YAAY,QAAQ,QACzB,4BACC,MAAM,IAAI,IACV,OACA,SAAS,MAAM,IAAI,KAAK,CAAC,CAAC,KAAK,IAAI,IACnC,eACA,SAAS,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,IAAI,IACvC,GACF;KACA,KAAK,MAAM,OAAO,SAAS,MAC1B,UAAU,IAAI,cAAc,KAAK,SAAS,OAAO,IAAI,CAAC;IAExD;GACD,CAAC;EACF;CACD;CAIA,MAAMG,QAAQ,OAAe,UAAkD;EAC9E,IAAI,KAAKD,iBAAiB,OACzB,MAAM,IAAI,UAAA,cAAc,YAAY,+BAA+B,CAAC,CAAC;EAEtE,KAAKA,eAAe,KAAA;EACpB,KAAKN,aAAa,SAAS,KAAK,QAAQ,CAAC;CAC1C;CAEA,MAAMQ,UAAU,OAAe,UAAkD;EAChF,IAAI,KAAKF,iBAAiB,OACzB,MAAM,IAAI,UAAA,cAAc,YAAY,+BAA+B,CAAC,CAAC;EAEtE,KAAKA,eAAe,KAAA;EACpB,KAAKN,aAAa,SAAS,KAAK,UAAU,CAAC;CAC5C;CAaA,OAAU,KAAiB;EAC1B,IAAI;GACH,OAAO,IAAI;EACZ,SAAS,OAAO;GACf,IAAI,iBAAiB,UAAA,eAAe,MAAM;GAC1C,KAAA,GAAA,kBAAA,cAAA,CAAkB,KAAK,GAAG;IACzB,IAAI,MAAM,SAAS,cAClB,MAAM,IAAI,UAAA,cAAc,YAAY,MAAM,SAAS;KAAE,OAAO;KAAO,MAAM,MAAM;IAAK,CAAC;IAEtF,IAAI,MAAM,SAAS,UAClB,MAAM,IAAI,UAAA,cAAc,UAAU,MAAM,SAAS;KAAE,OAAO;KAAO,MAAM,MAAM;IAAK,CAAC;IAEpF,IAAI,MAAM,SAAS,QAClB,MAAM,IAAI,UAAA,cAAc,UAAU,MAAM,SAAS;KAChD,OAAO;KACP,MAAM,MAAM;KACZ,WAAW;IACZ,CAAC;IAEF,MAAM,IAAI,UAAA,cAAc,UAAU,MAAM,SAAS;KAAE,OAAO;KAAO,MAAM,MAAM;IAAK,CAAC;GACpF;GACA,MAAM,IAAI,UAAA,cAAc,UAAU,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,GAAG,EACzF,OAAO,MACR,CAAC;EACF;CACD;CAEA,WAAoC;EACnC,IAAI,KAAKC,cAAc,KAAA,GACtB,MAAM,IAAI,UAAA,cAAc,UAAU,oBAAoB,KAAKH,MAAM,gBAAgB,EAChF,MAAM,KAAKA,MACZ,CAAC;EAEF,OAAO,KAAKG;CACb;CAGA,OAAO,MAA2B;EACjC,KAAKG,SAAS;EACd,MAAM,SAAS,KAAKF,QAAQ,IAAI,IAAI;EACpC,IAAI,WAAW,KAAA,GACd,MAAM,IAAI,UAAA,cAAc,aAAa,UAAU,KAAK,yBAAyB,EAAE,OAAO,KAAK,CAAC;EAE7F,OAAO;CACR;CAGA,KAAK,KAAU,QAAkC;EAChD,MAAM,UAAU,OAAO,QAAQ,MAAM,WAAW,OAAO,SAAS,OAAO,OAAO;EAC9E,OAAO,YAAY,KAAK,YAAY,KAAA,IAAY,SAAS,QAAQ,IAAI;CACtE;CAKA,WACC,UACA,MACA,QACO;EACP,KAAK,MAAM,QAAQ,KAAK,OAAO;GAC9B,MAAM,QAAQ,KAAK,cAAc,cAAc,KAAK,MAAM,OAAO,KAAK;GACtE,IAAI,KAAK,cAAc,eAAe,CAAC,OAAO,IAAI,KAAK,GACtD,MAAM,IAAI,UAAA,cAAc,aAAa,2BAA2B,MAAM,IAAI,EAAE,MAAM,CAAC;GAEpF,KAAK,MAAM,OAAO,UAAU,IAAI,GAAG,SAAS,KAAK,GAAG;GACpD,IAAI,KAAK,cAAc,aACtB,OAAO,IAAI,KAAK,MAAM,MAAM,KAAK,KAAK;QAChC,IAAI,KAAK,cAAc,gBAC7B,OAAO,OAAO,KAAK,KAAK;QAClB;IACN,MAAM,WAAW,OAAO,IAAI,KAAK;IACjC,IAAI,aAAa,KAAA,GAAW,OAAO,IAAI,OAAO,aAAa,UAAU,IAAI,CAAC;GAC3E;EACD;CACD;AACD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AChkBA,SAAgB,iBAAiB,MAA+B;CAC/D,OAAO,IAAI,WAAW,IAAI;AAC3B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAqCA,SAAgB,mBACf,UAAwC,YACtB;CAClB,MAAM,YAAA,GAAA,oBAAA,SAAA,CAAyC,OAAO,IAAI,EAAE,MAAM,QAAQ,IAAI;CAC9E,OAAO,IAAI,aAAa,SAAS,QAAQ,YAAY,QAAQ;AAC9D"}