@venizia/ignis-connectors 0.2.0-0

package/dist/esm/relational/postgres/repositories/executor.js

@@ -0,0 +1,151 @@
+import { getError } from '@venizia/ignis-helpers/core';
+import omit from 'lodash/omit';
+/**
+ * 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 class PostgresQueryExecutor {
+    async select(opts) {
+        const { connector, table, columns, where, orderBy, limit, offset, lock } = opts;
+        // Drizzle's `.from()` needs the concrete `PgTable` type, not the generic bound.
+        const pgTable = table;
+        let query = columns
+            ? connector
+                .select(columns)
+                .from(pgTable)
+                .$dynamic()
+            : connector.select().from(pgTable).$dynamic();
+        if (where) {
+            query = query.where(where);
+        }
+        if (orderBy && orderBy.length > 0) {
+            query = query.orderBy(...orderBy);
+        }
+        if (limit !== undefined) {
+            query = query.limit(limit);
+        }
+        if (offset !== undefined) {
+            query = query.offset(offset);
+        }
+        // `$dynamic()` infers its row type from the table schema, not from the caller-chosen R.
+        if (lock) {
+            return query.for(lock.strength, lock.config);
+        }
+        return query;
+    }
+    async count(opts) {
+        const { connector, table, where } = opts;
+        return connector.$count(table, where);
+    }
+    async findMany(opts) {
+        const queryInterface = this.getQueryInterface(opts);
+        // Drizzle's relational result (`PgRelationalQuery<{[x: string]: any}[]>`) does not overlap the
+        // caller-chosen R enough for a direct assertion.
+        return queryInterface.findMany(opts.query);
+    }
+    async findFirst(opts) {
+        const queryInterface = this.getQueryInterface(opts);
+        // Drizzle's `findFirst` config type structurally forbids `limit` - it always fetches one row.
+        // This is the only place that knows that, so the strip happens here whatever the caller passed.
+        const queryOptions = omit(opts.query, ['limit']);
+        const result = await queryInterface.findFirst(queryOptions);
+        // Same drizzle-relational-query-versus-caller-generic boundary as `findMany` above.
+        return (result ?? null);
+    }
+    async insert(opts) {
+        const { connector, table, values, returning, shouldReturn } = opts;
+        const query = connector.insert(table).values(values);
+        if (!shouldReturn) {
+            const result = await query;
+            return { count: this.readAffectedRowCount({ result }), rows: [] };
+        }
+        const rows = returning ? await query.returning(returning) : await query.returning();
+        return { count: rows.length, rows: rows };
+    }
+    async update(opts) {
+        const { connector, table, data, where, returning, shouldReturn } = opts;
+        const query = connector
+            .update(table)
+            .set(data)
+            .where(where);
+        if (!shouldReturn) {
+            const result = await query;
+            return { count: this.readAffectedRowCount({ result }), rows: [] };
+        }
+        const rows = returning ? await query.returning(returning) : await query.returning();
+        return { count: rows.length, rows: rows };
+    }
+    async remove(opts) {
+        const { connector, table, where, returning, shouldReturn } = opts;
+        const query = connector.delete(table).where(where);
+        if (!shouldReturn) {
+            const result = await query;
+            return { count: this.readAffectedRowCount({ result }), rows: [] };
+        }
+        const rows = returning ? await query.returning(returning) : await query.returning();
+        return { count: rows.length, rows: rows };
+    }
+    /**
+     * 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.
+     */
+    getQueryInterface(opts) {
+        const { connector, entityName } = opts;
+        const scope = opts.scope ?? this.constructor.name;
+        if (!connector.query) {
+            throw getError({
+                message: `[${scope}] Connector query interface not available | Ensure datasource is properly configured with schema`,
+            });
+        }
+        const queryInterface = connector.query[entityName];
+        if (!queryInterface) {
+            const availableKeys = Object.keys(connector.query);
+            throw getError({
+                message: `[${scope}] Schema key mismatch | Entity name '${entityName}' not found in connector.query | Available keys: [${availableKeys.join(', ')}] | Ensure the model's TABLE_NAME matches the schema registration key`,
+            });
+        }
+        return queryInterface;
+    }
+    /**
+     * Rows affected by a write executed without RETURNING. Reads `pg`'s `rowCount`, postgres-js's
+     * `count` or PGlite's `affectedRows` off the raw driver result - engine knowledge the shared
+     * repository tier must not hold.
+     */
+    readAffectedRowCount(opts) {
+        const { result } = opts;
+        // Drizzle resolves some statements to nothing at all; that counts as zero rows.
+        if (result === null || result === undefined) {
+            return 0;
+        }
+        if (typeof result !== 'object') {
+            throw getError({
+                message: `[readAffectedRowCount] Unrecognized driver result | expected pg.QueryResult, postgres-js RowList or a PGlite Results | got: ${typeof result}`,
+            });
+        }
+        const { rowCount, count, affectedRows } = result;
+        // node-postgres. `rowCount` is null for statements
+        // that affect no rows by definition (e.g. DDL).
+        if (typeof rowCount === 'number') {
+            return rowCount;
+        }
+        if (rowCount === null) {
+            return 0;
+        }
+        // postgres-js.
+        if (typeof count === 'number') {
+            return count;
+        }
+        // PGlite - it carries no `rowCount` at all, so without this
+        // branch every write with `shouldReturn: false` throws.
+        if (typeof affectedRows === 'number') {
+            return affectedRows;
+        }
+        throw getError({
+            message: `[readAffectedRowCount] Unrecognized driver result | expected 'rowCount' (node-postgres), 'count' (postgres-js) or 'affectedRows' (PGlite) | got keys: ${Object.keys(result).join(', ')}`,
+        });
+    }
+}
+//# sourceMappingURL=executor.js.map

