@buenojs/bueno 0.8.9 → 0.8.11

package/README.md

@@ -1246,7 +1246,7 @@ bun dev
 
 ## Links
 
-- **Documentation**: [https://bueno.github.io](https://bueno.github.io)
+- **Documentation**: [https://buenojs.github.io](https://buenojs.github.io)
 - **GitHub**: [https://github.com/buenojs/bueno](https://github.com/buenojs/bueno)
 - **Issues**: [https://github.com/buenojs/bueno/issues](https://github.com/buenojs/bueno/issues)
 - **npm**: [https://www.npmjs.com/package/@buenojs/bueno](https://www.npmjs.com/package/@buenojs/bueno)

package/dist/cache/index.d.ts

@@ -0,0 +1,187 @@
+/**
+ * Caching Layer
+ *
+ * Unified interface over Bun.redis with in-memory fallback.
+ * Uses Bun 1.3+ native Redis client for production.
+ */
+export interface CacheConfig {
+    driver?: "redis" | "memory";
+    url?: string;
+    ttl?: number;
+    keyPrefix?: string;
+    enableMetrics?: boolean;
+}
+/**
+ * Cache metrics for observability
+ */
+export interface CacheMetrics {
+    hits: number;
+    misses: number;
+    sets: number;
+    deletes: number;
+    errors: number;
+    avgLatency: number;
+    totalOperations: number;
+}
+export interface SessionData {
+    [key: string]: unknown;
+}
+export interface SessionStoreOptions {
+    ttl?: number;
+    prefix?: string;
+    driver?: "redis" | "memory";
+    url?: string;
+}
+export interface PubSubMessage {
+    channel: string;
+    message: string;
+}
+export declare class Cache {
+    private driver;
+    private keyPrefix;
+    private defaultTTL;
+    private _isConnected;
+    private driverType;
+    private enableMetrics;
+    private metrics;
+    private totalLatency;
+    constructor(config?: CacheConfig);
+    /**
+     * Get current metrics snapshot
+     */
+    getMetrics(): CacheMetrics;
+    /**
+     * Reset metrics counters
+     */
+    resetMetrics(): void;
+    /**
+     * Update metrics counters
+     */
+    private updateMetrics;
+    /**
+     * Get current timestamp in milliseconds
+     */
+    private getTimestamp;
+    /**
+     * Connect to cache
+     */
+    connect(): Promise<void>;
+    /**
+     * Disconnect from cache
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Check if connected
+     */
+    get isConnected(): boolean;
+    /**
+     * Get the driver type
+     */
+    getDriverType(): "redis" | "memory";
+    /**
+     * Get a value
+     */
+    get<T = unknown>(key: string): Promise<T | null>;
+    /**
+     * Set a value
+     */
+    set<T>(key: string, value: T, ttl?: number): Promise<void>;
+    /**
+     * Delete a value
+     */
+    delete(key: string): Promise<boolean>;
+    /**
+     * Check if key exists
+     */
+    has(key: string): Promise<boolean>;
+    /**
+     * Increment a value
+     */
+    increment(key: string, by?: number): Promise<number>;
+    /**
+     * Decrement a value
+     */
+    decrement(key: string, by?: number): Promise<number>;
+    /**
+     * Get remaining TTL
+     */
+    ttl(key: string): Promise<number>;
+    /**
+     * Set expiration on a key
+     */
+    expire(key: string, ttl: number): Promise<boolean>;
+    /**
+     * Set multiple values
+     */
+    mset(values: Record<string, unknown>, ttl?: number): Promise<void>;
+    /**
+     * Get multiple values
+     */
+    mget<T = unknown>(keys: string[]): Promise<(T | null)[]>;
+    /**
+     * Clear all keys with prefix
+     */
+    clear(): Promise<void>;
+    /**
+     * Get or set (cache-aside pattern)
+     */
+    getOrSet<T>(key: string, factory: () => Promise<T>, ttl?: number): Promise<T>;
+    /**
+     * Delete multiple keys
+     */
+    mdelete(keys: string[]): Promise<void>;
+    /**
+     * Publish a message to a channel (Redis only)
+     */
+    publish(channel: string, message: string): Promise<number>;
+    /**
+     * Subscribe to a channel (Redis only)
+     */
+    subscribe(channel: string, callback: (message: string) => void): Promise<void>;
+    /**
+     * Remember with lock (prevent cache stampede)
+     */
+    remember<T>(key: string, factory: () => Promise<T>, ttl?: number, lockTimeout?: number): Promise<T>;
+}
+export declare class SessionStore {
+    private cache;
+    private ttl;
+    constructor(options?: SessionStoreOptions);
+    /**
+     * Initialize the session store
+     */
+    init(): Promise<void>;
+    /**
+     * Create a new session
+     */
+    create(data: SessionData): Promise<string>;
+    /**
+     * Get session data
+     */
+    get(sessionId: string): Promise<SessionData | null>;
+    /**
+     * Update session data
+     */
+    update(sessionId: string, data: SessionData): Promise<void>;
+    /**
+     * Delete a session
+     */
+    delete(sessionId: string): Promise<void>;
+    /**
+     * Refresh session TTL
+     */
+    refresh(sessionId: string): Promise<boolean>;
+    /**
+     * Check if session exists
+     */
+    has(sessionId: string): Promise<boolean>;
+}
+/**
+ * Create a cache instance
+ */
+export declare function createCache(config?: CacheConfig): Cache;
+/**
+ * Create a session store
+ */
+export declare function createSessionStore(options?: SessionStoreOptions): SessionStore;
+//# 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;;;;;GAKG;AAIH,MAAM,WAAW,WAAW;IAC3B,MAAM,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,WAAW;IAC3B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,mBAAmB;IACnC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,aAAa;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CAChB;AAgRD,qBAAa,KAAK;IACjB,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,UAAU,CAAqB;IACvC,OAAO,CAAC,aAAa,CAAU;IAG/B,OAAO,CAAC,OAAO,CAQb;IACF,OAAO,CAAC,YAAY,CAAK;gBAEb,MAAM,GAAE,WAAgB;IAapC;;OAEG;IACH,UAAU,IAAI,YAAY;IAI1B;;OAEG;IACH,YAAY,IAAI,IAAI;IAapB;;OAEG;IACH,OAAO,CAAC,aAAa;IAqCrB;;OAEG;IACH,OAAO,CAAC,YAAY;IASpB;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAO9B;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAejC;;OAEG;IACH,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED;;OAEG;IACH,aAAa,IAAI,OAAO,GAAG,QAAQ;IAInC;;OAEG;IACG,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IA6BtD;;OAEG;IACG,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBhE;;OAEG;IACG,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAgB3C;;OAEG;IACG,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAKxC;;OAEG;IACG,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,SAAI,GAAG,OAAO,CAAC,MAAM,CAAC;IAYrD;;OAEG;IACG,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,SAAI,GAAG,OAAO,CAAC,MAAM,CAAC;IAIrD;;OAEG;IACG,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAQvC;;OAEG;IACG,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAQxD;;OAEG;IACG,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMxE;;OAEG;IACG,IAAI,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC;IAI9D;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B;;OAEG;IACG,QAAQ,CAAC,CAAC,EACf,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACzB,GAAG,CAAC,EAAE,MAAM,GACV,OAAO,CAAC,CAAC,CAAC;IAYb;;OAEG;IACG,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAM5C;;OAEG;IACG,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAQhE;;OAEG;IACG,SAAS,CACd,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,GACjC,OAAO,CAAC,IAAI,CAAC;IAOhB;;OAEG;IACG,QAAQ,CAAC,CAAC,EACf,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACzB,GAAG,CAAC,EAAE,MAAM,EACZ,WAAW,SAAK,GACd,OAAO,CAAC,CAAC,CAAC;CA4Bb;AAID,qBAAa,YAAY;IACxB,OAAO,CAAC,KAAK,CAAQ;IACrB,OAAO,CAAC,GAAG,CAAS;gBAER,OAAO,GAAE,mBAAwB;IAU7C;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B;;OAEG;IACG,MAAM,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC;IAMhD;;OAEG;IACG,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAIzD;;OAEG;IACG,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAOjE;;OAEG;IACG,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI9C;;OAEG;IACG,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IASlD;;OAEG;IACG,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAG9C;AAID;;GAEG;AACH,wBAAgB,WAAW,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,KAAK,CAGvD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CACjC,OAAO,CAAC,EAAE,mBAAmB,GAC3B,YAAY,CAEd"}