@gl-life/gl-life-database 1.0.0

package/dist/cache/invalidation.d.ts

@@ -0,0 +1,156 @@
+import { Result, Logger, EventBus, type UnsubscribeFn } from '@gl-life/gl-life-core';
+import type { Cache } from '../types/cache.js';
+/**
+ * Invalidation statistics
+ */
+export interface InvalidationStats {
+    /** Total number of invalidations performed */
+    totalInvalidations: number;
+    /** Number of tag-based invalidations */
+    tagInvalidations: number;
+    /** Number of pattern-based invalidations */
+    patternInvalidations: number;
+    /** Number of key-based invalidations */
+    keyInvalidations: number;
+    /** Number of expired entry invalidations */
+    expiredInvalidations: number;
+}
+/**
+ * Cache invalidation error types
+ */
+export type InvalidationError = {
+    type: 'INVALIDATION_FAILED';
+    message: string;
+    cause?: unknown;
+} | {
+    type: 'TAG_NOT_FOUND';
+    message: string;
+} | {
+    type: 'UNKNOWN';
+    message: string;
+    cause?: unknown;
+};
+/**
+ * Cache invalidation system
+ *
+ * Provides advanced cache invalidation strategies:
+ * - Tag-based invalidation (group entries by logical tags)
+ * - Time-based invalidation (TTL expiration scanning)
+ * - Event-based invalidation (integrate with EventBus)
+ * - Batch invalidation (efficient multi-entry invalidation)
+ * - Pattern-based invalidation (wildcard matching)
+ *
+ * Usage:
+ * ```typescript
+ * const invalidator = new CacheInvalidator(cache, eventBus, logger);
+ *
+ * // Tag entries
+ * await invalidator.tagEntry('user:1', ['users', 'active']);
+ *
+ * // Invalidate by tag
+ * await invalidator.invalidateByTag('users');
+ *
+ * // Subscribe to data change events
+ * const unsubscribe = invalidator.subscribeToDataChanges();
+ * ```
+ */
+export declare class CacheInvalidator {
+    private readonly cache;
+    private readonly eventBus;
+    private readonly logger;
+    private readonly tagIndex;
+    private readonly entryTags;
+    private stats;
+    constructor(cache: Cache, eventBus: EventBus, logger: Logger);
+    /**
+     * Tag a cache entry for group invalidation
+     *
+     * @param key - Cache key
+     * @param tags - Array of tags to associate with this entry
+     * @returns Result with void on success
+     */
+    tagEntry(key: string, tags: string[]): Promise<Result<void, InvalidationError>>;
+    /**
+     * Remove a tag from a cache entry
+     *
+     * @param key - Cache key
+     * @param tag - Tag to remove
+     * @returns Result with void on success
+     */
+    removeTag(key: string, tag: string): Promise<Result<void, InvalidationError>>;
+    /**
+     * Invalidate all entries with a specific tag
+     *
+     * @param tag - Tag to invalidate (supports wildcards)
+     * @returns Result with number of invalidated entries
+     */
+    invalidateByTag(tag: string): Promise<Result<number, InvalidationError>>;
+    /**
+     * Invalidate entries by multiple tags
+     *
+     * @param tags - Array of tags to invalidate
+     * @returns Result with number of invalidated entries
+     */
+    invalidateByTags(tags: string[]): Promise<Result<number, InvalidationError>>;
+    /**
+     * Invalidate specific cache keys
+     *
+     * @param keys - Array of keys to invalidate
+     * @returns Result with number of invalidated entries
+     */
+    invalidateByKeys(keys: string[]): Promise<Result<number, InvalidationError>>;
+    /**
+     * Invalidate entries matching a pattern
+     *
+     * @param pattern - Pattern to match (supports wildcards)
+     * @returns Result with number of invalidated entries
+     */
+    invalidateByPattern(pattern: string): Promise<Result<number, InvalidationError>>;
+    /**
+     * Scan and invalidate expired entries
+     *
+     * @returns Result with number of invalidated entries
+     */
+    invalidateExpired(): Promise<Result<number, InvalidationError>>;
+    /**
+     * Subscribe to data change events for automatic invalidation
+     *
+     * @returns Unsubscribe function
+     */
+    subscribeToDataChanges(): UnsubscribeFn;
+    /**
+     * Get all keys tagged with a specific tag
+     *
+     * @param tag - Tag name
+     * @returns Result with array of keys
+     */
+    getTaggedKeys(tag: string): Promise<Result<string[], InvalidationError>>;
+    /**
+     * Get all tags for a cache entry
+     *
+     * @param key - Cache key
+     * @returns Result with array of tags
+     */
+    getEntryTags(key: string): Promise<Result<string[], InvalidationError>>;
+    /**
+     * Get invalidation statistics
+     *
+     * @returns Result with statistics
+     */
+    getStats(): Result<InvalidationStats, InvalidationError>;
+    /**
+     * Reset invalidation statistics
+     *
+     * @returns Result with void on success
+     */
+    resetStats(): Result<void, InvalidationError>;
+    /**
+     * Clean up tag mappings for a deleted entry
+     */
+    private cleanupEntryTags;
+    /**
+     * Convert glob pattern to regex
+     */
+    private patternToRegex;
+}
+//# sourceMappingURL=invalidation.d.ts.map

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

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

