@venizia/ignis-connectors 0.2.0-0

package/dist/esm/relational/sqlite/repositories/dialect/filter.d.ts

@@ -0,0 +1,43 @@
+import type { Sorts, TQueryOperatorHandlers } from '@venizia/ignis-kernel';
+import type { TTableColumns } from '../../../../relational/core/repositories/common/index.js';
+import { FilterBuilder } from '../../../../relational/core/repositories/dialect/filter.js';
+import type { TConstValue } from '@venizia/ignis-helpers/common';
+import type { SQL } from 'drizzle-orm';
+/**
+ * Adds the SQLite operator table and `json_extract` path syntax; everything else - merging,
+ * where/orderBy, column selection, include, hidden-column exclusion - is inherited unchanged.
+ *
+ * The neutral column check is NARROWED rather than replaced: requiring the declared json mode is
+ * what stops a mistyped `title.tier` compiling to a `json_extract` that silently returns NULL.
+ */
+export declare class SqliteFilterBuilder extends FilterBuilder {
+    protected get operators(): TQueryOperatorHandlers;
+    protected validateJsonColumn(opts: {
+        key: string;
+        columns: TTableColumns;
+        tableName: string;
+        methodName: string;
+    }): {
+        column: TTableColumns[string];
+        path: string[];
+    };
+    /**
+     * `json_extract` hands back the JSON value in its own SQLite type - a
+     * JSON number arrives INTEGER or REAL - so there is no text extraction
+     * to repair. Postgres needs a cast only because `#>>` is always text.
+     */
+    protected jsonNeedsNumericCast(): boolean;
+    protected buildJsonWhereCondition(opts: {
+        key: string;
+        value: any;
+        columns: TTableColumns;
+        tableName: string;
+    }): SQL[];
+    protected buildJsonOrderBy(opts: {
+        key: string;
+        direction: TConstValue<typeof Sorts>;
+        columns: TTableColumns;
+        tableName: string;
+    }): SQL;
+}
+//# sourceMappingURL=filter.d.ts.map

package/dist/esm/relational/sqlite/repositories/dialect/filter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter.d.ts","sourceRoot":"","sources":["../../../../../../src/relational/sqlite/repositories/dialect/filter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC3E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uCAAuC,CAAC;AAC3E,OAAO,EAAE,aAAa,EAAE,MAAM,+CAA+C,CAAC;AAC9E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AAMvC;;;;;;GAMG;AACH,qBAAa,mBAAoB,SAAQ,aAAa;IACpD,cAAuB,SAAS,IAAI,sBAAsB,CAEzD;cAEkB,kBAAkB,CAAC,IAAI,EAAE;QAC1C,GAAG,EAAE,MAAM,CAAC;QACZ,OAAO,EAAE,aAAa,CAAC;QACvB,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;KACpB,GAAG;QAAE,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,CAAA;KAAE;IAcrD;;;;OAIG;cACgB,oBAAoB,IAAI,OAAO;cAI/B,uBAAuB,CAAC,IAAI,EAAE;QAC/C,GAAG,EAAE,MAAM,CAAC;QACZ,KAAK,EAAE,GAAG,CAAC;QACX,OAAO,EAAE,aAAa,CAAC;QACvB,SAAS,EAAE,MAAM,CAAC;KACnB,GAAG,GAAG,EAAE;cAyBU,gBAAgB,CAAC,IAAI,EAAE;QACxC,GAAG,EAAE,MAAM,CAAC;QACZ,SAAS,EAAE,WAAW,CAAC,OAAO,KAAK,CAAC,CAAC;QACrC,OAAO,EAAE,aAAa,CAAC;QACvB,SAAS,EAAE,MAAM,CAAC;KACnB,GAAG,GAAG;CAcR"}

package/dist/esm/relational/sqlite/repositories/dialect/filter.js

@@ -0,0 +1,67 @@
+import { FilterBuilder } from '../../../../relational/core/repositories/dialect/filter.js';
+import { sql } from 'drizzle-orm';
+import { assertNotBlobJsonColumn } from './internal/json-column.js';
+import { toSqliteJsonExtraction } from './internal/json-path.js';
+import { SqliteQueryOperators } from './query.js';
+/**
+ * Adds the SQLite operator table and `json_extract` path syntax; everything else - merging,
+ * where/orderBy, column selection, include, hidden-column exclusion - is inherited unchanged.
+ *
+ * The neutral column check is NARROWED rather than replaced: requiring the declared json mode is
+ * what stops a mistyped `title.tier` compiling to a `json_extract` that silently returns NULL.
+ */
+export class SqliteFilterBuilder extends FilterBuilder {
+    get operators() {
+        return SqliteQueryOperators.FNS;
+    }
+    validateJsonColumn(opts) {
+        const { tableName, methodName } = opts;
+        const validated = super.validateJsonColumn(opts);
+        assertNotBlobJsonColumn({
+            column: validated.column,
+            tableName,
+            scope: `[${SqliteFilterBuilder.name}][${methodName}]`,
+        });
+        return validated;
+    }
+    /**
+     * `json_extract` hands back the JSON value in its own SQLite type - a
+     * JSON number arrives INTEGER or REAL - so there is no text extraction
+     * to repair. Postgres needs a cast only because `#>>` is always text.
+     */
+    jsonNeedsNumericCast() {
+        return false;
+    }
+    buildJsonWhereCondition(opts) {
+        const { key, value, columns, tableName } = opts;
+        const { column, path } = this.validateJsonColumn({
+            key,
+            columns,
+            tableName,
+            methodName: 'buildJsonWhereCondition',
+        });
+        const extraction = toSqliteJsonExtraction({ columnName: column.name, path });
+        if (!this.isOperatorObject({ value })) {
+            return [this.buildValueCondition({ column: sql.raw(extraction), value })];
+        }
+        // Both arguments are the same expression: `json_extract` is already
+        // typed, so the inherited walk has no cast variant to switch to.
+        return this.buildJsonOperatorConditions({
+            jsonPath: extraction,
+            safeNumericCast: extraction,
+            operators: value,
+        });
+    }
+    buildJsonOrderBy(opts) {
+        const { key, direction, columns, tableName } = opts;
+        const { column, path } = this.validateJsonColumn({
+            key,
+            columns,
+            tableName,
+            methodName: 'buildJsonOrderBy',
+        });
+        const extraction = toSqliteJsonExtraction({ columnName: column.name, path });
+        return sql.raw(`${extraction} ${direction.toUpperCase()}`);
+    }
+}
+//# sourceMappingURL=filter.js.map

