@flight-framework/core 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024-2026 Flight 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/dist/actions/index.d.ts

@@ -0,0 +1,108 @@
+/**
+ * @flight/core - Server Actions
+ *
+ * Implementation of React 19 style Server Actions.
+ * Functions marked with 'use server' run on the server.
+ */
+/**
+ * Server action metadata
+ */
+interface ServerAction {
+    /** Unique action ID */
+    id: string;
+    /** Original function name */
+    name: string;
+    /** File path where action is defined */
+    filePath: string;
+    /** The actual action function */
+    fn: (...args: unknown[]) => Promise<unknown>;
+}
+/**
+ * Server action result
+ */
+interface ActionResult<T = unknown> {
+    success: boolean;
+    data?: T;
+    error?: string;
+}
+/**
+ * Form action data
+ */
+interface FormActionData {
+    actionId: string;
+    formData: FormData;
+}
+/**
+ * Register a server action
+ */
+declare function registerAction(action: ServerAction): void;
+/**
+ * Get a registered action by ID
+ */
+declare function getAction(id: string): ServerAction | undefined;
+/**
+ * Get all registered actions
+ */
+declare function getAllActions(): ServerAction[];
+/**
+ * Clear all registered actions (useful for testing)
+ */
+declare function clearActions(): void;
+/**
+ * Execute a server action
+ */
+declare function executeAction<T = unknown>(actionId: string, args: unknown[]): Promise<ActionResult<T>>;
+/**
+ * Execute a form action
+ */
+declare function executeFormAction<T = unknown>(actionId: string, formData: FormData): Promise<ActionResult<T>>;
+/**
+ * Generate a unique action ID
+ */
+declare function generateActionId(name: string, filePath: string): string;
+/**
+ * Get cookies in server action context
+ */
+declare function cookies(): {
+    get: (name: string) => string | undefined;
+    set: (name: string, value: string, options?: CookieOptions) => void;
+    delete: (name: string) => void;
+};
+interface CookieOptions {
+    maxAge?: number;
+    expires?: Date;
+    path?: string;
+    domain?: string;
+    secure?: boolean;
+    httpOnly?: boolean;
+    sameSite?: 'strict' | 'lax' | 'none';
+}
+/**
+ * Redirect in server action context
+ */
+declare function redirect(url: string): never;
+/**
+ * Special error for redirects
+ */
+declare class RedirectError extends Error {
+    readonly url: string;
+    constructor(url: string);
+}
+/**
+ * Check if error is a redirect
+ */
+declare function isRedirectError(error: unknown): error is RedirectError;
+/**
+ * Parse form data to typed object
+ */
+declare function parseFormData<T extends Record<string, string>>(formData: FormData): T;
+/**
+ * Create action reference for form action attribute
+ */
+declare function createActionReference(actionId: string): string;
+/**
+ * Handle action request from client
+ */
+declare function handleActionRequest(request: Request): Promise<Response>;
+
+export { type ActionResult, type CookieOptions, type FormActionData, RedirectError, type ServerAction, clearActions, cookies, createActionReference, executeAction, executeFormAction, generateActionId, getAction, getAllActions, handleActionRequest, isRedirectError, parseFormData, redirect, registerAction };

package/dist/actions/index.js

@@ -0,0 +1,3 @@
+export { RedirectError, clearActions, cookies, createActionReference, executeAction, executeFormAction, generateActionId, getAction, getAllActions, handleActionRequest, isRedirectError, parseFormData, redirect, registerAction } from '../chunk-TKXN7KGE.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/actions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

package/dist/adapters/index.d.ts

