@warlock.js/core 4.0.161 → 4.0.163

package/esm/benchmark/profiler.d.ts

@@ -0,0 +1,63 @@
+import type { BenchmarkErrorResult, BenchmarkProfilerOptions, BenchmarkStats, BenchmarkSuccessResult } from "./types";
+export declare class BenchmarkProfiler {
+    private readonly maxSamples;
+    private readonly channels;
+    private readonly entries;
+    private interval?;
+    constructor(options?: BenchmarkProfilerOptions);
+    /**
+     * Record one measurement result. Called automatically by measure() when a profiler is set.
+     *
+     * @param result - The success or error result from measure()
+     *
+     * @example
+     * profiler.record(result);
+     */
+    record(result: BenchmarkSuccessResult<unknown> | BenchmarkErrorResult): void;
+    /**
+     * Get aggregated stats for one operation name.
+     * Computes p50/p95/p99 by sorting the ring buffer on demand.
+     *
+     * @param name - The operation name to get stats for.
+     * @returns Stats object or undefined if no data yet.
+     *
+     * @example
+     * const stats = profiler.stats("db-query");
+     */
+    stats(name: string): BenchmarkStats | undefined;
+    /**
+     * Get stats for all tracked operations.
+     *
+     * @returns A record mapping operation names to their stats.
+     *
+     * @example
+     * const all = profiler.allStats();
+     */
+    allStats(): Record<string, BenchmarkStats>;
+    /**
+     * Send allStats() to all registered channels.
+     *
+     * @example
+     * await profiler.flush();
+     */
+    flush(): Promise<void>;
+    /**
+     * Clear ring buffer for one or all operations.
+     * Does NOT reset unbounded total/error counters.
+     *
+     * @param name - Optional operation name. If omitted, clears all ring buffers.
+     *
+     * @example
+     * profiler.reset("db-query");
+     * profiler.reset();
+     */
+    reset(name?: string): void;
+    /**
+     * Dispose the profiler, clearing its auto-flush interval.
+     *
+     * @example
+     * profiler.dispose();
+     */
+    dispose(): void;
+}
+//# sourceMappingURL=profiler.d.ts.map

package/esm/benchmark/profiler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"profiler.d.ts","sourceRoot":"","sources":["../../src/benchmark/profiler.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAEV,oBAAoB,EACpB,wBAAwB,EACxB,cAAc,EACd,sBAAsB,EACvB,MAAM,SAAS,CAAC;AAWjB,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqB;IAC9C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqC;IAC7D,OAAO,CAAC,QAAQ,CAAC,CAAiC;gBAE/B,OAAO,CAAC,EAAE,wBAAwB;IAYrD;;;;;;;OAOG;IACI,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,OAAO,CAAC,GAAG,oBAAoB,GAAG,IAAI;IAmCnF;;;;;;;;;OASG;IACI,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IA4BtD;;;;;;;OAOG;IACI,QAAQ,IAAI,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC;IAWjD;;;;;OAKG;IACU,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IASnC;;;;;;;;;OASG;IACI,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI;IAejC;;;;;OAKG;IACI,OAAO,IAAI,IAAI;CAMvB"}

package/esm/benchmark/profiler.js

