@venizia/ignis 0.1.1-8 → 0.1.1

package/dist/connectors/search/repositories/core/readable.d.ts.map

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

package/dist/connectors/search/repositories/core/readable.js

@@ -4,6 +4,8 @@ exports.ReadableSearchRepository = void 0;
 const common_1 = require("../../../../base/repositories/common");
 const common_2 = require("../../../../connectors/search/repositories/common");
 const base_1 = require("./base");
+/** The match-everything term. `build()` already seeds `query` with it, so a filter-only listing reaches the engine as `q: '*'` - naming fields for a term that ignores fields would mean nothing. */
+const WILDCARD_QUERY = '*';
 /** Read-only search-repository tier - translates filters via the datasource's dialect and executes through the connector. */
 class ReadableSearchRepository extends base_1.SearchBaseRepository {
     async count(opts) {
@@ -13,8 +15,13 @@ class ReadableSearchRepository extends base_1.SearchBaseRepository {
             filter: { where: opts.where },
             shouldSkipDefaultFilter: opts.options?.shouldSkipDefaultFilter,
         });
-        // Counted through the document endpoint, never the search endpoint: an engine whose search
-        // total is capped or estimated would otherwise report a count that quietly lies.
+        // An absorbing where counts zero by definition. Asking the engine would mean sending NO
+        // filterBy at all, which counts the entire collection.
+        if (query.matchNone) {
+            return { count: 0 };
+        }
+        // Counted through the document endpoint, never search: an engine whose search total is capped
+        // or estimated would report a count that quietly lies.
         const count = await this.connector.document.count({
             collection: this.collectionName,
             filterBy: query.filterBy,
@@ -25,8 +32,10 @@ class ReadableSearchRepository extends base_1.SearchBaseRepository {
         const { count } = await this.count(opts);
         return count > 0;
     }
-    /** Bare array or `{ data, range }` per shouldQueryRange, postgres-shaped range. Typesense's `found`
-     * already comes back in the same call as `hits`, so unlike SQL no second count query is needed. */
+    /**
+     * Bare array or `{ data, range }` per shouldQueryRange, postgres-shaped range. Typesense returns
+     * `found` in the same call as `hits`, so unlike SQL no second count query is needed.
+     */
     async find(opts) {
         const { filter, options } = opts;
         if (options?.retry) {
@@ -36,7 +45,8 @@ class ReadableSearchRepository extends base_1.SearchBaseRepository {
         }
         this.assertNoTransaction(options);
         this.assertNoLock(options);
-        // Omitted limit falls back to @model settings.defaultLimit then DEFAULT_LIMIT, rather than leaving `per_page` unset (an unbounded query).
+        // An omitted limit falls back to @model settings.defaultLimit then DEFAULT_LIMIT - leaving
+        // `per_page` unset would be an unbounded query.
         const effectiveFilter = {
             ...filter,
             limit: filter?.limit ?? this.defaultLimit ?? common_1.DEFAULT_LIMIT,
@@ -45,14 +55,18 @@ class ReadableSearchRepository extends base_1.SearchBaseRepository {
             filter: effectiveFilter,
             shouldSkipDefaultFilter: options?.shouldSkipDefaultFilter,
         });
-        const result = await this.connector.search({
-            collection: this.collectionName,
-            params: this.queryDialect.toWireParams({ query }),
-        });
+        // No round-trip for an absorbing where: with no filterBy the engine would happily return the
+        // whole collection, which is the opposite of what the filter asked for.
+        const result = query.matchNone
+            ? { hits: [], found: 0 }
+            : await this.connector.search({
+                collection: this.collectionName,
+                params: this.queryDialect.toWireParams({ query }),
+            });
         const { hits, found } = result;
-        // An explicit `find<Other>()` call is the caller's own unchecked assertion (R defaults to TDocument).
-        // Stripped in JS as well as engine-side: Typesense honours `exclude_fields`, but Meilisearch has
-        // no per-query exclusion at all, so the engine is not the last line of defence here.
+        // The cast is the caller's own unchecked assertion when they pass an explicit `find<Other>()`.
+        // Hidden fields are stripped in JS too, not only engine-side: Typesense honours
+        // `exclude_fields`, Meilisearch has no per-query exclusion at all.
         const data = this.omitHiddenFieldsAll((hits ?? []).map(hit => hit.document));
         if (!options?.shouldQueryRange) {
             return data;
@@ -72,22 +86,29 @@ class ReadableSearchRepository extends base_1.SearchBaseRepository {
         if (options?.retry) {
             return this.findOneUntil({ filter, options });
         }
-        // `retry` is already handled above, so it is absent here; TFindOneOptions's retry generic
-        // (TNullable<R>) does not unify with find's own (Array<R>), hence the options-only cast.
+        // `retry` is handled above so it is absent here; TFindOneOptions's retry generic (TNullable<R>)
+        // does not unify with find's own (Array<R>), hence the options-only cast.
         const results = await this.find({
             filter: { ...filter, limit: 1 },
             options: options,
         });
         return results[0] ?? null;
     }
-    /** Delegates to findOne with id in where - routes through buildQuery so hiddenFields/defaultFilter apply (a soft-deleted doc resolves to null, not fetched directly). */
+    /**
+     * Delegates to findOne with id in where - routing through buildQuery is what makes
+     * hiddenFields/defaultFilter apply, so a soft-deleted document resolves to null. `where` is spread
+     * away last so a projection can never widen the id lookup.
+     */
     findById(opts) {
-        const { id, options } = opts;
-        return this.findOne({ filter: { where: { id } }, options });
+        const { id, filter, options } = opts;
+        return this.findOne({ filter: { ...filter, where: { id } }, options });
     }
-    /** Unified search entry, discriminated by `mode`: `raw` is a full passthrough (no dialect/
-     * defaultFilter/hiddenFields); keyword/semantic/hybrid translate via the dialect same as `find()`.
-     * Nothing engine-specific lives here - `ISearchQueryDialect.applySearchInput` owns it all. */
+    /**
+     * Unified search entry discriminated by `mode`: `raw` is a full passthrough - no dialect, no
+     * defaultFilter, no hiddenFields - while keyword/semantic/hybrid translate through the dialect
+     * like `find()`. Nothing engine-specific lives here; `ISearchQueryDialect.applySearchInput`
+     * owns it.
+     */
     async search(opts) {
         if (opts.mode === common_2.SearchModes.RAW) {
             return this.connector.search({
@@ -101,7 +122,13 @@ class ReadableSearchRepository extends base_1.SearchBaseRepository {
             filter: opts.filter,
             shouldSkipDefaultFilter: opts.options?.shouldSkipDefaultFilter,
         });
-        this.queryDialect.applySearchInput({ query, input: opts });
+        this.queryDialect.applySearchInput({ query, input: this.withDefaultQueryBy({ input: opts }) });
+        // Same short-circuit as find(): an absorbing filter cannot be expressed to the engine, and
+        // omitting it would search everything.
+        // `isFoundExact` is true because zero is not an estimate - nothing was searched to approximate.
+        if (query.matchNone) {
+            return { hits: [], found: 0, isFoundExact: true };
+        }
         const result = await this.connector.search({
             collection: this.collectionName,
             params: this.queryDialect.toWireParams({ query }),
@@ -114,25 +141,44 @@ class ReadableSearchRepository extends base_1.SearchBaseRepository {
             })),
         };
     }
+    withDefaultQueryBy(opts) {
+        const { input } = opts;
+        if (input.mode !== common_2.SearchModes.KEYWORD || input.queryBy) {
+            return input;
+        }
+        const term = input.query?.trim();
+        if (!term || term === WILDCARD_QUERY) {
+            return input;
+        }
+        const defaultQueryBy = this.entity?.schema?.defaultQueryBy;
+        if (!defaultQueryBy || defaultQueryBy.length === 0) {
+            return input;
+        }
+        return { ...input, queryBy: [...defaultQueryBy] };
+    }
     create(_opts) {
-        return this.denyOperation(this.create.name);
+        return this.denyOperation({ methodName: this.create.name });
     }
     createAll(_opts) {
-        return this.denyOperation(this.createAll.name);
+        return this.denyOperation({ methodName: this.createAll.name });
     }
     updateById(_opts) {
-        return this.denyOperation(this.updateById.name);
+        return this.denyOperation({ methodName: this.updateById.name });
     }
-    /** @throws Error - disabled in a read-only repository. */
+    /**
+     * @throws Error - disabled in a read-only repository. `where` is optional where the base contract
+     * requires it: the `@model` defaultFilter alone can supply the effective filter, and Persistable
+     * refuses the write outright when neither is present.
+     */
     updateAll(_opts) {
-        return this.denyOperation(this.updateAll.name);
+        return this.denyOperation({ methodName: this.updateAll.name });
     }
     deleteById(_opts) {
-        return this.denyOperation(this.deleteById.name);
+        return this.denyOperation({ methodName: this.deleteById.name });
     }
     /** @throws Error - disabled in a read-only repository. Unlocked by DefaultSearchRepository. */
     deleteAll(_opts) {
-        return this.denyOperation(this.deleteAll.name);
+        return this.denyOperation({ methodName: this.deleteAll.name });
     }
 }
 exports.ReadableSearchRepository = ReadableSearchRepository;

package/dist/connectors/search/repositories/core/readable.js.map

@@ -1 +1 @@
-{"version":3,"file":"readable.js","sourceRoot":"","sources":["../../../../../src/connectors/search/repositories/core/readable.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"readable.js","sourceRoot":"","sources":["../../../../../src/connectors/search/repositories/core/readable.ts"],"names":[],"mappings":"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"}

package/dist/connectors/sqlite/datasources/abstract.d.ts

@@ -0,0 +1,16 @@
+import type { TAnyDataSourceSchema } from '../../../base/datasources';
+import { BaseRelationalDataSource } from '../../../connectors/relational/datasources';
+import type { IRelationalQueryDialect, IRelationalQueryExecutor } from '../../../connectors/relational/repositories/common';
+import type { TSqliteConnector } from '../../../connectors/sqlite/drivers';
+/**
+ * SQLite branch root: supplies the SQLite dialect and executor on
+ * top of the engine-neutral `BaseRelationalDataSource`. The BEGIN
+ * statement stays abstract - `BaseSqliteDataSource` supplies it.
+ */
+export declare abstract class AbstractSqliteDataSource<Settings extends object = {}, Schema extends TAnyDataSourceSchema = TAnyDataSourceSchema, ConfigurableOptions extends object = {}, Client = unknown> extends BaseRelationalDataSource<Settings, Schema, ConfigurableOptions, Client, TSqliteConnector<Schema>> {
+    private static queryDialect?;
+    private static queryExecutor?;
+    getQueryDialect(): IRelationalQueryDialect;
+    getQueryExecutor(): IRelationalQueryExecutor<TSqliteConnector<Schema>>;
+}
+//# sourceMappingURL=abstract.d.ts.map

package/dist/connectors/sqlite/datasources/abstract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"abstract.d.ts","sourceRoot":"","sources":["../../../../src/connectors/sqlite/datasources/abstract.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,EAAE,wBAAwB,EAAE,MAAM,qCAAqC,CAAC;AAC/E,OAAO,KAAK,EACV,uBAAuB,EACvB,wBAAwB,EACzB,MAAM,6CAA6C,CAAC;AACrD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAIpE;;;;GAIG;AACH,8BAAsB,wBAAwB,CAC5C,QAAQ,SAAS,MAAM,GAAG,EAAE,EAC5B,MAAM,SAAS,oBAAoB,GAAG,oBAAoB,EAC1D,mBAAmB,SAAS,MAAM,GAAG,EAAE,EACvC,MAAM,GAAG,OAAO,CAChB,SAAQ,wBAAwB,CAChC,QAAQ,EACR,MAAM,EACN,mBAAmB,EACnB,MAAM,EACN,gBAAgB,CAAC,MAAM,CAAC,CACzB;IACC,OAAO,CAAC,MAAM,CAAC,YAAY,CAAC,CAA0B;IACtD,OAAO,CAAC,MAAM,CAAC,aAAa,CAAC,CAA6C;IAEjE,eAAe,IAAI,uBAAuB;IAK1C,gBAAgB,IAAI,wBAAwB,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC;CAMhF"}

package/dist/connectors/sqlite/datasources/abstract.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AbstractSqliteDataSource = void 0;
+const datasources_1 = require("../../../connectors/relational/datasources");
+const executor_1 = require("../../../connectors/sqlite/repositories/executor");
+const query_dialect_1 = require("../../../connectors/sqlite/repositories/dialect/query-dialect");
+/**
+ * SQLite branch root: supplies the SQLite dialect and executor on
+ * top of the engine-neutral `BaseRelationalDataSource`. The BEGIN
+ * statement stays abstract - `BaseSqliteDataSource` supplies it.
+ */
+class AbstractSqliteDataSource extends datasources_1.BaseRelationalDataSource {
+    getQueryDialect() {
+        AbstractSqliteDataSource.queryDialect ??= new query_dialect_1.SqliteQueryDialect();
+        return AbstractSqliteDataSource.queryDialect;
+    }
+    getQueryExecutor() {
+        AbstractSqliteDataSource.queryExecutor ??= new executor_1.SqliteQueryExecutor();
+        return AbstractSqliteDataSource.queryExecutor;
+    }
+}
+exports.AbstractSqliteDataSource = AbstractSqliteDataSource;
+//# sourceMappingURL=abstract.js.map

package/dist/connectors/sqlite/datasources/abstract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"abstract.js","sourceRoot":"","sources":["../../../../src/connectors/sqlite/datasources/abstract.ts"],"names":[],"mappings":";;;AACA,qEAA+E;AAM/E,wEAAgF;AAChF,0FAA4F;AAE5F;;;;GAIG;AACH,MAAsB,wBAKpB,SAAQ,sCAMT;IAIU,eAAe;QACtB,wBAAwB,CAAC,YAAY,KAAK,IAAI,kCAAkB,EAAE,CAAC;QACnE,OAAO,wBAAwB,CAAC,YAAY,CAAC;IAC/C,CAAC;IAEQ,gBAAgB;QACvB,wBAAwB,CAAC,aAAa,KAAK,IAAI,8BAAmB,EAAE,CAAC;QACrE,OAAO,wBAAwB,CAAC,aAE/B,CAAC;IACJ,CAAC;CACF;AA1BD,4DA0BC"}

package/dist/connectors/sqlite/datasources/base.d.ts

@@ -0,0 +1,30 @@
+import type { TAnyDataSourceSchema } from '../../../base/datasources';
+import type { ValueOrPromise } from '@venizia/ignis-helpers';
+import { AbstractSqliteDataSource } from './abstract';
+import type { ISqliteDataSourceSettings, ISqliteTransaction, ISqliteTransactionOptions } from './common';
+/**
+ * SQLite's half of the transaction seam: supplies the BEGIN statement the inherited
+ * `beginTransaction()` delegates to, then attaches `beginMode` - a SQLite-only field the neutral
+ * `IRelationalTransaction` has no concept of.
+ */
+export declare abstract class BaseSqliteDataSource<Settings extends object = ISqliteDataSourceSettings, Schema extends TAnyDataSourceSchema = TAnyDataSourceSchema, ConfigurableOptions extends object = {}, Client = unknown> extends AbstractSqliteDataSource<Settings, Schema, ConfigurableOptions, Client> {
+    private resolveBeginMode;
+    /**
+     * The driver runs the BEGIN verbatim and never parameterized, so an
+     * unchecked mode is raw interpolation into SQL. Matched as written -
+     * SQLite's keywords are upper-case and nothing here normalises them.
+     */
+    private assertBeginMode;
+    /**
+     * `beginTransaction()` settles the mode before delegating here; the assertion still runs so a
+     * subclass calling this directly cannot interpolate an unchecked mode.
+     */
+    protected buildBeginStatement(opts?: ISqliteTransactionOptions): string;
+    beginTransaction(opts?: ISqliteTransactionOptions): Promise<ISqliteTransaction<Schema>>;
+    /**
+     * libsql's url IS SQLite's connection string; an app
+     * whose settings spell it differently overrides this.
+     */
+    getConnectionString(): ValueOrPromise<string>;
+}
+//# sourceMappingURL=base.d.ts.map

package/dist/connectors/sqlite/datasources/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../../src/connectors/sqlite/datasources/base.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAE7D,OAAO,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AACtD,OAAO,KAAK,EACV,yBAAyB,EACzB,kBAAkB,EAClB,yBAAyB,EAE1B,MAAM,UAAU,CAAC;AAGlB;;;;GAIG;AACH,8BAAsB,oBAAoB,CACxC,QAAQ,SAAS,MAAM,GAAG,yBAAyB,EACnD,MAAM,SAAS,oBAAoB,GAAG,oBAAoB,EAC1D,mBAAmB,SAAS,MAAM,GAAG,EAAE,EACvC,MAAM,GAAG,OAAO,CAChB,SAAQ,wBAAwB,CAAC,QAAQ,EAAE,MAAM,EAAE,mBAAmB,EAAE,MAAM,CAAC;IAC/E,OAAO,CAAC,gBAAgB;IAiBxB;;;;OAIG;IACH,OAAO,CAAC,eAAe;IAYvB;;;OAGG;cACgB,mBAAmB,CAAC,IAAI,CAAC,EAAE,yBAAyB,GAAG,MAAM;IAQjE,gBAAgB,CAC7B,IAAI,CAAC,EAAE,yBAAyB,GAC/B,OAAO,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC;IActC;;;OAGG;IACM,mBAAmB,IAAI,cAAc,CAAC,MAAM,CAAC;CAWvD"}

package/dist/connectors/sqlite/datasources/base.js

@@ -0,0 +1,78 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseSqliteDataSource = void 0;
+const utilities_1 = require("../../../utilities");
+const ignis_helpers_1 = require("@venizia/ignis-helpers");
+const abstract_1 = require("./abstract");
+const common_1 = require("./common");
+/**
+ * SQLite's half of the transaction seam: supplies the BEGIN statement the inherited
+ * `beginTransaction()` delegates to, then attaches `beginMode` - a SQLite-only field the neutral
+ * `IRelationalTransaction` has no concept of.
+ */
+class BaseSqliteDataSource extends abstract_1.AbstractSqliteDataSource {
+    resolveBeginMode(opts) {
+        // Silently ignoring it would leave the caller believing SERIALIZABLE was honoured; every SQLite
+        // transaction already is, so there is nothing to map it onto.
+        if (opts?.isolationLevel) {
+            (0, utilities_1.throwNotSupported)({
+                scope: this.constructor.name,
+                feature: `Isolation level '${opts.isolationLevel}' - SQLite has no isolation levels; pass \`beginMode\` (${common_1.SqliteBeginModes.DEFERRED} | ${common_1.SqliteBeginModes.IMMEDIATE} | ${common_1.SqliteBeginModes.EXCLUSIVE}) instead`,
+                logger: this.logger,
+            });
+        }
+        // IMMEDIATE, not DEFERRED: a deferred transaction takes its write lock at
+        // the first write, and that upgrade fails outright with SQLITE_BUSY when
+        // another writer got there first, where IMMEDIATE waits on the busy timeout.
+        return this.assertBeginMode({ beginMode: opts?.beginMode ?? common_1.SqliteBeginModes.IMMEDIATE });
+    }
+    /**
+     * The driver runs the BEGIN verbatim and never parameterized, so an
+     * unchecked mode is raw interpolation into SQL. Matched as written -
+     * SQLite's keywords are upper-case and nothing here normalises them.
+     */
+    assertBeginMode(opts) {
+        const { beginMode } = opts;
+        if (!common_1.SqliteBeginModes.isValid(beginMode)) {
+            throw (0, ignis_helpers_1.getError)({
+                message: `[${this.constructor.name}][assertBeginMode] Unknown beginMode '${beginMode}' | Expected ${common_1.SqliteBeginModes.DEFERRED} | ${common_1.SqliteBeginModes.IMMEDIATE} | ${common_1.SqliteBeginModes.EXCLUSIVE}`,
+            });
+        }
+        return beginMode;
+    }
+    /**
+     * `beginTransaction()` settles the mode before delegating here; the assertion still runs so a
+     * subclass calling this directly cannot interpolate an unchecked mode.
+     */
+    buildBeginStatement(opts) {
+        const beginMode = this.assertBeginMode({
+            beginMode: opts?.beginMode ?? common_1.SqliteBeginModes.IMMEDIATE,
+        });
+        return `BEGIN ${beginMode}`;
+    }
+    async beginTransaction(opts) {
+        // Resolved once and handed down, so the refusal paths run a single time per
+        // transaction rather than once here and once inside buildBeginStatement().
+        const beginMode = this.resolveBeginMode(opts);
+        const beginOptions = { ...opts, beginMode };
+        const transaction = await super.beginTransaction(beginOptions);
+        // Annotated so `TSqliteBeginMode` survives fresh-object-literal widening back to `string`.
+        const patch = { beginMode };
+        return Object.assign(transaction, patch);
+    }
+    /**
+     * libsql's url IS SQLite's connection string; an app
+     * whose settings spell it differently overrides this.
+     */
+    getConnectionString() {
+        const { url } = this.settings;
+        if (!url) {
+            throw (0, ignis_helpers_1.getError)({
+                message: `[${this.constructor.name}][getConnectionString] No 'url' in settings | Carry the libsql url in config (\`:memory:\`, \`file:./data.db\`, \`libsql://...\`), or override getConnectionString()`,
+            });
+        }
+        return url;
+    }
+}
+exports.BaseSqliteDataSource = BaseSqliteDataSource;
+//# sourceMappingURL=base.js.map

package/dist/connectors/sqlite/datasources/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../../../src/connectors/sqlite/datasources/base.ts"],"names":[],"mappings":";;;AACA,2CAAgD;AAEhD,0DAAkD;AAClD,yCAAsD;AAOtD,qCAA4C;AAE5C;;;;GAIG;AACH,MAAsB,oBAKpB,SAAQ,mCAAuE;IACvE,gBAAgB,CAAC,IAAgC;QACvD,gGAAgG;QAChG,8DAA8D;QAC9D,IAAI,IAAI,EAAE,cAAc,EAAE,CAAC;YACzB,IAAA,6BAAiB,EAAC;gBAChB,KAAK,EAAE,IAAI,CAAC,WAAW,CAAC,IAAI;gBAC5B,OAAO,EAAE,oBAAoB,IAAI,CAAC,cAAc,2DAA2D,yBAAgB,CAAC,QAAQ,MAAM,yBAAgB,CAAC,SAAS,MAAM,yBAAgB,CAAC,SAAS,WAAW;gBAC/M,MAAM,EAAE,IAAI,CAAC,MAAM;aACpB,CAAC,CAAC;QACL,CAAC;QAED,0EAA0E;QAC1E,yEAAyE;QACzE,6EAA6E;QAC7E,OAAO,IAAI,CAAC,eAAe,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,IAAI,yBAAgB,CAAC,SAAS,EAAE,CAAC,CAAC;IAC5F,CAAC;IAED;;;;OAIG;IACK,eAAe,CAAC,IAA2B;QACjD,MAAM,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC;QAE3B,IAAI,CAAC,yBAAgB,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;YACzC,MAAM,IAAA,wBAAQ,EAAC;gBACb,OAAO,EAAE,IAAI,IAAI,CAAC,WAAW,CAAC,IAAI,yCAAyC,SAAS,gBAAgB,yBAAgB,CAAC,QAAQ,MAAM,yBAAgB,CAAC,SAAS,MAAM,yBAAgB,CAAC,SAAS,EAAE;aAChM,CAAC,CAAC;QACL,CAAC;QAED,OAAO,SAA6B,CAAC;IACvC,CAAC;IAED;;;OAGG;IACgB,mBAAmB,CAAC,IAAgC;QACrE,MAAM,SAAS,GAAG,IAAI,CAAC,eAAe,CAAC;YACrC,SAAS,EAAE,IAAI,EAAE,SAAS,IAAI,yBAAgB,CAAC,SAAS;SACzD,CAAC,CAAC;QAEH,OAAO,SAAS,SAAS,EAAE,CAAC;IAC9B,CAAC;IAEQ,KAAK,CAAC,gBAAgB,CAC7B,IAAgC;QAEhC,4EAA4E;QAC5E,2EAA2E;QAC3E,MAAM,SAAS,GAAG,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC;QAE9C,MAAM,YAAY,GAA8B,EAAE,GAAG,IAAI,EAAE,SAAS,EAAE,CAAC;QACvE,MAAM,WAAW,GAAG,MAAM,KAAK,CAAC,gBAAgB,CAAC,YAAY,CAAC,CAAC;QAE/D,2FAA2F;QAC3F,MAAM,KAAK,GAAoC,EAAE,SAAS,EAAE,CAAC;QAE7D,OAAO,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;IAC3C,CAAC;IAED;;;OAGG;IACM,mBAAmB;QAC1B,MAAM,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,QAA8C,CAAC;QAEpE,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,MAAM,IAAA,wBAAQ,EAAC;gBACb,OAAO,EAAE,IAAI,IAAI,CAAC,WAAW,CAAC,IAAI,sKAAsK;aACzM,CAAC,CAAC;QACL,CAAC;QAED,OAAO,GAAG,CAAC;IACb,CAAC;CACF;AAnFD,oDAmFC"}

package/dist/connectors/sqlite/datasources/common/guards.d.ts

@@ -0,0 +1,8 @@
+import type { ITransaction } from '../../../../base/datasources';
+import type { ISqliteTransaction } from './types';
+/**
+ * Narrows the neutral `ITransaction` to the SQLite handle before accessing `.connector`.
+ * The runtime check is the neutral guard's; only the narrowed type differs.
+ */
+export declare const isSqliteTransaction: (transaction: ITransaction | undefined) => transaction is ISqliteTransaction;
+//# sourceMappingURL=guards.d.ts.map

package/dist/connectors/sqlite/datasources/common/guards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guards.d.ts","sourceRoot":"","sources":["../../../../../src/connectors/sqlite/datasources/common/guards.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAElD;;;GAGG;AACH,eAAO,MAAM,mBAAmB,GAC9B,aAAa,YAAY,GAAG,SAAS,KACpC,WAAW,IAAI,kBAEjB,CAAC"}

package/dist/connectors/sqlite/datasources/common/guards.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isSqliteTransaction = void 0;
+const common_1 = require("../../../../connectors/relational/datasources/common");
+/**
+ * Narrows the neutral `ITransaction` to the SQLite handle before accessing `.connector`.
+ * The runtime check is the neutral guard's; only the narrowed type differs.
+ */
+const isSqliteTransaction = (transaction) => {
+    return (0, common_1.isRelationalTransaction)(transaction);
+};
+exports.isSqliteTransaction = isSqliteTransaction;
+//# sourceMappingURL=guards.js.map

package/dist/connectors/sqlite/datasources/common/guards.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guards.js","sourceRoot":"","sources":["../../../../../src/connectors/sqlite/datasources/common/guards.ts"],"names":[],"mappings":";;;AACA,uEAAqF;AAGrF;;;GAGG;AACI,MAAM,mBAAmB,GAAG,CACjC,WAAqC,EACF,EAAE;IACrC,OAAO,IAAA,gCAAuB,EAAC,WAAW,CAAC,CAAC;AAC9C,CAAC,CAAC;AAJW,QAAA,mBAAmB,uBAI9B"}

package/dist/connectors/sqlite/datasources/common/index.d.ts

@@ -0,0 +1,3 @@
+export * from './guards';
+export * from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/connectors/sqlite/datasources/common/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/connectors/sqlite/datasources/common/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC"}

package/dist/connectors/sqlite/datasources/common/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./guards"), exports);
+__exportStar(require("./types"), exports);
+//# sourceMappingURL=index.js.map

package/dist/connectors/sqlite/datasources/common/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/connectors/sqlite/datasources/common/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2CAAyB;AACzB,0CAAwB"}

package/dist/connectors/sqlite/datasources/common/types.d.ts

@@ -0,0 +1,48 @@
+import type { TAnyDataSourceSchema } from '../../../../base/datasources';
+import type { IRelationalDataSource, IRelationalTransaction, TRelationalTransactionOptions } from '../../../../connectors/relational/datasources/common';
+import type { IRelationalQueryDialect } from '../../../../connectors/relational/repositories/common';
+import type { TSqliteConnector } from '../../../../connectors/sqlite/drivers';
+import type { TConstValue } from '@venizia/ignis-helpers';
+/**
+ * SQLite's BEGIN axis is a locking mode, not an isolation level - every SQLite transaction is
+ * serializable, so there is no level left to choose.
+ */
+export declare class SqliteBeginModes {
+    static readonly DEFERRED = "DEFERRED";
+    static readonly IMMEDIATE = "IMMEDIATE";
+    static readonly EXCLUSIVE = "EXCLUSIVE";
+    static readonly SCHEME_SET: Set<string>;
+    static isValid(value: string): boolean;
+}
+export type TSqliteBeginMode = TConstValue<typeof SqliteBeginModes>;
+/** SQLite transaction options: a locking mode where Postgres takes an isolation level. */
+export interface ISqliteTransactionOptions extends TRelationalTransactionOptions {
+    beginMode?: TSqliteBeginMode;
+}
+/**
+ * SQLite narrowing: pins the transaction's connector to an async
+ * `BaseSQLiteDatabase` and requires a resolved locking mode. `connector`,
+ * `commit()` and `rollback()` come from `IRelationalTransaction`.
+ */
+export interface ISqliteTransaction<Schema extends TAnyDataSourceSchema = TAnyDataSourceSchema> extends IRelationalTransaction<TSqliteConnector<Schema>> {
+    beginMode: TSqliteBeginMode;
+}
+/**
+ * SQLite narrowing of `IRelationalDataSource`. `Client` stays `unknown` rather than defaulting to
+ * libsql's `Client` the way Postgres defaults to `pg.Pool`: `@libsql/client` is an optional peer,
+ * and naming its type here would make the `@venizia/ignis/sqlite` declarations unusable without it.
+ */
+export interface ISqliteDataSource<Settings extends object = {}, Schema extends TAnyDataSourceSchema = TAnyDataSourceSchema, ConfigurableOptions extends object = {}, Client = unknown> extends IRelationalDataSource<Settings, Schema, ConfigurableOptions, Client, TSqliteConnector<Schema>> {
+    getQueryDialect(): IRelationalQueryDialect;
+    beginTransaction(opts?: ISqliteTransactionOptions): Promise<ISqliteTransaction<Schema>>;
+}
+/**
+ * The settings `getConnectionString()` reads by default
+ * - libsql's url IS SQLite's connection string.
+ */
+export interface ISqliteDataSourceSettings {
+    /** `:memory:`, `file:./data.db`, `libsql://<host>` or an embedded-replica url. */
+    url: string;
+    authToken?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/connectors/sqlite/datasources/common/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/connectors/sqlite/datasources/common/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,KAAK,EACV,qBAAqB,EACrB,sBAAsB,EACtB,6BAA6B,EAC9B,MAAM,4CAA4C,CAAC;AACpD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,6CAA6C,CAAC;AAC3F,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAE1D;;;GAGG;AACH,qBAAa,gBAAgB;IAC3B,MAAM,CAAC,QAAQ,CAAC,QAAQ,cAAc;IACtC,MAAM,CAAC,QAAQ,CAAC,SAAS,eAAe;IACxC,MAAM,CAAC,QAAQ,CAAC,SAAS,eAAe;IAExC,MAAM,CAAC,QAAQ,CAAC,UAAU,cAA4D;IAEtF,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;CAGvC;AAED,MAAM,MAAM,gBAAgB,GAAG,WAAW,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAEpE,0FAA0F;AAC1F,MAAM,WAAW,yBAA0B,SAAQ,6BAA6B;IAC9E,SAAS,CAAC,EAAE,gBAAgB,CAAC;CAC9B;AAED;;;;GAIG;AACH,MAAM,WAAW,kBAAkB,CACjC,MAAM,SAAS,oBAAoB,GAAG,oBAAoB,CAC1D,SAAQ,sBAAsB,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC;IACxD,SAAS,EAAE,gBAAgB,CAAC;CAC7B;AAED;;;;GAIG;AACH,MAAM,WAAW,iBAAiB,CAChC,QAAQ,SAAS,MAAM,GAAG,EAAE,EAC5B,MAAM,SAAS,oBAAoB,GAAG,oBAAoB,EAC1D,mBAAmB,SAAS,MAAM,GAAG,EAAE,EACvC,MAAM,GAAG,OAAO,CAChB,SAAQ,qBAAqB,CAC7B,QAAQ,EACR,MAAM,EACN,mBAAmB,EACnB,MAAM,EACN,gBAAgB,CAAC,MAAM,CAAC,CACzB;IACC,eAAe,IAAI,uBAAuB,CAAC;IAC3C,gBAAgB,CAAC,IAAI,CAAC,EAAE,yBAAyB,GAAG,OAAO,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC,CAAC;CACzF;AAED;;;GAGG;AACH,MAAM,WAAW,yBAAyB;IACxC,kFAAkF;IAClF,GAAG,EAAE,MAAM,CAAC;IAEZ,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB"}

package/dist/connectors/sqlite/datasources/common/types.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SqliteBeginModes = void 0;
+/**
+ * SQLite's BEGIN axis is a locking mode, not an isolation level - every SQLite transaction is
+ * serializable, so there is no level left to choose.
+ */
+class SqliteBeginModes {
+    static { this.DEFERRED = 'DEFERRED'; }
+    static { this.IMMEDIATE = 'IMMEDIATE'; }
+    static { this.EXCLUSIVE = 'EXCLUSIVE'; }
+    static { this.SCHEME_SET = new Set([this.DEFERRED, this.IMMEDIATE, this.EXCLUSIVE]); }
+    static isValid(value) {
+        return this.SCHEME_SET.has(value);
+    }
+}
+exports.SqliteBeginModes = SqliteBeginModes;
+//# sourceMappingURL=types.js.map

package/dist/connectors/sqlite/datasources/common/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../src/connectors/sqlite/datasources/common/types.ts"],"names":[],"mappings":";;;AAUA;;;GAGG;AACH,MAAa,gBAAgB;aACX,aAAQ,GAAG,UAAU,CAAC;aACtB,cAAS,GAAG,WAAW,CAAC;aACxB,cAAS,GAAG,WAAW,CAAC;aAExB,eAAU,GAAG,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC;IAEtF,MAAM,CAAC,OAAO,CAAC,KAAa;QAC1B,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC;;AATH,4CAUC"}

package/dist/connectors/sqlite/datasources/index.d.ts

@@ -0,0 +1,4 @@
+export * from './abstract';
+export * from './base';
+export * from './common';
+//# sourceMappingURL=index.d.ts.map

package/dist/connectors/sqlite/datasources/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/connectors/sqlite/datasources/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC"}

package/dist/connectors/sqlite/datasources/index.js

@@ -0,0 +1,20 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./abstract"), exports);
+__exportStar(require("./base"), exports);
+__exportStar(require("./common"), exports);
+//# sourceMappingURL=index.js.map

package/dist/connectors/sqlite/datasources/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/connectors/sqlite/datasources/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,6CAA2B;AAC3B,yCAAuB;AACvB,2CAAyB"}

package/dist/connectors/sqlite/drivers/driver.d.ts

@@ -0,0 +1,20 @@
+import type { TAnyDataSourceSchema } from '../../../base/datasources';
+import type { IRelationalConnection, IRelationalDriver } from '../../../connectors/relational/drivers';
+import type { AnyType } from '@venizia/ignis-helpers';
+import type { BaseSQLiteDatabase } from 'drizzle-orm/sqlite-core';
+export type { IStatementResult } from '../../../connectors/relational/drivers';
+/**
+ * Drizzle connector for any async SQLite driver. Result kind is pinned to `'async'` - a `'sync'`
+ * driver would block the event loop. The run-result type stays open: it is the one thing drivers
+ * disagree on, and pinning it would drag an optional peer's types into this tier.
+ */
+export type TSqliteConnector<DataSourceSchema extends TAnyDataSourceSchema = TAnyDataSourceSchema> = BaseSQLiteDatabase<'async', AnyType, DataSourceSchema>;
+/**
+ * SQLite narrowing: the neutral `IRelationalConnection<TConnector>` is parameterized by the
+ * connector type, not by `Schema`. Aliased rather than re-exported so callers keep writing
+ * `TSqliteConnection<Schema>` and getting `connector: TSqliteConnector<Schema>`.
+ */
+export type TSqliteConnection<Schema extends TAnyDataSourceSchema = TAnyDataSourceSchema> = IRelationalConnection<TSqliteConnector<Schema>>;
+/** SQLite narrowing: the connector is always an async `BaseSQLiteDatabase`. */
+export type TSqliteDriver<Schema extends TAnyDataSourceSchema = TAnyDataSourceSchema, Client = unknown> = IRelationalDriver<TSqliteConnector<Schema>, Client>;
+//# sourceMappingURL=driver.d.ts.map

package/dist/connectors/sqlite/drivers/driver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"driver.d.ts","sourceRoot":"","sources":["../../../../src/connectors/sqlite/drivers/driver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,KAAK,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AAChG,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAElE,YAAY,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAExE;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,CAAC,gBAAgB,SAAS,oBAAoB,GAAG,oBAAoB,IAC/F,kBAAkB,CAAC,OAAO,EAAE,OAAO,EAAE,gBAAgB,CAAC,CAAC;AAEzD;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,CAAC,MAAM,SAAS,oBAAoB,GAAG,oBAAoB,IACtF,qBAAqB,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC;AAElD,+EAA+E;AAC/E,MAAM,MAAM,aAAa,CACvB,MAAM,SAAS,oBAAoB,GAAG,oBAAoB,EAC1D,MAAM,GAAG,OAAO,IACd,iBAAiB,CAAC,gBAAgB,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC"}

package/dist/connectors/sqlite/drivers/driver.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=driver.js.map

package/dist/connectors/sqlite/drivers/driver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"driver.js","sourceRoot":"","sources":["../../../../src/connectors/sqlite/drivers/driver.ts"],"names":[],"mappings":""}