@zudojs/database 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Zudojs Contributors
+
+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,38 @@
+# @zudojs/database
+
+Database abstraction layer with clients, repositories, transactions, and query building for Zudojs applications.
+
+## Installation
+
+```bash
+npm install @zudojs/database
+```
+
+## Quick Start
+
+```typescript
+import { createDatabaseClient } from "@zudojs/database";
+
+const client = await createDatabaseClient({
+  connection: { url: "postgresql://localhost/mydb" },
+});
+
+const users = await client.repository("User").findMany();
+```
+
+## Features
+
+- Database-agnostic query builder
+- Repository pattern with CRUD operations
+- Transaction management with savepoints
+- Connection pooling and health checks
+- Migration runner
+- Seed runner for test data
+- Unit of Work pattern
+
+## Use Cases
+
+- Data access layer for applications
+- Multi-database support (PostgreSQL, MySQL, SQLite)
+- Transaction coordination across repositories
+- Database migrations and seeding

package/dist/cache/cache.memory.d.ts.map

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

package/dist/cache/cache.memory.js

@@ -0,0 +1,226 @@
+import { DatabaseError } from "@zudojs/errors";
+/**
+ * In-memory cache implementation for database read results.
+ *
+ * This cache is intentionally process-local. It should not be used
+ * where multiple application instances require shared cache state.
+ */
+export class MemoryDatabaseCache {
+    entries = new Map();
+    hits = 0;
+    misses = 0;
+    defaultTtlMs;
+    constructor(options = {}) {
+        this.defaultTtlMs = normalizeTtl(options.ttlMs);
+    }
+    /**
+     * Gets a cached value.
+     */
+    get(key) {
+        validateKey(key);
+        const entry = this.entries.get(key);
+        if (!entry) {
+            this.misses += 1;
+            return undefined;
+        }
+        if (isExpired(entry)) {
+            this.entries.delete(key);
+            this.misses += 1;
+            return undefined;
+        }
+        this.hits += 1;
+        return entry.value;
+    }
+    /**
+     * Sets a cached value.
+     */
+    set(key, value, options = {}) {
+        validateKey(key);
+        const ttlMs = normalizeTtl(options.ttlMs ?? this.defaultTtlMs);
+        const createdAt = Date.now();
+        this.entries.set(key, {
+            value,
+            createdAt,
+            expiresAt: ttlMs === undefined ? undefined : createdAt + ttlMs,
+        });
+    }
+    /**
+     * Checks whether a valid cached value exists.
+     */
+    has(key) {
+        validateKey(key);
+        const entry = this.entries.get(key);
+        if (!entry) {
+            return false;
+        }
+        if (isExpired(entry)) {
+            this.entries.delete(key);
+            return false;
+        }
+        return true;
+    }
+    /**
+     * Deletes a cache entry.
+     */
+    delete(key) {
+        validateKey(key);
+        return this.entries.delete(key);
+    }
+    /**
+     * Clears the entire cache.
+     */
+    clear() {
+        this.entries.clear();
+    }
+    /**
+     * Removes expired entries.
+     */
+    prune() {
+        let removed = 0;
+        for (const [key, entry] of this.entries) {
+            if (isExpired(entry)) {
+                this.entries.delete(key);
+                removed += 1;
+            }
+        }
+        return removed;
+    }
+    /**
+     * Returns the number of valid entries.
+     */
+    get size() {
+        this.prune();
+        return this.entries.size;
+    }
+    /**
+     * Returns cache statistics.
+     */
+    getStats() {
+        this.prune();
+        const total = this.hits + this.misses;
+        return {
+            size: this.entries.size,
+            hits: this.hits,
+            misses: this.misses,
+            hitRate: total === 0 ? 0 : this.hits / total,
+        };
+    }
+    /**
+     * Resets hit/miss counters.
+     */
+    resetStats() {
+        this.hits = 0;
+        this.misses = 0;
+    }
+    /**
+     * Returns all currently valid cache keys.
+     */
+    keys() {
+        this.prune();
+        return Object.freeze([...this.entries.keys()]);
+    }
+}
+/**
+ * Creates an in-memory database cache.
+ */
+export function createDatabaseCache(options = {}) {
+    return new MemoryDatabaseCache(options);
+}
+/**
+ * Builds a stable cache key from a namespace and parts.
+ */
+export function createCacheKey(namespace, ...parts) {
+    validateKey(namespace);
+    return [namespace, ...parts.map(serializeCachePart)].join(":");
+}
+/**
+ * Serializes a cache key component deterministically.
+ */
+export function serializeCachePart(value) {
+    if (value === null) {
+        return "null";
+    }
+    if (value === undefined) {
+        return "undefined";
+    }
+    if (typeof value === "string" ||
+        typeof value === "number" ||
+        typeof value === "boolean" ||
+        typeof value === "bigint") {
+        return String(value);
+    }
+    if (value instanceof Date) {
+        return value.toISOString();
+    }
+    try {
+        return JSON.stringify(value, Object.keys(value).sort());
+    }
+    catch (error) {
+        throw new DatabaseError("Unable to serialize database cache key.", {
+            cause: error,
+        });
+    }
+}
+/**
+ * Wraps a cache around an asynchronous loader.
+ */
+export async function getOrSet(cache, key, loader, options) {
+    validateKey(key);
+    if (typeof loader !== "function") {
+        throw new TypeError("A cache loader function is required.");
+    }
+    const cached = cache.get(key);
+    if (cached !== undefined) {
+        return cached;
+    }
+    const value = await loader();
+    cache.set(key, value, options);
+    return value;
+}
+/**
+ * Invalidates all entries whose keys start with a prefix.
+ *
+ * This is useful when a write invalidates a group of related reads.
+ */
+export function invalidateByPrefix(cache, prefix) {
+    validateKey(prefix);
+    let removed = 0;
+    for (const key of cache.keys()) {
+        if (key.startsWith(prefix)) {
+            if (cache.delete(key)) {
+                removed += 1;
+            }
+        }
+    }
+    return removed;
+}
+/**
+ * Checks whether a cache entry has expired.
+ */
+function isExpired(entry) {
+    return entry.expiresAt !== undefined && entry.expiresAt <= Date.now();
+}
+/**
+ * Normalizes a TTL value.
+ */
+function normalizeTtl(ttlMs) {
+    if (ttlMs === undefined) {
+        return undefined;
+    }
+    if (!Number.isFinite(ttlMs)) {
+        throw new TypeError("Cache TTL must be a finite number.");
+    }
+    if (ttlMs < 0) {
+        throw new TypeError("Cache TTL cannot be negative.");
+    }
+    return Math.floor(ttlMs);
+}
+/**
+ * Validates a cache key.
+ */
+function validateKey(key) {
+    if (typeof key !== "string" || key.trim().length === 0) {
+        throw new TypeError("A non-empty cache key is required.");
+    }
+}
+//# sourceMappingURL=cache.memory.js.map