@@ -0,0 +1,243 @@
+/**
+ * Flight Adapters - Universal deployment adapters
+ *
+ * Adapters transform Flight's output for different deployment targets.
+ * The user chooses where to deploy - Flight provides the adapters.
+ */
+/** Build manifest containing all generated assets */
+interface BuildManifest {
+    /** Entry points by name */
+    entries: Record<string, string>;
+    /** All generated files */
+    files: string[];
+    /** Route information */
+    routes: RouteManifestEntry[];
+    /** Server entry point (if applicable) */
+    serverEntry?: string;
+    /** Client entry point */
+    clientEntry?: string;
+}
+/** Route information in manifest */
+interface RouteManifestEntry {
+    /** Route path pattern */
+    path: string;
+    /** Render mode for this route */
+    mode: 'ssr' | 'ssg' | 'csr' | 'isr';
+    /** Component/handler file path */
+    component: string;
+    /** Pre-rendered paths (for SSG/ISR) */
+    prerendered?: string[];
+}
+/** Builder utilities passed to adapters */
+interface AdapterBuilder {
+    /** Build manifest */
+    manifest: BuildManifest;
+    /** Project root directory */
+    root: string;
+    /** Build output directory */
+    outDir: string;
+    /** Read a file from the build output */
+    readFile(path: string): Promise<string>;
+    /** Write a file to the adapter output */
+    writeFile(path: string, content: string): Promise<void>;
+    /** Copy files from build to adapter output */
+    copy(from: string, to: string): Promise<void>;
+    /** Get all files matching a pattern */
+    glob(pattern: string): Promise<string[]>;
+    /** Compress files for production */
+    compress?(files: string[]): Promise<void>;
+    /** Log info message */
+    log: {
+        info(message: string): void;
+        warn(message: string): void;
+        error(message: string): void;
+    };
+}
+/** Flight adapter interface */
+interface FlightAdapter {
+    /** Adapter name */
+    name: string;
+    /**
+     * Transform the build output for the target platform
+     * This is called after Flight's build process completes
+     */
+    adapt(builder: AdapterBuilder): Promise<void>;
+    /**
+     * Optional: Start listening for requests (for Node.js/Bun adapters)
+     */
+    listen?(server: unknown, port: number): Promise<void>;
+    /**
+     * Optional: Emulate the platform during development
+     * Useful for testing platform-specific behavior locally
+     */
+    emulate?(): {
+        /** Platform-specific env vars */
+        env?: Record<string, string>;
+        /** Custom middleware for dev server */
+        middleware?: unknown[];
+    };
+    /**
+     * Optional: Declare what this adapter supports
+     * Flight uses this to warn about incompatible features
+     */
+    supports?: {
+        /** Can read files at runtime (for dynamic content) */
+        read?: () => boolean;
+        /** Supports streaming responses */
+        streaming?: () => boolean;
+        /** Supports WebSockets */
+        websockets?: () => boolean;
+        /** Supports edge runtime */
+        edge?: () => boolean;
+        /** Supports Node.js runtime */
+        node?: () => boolean;
+    };
+}
+interface AdapterOptions {
+    name: string;
+    adapt: (builder: AdapterBuilder) => Promise<void>;
+    emulate?: FlightAdapter['emulate'];
+    supports?: FlightAdapter['supports'];
+}
+/**
+ * Create a Flight adapter
+ *
+ * @example
+ * ```typescript
+ * import { createAdapter } from '@flight/core/adapters';
+ *
+ * export default function myAdapter(options = {}) {
+ *   return createAdapter({
+ *     name: 'my-adapter',
+ *     async adapt(builder) {
+ *       // Transform build output for your platform
+ *     },
+ *   });
+ * }
+ * ```
+ */
+declare function createAdapter(options: AdapterOptions): FlightAdapter;
+/**
+ * Storage Adapter Interface
+ *
+ * Implement this to use any storage provider:
+ * S3, Supabase Storage, Cloudflare R2, local filesystem, etc.
+ */
+interface StorageAdapter {
+    name: string;
+    /** Upload a file */
+    upload(path: string, data: Buffer | Uint8Array | string, options?: {
+        contentType?: string;
+        metadata?: Record<string, string>;
+    }): Promise<{
+        url: string;
+        path: string;
+    }>;
+    /** Download a file */
+    download(path: string): Promise<Buffer>;
+    /** Delete a file */
+    delete(path: string): Promise<void>;
+    /** List files with optional prefix */
+    list(prefix?: string): Promise<string[]>;
+    /** Get a signed URL for direct access */
+    getSignedUrl?(path: string, options?: {
+        expiresIn?: number;
+        operation?: 'read' | 'write';
+    }): Promise<string>;
+}
+/**
+ * Auth Adapter Interface
+ *
+ * Implement this to use any auth provider:
+ * Better Auth, Supabase Auth, Lucia, Auth.js, etc.
+ */
+interface AuthAdapter {
+    name: string;
+    /** Get the current user from a request */
+    getUser(request: Request): Promise<AuthUser | null>;
+    /** Verify a session token */
+    verifySession(token: string): Promise<AuthSession | null>;
+    /** Optional middleware for handling auth-specific routes (e.g., /api/auth/*) */
+    middleware?: (req: Request) => Promise<Response | null>;
+}
+interface AuthUser {
+    id: string;
+    email?: string;
+    name?: string;
+    avatar?: string;
+    metadata?: Record<string, unknown>;
+}
+interface AuthSession {
+    user: AuthUser;
+    expiresAt: Date;
+    token: string;
+}
+/**
+ * Email Adapter Interface
+ *
+ * Implement this to use any email provider:
+ * Resend, SendGrid, Postmark, SMTP, etc.
+ */
+interface EmailAdapter {
+    name: string;
+    /** Send an email */
+    send(options: {
+        to: string | string[];
+        subject: string;
+        html?: string;
+        text?: string;
+        from?: string;
+        replyTo?: string;
+        attachments?: Array<{
+            filename: string;
+            content: Buffer | string;
+            contentType?: string;
+        }>;
+    }): Promise<{
+        id: string;
+        success: boolean;
+    }>;
+}
+/**
+ * Queue/Jobs Adapter Interface
+ *
+ * Implement this to use any job queue:
+ * BullMQ, Quirrel, Inngest, custom, etc.
+ */
+interface JobsAdapter {
+    name: string;
+    /** Add a job to the queue */
+    enqueue<T>(jobName: string, data: T, options?: {
+        delay?: number;
+        priority?: number;
+        retries?: number;
+    }): Promise<{
+        id: string;
+    }>;
+    /** Schedule a recurring job */
+    schedule?(jobName: string, cron: string, data?: unknown): Promise<{
+        id: string;
+    }>;
+    /** Cancel a job */
+    cancel?(jobId: string): Promise<void>;
+}
+/**
+ * Database Adapter Interface
+ *
+ * Note: This is intentionally minimal.
+ * For databases, use your preferred ORM/query builder directly.
+ * This interface is for Flight's internal use (sessions, cache, etc.)
+ */
+interface DatabaseAdapter {
+    name: string;
+    /** Raw query execution */
+    query<T = unknown>(sql: string, params?: unknown[]): Promise<T[]>;
+    /** Execute a mutation */
+    execute(sql: string, params?: unknown[]): Promise<{
+        rowsAffected: number;
+    }>;
+    /** Transaction support */
+    transaction?<T>(fn: (tx: DatabaseAdapter) => Promise<T>): Promise<T>;
+}
+
+export { type AdapterBuilder, type AdapterOptions, type AuthAdapter, type AuthSession, type AuthUser, type BuildManifest, type DatabaseAdapter, type EmailAdapter, type FlightAdapter, type JobsAdapter, type RouteManifestEntry, type StorageAdapter, createAdapter };

