@zudojs/database 0.0.1

package/dist/databaseClient/databaseClient.logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"databaseClient.logger.js","sourceRoot":"","sources":["../../src/databaseClient/databaseClient.logger.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,qGAAqG;AACrG,MAAM,UAAU,mBAAmB;IACjC,OAAO;QACL,KAAK,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,EAAE;YAC3B,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY,EAAE,CAAC;gBAC1C,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;YACnC,CAAC;QACH,CAAC;QACD,IAAI,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,EAAE;YAC1B,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY,EAAE,CAAC;gBAC1C,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;YAClC,CAAC;QACH,CAAC;QACD,IAAI,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,EAAE;YAC1B,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QAClC,CAAC;QACD,KAAK,EAAE,CAAC,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE;YAClC,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC;QAC1C,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/databaseClient/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @zudojs/database — Database Client
+ *
+ * Prisma-backed database client and connection infrastructure.
+ */
+export { DatabaseClient, createDatabaseClient, type DatabaseClientOptions, type DatabaseTransactionContext, } from "./databaseClient.core.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/databaseClient/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/databaseClient/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,cAAc,EACd,oBAAoB,EACpB,KAAK,qBAAqB,EAC1B,KAAK,0BAA0B,GAChC,MAAM,0BAA0B,CAAC"}

package/dist/databaseClient/index.js

@@ -0,0 +1,7 @@
+/**
+ * @zudojs/database — Database Client
+ *
+ * Prisma-backed database client and connection infrastructure.
+ */
+export { DatabaseClient, createDatabaseClient, } from "./databaseClient.core.js";
+//# sourceMappingURL=index.js.map

package/dist/databaseClient/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/databaseClient/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,cAAc,EACd,oBAAoB,GAGrB,MAAM,0BAA0B,CAAC"}

package/dist/databaseConnection/databaseConnection.manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"databaseConnection.manager.d.ts","sourceRoot":"","sources":["../../src/databaseConnection/databaseConnection.manager.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,cAAc,EACd,KAAK,qBAAqB,EAC3B,MAAM,0CAA0C,CAAC;AAElD,OAAO,KAAK,EACV,cAAc,EACd,cAAc,EACf,MAAM,sCAAsC,CAAC;AAE9C;;GAEG;AACH,MAAM,MAAM,uBAAuB,GACjC,YAAY,GAAG,WAAW,GAAG,eAAe,GAAG,cAAc,GAAG,OAAO,CAAC;AAE1E;;GAEG;AACH,MAAM,MAAM,0BAA0B,GAAG,CACvC,KAAK,EAAE,uBAAuB,EAC9B,OAAO,EAAE,8BAA8B,KACpC,IAAI,CAAC;AAEV;;GAEG;AACH,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,gCAAiC,SAAQ,qBAAqB;IAC7E,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,qBAAqB,CAAC,EAAE,MAAM,CAAC;CACzC;AAED;;;;;;GAMG;AACH,qBAAa,yBAAyB;IACpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;IAExC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAyC;IAEnE,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAU;IAEtC,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAC,CAAS;IAEhD,OAAO,CAAC,gBAAgB,CAAC,CAAiC;IAE1D,OAAO,CAAC,iBAAiB,CAAC,CAAgB;IAE1C,YAAY,OAAO,GAAE,gCAAqC,EAMzD;IAED;;OAEG;IACU,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAMvC;IAED;;OAEG;IACU,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CA4BpC;IAED;;OAEG;IACU,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAoBvC;IAED;;OAEG;IACU,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAI5C;IAED;;OAEG;IACI,SAAS,IAAI,cAAc,CAEjC;IAED;;OAEG;IACU,WAAW,IAAI,OAAO,CAAC,cAAc,CAAC,CAElD;IAED;;OAEG;IACI,SAAS,IAAI,cAAc,CAEjC;IAED;;OAEG;IACI,EAAE,CAAC,QAAQ,EAAE,0BAA0B,GAAG,MAAM,IAAI,CAU1D;IAED;;OAEG;IACI,GAAG,CAAC,QAAQ,EAAE,0BAA0B,GAAG,OAAO,CAExD;IAED;;OAEG;IACI,kBAAkB,IAAI,IAAI,CAEhC;IAED;;OAEG;IACI,iBAAiB,IAAI,IAAI,CAc/B;IAED;;OAEG;IACI,gBAAgB,IAAI,IAAI,CAQ9B;IAED;;OAEG;IACU,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAMpC;IAED;;OAEG;IACH,OAAO,CAAC,IAAI;IAiBZ;;OAEG;YACW,uBAAuB;IAYrC;;OAEG;IACH,OAAO,CAAC,UAAU;IAUlB;;OAEG;IACH,OAAO,CAAC,cAAc;CAkBvB;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,GAAE,gCAAqC,GAC7C,yBAAyB,CAE3B"}