package/dist/cache/cache.memory.js.map

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

package/dist/cache/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @zudojs/database — Database Cache
+ *
+ * In-memory cache for database read results.
+ */
+export { MemoryDatabaseCache, createDatabaseCache, createCacheKey, serializeCachePart, getOrSet, invalidateByPrefix, type CacheEntry, type CacheOptions, type CacheStats, type DatabaseCache, } from "./cache.memory.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cache/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,cAAc,EACd,kBAAkB,EAClB,QAAQ,EACR,kBAAkB,EAClB,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,aAAa,GACnB,MAAM,mBAAmB,CAAC"}

package/dist/cache/index.js

@@ -0,0 +1,7 @@
+/**
+ * @zudojs/database — Database Cache
+ *
+ * In-memory cache for database read results.
+ */
+export { MemoryDatabaseCache, createDatabaseCache, createCacheKey, serializeCachePart, getOrSet, invalidateByPrefix, } from "./cache.memory.js";
+//# sourceMappingURL=index.js.map

package/dist/cache/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cache/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,cAAc,EACd,kBAAkB,EAClB,QAAQ,EACR,kBAAkB,GAKnB,MAAM,mBAAmB,CAAC"}

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

@@ -0,0 +1 @@
+{"version":3,"file":"database.core.d.ts","sourceRoot":"","sources":["../../src/database/database.core.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,qBAAqB,EAC1B,KAAK,0BAA0B,EAChC,MAAM,0CAA0C,CAAC;AAElD,OAAO,KAAK,EACV,cAAc,EACd,cAAc,EACd,mBAAmB,EACnB,kBAAkB,EACnB,MAAM,sCAAsC,CAAC;AAE9C;;;;;;GAMG;AACH,qBAAa,QAAQ;IACnB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;IAExC,YAAY,OAAO,GAAE,qBAA0B,EAE9C;IAED;;OAEG;IACU,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAEpC;IAED;;OAEG;IACU,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAEvC;IAED;;OAEG;IACU,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAE5C;IAED;;OAEG;IACU,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAEjC;IAED;;OAEG;IACI,SAAS,IAAI,cAAc,CAEjC;IAED;;OAEG;IACU,WAAW,IAAI,OAAO,CAAC,cAAc,CAAC,CAElD;IAED;;OAEG;IACU,WAAW,CAAC,OAAO,EAC9B,QAAQ,EAAE,mBAAmB,CAAC,0BAA0B,EAAE,OAAO,CAAC,EAClE,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,OAAO,CAAC,CAElB;IAED;;;;;OAKG;IACI,SAAS,IAAI,cAAc,CAEjC;IAED;;OAEG;IACI,SAAS,wEAEf;IAED;;OAEG;IACU,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAEpC;CACF;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,GAAE,qBAA0B,GAAG,QAAQ,CAE5E;AAUD;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,OAAO,GAAE,qBAA0B,GAAG,QAAQ,CAMzE;AAED;;GAEG;AACH,wBAAsB,eAAe,CACnC,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,QAAQ,CAAC,CAMnB;AAED;;GAEG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC,CAMxD;AAED;;;;;GAKG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAQnD"}

package/dist/database/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @zudojs/database — Database Facade
+ *
+ * High-level database lifecycle entry point.
+ */
+export { Database, createDatabase, getDatabase, connectDatabase, disconnectDatabase, resetDatabase, } from "./database.core.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/database/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,QAAQ,EACR,cAAc,EACd,WAAW,EACX,eAAe,EACf,kBAAkB,EAClB,aAAa,GACd,MAAM,oBAAoB,CAAC"}