@@ -0,0 +1,155 @@
+import {NoopChannel}from'./channels/noop.channel.js';class BenchmarkProfiler {
+    maxSamples;
+    channels;
+    entries = new Map();
+    interval;
+    constructor(options) {
+        this.maxSamples = options?.maxSamples ?? 1000;
+        this.channels = options?.channels ?? [new NoopChannel()];
+        if (options?.flushEvery) {
+            this.interval = setInterval(() => {
+                // We use void to explicitly ignore the promise, as this is a background interval
+                void this.flush();
+            }, options.flushEvery);
+        }
+    }
+    /**
+     * Record one measurement result. Called automatically by measure() when a profiler is set.
+     *
+     * @param result - The success or error result from measure()
+     *
+     * @example
+     * profiler.record(result);
+     */
+    record(result) {
+        let entry = this.entries.get(result.name);
+        if (!entry) {
+            entry = {
+                latencies: [],
+                sum: 0,
+                total: 0,
+                errors: 0,
+                firstSeenAt: result.startedAt,
+                lastSeenAt: result.endedAt,
+            };
+            this.entries.set(result.name, entry);
+        }
+        entry.latencies.push(result.latency);
+        entry.sum += result.latency;
+        if (entry.latencies.length > this.maxSamples) {
+            const removed = entry.latencies.shift();
+            if (removed !== undefined) {
+                entry.sum -= removed;
+            }
+        }
+        entry.total += 1;
+        if (!result.success) {
+            entry.errors += 1;
+        }
+        entry.lastSeenAt = result.endedAt;
+    }
+    /**
+     * Get aggregated stats for one operation name.
+     * Computes p50/p95/p99 by sorting the ring buffer on demand.
+     *
+     * @param name - The operation name to get stats for.
+     * @returns Stats object or undefined if no data yet.
+     *
+     * @example
+     * const stats = profiler.stats("db-query");
+     */
+    stats(name) {
+        const entry = this.entries.get(name);
+        if (!entry || entry.latencies.length === 0)
+            return undefined;
+        const latencies = [...entry.latencies].sort((a, b) => a - b);
+        const count = latencies.length;
+        const getP = (percentile) => {
+            const index = Math.min(count - 1, Math.floor(count * percentile));
+            return latencies[index];
+        };
+        return {
+            p50: getP(0.5),
+            p90: getP(0.9),
+            p95: getP(0.95),
+            p99: getP(0.99),
+            avg: Math.round((entry.sum / count) * 100) / 100,
+            min: latencies[0],
+            max: latencies[count - 1],
+            count: entry.total,
+            errors: entry.errors,
+            errorRate: Math.round((entry.errors / entry.total) * 100) / 100,
+            firstSeenAt: entry.firstSeenAt,
+            lastSeenAt: entry.lastSeenAt,
+        };
+    }
+    /**
+     * Get stats for all tracked operations.
+     *
+     * @returns A record mapping operation names to their stats.
+     *
+     * @example
+     * const all = profiler.allStats();
+     */
+    allStats() {
+        const all = {};
+        for (const name of this.entries.keys()) {
+            const operationStats = this.stats(name);
+            if (operationStats) {
+                all[name] = operationStats;
+            }
+        }
+        return all;
+    }
+    /**
+     * Send allStats() to all registered channels.
+     *
+     * @example
+     * await profiler.flush();
+     */
+    async flush() {
+        const stats = this.allStats();
+        if (Object.keys(stats).length === 0)
+            return;
+        for (const channel of this.channels) {
+            await channel.onFlush(stats);
+        }
+    }
+    /**
+     * Clear ring buffer for one or all operations.
+     * Does NOT reset unbounded total/error counters.
+     *
+     * @param name - Optional operation name. If omitted, clears all ring buffers.
+     *
+     * @example
+     * profiler.reset("db-query");
+     * profiler.reset();
+     */
+    reset(name) {
+        if (name) {
+            const entry = this.entries.get(name);
+            if (entry) {
+                entry.latencies = [];
+                entry.sum = 0;
+            }
+        }
+        else {
+            for (const entry of this.entries.values()) {
+                entry.latencies = [];
+                entry.sum = 0;
+            }
+        }
+    }
+    /**
+     * Dispose the profiler, clearing its auto-flush interval.
+     *
+     * @example
+     * profiler.dispose();
+     */
+    dispose() {
+        if (this.interval) {
+            clearInterval(this.interval);
+            this.interval = undefined;
+        }
+    }
+}export{BenchmarkProfiler};//# sourceMappingURL=profiler.js.map

package/esm/benchmark/profiler.js.map

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

package/esm/benchmark/types.d.ts