package/dist/esm/relational/postgres/repositories/executor.js.map

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

package/dist/esm/relational/postgres/repositories/index.d.ts

@@ -0,0 +1,5 @@
+export * from './common/index.js';
+export * from './core/index.js';
+export * from './dialect/index.js';
+export * from './executor.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/relational/postgres/repositories/index.d.ts.map

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

package/dist/esm/relational/postgres/repositories/index.js

@@ -0,0 +1,7 @@
+export * from './common/index.js';
+export * from './core/index.js';
+export * from './dialect/index.js';
+// `getQueryExecutor()` is a required member of `IRelationalDataSource`, so an application with a
+// hand-rolled datasource needs this class from the public barrel, not a deep internal path.
+export * from './executor.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/relational/postgres/repositories/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/relational/postgres/repositories/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,QAAQ,CAAC;AACvB,cAAc,WAAW,CAAC;AAC1B,iGAAiG;AACjG,4FAA4F;AAC5F,cAAc,YAAY,CAAC"}

package/dist/esm/relational/postgres/supabase/index.d.ts

@@ -0,0 +1,4 @@
+export * from './pooler.js';
+export * from './rls.js';
+export { anonRole, authenticatedRole, authUid, authUsers, postgresRole, realtimeMessages, realtimeTopic, serviceRole, supabaseAuthAdminRole, } from 'drizzle-orm/supabase';
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/relational/postgres/supabase/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/relational/postgres/supabase/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,OAAO,CAAC;AAGtB,OAAO,EACL,QAAQ,EACR,iBAAiB,EACjB,OAAO,EACP,SAAS,EACT,YAAY,EACZ,gBAAgB,EAChB,aAAa,EACb,WAAW,EACX,qBAAqB,GACtB,MAAM,sBAAsB,CAAC"}

package/dist/esm/relational/postgres/supabase/index.js

@@ -0,0 +1,6 @@
+export * from './pooler.js';
+export * from './rls.js';
+// Supabase's own roles and table definitions, re-exported so a schema author has one import.
+export { anonRole, authenticatedRole, authUid, authUsers, postgresRole, realtimeMessages, realtimeTopic, serviceRole, supabaseAuthAdminRole, } from 'drizzle-orm/supabase';
+// Reachable only via `@venizia/ignis-connectors/postgres/supabase`: `postgres/index.ts` must not re-export this module, or every entry point would pull in `drizzle-orm/supabase`.
+//# sourceMappingURL=index.js.map