package/dist/database/index.js

@@ -0,0 +1,7 @@
+/**
+ * @zudojs/database — Database Facade
+ *
+ * High-level database lifecycle entry point.
+ */
+export { Database, createDatabase, getDatabase, connectDatabase, disconnectDatabase, resetDatabase, } from "./database.core.js";
+//# sourceMappingURL=index.js.map

package/dist/database/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/database/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,QAAQ,EACR,cAAc,EACd,WAAW,EACX,eAAe,EACf,kBAAkB,EAClB,aAAa,GACd,MAAM,oBAAoB,CAAC"}

package/dist/databaseClient/databaseClient.core.d.ts

@@ -0,0 +1,42 @@
+/**
+ * @zudojs/database — Database Client Core
+ *
+ * Prisma-backed database client implementation.
+ */
+import { PrismaClient, Prisma } from "@prisma/client";
+import type { DatabaseClient as DatabaseClientContract, DatabaseConnectionOptions, DatabaseHealth, DatabaseLogger, DatabaseStatus, TransactionCallback, TransactionOptions } from "../databaseType/databaseType.type.js";
+export type PrismaClientLike = PrismaClient;
+export interface DatabaseClientOptions extends DatabaseConnectionOptions {
+    readonly logger?: DatabaseLogger;
+    readonly prisma?: PrismaClientLike;
+}
+export type DatabaseTransactionContext = Prisma.TransactionClient;
+/** Prisma-backed database client. */
+export declare class DatabaseClient implements DatabaseClientContract<DatabaseTransactionContext> {
+    private readonly prisma;
+    private readonly logger;
+    private readonly options;
+    private status;
+    private connectedAt?;
+    constructor(options?: DatabaseClientOptions);
+    getPrisma(): PrismaClientLike;
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    ping(): Promise<void>;
+    getStatus(): DatabaseStatus;
+    getConnectedAt(): Date | undefined;
+    healthCheck(): Promise<DatabaseHealth>;
+    transaction<TResult>(callback: TransactionCallback<DatabaseTransactionContext, TResult>, options?: TransactionOptions): Promise<TResult>;
+    executeRaw(query: Prisma.Sql): Promise<number>;
+    queryRaw<TResult = unknown>(query: Prisma.Sql): Promise<TResult>;
+    ensureConnected(): Promise<void>;
+    destroy(): Promise<void>;
+    private registerQueryLogging;
+    private buildTransactionOptions;
+    private mapIsolationLevel;
+    private withTimeout;
+    private normalizeError;
+}
+/** Creates a database client. */
+export declare function createDatabaseClient(options?: DatabaseClientOptions): DatabaseClient;
+//# sourceMappingURL=databaseClient.core.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"databaseClient.core.d.ts","sourceRoot":"","sources":["../../src/databaseClient/databaseClient.core.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAEtD,OAAO,KAAK,EACV,cAAc,IAAI,sBAAsB,EACxC,yBAAyB,EACzB,cAAc,EACd,cAAc,EACd,cAAc,EACd,mBAAmB,EACnB,kBAAkB,EACnB,MAAM,sCAAsC,CAAC;AAG9C,MAAM,MAAM,gBAAgB,GAAG,YAAY,CAAC;AAE5C,MAAM,WAAW,qBAAsB,SAAQ,yBAAyB;IACtE,QAAQ,CAAC,MAAM,CAAC,EAAE,cAAc,CAAC;IACjC,QAAQ,CAAC,MAAM,CAAC,EAAE,gBAAgB,CAAC;CACpC;AAED,MAAM,MAAM,0BAA0B,GAAG,MAAM,CAAC,iBAAiB,CAAC;AAElE,qCAAqC;AACrC,qBAAa,cAAe,YAAW,sBAAsB,CAAC,0BAA0B,CAAC;IACvF,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmB;IAC1C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;IACxC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwB;IAChD,OAAO,CAAC,MAAM,CAAkC;IAChD,OAAO,CAAC,WAAW,CAAC,CAAO;IAE3B,YAAY,OAAO,GAAE,qBAA0B,EAe9C;IAEM,SAAS,IAAI,gBAAgB,CAEnC;IAEY,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAqBpC;IAEY,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAiBvC;IAEY,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAOjC;IAEM,SAAS,IAAI,cAAc,CAEjC;IACM,cAAc,IAAI,IAAI,GAAG,SAAS,CAExC;IAEY,WAAW,IAAI,OAAO,CAAC,cAAc,CAAC,CAqBlD;IAEY,WAAW,CAAC,OAAO,EAC9B,QAAQ,EAAE,mBAAmB,CAAC,0BAA0B,EAAE,OAAO,CAAC,EAClE,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,OAAO,CAAC,CAkBlB;IAEY,UAAU,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC,CAO1D;IAEY,QAAQ,CAAC,OAAO,GAAG,OAAO,EACrC,KAAK,EAAE,MAAM,CAAC,GAAG,GAChB,OAAO,CAAC,OAAO,CAAC,CAOlB;IAEY,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAE5C;IAEY,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAEpC;IAED,OAAO,CAAC,oBAAoB;IAqB5B,OAAO,CAAC,uBAAuB;IAU/B,OAAO,CAAC,iBAAiB;YAmBX,WAAW;IAmBzB,OAAO,CAAC,cAAc;CAUvB;AAED,iCAAiC;AACjC,wBAAgB,oBAAoB,CAClC,OAAO,GAAE,qBAA0B,GAClC,cAAc,CAEhB"}

