@venizia/ignis-connectors 0.2.0-0

package/dist/esm/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/index.js';
+import type { AnyType } from '@venizia/ignis-helpers/common';
+import type { BaseSQLiteDatabase } from 'drizzle-orm/sqlite-core';
+export type { IStatementResult } from '../../../relational/core/drivers/index.js';
+/**
+ * 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/esm/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/esm/relational/sqlite/drivers/driver.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=driver.js.map

package/dist/esm/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/esm/relational/sqlite/drivers/index.d.ts

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

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

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

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

package/dist/esm/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.js';
+/**
+ * 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/esm/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"}

package/dist/esm/relational/sqlite/drivers/libsql.js

@@ -0,0 +1,153 @@
+import { throwNotSupported } from '@venizia/ignis-kernel';
+import { BaseHelper, BasePoolHelper, getError } from '@venizia/ignis-helpers/core';
+import { drizzle } from 'drizzle-orm/libsql';
+/**
+ * libsql's own name for a local database file, the
+ * only protocol whose statements share a connection.
+ */
+const FILE_PROTOCOL = 'file';
+/**
+ * SQLite rejects ROLLBACK outside a transaction rather
+ * than treating it as a no-op the way Postgres does.
+ */
+const NO_ACTIVE_TRANSACTION = 'no transaction is active';
+/**
+ * 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 class LibSqlDriver {
+    /**
+     * 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 { this.DEFAULT_ACQUIRE_TIMEOUT_MS = 30_000; }
+    constructor(opts) {
+        const { client, acquireTimeoutMs, maxWaitingClients, scope } = opts;
+        // A `bun:sqlite` / better-sqlite3 Database leads with prepare()/exec() and has none
+        // of these, so the wrong driver class fails here rather than at the first query.
+        const isLibSqlClient = typeof client?.execute === 'function' &&
+            typeof client?.batch === 'function' &&
+            typeof client?.transaction === 'function' &&
+            typeof client?.protocol === 'string';
+        if (!isLibSqlClient) {
+            throw getError({
+                message: `[${LibSqlDriver.name}] Expected an \`@libsql/client\` Client | Got a client without execute()/batch()/transaction() - a \`bun:sqlite\` Database? | Construct \`createClient({ url: 'file:./data.db' })\``,
+            });
+        }
+        this.client = client;
+        // Not `LoggerFactory`: it reaches the helpers root barrel, which pulls `ioredis` and fails a
+        // browser bundle on `tls`.
+        this.logger = new BaseHelper({ scope: LibSqlDriver.name }).getLogger();
+        this.slot = new BasePoolHelper({
+            size: 1,
+            acquireTimeoutMs: acquireTimeoutMs ?? LibSqlDriver.DEFAULT_ACQUIRE_TIMEOUT_MS,
+            maxWaitingClients,
+            scope: scope ?? LibSqlDriver.name,
+            create: () => this.client,
+            destroy: resource => this.scrubSession({ resource }),
+        });
+    }
+    createConnector(opts) {
+        return drizzle({ client: this.client, schema: opts.schema });
+    }
+    async acquire(opts) {
+        // A remote client opens a stream per statement and closes it, so BEGIN would neither hold nor
+        // error - the transaction would silently not exist.
+        if (this.client.protocol !== FILE_PROTOCOL) {
+            throwNotSupported({
+                scope: LibSqlDriver.name,
+                feature: `Explicit transactions over a '${this.client.protocol}' libsql client - every statement runs on its own connection, so BEGIN cannot hold; use a \`file:\` or \`:memory:\` url, or an embedded replica`,
+                logger: this.logger,
+            });
+        }
+        let client;
+        // The bare pool error names only a timeout; on one connection the cause is almost always an
+        // unreleased transaction, so say so where the caller reads it.
+        try {
+            client = await this.slot.acquire();
+        }
+        catch (error) {
+            throw getError({
+                message: `[${LibSqlDriver.name}][acquire] Could not borrow the single libsql connection | ${error?.message ?? String(error)} | An unreleased transaction still holds it - commit/rollback it, or raise \`acquireTimeoutMs\``,
+            });
+        }
+        let connector;
+        try {
+            connector = drizzle({ client, schema: opts.schema });
+        }
+        catch (error) {
+            this.slot.release({ resource: client });
+            throw error;
+        }
+        // Every borrower gets the SAME object, so a stale handle releasing twice would hand the
+        // slot away underneath whoever holds it now. The latch makes the second release a no-op.
+        let isReleased = false;
+        return {
+            connector,
+            execute: async (executeOpts) => {
+                const result = await client.execute(executeOpts.statement);
+                return { count: result.rowsAffected ?? 0 };
+            },
+            query: async (queryOpts) => {
+                const result = await client.execute(queryOpts.statement);
+                return (result.rows ?? []);
+            },
+            release: (releaseOpts) => {
+                if (isReleased) {
+                    return;
+                }
+                isReleased = true;
+                if (releaseOpts?.destroy !== true) {
+                    this.slot.release({ resource: client });
+                    return;
+                }
+                // Discard cannot throw the connection away - there is one client and no
+                // replacement. The slot is re-created from the same instance after the destroy
+                // hook scrubs it, so the next waiter never inherits an unknown transaction.
+                this.slot.discard({ resource: client }).catch(error => {
+                    this.logger.for('release').error('Failed to discard the libsql slot | Error: %s', error);
+                });
+            },
+        };
+    }
+    getClient() {
+        return this.client;
+    }
+    async end() {
+        await this.slot.destroy();
+        this.client.close();
+    }
+    /**
+     * 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.
+     */
+    async scrubSession(opts) {
+        const { resource } = opts;
+        if (resource.closed) {
+            return;
+        }
+        try {
+            await resource.execute('ROLLBACK');
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            if (message.includes(NO_ACTIVE_TRANSACTION)) {
+                this.logger.for(this.scrubSession.name).debug('Nothing to scrub | %s', message);
+                return;
+            }
+            this.logger
+                .for(this.scrubSession.name)
+                .warn('Failed to scrub the libsql session | Error: %s', error);
+        }
+    }
+}
+//# sourceMappingURL=libsql.js.map