package/dist/cache/kv-cache.d.ts

@@ -0,0 +1,79 @@
+import { Result, Option, Logger } from '@gl-life/gl-life-core';
+import type { Cache, CacheConfig, CacheEntry, CacheError, CacheStats } from '../types/cache.js';
+/**
+ * Cloudflare Workers KV namespace interface
+ */
+export interface KVNamespace {
+    get(key: string, options?: {
+        type?: 'text' | 'json';
+    }): Promise<any>;
+    put(key: string, value: string, options?: {
+        expirationTtl?: number;
+    }): Promise<void>;
+    delete(key: string): Promise<void>;
+    list(options?: {
+        prefix?: string;
+        limit?: number;
+        cursor?: string;
+    }): Promise<{
+        keys: Array<{
+            name: string;
+        }>;
+        list_complete: boolean;
+        cursor?: string;
+    }>;
+}
+/**
+ * Cloudflare Workers KV cache implementation
+ *
+ * Features:
+ * - Distributed cache using Cloudflare KV
+ * - TTL-based expiration via KV expirationTtl
+ * - Cache-aside pattern
+ * - Pattern-based invalidation
+ * - Statistics tracking (hits/misses)
+ *
+ * Limitations:
+ * - No total item count (KV doesn't provide this efficiently)
+ * - No LRU eviction (KV handles this internally)
+ * - List operations are eventually consistent
+ *
+ * Usage:
+ * ```typescript
+ * const cache = new KVCache(env.CACHE_KV, config, logger);
+ * await cache.set('user:1', { id: 1, name: 'John' }, 60);
+ * const result = await cache.get<User>('user:1');
+ * ```
+ */
+export declare class KVCache implements Cache {
+    readonly config: CacheConfig;
+    private readonly kv;
+    private readonly logger;
+    private stats;
+    constructor(kv: KVNamespace, config: CacheConfig, logger: Logger);
+    get<T = unknown>(key: string): Promise<Result<Option<T>, CacheError>>;
+    getWithMetadata<T = unknown>(key: string): Promise<Result<Option<CacheEntry<T>>, CacheError>>;
+    set<T = unknown>(key: string, value: T, ttl?: number): Promise<Result<void, CacheError>>;
+    delete(key: string): Promise<Result<boolean, CacheError>>;
+    deleteMany(keys: string[]): Promise<Result<number, CacheError>>;
+    clear(): Promise<Result<void, CacheError>>;
+    has(key: string): Promise<Result<boolean, CacheError>>;
+    invalidate(pattern: string): Promise<Result<number, CacheError>>;
+    invalidateTable(table: string): Promise<Result<number, CacheError>>;
+    getStats(): Result<CacheStats, CacheError>;
+    resetStats(): Result<void, CacheError>;
+    generateKey(sql: string, params?: unknown[]): string;
+    /**
+     * Get full cache key with prefix
+     */
+    private getFullKey;
+    /**
+     * Estimate size of value in bytes
+     */
+    private estimateSize;
+    /**
+     * Convert glob pattern to regex
+     */
+    private patternToRegex;
+}
+//# sourceMappingURL=kv-cache.d.ts.map

