@zudojs/database 0.0.1 → 0.1.0

package/dist/database/database.core.js

@@ -0,0 +1,133 @@
+import { createDatabaseClient, } from "../databaseClient/databaseClient.core.js";
+/**
+ * Database facade used by the application layer.
+ *
+ * This module provides a single database lifecycle entry point while
+ * keeping the underlying Prisma client implementation inside the
+ * database package.
+ */
+export class Database {
+    client;
+    constructor(options = {}) {
+        this.client = createDatabaseClient(options);
+    }
+    /**
+     * Initializes the database connection.
+     */
+    async connect() {
+        await this.client.connect();
+    }
+    /**
+     * Closes the database connection.
+     */
+    async disconnect() {
+        await this.client.disconnect();
+    }
+    /**
+     * Ensures the database is connected.
+     */
+    async ensureConnected() {
+        await this.client.ensureConnected();
+    }
+    /**
+     * Checks database connectivity.
+     */
+    async ping() {
+        await this.client.ping();
+    }
+    /**
+     * Returns the current database status.
+     */
+    getStatus() {
+        return this.client.getStatus();
+    }
+    /**
+     * Returns database health information.
+     */
+    async healthCheck() {
+        return this.client.healthCheck();
+    }
+    /**
+     * Executes work inside a database transaction.
+     */
+    async transaction(callback, options) {
+        return this.client.transaction(callback, options);
+    }
+    /**
+     * Returns the underlying database client.
+     *
+     * This should primarily be used by repository and infrastructure
+     * implementations that require direct Prisma access.
+     */
+    getClient() {
+        return this.client;
+    }
+    /**
+     * Returns the underlying Prisma client.
+     */
+    getPrisma() {
+        return this.client.getPrisma();
+    }
+    /**
+     * Releases all database resources.
+     */
+    async destroy() {
+        await this.client.destroy();
+    }
+}
+/**
+ * Creates a database facade.
+ */
+export function createDatabase(options = {}) {
+    return new Database(options);
+}
+/**
+ * Default database instance.
+ *
+ * The instance is created lazily by consumers through the exported
+ * factory rather than connecting during module import.
+ */
+let defaultDatabase;
+/**
+ * Returns the shared application database instance.
+ *
+ * The connection is not established automatically. Call
+ * `connect()` during application bootstrap.
+ */
+export function getDatabase(options = {}) {
+    if (!defaultDatabase) {
+        defaultDatabase = createDatabase(options);
+    }
+    return defaultDatabase;
+}
+/**
+ * Connects the shared application database.
+ */
+export async function connectDatabase(options = {}) {
+    const database = getDatabase(options);
+    await database.connect();
+    return database;
+}
+/**
+ * Disconnects the shared application database.
+ */
+export async function disconnectDatabase() {
+    if (!defaultDatabase) {
+        return;
+    }
+    await defaultDatabase.disconnect();
+}
+/**
+ * Resets the shared database instance.
+ *
+ * Primarily useful for application shutdown, tests, and isolated
+ * runtime environments.
+ */
+export async function resetDatabase() {
+    if (!defaultDatabase) {
+        return;
+    }
+    await defaultDatabase.destroy();
+    defaultDatabase = undefined;
+}
+//# sourceMappingURL=database.core.js.map