package/dist/esm/relational/postgres/supabase/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/relational/postgres/supabase/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,OAAO,CAAC;AAEtB,6FAA6F;AAC7F,OAAO,EACL,QAAQ,EACR,iBAAiB,EACjB,OAAO,EACP,SAAS,EACT,YAAY,EACZ,gBAAgB,EAChB,aAAa,EACb,WAAW,EACX,qBAAqB,GACtB,MAAM,sBAAsB,CAAC;AAE9B,mLAAmL"}

package/dist/esm/relational/postgres/supabase/pooler.d.ts

@@ -0,0 +1,20 @@
+import type { TConstValue } from '@venizia/ignis-helpers/common';
+/** How the app reaches Supabase. Direct and session pooler are 5432; transaction pooler is 6543. */
+export declare class PoolerModes {
+    static readonly DIRECT = "direct";
+    static readonly SESSION = "session";
+    static readonly TRANSACTION = "transaction";
+    static readonly SCHEME_SET: Set<string>;
+    static isValid(value: string): value is TPoolerMode;
+}
+export type TPoolerMode = TConstValue<typeof PoolerModes>;
+export interface IPostgresJsOptions {
+    prepare: boolean;
+    max?: number;
+}
+/** Supavisor's TRANSACTION mode rebinds the backend connection per transaction, so server-side prepared statements do not survive - `prepare: false` is required there, not a tuning knob. `max` is forwarded only when supplied; postgres-js has its own default. */
+export declare const buildPostgresJsOptions: (opts: {
+    mode: TPoolerMode;
+    max?: number;
+}) => IPostgresJsOptions;
+//# sourceMappingURL=pooler.d.ts.map

package/dist/esm/relational/postgres/supabase/pooler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pooler.d.ts","sourceRoot":"","sources":["../../../../../src/relational/postgres/supabase/pooler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAGjE,oGAAoG;AACpG,qBAAa,WAAW;IACtB,MAAM,CAAC,QAAQ,CAAC,MAAM,YAAY;IAClC,MAAM,CAAC,QAAQ,CAAC,OAAO,aAAa;IACpC,MAAM,CAAC,QAAQ,CAAC,WAAW,iBAAiB;IAE5C,MAAM,CAAC,QAAQ,CAAC,UAAU,cAAkE;IAE5F,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,WAAW;CAGpD;AAED,MAAM,MAAM,WAAW,GAAG,WAAW,CAAC,OAAO,WAAW,CAAC,CAAC;AAE1D,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,sQAAsQ;AACtQ,eAAO,MAAM,sBAAsB,GAAI,MAAM;IAC3C,IAAI,EAAE,WAAW,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,KAAG,kBAgBH,CAAC"}

package/dist/esm/relational/postgres/supabase/pooler.js

@@ -0,0 +1,26 @@
+import { getError } from '@venizia/ignis-helpers/core';
+/** How the app reaches Supabase. Direct and session pooler are 5432; transaction pooler is 6543. */
+export class PoolerModes {
+    static { this.DIRECT = 'direct'; }
+    static { this.SESSION = 'session'; }
+    static { this.TRANSACTION = 'transaction'; }
+    static { this.SCHEME_SET = new Set([this.DIRECT, this.SESSION, this.TRANSACTION]); }
+    static isValid(value) {
+        return this.SCHEME_SET.has(value);
+    }
+}
+/** Supavisor's TRANSACTION mode rebinds the backend connection per transaction, so server-side prepared statements do not survive - `prepare: false` is required there, not a tuning knob. `max` is forwarded only when supplied; postgres-js has its own default. */
+export const buildPostgresJsOptions = (opts) => {
+    const { mode, max } = opts;
+    if (!PoolerModes.isValid(mode)) {
+        throw getError({
+            message: `[buildPostgresJsOptions] Unknown pooler mode '${mode}' | Expected one of: ${[...PoolerModes.SCHEME_SET].join(', ')}`,
+        });
+    }
+    const options = { prepare: mode !== PoolerModes.TRANSACTION };
+    if (max !== undefined) {
+        options.max = max;
+    }
+    return options;
+};
+//# sourceMappingURL=pooler.js.map