package/dist/esm/relational/sqlite/repositories/dialect/filter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter.js","sourceRoot":"","sources":["../../../../../../src/relational/sqlite/repositories/dialect/filter.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,+CAA+C,CAAC;AAG9E,OAAO,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AAClC,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAE/C;;;;;;GAMG;AACH,MAAM,OAAO,mBAAoB,SAAQ,aAAa;IACpD,IAAuB,SAAS;QAC9B,OAAO,oBAAoB,CAAC,GAAG,CAAC;IAClC,CAAC;IAEkB,kBAAkB,CAAC,IAKrC;QACC,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC;QAEvC,MAAM,SAAS,GAAG,KAAK,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC;QAEjD,uBAAuB,CAAC;YACtB,MAAM,EAAE,SAAS,CAAC,MAAM;YACxB,SAAS;YACT,KAAK,EAAE,IAAI,mBAAmB,CAAC,IAAI,KAAK,UAAU,GAAG;SACtD,CAAC,CAAC;QAEH,OAAO,SAAS,CAAC;IACnB,CAAC;IAED;;;;OAIG;IACgB,oBAAoB;QACrC,OAAO,KAAK,CAAC;IACf,CAAC;IAEkB,uBAAuB,CAAC,IAK1C;QACC,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC;QAEhD,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC,kBAAkB,CAAC;YAC/C,GAAG;YACH,OAAO;YACP,SAAS;YACT,UAAU,EAAE,yBAAyB;SACtC,CAAC,CAAC;QAEH,MAAM,UAAU,GAAG,sBAAsB,CAAC,EAAE,UAAU,EAAE,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QAE7E,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;YACtC,OAAO,CAAC,IAAI,CAAC,mBAAmB,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;QAC5E,CAAC;QAED,oEAAoE;QACpE,iEAAiE;QACjE,OAAO,IAAI,CAAC,2BAA2B,CAAC;YACtC,QAAQ,EAAE,UAAU;YACpB,eAAe,EAAE,UAAU;YAC3B,SAAS,EAAE,KAAK;SACjB,CAAC,CAAC;IACL,CAAC;IAEkB,gBAAgB,CAAC,IAKnC;QACC,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC;QAEpD,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC,kBAAkB,CAAC;YAC/C,GAAG;YACH,OAAO;YACP,SAAS;YACT,UAAU,EAAE,kBAAkB;SAC/B,CAAC,CAAC;QAEH,MAAM,UAAU,GAAG,sBAAsB,CAAC,EAAE,UAAU,EAAE,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QAE7E,OAAO,GAAG,CAAC,GAAG,CAAC,GAAG,UAAU,IAAI,SAAS,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;IAC7D,CAAC;CACF"}

package/dist/esm/relational/sqlite/repositories/dialect/index.d.ts

@@ -0,0 +1,5 @@
+export * from './filter.js';
+export * from './query.js';
+export * from './query-dialect.js';
+export * from './update.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/relational/sqlite/repositories/dialect/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/relational/sqlite/repositories/dialect/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,iBAAiB,CAAC;AAChC,cAAc,UAAU,CAAC"}

package/dist/esm/relational/sqlite/repositories/dialect/index.js

@@ -0,0 +1,5 @@
+export * from './filter.js';
+export * from './query.js';
+export * from './query-dialect.js';
+export * from './update.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/relational/sqlite/repositories/dialect/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../src/relational/sqlite/repositories/dialect/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,iBAAiB,CAAC;AAChC,cAAc,UAAU,CAAC"}

package/dist/esm/relational/sqlite/repositories/dialect/internal/json-column.d.ts

@@ -0,0 +1,14 @@
+import type { TTableColumns } from '../../../../../relational/core/repositories/common/index.js';
+/**
+ * Refuses `blob(name, { mode: 'json' })`, which the neutral check accepts because Drizzle reports
+ * `dataType: 'json'` for it. SQLite reads a BLOB json argument as JSONB while Drizzle stores UTF-8
+ * text, so payloads whose bytes resemble a JSONB header fail per-row - invisible at compile time.
+ *
+ * @throws Error if the column is declared as a blob.
+ */
+export declare const assertNotBlobJsonColumn: (opts: {
+    column: TTableColumns[string];
+    tableName: string;
+    scope: string;
+}) => void;
+//# sourceMappingURL=json-column.d.ts.map