package/dist/cache/kv-cache.d.ts.map

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

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

@@ -0,0 +1,68 @@
+import { Result, Option, Logger } from '@gl-life/gl-life-core';
+import type { Cache, CacheConfig, CacheEntry, CacheError, CacheStats } from '../types/cache.js';
+/**
+ * In-memory LRU cache implementation
+ *
+ * Features:
+ * - TTL-based expiration
+ * - LRU eviction policy
+ * - Cache statistics tracking (hits/misses/evictions)
+ * - Pattern-based invalidation
+ * - Metadata tracking (access count, timestamps)
+ *
+ * Usage:
+ * ```typescript
+ * const cache = new MemoryCache(config, logger);
+ * await cache.set('user:1', { id: 1, name: 'John' }, 60);
+ * const result = await cache.get<User>('user:1');
+ * ```
+ */
+export declare class MemoryCache implements Cache {
+    readonly config: CacheConfig;
+    private readonly logger;
+    private readonly store;
+    private readonly lruList;
+    private stats;
+    constructor(config: CacheConfig, logger: Logger);
+    get<T = unknown>(key: string): Promise<Result<Option<T>, CacheError>>;
+    getWithMetadata<T = unknown>(key: string): Promise<Result<Option<CacheEntry<T>>, CacheError>>;
+    set<T = unknown>(key: string, value: T, ttl?: number): Promise<Result<void, CacheError>>;
+    delete(key: string): Promise<Result<boolean, CacheError>>;
+    deleteMany(keys: string[]): Promise<Result<number, CacheError>>;
+    clear(): Promise<Result<void, CacheError>>;
+    has(key: string): Promise<Result<boolean, CacheError>>;
+    invalidate(pattern: string): Promise<Result<number, CacheError>>;
+    invalidateTable(table: string): Promise<Result<number, CacheError>>;
+    getStats(): Result<CacheStats, CacheError>;
+    resetStats(): Result<void, CacheError>;
+    generateKey(sql: string, params?: unknown[]): string;
+    /**
+     * Get full cache key with prefix
+     */
+    private getFullKey;
+    /**
+     * Check if entry is expired
+     */
+    private isExpired;
+    /**
+     * Update entry access metadata and LRU position
+     */
+    private touchEntry;
+    /**
+     * Remove key from LRU list
+     */
+    private removeLRU;
+    /**
+     * Evict least recently used entry
+     */
+    private evictLRU;
+    /**
+     * Estimate size of value in bytes
+     */
+    private estimateSize;
+    /**
+     * Convert glob pattern to regex
+     */
+    private patternToRegex;
+}
+//# sourceMappingURL=memory-cache.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"memory-cache.d.ts","sourceRoot":"","sources":["../../src/cache/memory-cache.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAE/D,OAAO,KAAK,EACV,KAAK,EACL,WAAW,EACX,UAAU,EAEV,UAAU,EACV,UAAU,EACX,MAAM,mBAAmB,CAAC;AAE3B;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,WAAY,YAAW,KAAK;IACvC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA0B;IAChD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgB;IACxC,OAAO,CAAC,KAAK,CAIX;gBAEU,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM;IAMzC,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;IAiCrE,eAAe,CAAC,CAAC,GAAG,OAAO,EAC/B,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;IA+B/C,GAAG,CAAC,CAAC,GAAG,OAAO,EACnB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,CAAC,EACR,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAsD9B,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IAqBzD,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAsB/D,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAkB1C,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IA2BtD,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IA4BhE,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAezE,QAAQ,IAAI,MAAM,CAAC,UAAU,EAAE,UAAU,CAAC;IA2B1C,UAAU,IAAI,MAAM,CAAC,IAAI,EAAE,UAAU,CAAC;IAgBtC,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,MAAM;IAcpD;;OAEG;IACH,OAAO,CAAC,UAAU;IAIlB;;OAEG;IACH,OAAO,CAAC,SAAS;IAQjB;;OAEG;IACH,OAAO,CAAC,UAAU;IASlB;;OAEG;IACH,OAAO,CAAC,SAAS;IAOjB;;OAEG;IACH,OAAO,CAAC,QAAQ;IAahB;;OAEG;IACH,OAAO,CAAC,YAAY;IAQpB;;OAEG;IACH,OAAO,CAAC,cAAc;CAQvB"}