package/dist/adapters/index.js

@@ -0,0 +1,3 @@
+export { createAdapter } from '../chunk-Q4C5CCHK.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/adapters/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

package/dist/cache/index.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Flight Cache - Agnostic caching primitives
+ *
+ * Flight provides the interface, you choose the implementation.
+ * Use in-memory, Redis, Cloudflare KV, or anything else.
+ */
+interface CacheOptions {
+    /** Time-to-live in seconds */
+    ttl?: number;
+    /** Cache tags for invalidation */
+    tags?: string[];
+    /** Stale-while-revalidate time in seconds */
+    swr?: number;
+}
+interface CacheEntry<T> {
+    /** Cached value */
+    value: T;
+    /** When this entry expires (timestamp) */
+    expiresAt?: number;
+    /** When this entry becomes stale (timestamp) */
+    staleAt?: number;
+    /** Cache tags for invalidation */
+    tags?: string[];
+    /** When this entry was created */
+    createdAt: number;
+}
+interface Cache {
+    /** Get a value from cache */
+    get<T>(key: string): Promise<T | undefined>;
+    /** Set a value in cache */
+    set<T>(key: string, value: T, options?: CacheOptions): Promise<void>;
+    /** Delete a value from cache */
+    delete(key: string): Promise<boolean>;
+    /** Check if a key exists */
+    has(key: string): Promise<boolean>;
+    /** Clear all cache entries */
+    clear(): Promise<void>;
+    /** Invalidate entries by tag */
+    invalidateTag(tag: string): Promise<void>;
+    /** Get or set with a factory function */
+    getOrSet<T>(key: string, factory: () => Promise<T>, options?: CacheOptions): Promise<T>;
+}
+/** Adapter interface for external cache providers */
+interface CacheAdapter {
+    name: string;
+    get<T>(key: string): Promise<CacheEntry<T> | undefined>;
+    set<T>(key: string, entry: CacheEntry<T>): Promise<void>;
+    delete(key: string): Promise<boolean>;
+    has(key: string): Promise<boolean>;
+    clear(): Promise<void>;
+    keys?(pattern?: string): Promise<string[]>;
+}
+interface CreateCacheOptions {
+    /** Custom cache adapter (defaults to in-memory) */
+    adapter?: CacheAdapter;
+    /** Default TTL for all entries */
+    defaultTTL?: number;
+    /** Key prefix for namespacing */
+    prefix?: string;
+}
+/**
+ * Create a new cache instance
+ */
+declare function createCache(options?: CreateCacheOptions): Cache;
+/**
+ * Create a cache key from multiple parts
+ */
+declare function cacheKey(...parts: (string | number | boolean | undefined)[]): string;
+/**
+ * Wrap a function with caching
+ */
+declare function cached<T extends (...args: unknown[]) => Promise<unknown>>(cache: Cache, fn: T, options?: CacheOptions & {
+    keyFn?: (...args: Parameters<T>) => string;
+}): T;
+
+export { type Cache, type CacheAdapter, type CacheEntry, type CacheOptions, type CreateCacheOptions, cacheKey, cached, createCache };