package/dist/database/database.core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"database.core.js","sourceRoot":"","sources":["../../src/database/database.core.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,GAIrB,MAAM,0CAA0C,CAAC;AASlD;;;;;;GAMG;AACH,MAAM,OAAO,QAAQ;IACF,MAAM,CAAiB;IAExC,YAAY,OAAO,GAA0B,EAAE;QAC7C,IAAI,CAAC,MAAM,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAC;IAC9C,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,OAAO;QAClB,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;IAC9B,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,UAAU;QACrB,MAAM,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;IACjC,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,eAAe;QAC1B,MAAM,IAAI,CAAC,MAAM,CAAC,eAAe,EAAE,CAAC;IACtC,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,IAAI;QACf,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;IAC3B,CAAC;IAED;;OAEG;IACI,SAAS;QACd,OAAO,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;IACjC,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,WAAW;QACtB,OAAO,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;IACnC,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,WAAW,CACtB,QAAkE,EAClE,OAA4B;QAE5B,OAAO,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACpD,CAAC;IAED;;;;;OAKG;IACI,SAAS;QACd,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED;;OAEG;IACI,SAAS;QACd,OAAO,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;IACjC,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,OAAO;QAClB,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;IAC9B,CAAC;CACF;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,OAAO,GAA0B,EAAE;IAChE,OAAO,IAAI,QAAQ,CAAC,OAAO,CAAC,CAAC;AAC/B,CAAC;AAED;;;;;GAKG;AACH,IAAI,eAAqC,CAAC;AAE1C;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,OAAO,GAA0B,EAAE;IAC7D,IAAI,CAAC,eAAe,EAAE,CAAC;QACrB,eAAe,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;IAC5C,CAAC;IAED,OAAO,eAAe,CAAC;AACzB,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,OAAO,GAA0B,EAAE;IAEnC,MAAM,QAAQ,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;IAEtC,MAAM,QAAQ,CAAC,OAAO,EAAE,CAAC;IAEzB,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB;IACtC,IAAI,CAAC,eAAe,EAAE,CAAC;QACrB,OAAO;IACT,CAAC;IAED,MAAM,eAAe,CAAC,UAAU,EAAE,CAAC;AACrC,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa;IACjC,IAAI,CAAC,eAAe,EAAE,CAAC;QACrB,OAAO;IACT,CAAC;IAED,MAAM,eAAe,CAAC,OAAO,EAAE,CAAC;IAEhC,eAAe,GAAG,SAAS,CAAC;AAC9B,CAAC"}

