@kurdel/db 0.1.0-beta.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025-2026 Andrii Sorokin
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,42 @@
+# @kurdel/db
+
+Database contracts, SQLite connectivity, and query-building utilities for
+Kurdel applications.
+
+## Transactions
+
+Use `IDatabase.transaction` to execute related operations atomically:
+
+```ts
+const user = await db.transaction(async transaction => {
+  const created = await transaction.get({
+    sql: 'INSERT INTO users (email) VALUES (?) RETURNING id, email;',
+    params: ['ada@example.test'],
+  });
+  await transaction.run({
+    sql: 'INSERT INTO user_roles (user_id, role_id) VALUES (?, ?);',
+    params: [created.id, 2],
+  });
+  return created;
+});
+```
+
+The callback result is returned after commit. Throwing or rejecting rolls back
+every operation performed through the supplied `IDatabaseSession`.
+
+Always use the callback's `transaction` argument inside the callback. Calling
+the outer `db` object would schedule work outside the transaction and may wait
+for the callback to finish. Nested transactions are intentionally not exposed
+by `IDatabaseSession`.
+
+The SQLite implementation serializes the complete callback with respect to
+all other operations on its connection. This prevents another request from
+interleaving a query between `BEGIN` and `COMMIT`.
+
+Custom database implementations must provide the same atomic callback
+semantics and ensure that the supplied session stays on one connection for the
+duration of the transaction.
+
+## License
+
+MIT © Andrii Sorokin

package/lib/consts.d.ts

@@ -0,0 +1 @@
+export declare const DB_CONFIG_FILENAME = "db.config.json";

package/lib/consts.js

@@ -0,0 +1,2 @@
+export const DB_CONFIG_FILENAME = 'db.config.json';
+//# sourceMappingURL=consts.js.map

package/lib/consts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"consts.js","sourceRoot":"","sources":["../src/consts.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,kBAAkB,GAAG,gBAAgB,CAAC"}

package/lib/database-driver.d.ts

@@ -0,0 +1,7 @@
+import type { IDatabaseConfig } from './interfaces.js';
+export declare abstract class DatabaseDriver<T extends IDatabaseConfig> {
+    protected config: T;
+    constructor(config: T);
+    abstract connect(): Promise<void>;
+    abstract disconnect(): Promise<void>;
+}

package/lib/database-driver.js

@@ -0,0 +1,6 @@
+export class DatabaseDriver {
+    constructor(config) {
+        this.config = config;
+    }
+}
+//# sourceMappingURL=database-driver.js.map

package/lib/database-driver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"database-driver.js","sourceRoot":"","sources":["../src/database-driver.ts"],"names":[],"mappings":"AAEA,MAAM,OAAgB,cAAc;IAGlC,YAAY,MAAS;QACnB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;CAKF"}

package/lib/database-factory.d.ts

@@ -0,0 +1,6 @@
+import type { ISQLiteConfig } from './sqlite-driver.js';
+import { SQLiteDriver } from './sqlite-driver.js';
+export type ICombinedDatabaseConfig = ISQLiteConfig;
+export declare class DatabaseFactory {
+    static createDriver(config: ICombinedDatabaseConfig): SQLiteDriver;
+}

package/lib/database-factory.js

@@ -0,0 +1,12 @@
+import { SQLiteDriver } from './sqlite-driver.js';
+export class DatabaseFactory {
+    static createDriver(config) {
+        switch (config.type) {
+            case 'sqlite':
+                return new SQLiteDriver(config);
+            default:
+                throw new Error(`Unsupported database type: ${config.type}`);
+        }
+    }
+}
+//# sourceMappingURL=database-factory.js.map

package/lib/database-factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"database-factory.js","sourceRoot":"","sources":["../src/database-factory.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAIlD,MAAM,OAAO,eAAe;IAC1B,MAAM,CAAC,YAAY,CAAC,MAA+B;QACjD,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;YACpB,KAAK,QAAQ;gBACX,OAAO,IAAI,YAAY,CAAC,MAAuB,CAAC,CAAC;YACnD;gBACE,MAAM,IAAI,KAAK,CAAC,8BAA8B,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;QACjE,CAAC;IACH,CAAC;CACF"}