package/dist/esm/relational/sqlite/repositories/dialect/internal/json-column.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-column.d.ts","sourceRoot":"","sources":["../../../../../../../src/relational/sqlite/repositories/dialect/internal/json-column.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uCAAuC,CAAC;AAG3E;;;;;;GAMG;AACH,eAAO,MAAM,uBAAuB,GAAI,MAAM;IAC5C,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;CACf,KAAG,IAUH,CAAC"}

package/dist/esm/relational/sqlite/repositories/dialect/internal/json-column.js

@@ -0,0 +1,18 @@
+import { getError } from '@venizia/ignis-helpers/core';
+/**
+ * Refuses `blob(name, { mode: 'json' })`, which the neutral check accepts because Drizzle reports
+ * `dataType: 'json'` for it. SQLite reads a BLOB json argument as JSONB while Drizzle stores UTF-8
+ * text, so payloads whose bytes resemble a JSONB header fail per-row - invisible at compile time.
+ *
+ * @throws Error if the column is declared as a blob.
+ */
+export const assertNotBlobJsonColumn = (opts) => {
+    const { column, tableName, scope } = opts;
+    if (column.getSQLType().toLowerCase() !== 'blob') {
+        return;
+    }
+    throw getError({
+        message: `${scope} Table: ${tableName} | Column '${column.name}' is a blob-mode JSON column | SQLite reads a BLOB argument to a json function as JSONB while Drizzle stores JSON text | Declare it as text(name, { mode: 'json' })`,
+    });
+};
+//# sourceMappingURL=json-column.js.map

package/dist/esm/relational/sqlite/repositories/dialect/internal/json-column.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-column.js","sourceRoot":"","sources":["../../../../../../../src/relational/sqlite/repositories/dialect/internal/json-column.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAEvD;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,IAIvC,EAAQ,EAAE;IACT,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;IAE1C,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC,WAAW,EAAE,KAAK,MAAM,EAAE,CAAC;QACjD,OAAO;IACT,CAAC;IAED,MAAM,QAAQ,CAAC;QACb,OAAO,EAAE,GAAG,KAAK,WAAW,SAAS,cAAc,MAAM,CAAC,IAAI,qKAAqK;KACpO,CAAC,CAAC;AACL,CAAC,CAAC"}