package/dist/databaseType/databaseType.type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"databaseType.type.d.ts","sourceRoot":"","sources":["../../src/databaseType/databaseType.type.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,cAAc,GACxB,cAAc,GAAG,YAAY,GAAG,WAAW,GAAG,eAAe,GAAG,OAAO,CAAC;AAE1E;;GAEG;AACH,MAAM,MAAM,yBAAyB,GACnC,iBAAiB,GAAG,eAAe,GAAG,gBAAgB,GAAG,cAAc,CAAC;AAE1E;;GAEG;AACH,MAAM,MAAM,iBAAiB,GACzB,QAAQ,GACR,MAAM,GACN,QAAQ,GACR,QAAQ,GACR,QAAQ,GACR,OAAO,GACP,WAAW,GACX,aAAa,GACb,KAAK,CAAC;AAEV;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAC9B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACvD;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;CACrC;AAED;;GAEG;AACH,MAAM,WAAW,kBAAmB,SAAQ,wBAAwB;IAClE,QAAQ,CAAC,cAAc,CAAC,EAAE,yBAAyB,CAAC;IACpD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,MAAM,mBAAmB,CAAC,QAAQ,EAAE,OAAO,IAAI,CACnD,OAAO,EAAE,QAAQ,KACd,OAAO,CAAC,OAAO,CAAC,CAAC;AAEtB;;;;;;GAMG;AACH,MAAM,WAAW,cAAc,CAAC,mBAAmB,GAAG,OAAO;IAC3D,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEtB,SAAS,IAAI,cAAc,CAAC;IAE5B,WAAW,IAAI,OAAO,CAAC,cAAc,CAAC,CAAC;IAEvC,WAAW,CAAC,OAAO,EACjB,QAAQ,EAAE,mBAAmB,CAAC,mBAAmB,EAAE,OAAO,CAAC,EAC3D,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,OAAO,CAAC,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU,CACzB,OAAO,EACP,GAAG,GAAG,MAAM,EACZ,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,EAC/B,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,EAC/B,OAAO,GAAG,OAAO;IAEjB,QAAQ,CACN,EAAE,EAAE,GAAG,EACP,OAAO,CAAC,EAAE,wBAAwB,GACjC,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;IAE3B,OAAO,CACL,MAAM,EAAE,OAAO,EACf,OAAO,CAAC,EAAE,wBAAwB,GACjC,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;IAE3B,QAAQ,CACN,MAAM,CAAC,EAAE,OAAO,EAChB,OAAO,CAAC,EAAE,wBAAwB,GACjC,OAAO,CAAC,SAAS,OAAO,EAAE,CAAC,CAAC;IAE/B,MAAM,CACJ,KAAK,EAAE,YAAY,EACnB,OAAO,CAAC,EAAE,wBAAwB,GACjC,OAAO,CAAC,OAAO,CAAC,CAAC;IAEpB,MAAM,CACJ,EAAE,EAAE,GAAG,EACP,KAAK,EAAE,YAAY,EACnB,OAAO,CAAC,EAAE,wBAAwB,GACjC,OAAO,CAAC,OAAO,CAAC,CAAC;IAEpB,MAAM,CAAC,EAAE,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,wBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnE,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,wBAAwB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAE9E,KAAK,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,wBAAwB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAC9E;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,eAAe,CAAC,OAAO;IACtC,QAAQ,CAAC,IAAI,EAAE,SAAS,OAAO,EAAE,CAAC;IAClC,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,KAAK,GAAG,MAAM,CAAC;AAE3C;;GAEG;AACH,MAAM,WAAW,SAAS,CAAC,MAAM,SAAS,MAAM,GAAG,MAAM;IACvD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,YAAY,CAC3B,MAAM,SAAS,MAAM,GAAG,MAAM,CAC9B,SAAQ,wBAAwB;IAChC,QAAQ,CAAC,UAAU,CAAC,EAAE,eAAe,CAAC;IACtC,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;CAC9C;AAED;;GAEG;AACH,MAAM,WAAW,cAAc,CAAC,GAAG,GAAG,MAAM;IAC1C,QAAQ,CAAC,EAAE,EAAE,GAAG,CAAC;IACjB,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,mBAAoB,SAAQ,cAAc;IACzD,QAAQ,CAAC,SAAS,EAAE,IAAI,GAAG,IAAI,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,eAAgB,SAAQ,cAAc;IACrD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,CAAC,EAAE,iBAAiB,CAAC;IACvC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACvD;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAE3E,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAE1E,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAE1E,KAAK,CACH,OAAO,EAAE,MAAM,EACf,KAAK,CAAC,EAAE,OAAO,EACf,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAC3C,IAAI,CAAC;CACT;AAED;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,cAK/B,CAAC;AAEH;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,CAAC,EAAE,eAAe,GACtB,QAAQ,CAAC,eAAe,CAAC,CAS3B;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,GACZ,cAAc,CAkBhB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,CAAC,EAAE,eAAe,GAAG,MAAM,CAInE"}

package/dist/databaseType/databaseType.type.js

@@ -0,0 +1,45 @@
+/**
+ * Default no-op database logger.
+ */
+export const noopDatabaseLogger = Object.freeze({
+    debug: () => undefined,
+    info: () => undefined,
+    warn: () => undefined,
+    error: () => undefined,
+});
+/**
+ * Normalizes pagination input.
+ */
+export function normalizePagination(input) {
+    const page = Math.max(1, Math.floor(input?.page ?? 1));
+    const limit = Math.min(100, Math.max(1, Math.floor(input?.limit ?? 20)));
+    return {
+        page,
+        limit,
+    };
+}
+/**
+ * Creates pagination metadata.
+ */
+export function createPaginationMeta(page, limit, total) {
+    const normalizedPage = Math.max(1, Math.floor(page));
+    const normalizedLimit = Math.max(1, Math.floor(limit));
+    const normalizedTotal = Math.max(0, Math.floor(total));
+    const totalPages = normalizedTotal === 0 ? 0 : Math.ceil(normalizedTotal / normalizedLimit);
+    return {
+        page: normalizedPage,
+        limit: normalizedLimit,
+        total: normalizedTotal,
+        totalPages,
+        hasNextPage: totalPages > 0 && normalizedPage < totalPages,
+        hasPreviousPage: normalizedPage > 1 && totalPages > 0,
+    };
+}
+/**
+ * Calculates the offset for a paginated query.
+ */
+export function getPaginationOffset(input) {
+    const { page, limit } = normalizePagination(input);
+    return (page - 1) * limit;
+}
+//# sourceMappingURL=databaseType.type.js.map