package/dist/esm/relational/sqlite/drivers/libsql.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"libsql.js","sourceRoot":"","sources":["../../../../../src/relational/sqlite/drivers/libsql.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAI1D,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AACnF,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAG7C;;;GAGG;AACH,MAAM,aAAa,GAAG,MAAM,CAAC;AAE7B;;;GAGG;AACH,MAAM,qBAAqB,GAAG,0BAA0B,CAAC;AAQzD;;;;;;;;;;GAUG;AACH,MAAM,OAAO,YAAY;IAavB;;;;OAIG;aACa,+BAA0B,GAAG,MAAM,CAAC;IAEpD,YAAY,IAA0B;QACpC,MAAM,EAAE,MAAM,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;QAEpE,oFAAoF;QACpF,iFAAiF;QACjF,MAAM,cAAc,GAClB,OAAQ,MAAkB,EAAE,OAAO,KAAK,UAAU;YAClD,OAAQ,MAAkB,EAAE,KAAK,KAAK,UAAU;YAChD,OAAQ,MAAkB,EAAE,WAAW,KAAK,UAAU;YACtD,OAAQ,MAAkB,EAAE,QAAQ,KAAK,QAAQ,CAAC;QAEpD,IAAI,CAAC,cAAc,EAAE,CAAC;YACpB,MAAM,QAAQ,CAAC;gBACb,OAAO,EAAE,IAAI,YAAY,CAAC,IAAI,qLAAqL;aACpN,CAAC,CAAC;QACL,CAAC;QAED,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,6FAA6F;QAC7F,2BAA2B;QAC3B,IAAI,CAAC,MAAM,GAAG,IAAI,UAAU,CAAC,EAAE,KAAK,EAAE,YAAY,CAAC,IAAI,EAAE,CAAC,CAAC,SAAS,EAAE,CAAC;QAEvE,IAAI,CAAC,IAAI,GAAG,IAAI,cAAc,CAAS;YACrC,IAAI,EAAE,CAAC;YACP,gBAAgB,EAAE,gBAAgB,IAAI,YAAY,CAAC,0BAA0B;YAC7E,iBAAiB;YACjB,KAAK,EAAE,KAAK,IAAI,YAAY,CAAC,IAAI;YACjC,MAAM,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM;YACzB,OAAO,EAAE,QAAQ,CAAC,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,EAAE,QAAQ,EAAE,CAAC;SACrD,CAAC,CAAC;IACL,CAAC;IAED,eAAe,CAAC,IAAwB;QACtC,OAAO,OAAO,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IAC/D,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,IAAwB;QACpC,8FAA8F;QAC9F,oDAAoD;QACpD,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ,KAAK,aAAa,EAAE,CAAC;YAC3C,iBAAiB,CAAC;gBAChB,KAAK,EAAE,YAAY,CAAC,IAAI;gBACxB,OAAO,EAAE,iCAAiC,IAAI,CAAC,MAAM,CAAC,QAAQ,iJAAiJ;gBAC/M,MAAM,EAAE,IAAI,CAAC,MAAM;aACpB,CAAC,CAAC;QACL,CAAC;QAED,IAAI,MAAc,CAAC;QAEnB,4FAA4F;QAC5F,+DAA+D;QAC/D,IAAI,CAAC;YACH,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;QACrC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,QAAQ,CAAC;gBACb,OAAO,EAAE,IAAI,YAAY,CAAC,IAAI,8DAA+D,KAAe,EAAE,OAAO,IAAI,MAAM,CAAC,KAAK,CAAC,iGAAiG;aACxO,CAAC,CAAC;QACL,CAAC;QAED,IAAI,SAAmC,CAAC;QACxC,IAAI,CAAC;YACH,SAAS,GAAG,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;QACvD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;YACxC,MAAM,KAAK,CAAC;QACd,CAAC;QAED,wFAAwF;QACxF,yFAAyF;QACzF,IAAI,UAAU,GAAG,KAAK,CAAC;QAEvB,OAAO;YACL,SAAS;YAET,OAAO,EAAE,KAAK,EAAE,WAAkC,EAAE,EAAE;gBACpD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;gBAC3D,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,YAAY,IAAI,CAAC,EAAE,CAAC;YAC7C,CAAC;YAED,KAAK,EAAE,KAAK,EAAK,SAAgC,EAAE,EAAE;gBACnD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;gBACzD,OAAO,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE,CAAa,CAAC;YACzC,CAAC;YAED,OAAO,EAAE,CAAC,WAAmC,EAAE,EAAE;gBAC/C,IAAI,UAAU,EAAE,CAAC;oBACf,OAAO;gBACT,CAAC;gBACD,UAAU,GAAG,IAAI,CAAC;gBAElB,IAAI,WAAW,EAAE,OAAO,KAAK,IAAI,EAAE,CAAC;oBAClC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;oBACxC,OAAO;gBACT,CAAC;gBAED,wEAAwE;gBACxE,+EAA+E;gBAC/E,4EAA4E;gBAC5E,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE;oBACpD,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,+CAA+C,EAAE,KAAK,CAAC,CAAC;gBAC3F,CAAC,CAAC,CAAC;YACL,CAAC;SACF,CAAC;IACJ,CAAC;IAED,SAAS;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,KAAK,CAAC,GAAG;QACP,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;QAC1B,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;IACtB,CAAC;IAED;;;;OAIG;IACK,KAAK,CAAC,YAAY,CAAC,IAA0B;QACnD,MAAM,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC;QAE1B,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC;YACpB,OAAO;QACT,CAAC;QAED,IAAI,CAAC;YACH,MAAM,QAAQ,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QACrC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAEvE,IAAI,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAC,EAAE,CAAC;gBAC5C,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,uBAAuB,EAAE,OAAO,CAAC,CAAC;gBAChF,OAAO;YACT,CAAC;YAED,IAAI,CAAC,MAAM;iBACR,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC;iBAC3B,IAAI,CAAC,gDAAgD,EAAE,KAAK,CAAC,CAAC;QACnE,CAAC;IACH,CAAC"}

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