package/dist/esm/relational/sqlite/repositories/dialect/internal/json-path.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Every path literal a component sequence can mean, array reading first. SQLite cannot
+ * express both readings of an all-digit component at once - `$."c"[0]` is an array element,
+ * `$."c"."0"` an object key, and neither falls back to the other - while Postgres's `#>>
+ * '{c,0}'` addresses both. Handing SQLite every candidate is what makes the engines agree.
+ */
+export declare const toSqliteJsonPaths: (opts: {
+    path: string[];
+}) => string[];
+/**
+ * The raw `json_extract` expression the neutral walk feeds to `sql.raw`. Safe as text only because
+ * the caller has already resolved the column against the schema and passed every component through
+ * `validateJsonPathComponents`, whose pattern admits no quote.
+ *
+ * Coalescing loses nothing: a container is either an array or an object, so at most one candidate
+ * resolves to non-NULL.
+ */
+export declare const toSqliteJsonExtraction: (opts: {
+    columnName: string;
+    path: string[];
+}) => string;
+//# sourceMappingURL=json-path.d.ts.map

package/dist/esm/relational/sqlite/repositories/dialect/internal/json-path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-path.d.ts","sourceRoot":"","sources":["../../../../../../../src/relational/sqlite/repositories/dialect/internal/json-path.ts"],"names":[],"mappings":"AAOA;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,GAAI,MAAM;IAAE,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,KAAG,MAAM,EAmBlE,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,sBAAsB,GAAI,MAAM;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,KAAG,MAQrF,CAAC"}

package/dist/esm/relational/sqlite/repositories/dialect/internal/json-path.js

@@ -0,0 +1,40 @@
+import { getError } from '@venizia/ignis-helpers/core';
+/** Every all-digit component doubles the candidate paths, and filter keys arrive from callers. */
+const MAX_AMBIGUOUS_COMPONENTS = 4;
+const isAmbiguousComponent = (opts) => /^\d+$/.test(opts.part);
+/**
+ * Every path literal a component sequence can mean, array reading first. SQLite cannot
+ * express both readings of an all-digit component at once - `$."c"[0]` is an array element,
+ * `$."c"."0"` an object key, and neither falls back to the other - while Postgres's `#>>
+ * '{c,0}'` addresses both. Handing SQLite every candidate is what makes the engines agree.
+ */
+export const toSqliteJsonPaths = (opts) => {
+    const { path } = opts;
+    const ambiguousCount = path.filter(part => isAmbiguousComponent({ part })).length;
+    if (ambiguousCount > MAX_AMBIGUOUS_COMPONENTS) {
+        throw getError({
+            message: `[toSqliteJsonPaths] Ambiguous JSON path components over the limit | max: ${MAX_AMBIGUOUS_COMPONENTS} | got: ${ambiguousCount} | each all-digit component doubles the candidate paths`,
+        });
+    }
+    let literals = ['$'];
+    for (const part of path) {
+        literals = isAmbiguousComponent({ part })
+            ? literals.flatMap(literal => [`${literal}[${part}]`, `${literal}."${part}"`])
+            : literals.map(literal => `${literal}."${part}"`);
+    }
+    return literals;
+};
+/**
+ * The raw `json_extract` expression the neutral walk feeds to `sql.raw`. Safe as text only because
+ * the caller has already resolved the column against the schema and passed every component through
+ * `validateJsonPathComponents`, whose pattern admits no quote.
+ *
+ * Coalescing loses nothing: a container is either an array or an object, so at most one candidate
+ * resolves to non-NULL.
+ */
+export const toSqliteJsonExtraction = (opts) => {
+    const { columnName, path } = opts;
+    const extractions = toSqliteJsonPaths({ path }).map(literal => `json_extract("${columnName}", '${literal}')`);
+    return extractions.length > 1 ? `coalesce(${extractions.join(', ')})` : extractions.join('');
+};
+//# sourceMappingURL=json-path.js.map

package/dist/esm/relational/sqlite/repositories/dialect/internal/json-path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-path.js","sourceRoot":"","sources":["../../../../../../../src/relational/sqlite/repositories/dialect/internal/json-path.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAEvD,kGAAkG;AAClG,MAAM,wBAAwB,GAAG,CAAC,CAAC;AAEnC,MAAM,oBAAoB,GAAG,CAAC,IAAsB,EAAW,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAE1F;;;;;GAKG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,IAAwB,EAAY,EAAE;IACtE,MAAM,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC;IAEtB,MAAM,cAAc,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,oBAAoB,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC;IAClF,IAAI,cAAc,GAAG,wBAAwB,EAAE,CAAC;QAC9C,MAAM,QAAQ,CAAC;YACb,OAAO,EAAE,4EAA4E,wBAAwB,WAAW,cAAc,yDAAyD;SAChM,CAAC,CAAC;IACL,CAAC;IAED,IAAI,QAAQ,GAAG,CAAC,GAAG,CAAC,CAAC;IAErB,KAAK,MAAM,IAAI,IAAI,IAAI,EAAE,CAAC;QACxB,QAAQ,GAAG,oBAAoB,CAAC,EAAE,IAAI,EAAE,CAAC;YACvC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,GAAG,OAAO,IAAI,IAAI,GAAG,EAAE,GAAG,OAAO,KAAK,IAAI,GAAG,CAAC,CAAC;YAC9E,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,GAAG,OAAO,KAAK,IAAI,GAAG,CAAC,CAAC;IACtD,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,IAA4C,EAAU,EAAE;IAC7F,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC;IAElC,MAAM,WAAW,GAAG,iBAAiB,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,CACjD,OAAO,CAAC,EAAE,CAAC,iBAAiB,UAAU,OAAO,OAAO,IAAI,CACzD,CAAC;IAEF,OAAO,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,YAAY,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AAC/F,CAAC,CAAC"}

package/dist/esm/relational/sqlite/repositories/dialect/query-dialect.d.ts

@@ -0,0 +1,23 @@
+import type { TTableSchemaWithId } from '../../../../relational/core/models/common/index.js';
+import type { IRelationalQueryDialect, ITransformedUpdateData } from '../../../../relational/core/repositories/common/index.js';
+import { SqliteFilterBuilder } from './filter.js';
+import { SqliteUpdateBuilder } from './update.js';
+/**
+ * The SQLite `IRelationalQueryDialect`: the neutral `FilterBuilder`'s filter translation plus the
+ * SQLite-only JSON-path update composition (`json_set`) that `SqliteUpdateBuilder` owns. The two
+ * stay in separate files so `SqliteFilterBuilder` keeps its zero sqlite-core imports.
+ */
+export declare class SqliteQueryDialect extends SqliteFilterBuilder implements IRelationalQueryDialect {
+    private readonly _updateBuilder;
+    /** The SQLite update transform, reachable for callers that need the raw builder. */
+    get updateBuilder(): SqliteUpdateBuilder;
+    transformUpdate<Schema extends TTableSchemaWithId>(opts: {
+        tableName: string;
+        schema: Schema;
+        data: Record<string, unknown>;
+    }): ITransformedUpdateData;
+    toUpdateData(opts: {
+        transformed: ITransformedUpdateData;
+    }): Record<string, unknown>;
+}
+//# sourceMappingURL=query-dialect.d.ts.map

package/dist/esm/relational/sqlite/repositories/dialect/query-dialect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-dialect.d.ts","sourceRoot":"","sources":["../../../../../../src/relational/sqlite/repositories/dialect/query-dialect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,KAAK,EACV,uBAAuB,EACvB,sBAAsB,EACvB,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAC/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAE/C;;;;GAIG;AACH,qBAAa,kBAAmB,SAAQ,mBAAoB,YAAW,uBAAuB;IAC5F,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA6B;IAE5D,oFAAoF;IACpF,IAAI,aAAa,IAAI,mBAAmB,CAEvC;IAED,eAAe,CAAC,MAAM,SAAS,kBAAkB,EAAE,IAAI,EAAE;QACvD,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KAC/B,GAAG,sBAAsB;IAI1B,YAAY,CAAC,IAAI,EAAE;QAAE,WAAW,EAAE,sBAAsB,CAAA;KAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAGrF"}

package/dist/esm/relational/sqlite/repositories/dialect/query-dialect.js

@@ -0,0 +1,24 @@
+import { SqliteFilterBuilder } from './filter.js';
+import { SqliteUpdateBuilder } from './update.js';
+/**
+ * The SQLite `IRelationalQueryDialect`: the neutral `FilterBuilder`'s filter translation plus the
+ * SQLite-only JSON-path update composition (`json_set`) that `SqliteUpdateBuilder` owns. The two
+ * stay in separate files so `SqliteFilterBuilder` keeps its zero sqlite-core imports.
+ */
+export class SqliteQueryDialect extends SqliteFilterBuilder {
+    constructor() {
+        super(...arguments);
+        this._updateBuilder = new SqliteUpdateBuilder();
+    }
+    /** The SQLite update transform, reachable for callers that need the raw builder. */
+    get updateBuilder() {
+        return this._updateBuilder;
+    }
+    transformUpdate(opts) {
+        return this._updateBuilder.transform(opts);
+    }
+    toUpdateData(opts) {
+        return this._updateBuilder.toUpdateData(opts);
+    }
+}
+//# sourceMappingURL=query-dialect.js.map

package/dist/esm/relational/sqlite/repositories/dialect/query-dialect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-dialect.js","sourceRoot":"","sources":["../../../../../../src/relational/sqlite/repositories/dialect/query-dialect.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAC/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAE/C;;;;GAIG;AACH,MAAM,OAAO,kBAAmB,SAAQ,mBAAmB;IAA3D;;QACmB,mBAAc,GAAG,IAAI,mBAAmB,EAAE,CAAC;IAkB9D,CAAC;IAhBC,oFAAoF;IACpF,IAAI,aAAa;QACf,OAAO,IAAI,CAAC,cAAc,CAAC;IAC7B,CAAC;IAED,eAAe,CAAoC,IAIlD;QACC,OAAO,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAC7C,CAAC;IAED,YAAY,CAAC,IAA6C;QACxD,OAAO,IAAI,CAAC,cAAc,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;IAChD,CAAC;CACF"}

package/dist/esm/relational/sqlite/repositories/dialect/query.d.ts

@@ -0,0 +1,42 @@
+import type { IQueryHandlerOptions } from '@venizia/ignis-kernel';
+import { QueryOperators } from '@venizia/ignis-kernel';
+/**
+ * Drizzle-backed handlers for the neutral QueryOperators vocabulary. The operator NAMES live in
+ * repositories/common/operators.ts, shared with every connector family.
+ */
+export declare class SqliteQueryOperators extends QueryOperators {
+    /**
+     * Refuses where it cannot translate: approximate SQL returns the wrong rows silently,
+     * and a caller cannot tell that from a right answer. The message names the operator
+     * and the missing capability, so the caller knows there is nothing to configure.
+     */
+    private static reject;
+    static readonly FNS: {
+        eq: (opts: IQueryHandlerOptions) => import("drizzle-orm").SQL<unknown>;
+        ne: (opts: IQueryHandlerOptions) => import("drizzle-orm").SQL<unknown>;
+        neq: (opts: IQueryHandlerOptions) => import("drizzle-orm").SQL<unknown>;
+        exists: (opts: IQueryHandlerOptions) => import("drizzle-orm").SQL<unknown>;
+        notExists: (opts: IQueryHandlerOptions) => import("drizzle-orm").SQL<unknown>;
+        gt: (opts: IQueryHandlerOptions) => import("drizzle-orm").SQL<unknown>;
+        gte: (opts: IQueryHandlerOptions) => import("drizzle-orm").SQL<unknown>;
+        lt: (opts: IQueryHandlerOptions) => import("drizzle-orm").SQL<unknown>;
+        lte: (opts: IQueryHandlerOptions) => import("drizzle-orm").SQL<unknown>;
+        is: (opts: IQueryHandlerOptions) => import("drizzle-orm").SQL<unknown>;
+        isn: (opts: IQueryHandlerOptions) => import("drizzle-orm").SQL<unknown>;
+        in: (opts: IQueryHandlerOptions) => import("drizzle-orm").SQL<unknown>;
+        inq: (opts: IQueryHandlerOptions) => import("drizzle-orm").SQL<unknown>;
+        nin: (opts: IQueryHandlerOptions) => import("drizzle-orm").SQL<unknown>;
+        between: (opts: IQueryHandlerOptions) => import("drizzle-orm").SQL<unknown>;
+        notBetween: (opts: IQueryHandlerOptions) => import("drizzle-orm").SQL<unknown>;
+        contains: () => never;
+        containedBy: () => never;
+        overlaps: () => never;
+        like: (opts: IQueryHandlerOptions) => import("drizzle-orm").SQL<unknown>;
+        nlike: (opts: IQueryHandlerOptions) => import("drizzle-orm").SQL<unknown>;
+        ilike: (opts: IQueryHandlerOptions) => import("drizzle-orm").SQL<unknown>;
+        nilike: (opts: IQueryHandlerOptions) => import("drizzle-orm").SQL<unknown>;
+        regexp: () => never;
+        iregexp: () => never;
+    };
+}
+//# sourceMappingURL=query.d.ts.map

package/dist/esm/relational/sqlite/repositories/dialect/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../../../../../src/relational/sqlite/repositories/dialect/query.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAClE,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAqBvD;;;GAGG;AACH,qBAAa,oBAAqB,SAAQ,cAAc;IACtD;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAAC,MAAM;IAYrB,MAAM,CAAC,QAAQ,CAAC,GAAG;mBACC,oBAAoB;mBAIpB,oBAAoB;oBAEnB,oBAAoB;uBAKjB,oBAAoB;0BAEhB,oBAAoB;mBAG5B,oBAAoB;oBACnB,oBAAoB;mBAErB,oBAAoB;oBACnB,oBAAoB;mBAErB,oBAAoB;oBAEhB,oBAAoB;mBAGxB,oBAAoB;oBAMnB,oBAAoB;oBAMpB,oBAAoB;wBAMhB,oBAAoB;2BAQhB,oBAAoB;;;;qBAuB3B,oBAAoB;sBAChB,oBAAoB;sBACvB,oBAAoB;uBAChB,oBAAoB;;;MAc7C;CACH"}

package/dist/esm/relational/sqlite/repositories/dialect/query.js

@@ -0,0 +1,101 @@
+import { QueryOperators } from '@venizia/ignis-kernel';
+import { throwNotSupported } from '@venizia/ignis-kernel';
+import { BaseHelper, getError } from '@venizia/ignis-helpers/core';
+import { between, eq, gt, gte, inArray, isNotNull, isNull, like, lt, lte, ne, not, notInArray, notLike, sql, } from 'drizzle-orm';
+/**
+ * Drizzle-backed handlers for the neutral QueryOperators vocabulary. The operator NAMES live in
+ * repositories/common/operators.ts, shared with every connector family.
+ */
+export class SqliteQueryOperators extends QueryOperators {
+    /**
+     * Refuses where it cannot translate: approximate SQL returns the wrong rows silently,
+     * and a caller cannot tell that from a right answer. The message names the operator
+     * and the missing capability, so the caller knows there is nothing to configure.
+     */
+    static reject(opts) {
+        const { operator, reason } = opts;
+        return throwNotSupported({
+            scope: SqliteQueryOperators.name,
+            feature: `Operator '${operator}' - ${reason}`,
+            // Not `LoggerFactory`: it reaches the helpers root barrel, which pulls `ioredis` and fails a
+            // browser bundle on `tls`.
+            logger: new BaseHelper({ scope: SqliteQueryOperators.name }).getLogger(),
+        });
+    }
+    static { this.FNS = {
+        [this.EQ]: (opts) => opts.value === null ? isNull(opts.column) : eq(opts.column, opts.value),
+        // SQL three-valued logic is canonical: a NULL row never matches `neq`/`ne`,
+        // because comparing to a real value yields UNKNOWN rather than TRUE.
+        [this.NE]: (opts) => opts.value === null ? isNotNull(opts.column) : ne(opts.column, opts.value),
+        [this.NEQ]: (opts) => opts.value === null ? isNotNull(opts.column) : ne(opts.column, opts.value),
+        // `exists`/`notExists` test presence: `exists: true` -> IS NOT
+        // NULL, `exists: false` -> IS NULL, `notExists` the inverse.
+        [this.EXISTS]: (opts) => opts.value === false ? isNull(opts.column) : isNotNull(opts.column),
+        [this.NOT_EXISTS]: (opts) => opts.value === false ? isNotNull(opts.column) : isNull(opts.column),
+        [this.GT]: (opts) => gt(opts.column, opts.value),
+        [this.GTE]: (opts) => gte(opts.column, opts.value),
+        [this.LT]: (opts) => lt(opts.column, opts.value),
+        [this.LTE]: (opts) => lte(opts.column, opts.value),
+        [this.IS]: (opts) => opts.value === null ? isNull(opts.column) : eq(opts.column, opts.value),
+        [this.IS_NOT]: (opts) => opts.value === null ? isNotNull(opts.column) : ne(opts.column, opts.value),
+        [this.IN]: (opts) => {
+            if (!Array.isArray(opts.value)) {
+                return eq(opts.column, opts.value);
+            }
+            return opts.value.length === 0 ? sql `false` : inArray(opts.column, opts.value);
+        },
+        [this.INQ]: (opts) => {
+            if (!Array.isArray(opts.value)) {
+                return eq(opts.column, opts.value);
+            }
+            return opts.value.length === 0 ? sql `false` : inArray(opts.column, opts.value);
+        },
+        [this.NIN]: (opts) => {
+            if (!Array.isArray(opts.value)) {
+                return ne(opts.column, opts.value);
+            }
+            return opts.value.length === 0 ? sql `true` : notInArray(opts.column, opts.value);
+        },
+        [this.BETWEEN]: (opts) => {
+            if (!Array.isArray(opts.value) || opts.value.length !== 2) {
+                throw getError({
+                    message: `[SqliteQueryOperators][BETWEEN] Invalid value: expected array of 2 elements, got ${JSON.stringify(opts.value)}`,
+                });
+            }
+            return between(opts.column, opts.value[0], opts.value[1]);
+        },
+        [this.NOT_BETWEEN]: (opts) => {
+            if (!Array.isArray(opts.value) || opts.value.length !== 2) {
+                throw getError({
+                    message: `[SqliteQueryOperators][NOT_BETWEEN] Invalid value: expected array of 2 elements, got ${JSON.stringify(opts.value)}`,
+                });
+            }
+            return not(between(opts.column, opts.value[0], opts.value[1]));
+        },
+        // No array storage class, so `@>` / `<@` / `&&` have no operand. A `json_each` emulation would
+        // answer a different question - containment inside one row's JSON, not array-column algebra.
+        [this.CONTAINS]: () => this.reject({ operator: this.CONTAINS, reason: 'SQLite has no array storage class' }),
+        [this.CONTAINED_BY]: () => this.reject({ operator: this.CONTAINED_BY, reason: 'SQLite has no array storage class' }),
+        [this.OVERLAPS]: () => this.reject({ operator: this.OVERLAPS, reason: 'SQLite has no array storage class' }),
+        /*
+         * SQLite's `LIKE` is ASCII case-INSENSITIVE, so `ilike` maps exactly and it is `like` that
+         * silently widens against its Postgres meaning. Refusing `ilike` would be theatre - renaming it
+         * to `like` yields the same SQL. Residual gap: `'ÉCOLE' LIKE 'é%'` is false without ICU.
+         */
+        [this.LIKE]: (opts) => like(opts.column, opts.value),
+        [this.NOT_LIKE]: (opts) => notLike(opts.column, opts.value),
+        [this.ILIKE]: (opts) => like(opts.column, opts.value),
+        [this.NOT_ILIKE]: (opts) => notLike(opts.column, opts.value),
+        // `X REGEXP Y` is sugar for a `regexp()` function SQLite never defines and libsql never
+        // registers, so the operator would fail at execution on a query that looked accepted.
+        [this.REGEXP]: () => this.reject({
+            operator: this.REGEXP,
+            reason: 'SQLite defines no regexp() function and libsql registers none',
+        }),
+        [this.IREGEXP]: () => this.reject({
+            operator: this.IREGEXP,
+            reason: 'SQLite defines no regexp() function and libsql registers none',
+        }),
+    }; }
+}
+//# sourceMappingURL=query.js.map

package/dist/esm/relational/sqlite/repositories/dialect/query.js.map

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

package/dist/esm/relational/sqlite/repositories/dialect/update.d.ts

@@ -0,0 +1,27 @@
+import type { TTableSchemaWithId } from '../../../../relational/core/models/common/index.js';
+import type { ITransformedUpdateData } from '../../../../relational/core/repositories/common/index.js';
+import { RelationalUpdateBuilder } from '../../../../relational/core/repositories/dialect/index.js';
+import type { SQL } from 'drizzle-orm';
+/**
+ * Composes nested JSON path updates as chained `json_set` calls - SQLite's `jsonb_set`. The neutral
+ * base owns the split and the path validation.
+ */
+export declare class SqliteUpdateBuilder extends RelationalUpdateBuilder {
+    constructor();
+    transform<Schema extends TTableSchemaWithId>(opts: {
+        tableName: string;
+        schema: Schema;
+        data: Record<string, any>;
+    }): ITransformedUpdateData;
+    /**
+     * Path and value are BOUND, never interpolated: unlike the extraction side, nothing here has to
+     * survive `sql.raw`. `json(...)` is what keeps an object, an array or `true` from being stored as
+     * a JSON string.
+     */
+    protected composeJsonSet(opts: {
+        target: SQL;
+        path: string[];
+        value: any;
+    }): SQL;
+}
+//# sourceMappingURL=update.d.ts.map

package/dist/esm/relational/sqlite/repositories/dialect/update.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../../../../../src/relational/sqlite/repositories/dialect/update.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,uCAAuC,CAAC;AAEpF,OAAO,EAAE,uBAAuB,EAAE,MAAM,wCAAwC,CAAC;AACjF,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AAKvC;;;GAGG;AACH,qBAAa,mBAAoB,SAAQ,uBAAuB;;IAKrD,SAAS,CAAC,MAAM,SAAS,kBAAkB,EAAE,IAAI,EAAE;QAC1D,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;KAC3B,GAAG,sBAAsB;IAmB1B;;;;OAIG;cACgB,cAAc,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,GAAG,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,CAAC;QAAC,KAAK,EAAE,GAAG,CAAA;KAAE,GAAG,GAAG;CAY1F"}

package/dist/esm/relational/sqlite/repositories/dialect/update.js

@@ -0,0 +1,42 @@
+import { TableColumnCache } from '../../../../relational/core/repositories/common/index.js';
+import { RelationalUpdateBuilder } from '../../../../relational/core/repositories/dialect/index.js';
+import { sql } from 'drizzle-orm';
+import { assertNotBlobJsonColumn } from './internal/json-column.js';
+import { toSqliteJsonPaths } from './internal/json-path.js';
+/**
+ * Composes nested JSON path updates as chained `json_set` calls - SQLite's `jsonb_set`. The neutral
+ * base owns the split and the path validation.
+ */
+export class SqliteUpdateBuilder extends RelationalUpdateBuilder {
+    constructor() {
+        super({ scope: SqliteUpdateBuilder.name });
+    }
+    transform(opts) {
+        const { tableName, schema } = opts;
+        const transformed = super.transform(opts);
+        // Checked on the way out: the base keys `jsonExpressions` by
+        // schema property, which is what resolves back to a column.
+        const columns = TableColumnCache.get(schema);
+        for (const columnName in transformed.jsonExpressions) {
+            assertNotBlobJsonColumn({
+                column: columns[columnName],
+                tableName,
+                scope: `[${SqliteUpdateBuilder.name}][transform]`,
+            });
+        }
+        return transformed;
+    }
+    /**
+     * Path and value are BOUND, never interpolated: unlike the extraction side, nothing here has to
+     * survive `sql.raw`. `json(...)` is what keeps an object, an array or `true` from being stored as
+     * a JSON string.
+     */
+    composeJsonSet(opts) {
+        const { target, path, value } = opts;
+        const serialized = JSON.stringify(value);
+        // Chained rather than merged: an all-digit component yields both
+        // readings, and only the one matching the stored shape applies.
+        return toSqliteJsonPaths({ path }).reduce((composed, literal) => sql `json_set(${composed}, ${literal}, json(${serialized}))`, target);
+    }
+}
+//# sourceMappingURL=update.js.map

package/dist/esm/relational/sqlite/repositories/dialect/update.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update.js","sourceRoot":"","sources":["../../../../../../src/relational/sqlite/repositories/dialect/update.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,MAAM,uCAAuC,CAAC;AACzE,OAAO,EAAE,uBAAuB,EAAE,MAAM,wCAAwC,CAAC;AAEjF,OAAO,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AAClC,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAEzD;;;GAGG;AACH,MAAM,OAAO,mBAAoB,SAAQ,uBAAuB;IAC9D;QACE,KAAK,CAAC,EAAE,KAAK,EAAE,mBAAmB,CAAC,IAAI,EAAE,CAAC,CAAC;IAC7C,CAAC;IAEQ,SAAS,CAAoC,IAIrD;QACC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;QAEnC,MAAM,WAAW,GAAG,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAE1C,6DAA6D;QAC7D,4DAA4D;QAC5D,MAAM,OAAO,GAAG,gBAAgB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC7C,KAAK,MAAM,UAAU,IAAI,WAAW,CAAC,eAAe,EAAE,CAAC;YACrD,uBAAuB,CAAC;gBACtB,MAAM,EAAE,OAAO,CAAC,UAAU,CAAC;gBAC3B,SAAS;gBACT,KAAK,EAAE,IAAI,mBAAmB,CAAC,IAAI,cAAc;aAClD,CAAC,CAAC;QACL,CAAC;QAED,OAAO,WAAW,CAAC;IACrB,CAAC;IAED;;;;OAIG;IACgB,cAAc,CAAC,IAAiD;QACjF,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;QAErC,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QAEzC,iEAAiE;QACjE,gEAAgE;QAChE,OAAO,iBAAiB,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,CACvC,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,CAAC,GAAG,CAAA,YAAY,QAAQ,KAAK,OAAO,UAAU,UAAU,IAAI,EAClF,MAAM,CACP,CAAC;IACJ,CAAC;CACF"}

package/dist/esm/relational/sqlite/repositories/executor.d.ts

@@ -0,0 +1,40 @@
+import type { ICountOptions, IInsertOptions, IRelationalQueryExecutor, IRelationalQueryOptions, IRemoveOptions, ISelectOptions, IUpdateOptions, IWriteResult } from '../../../relational/core/repositories/common/index.js';
+import type { TSqliteConnector } from '../../../relational/sqlite/drivers/index.js';
+import type { TNullable } from '@venizia/ignis-helpers/common';
+/**
+ * Translates already-built SQL fragments (`where`, `orderBy`, projections) to Drizzle Core calls.
+ * Filter-to-SQL compilation is dialect work and stays in the repository tier.
+ *
+ * The `rows as Array<R>` every write verb ends in is convention, not proof: Drizzle infers
+ * `returning()`'s row type from the table schema, not from the caller-chosen R.
+ */
+export declare class SqliteQueryExecutor implements IRelationalQueryExecutor<TSqliteConnector> {
+    private readonly logger;
+    constructor();
+    select<R>(opts: ISelectOptions<TSqliteConnector>): Promise<Array<R>>;
+    count(opts: ICountOptions<TSqliteConnector>): Promise<number>;
+    findMany<R>(opts: IRelationalQueryOptions<TSqliteConnector>): Promise<Array<R>>;
+    findFirst<R>(opts: IRelationalQueryOptions<TSqliteConnector>): Promise<TNullable<R>>;
+    insert<R>(opts: IInsertOptions<TSqliteConnector>): Promise<IWriteResult<R>>;
+    update<R>(opts: IUpdateOptions<TSqliteConnector>): Promise<IWriteResult<R>>;
+    remove<R>(opts: IRemoveOptions<TSqliteConnector>): Promise<IWriteResult<R>>;
+    /**
+     * The neutral options carry the dialect-free `Table` bound; every Drizzle SQLite verb wants the
+     * concrete `SQLiteTable`. Knowing your own input belongs in the engine adapter, so the whole
+     * boundary is this one cast.
+     */
+    private asTable;
+    /**
+     * Gets the Drizzle relational-query interface, validating schema registration. The error wording
+     * names the entity and lists the available keys, and a test asserts it word for word.
+     */
+    private getQueryInterface;
+    /**
+     * Rows affected by a write with no RETURNING. Reads libsql's `ResultSet.rowsAffected`
+     * off the raw result - engine knowledge the shared repository tier must not hold.
+     * Drivers reporting `changes` instead are synchronous, and `TSqliteConnector` is
+     * pinned to `'async'`, so none can arrive here.
+     */
+    private readAffectedRowCount;
+}
+//# sourceMappingURL=executor.d.ts.map

package/dist/esm/relational/sqlite/repositories/executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../../../../src/relational/sqlite/repositories/executor.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,aAAa,EACb,cAAc,EACd,wBAAwB,EACxB,uBAAuB,EACvB,cAAc,EACd,cAAc,EACd,cAAc,EACd,YAAY,EACb,MAAM,uCAAuC,CAAC;AAC/C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAGpE,OAAO,KAAK,EAAW,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAKxE;;;;;;GAMG;AACH,qBAAa,mBAAoB,YAAW,wBAAwB,CAAC,gBAAgB,CAAC;IACpF,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAU;;IAQ3B,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,cAAc,CAAC,gBAAgB,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IA0CpE,KAAK,CAAC,IAAI,EAAE,aAAa,CAAC,gBAAgB,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;IAK7D,QAAQ,CAAC,CAAC,EAAE,IAAI,EAAE,uBAAuB,CAAC,gBAAgB,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAQ/E,SAAS,CAAC,CAAC,EAAE,IAAI,EAAE,uBAAuB,CAAC,gBAAgB,CAAC,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IAYpF,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,cAAc,CAAC,gBAAgB,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAa3E,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,cAAc,CAAC,gBAAgB,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAgB3E,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,cAAc,CAAC,gBAAgB,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAajF;;;;OAIG;IACH,OAAO,CAAC,OAAO;IAIf;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAqBzB;;;;;OAKG;IACH,OAAO,CAAC,oBAAoB;CAwB7B"}