@@ -0,0 +1,167 @@
+import type { BenchmarkSnapshots } from "./benchmark-snapshots";
+import type { BenchmarkProfiler } from "./profiler";
+/**
+ * Global benchmark configuration (set via config.get("benchmark"))
+ */
+export type BenchmarkConfigurations = {
+    enabled?: boolean;
+    latencyRange?: {
+        excellent: number;
+        poor: number;
+    };
+    profiler?: BenchmarkProfiler;
+    snapshotContainer?: BenchmarkSnapshots;
+};
+export type BenchmarkOptions<T = unknown> = {
+    /**
+     * Quick enable/disable without removing the call.
+     * When false, fn() is still called but no timing occurs and no hooks fire.
+     */
+    enabled?: boolean;
+    /**
+     * Latency thresholds (in ms) for performance classification.
+     * - latency <= excellent → "excellent"
+     * - latency >= poor      → "poor"
+     * - between              → "good"
+     *
+     * @example
+     * { excellent: 100, poor: 500 } // ≤100ms excellent, ≥500ms poor
+     */
+    latencyRange?: {
+        /**
+         * Upper bound (ms) for "excellent" classification
+         */
+        excellent: number;
+        /**
+         * Lower bound (ms) for "poor" classification
+         */
+        poor: number;
+    };
+    /**
+     * Hook called after a successful measurement
+     */
+    onComplete?: (result: BenchmarkSuccessResult<T>) => void;
+    /**
+     * Hook called after a benchmarked error
+     */
+    onError?: (result: BenchmarkErrorResult) => void;
+    /**
+     * Hook called after every measurement, success or error.
+     * Fires after onComplete / onError.
+     */
+    onFinish?: (result: BenchmarkSuccessResult<T> | BenchmarkErrorResult) => void;
+    /**
+     * Metadata tags for grouping/filtering benchmarks
+     *
+     * @example { service: "auth", endpoint: "/login" }
+     */
+    tags?: Record<string, string>;
+    /**
+     * Control whether a thrown error should be benchmarked.
+     * Return false for business logic errors (400, 404, validation) — they are re-thrown immediately.
+     * Return true for technical errors (timeouts, DB crashes) — they are captured and benchmarked.
+     *
+     * Default: benchmark all errors
+     */
+    shouldBenchmarkError?: (error: unknown) => boolean;
+    /**
+     * Profiler to record this measurement into.
+     * - BenchmarkProfiler instance → use it
+     * - false                      → skip profiling for this call
+     * - undefined (default)        → fall back to config.get("benchmark").profiler
+     */
+    profiler?: BenchmarkProfiler | false;
+    /**
+     * Snapshot container to record this result into.
+     * - BenchmarkSnapshots instance → use it
+     * - false                       → skip snapshot for this call
+     * - undefined (default)         → fall back to config.get("benchmark").snapshotContainer
+     */
+    snapshotContainer?: BenchmarkSnapshots | false;
+};
+export type BenchmarkResult = {
+    /**
+     * Name of the benchmark
+     */
+    name: string;
+    /**
+     * Latency in milliseconds
+     */
+    latency: number;
+    /**
+     * Performance classification based on latency thresholds
+     */
+    state: "excellent" | "good" | "poor";
+    /**
+     * Optional metadata tags
+     */
+    tags?: Record<string, string>;
+    /**
+     * Start time of the measurement
+     */
+    startedAt: Date;
+    /**
+     * End time of the measurement
+     */
+    endedAt: Date;
+};
+/**
+ * Result of a successful benchmark measurement.
+ */
+export type BenchmarkSuccessResult<T> = BenchmarkResult & {
+    success: true;
+    value: T;
+};
+/**
+ * Result of a benchmarked error.
+ */
+export type BenchmarkErrorResult = BenchmarkResult & {
+    success: false;
+    error: unknown;
+};
+export interface BenchmarkChannel {
+    /**
+     * Called on profiler.flush() with aggregated stats for all tracked operations.
+     */
+    onFlush(stats: Record<string, BenchmarkStats>): void | Promise<void>;
+}
+export type BenchmarkStats = {
+    p50: number;
+    p90: number;
+    p95: number;
+    p99: number;
+    avg: number;
+    min: number;
+    max: number;
+    /** Total call count — unbounded, not capped by ring buffer */
+    count: number;
+    /** Total error count — unbounded */
+    errors: number;
+    /** 0.0–1.0 — based on unbounded total/error counters */
+    errorRate: number;
+    firstSeenAt: Date;
+    lastSeenAt: Date;
+};
+export type BenchmarkProfilerOptions = {
+    /** Max latency samples to keep per operation name. Default: 1000 */
+    maxSamples?: number;
+    /** Channels to broadcast stats to on flush(). Default: [new NoopChannel()] */
+    channels?: BenchmarkChannel[];
+    /** Auto-flush interval in ms. If not set, flush() must be called manually. */
+    flushEvery?: number;
+};
+export type BenchmarkSnapshotsOptions = {
+    /** Max snapshots to keep per operation name. Default: 100 */
+    maxSnapshots?: number;
+    /**
+     * What to capture:
+     * - "error" → only BenchmarkErrorResult (default, memory safe)
+     * - "value" → only BenchmarkSuccessResult<T> with value
+     * - "all"   → both
+     *
+     * WARNING: "value" and "all" store the full T value in memory.
+     * Do not use in production without understanding the memory implications.
+     */
+    capture?: "error" | "value" | "all";
+};
+//# sourceMappingURL=types.d.ts.map