package/dist/esm/relational/postgres/supabase/pooler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pooler.js","sourceRoot":"","sources":["../../../../../src/relational/postgres/supabase/pooler.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAEvD,oGAAoG;AACpG,MAAM,OAAO,WAAW;aACN,WAAM,GAAG,QAAQ,CAAC;aAClB,YAAO,GAAG,SAAS,CAAC;aACpB,gBAAW,GAAG,aAAa,CAAC;aAE5B,eAAU,GAAG,IAAI,GAAG,CAAS,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC;IAE5F,MAAM,CAAC,OAAO,CAAC,KAAa;QAC1B,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC;;AAUH,sQAAsQ;AACtQ,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,IAGtC,EAAsB,EAAE;IACvB,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IAE3B,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QAC/B,MAAM,QAAQ,CAAC;YACb,OAAO,EAAE,iDAAiD,IAAI,wBAAwB,CAAC,GAAG,WAAW,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;SAC/H,CAAC,CAAC;IACL,CAAC;IAED,MAAM,OAAO,GAAuB,EAAE,OAAO,EAAE,IAAI,KAAK,WAAW,CAAC,WAAW,EAAE,CAAC;IAElF,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;QACtB,OAAO,CAAC,GAAG,GAAG,GAAG,CAAC;IACpB,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC"}

package/dist/esm/relational/postgres/supabase/rls.d.ts

@@ -0,0 +1,8 @@
+import type { IDatabaseTransaction } from '../../../relational/postgres/datasources/index.js';
+/** Sets the Supabase auth context for THIS transaction so `auth.uid()` resolves in RLS policies. `SET LOCAL` only - plain `SET` would leak the identity to the connection's next borrower under a pooler. `role` defaults to the JWT's own `role` claim, the only default that cannot contradict `request.jwt.claims`. */
+export declare const withAuthContext: (opts: {
+    transaction: IDatabaseTransaction;
+    claims: Record<string, unknown>;
+    role?: string;
+}) => Promise<void>;
+//# sourceMappingURL=rls.d.ts.map

package/dist/esm/relational/postgres/supabase/rls.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rls.d.ts","sourceRoot":"","sources":["../../../../../src/relational/postgres/supabase/rls.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAO9E,0TAA0T;AAC1T,eAAO,MAAM,eAAe,GAAU,MAAM;IAC1C,WAAW,EAAE,oBAAoB,CAAC;IAClC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,KAAG,OAAO,CAAC,IAAI,CAmBf,CAAC"}

package/dist/esm/relational/postgres/supabase/rls.js

@@ -0,0 +1,20 @@
+import { getError } from '@venizia/ignis-helpers/core';
+import { sql } from 'drizzle-orm';
+/** A bare Postgres role identifier. Anything else cannot be safely interpolated. */
+const ROLE_PATTERN = /^[a-z_][a-z0-9_]*$/;
+/** Sets the Supabase auth context for THIS transaction so `auth.uid()` resolves in RLS policies. `SET LOCAL` only - plain `SET` would leak the identity to the connection's next borrower under a pooler. `role` defaults to the JWT's own `role` claim, the only default that cannot contradict `request.jwt.claims`. */
+export const withAuthContext = async (opts) => {
+    const { transaction, claims } = opts;
+    const roleClaim = claims['role'];
+    const role = opts.role ?? (typeof roleClaim === 'string' ? roleClaim : undefined);
+    // `set local role $1` is not valid SQL, so the role is interpolated - unvalidated that is a privilege-escalation vector. Validated before any statement runs, so a rejected call leaves the session untouched.
+    if (!role || !ROLE_PATTERN.test(role)) {
+        throw getError({
+            message: `[withAuthContext] Invalid role '${role ?? ''}' | Pass role explicitly or include a string 'role' claim | A role must match ${String(ROLE_PATTERN)}`,
+        });
+    }
+    // `claims` IS parameterizable, so it is bound rather than interpolated.
+    await transaction.connector.execute(sql `select set_config('request.jwt.claims', ${JSON.stringify(claims)}, true)`);
+    await transaction.connector.execute(sql.raw(`set local role ${role}`));
+};
+//# sourceMappingURL=rls.js.map