@@ -0,0 +1,5 @@
+export * from './datasources/index.js';
+export * from './drivers/index.js';
+export * from './models/index.js';
+export * from './repositories/index.js';
+//# sourceMappingURL=index.d.ts.map

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

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

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

@@ -0,0 +1,5 @@
+export * from './datasources/index.js';
+export * from './drivers/index.js';
+export * from './models/index.js';
+export * from './repositories/index.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/relational/sqlite/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC"}

package/dist/esm/relational/sqlite/models/base.d.ts

@@ -0,0 +1,10 @@
+import { BaseRelationalEntity } from '../../../relational/core/models/base.js';
+import type { TTableSchemaWithId } from './common/index.js';
+/**
+ * SQLite-bound entity base. The narrowed `Schema` keeps this barrel's `TTableObject` /
+ * `TTableInsert` intersectable with a subclass's own schema type; the neutral `Table`-branded
+ * bound would leave them uncomposable (TS2344).
+ */
+export declare class BaseSqliteEntity<Schema extends TTableSchemaWithId = TTableSchemaWithId> extends BaseRelationalEntity<Schema> {
+}
+//# sourceMappingURL=base.d.ts.map

package/dist/esm/relational/sqlite/models/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../../../src/relational/sqlite/models/base.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAEnD;;;;GAIG;AACH,qBAAa,gBAAgB,CAC3B,MAAM,SAAS,kBAAkB,GAAG,kBAAkB,CACtD,SAAQ,oBAAoB,CAAC,MAAM,CAAC;CAAG"}