package/dist/cache/index.js

@@ -0,0 +1,3 @@
+export { cacheKey, cached, createCache } from '../chunk-3AIQVGTM.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/cache/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

package/dist/chunk-3AIQVGTM.js

@@ -0,0 +1,120 @@
+// src/cache/index.ts
+var MemoryCacheAdapter = class {
+  name = "memory";
+  store = /* @__PURE__ */ new Map();
+  async get(key) {
+    const entry = this.store.get(key);
+    if (!entry) return void 0;
+    if (entry.expiresAt && Date.now() > entry.expiresAt) {
+      this.store.delete(key);
+      return void 0;
+    }
+    return entry;
+  }
+  async set(key, entry) {
+    this.store.set(key, entry);
+  }
+  async delete(key) {
+    return this.store.delete(key);
+  }
+  async has(key) {
+    const entry = await this.get(key);
+    return entry !== void 0;
+  }
+  async clear() {
+    this.store.clear();
+  }
+  async keys(pattern) {
+    const allKeys = Array.from(this.store.keys());
+    if (!pattern) return allKeys;
+    const regex = new RegExp(pattern.replace(/\*/g, ".*"));
+    return allKeys.filter((key) => regex.test(key));
+  }
+};
+function createCache(options = {}) {
+  const {
+    adapter = new MemoryCacheAdapter(),
+    defaultTTL,
+    prefix = ""
+  } = options;
+  const tagIndex = /* @__PURE__ */ new Map();
+  function prefixKey(key) {
+    return prefix ? `${prefix}:${key}` : key;
+  }
+  return {
+    async get(key) {
+      const entry = await adapter.get(prefixKey(key));
+      if (!entry) return void 0;
+      if (entry.staleAt && Date.now() > entry.staleAt) {
+        return entry.value;
+      }
+      return entry.value;
+    },
+    async set(key, value, opts) {
+      const ttl = opts?.ttl ?? defaultTTL;
+      const now = Date.now();
+      const entry = {
+        value,
+        createdAt: now,
+        tags: opts?.tags
+      };
+      if (ttl) {
+        entry.expiresAt = now + ttl * 1e3;
+        if (opts?.swr) {
+          entry.staleAt = now + (ttl - opts.swr) * 1e3;
+        }
+      }
+      const fullKey = prefixKey(key);
+      await adapter.set(fullKey, entry);
+      if (opts?.tags) {
+        for (const tag of opts.tags) {
+          if (!tagIndex.has(tag)) {
+            tagIndex.set(tag, /* @__PURE__ */ new Set());
+          }
+          tagIndex.get(tag).add(fullKey);
+        }
+      }
+    },
+    async delete(key) {
+      return adapter.delete(prefixKey(key));
+    },
+    async has(key) {
+      return adapter.has(prefixKey(key));
+    },
+    async clear() {
+      await adapter.clear();
+      tagIndex.clear();
+    },
+    async invalidateTag(tag) {
+      const keys = tagIndex.get(tag);
+      if (!keys) return;
+      for (const key of keys) {
+        await adapter.delete(key);
+      }
+      tagIndex.delete(tag);
+    },
+    async getOrSet(key, factory, opts) {
+      const cached2 = await this.get(key);
+      if (cached2 !== void 0) {
+        return cached2;
+      }
+      const value = await factory();
+      await this.set(key, value, opts);
+      return value;
+    }
+  };
+}
+function cacheKey(...parts) {
+  return parts.filter((p) => p !== void 0).map((p) => String(p)).join(":");
+}
+function cached(cache, fn, options) {
+  const { keyFn = (...args) => JSON.stringify(args), ...cacheOpts } = options ?? {};
+  return (async (...args) => {
+    const key = keyFn(...args);
+    return cache.getOrSet(key, () => fn(...args), cacheOpts);
+  });
+}
+
+export { cacheKey, cached, createCache };
+//# sourceMappingURL=chunk-3AIQVGTM.js.map
+//# sourceMappingURL=chunk-3AIQVGTM.js.map