package/dist/cloudforge/d1-adapter.d.ts

@@ -0,0 +1,67 @@
+import { Result, Logger } from '@gl-life/gl-life-core';
+import type { D1Result, D1AdapterConfig, D1AdapterError, D1Adapter, D1ExecResult } from '../types/cloudforge.js';
+/**
+ * Cloudflare D1 database adapter
+ *
+ * Provides a standardized interface for interacting with Cloudflare D1 databases.
+ * Handles D1-specific quirks and optimizes for D1 performance.
+ *
+ * Usage:
+ * ```typescript
+ * const adapter = new D1DatabaseAdapter(config, logger);
+ *
+ * // Query data
+ * const result = await adapter.query('SELECT * FROM users WHERE id = ?', [1]);
+ *
+ * // Execute statement
+ * const execResult = await adapter.execute('INSERT INTO users (name) VALUES (?)', ['Alice']);
+ *
+ * // Batch operations
+ * const batchResult = await adapter.batch([
+ *   { sql: 'INSERT INTO users (name) VALUES (?)', params: ['Alice'] },
+ *   { sql: 'INSERT INTO users (name) VALUES (?)', params: ['Bob'] },
+ * ]);
+ * ```
+ */
+export declare class D1DatabaseAdapter implements D1Adapter {
+    readonly config: D1AdapterConfig;
+    private readonly logger;
+    private readonly db;
+    constructor(config: D1AdapterConfig, logger: Logger);
+    /**
+     * Execute a SQL query and return all results
+     */
+    query<T = unknown>(sql: string, params?: unknown[]): Promise<Result<T[], D1AdapterError>>;
+    /**
+     * Execute a SQL query and return first result
+     */
+    queryFirst<T = unknown>(sql: string, params?: unknown[]): Promise<Result<T | null, D1AdapterError>>;
+    /**
+     * Execute a SQL statement (INSERT, UPDATE, DELETE)
+     */
+    execute(sql: string, params?: unknown[]): Promise<Result<D1Result, D1AdapterError>>;
+    /**
+     * Execute multiple SQL statements in a batch
+     */
+    batch(statements: Array<{
+        sql: string;
+        params?: unknown[];
+    }>): Promise<Result<D1Result[], D1AdapterError>>;
+    /**
+     * Execute raw SQL (for migrations and schema changes)
+     */
+    exec(sql: string): Promise<Result<D1ExecResult, D1AdapterError>>;
+    /**
+     * Begin a transaction
+     *
+     * Note: D1 doesn't support explicit transactions yet, so this wraps
+     * the callback execution and provides the same interface for compatibility.
+     * Consider using batch() for atomic multi-statement operations.
+     */
+    transaction<T>(callback: (adapter: D1Adapter) => Promise<Result<T, D1AdapterError>>): Promise<Result<T, D1AdapterError>>;
+    /**
+     * Prepare a SQL statement with parameters
+     */
+    private prepareStatement;
+}
+//# sourceMappingURL=d1-adapter.d.ts.map