package/lib/db-connector.d.ts

@@ -0,0 +1,7 @@
+import type { IDatabase } from './interfaces.js';
+export declare class DBConnector {
+    private jsonLoader;
+    constructor();
+    run(): Promise<IDatabase>;
+    private establish;
+}

package/lib/db-connector.js

@@ -0,0 +1,26 @@
+import { JSONLoader } from '@kurdel/common';
+import { DB_CONFIG_FILENAME } from './consts.js';
+import { DatabaseFactory } from './database-factory.js';
+export class DBConnector {
+    constructor() {
+        this.jsonLoader = new JSONLoader();
+    }
+    async run() {
+        try {
+            const dbConfig = this.jsonLoader.load(DB_CONFIG_FILENAME);
+            return this.establish(dbConfig);
+        }
+        catch (err) {
+            throw new Error(`Database connection failed: ${String(err)}`);
+        }
+    }
+    async establish(dbConfig) {
+        const driver = DatabaseFactory.createDriver(dbConfig);
+        await driver.connect();
+        if (!driver.connection) {
+            throw new Error('Database connection failed');
+        }
+        return driver.connection;
+    }
+}
+//# sourceMappingURL=db-connector.js.map

package/lib/db-connector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"db-connector.js","sourceRoot":"","sources":["../src/db-connector.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEjD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAGxD,MAAM,OAAO,WAAW;IAGtB;QACE,IAAI,CAAC,UAAU,GAAG,IAAI,UAAU,EAAE,CAAC;IACrC,CAAC;IAEM,KAAK,CAAC,GAAG;QACd,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;YAC1D,OAAO,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QAClC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,+BAA+B,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChE,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,SAAS,CAAC,QAAiC;QACvD,MAAM,MAAM,GAAG,eAAe,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;QACtD,MAAM,MAAM,CAAC,OAAO,EAAE,CAAC;QACvB,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;QAChD,CAAC;QACD,OAAO,MAAM,CAAC,UAAU,CAAC;IAC3B,CAAC;CACF"}

package/lib/index.d.ts

@@ -0,0 +1,4 @@
+export { IDatabase, type IDatabaseSession, type IQueryBuilder, type IDatabaseConfig, type DatabaseQuery, } from './interfaces.js';
+export { DatabaseFactory } from './database-factory.js';
+export { DBConnector } from './db-connector.js';
+export { QueryBuilder } from './query-builder.js';

package/lib/index.js

@@ -0,0 +1,5 @@
+export { IDatabase, } from './interfaces.js';
+export { DatabaseFactory } from './database-factory.js';
+export { DBConnector } from './db-connector.js';
+export { QueryBuilder } from './query-builder.js';
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,GAKV,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC"}

package/lib/interfaces.d.ts

@@ -0,0 +1,35 @@
+export interface IDatabaseConfig {
+    type: string;
+    host?: string;
+    filename?: string;
+    port?: number;
+    user?: string;
+    password?: string;
+}
+export type DatabaseQuery = {
+    sql: string;
+    params: any[];
+};
+export declare const IDatabase: unique symbol;
+export interface IDatabaseSession {
+    get(query: DatabaseQuery): Promise<any>;
+    all(query: DatabaseQuery): Promise<any>;
+    run(query: DatabaseQuery): Promise<void>;
+}
+export interface IDatabase extends IDatabaseSession {
+    /**
+     * Runs work atomically on an isolated database session.
+     *
+     * Queries inside the callback must use the supplied transaction session.
+     * Resolves with the callback result after commit and rolls back on failure.
+     */
+    transaction<T>(work: (transaction: IDatabaseSession) => Promise<T>): Promise<T>;
+    close(): Promise<void>;
+}
+export interface IQueryBuilder {
+    insert(table: string, data: Record<string, any>): IQueryBuilder;
+    select(fields: string | string[]): IQueryBuilder;
+    from(table: string): IQueryBuilder;
+    where(condition: string, params?: any[]): IQueryBuilder;
+    build(): DatabaseQuery;
+}

package/lib/interfaces.js

@@ -0,0 +1,2 @@
+export const IDatabase = Symbol('IDatabase');
+//# sourceMappingURL=interfaces.js.map