package/dist/esm/relational/sqlite/models/base.js

@@ -0,0 +1,9 @@
+import { BaseRelationalEntity } from '../../../relational/core/models/base.js';
+/**
+ * SQLite-bound entity base. The narrowed `Schema` keeps this barrel's `TTableObject` /
+ * `TTableInsert` intersectable with a subclass's own schema type; the neutral `Table`-branded
+ * bound would leave them uncomposable (TS2344).
+ */
+export class BaseSqliteEntity extends BaseRelationalEntity {
+}
+//# sourceMappingURL=base.js.map

package/dist/esm/relational/sqlite/models/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../../../../src/relational/sqlite/models/base.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAGrE;;;;GAIG;AACH,MAAM,OAAO,gBAEX,SAAQ,oBAA4B;CAAG"}

package/dist/esm/relational/sqlite/models/common/columns.d.ts

@@ -0,0 +1,18 @@
+/**
+ * No date storage class - timestamps live in `text`, normalized
+ * to ISO 8601 both ways so comparisons stay lexicographic.
+ */
+export declare const isoTimestamp: (name: string) => import("drizzle-orm/sqlite-core").SQLiteCustomColumnBuilder<{
+    name: string;
+    dataType: "custom";
+    columnType: "SQLiteCustomColumn";
+    data: string;
+    driverParam: string;
+    enumValues: undefined;
+}>;
+/**
+ * SQLite `DEFAULT` takes an expression only in parentheses, and `CURRENT_TIMESTAMP` would yield
+ * second-resolution text that `isoTimestamp` does not round-trip.
+ */
+export declare const ISO_TIMESTAMP_NOW = "(strftime('%Y-%m-%dT%H:%M:%fZ', 'now'))";
+//# sourceMappingURL=columns.d.ts.map

package/dist/esm/relational/sqlite/models/common/columns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"columns.d.ts","sourceRoot":"","sources":["../../../../../../src/relational/sqlite/models/common/columns.ts"],"names":[],"mappings":"AAWA;;;GAGG;AACH,eAAO,MAAM,YAAY,GAAI,MAAM,MAAM;;;;;;;EA6BxC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,iBAAiB,4CAA4C,CAAC"}

package/dist/esm/relational/sqlite/models/common/columns.js

@@ -0,0 +1,43 @@
+import { getError } from '@venizia/ignis-helpers/core';
+import { HTTP } from '@venizia/ignis-helpers/common';
+import { customType } from 'drizzle-orm/sqlite-core';
+/**
+ * A date-time with no zone designator - what SQLite's own
+ * `CURRENT_TIMESTAMP` writes. It is UTC by SQLite's definition, but `Date`
+ * would read it as host-local, so the offset is pinned on the way in.
+ */
+const ZONELESS_DATE_TIME = /^(\d{4}-\d{2}-\d{2})[T ](\d{2}:\d{2}(?::\d{2}(?:\.\d+)?)?)$/;
+/**
+ * No date storage class - timestamps live in `text`, normalized
+ * to ISO 8601 both ways so comparisons stay lexicographic.
+ */
+export const isoTimestamp = (name) => {
+    return customType({
+        dataType() {
+            return 'text';
+        },
+        toDriver(value) {
+            if (value instanceof Date) {
+                return value.toISOString();
+            }
+            return value;
+        },
+        fromDriver(value) {
+            const zoneless = ZONELESS_DATE_TIME.exec(value);
+            const date = new Date(zoneless ? `${zoneless[1]}T${zoneless[2]}Z` : value);
+            if (isNaN(date.getTime())) {
+                throw getError({
+                    message: `Invalid date string: ${value}`,
+                    statusCode: HTTP.ResultCodes.RS_5.InternalServerError,
+                });
+            }
+            return date.toISOString();
+        },
+    })(name);
+};
+/**
+ * SQLite `DEFAULT` takes an expression only in parentheses, and `CURRENT_TIMESTAMP` would yield
+ * second-resolution text that `isoTimestamp` does not round-trip.
+ */
+export const ISO_TIMESTAMP_NOW = `(strftime('%Y-%m-%dT%H:%M:%fZ', 'now'))`;
+//# sourceMappingURL=columns.js.map