package/esm/benchmark/types.d.ts.map

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

package/esm/bootstrap/setup.d.ts

@@ -0,0 +1,2 @@
+export declare function displayEnvironmentMode(): void;
+//# sourceMappingURL=setup.d.ts.map

package/esm/bootstrap/setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../src/bootstrap/setup.ts"],"names":[],"mappings":"AAGA,wBAAgB,sBAAsB,SAqBrC"}

package/esm/bootstrap/setup.js

@@ -0,0 +1,14 @@
+import {colors}from'@mongez/copper';import'@warlock.js/logger';import'../database/models/database-log/database-log.js';import {environment}from'../utils/environment.js';import'../http/context/request-context.js';import'@mongez/config';import'path';import'@mongez/slug';import'@mongez/supportive-is';import'@mongez/reinforcements';function displayEnvironmentMode() {
+    const env = environment();
+    const envColor = (env) => {
+        switch (env) {
+            case "development":
+                return colors.yellow(env);
+            case "production":
+                return colors.green(env);
+            case "test":
+                return colors.magentaBright(env);
+        }
+    };
+    console.log(colors.blueBright("ℹ"), colors.yellow(`(${new Date().toISOString()})`), colors.orange("[warlock]"), colors.magenta(`bootstrap`), colors.blueBright(`Starting application in ${envColor(env)} mode`));
+}export{displayEnvironmentMode};//# sourceMappingURL=setup.js.map

package/esm/bootstrap/setup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.js","sources":["../../src/bootstrap/setup.ts"],"sourcesContent":[null],"names":[],"mappings":"mVAGgB,sBAAsB,GAAA;AACpC,IAAA,MAAM,GAAG,GAAG,WAAW,EAAE,CAAC;AAE1B,IAAA,MAAM,QAAQ,GAAG,CAAC,GAAW,KAAI;AAC/B,QAAA,QAAQ,GAAG;AACT,YAAA,KAAK,aAAa;AAChB,gBAAA,OAAO,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;AAC5B,YAAA,KAAK,YAAY;AACf,gBAAA,OAAO,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;AAC3B,YAAA,KAAK,MAAM;AACT,gBAAA,OAAO,MAAM,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;AACpC,SAAA;AACH,KAAC,CAAC;IAEF,OAAO,CAAC,GAAG,CACT,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,EACtB,MAAM,CAAC,MAAM,CAAC,CAAI,CAAA,EAAA,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAG,CAAA,CAAA,CAAC,EAC9C,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,EAC1B,MAAM,CAAC,OAAO,CAAC,CAAA,SAAA,CAAW,CAAC,EAC3B,MAAM,CAAC,UAAU,CAAC,CAAA,wBAAA,EAA2B,QAAQ,CAAC,GAAG,CAAC,CAAA,KAAA,CAAO,CAAC,CACnE,CAAC;AACJ"}

package/esm/bootstrap.d.ts

@@ -0,0 +1,2 @@
+export declare function bootstrap(): Promise<void>;
+//# sourceMappingURL=bootstrap.d.ts.map

package/esm/bootstrap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../src/bootstrap.ts"],"names":[],"mappings":"AAIA,wBAAsB,SAAS,kBAK9B"}

package/esm/bootstrap.js