package/lib/interfaces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interfaces.js","sourceRoot":"","sources":["../src/interfaces.ts"],"names":[],"mappings":"AAcA,MAAM,CAAC,MAAM,SAAS,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC"}

package/lib/query-builder.d.ts

@@ -0,0 +1,16 @@
+import type { DatabaseQuery, IQueryBuilder } from './interfaces.js';
+type SelectOptions = {
+    fn?: 'MAX' | 'MIN' | 'COUNT';
+    as?: string;
+};
+export declare class QueryBuilder implements IQueryBuilder {
+    private sql;
+    private params;
+    select(fields: string | string[], options?: SelectOptions): QueryBuilder;
+    insert(table: string, data: Record<string, any>): QueryBuilder;
+    delete(): QueryBuilder;
+    from(table: string): QueryBuilder;
+    where(condition: string, params?: any[]): QueryBuilder;
+    build(): DatabaseQuery;
+}
+export {};

package/lib/query-builder.js

@@ -0,0 +1,50 @@
+export class QueryBuilder {
+    constructor() {
+        this.sql = '';
+        this.params = [];
+    }
+    select(fields, options = {}) {
+        if (options.fn) {
+            this.sql = `SELECT ${options.fn}(${fields}) `;
+        }
+        else {
+            this.sql = `SELECT ${Array.isArray(fields) ? fields.join(', ') : fields} `;
+        }
+        if (options.as) {
+            this.sql = this.sql + `AS ${options.as} `;
+        }
+        this.params = [];
+        return this;
+    }
+    insert(table, data) {
+        const keys = Object.keys(data);
+        const values = Object.values(data);
+        const columns = keys.join(', ');
+        const placeholders = keys.map(() => '?').join(', ');
+        this.sql = `INSERT INTO ${table} (${columns}) VALUES (${placeholders}) `;
+        this.params = values;
+        return this;
+    }
+    delete() {
+        this.sql = `DELETE `;
+        return this;
+    }
+    from(table) {
+        this.sql += `FROM ${table} `;
+        return this;
+    }
+    where(condition, params) {
+        this.sql += `WHERE ${condition} `;
+        if (params) {
+            this.params.push(...params);
+        }
+        return this;
+    }
+    build() {
+        const result = { sql: this.sql.trim(), params: [...this.params] };
+        this.sql = '';
+        this.params = [];
+        return result;
+    }
+}
+//# sourceMappingURL=query-builder.js.map

package/lib/query-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-builder.js","sourceRoot":"","sources":["../src/query-builder.ts"],"names":[],"mappings":"AAOA,MAAM,OAAO,YAAY;IAAzB;QACU,QAAG,GAAW,EAAE,CAAC;QACjB,WAAM,GAAU,EAAE,CAAC;IAkD7B,CAAC;IAhDC,MAAM,CAAC,MAAyB,EAAE,UAAyB,EAAE;QAC3D,IAAI,OAAO,CAAC,EAAE,EAAE,CAAC;YACf,IAAI,CAAC,GAAG,GAAG,UAAU,OAAO,CAAC,EAAE,IAAI,MAAM,IAAI,CAAC;QAChD,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,GAAG,GAAG,UAAU,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC;QAC7E,CAAC;QACD,IAAI,OAAO,CAAC,EAAE,EAAE,CAAC;YACf,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,GAAG,MAAM,OAAO,CAAC,EAAE,GAAG,CAAC;QAC5C,CAAC;QACD,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC;QACjB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,CAAC,KAAa,EAAE,IAAyB;QAC7C,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC/B,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACnC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChC,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEpD,IAAI,CAAC,GAAG,GAAG,eAAe,KAAK,KAAK,OAAO,aAAa,YAAY,IAAI,CAAC;QACzE,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM;QACJ,IAAI,CAAC,GAAG,GAAG,SAAS,CAAC;QACrB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,CAAC,KAAa;QAChB,IAAI,CAAC,GAAG,IAAI,QAAQ,KAAK,GAAG,CAAC;QAC7B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,SAAiB,EAAE,MAAc;QACrC,IAAI,CAAC,GAAG,IAAI,SAAS,SAAS,GAAG,CAAC;QAClC,IAAI,MAAM,EAAE,CAAC;YACX,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,CAAC;QAC9B,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK;QACH,MAAM,MAAM,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QAClE,IAAI,CAAC,GAAG,GAAG,EAAE,CAAC;QACd,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC;QACjB,OAAO,MAAM,CAAC;IAChB,CAAC;CACF"}