package/dist/esm/relational/postgres/supabase/rls.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rls.js","sourceRoot":"","sources":["../../../../../src/relational/postgres/supabase/rls.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AACvD,OAAO,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AAElC,oFAAoF;AACpF,MAAM,YAAY,GAAG,oBAAoB,CAAC;AAE1C,0TAA0T;AAC1T,MAAM,CAAC,MAAM,eAAe,GAAG,KAAK,EAAE,IAIrC,EAAiB,EAAE;IAClB,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAErC,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;IACjC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,CAAC,OAAO,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAElF,+MAA+M;IAC/M,IAAI,CAAC,IAAI,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACtC,MAAM,QAAQ,CAAC;YACb,OAAO,EAAE,mCAAmC,IAAI,IAAI,EAAE,iFAAiF,MAAM,CAAC,YAAY,CAAC,EAAE;SAC9J,CAAC,CAAC;IACL,CAAC;IAED,wEAAwE;IACxE,MAAM,WAAW,CAAC,SAAS,CAAC,OAAO,CACjC,GAAG,CAAA,2CAA2C,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,SAAS,CAC9E,CAAC;IAEF,MAAM,WAAW,CAAC,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,kBAAkB,IAAI,EAAE,CAAC,CAAC,CAAC;AACzE,CAAC,CAAC"}

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

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