package/dist/databaseConnection/databaseConnection.manager.js

@@ -0,0 +1,219 @@
+import { DatabaseError } from "@zudojs/errors";
+import { DatabaseClient, } from "../databaseClient/databaseClient.core.js";
+/**
+ * Manages the database connection lifecycle.
+ *
+ * The manager intentionally does not connect during construction.
+ * Application bootstrap should call `connect()` explicitly unless
+ * `autoConnect` is enabled.
+ */
+export class DatabaseConnectionManager {
+    client;
+    listeners = new Set();
+    autoConnect;
+    healthCheckIntervalMs;
+    healthCheckTimer;
+    connectionPromise;
+    constructor(options = {}) {
+        this.client = new DatabaseClient(options);
+        this.autoConnect = options.autoConnect ?? false;
+        this.healthCheckIntervalMs = options.healthCheckIntervalMs;
+    }
+    /**
+     * Initializes the connection manager.
+     */
+    async initialize() {
+        if (!this.autoConnect) {
+            return;
+        }
+        await this.connect();
+    }
+    /**
+     * Opens the database connection.
+     */
+    async connect() {
+        if (this.client.getStatus() === "connected") {
+            return;
+        }
+        if (this.connectionPromise) {
+            return this.connectionPromise;
+        }
+        this.emit("connecting");
+        this.connectionPromise = this.client
+            .connect()
+            .then(() => {
+            this.emit("connected");
+            this.startHealthChecks();
+        })
+            .catch((error) => {
+            this.emit("error", error);
+            throw this.normalizeError(error, "Database connection failed.");
+        })
+            .finally(() => {
+            this.connectionPromise = undefined;
+        });
+        return this.connectionPromise;
+    }
+    /**
+     * Closes the database connection.
+     */
+    async disconnect() {
+        this.stopHealthChecks();
+        const status = this.client.getStatus();
+        if (status === "disconnected" || status === "disconnecting") {
+            return;
+        }
+        this.emit("disconnecting");
+        try {
+            await this.client.disconnect();
+            this.emit("disconnected");
+        }
+        catch (error) {
+            this.emit("error", error);
+            throw this.normalizeError(error, "Database disconnection failed.");
+        }
+    }
+    /**
+     * Ensures that the connection is ready.
+     */
+    async ensureConnected() {
+        if (this.client.getStatus() !== "connected") {
+            await this.connect();
+        }
+    }
+    /**
+     * Returns the current connection status.
+     */
+    getStatus() {
+        return this.client.getStatus();
+    }
+    /**
+     * Performs a database health check.
+     */
+    async healthCheck() {
+        return this.client.healthCheck();
+    }
+    /**
+     * Returns the underlying database client.
+     */
+    getClient() {
+        return this.client;
+    }
+    /**
+     * Subscribes to connection lifecycle events.
+     */
+    on(listener) {
+        if (typeof listener !== "function") {
+            throw new TypeError("A connection listener must be a function.");
+        }
+        this.listeners.add(listener);
+        return () => {
+            this.off(listener);
+        };
+    }
+    /**
+     * Removes a connection listener.
+     */
+    off(listener) {
+        return this.listeners.delete(listener);
+    }
+    /**
+     * Removes all connection listeners.
+     */
+    removeAllListeners() {
+        this.listeners.clear();
+    }
+    /**
+     * Starts periodic database health checks.
+     */
+    startHealthChecks() {
+        this.stopHealthChecks();
+        const interval = this.healthCheckIntervalMs;
+        if (!interval || interval <= 0) {
+            return;
+        }
+        this.healthCheckTimer = setInterval(() => {
+            void this.runScheduledHealthCheck();
+        }, interval);
+        this.unrefTimer();
+    }
+    /**
+     * Stops periodic database health checks.
+     */
+    stopHealthChecks() {
+        if (!this.healthCheckTimer) {
+            return;
+        }
+        clearInterval(this.healthCheckTimer);
+        this.healthCheckTimer = undefined;
+    }
+    /**
+     * Releases connection manager resources.
+     */
+    async destroy() {
+        this.stopHealthChecks();
+        await this.disconnect();
+        this.removeAllListeners();
+    }
+    /**
+     * Emits a connection lifecycle event.
+     */
+    emit(event, error) {
+        const details = Object.freeze({
+            status: this.client.getStatus(),
+            timestamp: new Date(),
+            error,
+        });
+        for (const listener of [...this.listeners]) {
+            try {
+                listener(event, details);
+            }
+            catch {
+                // Connection lifecycle listeners must never break the
+                // database connection lifecycle itself.
+            }
+        }
+    }
+    /**
+     * Runs a scheduled health check.
+     */
+    async runScheduledHealthCheck() {
+        try {
+            const health = await this.healthCheck();
+            if (health.status === "error") {
+                this.emit("error", health.error);
+            }
+        }
+        catch (error) {
+            this.emit("error", error);
+        }
+    }
+    /**
+     * Prevents the health-check timer from keeping Node alive.
+     */
+    unrefTimer() {
+        const timer = this.healthCheckTimer;
+        timer?.unref?.();
+    }
+    /**
+     * Normalizes connection failures.
+     */
+    normalizeError(error, fallbackMessage) {
+        if (error instanceof DatabaseError) {
+            return error;
+        }
+        return new DatabaseError(error instanceof Error ? error.message : fallbackMessage, {
+            cause: error,
+            metadata: {
+                status: this.client.getStatus(),
+            },
+        });
+    }
+}
+/**
+ * Creates a database connection manager.
+ */
+export function createConnectionManager(options = {}) {
+    return new DatabaseConnectionManager(options);
+}
+//# sourceMappingURL=databaseConnection.manager.js.map