package/lib/sqlite-db.d.ts

@@ -0,0 +1,15 @@
+import type { DatabaseQuery, IDatabase, IDatabaseSession } from './interfaces.js';
+export declare class SQLiteDB implements IDatabase {
+    private db;
+    private queue;
+    constructor(path: string);
+    get({ sql, params }: DatabaseQuery): Promise<any>;
+    all({ sql, params }: DatabaseQuery): Promise<any>;
+    run({ sql, params }: DatabaseQuery): Promise<void>;
+    transaction<T>(work: (transaction: IDatabaseSession) => Promise<T>): Promise<T>;
+    close(): Promise<void>;
+    private getRaw;
+    private allRaw;
+    private runRaw;
+    private enqueue;
+}

package/lib/sqlite-db.js

@@ -0,0 +1,93 @@
+import sqlite3 from 'sqlite3';
+export class SQLiteDB {
+    constructor(path) {
+        this.queue = Promise.resolve();
+        this.db = new sqlite3.Database(path, err => {
+            if (err) {
+                console.error('Could not connect to database', err);
+            }
+        });
+    }
+    get({ sql, params }) {
+        return this.enqueue(() => this.getRaw({ sql, params }));
+    }
+    all({ sql, params }) {
+        return this.enqueue(() => this.allRaw({ sql, params }));
+    }
+    run({ sql, params }) {
+        return this.enqueue(() => this.runRaw({ sql, params }));
+    }
+    transaction(work) {
+        return this.enqueue(async () => {
+            await this.runRaw({ sql: 'BEGIN IMMEDIATE;', params: [] });
+            const transaction = {
+                get: query => this.getRaw(query),
+                all: query => this.allRaw(query),
+                run: query => this.runRaw(query),
+            };
+            try {
+                const result = await work(transaction);
+                await this.runRaw({ sql: 'COMMIT;', params: [] });
+                return result;
+            }
+            catch (error) {
+                await this.runRaw({ sql: 'ROLLBACK;', params: [] });
+                throw error;
+            }
+        });
+    }
+    close() {
+        return this.enqueue(() => new Promise((resolve, reject) => {
+            this.db.close(err => {
+                if (err) {
+                    reject(err);
+                }
+                else {
+                    resolve();
+                }
+            });
+        }));
+    }
+    getRaw({ sql, params }) {
+        return new Promise((resolve, reject) => {
+            this.db.get(sql, params, (err, result) => {
+                if (err) {
+                    reject(err);
+                }
+                else {
+                    resolve(result);
+                }
+            });
+        });
+    }
+    allRaw({ sql, params }) {
+        return new Promise((resolve, reject) => {
+            this.db.all(sql, params, (err, result) => {
+                if (err) {
+                    reject(err);
+                }
+                else {
+                    resolve(result);
+                }
+            });
+        });
+    }
+    runRaw({ sql, params }) {
+        return new Promise((resolve, reject) => {
+            this.db.run(sql, params, function (err) {
+                if (err) {
+                    reject(err);
+                }
+                else {
+                    resolve();
+                }
+            });
+        });
+    }
+    enqueue(operation) {
+        const result = this.queue.then(operation, operation);
+        this.queue = result.then(() => undefined, () => undefined);
+        return result;
+    }
+}
+//# sourceMappingURL=sqlite-db.js.map

package/lib/sqlite-db.js.map

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

package/lib/sqlite-driver.d.ts

@@ -0,0 +1,13 @@
+import { DatabaseDriver } from './database-driver.js';
+import type { IDatabaseConfig } from './interfaces.js';
+import { SQLiteDB } from './sqlite-db.js';
+export interface ISQLiteConfig extends IDatabaseConfig {
+    filename: string;
+}
+export declare class SQLiteDriver extends DatabaseDriver<ISQLiteConfig> {
+    private db?;
+    constructor(config: ISQLiteConfig);
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    get connection(): SQLiteDB | undefined;
+}

