@flightdev/core 0.6.7

package/dist/chunk-ZZZML7Y3.js

@@ -0,0 +1,310 @@
+// src/cache/index.ts
+var jsonSerializer = {
+  serialize: (value) => JSON.stringify(value),
+  deserialize: (data) => JSON.parse(data)
+};
+var MemoryCacheAdapter = class {
+  name = "memory";
+  supportsDistributedTags = false;
+  store = /* @__PURE__ */ new Map();
+  tagIndex = /* @__PURE__ */ new Map();
+  maxSize;
+  cleanupTimer;
+  constructor(options = {}) {
+    this.maxSize = options.maxSize ?? 0;
+    const interval = options.cleanupInterval ?? 6e4;
+    if (interval > 0) {
+      this.cleanupTimer = setInterval(() => this.cleanup(), interval);
+    }
+  }
+  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);
+      this.removeFromTagIndex(key, entry.tags);
+      return void 0;
+    }
+    return entry;
+  }
+  async set(key, entry) {
+    if (this.maxSize > 0 && this.store.size >= this.maxSize && !this.store.has(key)) {
+      const firstKey = this.store.keys().next().value;
+      if (firstKey) {
+        const evicted = this.store.get(firstKey);
+        this.store.delete(firstKey);
+        if (evicted?.tags) {
+          this.removeFromTagIndex(firstKey, evicted.tags);
+        }
+      }
+    }
+    this.store.set(key, entry);
+    if (entry.tags) {
+      for (const tag of entry.tags) {
+        if (!this.tagIndex.has(tag)) {
+          this.tagIndex.set(tag, /* @__PURE__ */ new Set());
+        }
+        this.tagIndex.get(tag).add(key);
+      }
+    }
+  }
+  async delete(key) {
+    const entry = this.store.get(key);
+    if (entry?.tags) {
+      this.removeFromTagIndex(key, entry.tags);
+    }
+    return this.store.delete(key);
+  }
+  async has(key) {
+    const entry = await this.get(key);
+    return entry !== void 0;
+  }
+  async clear() {
+    this.store.clear();
+    this.tagIndex.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));
+  }
+  async getMany(keys) {
+    const result = /* @__PURE__ */ new Map();
+    for (const key of keys) {
+      result.set(key, await this.get(key));
+    }
+    return result;
+  }
+  async setMany(entries) {
+    for (const [key, entry] of entries) {
+      await this.set(key, entry);
+    }
+  }
+  // In-memory adapter handles tags locally (non-distributed)
+  async addToTag(tag, key) {
+    if (!this.tagIndex.has(tag)) {
+      this.tagIndex.set(tag, /* @__PURE__ */ new Set());
+    }
+    this.tagIndex.get(tag).add(key);
+  }
+  async getTagMembers(tag) {
+    return Array.from(this.tagIndex.get(tag) ?? []);
+  }
+  async deleteTag(tag) {
+    const members = await this.getTagMembers(tag);
+    this.tagIndex.delete(tag);
+    return members;
+  }
+  async close() {
+    if (this.cleanupTimer) {
+      clearInterval(this.cleanupTimer);
+    }
+    this.store.clear();
+    this.tagIndex.clear();
+  }
+  async ping() {
+    return true;
+  }
+  removeFromTagIndex(key, tags) {
+    if (!tags) return;
+    for (const tag of tags) {
+      this.tagIndex.get(tag)?.delete(key);
+    }
+  }
+  cleanup() {
+    const now = Date.now();
+    for (const [key, entry] of this.store) {
+      if (entry.expiresAt && now > entry.expiresAt) {
+        this.store.delete(key);
+        this.removeFromTagIndex(key, entry.tags);
+      }
+    }
+  }
+};
+function memory(options = {}) {
+  return new MemoryCacheAdapter(options);
+}
+function createCache(options = {}) {
+  const {
+    adapter = new MemoryCacheAdapter(),
+    defaultTTL,
+    prefix = "",
+    trackStats = false
+  } = options;
+  const localTagIndex = /* @__PURE__ */ new Map();
+  const stats = { hits: 0, misses: 0, sets: 0, deletes: 0 };
+  function prefixKey(key) {
+    return prefix ? `${prefix}:${key}` : key;
+  }
+  function useDistributedTags() {
+    return !!(adapter.supportsDistributedTags && adapter.addToTag && adapter.getTagMembers && adapter.deleteTag);
+  }
+  async function registerTags(fullKey, tags) {
+    if (!tags || tags.length === 0) return;
+    if (useDistributedTags()) {
+      for (const tag of tags) {
+        await adapter.addToTag(tag, fullKey);
+      }
+    } else {
+      for (const tag of tags) {
+        if (!localTagIndex.has(tag)) {
+          localTagIndex.set(tag, /* @__PURE__ */ new Set());
+        }
+        localTagIndex.get(tag).add(fullKey);
+      }
+    }
+  }
+  async function getTagMembers(tag) {
+    if (useDistributedTags()) {
+      return adapter.getTagMembers(tag);
+    }
+    return Array.from(localTagIndex.get(tag) ?? []);
+  }
+  async function removeTag(tag) {
+    if (useDistributedTags()) {
+      await adapter.deleteTag(tag);
+    } else {
+      localTagIndex.delete(tag);
+    }
+  }
+  return {
+    async get(key) {
+      const entry = await adapter.get(prefixKey(key));
+      if (!entry) {
+        if (trackStats) stats.misses++;
+        return void 0;
+      }
+      if (trackStats) stats.hits++;
+      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);
+      await registerTags(fullKey, opts?.tags);
+      if (trackStats) stats.sets++;
+    },
+    async delete(key) {
+      const fullKey = prefixKey(key);
+      const result = await adapter.delete(fullKey);
+      if (trackStats && result) stats.deletes++;
+      return result;
+    },
+    async has(key) {
+      return adapter.has(prefixKey(key));
+    },
+    async clear() {
+      await adapter.clear();
+      localTagIndex.clear();
+    },
+    async invalidateTag(tag) {
+      const keys = await getTagMembers(tag);
+      for (const key of keys) {
+        await adapter.delete(key);
+      }
+      await removeTag(tag);
+    },
+    async invalidateTags(tags) {
+      for (const tag of tags) {
+        await this.invalidateTag(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;
+    },
+    async getMany(keys) {
+      const result = /* @__PURE__ */ new Map();
+      if (adapter.getMany) {
+        const entries = await adapter.getMany(keys.map(prefixKey));
+        for (const [key, entry] of entries) {
+          const originalKey = prefix ? key.slice(prefix.length + 1) : key;
+          result.set(originalKey, entry?.value);
+        }
+      } else {
+        for (const key of keys) {
+          result.set(key, await this.get(key));
+        }
+      }
+      return result;
+    },
+    async setMany(entries, opts) {
+      const ttl = opts?.ttl ?? defaultTTL;
+      const now = Date.now();
+      const cacheEntries = /* @__PURE__ */ new Map();
+      for (const [key, value] of entries) {
+        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);
+        cacheEntries.set(fullKey, entry);
+        await registerTags(fullKey, opts?.tags);
+      }
+      if (adapter.setMany) {
+        await adapter.setMany(cacheEntries);
+      } else {
+        for (const [key, entry] of cacheEntries) {
+          await adapter.set(key, entry);
+        }
+      }
+      if (trackStats) stats.sets += entries.size;
+    },
+    getStats() {
+      return trackStats ? { ...stats } : void 0;
+    }
+  };
+}
+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);
+  });
+}
+function dedupe(fn, keyFn = (...args) => JSON.stringify(args)) {
+  const pending = /* @__PURE__ */ new Map();
+  return (async (...args) => {
+    const key = keyFn(...args);
+    if (pending.has(key)) {
+      return pending.get(key);
+    }
+    const promise = fn(...args).finally(() => {
+      pending.delete(key);
+    });
+    pending.set(key, promise);
+    return promise;
+  });
+}
+
+export { cacheKey, cached, createCache, dedupe, jsonSerializer, memory };
+//# sourceMappingURL=chunk-ZZZML7Y3.js.map
+//# sourceMappingURL=chunk-ZZZML7Y3.js.map