package/dist/databaseType/databaseType.type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"databaseType.type.js","sourceRoot":"","sources":["../../src/databaseType/databaseType.type.ts"],"names":[],"mappings":"AAmQA;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAmB,MAAM,CAAC,MAAM,CAAC;IAC9D,KAAK,EAAE,GAAG,EAAE,CAAC,SAAS;IACtB,IAAI,EAAE,GAAG,EAAE,CAAC,SAAS;IACrB,IAAI,EAAE,GAAG,EAAE,CAAC,SAAS;IACrB,KAAK,EAAE,GAAG,EAAE,CAAC,SAAS;CACvB,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,UAAU,mBAAmB,CACjC,KAAuB;IAEvB,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC;IAEvD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAEzE,OAAO;QACL,IAAI;QACJ,KAAK;KACN,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAClC,IAAY,EACZ,KAAa,EACb,KAAa;IAEb,MAAM,cAAc,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;IAErD,MAAM,eAAe,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;IAEvD,MAAM,eAAe,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;IAEvD,MAAM,UAAU,GACd,eAAe,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,GAAG,eAAe,CAAC,CAAC;IAE3E,OAAO;QACL,IAAI,EAAE,cAAc;QACpB,KAAK,EAAE,eAAe;QACtB,KAAK,EAAE,eAAe;QACtB,UAAU;QACV,WAAW,EAAE,UAAU,GAAG,CAAC,IAAI,cAAc,GAAG,UAAU;QAC1D,eAAe,EAAE,cAAc,GAAG,CAAC,IAAI,UAAU,GAAG,CAAC;KACtD,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAuB;IACzD,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,mBAAmB,CAAC,KAAK,CAAC,CAAC;IAEnD,OAAO,CAAC,IAAI,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC;AAC5B,CAAC"}

package/dist/migration/migration.helpers.js

@@ -0,0 +1,99 @@
+/**
+ * Default migration table.
+ */
+export const DEFAULT_MIGRATION_TABLE = "_migrations";
+/**
+ * Default migration advisory lock.
+ */
+export const DEFAULT_MIGRATION_LOCK = "database:migrations";
+/**
+ * Normalizes and validates migrations.
+ */
+export function normalizeMigrations(migrations) {
+    if (!Array.isArray(migrations)) {
+        throw new TypeError("Migrations must be an array.");
+    }
+    const normalized = migrations
+        .map((migration) => {
+        validateMigration(migration);
+        return Object.freeze({ ...migration });
+    })
+        .sort((first, second) => first.version - second.version);
+    for (let index = 1; index < normalized.length; index += 1) {
+        const previous = normalized[index - 1];
+        const current = normalized[index];
+        if (previous && current && previous.version === current.version) {
+            throw new TypeError(`Duplicate migration version: ${current.version}.`);
+        }
+    }
+    return Object.freeze(normalized);
+}
+/**
+ * Validates one migration.
+ */
+export function validateMigration(migration) {
+    if (!migration || typeof migration !== "object") {
+        throw new TypeError("A migration definition is required.");
+    }
+    if (!Number.isInteger(migration.version) || migration.version <= 0) {
+        throw new TypeError("Migration version must be a positive integer.");
+    }
+    if (typeof migration.name !== "string" ||
+        migration.name.trim().length === 0) {
+        throw new TypeError("Migration name is required.");
+    }
+    if (migration.name.length > 255) {
+        throw new TypeError("Migration name cannot exceed 255 characters.");
+    }
+    if (typeof migration.up !== "function") {
+        throw new TypeError(`Migration "${migration.name}" requires an up function.`);
+    }
+    if (migration.down !== undefined && typeof migration.down !== "function") {
+        throw new TypeError(`Migration "${migration.name}" has an invalid down function.`);
+    }
+}
+/**
+ * Returns the latest registered migration version.
+ */
+export function getLatestVersion(migrations) {
+    if (migrations.length === 0)
+        return 0;
+    return migrations[migrations.length - 1].version;
+}
+/**
+ * Returns the current applied migration version.
+ */
+export function getCurrentVersion(migrations) {
+    if (migrations.length === 0)
+        return 0;
+    return migrations[migrations.length - 1].version;
+}
+/**
+ * Quotes a validated SQL identifier.
+ */
+export function quoteIdentifier(identifier) {
+    validateIdentifier(identifier, "identifier");
+    return `"${identifier}"`;
+}
+/**
+ * Validates an SQL identifier.
+ */
+export function validateIdentifier(identifier, name) {
+    if (typeof identifier !== "string" ||
+        !/^[A-Za-z_][A-Za-z0-9_]*$/.test(identifier)) {
+        throw new TypeError(`Invalid ${name}: "${identifier}".`);
+    }
+}
+/**
+ * Creates a deterministic signed 64-bit advisory lock key.
+ */
+export function hashLockKey(value) {
+    let hash = 1469598103934665603n;
+    const bytes = new TextEncoder().encode(value);
+    for (const byte of bytes) {
+        hash ^= BigInt(byte);
+        hash = BigInt.asIntN(64, hash * 1099511628211n);
+    }
+    return BigInt.asIntN(64, hash);
+}
+//# sourceMappingURL=migration.helpers.js.map