package/lib/sqlite-driver.js

@@ -0,0 +1,36 @@
+import { DatabaseDriver } from './database-driver.js';
+import { SQLiteDB } from './sqlite-db.js';
+export class SQLiteDriver extends DatabaseDriver {
+    constructor(config) {
+        super(config);
+    }
+    async connect() {
+        this.db = await new Promise((resolve, reject) => {
+            try {
+                const db = new SQLiteDB(this.config.filename);
+                return resolve(db);
+            }
+            catch (err) {
+                return reject(err);
+            }
+        });
+    }
+    async disconnect() {
+        await new Promise((resolve, reject) => {
+            if (this.db) {
+                try {
+                    this.db.close();
+                    this.db = undefined;
+                }
+                catch (err) {
+                    return reject(err);
+                }
+            }
+            return resolve(null);
+        });
+    }
+    get connection() {
+        return this.db;
+    }
+}
+//# sourceMappingURL=sqlite-driver.js.map

package/lib/sqlite-driver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-driver.js","sourceRoot":"","sources":["../src/sqlite-driver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAM1C,MAAM,OAAO,YAAa,SAAQ,cAA6B;IAG7D,YAAY,MAAqB;QAC/B,KAAK,CAAC,MAAM,CAAC,CAAC;IAChB,CAAC;IAED,KAAK,CAAC,OAAO;QACX,IAAI,CAAC,EAAE,GAAG,MAAM,IAAI,OAAO,CAAW,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACxD,IAAI,CAAC;gBACH,MAAM,EAAE,GAAG,IAAI,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;gBAC9C,OAAO,OAAO,CAAC,EAAE,CAAC,CAAC;YACrB,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;YACrB,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,UAAU;QACd,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACpC,IAAI,IAAI,CAAC,EAAE,EAAE,CAAC;gBACZ,IAAI,CAAC;oBACH,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC;oBAChB,IAAI,CAAC,EAAE,GAAG,SAAS,CAAC;gBACtB,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACb,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;gBACrB,CAAC;YACH,CAAC;YACD,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC;QACvB,CAAC,CAAC,CAAC;IACL,CAAC;IAED,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,EAAE,CAAC;IACjB,CAAC;CACF"}

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@kurdel/db",
+  "version": "0.1.0-beta.1",
+  "description": "Database abstractions and SQLite adapter for Kurdel",
+  "type": "module",
+  "exports": {
+    ".": "./lib/index.js"
+  },
+  "main": "./lib/index.js",
+  "types": "./lib/index.d.ts",
+  "files": [
+    "lib"
+  ],
+  "scripts": {
+    "prepack": "npm run build",
+    "test": "vitest run",
+    "clean": "rimraf lib ../../.cache/tsconfig.db.build.tsbuildinfo",
+    "build": "tsc -p tsconfig.build.json && tsc-alias -p tsconfig.build.json",
+    "build:force": "npm run clean && tsc -p tsconfig.build.json --force && tsc-alias -p tsconfig.build.json"
+  },
+  "keywords": [
+    "kurdel",
+    "database",
+    "sqlite",
+    "framework"
+  ],
+  "author": "Andrii Sorokin",
+  "license": "MIT",
+  "engines": {
+    "node": "^20.19.0 || ^22.12.0 || >=24.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ignorantic/kurdel.git",
+    "directory": "packages/db"
+  },
+  "homepage": "https://github.com/ignorantic/kurdel/tree/main/packages/db#readme",
+  "bugs": {
+    "url": "https://github.com/ignorantic/kurdel/issues"
+  },
+  "publishConfig": {
+    "access": "public",
+    "tag": "beta"
+  },
+  "devDependencies": {
+    "@types/node": "^20.9.0",
+    "rimraf": "^3.0.2",
+    "tsc-alias": "^1.8.16"
+  },
+  "peerDependencies": {
+    "sqlite3": "^5.1.6"
+  },
+  "dependencies": {
+    "@kurdel/common": "0.1.0-beta.1"
+  }
+}