package/dist/databaseConnection/databaseConnection.manager.js.map

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

package/dist/databaseConnection/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @zudojs/database — Database Connection
+ *
+ * Connection lifecycle management with health checks.
+ */
+export { DatabaseConnectionManager, createConnectionManager, type DatabaseConnectionEvent, type DatabaseConnectionListener, type DatabaseConnectionEventDetails, type DatabaseConnectionManagerOptions, } from "./databaseConnection.manager.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/databaseConnection/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/databaseConnection/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,yBAAyB,EACzB,uBAAuB,EACvB,KAAK,uBAAuB,EAC5B,KAAK,0BAA0B,EAC/B,KAAK,8BAA8B,EACnC,KAAK,gCAAgC,GACtC,MAAM,iCAAiC,CAAC"}

package/dist/databaseConnection/index.js

@@ -0,0 +1,7 @@
+/**
+ * @zudojs/database — Database Connection
+ *
+ * Connection lifecycle management with health checks.
+ */
+export { DatabaseConnectionManager, createConnectionManager, } from "./databaseConnection.manager.js";
+//# sourceMappingURL=index.js.map

package/dist/databaseConnection/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/databaseConnection/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,yBAAyB,EACzB,uBAAuB,GAKxB,MAAM,iCAAiC,CAAC"}

package/dist/databaseType/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @zudojs/database — Database Types
+ *
+ * Core type definitions for the database package.
+ */
+export * from "./databaseType.type.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/databaseType/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,wBAAwB,CAAC"}

package/dist/databaseType/index.js

@@ -0,0 +1,7 @@
+/**
+ * @zudojs/database — Database Types
+ *
+ * Core type definitions for the database package.
+ */
+export * from "./databaseType.type.js";
+//# sourceMappingURL=index.js.map

package/dist/databaseType/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/databaseType/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,wBAAwB,CAAC"}