package/dist/migration/migration.helpers.js.map

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

package/dist/migration/migration.types.js

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

package/dist/migration/migration.types.js.map

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

package/dist/pagination/pagination.core.d.ts.map

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

package/dist/pagination/pagination.core.js

@@ -0,0 +1,210 @@
+/**
+ * Default pagination values.
+ */
+export const DEFAULT_PAGE = 1;
+export const DEFAULT_LIMIT = 20;
+export const MAX_LIMIT = 100;
+/**
+ * Normalizes page and limit values.
+ */
+export function normalizePagination(input) {
+    const page = normalizePage(input?.page);
+    const limit = normalizeLimit(input?.limit);
+    return {
+        page,
+        limit,
+        offset: calculateOffset(page, limit),
+    };
+}
+/**
+ * Normalizes a page number.
+ */
+export function normalizePage(page) {
+    if (page === undefined || !Number.isFinite(page)) {
+        return DEFAULT_PAGE;
+    }
+    return Math.max(1, Math.floor(page));
+}
+/**
+ * Normalizes a page size.
+ */
+export function normalizeLimit(limit) {
+    if (limit === undefined || !Number.isFinite(limit)) {
+        return DEFAULT_LIMIT;
+    }
+    return Math.min(MAX_LIMIT, Math.max(1, Math.floor(limit)));
+}
+/**
+ * Calculates the database offset for a page.
+ */
+export function calculateOffset(page, limit) {
+    return (normalizePage(page) - 1) * normalizeLimit(limit);
+}
+/**
+ * Calculates the total number of pages.
+ */
+export function calculateTotalPages(total, limit) {
+    const normalizedTotal = Math.max(0, Math.floor(total));
+    const normalizedLimit = normalizeLimit(limit);
+    if (normalizedTotal === 0) {
+        return 0;
+    }
+    return Math.ceil(normalizedTotal / normalizedLimit);
+}
+/**
+ * Creates pagination metadata.
+ */
+export function createPaginationMeta(page, limit, total) {
+    const normalizedPage = normalizePage(page);
+    const normalizedLimit = normalizeLimit(limit);
+    const normalizedTotal = Math.max(0, Math.floor(total));
+    const totalPages = calculateTotalPages(normalizedTotal, normalizedLimit);
+    return {
+        page: normalizedPage,
+        limit: normalizedLimit,
+        total: normalizedTotal,
+        totalPages,
+        hasNextPage: totalPages > 0 && normalizedPage < totalPages,
+        hasPreviousPage: normalizedPage > 1 && totalPages > 0,
+    };
+}
+/**
+ * Creates a paginated result.
+ */
+export function createPaginatedResult(data, page, limit, total) {
+    return {
+        data: [...data],
+        meta: createPaginationMeta(page, limit, total),
+    };
+}
+/**
+ * Gets the next page number.
+ */
+export function getNextPage(meta) {
+    if (!meta.hasNextPage) {
+        return null;
+    }
+    return meta.page + 1;
+}
+/**
+ * Gets the previous page number.
+ */
+export function getPreviousPage(meta) {
+    if (!meta.hasPreviousPage) {
+        return null;
+    }
+    return Math.max(1, meta.page - 1);
+}
+/**
+ * Checks whether a page number is valid for the result set.
+ */
+export function isValidPage(page, totalPages) {
+    if (!Number.isFinite(page) || !Number.isFinite(totalPages)) {
+        return false;
+    }
+    const normalizedPage = Math.floor(page);
+    const normalizedTotalPages = Math.max(0, Math.floor(totalPages));
+    if (normalizedTotalPages === 0) {
+        return normalizedPage === 1;
+    }
+    return normalizedPage >= 1 && normalizedPage <= normalizedTotalPages;
+}
+/**
+ * Calculates the item range represented by a page.
+ *
+ * For example, page 2 with a limit of 20 and total of 55 returns
+ * `{ start: 21, end: 40 }`.
+ */
+export function getItemRange(page, limit, total) {
+    const normalizedPage = normalizePage(page);
+    const normalizedLimit = normalizeLimit(limit);
+    const normalizedTotal = Math.max(0, Math.floor(total));
+    if (normalizedTotal === 0) {
+        return {
+            start: 0,
+            end: 0,
+        };
+    }
+    const start = calculateOffset(normalizedPage, normalizedLimit) + 1;
+    const end = Math.min(start + normalizedLimit - 1, normalizedTotal);
+    if (start > normalizedTotal) {
+        return {
+            start: normalizedTotal,
+            end: normalizedTotal,
+        };
+    }
+    return {
+        start,
+        end,
+    };
+}
+/**
+ * Applies offset pagination to an in-memory collection.
+ *
+ * This is useful for adapters and tests that need the same pagination
+ * semantics without querying the database directly.
+ */
+export function paginateCollection(items, input) {
+    const pagination = normalizePagination(input);
+    const total = items.length;
+    const data = items.slice(pagination.offset, pagination.offset + pagination.limit);
+    return createPaginatedResult(data, pagination.page, pagination.limit, total);
+}
+/**
+ * Normalizes cursor pagination input.
+ */
+export function normalizeCursorPagination(input) {
+    return {
+        cursor: input?.cursor ?? null,
+        limit: normalizeLimit(input?.limit),
+    };
+}
+/**
+ * Creates cursor pagination metadata.
+ */
+export function createCursorPaginationMeta(limit, options) {
+    return {
+        limit: normalizeLimit(limit),
+        hasNextPage: options.hasNextPage,
+        hasPreviousPage: options.hasPreviousPage ?? false,
+        nextCursor: options.nextCursor ?? undefined,
+        previousCursor: options.previousCursor ?? undefined,
+    };
+}
+/**
+ * Creates a cursor paginated result.
+ */
+export function createCursorPaginatedResult(data, limit, options) {
+    return {
+        data: [...data],
+        meta: createCursorPaginationMeta(limit, options),
+    };
+}
+/**
+ * Encodes a cursor value.
+ */
+export function encodeCursor(value) {
+    const serialized = JSON.stringify(value);
+    if (typeof serialized !== "string") {
+        throw new TypeError("Cursor value could not be serialized.");
+    }
+    return Buffer.from(serialized, "utf8").toString("base64url");
+}
+/**
+ * Decodes a cursor value.
+ */
+export function decodeCursor(cursor) {
+    if (typeof cursor !== "string" || cursor.trim().length === 0) {
+        throw new TypeError("A cursor value is required.");
+    }
+    try {
+        const decoded = Buffer.from(cursor, "base64url").toString("utf8");
+        return JSON.parse(decoded);
+    }
+    catch (error) {
+        throw new TypeError("Invalid pagination cursor.", {
+            cause: error,
+        });
+    }
+}
+//# sourceMappingURL=pagination.core.js.map

package/dist/pagination/pagination.core.js.map

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

package/dist/queryBuilder/queryBuilder.core.d.ts.map

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