package/dist/esm/relational/sqlite/models/common/columns.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"columns.js","sourceRoot":"","sources":["../../../../../../src/relational/sqlite/models/common/columns.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AACvD,OAAO,EAAE,IAAI,EAAE,MAAM,+BAA+B,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAErD;;;;GAIG;AACH,MAAM,kBAAkB,GAAG,6DAA6D,CAAC;AAEzF;;;GAGG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,IAAY,EAAE,EAAE;IAC3C,OAAO,UAAU,CAGd;QACD,QAAQ;YACN,OAAO,MAAM,CAAC;QAChB,CAAC;QACD,QAAQ,CAAC,KAAoB;YAC3B,IAAI,KAAK,YAAY,IAAI,EAAE,CAAC;gBAC1B,OAAO,KAAK,CAAC,WAAW,EAAE,CAAC;YAC7B,CAAC;YAED,OAAO,KAAK,CAAC;QACf,CAAC;QACD,UAAU,CAAC,KAAa;YACtB,MAAM,QAAQ,GAAG,kBAAkB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAChD,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;YAE3E,IAAI,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;gBAC1B,MAAM,QAAQ,CAAC;oBACb,OAAO,EAAE,wBAAwB,KAAK,EAAE;oBACxC,UAAU,EAAE,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,mBAAmB;iBACtD,CAAC,CAAC;YACL,CAAC;YAED,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC;QAC5B,CAAC;KACF,CAAC,CAAC,IAAI,CAAC,CAAC;AACX,CAAC,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,yCAAyC,CAAC"}

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

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

package/dist/esm/relational/sqlite/models/common/index.d.ts.map

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

package/dist/esm/relational/sqlite/models/common/index.js

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

package/dist/esm/relational/sqlite/models/common/index.js.map

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

package/dist/esm/relational/sqlite/models/common/types.d.ts