package/dist/health/health.check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.check.d.ts","sourceRoot":"","sources":["../../src/health/health.check.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0CAA0C,CAAC;AAI/E;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,SAAS,GAAG,WAAW,GAAG,UAAU,CAAC;AAExE;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,MAAM,EAAE,oBAAoB,CAAC;IACtC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,CAAC,EAAE;QACf,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;KAC1B,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,eAAO,MAAM,yBAAyB,OAAQ,CAAC;AAE/C;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,cAAc,EACtB,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,cAAc,CAAC,CAqCzB;AAED;;;;;GAKG;AACH,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,cAAc,EACtB,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,iBAAiB,CAAC,CAgC5B;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,cAAc,EACtB,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,cAAc,CAAC,CAezB;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,cAAc,EACtB,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,OAAO,CAAC,CAIlB"}

package/dist/health/health.check.js

@@ -0,0 +1,159 @@
+import { DatabaseError } from "@zudojs/errors";
+import { Prisma } from "@prisma/client";
+/**
+ * Default database health-check timeout.
+ */
+export const DEFAULT_HEALTH_TIMEOUT_MS = 5_000;
+/**
+ * Performs a lightweight database health check.
+ */
+export async function checkDatabaseHealth(client, options = {}) {
+    if (!client) {
+        throw new TypeError("A database client is required.");
+    }
+    const timeoutMs = normalizeTimeout(options.timeoutMs);
+    const checkedAt = new Date();
+    const startedAt = performance.now();
+    try {
+        await withTimeout(executeHealthCheck(client), timeoutMs);
+        const latencyMs = Math.max(0, Math.round(performance.now() - startedAt));
+        return {
+            status: latencyMs > timeoutMs * 0.75 ? "degraded" : "healthy",
+            healthy: true,
+            latencyMs,
+            checkedAt,
+            message: "Database connection is healthy.",
+        };
+    }
+    catch (error) {
+        const latencyMs = Math.max(0, Math.round(performance.now() - startedAt));
+        const normalizedError = normalizeHealthError(error);
+        return {
+            status: "unhealthy",
+            healthy: false,
+            latencyMs,
+            checkedAt,
+            message: normalizedError.message,
+            error: normalizedError,
+        };
+    }
+}
+/**
+ * Performs a database readiness check.
+ *
+ * Readiness is intentionally stricter than health. A degraded
+ * connection remains healthy but may still be considered ready.
+ */
+export async function checkDatabaseReadiness(client, options = {}) {
+    if (!client) {
+        throw new TypeError("A database client is required.");
+    }
+    const timeoutMs = normalizeTimeout(options.timeoutMs);
+    const checkedAt = new Date();
+    const startedAt = performance.now();
+    try {
+        await withTimeout(executeHealthCheck(client), timeoutMs);
+        const latencyMs = Math.max(0, Math.round(performance.now() - startedAt));
+        return {
+            ready: true,
+            checkedAt,
+            latencyMs,
+            message: "Database is ready.",
+        };
+    }
+    catch (error) {
+        const latencyMs = Math.max(0, Math.round(performance.now() - startedAt));
+        return {
+            ready: false,
+            checkedAt,
+            latencyMs,
+            message: normalizeHealthError(error).message,
+        };
+    }
+}
+/**
+ * Throws when the database is not healthy.
+ */
+export async function assertDatabaseHealth(client, options = {}) {
+    const health = await checkDatabaseHealth(client, options);
+    if (!health.healthy) {
+        throw new DatabaseError("Database health check failed.", {
+            metadata: {
+                status: health.status,
+                latencyMs: health.latencyMs,
+                checkedAt: health.checkedAt.toISOString(),
+            },
+            cause: health.error ? new Error(health.error.message) : undefined,
+        });
+    }
+    return health;
+}
+/**
+ * Checks whether a database is reachable.
+ */
+export async function isDatabaseHealthy(client, options = {}) {
+    const health = await checkDatabaseHealth(client, options);
+    return health.healthy;
+}
+/**
+ * Executes the lightweight health query.
+ */
+async function executeHealthCheck(client) {
+    try {
+        await client.queryRaw(Prisma.sql `SELECT 1 AS result`);
+    }
+    catch (error) {
+        throw new DatabaseError("Database health query failed.", {
+            cause: error,
+        });
+    }
+}
+/**
+ * Runs a promise with a timeout.
+ */
+async function withTimeout(promise, timeoutMs) {
+    let timeout;
+    try {
+        return await Promise.race([
+            promise,
+            new Promise((_resolve, reject) => {
+                timeout = setTimeout(() => {
+                    reject(new DatabaseError(`Database health check timed out after ${timeoutMs}ms.`));
+                }, timeoutMs);
+            }),
+        ]);
+    }
+    finally {
+        if (timeout) {
+            clearTimeout(timeout);
+        }
+    }
+}
+/**
+ * Normalizes timeout values.
+ */
+function normalizeTimeout(timeoutMs) {
+    if (timeoutMs === undefined) {
+        return DEFAULT_HEALTH_TIMEOUT_MS;
+    }
+    if (!Number.isFinite(timeoutMs) || timeoutMs <= 0) {
+        throw new TypeError("Database health timeout must be a positive finite number.");
+    }
+    return Math.floor(timeoutMs);
+}
+/**
+ * Converts an unknown error into a safe health error.
+ */
+function normalizeHealthError(error) {
+    if (error instanceof Error) {
+        return {
+            name: error.name,
+            message: error.message,
+        };
+    }
+    return {
+        name: "DatabaseHealthError",
+        message: "Database health check failed.",
+    };
+}
+//# sourceMappingURL=health.check.js.map