package/dist/chunk-ZZZML7Y3.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cache/index.ts"],"names":["cached"],"mappings":"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","file":"chunk-ZZZML7Y3.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, Upstash, or anything else.\r\n * \r\n * @example\r\n * ```typescript\r\n * import { createCache } from '@flightdev/core';\r\n * import { redis } from '@flightdev/cache-redis';\r\n * \r\n * const cache = createCache({\r\n *     adapter: redis({ url: process.env.REDIS_URL }),\r\n *     defaultTTL: 3600,\r\n * });\r\n * \r\n * await cache.set('user:1', userData, { tags: ['users'] });\r\n * await cache.invalidateTag('users');\r\n * ```\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    /** Invalidate entries by multiple tags */\r\n    invalidateTags(tags: 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    /** Get multiple values at once */\r\n    getMany<T>(keys: string[]): Promise<Map<string, T | undefined>>;\r\n\r\n    /** Set multiple values at once */\r\n    setMany<T>(entries: Map<string, T>, options?: CacheOptions): Promise<void>;\r\n\r\n    /** Get cache statistics (if tracking enabled) */\r\n    getStats?(): CacheStats | undefined;\r\n}\r\n\r\nexport interface CacheStats {\r\n    hits: number;\r\n    misses: number;\r\n    sets: number;\r\n    deletes: number;\r\n}\r\n\r\n/** Adapter interface for external cache providers */\r\nexport interface CacheAdapter {\r\n    /** Adapter name for identification */\r\n    readonly name: string;\r\n\r\n    /** Get an entry from cache */\r\n    get<T>(key: string): Promise<CacheEntry<T> | undefined>;\r\n\r\n    /** Set an entry in cache */\r\n    set<T>(key: string, entry: CacheEntry<T>): Promise<void>;\r\n\r\n    /** Delete an entry from cache */\r\n    delete(key: string): Promise<boolean>;\r\n\r\n    /** Check if key exists */\r\n    has(key: string): Promise<boolean>;\r\n\r\n    /** Clear all entries */\r\n    clear(): Promise<void>;\r\n\r\n    /** Get keys matching pattern (optional) */\r\n    keys?(pattern?: string): Promise<string[]>;\r\n\r\n    /** Get multiple entries at once (optional, for performance) */\r\n    getMany?<T>(keys: string[]): Promise<Map<string, CacheEntry<T> | undefined>>;\r\n\r\n    /** Set multiple entries at once (optional, for performance) */\r\n    setMany?<T>(entries: Map<string, CacheEntry<T>>): Promise<void>;\r\n\r\n    // ========================================================================\r\n    // Tag operations - For distributed caches, tags MUST be handled by adapter\r\n    // ========================================================================\r\n\r\n    /** Whether this adapter supports distributed tags natively */\r\n    readonly supportsDistributedTags?: boolean;\r\n\r\n    /** Add a key to a tag set (for distributed tag management) */\r\n    addToTag?(tag: string, key: string): Promise<void>;\r\n\r\n    /** Get all keys associated with a tag */\r\n    getTagMembers?(tag: string): Promise<string[]>;\r\n\r\n    /** Delete a tag and return its members */\r\n    deleteTag?(tag: string): Promise<string[]>;\r\n\r\n    // ========================================================================\r\n    // Lifecycle\r\n    // ========================================================================\r\n\r\n    /** Close connection (for cleanup) */\r\n    close?(): Promise<void>;\r\n\r\n    /** Check if adapter is healthy */\r\n    ping?(): Promise<boolean>;\r\n}\r\n\r\n// ============================================================================\r\n// Serialization\r\n// ============================================================================\r\n\r\nexport interface Serializer {\r\n    serialize(value: unknown): string;\r\n    deserialize<T>(data: string): T;\r\n}\r\n\r\n/** Default JSON serializer */\r\nexport const jsonSerializer: Serializer = {\r\n    serialize: (value) => JSON.stringify(value),\r\n    deserialize: <T>(data: string) => JSON.parse(data) as T,\r\n};\r\n\r\n// ============================================================================\r\n// In-Memory Cache Implementation (Default)\r\n// ============================================================================\r\n\r\nexport interface MemoryCacheAdapterOptions {\r\n    /** Maximum number of entries (0 = unlimited) */\r\n    maxSize?: number;\r\n    /** Cleanup interval in ms (default: 60000) */\r\n    cleanupInterval?: number;\r\n}\r\n\r\nclass MemoryCacheAdapter implements CacheAdapter {\r\n    readonly name = 'memory';\r\n    readonly supportsDistributedTags = false;\r\n\r\n    private store = new Map<string, CacheEntry<unknown>>();\r\n    private tagIndex = new Map<string, Set<string>>();\r\n    private maxSize: number;\r\n    private cleanupTimer?: ReturnType<typeof setInterval>;\r\n\r\n    constructor(options: MemoryCacheAdapterOptions = {}) {\r\n        this.maxSize = options.maxSize ?? 0;\r\n\r\n        // Periodic cleanup of expired entries\r\n        const interval = options.cleanupInterval ?? 60000;\r\n        if (interval > 0) {\r\n            this.cleanupTimer = setInterval(() => this.cleanup(), interval);\r\n        }\r\n    }\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            this.removeFromTagIndex(key, entry.tags);\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        // Evict if at max size (simple FIFO eviction)\r\n        if (this.maxSize > 0 && this.store.size >= this.maxSize && !this.store.has(key)) {\r\n            const firstKey = this.store.keys().next().value;\r\n            if (firstKey) {\r\n                const evicted = this.store.get(firstKey);\r\n                this.store.delete(firstKey);\r\n                if (evicted?.tags) {\r\n                    this.removeFromTagIndex(firstKey, evicted.tags);\r\n                }\r\n            }\r\n        }\r\n\r\n        this.store.set(key, entry as CacheEntry<unknown>);\r\n\r\n        // Update tag index\r\n        if (entry.tags) {\r\n            for (const tag of entry.tags) {\r\n                if (!this.tagIndex.has(tag)) {\r\n                    this.tagIndex.set(tag, new Set());\r\n                }\r\n                this.tagIndex.get(tag)!.add(key);\r\n            }\r\n        }\r\n    }\r\n\r\n    async delete(key: string): Promise<boolean> {\r\n        const entry = this.store.get(key);\r\n        if (entry?.tags) {\r\n            this.removeFromTagIndex(key, entry.tags);\r\n        }\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        this.tagIndex.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    async getMany<T>(keys: string[]): Promise<Map<string, CacheEntry<T> | undefined>> {\r\n        const result = new Map<string, CacheEntry<T> | undefined>();\r\n        for (const key of keys) {\r\n            result.set(key, await this.get<T>(key));\r\n        }\r\n        return result;\r\n    }\r\n\r\n    async setMany<T>(entries: Map<string, CacheEntry<T>>): Promise<void> {\r\n        for (const [key, entry] of entries) {\r\n            await this.set(key, entry);\r\n        }\r\n    }\r\n\r\n    // In-memory adapter handles tags locally (non-distributed)\r\n    async addToTag(tag: string, key: string): Promise<void> {\r\n        if (!this.tagIndex.has(tag)) {\r\n            this.tagIndex.set(tag, new Set());\r\n        }\r\n        this.tagIndex.get(tag)!.add(key);\r\n    }\r\n\r\n    async getTagMembers(tag: string): Promise<string[]> {\r\n        return Array.from(this.tagIndex.get(tag) ?? []);\r\n    }\r\n\r\n    async deleteTag(tag: string): Promise<string[]> {\r\n        const members = await this.getTagMembers(tag);\r\n        this.tagIndex.delete(tag);\r\n        return members;\r\n    }\r\n\r\n    async close(): Promise<void> {\r\n        if (this.cleanupTimer) {\r\n            clearInterval(this.cleanupTimer);\r\n        }\r\n        this.store.clear();\r\n        this.tagIndex.clear();\r\n    }\r\n\r\n    async ping(): Promise<boolean> {\r\n        return true;\r\n    }\r\n\r\n    private removeFromTagIndex(key: string, tags?: string[]): void {\r\n        if (!tags) return;\r\n        for (const tag of tags) {\r\n            this.tagIndex.get(tag)?.delete(key);\r\n        }\r\n    }\r\n\r\n    private cleanup(): void {\r\n        const now = Date.now();\r\n        for (const [key, entry] of this.store) {\r\n            if (entry.expiresAt && now > entry.expiresAt) {\r\n                this.store.delete(key);\r\n                this.removeFromTagIndex(key, entry.tags);\r\n            }\r\n        }\r\n    }\r\n}\r\n\r\n/**\r\n * Create in-memory cache adapter\r\n */\r\nexport function memory(options: MemoryCacheAdapterOptions = {}): CacheAdapter {\r\n    return new MemoryCacheAdapter(options);\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 (seconds) */\r\n    defaultTTL?: number;\r\n    /** Key prefix for namespacing */\r\n    prefix?: string;\r\n    /** Custom serializer (for external adapters) */\r\n    serializer?: Serializer;\r\n    /** Track cache statistics */\r\n    trackStats?: boolean;\r\n}\r\n\r\n/**\r\n * Create a new cache instance\r\n * \r\n * @example\r\n * ```typescript\r\n * // Simple in-memory cache\r\n * const cache = createCache();\r\n * \r\n * // With Redis adapter\r\n * import { redis } from '@flightdev/cache-redis';\r\n * const cache = createCache({\r\n *     adapter: redis({ url: 'redis://localhost:6379' }),\r\n *     defaultTTL: 3600,\r\n *     prefix: 'myapp',\r\n * });\r\n * ```\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        trackStats = false,\r\n    } = options;\r\n\r\n    // Local tag index for adapters that don't support distributed tags\r\n    const localTagIndex = new Map<string, Set<string>>();\r\n\r\n    // Stats tracking\r\n    const stats: CacheStats = { hits: 0, misses: 0, sets: 0, deletes: 0 };\r\n\r\n    function prefixKey(key: string): string {\r\n        return prefix ? `${prefix}:${key}` : key;\r\n    }\r\n\r\n    function useDistributedTags(): boolean {\r\n        return !!(adapter.supportsDistributedTags && adapter.addToTag && adapter.getTagMembers && adapter.deleteTag);\r\n    }\r\n\r\n    async function registerTags(fullKey: string, tags?: string[]): Promise<void> {\r\n        if (!tags || tags.length === 0) return;\r\n\r\n        if (useDistributedTags()) {\r\n            // Distributed: adapter handles tag storage\r\n            for (const tag of tags) {\r\n                await adapter.addToTag!(tag, fullKey);\r\n            }\r\n        } else {\r\n            // Local: use in-memory index (for memory adapter or simple adapters)\r\n            for (const tag of tags) {\r\n                if (!localTagIndex.has(tag)) {\r\n                    localTagIndex.set(tag, new Set());\r\n                }\r\n                localTagIndex.get(tag)!.add(fullKey);\r\n            }\r\n        }\r\n    }\r\n\r\n    async function getTagMembers(tag: string): Promise<string[]> {\r\n        if (useDistributedTags()) {\r\n            return adapter.getTagMembers!(tag);\r\n        }\r\n        return Array.from(localTagIndex.get(tag) ?? []);\r\n    }\r\n\r\n    async function removeTag(tag: string): Promise<void> {\r\n        if (useDistributedTags()) {\r\n            await adapter.deleteTag!(tag);\r\n        } else {\r\n            localTagIndex.delete(tag);\r\n        }\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\r\n            if (!entry) {\r\n                if (trackStats) stats.misses++;\r\n                return undefined;\r\n            }\r\n\r\n            if (trackStats) stats.hits++;\r\n\r\n            // Check stale-while-revalidate (return stale value, caller should revalidate)\r\n            // The value is still returned even if stale - that's the \"while revalidate\" part\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            await registerTags(fullKey, opts?.tags);\r\n\r\n            if (trackStats) stats.sets++;\r\n        },\r\n\r\n        async delete(key: string): Promise<boolean> {\r\n            const fullKey = prefixKey(key);\r\n            const result = await adapter.delete(fullKey);\r\n            if (trackStats && result) stats.deletes++;\r\n            return result;\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            localTagIndex.clear();\r\n        },\r\n\r\n        async invalidateTag(tag: string): Promise<void> {\r\n            const keys = await getTagMembers(tag);\r\n\r\n            for (const key of keys) {\r\n                await adapter.delete(key);\r\n            }\r\n\r\n            await removeTag(tag);\r\n        },\r\n\r\n        async invalidateTags(tags: string[]): Promise<void> {\r\n            for (const tag of tags) {\r\n                await this.invalidateTag(tag);\r\n            }\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        async getMany<T>(keys: string[]): Promise<Map<string, T | undefined>> {\r\n            const result = new Map<string, T | undefined>();\r\n\r\n            if (adapter.getMany) {\r\n                // Use batch operation if adapter supports it\r\n                const entries = await adapter.getMany<T>(keys.map(prefixKey));\r\n                for (const [key, entry] of entries) {\r\n                    const originalKey = prefix ? key.slice(prefix.length + 1) : key;\r\n                    result.set(originalKey, entry?.value);\r\n                }\r\n            } else {\r\n                // Fallback to individual gets\r\n                for (const key of keys) {\r\n                    result.set(key, await this.get<T>(key));\r\n                }\r\n            }\r\n\r\n            return result;\r\n        },\r\n\r\n        async setMany<T>(entries: Map<string, T>, opts?: CacheOptions): Promise<void> {\r\n            const ttl = opts?.ttl ?? defaultTTL;\r\n            const now = Date.now();\r\n\r\n            const cacheEntries = new Map<string, CacheEntry<T>>();\r\n\r\n            for (const [key, value] of entries) {\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                cacheEntries.set(fullKey, entry);\r\n                await registerTags(fullKey, opts?.tags);\r\n            }\r\n\r\n            if (adapter.setMany) {\r\n                await adapter.setMany(cacheEntries);\r\n            } else {\r\n                for (const [key, entry] of cacheEntries) {\r\n                    await adapter.set(key, entry);\r\n                }\r\n            }\r\n\r\n            if (trackStats) stats.sets += entries.size;\r\n        },\r\n\r\n        getStats() {\r\n            return trackStats ? { ...stats } : undefined;\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\n * @example\r\n * ```typescript\r\n * cacheKey('user', userId, 'profile'); // \"user:123:profile\"\r\n * ```\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\n * @example\r\n * ```typescript\r\n * const getCachedUser = cached(cache, getUser, {\r\n *     ttl: 300,\r\n *     keyFn: (userId) => `user:${userId}`,\r\n * });\r\n * \r\n * const user = await getCachedUser(123);\r\n * ```\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\r\n/**\r\n * Create a deduplication wrapper to prevent duplicate concurrent requests\r\n * \r\n * @example\r\n * ```typescript\r\n * const dedupedFetch = dedupe(fetchUser);\r\n * \r\n * // These will share the same request\r\n * const [user1, user2] = await Promise.all([\r\n *     dedupedFetch(123),\r\n *     dedupedFetch(123),\r\n * ]);\r\n * ```\r\n */\r\nexport function dedupe<T extends (...args: unknown[]) => Promise<unknown>>(\r\n    fn: T,\r\n    keyFn: (...args: Parameters<T>) => string = (...args) => JSON.stringify(args)\r\n): T {\r\n    const pending = new Map<string, Promise<unknown>>();\r\n\r\n    return (async (...args: Parameters<T>) => {\r\n        const key = keyFn(...args);\r\n\r\n        if (pending.has(key)) {\r\n            return pending.get(key);\r\n        }\r\n\r\n        const promise = fn(...args).finally(() => {\r\n            pending.delete(key);\r\n        });\r\n\r\n        pending.set(key, promise);\r\n        return promise;\r\n    }) as T;\r\n}\r\n"]}

package/dist/client.d.ts

@@ -0,0 +1,25 @@
+export { FlightConfig, FlightUserConfig } from './config/index.js';
+export { Route, RouteMatch, RouteParams, Router, createRouter } from './router/index.js';
+export { Cache, CacheAdapter, CacheEntry, CacheOptions, CacheStats, CreateCacheOptions, Serializer, cacheKey, cached, createCache, dedupe, jsonSerializer, memory } from './cache/index.js';
+export { Middleware, MiddlewareContext, MiddlewareNext, createMiddlewareChain } from './middleware/index.js';
+export { CustomHydrationTrigger, HydrateOptions, HydrationTrigger, IslandConfig, hydrateIslands, registerFlightIslandElement } from './islands/index.js';
+export { BuiltInCondition, DEFAULT_BOT_PATTERNS, StreamingCondition, isBot, isSlowConnection, prefersNoStream, supportsStreaming } from './streaming/conditional.js';
+export { BadRequestError, ErrorBoundaryOptions, FlightError, FlightErrorOptions, FlightErrorProps, ForbiddenError, InternalError, NotFoundError, ResetDetails, UnauthorizedError, clearError, createError, getError, getErrorStatusCode, isFlightError, isForbiddenError as isForbidden, isNotFoundError as isNotFound, isUnauthorizedError as isUnauthorized, showError } from './errors/index.js';
+export { getEnvironment, isBrowser, isDevelopment, isProduction, isServer, isTest } from './utils/index.js';
+import './render/index.js';
+import './adapters/index.js';
+
+/**
+ * Flight Framework - Core (Browser-Safe Exports)
+ *
+ * This entry point only exports modules that are safe to use in browser environments.
+ * Use this import when building for the client:
+ *
+ *   import { ... } from '@flightdev/core/client';
+ *
+ * Server-only modules (file-router, prerender, etc.) are NOT included.
+ */
+
+declare const VERSION = "0.0.1";
+
+export { VERSION };

package/dist/client.js

@@ -0,0 +1,16 @@
+export { DEFAULT_BOT_PATTERNS, isBot, isSlowConnection, prefersNoStream, supportsStreaming } from './chunk-UVH5XJRP.js';
+export { hydrateIslands, registerFlightIslandElement } from './chunk-IW7FTQQX.js';
+export { createMiddlewareChain } from './chunk-OYF2OAKS.js';
+import './chunk-NCGPUFWV.js';
+export { BadRequestError, FlightError, ForbiddenError, InternalError, NotFoundError, UnauthorizedError, clearError, createError, getError, getErrorStatusCode, isFlightError, isForbiddenError as isForbidden, isNotFoundError as isNotFound, isUnauthorizedError as isUnauthorized, showError } from './chunk-Q7BS5QC5.js';
+import './chunk-PL37KFRJ.js';
+export { getEnvironment, isBrowser, isDevelopment, isProduction, isServer, isTest } from './chunk-LWVETFJV.js';
+export { createRouter } from './chunk-GCQZ4FHI.js';
+export { cacheKey, cached, createCache, dedupe, jsonSerializer, memory } from './chunk-ZZZML7Y3.js';
+
+// src/client.ts
+var VERSION = "0.0.1";
+
+export { VERSION };
+//# sourceMappingURL=client.js.map
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/client.ts"],"names":[],"mappings":";;;;;;;;;;;AAuGO,IAAM,OAAA,GAAU","file":"client.js","sourcesContent":["/**\r\n * Flight Framework - Core (Browser-Safe Exports)\r\n *\r\n * This entry point only exports modules that are safe to use in browser environments.\r\n * Use this import when building for the client:\r\n *\r\n *   import { ... } from '@flightdev/core/client';\r\n *\r\n * Server-only modules (file-router, prerender, etc.) are NOT included.\r\n */\r\n\r\n// Configuration (browser-safe parts only)\r\nexport { type FlightConfig, type FlightUserConfig } from './config/index.js';\r\n\r\n// Router (browser-safe)\r\nexport {\r\n    createRouter,\r\n    type Route,\r\n    type RouteMatch,\r\n    type Router,\r\n    type RouteParams,\r\n} from './router/index.js';\r\n\r\n// Cache (browser-safe)\r\nexport {\r\n    createCache,\r\n    memory,\r\n    cacheKey,\r\n    cached,\r\n    dedupe,\r\n    jsonSerializer,\r\n    type Cache,\r\n    type CacheOptions,\r\n    type CacheEntry,\r\n    type CacheAdapter,\r\n    type CacheStats,\r\n    type Serializer,\r\n    type CreateCacheOptions,\r\n} from './cache/index.js';\r\n\r\n// Middleware (browser-safe)\r\nexport {\r\n    createMiddlewareChain,\r\n    type Middleware,\r\n    type MiddlewareContext,\r\n    type MiddlewareNext,\r\n} from './middleware/index.js';\r\n\r\n// Islands (browser-safe hydration)\r\nexport {\r\n    hydrateIslands,\r\n    registerFlightIslandElement,\r\n    type HydrationTrigger,\r\n    type CustomHydrationTrigger,\r\n    type IslandConfig,\r\n    type HydrateOptions,\r\n} from './islands/index.js';\r\n\r\n// Streaming Conditional (browser-safe detection)\r\nexport {\r\n    isBot,\r\n    prefersNoStream,\r\n    isSlowConnection,\r\n    supportsStreaming,\r\n    DEFAULT_BOT_PATTERNS,\r\n    type StreamingCondition,\r\n    type BuiltInCondition,\r\n} from './streaming/conditional.js';\r\n\r\n// Error Handling (browser-safe)\r\nexport {\r\n    FlightError,\r\n    BadRequestError,\r\n    UnauthorizedError,\r\n    ForbiddenError,\r\n    NotFoundError,\r\n    InternalError,\r\n    createError,\r\n    showError,\r\n    clearError,\r\n    getError,\r\n    isFlightError,\r\n    isNotFoundError as isNotFound,\r\n    isForbiddenError as isForbidden,\r\n    isUnauthorizedError as isUnauthorized,\r\n    getErrorStatusCode,\r\n    type FlightErrorOptions,\r\n    type FlightErrorProps,\r\n    type ResetDetails,\r\n    type ErrorBoundaryOptions,\r\n} from './errors/index.js';\r\n\r\n// Environment Utilities (browser-safe)\r\nexport {\r\n    isProduction,\r\n    isDevelopment,\r\n    isTest,\r\n    isServer,\r\n    isBrowser,\r\n    getEnvironment,\r\n} from './utils/index.js';\r\n\r\n// Version\r\nexport const VERSION = '0.0.1';\r\n"]}

package/dist/config/index.d.ts

@@ -0,0 +1,170 @@
+import { RenderMode } from '../render/index.js';
+import { FlightAdapter } from '../adapters/index.js';
+
+/**
+ * Flight Configuration - User configuration system
+ */
+
+/**
+ * Bundler adapter interface.
+ * Import the full type from @flightdev/bundler for implementation.
+ */
+interface BundlerAdapter {
+    /** Adapter identifier */
+    name: string;
+    /** Bundler name (vite, esbuild, rolldown, etc.) */
+    bundler: string;
+    /** Bundler-specific options */
+    options?: Record<string, unknown>;
+    /** Create dev server */
+    createDevServer(config: FlightConfig): Promise<unknown>;
+    /** Build for production */
+    build(config: FlightConfig): Promise<unknown>;
+}
+/** UI Framework configuration */
+interface UIConfig {
+    /** The UI framework to use */
+    framework?: 'react' | 'vue' | 'svelte' | 'solid' | 'preact' | 'vanilla' | string;
+    /** Framework-specific options */
+    options?: Record<string, unknown>;
+}
+/** Rendering configuration */
+interface RenderConfig {
+    /** Default render mode */
+    default?: RenderMode;
+    /** Per-route render mode overrides */
+    routes?: Record<string, RenderMode>;
+}
+/** Development server options */
+interface DevConfig {
+    /** Port to run dev server on */
+    port?: number;
+    /** Host to bind to */
+    host?: string | boolean;
+    /** Open browser on start */
+    open?: boolean;
+    /** HTTPS configuration */
+    https?: boolean | {
+        key?: string;
+        cert?: string;
+    };
+    /** Proxy configuration */
+    proxy?: Record<string, string | {
+        target: string;
+        changeOrigin?: boolean;
+        rewrite?: (path: string) => string;
+    }>;
+}
+/** Build configuration */
+interface BuildConfig {
+    /** Output directory */
+    outDir?: string;
+    /** Source directory */
+    srcDir?: string;
+    /** Public assets directory */
+    publicDir?: string;
+    /** Routes directory */
+    routesDir?: string;
+    /** Generate sourcemaps */
+    sourcemap?: boolean | 'inline' | 'hidden';
+    /** Minify output */
+    minify?: boolean | 'terser' | 'esbuild';
+    /** Target environments */
+    target?: string | string[];
+}
+/** Full Flight configuration (resolved) */
+interface FlightConfig {
+    /** Root directory */
+    root: string;
+    /** Deployment adapter */
+    adapter: FlightAdapter | null;
+    /** Bundler adapter (Vite, esbuild, Rolldown, etc.) */
+    bundler: BundlerAdapter | null;
+    /** UI framework configuration */
+    ui: UIConfig;
+    /** Rendering configuration */
+    rendering: RenderConfig;
+    /** Development server options */
+    dev: Required<DevConfig>;
+    /** Build configuration */
+    build: Required<BuildConfig>;
+    /** Bundler-specific configuration (passed to adapter) */
+    bundlerOptions?: Record<string, unknown>;
+    /** @deprecated Use bundler adapter instead */
+    vite?: Record<string, unknown>;
+    /** Plugin configurations */
+    plugins: FlightPlugin[];
+}
+/** Flight plugin interface */
+interface FlightPlugin {
+    /** Plugin name */
+    name: string;
+    /** Hook into config resolution */
+    config?: (config: FlightConfig) => FlightConfig | void | Promise<FlightConfig | void>;
+    /** Hook into build start */
+    buildStart?: () => void | Promise<void>;
+    /** Hook into build end */
+    buildEnd?: () => void | Promise<void>;
+    /** Hook into dev server start */
+    devStart?: () => void | Promise<void>;
+}
+/** User-provided configuration (partial) */
+interface FlightUserConfig {
+    /** Root directory (defaults to process.cwd()) */
+    root?: string;
+    /** Deployment adapter */
+    adapter?: FlightAdapter;
+    /** Bundler adapter (Vite, esbuild, Rolldown, etc.) */
+    bundler?: BundlerAdapter;
+    /** UI framework configuration */
+    ui?: UIConfig;
+    /** Rendering configuration */
+    rendering?: RenderConfig;
+    /** Development server options */
+    dev?: DevConfig;
+    /** Build configuration */
+    build?: BuildConfig;
+    /** Bundler-specific configuration */
+    bundlerOptions?: Record<string, unknown>;
+    /** @deprecated Use bundler adapter instead */
+    vite?: Record<string, unknown>;
+    /** Plugins */
+    plugins?: FlightPlugin[];
+}
+/**
+ * Define Flight configuration
+ *
+ * @example
+ * ```typescript
+ * // flight.config.ts
+ * import { defineConfig } from '@flightdev/core';
+ * import node from '@flightdev/adapter-node';
+ *
+ * export default defineConfig({
+ *   adapter: node(),
+ *   ui: { framework: 'react' },
+ *   rendering: {
+ *     default: 'ssr',
+ *     routes: {
+ *       '/blog/*': 'ssg',
+ *       '/app/*': 'csr',
+ *     },
+ *   },
+ * });
+ * ```
+ */
+declare function defineConfig(config: FlightUserConfig): FlightUserConfig;
+/**
+ * Resolve user config to full config with defaults
+ */
+declare function resolveConfig(userConfig?: FlightUserConfig): FlightConfig;
+/**
+ * Find the config file in a directory
+ */
+declare function findConfigFile(root: string): Promise<string | null>;
+/**
+ * Load configuration from file
+ */
+declare function loadConfig(root?: string): Promise<FlightConfig>;
+
+export { type BuildConfig, type BundlerAdapter, type DevConfig, type FlightConfig, type FlightPlugin, type FlightUserConfig, type RenderConfig, type UIConfig, defineConfig, findConfigFile, loadConfig, resolveConfig };

package/dist/config/index.js

@@ -0,0 +1,3 @@
+export { defineConfig, findConfigFile, loadConfig, resolveConfig } from '../chunk-NCGPUFWV.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/config/index.js.map

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