@@ -0,0 +1,19 @@
+import { BaseRelationalDataSource } from '../../../relational/core/datasources/index.js';
+import { SqliteQueryExecutor } from '../../../relational/sqlite/repositories/executor.js';
+import { SqliteQueryDialect } from '../../../relational/sqlite/repositories/dialect/query-dialect.js';
+/**
+ * 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 class AbstractSqliteDataSource extends BaseRelationalDataSource {
+    getQueryDialect() {
+        AbstractSqliteDataSource.queryDialect ??= new SqliteQueryDialect();
+        return AbstractSqliteDataSource.queryDialect;
+    }
+    getQueryExecutor() {
+        AbstractSqliteDataSource.queryExecutor ??= new SqliteQueryExecutor();
+        return AbstractSqliteDataSource.queryExecutor;
+    }
+}
+//# sourceMappingURL=abstract.js.map

package/dist/esm/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,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAMzE,OAAO,EAAE,mBAAmB,EAAE,MAAM,2CAA2C,CAAC;AAChF,OAAO,EAAE,kBAAkB,EAAE,MAAM,wDAAwD,CAAC;AAE5F;;;;GAIG;AACH,MAAM,OAAgB,wBAKpB,SAAQ,wBAMT;IAIU,eAAe;QACtB,wBAAwB,CAAC,YAAY,KAAK,IAAI,kBAAkB,EAAE,CAAC;QACnE,OAAO,wBAAwB,CAAC,YAAY,CAAC;IAC/C,CAAC;IAEQ,gBAAgB;QACvB,wBAAwB,CAAC,aAAa,KAAK,IAAI,mBAAmB,EAAE,CAAC;QACrE,OAAO,wBAAwB,CAAC,aAE/B,CAAC;IACJ,CAAC;CACF"}

package/dist/esm/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.js';
+import type { ISqliteDataSourceSettings, ISqliteTransaction, ISqliteTransactionOptions } from './common/index.js';
+/**
+ * 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/esm/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/esm/relational/sqlite/datasources/base.js

@@ -0,0 +1,74 @@
+import { throwNotSupported } from '@venizia/ignis-kernel';
+import { getError } from '@venizia/ignis-helpers/core';
+import { AbstractSqliteDataSource } from './abstract.js';
+import { SqliteBeginModes } from './common/index.js';
+/**
+ * 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 class BaseSqliteDataSource extends 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) {
+            throwNotSupported({
+                scope: this.constructor.name,
+                feature: `Isolation level '${opts.isolationLevel}' - SQLite has no isolation levels; pass \`beginMode\` (${SqliteBeginModes.DEFERRED} | ${SqliteBeginModes.IMMEDIATE} | ${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 ?? 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 (!SqliteBeginModes.isValid(beginMode)) {
+            throw getError({
+                message: `[${this.constructor.name}][assertBeginMode] Unknown beginMode '${beginMode}' | Expected ${SqliteBeginModes.DEFERRED} | ${SqliteBeginModes.IMMEDIATE} | ${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 ?? 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 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;
+    }
+}
+//# sourceMappingURL=base.js.map

package/dist/esm/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,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE1D,OAAO,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AACvD,OAAO,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAOtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAE5C;;;;GAIG;AACH,MAAM,OAAgB,oBAKpB,SAAQ,wBAAuE;IACvE,gBAAgB,CAAC,IAAgC;QACvD,gGAAgG;QAChG,8DAA8D;QAC9D,IAAI,IAAI,EAAE,cAAc,EAAE,CAAC;YACzB,iBAAiB,CAAC;gBAChB,KAAK,EAAE,IAAI,CAAC,WAAW,CAAC,IAAI;gBAC5B,OAAO,EAAE,oBAAoB,IAAI,CAAC,cAAc,2DAA2D,gBAAgB,CAAC,QAAQ,MAAM,gBAAgB,CAAC,SAAS,MAAM,gBAAgB,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,gBAAgB,CAAC,SAAS,EAAE,CAAC,CAAC;IAC5F,CAAC;IAED;;;;OAIG;IACK,eAAe,CAAC,IAA2B;QACjD,MAAM,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC;QAE3B,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;YACzC,MAAM,QAAQ,CAAC;gBACb,OAAO,EAAE,IAAI,IAAI,CAAC,WAAW,CAAC,IAAI,yCAAyC,SAAS,gBAAgB,gBAAgB,CAAC,QAAQ,MAAM,gBAAgB,CAAC,SAAS,MAAM,gBAAgB,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,gBAAgB,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,QAAQ,CAAC;gBACb,OAAO,EAAE,IAAI,IAAI,CAAC,WAAW,CAAC,IAAI,sKAAsK;aACzM,CAAC,CAAC;QACL,CAAC;QAED,OAAO,GAAG,CAAC;IACb,CAAC;CACF"}

package/dist/esm/relational/sqlite/datasources/common/guards.d.ts

@@ -0,0 +1,8 @@
+import type { ITransaction } from '@venizia/ignis-kernel';
+import type { ISqliteTransaction } from './types.js';
+/**
+ * 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/esm/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/esm/relational/sqlite/datasources/common/guards.js

@@ -0,0 +1,9 @@
+import { isRelationalTransaction } from '../../../../relational/core/datasources/common/index.js';
+/**
+ * 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 const isSqliteTransaction = (transaction) => {
+    return isRelationalTransaction(transaction);
+};
+//# sourceMappingURL=guards.js.map

package/dist/esm/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,OAAO,EAAE,uBAAuB,EAAE,MAAM,sCAAsC,CAAC;AAG/E;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CACjC,WAAqC,EACF,EAAE;IACrC,OAAO,uBAAuB,CAAC,WAAW,CAAC,CAAC;AAC9C,CAAC,CAAC"}

package/dist/esm/relational/sqlite/datasources/common/index.d.ts

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

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

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

package/dist/esm/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,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC"}

package/dist/esm/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/index.js';
+import type { IRelationalQueryDialect } from '../../../../relational/core/repositories/common/index.js';
+import type { TSqliteConnector } from '../../../../relational/sqlite/drivers/index.js';
+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/esm/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/esm/relational/sqlite/datasources/common/types.js

@@ -0,0 +1,14 @@
+/**
+ * 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 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);
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/esm/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,MAAM,OAAO,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"}

package/dist/esm/relational/sqlite/datasources/index.d.ts

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

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

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

package/dist/esm/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,cAAc,YAAY,CAAC;AAC3B,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC"}