package/dist/databaseClient/databaseClient.core.js

@@ -0,0 +1,203 @@
+/**
+ * @zudojs/database — Database Client Core
+ *
+ * Prisma-backed database client implementation.
+ */
+import { PrismaClient, Prisma } from "@prisma/client";
+import { DatabaseError } from "@zudojs/errors";
+import { createDefaultLogger } from "./databaseClient.logger.js";
+/** Prisma-backed database client. */
+export class DatabaseClient {
+    prisma;
+    logger;
+    options;
+    status = "disconnected";
+    connectedAt;
+    constructor(options = {}) {
+        this.options = options;
+        this.logger = options.logger ?? createDefaultLogger();
+        this.prisma =
+            options.prisma ??
+                new PrismaClient({
+                    log: options.logging
+                        ? [
+                            { emit: "event", level: "query" },
+                            { emit: "stdout", level: "error" },
+                            { emit: "stdout", level: "warn" },
+                        ]
+                        : [{ emit: "stdout", level: "error" }],
+                });
+        this.registerQueryLogging();
+    }
+    getPrisma() {
+        return this.prisma;
+    }
+    async connect() {
+        if (this.status === "connected" || this.status === "connecting")
+            return;
+        this.status = "connecting";
+        try {
+            await this.withTimeout(this.prisma.$connect(), this.options.connectionTimeoutMs ?? 10_000, "Database connection timed out.");
+            this.status = "connected";
+            this.connectedAt = new Date();
+            this.logger.info("Database connected.");
+        }
+        catch (error) {
+            this.status = "error";
+            const normalized = this.normalizeError(error, "Database connection failed.");
+            this.logger.error(normalized.message, normalized);
+            throw normalized;
+        }
+    }
+    async disconnect() {
+        if (this.status === "disconnected")
+            return;
+        this.status = "disconnecting";
+        try {
+            await this.prisma.$disconnect();
+            this.status = "disconnected";
+            this.connectedAt = undefined;
+            this.logger.info("Database disconnected.");
+        }
+        catch (error) {
+            this.status = "error";
+            const normalized = this.normalizeError(error, "Database disconnection failed.");
+            this.logger.error(normalized.message, normalized);
+            throw normalized;
+        }
+    }
+    async ping() {
+        try {
+            await this.prisma.$queryRaw `SELECT 1`;
+        }
+        catch (error) {
+            this.status = "error";
+            throw this.normalizeError(error, "Database ping failed.");
+        }
+    }
+    getStatus() {
+        return this.status;
+    }
+    getConnectedAt() {
+        return this.connectedAt;
+    }
+    async healthCheck() {
+        const startedAt = Date.now();
+        try {
+            await this.ping();
+            return {
+                status: "connected",
+                latencyMs: Date.now() - startedAt,
+                checkedAt: new Date(),
+            };
+        }
+        catch (error) {
+            const normalized = this.normalizeError(error, "Database health check failed.");
+            return {
+                status: "error",
+                latencyMs: Date.now() - startedAt,
+                checkedAt: new Date(),
+                error: normalized.message,
+            };
+        }
+    }
+    async transaction(callback, options = {}) {
+        if (typeof callback !== "function")
+            throw new TypeError("A transaction callback is required.");
+        await this.ensureConnected();
+        const transactionOptions = this.buildTransactionOptions(options);
+        try {
+            return await this.prisma.$transaction(async (transaction) => callback(transaction), transactionOptions);
+        }
+        catch (error) {
+            const normalized = this.normalizeError(error, "Database transaction failed.");
+            this.logger.error(normalized.message, normalized);
+            throw normalized;
+        }
+    }
+    async executeRaw(query) {
+        await this.ensureConnected();
+        try {
+            return await this.prisma.$executeRaw(query);
+        }
+        catch (error) {
+            throw this.normalizeError(error, "Raw database execution failed.");
+        }
+    }
+    async queryRaw(query) {
+        await this.ensureConnected();
+        try {
+            return (await this.prisma.$queryRaw(query));
+        }
+        catch (error) {
+            throw this.normalizeError(error, "Raw database query failed.");
+        }
+    }
+    async ensureConnected() {
+        if (this.status !== "connected")
+            await this.connect();
+    }
+    async destroy() {
+        await this.disconnect();
+    }
+    registerQueryLogging() {
+        if (!this.options.logging)
+            return;
+        const prisma = this.prisma;
+        prisma.$on?.("query", (event) => {
+            this.logger.debug("Database query executed.", {
+                durationMs: event.duration,
+                target: event.target,
+            });
+        });
+    }
+    buildTransactionOptions(options) {
+        return {
+            maxWait: options.maxWaitMs,
+            timeout: options.timeoutMs,
+            isolationLevel: options.isolationLevel
+                ? this.mapIsolationLevel(options.isolationLevel)
+                : undefined,
+        };
+    }
+    mapIsolationLevel(level) {
+        switch (level) {
+            case "ReadUncommitted":
+                return Prisma.TransactionIsolationLevel.ReadUncommitted;
+            case "ReadCommitted":
+                return Prisma.TransactionIsolationLevel.ReadCommitted;
+            case "RepeatableRead":
+                return Prisma.TransactionIsolationLevel.RepeatableRead;
+            case "Serializable":
+                return Prisma.TransactionIsolationLevel.Serializable;
+            default:
+                throw new TypeError(`Unsupported transaction isolation level: ${String(level)}`);
+        }
+    }
+    async withTimeout(promise, timeoutMs, message) {
+        if (timeoutMs <= 0)
+            return promise;
+        let timer;
+        const timeout = new Promise((_, reject) => {
+            timer = setTimeout(() => {
+                reject(new DatabaseError(message));
+            }, timeoutMs);
+        });
+        try {
+            return await Promise.race([promise, timeout]);
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+    normalizeError(error, fallbackMessage) {
+        if (error instanceof DatabaseError)
+            return error;
+        return new DatabaseError(error instanceof Error ? error.message : fallbackMessage, { cause: error });
+    }
+}
+/** Creates a database client. */
+export function createDatabaseClient(options = {}) {
+    return new DatabaseClient(options);
+}
+//# sourceMappingURL=databaseClient.core.js.map

package/dist/databaseClient/databaseClient.core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"databaseClient.core.js","sourceRoot":"","sources":["../../src/databaseClient/databaseClient.core.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAU/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAWjE,qCAAqC;AACrC,MAAM,OAAO,cAAc;IACR,MAAM,CAAmB;IACzB,MAAM,CAAiB;IACvB,OAAO,CAAwB;IACxC,MAAM,GAAmB,cAAc,CAAC;IACxC,WAAW,CAAQ;IAE3B,YAAY,OAAO,GAA0B,EAAE;QAC7C,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,mBAAmB,EAAE,CAAC;QACtD,IAAI,CAAC,MAAM;YACT,OAAO,CAAC,MAAM;gBACd,IAAI,YAAY,CAAC;oBACf,GAAG,EAAE,OAAO,CAAC,OAAO;wBAClB,CAAC,CAAC;4BACE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE;4BACjC,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE;4BAClC,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE;yBAClC;wBACH,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;iBACzC,CAAC,CAAC;QACL,IAAI,CAAC,oBAAoB,EAAE,CAAC;IAC9B,CAAC;IAEM,SAAS;QACd,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAEM,KAAK,CAAC,OAAO;QAClB,IAAI,IAAI,CAAC,MAAM,KAAK,WAAW,IAAI,IAAI,CAAC,MAAM,KAAK,YAAY;YAAE,OAAO;QACxE,IAAI,CAAC,MAAM,GAAG,YAAY,CAAC;QAC3B,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,WAAW,CACpB,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,EACtB,IAAI,CAAC,OAAO,CAAC,mBAAmB,IAAI,MAAM,EAC1C,gCAAgC,CACjC,CAAC;YACF,IAAI,CAAC,MAAM,GAAG,WAAW,CAAC;YAC1B,IAAI,CAAC,WAAW,GAAG,IAAI,IAAI,EAAE,CAAC;YAC9B,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;QAC1C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC;YACtB,MAAM,UAAU,GAAG,IAAI,CAAC,cAAc,CACpC,KAAK,EACL,6BAA6B,CAC9B,CAAC;YACF,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;YAClD,MAAM,UAAU,CAAC;QACnB,CAAC;IACH,CAAC;IAEM,KAAK,CAAC,UAAU;QACrB,IAAI,IAAI,CAAC,MAAM,KAAK,cAAc;YAAE,OAAO;QAC3C,IAAI,CAAC,MAAM,GAAG,eAAe,CAAC;QAC9B,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;YAChC,IAAI,CAAC,MAAM,GAAG,cAAc,CAAC;YAC7B,IAAI,CAAC,WAAW,GAAG,SAAS,CAAC;YAC7B,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;QAC7C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC;YACtB,MAAM,UAAU,GAAG,IAAI,CAAC,cAAc,CACpC,KAAK,EACL,gCAAgC,CACjC,CAAC;YACF,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;YAClD,MAAM,UAAU,CAAC;QACnB,CAAC;IACH,CAAC;IAEM,KAAK,CAAC,IAAI;QACf,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,MAAM,CAAC,SAAS,CAAA,UAAU,CAAC;QACxC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC;YACtB,MAAM,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,uBAAuB,CAAC,CAAC;QAC5D,CAAC;IACH,CAAC;IAEM,SAAS;QACd,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IACM,cAAc;QACnB,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAEM,KAAK,CAAC,WAAW;QACtB,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC7B,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;YAClB,OAAO;gBACL,MAAM,EAAE,WAAW;gBACnB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;gBACjC,SAAS,EAAE,IAAI,IAAI,EAAE;aACtB,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,UAAU,GAAG,IAAI,CAAC,cAAc,CACpC,KAAK,EACL,+BAA+B,CAChC,CAAC;YACF,OAAO;gBACL,MAAM,EAAE,OAAO;gBACf,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;gBACjC,SAAS,EAAE,IAAI,IAAI,EAAE;gBACrB,KAAK,EAAE,UAAU,CAAC,OAAO;aAC1B,CAAC;QACJ,CAAC;IACH,CAAC;IAEM,KAAK,CAAC,WAAW,CACtB,QAAkE,EAClE,OAAO,GAAuB,EAAE;QAEhC,IAAI,OAAO,QAAQ,KAAK,UAAU;YAChC,MAAM,IAAI,SAAS,CAAC,qCAAqC,CAAC,CAAC;QAC7D,MAAM,IAAI,CAAC,eAAe,EAAE,CAAC;QAC7B,MAAM,kBAAkB,GAAG,IAAI,CAAC,uBAAuB,CAAC,OAAO,CAAC,CAAC;QACjE,IAAI,CAAC;YACH,OAAO,MAAM,IAAI,CAAC,MAAM,CAAC,YAAY,CACnC,KAAK,EAAE,WAAW,EAAE,EAAE,CAAC,QAAQ,CAAC,WAAW,CAAC,EAC5C,kBAAkB,CACnB,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,UAAU,GAAG,IAAI,CAAC,cAAc,CACpC,KAAK,EACL,8BAA8B,CAC/B,CAAC;YACF,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;YAClD,MAAM,UAAU,CAAC;QACnB,CAAC;IACH,CAAC;IAEM,KAAK,CAAC,UAAU,CAAC,KAAiB;QACvC,MAAM,IAAI,CAAC,eAAe,EAAE,CAAC;QAC7B,IAAI,CAAC;YACH,OAAO,MAAM,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;QAC9C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,gCAAgC,CAAC,CAAC;QACrE,CAAC;IACH,CAAC;IAEM,KAAK,CAAC,QAAQ,CACnB,KAAiB;QAEjB,MAAM,IAAI,CAAC,eAAe,EAAE,CAAC;QAC7B,IAAI,CAAC;YACH,OAAO,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAY,CAAC;QACzD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,4BAA4B,CAAC,CAAC;QACjE,CAAC;IACH,CAAC;IAEM,KAAK,CAAC,eAAe;QAC1B,IAAI,IAAI,CAAC,MAAM,KAAK,WAAW;YAAE,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;IACxD,CAAC;IAEM,KAAK,CAAC,OAAO;QAClB,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC;IAC1B,CAAC;IAEO,oBAAoB;QAC1B,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO;YAAE,OAAO;QAClC,MAAM,MAAM,GAAG,IAAI,CAAC,MAUnB,CAAC;QACF,MAAM,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;YAC9B,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,0BAA0B,EAAE;gBAC5C,UAAU,EAAE,KAAK,CAAC,QAAQ;gBAC1B,MAAM,EAAE,KAAK,CAAC,MAAM;aACrB,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,uBAAuB,CAAC,OAA2B;QACzD,OAAO;YACL,OAAO,EAAE,OAAO,CAAC,SAAS;YAC1B,OAAO,EAAE,OAAO,CAAC,SAAS;YAC1B,cAAc,EAAE,OAAO,CAAC,cAAc;gBACpC,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,OAAO,CAAC,cAAc,CAAC;gBAChD,CAAC,CAAC,SAAS;SACd,CAAC;IACJ,CAAC;IAEO,iBAAiB,CACvB,KAAwD;QAExD,QAAQ,KAAK,EAAE,CAAC;YACd,KAAK,iBAAiB;gBACpB,OAAO,MAAM,CAAC,yBAAyB,CAAC,eAAe,CAAC;YAC1D,KAAK,eAAe;gBAClB,OAAO,MAAM,CAAC,yBAAyB,CAAC,aAAa,CAAC;YACxD,KAAK,gBAAgB;gBACnB,OAAO,MAAM,CAAC,yBAAyB,CAAC,cAAc,CAAC;YACzD,KAAK,cAAc;gBACjB,OAAO,MAAM,CAAC,yBAAyB,CAAC,YAAY,CAAC;YACvD;gBACE,MAAM,IAAI,SAAS,CACjB,4CAA4C,MAAM,CAAC,KAAK,CAAC,EAAE,CAC5D,CAAC;QACN,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,WAAW,CACvB,OAAmB,EACnB,SAAiB,EACjB,OAAe;QAEf,IAAI,SAAS,IAAI,CAAC;YAAE,OAAO,OAAO,CAAC;QACnC,IAAI,KAAoC,CAAC;QACzC,MAAM,OAAO,GAAG,IAAI,OAAO,CAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE;YAC/C,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;gBACtB,MAAM,CAAC,IAAI,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC;YACrC,CAAC,EAAE,SAAS,CAAC,CAAC;QAChB,CAAC,CAAC,CAAC;QACH,IAAI,CAAC;YACH,OAAO,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;QAChD,CAAC;gBAAS,CAAC;YACT,YAAY,CAAC,KAAM,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;IAEO,cAAc,CACpB,KAAc,EACd,eAAuB;QAEvB,IAAI,KAAK,YAAY,aAAa;YAAE,OAAO,KAAK,CAAC;QACjD,OAAO,IAAI,aAAa,CACtB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,EACxD,EAAE,KAAK,EAAE,KAAK,EAAE,CACjB,CAAC;IACJ,CAAC;CACF;AAED,iCAAiC;AACjC,MAAM,UAAU,oBAAoB,CAClC,OAAO,GAA0B,EAAE;IAEnC,OAAO,IAAI,cAAc,CAAC,OAAO,CAAC,CAAC;AACrC,CAAC"}

package/dist/databaseClient/databaseClient.logger.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @zudojs/database — Default Logger
+ *
+ * Minimal logger for environments where no application logger has been configured yet.
+ */
+import type { DatabaseLogger } from "../databaseType/databaseType.type.js";
+/** Creates a minimal logger for environments where no application logger has been configured yet. */
+export declare function createDefaultLogger(): DatabaseLogger;
+//# sourceMappingURL=databaseClient.logger.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"databaseClient.logger.d.ts","sourceRoot":"","sources":["../../src/databaseClient/databaseClient.logger.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sCAAsC,CAAC;AAE3E,qGAAqG;AACrG,wBAAgB,mBAAmB,IAAI,cAAc,CAmBpD"}

package/dist/databaseClient/databaseClient.logger.js

@@ -0,0 +1,27 @@
+/**
+ * @zudojs/database — Default Logger
+ *
+ * Minimal logger for environments where no application logger has been configured yet.
+ */
+/** Creates a minimal logger for environments where no application logger has been configured yet. */
+export function createDefaultLogger() {
+    return {
+        debug: (message, metadata) => {
+            if (process.env.NODE_ENV !== "production") {
+                console.debug(message, metadata);
+            }
+        },
+        info: (message, metadata) => {
+            if (process.env.NODE_ENV !== "production") {
+                console.info(message, metadata);
+            }
+        },
+        warn: (message, metadata) => {
+            console.warn(message, metadata);
+        },
+        error: (message, error, metadata) => {
+            console.error(message, error, metadata);
+        },
+    };
+}
+//# sourceMappingURL=databaseClient.logger.js.map