@venizia/ignis-connectors 0.2.0-0

package/dist/cjs/relational/sqlite/datasources/abstract.d.ts

@@ -0,0 +1,16 @@
+import type { TAnyDataSourceSchema } from '@venizia/ignis-kernel';
+import { BaseRelationalDataSource } from '../../../relational/core/datasources';
+import type { IRelationalQueryDialect, IRelationalQueryExecutor } from '../../../relational/core/repositories/common';
+import type { TSqliteConnector } from '../../../relational/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/cjs/relational/sqlite/datasources/abstract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"abstract.d.ts","sourceRoot":"","sources":["../../../../../src/relational/sqlite/datasources/abstract.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAClE,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AACzE,OAAO,KAAK,EACV,uBAAuB,EACvB,wBAAwB,EACzB,MAAM,uCAAuC,CAAC;AAC/C,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/cjs/relational/sqlite/datasources/abstract.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AbstractSqliteDataSource = void 0;
+const datasources_1 = require("../../../relational/core/datasources");
+const executor_1 = require("../../../relational/sqlite/repositories/executor");
+const query_dialect_1 = require("../../../relational/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/cjs/relational/sqlite/datasources/abstract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"abstract.js","sourceRoot":"","sources":["../../../../../src/relational/sqlite/datasources/abstract.ts"],"names":[],"mappings":";;;AACA,+DAAyE;AAMzE,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/cjs/relational/sqlite/datasources/base.d.ts

@@ -0,0 +1,30 @@
+import type { TAnyDataSourceSchema } from '@venizia/ignis-kernel';
+import type { ValueOrPromise } from '@venizia/ignis-helpers/common';
+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/cjs/relational/sqlite/datasources/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../../../src/relational/sqlite/datasources/base.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAElE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAEpE,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/cjs/relational/sqlite/datasources/base.js

@@ -0,0 +1,78 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseSqliteDataSource = void 0;
+const ignis_kernel_1 = require("@venizia/ignis-kernel");
+const core_1 = require("@venizia/ignis-helpers/core");
+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, ignis_kernel_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, core_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, core_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/cjs/relational/sqlite/datasources/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../../../../src/relational/sqlite/datasources/base.ts"],"names":[],"mappings":";;;AACA,wDAA0D;AAE1D,sDAAuD;AACvD,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,gCAAiB,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,eAAQ,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,eAAQ,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/cjs/relational/sqlite/datasources/common/guards.d.ts

@@ -0,0 +1,8 @@
+import type { ITransaction } from '@venizia/ignis-kernel';
+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/cjs/relational/sqlite/datasources/common/guards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guards.d.ts","sourceRoot":"","sources":["../../../../../../src/relational/sqlite/datasources/common/guards.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAE1D,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/cjs/relational/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("../../../../relational/core/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/cjs/relational/sqlite/datasources/common/guards.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guards.js","sourceRoot":"","sources":["../../../../../../src/relational/sqlite/datasources/common/guards.ts"],"names":[],"mappings":";;;AACA,iEAA+E;AAG/E;;;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/cjs/relational/sqlite/datasources/common/index.d.ts

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

package/dist/cjs/relational/sqlite/datasources/common/index.d.ts.map

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

package/dist/cjs/relational/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/cjs/relational/sqlite/datasources/common/index.js.map

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

package/dist/cjs/relational/sqlite/datasources/common/types.d.ts

@@ -0,0 +1,49 @@
+import type { TAnyDataSourceSchema } from '@venizia/ignis-kernel';
+import type { IRelationalDataSource, IRelationalTransaction, TRelationalTransactionOptions } from '../../../../relational/core/datasources/common';
+import type { IRelationalQueryDialect } from '../../../../relational/core/repositories/common';
+import type { TSqliteConnector } from '../../../../relational/sqlite/drivers';
+import type { TConstValue } from '@venizia/ignis-helpers/common';
+/**
+ * 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-connectors/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/cjs/relational/sqlite/datasources/common/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../src/relational/sqlite/datasources/common/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAClE,OAAO,KAAK,EACV,qBAAqB,EACrB,sBAAsB,EACtB,6BAA6B,EAC9B,MAAM,sCAAsC,CAAC;AAC9C,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,uCAAuC,CAAC;AACrF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAEjE;;;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;;;;;GAKG;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/cjs/relational/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/cjs/relational/sqlite/datasources/common/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../../src/relational/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/cjs/relational/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/cjs/relational/sqlite/datasources/index.d.ts.map

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

package/dist/cjs/relational/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/cjs/relational/sqlite/datasources/index.js.map

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

package/dist/cjs/relational/sqlite/drivers/driver.d.ts

@@ -0,0 +1,20 @@
+import type { TAnyDataSourceSchema } from '@venizia/ignis-kernel';
+import type { IRelationalConnection, IRelationalDriver } from '../../../relational/core/drivers';
+import type { AnyType } from '@venizia/ignis-helpers/common';
+import type { BaseSQLiteDatabase } from 'drizzle-orm/sqlite-core';
+export type { IStatementResult } from '../../../relational/core/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/cjs/relational/sqlite/drivers/driver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"driver.d.ts","sourceRoot":"","sources":["../../../../../src/relational/sqlite/drivers/driver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAClE,OAAO,KAAK,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC1F,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAC;AAC7D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAElE,YAAY,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAElE;;;;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/cjs/relational/sqlite/drivers/driver.js

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

package/dist/cjs/relational/sqlite/drivers/driver.js.map

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

package/dist/cjs/relational/sqlite/drivers/index.d.ts

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

package/dist/cjs/relational/sqlite/drivers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/relational/sqlite/drivers/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC"}

package/dist/cjs/relational/sqlite/drivers/index.js

@@ -0,0 +1,18 @@
+"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("./driver"), exports);
+//# sourceMappingURL=index.js.map

package/dist/cjs/relational/sqlite/drivers/index.js.map

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

package/dist/cjs/relational/sqlite/drivers/libsql.d.ts

@@ -0,0 +1,53 @@
+import type { TAnyDataSourceSchema } from '@venizia/ignis-kernel';
+import type { Client } from '@libsql/client';
+import type { IPoolControlOptions } from '@venizia/ignis-helpers/core';
+import type { TSqliteConnection, TSqliteConnector, TSqliteDriver } from './driver';
+/**
+ * Pool knobs the driver forwards, minus `size`: one slot
+ * IS the mutual exclusion a single connection lacks.
+ */
+export type TLibSqlDriverOptions = Omit<IPoolControlOptions, 'size'> & {
+    client: Client;
+};
+/**
+ * Covers `:memory:`, a local file, remote Turso and embedded replicas. Chosen over `better-sqlite3`
+ * and `bun:sqlite` for its async result kind - those block the event loop.
+ *
+ * `acquire()` takes a 1-slot pool, not a second connection: `drizzle()` binds to a `Client`, never
+ * to libsql's `Transaction`, and `client.transaction()` swaps the connection out - against
+ * `:memory:` that is a DIFFERENT empty database.
+ *
+ * Consequence: a query on the `createConnector()` connector while a transaction is open runs INSIDE
+ * it. Route work that must stay outside one through `acquire()`.
+ */
+export declare class LibSqlDriver<Schema extends TAnyDataSourceSchema = TAnyDataSourceSchema> implements TSqliteDriver<Schema, Client> {
+    private readonly client;
+    /**
+     * The pooled resource IS the single client, so `create()` always hands back the same instance.
+     * The pool contributes mutual exclusion, not connection multiplicity.
+     */
+    private readonly slot;
+    private readonly logger;
+    /**
+     * A leaked transaction never releases the one slot, so without a timeout every later `acquire()`
+     * in the process hangs forever and silently. 30s outlasts any honest SQLite write transaction -
+     * one writer at a time is the engine's own limit - and turns a leak into a named error.
+     */
+    static readonly DEFAULT_ACQUIRE_TIMEOUT_MS = 30000;
+    constructor(opts: TLibSqlDriverOptions);
+    createConnector(opts: {
+        schema: Schema;
+    }): TSqliteConnector<Schema>;
+    acquire(opts: {
+        schema: Schema;
+    }): Promise<TSqliteConnection<Schema>>;
+    getClient(): Client;
+    end(): Promise<void>;
+    /**
+     * The pool's destroy hook. A failed COMMIT/ROLLBACK may leave the connection inside a transaction
+     * and the next borrower would inherit it. The client offers no way to ask whether one is open, so
+     * the ROLLBACK is issued blind and its rejection is the ordinary answer of a clean connection.
+     */
+    private scrubSession;
+}
+//# sourceMappingURL=libsql.d.ts.map

package/dist/cjs/relational/sqlite/drivers/libsql.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"libsql.d.ts","sourceRoot":"","sources":["../../../../../src/relational/sqlite/drivers/libsql.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAElE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,KAAK,EAAW,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAIhF,OAAO,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAcnF;;;GAGG;AACH,MAAM,MAAM,oBAAoB,GAAG,IAAI,CAAC,mBAAmB,EAAE,MAAM,CAAC,GAAG;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAE1F;;;;;;;;;;GAUG;AACH,qBAAa,YAAY,CACvB,MAAM,SAAS,oBAAoB,GAAG,oBAAoB,CAC1D,YAAW,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC;IACxC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAEhC;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAyB;IAE9C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAU;IAEjC;;;;OAIG;IACH,MAAM,CAAC,QAAQ,CAAC,0BAA0B,SAAU;gBAExC,IAAI,EAAE,oBAAoB;IAgCtC,eAAe,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,gBAAgB,CAAC,MAAM,CAAC;IAI7D,OAAO,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAqE3E,SAAS,IAAI,MAAM;IAIb,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;IAK1B;;;;OAIG;YACW,YAAY;CAsB3B"}