@@ -0,0 +1,88 @@
+import type { IdType } from '@venizia/ignis-kernel';
+import type { TRelationConfig } from '../../../../relational/core/repositories/common/index.js';
+import type { TValueOrResolver } from '@venizia/ignis-helpers/common';
+import type { IsPrimaryKey, NotNull } from 'drizzle-orm';
+import type { AnySQLiteColumn, SQLiteColumnBuilderBase, SQLiteTable, TableConfig } from 'drizzle-orm/sqlite-core';
+export type TColumnDefinition = SQLiteColumnBuilderBase;
+export type TColumnDefinitions = {
+    [field: string | symbol]: TColumnDefinition;
+};
+export type TPrimaryKey<T extends TColumnDefinition> = IsPrimaryKey<NotNull<T>>;
+export type TIdColumn = AnySQLiteColumn<{
+    data: IdType;
+}>;
+export type TTableSchemaWithId<TC extends TableConfig = TableConfig> = SQLiteTable<TC> & {
+    id: TIdColumn;
+};
+export type TTableObject<T extends TTableSchemaWithId> = T['$inferSelect'];
+export type TGetIdType<T extends TTableSchemaWithId> = TTableObject<T>['id'];
+export { getIdType } from '../../../../relational/core/models/common/types.js';
+export type TTableInsert<T extends TTableSchemaWithId> = T['$inferInsert'];
+/** Static schema + relations contract every entity model implements. */
+export interface IEntity<Schema extends TTableSchemaWithId = TTableSchemaWithId> {
+    TABLE_NAME?: string;
+    schema: Schema;
+    relations?: TValueOrResolver<Array<TRelationConfig>>;
+}
+export type TDataTypeEnricherOptions = {
+    defaultValue: Partial<{
+        dataType: string;
+        nValue: number;
+        tValue: string;
+        bValue: Buffer;
+        jValue: object;
+        boValue: boolean;
+    }>;
+};
+/**
+ * SQLite has no sequences or identity columns - an integer primary key is the table's rowid, which
+ * the engine assigns. `autoIncrement` maps to `AUTOINCREMENT`, which additionally forbids reusing a
+ * deleted row's id, matching Postgres `generatedAlwaysAsIdentity`.
+ */
+export type TIdEnricherOptions = {
+    id?: {
+        dataType: 'string';
+        generator?: () => string;
+    } | {
+        dataType: 'number';
+        autoIncrement?: boolean;
+    };
+};
+export type TPrincipalEnricherOptions<Discriminator extends string = string, PolymorphicIdType extends 'number' | 'string' = 'number' | 'string', Nullable extends boolean = false> = {
+    discriminator?: Discriminator;
+    defaultPolymorphic?: string;
+    polymorphicIdType: PolymorphicIdType;
+    isNullableId?: Nullable;
+};
+/**
+ * No `withTimezone` twin of the Postgres options: with no `timestamptz`, every timestamp is an ISO
+ * 8601 UTC string carrying its own offset. Omitting `enable` opts the column IN - only
+ * `enable: false` drops it. Omitting the key keeps the default: `modified` on, `deleted` off.
+ */
+export type TTzEnricherOptions = {
+    created?: {
+        columnName: string;
+    };
+    modified?: {
+        enable: false;
+    } | {
+        enable?: true;
+        columnName: string;
+    };
+    deleted?: {
+        enable: false;
+    } | {
+        enable?: true;
+        columnName: string;
+    };
+};
+export type TUserAuditColumnOpts = {
+    dataType: 'string' | 'number';
+    columnName: string;
+    allowAnonymous?: boolean;
+};
+export type TUserAuditEnricherOptions = {
+    created?: TUserAuditColumnOpts;
+    modified?: TUserAuditColumnOpts;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/esm/relational/sqlite/models/common/types.d.ts.map

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

package/dist/esm/relational/sqlite/models/common/types.js

@@ -0,0 +1,4 @@
+// The neutral constraint is `Table`-branded, so it is wider than the `SQLiteTable`-branded one here
+// and every sqlite caller still satisfies it.
+export { getIdType } from '../../../../relational/core/models/common/types.js';
+//# sourceMappingURL=types.js.map

package/dist/esm/relational/sqlite/models/common/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../../src/relational/sqlite/models/common/types.ts"],"names":[],"mappings":"AA6BA,oGAAoG;AACpG,8CAA8C;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,uCAAuC,CAAC"}

package/dist/esm/relational/sqlite/models/enrichers/data-type.enricher.d.ts

@@ -0,0 +1,22 @@
+import type { TColumnDefinitions, TDataTypeEnricherOptions } from '../common/types.js';
+/**
+ * Storage-class mapping of the Postgres twin: `double precision` -> `real`, `bytea` -> `blob`,
+ * `boolean` -> `integer` 0/1, `jsonb` -> text-mode json so `json_extract` / `->>` can read it.
+ */
+export declare const generateDataTypeColumnDefs: (opts?: TDataTypeEnricherOptions) => {
+    dataType: import("drizzle-orm/sqlite-core").SQLiteTextBuilderInitial<"data_type", [string, ...string[]], number | undefined>;
+    nValue: import("drizzle-orm/sqlite-core").SQLiteRealBuilderInitial<"n_value">;
+    tValue: import("drizzle-orm/sqlite-core").SQLiteTextBuilderInitial<"t_value", [string, ...string[]], number | undefined>;
+    bValue: import("drizzle-orm/sqlite-core").SQLiteBlobBufferBuilderInitial<"b_value">;
+    jValue: import("drizzle-orm").$Type<import("drizzle-orm/sqlite-core").SQLiteTextJsonBuilderInitial<"j_value">, Record<string, any>>;
+    boValue: import("drizzle-orm/sqlite-core").SQLiteBooleanBuilderInitial<"bo_value">;
+};
+export declare const enrichDataTypes: (baseSchema: TColumnDefinitions, opts?: TDataTypeEnricherOptions) => {
+    dataType: import("drizzle-orm/sqlite-core").SQLiteTextBuilderInitial<"data_type", [string, ...string[]], number | undefined>;
+    nValue: import("drizzle-orm/sqlite-core").SQLiteRealBuilderInitial<"n_value">;
+    tValue: import("drizzle-orm/sqlite-core").SQLiteTextBuilderInitial<"t_value", [string, ...string[]], number | undefined>;
+    bValue: import("drizzle-orm/sqlite-core").SQLiteBlobBufferBuilderInitial<"b_value">;
+    jValue: import("drizzle-orm").$Type<import("drizzle-orm/sqlite-core").SQLiteTextJsonBuilderInitial<"j_value">, Record<string, any>>;
+    boValue: import("drizzle-orm/sqlite-core").SQLiteBooleanBuilderInitial<"bo_value">;
+};
+//# sourceMappingURL=data-type.enricher.d.ts.map

package/dist/esm/relational/sqlite/models/enrichers/data-type.enricher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-type.enricher.d.ts","sourceRoot":"","sources":["../../../../../../src/relational/sqlite/models/enrichers/data-type.enricher.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAEpF;;;GAGG;AACH,eAAO,MAAM,0BAA0B,GAAI,OAAO,wBAAwB;;;;;;;CAgCzE,CAAC;AAEF,eAAO,MAAM,eAAe,GAC1B,YAAY,kBAAkB,EAC9B,OAAO,wBAAwB;;;;;;;CAKhC,CAAC"}

package/dist/esm/relational/sqlite/models/enrichers/data-type.enricher.js

@@ -0,0 +1,36 @@
+import { blob, integer, real, text } from 'drizzle-orm/sqlite-core';
+/**
+ * Storage-class mapping of the Postgres twin: `double precision` -> `real`, `bytea` -> `blob`,
+ * `boolean` -> `integer` 0/1, `jsonb` -> text-mode json so `json_extract` / `->>` can read it.
+ */
+export const generateDataTypeColumnDefs = (opts) => {
+    const { defaultValue } = opts ?? {};
+    // Gate on presence, not truthiness - `0`, `''` and `false` are legitimate defaults.
+    return {
+        dataType: defaultValue?.dataType !== undefined
+            ? text('data_type').default(defaultValue.dataType)
+            : text('data_type'),
+        nValue: defaultValue?.nValue !== undefined
+            ? real('n_value').default(defaultValue.nValue)
+            : real('n_value'),
+        tValue: defaultValue?.tValue !== undefined
+            ? text('t_value').default(defaultValue.tValue)
+            : text('t_value'),
+        bValue: defaultValue?.bValue !== undefined
+            ? blob('b_value', { mode: 'buffer' }).default(defaultValue.bValue)
+            : blob('b_value', { mode: 'buffer' }),
+        jValue: defaultValue?.jValue !== undefined
+            ? text('j_value', { mode: 'json' })
+                .default(defaultValue.jValue)
+                .$type()
+            : text('j_value', { mode: 'json' }).$type(),
+        boValue: defaultValue?.boValue !== undefined
+            ? integer('bo_value', { mode: 'boolean' }).default(defaultValue.boValue)
+            : integer('bo_value', { mode: 'boolean' }),
+    };
+};
+export const enrichDataTypes = (baseSchema, opts) => {
+    const defs = generateDataTypeColumnDefs(opts);
+    return { ...baseSchema, ...defs };
+};
+//# sourceMappingURL=data-type.enricher.js.map

package/dist/esm/relational/sqlite/models/enrichers/data-type.enricher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-type.enricher.js","sourceRoot":"","sources":["../../../../../../src/relational/sqlite/models/enrichers/data-type.enricher.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,yBAAyB,CAAC;AAGpE;;;GAGG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,IAA+B,EAAE,EAAE;IAC5E,MAAM,EAAE,YAAY,EAAE,GAAG,IAAI,IAAI,EAAE,CAAC;IAEpC,oFAAoF;IACpF,OAAO;QACL,QAAQ,EACN,YAAY,EAAE,QAAQ,KAAK,SAAS;YAClC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,QAAQ,CAAC;YAClD,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC;QACvB,MAAM,EACJ,YAAY,EAAE,MAAM,KAAK,SAAS;YAChC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,MAAM,CAAC;YAC9C,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC;QACrB,MAAM,EACJ,YAAY,EAAE,MAAM,KAAK,SAAS;YAChC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,MAAM,CAAC;YAC9C,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC;QACrB,MAAM,EACJ,YAAY,EAAE,MAAM,KAAK,SAAS;YAChC,CAAC,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,MAAM,CAAC;YAClE,CAAC,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;QACzC,MAAM,EACJ,YAAY,EAAE,MAAM,KAAK,SAAS;YAChC,CAAC,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;iBAC9B,OAAO,CAAC,YAAY,CAAC,MAAM,CAAC;iBAC5B,KAAK,EAA2B;YACrC,CAAC,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,KAAK,EAA2B;QACxE,OAAO,EACL,YAAY,EAAE,OAAO,KAAK,SAAS;YACjC,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC;YACxE,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;KAC/C,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,eAAe,GAAG,CAC7B,UAA8B,EAC9B,IAA+B,EAC/B,EAAE;IACF,MAAM,IAAI,GAAG,0BAA0B,CAAC,IAAI,CAAC,CAAC;IAE9C,OAAO,EAAE,GAAG,UAAU,EAAE,GAAG,IAAI,EAAE,CAAC;AACpC,CAAC,CAAC"}

package/dist/esm/relational/sqlite/models/enrichers/id.enricher.d.ts

@@ -0,0 +1,25 @@
+import type { HasDefault, HasRuntimeDefault, IsPrimaryKey, NotNull } from 'drizzle-orm';
+import type { SQLiteIntegerBuilderInitial, SQLiteTextBuilderInitial } from 'drizzle-orm/sqlite-core';
+import type { TColumnDefinitions, TIdEnricherOptions } from '../common/types.js';
+type TStringIdCol = HasRuntimeDefault<HasDefault<IsPrimaryKey<NotNull<SQLiteTextBuilderInitial<'id', [string, ...string[]], undefined>>>>>;
+type TNumberIdCol = IsPrimaryKey<HasDefault<NotNull<SQLiteIntegerBuilderInitial<'id'>>>>;
+export type TIdEnricherResult<ColumnDefinitions extends TColumnDefinitions = TColumnDefinitions> = ColumnDefinitions & {
+    id: TStringIdCol | TNumberIdCol;
+};
+type TIdColumnDef<Opts extends TIdEnricherOptions | undefined = undefined> = Opts extends {
+    id: infer IdOpts;
+} ? IdOpts extends {
+    dataType: 'string';
+} ? {
+    id: TStringIdCol;
+} : {
+    id: TNumberIdCol;
+} : {
+    id: TNumberIdCol;
+};
+export declare const generateIdColumnDefs: <Opts extends TIdEnricherOptions | undefined>(opts?: Opts) => TIdColumnDef<Opts>;
+export declare const enrichId: (baseColumns: TColumnDefinitions, opts?: TIdEnricherOptions) => {
+    id: TNumberIdCol;
+};
+export {};
+//# sourceMappingURL=id.enricher.d.ts.map

package/dist/esm/relational/sqlite/models/enrichers/id.enricher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"id.enricher.d.ts","sourceRoot":"","sources":["../../../../../../src/relational/sqlite/models/enrichers/id.enricher.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,iBAAiB,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACxF,OAAO,KAAK,EACV,2BAA2B,EAC3B,wBAAwB,EACzB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,KAAK,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAE9E,KAAK,YAAY,GAAG,iBAAiB,CACnC,UAAU,CACR,YAAY,CAAC,OAAO,CAAC,wBAAwB,CAAC,IAAI,EAAE,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,CACxF,CACF,CAAC;AAGF,KAAK,YAAY,GAAG,YAAY,CAAC,UAAU,CAAC,OAAO,CAAC,2BAA2B,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;AAEzF,MAAM,MAAM,iBAAiB,CAAC,iBAAiB,SAAS,kBAAkB,GAAG,kBAAkB,IAC7F,iBAAiB,GAAG;IAClB,EAAE,EAAE,YAAY,GAAG,YAAY,CAAC;CACjC,CAAC;AAEJ,KAAK,YAAY,CAAC,IAAI,SAAS,kBAAkB,GAAG,SAAS,GAAG,SAAS,IAAI,IAAI,SAAS;IACxF,EAAE,EAAE,MAAM,MAAM,CAAC;CAClB,GACG,MAAM,SAAS;IAAE,QAAQ,EAAE,QAAQ,CAAA;CAAE,GACnC;IAAE,EAAE,EAAE,YAAY,CAAA;CAAE,GACpB;IAAE,EAAE,EAAE,YAAY,CAAA;CAAE,GACtB;IAAE,EAAE,EAAE,YAAY,CAAA;CAAE,CAAC;AAEzB,eAAO,MAAM,oBAAoB,GAAI,IAAI,SAAS,kBAAkB,GAAG,SAAS,EAC9E,OAAO,IAAI,KACV,YAAY,CAAC,IAAI,CAwBnB,CAAC;AAEF,eAAO,MAAM,QAAQ,GAAI,aAAa,kBAAkB,EAAE,OAAO,kBAAkB;QA9BzE,YAAY;CAkCrB,CAAC"}