package/dist/cloudforge/d1-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"d1-adapter.d.ts","sourceRoot":"","sources":["../../src/cloudforge/d1-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,KAAK,EAGV,QAAQ,EACR,eAAe,EACf,cAAc,EACd,SAAS,EACT,YAAY,EACb,MAAM,wBAAwB,CAAC;AAEhC;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,iBAAkB,YAAW,SAAS;IACjD,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAa;gBAEpB,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM;IAMnD;;OAEG;IACG,KAAK,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,cAAc,CAAC,CAAC;IA6B/F;;OAEG;IACG,UAAU,CAAC,CAAC,GAAG,OAAO,EAC1B,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,OAAO,EAAE,GACjB,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,IAAI,EAAE,cAAc,CAAC,CAAC;IAqB5C;;OAEG;IACG,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC;IA6BzF;;OAEG;IACG,KAAK,CACT,UAAU,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAA;KAAE,CAAC,GACrD,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,EAAE,cAAc,CAAC,CAAC;IAyC9C;;OAEG;IACG,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,cAAc,CAAC,CAAC;IAmBtE;;;;;;OAMG;IACG,WAAW,CAAC,CAAC,EACjB,QAAQ,EAAE,CAAC,OAAO,EAAE,SAAS,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC,GACnE,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC;IAkBrC;;OAEG;IACH,OAAO,CAAC,gBAAgB;CAUzB"}

package/dist/cloudforge/do-storage.d.ts

@@ -0,0 +1,51 @@
+import { Result, Logger } from '@gl-life/gl-life-core';
+import type { DurableObjectStorage, DurableObjectStorageConfig, DurableObjectStorageError, DurableObjectStorageAdapter as IDurableObjectStorageAdapter, StorageListOptions, StorageTransaction } from '../types/cloudforge.js';
+/**
+ * Durable Objects storage adapter implementation
+ *
+ * Provides a type-safe interface for Cloudflare Durable Objects storage
+ * with Result-based error handling and logging support.
+ */
+export declare class DurableObjectStorageAdapter implements IDurableObjectStorageAdapter {
+    readonly config: DurableObjectStorageConfig;
+    private readonly storage;
+    private readonly logger;
+    constructor(storage: DurableObjectStorage, config: DurableObjectStorageConfig, logger: Logger);
+    /**
+     * Get a single value by key
+     */
+    get<T>(key: string): Promise<Result<T | null, DurableObjectStorageError>>;
+    /**
+     * Get multiple values by keys
+     */
+    getMultiple<T>(keys: string[]): Promise<Result<Map<string, T>, DurableObjectStorageError>>;
+    /**
+     * Put a single key-value pair
+     */
+    put<T>(key: string, value: T): Promise<Result<void, DurableObjectStorageError>>;
+    /**
+     * Put multiple key-value pairs
+     */
+    putMultiple<T>(entries: [string, T][]): Promise<Result<void, DurableObjectStorageError>>;
+    /**
+     * Delete a single key
+     */
+    delete(key: string): Promise<Result<boolean, DurableObjectStorageError>>;
+    /**
+     * Delete multiple keys
+     */
+    deleteMultiple(keys: string[]): Promise<Result<number, DurableObjectStorageError>>;
+    /**
+     * Delete all keys in storage
+     */
+    deleteAll(): Promise<Result<void, DurableObjectStorageError>>;
+    /**
+     * List keys in storage
+     */
+    list(options?: StorageListOptions): Promise<Result<Map<string, any>, DurableObjectStorageError>>;
+    /**
+     * Execute operations in a transaction
+     */
+    transaction<T>(callback: (txn: StorageTransaction) => Promise<Result<T, DurableObjectStorageError>>): Promise<Result<T, DurableObjectStorageError>>;
+}
+//# sourceMappingURL=do-storage.d.ts.map