package/dist/chunk-3AIQVGTM.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cache/index.ts"],"names":["cached"],"mappings":"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","file":"chunk-3AIQVGTM.js","sourcesContent":["/**\r\n * Flight Cache - Agnostic caching primitives\r\n * \r\n * Flight provides the interface, you choose the implementation.\r\n * Use in-memory, Redis, Cloudflare KV, or anything else.\r\n */\r\n\r\n// ============================================================================\r\n// Types\r\n// ============================================================================\r\n\r\nexport interface CacheOptions {\r\n    /** Time-to-live in seconds */\r\n    ttl?: number;\r\n    /** Cache tags for invalidation */\r\n    tags?: string[];\r\n    /** Stale-while-revalidate time in seconds */\r\n    swr?: number;\r\n}\r\n\r\nexport interface CacheEntry<T> {\r\n    /** Cached value */\r\n    value: T;\r\n    /** When this entry expires (timestamp) */\r\n    expiresAt?: number;\r\n    /** When this entry becomes stale (timestamp) */\r\n    staleAt?: number;\r\n    /** Cache tags for invalidation */\r\n    tags?: string[];\r\n    /** When this entry was created */\r\n    createdAt: number;\r\n}\r\n\r\nexport interface Cache {\r\n    /** Get a value from cache */\r\n    get<T>(key: string): Promise<T | undefined>;\r\n\r\n    /** Set a value in cache */\r\n    set<T>(key: string, value: T, options?: CacheOptions): Promise<void>;\r\n\r\n    /** Delete a value from cache */\r\n    delete(key: string): Promise<boolean>;\r\n\r\n    /** Check if a key exists */\r\n    has(key: string): Promise<boolean>;\r\n\r\n    /** Clear all cache entries */\r\n    clear(): Promise<void>;\r\n\r\n    /** Invalidate entries by tag */\r\n    invalidateTag(tag: string): Promise<void>;\r\n\r\n    /** Get or set with a factory function */\r\n    getOrSet<T>(\r\n        key: string,\r\n        factory: () => Promise<T>,\r\n        options?: CacheOptions\r\n    ): Promise<T>;\r\n}\r\n\r\n/** Adapter interface for external cache providers */\r\nexport interface CacheAdapter {\r\n    name: string;\r\n    get<T>(key: string): Promise<CacheEntry<T> | undefined>;\r\n    set<T>(key: string, entry: CacheEntry<T>): Promise<void>;\r\n    delete(key: string): Promise<boolean>;\r\n    has(key: string): Promise<boolean>;\r\n    clear(): Promise<void>;\r\n    keys?(pattern?: string): Promise<string[]>;\r\n}\r\n\r\n// ============================================================================\r\n// In-Memory Cache Implementation (Default)\r\n// ============================================================================\r\n\r\nclass MemoryCacheAdapter implements CacheAdapter {\r\n    name = 'memory';\r\n    private store = new Map<string, CacheEntry<unknown>>();\r\n\r\n    async get<T>(key: string): Promise<CacheEntry<T> | undefined> {\r\n        const entry = this.store.get(key) as CacheEntry<T> | undefined;\r\n        if (!entry) return undefined;\r\n\r\n        // Check if expired\r\n        if (entry.expiresAt && Date.now() > entry.expiresAt) {\r\n            this.store.delete(key);\r\n            return undefined;\r\n        }\r\n\r\n        return entry;\r\n    }\r\n\r\n    async set<T>(key: string, entry: CacheEntry<T>): Promise<void> {\r\n        this.store.set(key, entry as CacheEntry<unknown>);\r\n    }\r\n\r\n    async delete(key: string): Promise<boolean> {\r\n        return this.store.delete(key);\r\n    }\r\n\r\n    async has(key: string): Promise<boolean> {\r\n        const entry = await this.get(key);\r\n        return entry !== undefined;\r\n    }\r\n\r\n    async clear(): Promise<void> {\r\n        this.store.clear();\r\n    }\r\n\r\n    async keys(pattern?: string): Promise<string[]> {\r\n        const allKeys = Array.from(this.store.keys());\r\n        if (!pattern) return allKeys;\r\n\r\n        const regex = new RegExp(pattern.replace(/\\*/g, '.*'));\r\n        return allKeys.filter(key => regex.test(key));\r\n    }\r\n}\r\n\r\n// ============================================================================\r\n// Cache Factory\r\n// ============================================================================\r\n\r\nexport interface CreateCacheOptions {\r\n    /** Custom cache adapter (defaults to in-memory) */\r\n    adapter?: CacheAdapter;\r\n    /** Default TTL for all entries */\r\n    defaultTTL?: number;\r\n    /** Key prefix for namespacing */\r\n    prefix?: string;\r\n}\r\n\r\n/**\r\n * Create a new cache instance\r\n */\r\nexport function createCache(options: CreateCacheOptions = {}): Cache {\r\n    const {\r\n        adapter = new MemoryCacheAdapter(),\r\n        defaultTTL,\r\n        prefix = ''\r\n    } = options;\r\n\r\n    const tagIndex = new Map<string, Set<string>>();\r\n\r\n    function prefixKey(key: string): string {\r\n        return prefix ? `${prefix}:${key}` : key;\r\n    }\r\n\r\n    return {\r\n        async get<T>(key: string): Promise<T | undefined> {\r\n            const entry = await adapter.get<T>(prefixKey(key));\r\n            if (!entry) return undefined;\r\n\r\n            // Check stale-while-revalidate\r\n            if (entry.staleAt && Date.now() > entry.staleAt) {\r\n                // Return stale value (caller should revalidate)\r\n                return entry.value;\r\n            }\r\n\r\n            return entry.value;\r\n        },\r\n\r\n        async set<T>(key: string, value: T, opts?: CacheOptions): Promise<void> {\r\n            const ttl = opts?.ttl ?? defaultTTL;\r\n            const now = Date.now();\r\n\r\n            const entry: CacheEntry<T> = {\r\n                value,\r\n                createdAt: now,\r\n                tags: opts?.tags,\r\n            };\r\n\r\n            if (ttl) {\r\n                entry.expiresAt = now + (ttl * 1000);\r\n                if (opts?.swr) {\r\n                    entry.staleAt = now + ((ttl - opts.swr) * 1000);\r\n                }\r\n            }\r\n\r\n            const fullKey = prefixKey(key);\r\n            await adapter.set(fullKey, entry);\r\n\r\n            // Update tag index\r\n            if (opts?.tags) {\r\n                for (const tag of opts.tags) {\r\n                    if (!tagIndex.has(tag)) {\r\n                        tagIndex.set(tag, new Set());\r\n                    }\r\n                    tagIndex.get(tag)!.add(fullKey);\r\n                }\r\n            }\r\n        },\r\n\r\n        async delete(key: string): Promise<boolean> {\r\n            return adapter.delete(prefixKey(key));\r\n        },\r\n\r\n        async has(key: string): Promise<boolean> {\r\n            return adapter.has(prefixKey(key));\r\n        },\r\n\r\n        async clear(): Promise<void> {\r\n            await adapter.clear();\r\n            tagIndex.clear();\r\n        },\r\n\r\n        async invalidateTag(tag: string): Promise<void> {\r\n            const keys = tagIndex.get(tag);\r\n            if (!keys) return;\r\n\r\n            for (const key of keys) {\r\n                await adapter.delete(key);\r\n            }\r\n            tagIndex.delete(tag);\r\n        },\r\n\r\n        async getOrSet<T>(\r\n            key: string,\r\n            factory: () => Promise<T>,\r\n            opts?: CacheOptions\r\n        ): Promise<T> {\r\n            const cached = await this.get<T>(key);\r\n            if (cached !== undefined) {\r\n                return cached;\r\n            }\r\n\r\n            const value = await factory();\r\n            await this.set(key, value, opts);\r\n            return value;\r\n        },\r\n    };\r\n}\r\n\r\n// ============================================================================\r\n// Cache Utilities\r\n// ============================================================================\r\n\r\n/**\r\n * Create a cache key from multiple parts\r\n */\r\nexport function cacheKey(...parts: (string | number | boolean | undefined)[]): string {\r\n    return parts\r\n        .filter(p => p !== undefined)\r\n        .map(p => String(p))\r\n        .join(':');\r\n}\r\n\r\n/**\r\n * Wrap a function with caching\r\n */\r\nexport function cached<T extends (...args: unknown[]) => Promise<unknown>>(\r\n    cache: Cache,\r\n    fn: T,\r\n    options?: CacheOptions & { keyFn?: (...args: Parameters<T>) => string }\r\n): T {\r\n    const { keyFn = (...args: unknown[]) => JSON.stringify(args), ...cacheOpts } = options ?? {};\r\n\r\n    return (async (...args: Parameters<T>) => {\r\n        const key = keyFn(...args);\r\n        return cache.getOrSet(key, () => fn(...args) as Promise<unknown>, cacheOpts);\r\n    }) as T;\r\n}\r\n"]}