@@ -0,0 +1,5 @@
+import {loadEnv}from'@mongez/dotenv';import {initializeDayjs}from'@mongez/time-wizard';import {captureAnyUnhandledRejection}from'@warlock.js/logger';async function bootstrap() {
+    await loadEnv();
+    initializeDayjs();
+    captureAnyUnhandledRejection();
+}export{bootstrap};//# sourceMappingURL=bootstrap.js.map

package/esm/bootstrap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap.js","sources":["../src/bootstrap.ts"],"sourcesContent":[null],"names":[],"mappings":"qJAIO,eAAe,SAAS,GAAA;IAC7B,MAAM,OAAO,EAAE,CAAC;AAEhB,IAAA,eAAe,EAAE,CAAC;AAClB,IAAA,4BAA4B,EAAE,CAAC;AACjC"}

package/esm/cache/database-cache-driver.d.ts

@@ -0,0 +1,56 @@
+import { BaseCacheDriver, type CacheDriver, type CacheKey } from "@warlock.js/cache";
+import { Model } from "@warlock.js/cascade";
+export type DatabaseCacheOptions = {
+    /**
+     * Database model class
+     */
+    model?: typeof CacheModel;
+    /**
+     * Global prefix for the cache key
+     */
+    globalPrefix?: string | (() => string);
+    /**
+     * The default TTL for the cache in seconds
+     *
+     * @default Infinity
+     */
+    ttl?: number;
+};
+export declare class CacheModel extends Model {
+    static table: string;
+}
+export declare class DatabaseCacheDriver extends BaseCacheDriver<DatabaseCacheDriver, DatabaseCacheOptions> implements CacheDriver<DatabaseCacheDriver, DatabaseCacheOptions> {
+    /**
+     * {@inheritdoc}
+     */
+    name: string;
+    /**
+     * Database model class
+     */
+    model: typeof CacheModel;
+    /**
+     * {@inheritdoc}
+     */
+    setOptions(options: DatabaseCacheOptions): this;
+    /**
+     * {@inheritdoc}
+     */
+    removeNamespace(namespace: string): Promise<this>;
+    /**
+     * {@inheritdoc}
+     */
+    set(key: CacheKey, value: any, ttl?: number): Promise<this>;
+    /**
+     * {@inheritdoc}
+     */
+    get(key: CacheKey): Promise<any>;
+    /**
+     * {@inheritdoc}
+     */
+    remove(key: CacheKey): Promise<void>;
+    /**
+     * {@inheritdoc}
+     */
+    flush(): Promise<void>;
+}
+//# sourceMappingURL=database-cache-driver.d.ts.map

package/esm/cache/database-cache-driver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"database-cache-driver.d.ts","sourceRoot":"","sources":["../../src/cache/database-cache-driver.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EAEf,KAAK,WAAW,EAChB,KAAK,QAAQ,EACd,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAE5C,MAAM,MAAM,oBAAoB,GAAG;IACjC;;OAEG;IACH,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC;IAC1B;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,CAAC;IACvC;;;;OAIG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,qBAAa,UAAW,SAAQ,KAAK;IACnC,OAAc,KAAK,SAAW;CAC/B;AAED,qBAAa,mBACX,SAAQ,eAAe,CAAC,mBAAmB,EAAE,oBAAoB,CACjE,YAAW,WAAW,CAAC,mBAAmB,EAAE,oBAAoB,CAAC;IAEjE;;OAEG;IACI,IAAI,SAAc;IAEzB;;OAEG;IACI,KAAK,EAAG,OAAO,UAAU,CAAC;IAEjC;;OAEG;IACI,UAAU,CAAC,OAAO,EAAE,oBAAoB;IAQ/C;;OAEG;IACU,eAAe,CAAC,SAAS,EAAE,MAAM;IAc9C;;OAEG;IACU,GAAG,CAAC,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE,MAAM;IAuCxD;;OAEG;IACU,GAAG,CAAC,GAAG,EAAE,QAAQ;IAuB9B;;OAEG;IACU,MAAM,CAAC,GAAG,EAAE,QAAQ;IAYjC;;OAEG;IACU,KAAK;CAUnB"}

package/esm/cache/database-cache-driver.js