package/dist/cloudforge/do-storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"do-storage.d.ts","sourceRoot":"","sources":["../../src/cloudforge/do-storage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,KAAK,EACV,oBAAoB,EACpB,0BAA0B,EAC1B,yBAAyB,EACzB,2BAA2B,IAAI,4BAA4B,EAC3D,kBAAkB,EAClB,kBAAkB,EACnB,MAAM,wBAAwB,CAAC;AAEhC;;;;;GAKG;AACH,qBAAa,2BAA4B,YAAW,4BAA4B;IAC9E,QAAQ,CAAC,MAAM,EAAE,0BAA0B,CAAC;IAC5C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAuB;IAC/C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAG9B,OAAO,EAAE,oBAAoB,EAC7B,MAAM,EAAE,0BAA0B,EAClC,MAAM,EAAE,MAAM;IAOhB;;OAEG;IACG,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,IAAI,EAAE,yBAAyB,CAAC,CAAC;IAoB/E;;OAEG;IACG,WAAW,CAAC,CAAC,EACjB,IAAI,EAAE,MAAM,EAAE,GACb,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,yBAAyB,CAAC,CAAC;IAuB7D;;OAEG;IACG,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,yBAAyB,CAAC,CAAC;IA8CrF;;OAEG;IACG,WAAW,CAAC,CAAC,EACjB,OAAO,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,GACrB,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,yBAAyB,CAAC,CAAC;IAsDnD;;OAEG;IACG,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,yBAAyB,CAAC,CAAC;IAoB9E;;OAEG;IACG,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,yBAAyB,CAAC,CAAC;IAsBxF;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,yBAAyB,CAAC,CAAC;IAmBnE;;OAEG;IACG,IAAI,CACR,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,yBAAyB,CAAC,CAAC;IAmB/D;;OAEG;IACG,WAAW,CAAC,CAAC,EACjB,QAAQ,EAAE,CAAC,GAAG,EAAE,kBAAkB,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,yBAAyB,CAAC,CAAC,GACnF,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,yBAAyB,CAAC,CAAC;CA4BjD"}

package/dist/cloudforge/index.d.ts

@@ -0,0 +1,4 @@
+export * from './d1-adapter.js';
+export * from './do-storage.js';
+export * from './r2-backup.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cloudforge/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC"}

package/dist/cloudforge/r2-backup.d.ts

@@ -0,0 +1,38 @@
+import { Result, Logger } from '@gl-life/gl-life-core';
+import type { R2BackupConfig, R2BackupError, R2BackupAdapter as IR2BackupAdapter, BackupInfo, BackupOptions, RestoreOptions } from '../types/cloudforge.js';
+/**
+ * R2 backup adapter implementation
+ *
+ * Provides database backup and restore functionality using Cloudflare R2 storage
+ * with compression support and metadata tracking.
+ */
+export declare class R2BackupAdapter implements IR2BackupAdapter {
+    readonly config: R2BackupConfig;
+    private readonly bucket;
+    private readonly logger;
+    constructor(config: R2BackupConfig, logger: Logger);
+    /**
+     * Create a backup with compression
+     */
+    backup(data: ArrayBuffer | Buffer, options?: BackupOptions): Promise<Result<BackupInfo, R2BackupError>>;
+    /**
+     * Restore from a backup with decompression
+     */
+    restore(key: string, options?: RestoreOptions): Promise<Result<ArrayBuffer, R2BackupError>>;
+    /**
+     * List all backups
+     */
+    listBackups(options?: {
+        limit?: number;
+        cursor?: string;
+    }): Promise<Result<BackupInfo[], R2BackupError>>;
+    /**
+     * Delete a single backup
+     */
+    deleteBackup(key: string): Promise<Result<void, R2BackupError>>;
+    /**
+     * Delete multiple backups (batched for efficiency)
+     */
+    deleteMultipleBackups(keys: string[]): Promise<Result<void, R2BackupError>>;
+}
+//# sourceMappingURL=r2-backup.d.ts.map