package/dist/health/health.check.js.map

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

package/dist/health/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @zudojs/database — Health Checks
+ *
+ * Database health and readiness monitoring.
+ */
+export { checkDatabaseHealth, checkDatabaseReadiness, assertDatabaseHealth, isDatabaseHealthy, DEFAULT_HEALTH_TIMEOUT_MS, type DatabaseHealthStatus, type DatabaseHealth, type DatabaseHealthOptions, type DatabaseReadiness, } from "./health.check.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/health/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/health/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,mBAAmB,EACnB,sBAAsB,EACtB,oBAAoB,EACpB,iBAAiB,EACjB,yBAAyB,EACzB,KAAK,oBAAoB,EACzB,KAAK,cAAc,EACnB,KAAK,qBAAqB,EAC1B,KAAK,iBAAiB,GACvB,MAAM,mBAAmB,CAAC"}

package/dist/health/index.js

@@ -0,0 +1,7 @@
+/**
+ * @zudojs/database — Health Checks
+ *
+ * Database health and readiness monitoring.
+ */
+export { checkDatabaseHealth, checkDatabaseReadiness, assertDatabaseHealth, isDatabaseHealthy, DEFAULT_HEALTH_TIMEOUT_MS, } from "./health.check.js";
+//# sourceMappingURL=index.js.map