@@ -0,0 +1,112 @@
+import {BaseCacheDriver}from'@warlock.js/cache';import {Model}from'@warlock.js/cascade';class CacheModel extends Model {
+    static table = "cache";
+}
+class DatabaseCacheDriver extends BaseCacheDriver {
+    /**
+     * {@inheritdoc}
+     */
+    name = "database";
+    /**
+     * Database model class
+     */
+    model;
+    /**
+     * {@inheritdoc}
+     */
+    setOptions(options) {
+        super.setOptions(options);
+        this.model = options.model ?? CacheModel;
+        return this;
+    }
+    /**
+     * {@inheritdoc}
+     */
+    async removeNamespace(namespace) {
+        this.log("clearing", namespace);
+        namespace = this.parseKey(namespace);
+        await this.model.delete({
+            namespace,
+        });
+        this.log("cleared", namespace);
+        return this;
+    }
+    /**
+     * {@inheritdoc}
+     */
+    async set(key, value, ttl) {
+        const parsedKey = this.parseKey(key);
+        this.log("caching", parsedKey);
+        if (ttl === undefined) {
+            ttl = this.ttl;
+        }
+        // Extract namespace: all parts except the last (e.g., "users.id.1" -> "users.id")
+        const keyParts = parsedKey.split(".");
+        const namespace = keyParts.slice(0, -1).join(".") || parsedKey;
+        // Find existing cache entry or create new one (upsert pattern)
+        let cacheEntry = await this.model.first({ key: parsedKey });
+        if (cacheEntry) {
+            // Update existing entry
+            cacheEntry.set("namespace", namespace);
+            cacheEntry.set("data", value);
+            cacheEntry.set("ttl", ttl);
+            cacheEntry.set("expiresAt", this.getExpiresAt(ttl) || null);
+            await cacheEntry.save();
+        }
+        else {
+            // Create new entry
+            await this.model.create({
+                key: parsedKey,
+                namespace,
+                data: value,
+                ttl,
+                expiresAt: this.getExpiresAt(ttl) || null,
+            });
+        }
+        this.log("cached", parsedKey);
+        return this;
+    }
+    /**
+     * {@inheritdoc}
+     */
+    async get(key) {
+        const parsedKey = this.parseKey(key);
+        this.log("fetching", parsedKey);
+        const model = await this.model.first({
+            key: parsedKey,
+        });
+        if (!model) {
+            this.log("notFound", parsedKey);
+            return null;
+        }
+        const data = {
+            data: model.get("data"),
+            expiresAt: model.get("expiresAt"),
+            ttl: model.get("ttl"),
+        };
+        return this.parseCachedData(parsedKey, data);
+    }
+    /**
+     * {@inheritdoc}
+     */
+    async remove(key) {
+        const parsedKey = this.parseKey(key);
+        this.log("removing", parsedKey);
+        await this.model.delete({
+            key: parsedKey,
+        });
+        this.log("removed", parsedKey);
+    }
+    /**
+     * {@inheritdoc}
+     */
+    async flush() {
+        this.log("flushing");
+        if (this.options.globalPrefix) {
+            this.removeNamespace("");
+        }
+        else {
+            await this.model.delete();
+        }
+        this.log("flushed");
+    }
+}export{CacheModel,DatabaseCacheDriver};//# sourceMappingURL=database-cache-driver.js.map

package/esm/cache/database-cache-driver.js.map

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

package/esm/cache/index.d.ts

@@ -0,0 +1,3 @@
+export { DatabaseCacheDriver } from "./database-cache-driver";
+export type { DatabaseCacheOptions } from "./database-cache-driver";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cache/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC9D,YAAY,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC"}

package/esm/cache/index.js

@@ -0,0 +1 @@
+import {DatabaseCacheDriver}from'./database-cache-driver.js';import {cache}from'@warlock.js/cache';cache.registerDriver("database", DatabaseCacheDriver);export{DatabaseCacheDriver};//# sourceMappingURL=index.js.map

package/esm/cache/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../../src/cache/index.ts"],"sourcesContent":[null],"names":[],"mappings":"mGAOA,KAAK,CAAC,cAAc,CAAC,UAAU,EAAE,mBAAmB,CAAC"}