package/dist/cloudforge/r2-backup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"r2-backup.d.ts","sourceRoot":"","sources":["../../src/cloudforge/r2-backup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAEvD,OAAO,KAAK,EAEV,cAAc,EACd,aAAa,EACb,eAAe,IAAI,gBAAgB,EACnC,UAAU,EACV,aAAa,EACb,cAAc,EACf,MAAM,wBAAwB,CAAC;AAEhC;;;;;GAKG;AACH,qBAAa,eAAgB,YAAW,gBAAgB;IACtD,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAW;IAClC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAEpB,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM;IAMlD;;OAEG;IACG,MAAM,CACV,IAAI,EAAE,WAAW,GAAG,MAAM,EAC1B,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;IAmG7C;;OAEG;IACG,OAAO,CACX,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC;IA8D9C;;OAEG;IACG,WAAW,CAAC,OAAO,CAAC,EAAE;QAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,GAAG,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,EAAE,aAAa,CAAC,CAAC;IA6ChD;;OAEG;IACG,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;IAmBrE;;OAEG;IACG,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;CAgClF"}

package/dist/connection/index.d.ts

@@ -0,0 +1,2 @@
+export * from './manager.js';
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/connection/manager.d.ts

@@ -0,0 +1,54 @@
+import { Result, Logger } from '@gl-life/gl-life-core';
+import type { DatabaseConnection, DatabaseConnectionConfig, DatabaseConnectionError } from '../types/connection.js';
+/**
+ * Extended configuration for connection manager
+ */
+interface ConnectionManagerConfig extends DatabaseConnectionConfig {
+    autoReconnect?: boolean;
+    maxRetries?: number;
+    retryDelay?: number;
+}
+/**
+ * Database connection manager with pooling, health checks, and auto-reconnect
+ */
+export declare class DatabaseConnectionManager {
+    private config;
+    private logger;
+    private pool;
+    private available;
+    private active;
+    private initialized;
+    private destroyed;
+    private connectionIdCounter;
+    constructor(config: ConnectionManagerConfig, logger: Logger);
+    /**
+     * Get manager configuration
+     */
+    getConfig(): ConnectionManagerConfig;
+    /**
+     * Get number of active connections
+     */
+    getActiveCount(): number;
+    /**
+     * Initialize the connection manager
+     */
+    initialize(): Promise<Result<void, DatabaseConnectionError>>;
+    /**
+     * Acquire a connection from the pool
+     */
+    acquire(): Promise<Result<DatabaseConnection, DatabaseConnectionError>>;
+    /**
+     * Release a connection back to the pool
+     */
+    release(connection: DatabaseConnection): Promise<Result<void, DatabaseConnectionError>>;
+    /**
+     * Perform health check on all connections
+     */
+    healthCheck(): Promise<Result<boolean, DatabaseConnectionError>>;
+    /**
+     * Destroy the connection manager and close all connections
+     */
+    destroy(): Promise<Result<void, DatabaseConnectionError>>;
+}
+export {};
+//# sourceMappingURL=manager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/connection/manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,KAAK,EACV,kBAAkB,EAClB,wBAAwB,EACxB,uBAAuB,EACxB,MAAM,wBAAwB,CAAC;AAEhC;;GAEG;AACH,UAAU,uBAAwB,SAAQ,wBAAwB;IAChE,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAyFD;;GAEG;AACH,qBAAa,yBAAyB;IACpC,OAAO,CAAC,MAAM,CAA0B;IACxC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,IAAI,CAA4B;IACxC,OAAO,CAAC,SAAS,CAA4B;IAC7C,OAAO,CAAC,MAAM,CAAsC;IACpD,OAAO,CAAC,WAAW,CAAkB;IACrC,OAAO,CAAC,SAAS,CAAkB;IACnC,OAAO,CAAC,mBAAmB,CAAa;gBAE5B,MAAM,EAAE,uBAAuB,EAAE,MAAM,EAAE,MAAM;IAoB3D;;OAEG;IACH,SAAS,IAAI,uBAAuB;IAIpC;;OAEG;IACH,cAAc,IAAI,MAAM;IAIxB;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,uBAAuB,CAAC,CAAC;IA+BlE;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC,kBAAkB,EAAE,uBAAuB,CAAC,CAAC;IAgF7E;;OAEG;IACG,OAAO,CAAC,UAAU,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,uBAAuB,CAAC,CAAC;IA2B7F;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,uBAAuB,CAAC,CAAC;IA8CtE;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,uBAAuB,CAAC,CAAC;CA+BhE"}