package/dist/health/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/health/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,mBAAmB,EACnB,sBAAsB,EACtB,oBAAoB,EACpB,iBAAiB,EACjB,yBAAyB,GAK1B,MAAM,mBAAmB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,36 @@
+/**
+ * @zudojs/database
+ *
+ * Shared database infrastructure for the Zudojs platform.
+ *
+ * This package provides:
+ *   • Database client and connection management
+ *   • Repository abstractions
+ *   • Transactions and units of work
+ *   • Query building and filtering
+ *   • Pagination utilities
+ *   • Relation definitions
+ *   • Database locking
+ *   • Caching
+ *   • Migrations
+ *   • Seed management
+ *   • Health and readiness checks
+ */
+export type { DatabaseOperationOptions, DatabaseStatus, TransactionIsolationLevel, DatabaseOperation, DatabaseConnectionOptions, DatabaseHealth as DatabaseHealthInfo, DatabaseMetrics, TransactionOptions, TransactionCallback, Repository, PaginationInput, PaginationMeta, PaginatedResult, SortDirection, SortInput, QueryOptions, DatabaseEntity, SoftDeletableEntity, AuditableEntity, DatabaseErrorInfo, DatabaseLogger, } from "./databaseType/index.js";
+export { noopDatabaseLogger } from "./databaseType/index.js";
+export { DatabaseClient, createDatabaseClient, type DatabaseClientOptions, type DatabaseTransactionContext, } from "./databaseClient/index.js";
+export { DatabaseConnectionManager, createConnectionManager, type DatabaseConnectionEvent, type DatabaseConnectionListener, type DatabaseConnectionEventDetails, type DatabaseConnectionManagerOptions, } from "./databaseConnection/index.js";
+export { Database, createDatabase, getDatabase, connectDatabase, disconnectDatabase, resetDatabase, } from "./database/index.js";
+export { BaseRepository, type RepositoryDelegate, type BaseRepositoryOptions, } from "./repository/index.js";
+export { TransactionManager, createTransactionManager, withTransaction, withTransactionRetry, createTransactionContext, createTransactionId, isTransactionActive, isTransactionCommitted, isTransactionFailed, type TransactionStatus, type TransactionContext, type ManagedTransactionOptions, } from "./transaction/index.js";
+export { DatabaseUnitOfWork, createUnitOfWork, executeUnitOfWork, type UnitOfWork, type UnitOfWorkOptions, } from "./unitOfWork/index.js";
+export { QueryBuilder, createQueryBuilder, type QueryCondition, type QueryFilter, type QueryOperator, type QueryBuilderState, } from "./queryBuilder/index.js";
+export { equals, notEquals, inList, notInList, lessThan, lessThanOrEqual, greaterThan, greaterThanOrEqual, contains, startsWith, endsWith, isNull, isNotNull, and, or, not, condition, allOf, anyOf, fromObject, dateRange, oneOf, noneOf, optionalEquals, optionalContains, hasConditions, flattenAnd, cloneFilter, } from "./queryBuilder/index.js";
+export { normalizePagination, normalizePage, normalizeLimit, calculateOffset, calculateTotalPages, createPaginationMeta, createPaginatedResult, getNextPage, getPreviousPage, isValidPage, getItemRange, paginateCollection, encodeCursor, decodeCursor, normalizeCursorPagination, createCursorPaginationMeta, createCursorPaginatedResult, DEFAULT_PAGE, DEFAULT_LIMIT, MAX_LIMIT, type NormalizedPagination, type CursorPaginationInput, type CursorPaginationMeta, type CursorPaginatedResult, } from "./pagination/index.js";
+export { oneToOne, oneToMany, manyToOne, manyToMany, includeRelation, includeRelations, RelationRegistry, createRelationRegistry, validateRelation, isRelationType, isCollectionRelation, isSingleRelation, type RelationDefinition, type RelationType, type RelationLoadOptions, type RelationInclude, } from "./relations/index.js";
+export { DatabaseLockManager, createLockManager, acquireAdvisoryLock, lockRow, buildLockClause, normalizeAdvisoryKey, type DatabaseLockMode, type DatabaseLockOptions, type DatabaseLockResult, } from "./locks/index.js";
+export { MemoryDatabaseCache, createDatabaseCache, createCacheKey, serializeCachePart, getOrSet, invalidateByPrefix, type CacheEntry, type CacheOptions, type CacheStats, type DatabaseCache, } from "./cache/index.js";
+export { MigrationRunner, createMigrationRunner, normalizeMigrations, validateMigration, getLatestVersion, getCurrentVersion, DEFAULT_MIGRATION_TABLE, DEFAULT_MIGRATION_LOCK, type Migration, type MigrationRecord, type MigrationResult, type MigrationStatus, type MigrationRunnerOptions, } from "./migration/index.js";
+export { SeedRunner, createSeedRunner, normalizeSeeds, validateSeed, DEFAULT_SEED_TABLE, DEFAULT_SEED_LOCK, type Seed, type SeedRecord, type SeedResult, type SeedRunnerOptions, } from "./seed/index.js";
+export { checkDatabaseHealth, checkDatabaseReadiness, assertDatabaseHealth, isDatabaseHealthy, DEFAULT_HEALTH_TIMEOUT_MS, type DatabaseHealthStatus, type DatabaseHealth, type DatabaseHealthOptions, type DatabaseReadiness, } from "./health/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,49 @@
+/**
+ * @zudojs/database
+ *
+ * Shared database infrastructure for the Zudojs platform.
+ *
+ * This package provides:
+ *   • Database client and connection management
+ *   • Repository abstractions
+ *   • Transactions and units of work
+ *   • Query building and filtering
+ *   • Pagination utilities
+ *   • Relation definitions
+ *   • Database locking
+ *   • Caching
+ *   • Migrations
+ *   • Seed management
+ *   • Health and readiness checks
+ */
+export { noopDatabaseLogger } from "./databaseType/index.js";
+// Client
+export { DatabaseClient, createDatabaseClient, } from "./databaseClient/index.js";
+// Connection
+export { DatabaseConnectionManager, createConnectionManager, } from "./databaseConnection/index.js";
+// Database facade
+export { Database, createDatabase, getDatabase, connectDatabase, disconnectDatabase, resetDatabase, } from "./database/index.js";
+// Repository
+export { BaseRepository, } from "./repository/index.js";
+// Transactions
+export { TransactionManager, createTransactionManager, withTransaction, withTransactionRetry, createTransactionContext, createTransactionId, isTransactionActive, isTransactionCommitted, isTransactionFailed, } from "./transaction/index.js";
+// Unit of Work
+export { DatabaseUnitOfWork, createUnitOfWork, executeUnitOfWork, } from "./unitOfWork/index.js";
+// Query Builder
+export { QueryBuilder, createQueryBuilder, } from "./queryBuilder/index.js";
+export { equals, notEquals, inList, notInList, lessThan, lessThanOrEqual, greaterThan, greaterThanOrEqual, contains, startsWith, endsWith, isNull, isNotNull, and, or, not, condition, allOf, anyOf, fromObject, dateRange, oneOf, noneOf, optionalEquals, optionalContains, hasConditions, flattenAnd, cloneFilter, } from "./queryBuilder/index.js";
+// Pagination
+export { normalizePagination, normalizePage, normalizeLimit, calculateOffset, calculateTotalPages, createPaginationMeta, createPaginatedResult, getNextPage, getPreviousPage, isValidPage, getItemRange, paginateCollection, encodeCursor, decodeCursor, normalizeCursorPagination, createCursorPaginationMeta, createCursorPaginatedResult, DEFAULT_PAGE, DEFAULT_LIMIT, MAX_LIMIT, } from "./pagination/index.js";
+// Relations
+export { oneToOne, oneToMany, manyToOne, manyToMany, includeRelation, includeRelations, RelationRegistry, createRelationRegistry, validateRelation, isRelationType, isCollectionRelation, isSingleRelation, } from "./relations/index.js";
+// Locks
+export { DatabaseLockManager, createLockManager, acquireAdvisoryLock, lockRow, buildLockClause, normalizeAdvisoryKey, } from "./locks/index.js";
+// Cache
+export { MemoryDatabaseCache, createDatabaseCache, createCacheKey, serializeCachePart, getOrSet, invalidateByPrefix, } from "./cache/index.js";
+// Migrations
+export { MigrationRunner, createMigrationRunner, normalizeMigrations, validateMigration, getLatestVersion, getCurrentVersion, DEFAULT_MIGRATION_TABLE, DEFAULT_MIGRATION_LOCK, } from "./migration/index.js";
+// Seeds
+export { SeedRunner, createSeedRunner, normalizeSeeds, validateSeed, DEFAULT_SEED_TABLE, DEFAULT_SEED_LOCK, } from "./seed/index.js";
+// Health
+export { checkDatabaseHealth, checkDatabaseReadiness, assertDatabaseHealth, isDatabaseHealthy, DEFAULT_HEALTH_TIMEOUT_MS, } from "./health/index.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/locks/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @zudojs/database — Locks
+ *
+ * Advisory and row-level database locking.
+ */
+export { DatabaseLockManager, createLockManager, acquireAdvisoryLock, lockRow, buildLockClause, normalizeAdvisoryKey, type DatabaseLockMode, type DatabaseLockOptions, type DatabaseLockResult, } from "./locks.core.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/locks/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/locks/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,mBAAmB,EACnB,OAAO,EACP,eAAe,EACf,oBAAoB,EACpB,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,GACxB,MAAM,iBAAiB,CAAC"}

package/dist/locks/index.js

@@ -0,0 +1,7 @@
+/**
+ * @zudojs/database — Locks
+ *
+ * Advisory and row-level database locking.
+ */
+export { DatabaseLockManager, createLockManager, acquireAdvisoryLock, lockRow, buildLockClause, normalizeAdvisoryKey, } from "./locks.core.js";
+//# sourceMappingURL=index.js.map

package/dist/locks/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/locks/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,mBAAmB,EACnB,OAAO,EACP,eAAe,EACf,oBAAoB,GAIrB,MAAM,iBAAiB,CAAC"}