@flight-framework/core 0.2.1 → 0.2.3

package/dist/cache/index.d.ts

@@ -2,7 +2,21 @@
  * Flight Cache - Agnostic caching primitives
  *
  * Flight provides the interface, you choose the implementation.
- * Use in-memory, Redis, Cloudflare KV, or anything else.
+ * Use in-memory, Redis, Cloudflare KV, Upstash, or anything else.
+ *
+ * @example
+ * ```typescript
+ * import { createCache } from '@flight-framework/core';
+ * import { redis } from '@flight-framework/cache-redis';
+ *
+ * const cache = createCache({
+ *     adapter: redis({ url: process.env.REDIS_URL }),
+ *     defaultTTL: 3600,
+ * });
+ *
+ * await cache.set('user:1', userData, { tags: ['users'] });
+ * await cache.invalidateTag('users');
+ * ```
  */
 interface CacheOptions {
     /** Time-to-live in seconds */
@@ -37,40 +51,141 @@ interface Cache {
     clear(): Promise<void>;
     /** Invalidate entries by tag */
     invalidateTag(tag: string): Promise<void>;
+    /** Invalidate entries by multiple tags */
+    invalidateTags(tags: string[]): Promise<void>;
     /** Get or set with a factory function */
     getOrSet<T>(key: string, factory: () => Promise<T>, options?: CacheOptions): Promise<T>;
+    /** Get multiple values at once */
+    getMany<T>(keys: string[]): Promise<Map<string, T | undefined>>;
+    /** Set multiple values at once */
+    setMany<T>(entries: Map<string, T>, options?: CacheOptions): Promise<void>;
+    /** Get cache statistics (if tracking enabled) */
+    getStats?(): CacheStats | undefined;
+}
+interface CacheStats {
+    hits: number;
+    misses: number;
+    sets: number;
+    deletes: number;
 }
 /** Adapter interface for external cache providers */
 interface CacheAdapter {
-    name: string;
+    /** Adapter name for identification */
+    readonly name: string;
+    /** Get an entry from cache */
     get<T>(key: string): Promise<CacheEntry<T> | undefined>;
+    /** Set an entry in cache */
     set<T>(key: string, entry: CacheEntry<T>): Promise<void>;
+    /** Delete an entry from cache */
     delete(key: string): Promise<boolean>;
+    /** Check if key exists */
     has(key: string): Promise<boolean>;
+    /** Clear all entries */
     clear(): Promise<void>;
+    /** Get keys matching pattern (optional) */
     keys?(pattern?: string): Promise<string[]>;
+    /** Get multiple entries at once (optional, for performance) */
+    getMany?<T>(keys: string[]): Promise<Map<string, CacheEntry<T> | undefined>>;
+    /** Set multiple entries at once (optional, for performance) */
+    setMany?<T>(entries: Map<string, CacheEntry<T>>): Promise<void>;
+    /** Whether this adapter supports distributed tags natively */
+    readonly supportsDistributedTags?: boolean;
+    /** Add a key to a tag set (for distributed tag management) */
+    addToTag?(tag: string, key: string): Promise<void>;
+    /** Get all keys associated with a tag */
+    getTagMembers?(tag: string): Promise<string[]>;
+    /** Delete a tag and return its members */
+    deleteTag?(tag: string): Promise<string[]>;
+    /** Close connection (for cleanup) */
+    close?(): Promise<void>;
+    /** Check if adapter is healthy */
+    ping?(): Promise<boolean>;
+}
+interface Serializer {
+    serialize(value: unknown): string;
+    deserialize<T>(data: string): T;
 }
+/** Default JSON serializer */
+declare const jsonSerializer: Serializer;
+interface MemoryCacheAdapterOptions {
+    /** Maximum number of entries (0 = unlimited) */
+    maxSize?: number;
+    /** Cleanup interval in ms (default: 60000) */
+    cleanupInterval?: number;
+}
+/**
+ * Create in-memory cache adapter
+ */
+declare function memory(options?: MemoryCacheAdapterOptions): CacheAdapter;
 interface CreateCacheOptions {
     /** Custom cache adapter (defaults to in-memory) */
     adapter?: CacheAdapter;
-    /** Default TTL for all entries */
+    /** Default TTL for all entries (seconds) */
     defaultTTL?: number;
     /** Key prefix for namespacing */
     prefix?: string;
+    /** Custom serializer (for external adapters) */
+    serializer?: Serializer;
+    /** Track cache statistics */
+    trackStats?: boolean;
 }
 /**
  * Create a new cache instance
+ *
+ * @example
+ * ```typescript
+ * // Simple in-memory cache
+ * const cache = createCache();
+ *
+ * // With Redis adapter
+ * import { redis } from '@flight-framework/cache-redis';
+ * const cache = createCache({
+ *     adapter: redis({ url: 'redis://localhost:6379' }),
+ *     defaultTTL: 3600,
+ *     prefix: 'myapp',
+ * });
+ * ```
  */
 declare function createCache(options?: CreateCacheOptions): Cache;
 /**
  * Create a cache key from multiple parts
+ *
+ * @example
+ * ```typescript
+ * cacheKey('user', userId, 'profile'); // "user:123:profile"
+ * ```
  */
 declare function cacheKey(...parts: (string | number | boolean | undefined)[]): string;
 /**
  * Wrap a function with caching
+ *
+ * @example
+ * ```typescript
+ * const getCachedUser = cached(cache, getUser, {
+ *     ttl: 300,
+ *     keyFn: (userId) => `user:${userId}`,
+ * });
+ *
+ * const user = await getCachedUser(123);
+ * ```
  */
 declare function cached<T extends (...args: unknown[]) => Promise<unknown>>(cache: Cache, fn: T, options?: CacheOptions & {
     keyFn?: (...args: Parameters<T>) => string;
 }): T;
+/**
+ * Create a deduplication wrapper to prevent duplicate concurrent requests
+ *
+ * @example
+ * ```typescript
+ * const dedupedFetch = dedupe(fetchUser);
+ *
+ * // These will share the same request
+ * const [user1, user2] = await Promise.all([
+ *     dedupedFetch(123),
+ *     dedupedFetch(123),
+ * ]);
+ * ```
+ */
+declare function dedupe<T extends (...args: unknown[]) => Promise<unknown>>(fn: T, keyFn?: (...args: Parameters<T>) => string): T;
 
-export { type Cache, type CacheAdapter, type CacheEntry, type CacheOptions, type CreateCacheOptions, cacheKey, cached, createCache };
+export { type Cache, type CacheAdapter, type CacheEntry, type CacheOptions, type CacheStats, type CreateCacheOptions, type MemoryCacheAdapterOptions, type Serializer, cacheKey, cached, createCache, dedupe, jsonSerializer, memory };

package/dist/cache/index.js

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

package/dist/{chunk-N3TUOEV4.js → chunk-2F2QU6RC.js}

@@ -112,6 +112,18 @@ function createVueAdapter(deps) {
       if (comp.$$typeof === CLIENT_REFERENCE) return true;
       return false;
     },
+    createElement(component, props) {
+      if (Vue?.h) {
+        return Vue.h(component, props);
+      }
+      return {
+        __v_isVNode: true,
+        type: component,
+        props,
+        key: null,
+        children: props.children ?? null
+      };
+    },
     async renderToString(element) {
       if (renderToString && Vue?.createSSRApp) {
         const app = Vue.createSSRApp({
@@ -209,5 +221,5 @@ function markAsVueClientComponent(component, moduleId, exportName = "default") {
 }
 
 export { createVueAdapter, createVueConsumer, markAsVueClientComponent };
-//# sourceMappingURL=chunk-N3TUOEV4.js.map
-//# sourceMappingURL=chunk-N3TUOEV4.js.map
+//# sourceMappingURL=chunk-2F2QU6RC.js.map
+//# sourceMappingURL=chunk-2F2QU6RC.js.map

package/dist/chunk-2F2QU6RC.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/rsc/adapters/vue.ts"],"names":["children"],"mappings":"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","file":"chunk-2F2QU6RC.js","sourcesContent":["/**\r\n * @flight-framework/core - Vue UI Adapter\r\n * \r\n * Adapter for using Vue 3 with Flight Server Components.\r\n * Enables Flight to render Vue components without tight coupling.\r\n * \r\n * Philosophy: Zero lock-in - Vue is optional, user decides.\r\n * \r\n * @module @flight-framework/core/rsc/adapters/vue\r\n */\r\n\r\nimport type { UIAdapter, ElementTypeInfo } from '../renderer.js';\r\n\r\n// ============================================================================\r\n// Vue Symbols (Vue 3 internal markers)\r\n// ============================================================================\r\n\r\nconst VUE_FRAGMENT = Symbol.for('v-fgt');\r\nconst VUE_TEXT = Symbol.for('v-txt');\r\nconst VUE_COMMENT = Symbol.for('v-cmt');\r\nconst VUE_SUSPENSE = Symbol.for('v-sus');\r\nconst VUE_TELEPORT = Symbol.for('v-tel');\r\n\r\n// Flight reference symbols\r\nconst CLIENT_REFERENCE = Symbol.for('flight.client.reference');\r\n\r\n// ============================================================================\r\n// Types\r\n// ============================================================================\r\n\r\n/**\r\n * Minimal Vue VNode interface\r\n */\r\ninterface VueVNode {\r\n    __v_isVNode?: boolean;\r\n    type: unknown;\r\n    props: Record<string, unknown> | null;\r\n    children: unknown;\r\n    key: string | number | null;\r\n    component?: unknown;\r\n    shapeFlag?: number;\r\n}\r\n\r\n/**\r\n * Vue dependencies (user provides these)\r\n */\r\nexport interface VueDependencies {\r\n    /** Vue module */\r\n    Vue: {\r\n        h: (type: unknown, props?: unknown, children?: unknown) => VueVNode;\r\n        isVNode: (value: unknown) => boolean;\r\n        createSSRApp?: (rootComponent: unknown) => unknown;\r\n        Fragment?: symbol;\r\n        Suspense?: unknown;\r\n        Text?: symbol;\r\n    };\r\n    /** renderToString from vue/server-renderer (optional - for SSR) */\r\n    renderToString?: (app: unknown) => Promise<string>;\r\n}\r\n\r\n// ============================================================================\r\n// Adapter Implementation\r\n// ============================================================================\r\n\r\n/**\r\n * Create Vue UI Adapter\r\n * \r\n * @example\r\n * ```typescript\r\n * import { createVueAdapter } from '@flight-framework/core/rsc/adapters/vue';\r\n * import * as Vue from 'vue';\r\n * import { renderToString } from 'vue/server-renderer';\r\n * \r\n * const adapter = createVueAdapter({\r\n *   Vue,\r\n *   renderToString,\r\n * });\r\n * \r\n * const renderer = createRenderer(adapter);\r\n * ```\r\n */\r\nexport function createVueAdapter(deps?: VueDependencies): UIAdapter {\r\n    const { Vue, renderToString } = deps || {};\r\n\r\n    return {\r\n        name: 'vue',\r\n\r\n        isElement(value: unknown): boolean {\r\n            if (Vue?.isVNode) {\r\n                return Vue.isVNode(value);\r\n            }\r\n            // Fallback: check for __v_isVNode marker\r\n            return (\r\n                typeof value === 'object' &&\r\n                value !== null &&\r\n                (value as VueVNode).__v_isVNode === true\r\n            );\r\n        },\r\n\r\n        getElementType(element: unknown): ElementTypeInfo {\r\n            const vnode = element as VueVNode;\r\n            const type = vnode.type;\r\n\r\n            // String = host element (div, span, etc.)\r\n            if (typeof type === 'string') {\r\n                return { kind: 'host', tag: type };\r\n            }\r\n\r\n            // Symbol types\r\n            if (typeof type === 'symbol') {\r\n                // Fragment\r\n                if (type === VUE_FRAGMENT || type === Vue?.Fragment) {\r\n                    return { kind: 'fragment' };\r\n                }\r\n\r\n                // Text\r\n                if (type === VUE_TEXT || type === Vue?.Text) {\r\n                    const children = vnode.children;\r\n                    return {\r\n                        kind: 'text',\r\n                        value: String(children ?? '')\r\n                    };\r\n                }\r\n\r\n                // Comment\r\n                if (type === VUE_COMMENT) {\r\n                    return { kind: 'null' };\r\n                }\r\n\r\n                // Suspense\r\n                if (type === VUE_SUSPENSE) {\r\n                    return {\r\n                        kind: 'suspense',\r\n                        fallback: vnode.props?.fallback\r\n                    };\r\n                }\r\n\r\n                // Teleport (treat as fragment for RSC)\r\n                if (type === VUE_TELEPORT) {\r\n                    return { kind: 'fragment' };\r\n                }\r\n\r\n                return { kind: 'null' };\r\n            }\r\n\r\n            // Object component (Options API or async component)\r\n            if (typeof type === 'object' && type !== null) {\r\n                const comp = type as {\r\n                    name?: string;\r\n                    setup?: unknown;\r\n                    render?: unknown;\r\n                    __asyncLoader?: unknown;\r\n                };\r\n\r\n                // Async component\r\n                if (comp.__asyncLoader) {\r\n                    return {\r\n                        kind: 'component',\r\n                        fn: () => null,\r\n                        name: comp.name || 'AsyncComponent'\r\n                    };\r\n                }\r\n\r\n                // Options API component\r\n                if (comp.setup || comp.render) {\r\n                    return {\r\n                        kind: 'component',\r\n                        fn: (_props) => {\r\n                            // Vue components need to be rendered differently\r\n                            // This is a placeholder - actual rendering uses renderToString\r\n                            return null;\r\n                        },\r\n                        name: comp.name || 'VueComponent',\r\n                    };\r\n                }\r\n            }\r\n\r\n            // Function component (Composition API)\r\n            if (typeof type === 'function') {\r\n                const fn = type as ((props: Record<string, unknown>) => unknown) & {\r\n                    displayName?: string;\r\n                    name?: string;\r\n                    __name?: string;\r\n                };\r\n                return {\r\n                    kind: 'component',\r\n                    fn,\r\n                    name: fn.displayName || fn.__name || fn.name || 'Component'\r\n                };\r\n            }\r\n\r\n            return { kind: 'null' };\r\n        },\r\n\r\n        getProps(element: unknown): Record<string, unknown> {\r\n            const vnode = element as VueVNode;\r\n            return vnode.props || {};\r\n        },\r\n\r\n        getChildren(element: unknown): unknown[] {\r\n            const vnode = element as VueVNode;\r\n            const children = vnode.children;\r\n\r\n            if (children === undefined || children === null) {\r\n                return [];\r\n            }\r\n\r\n            // String children\r\n            if (typeof children === 'string' || typeof children === 'number') {\r\n                return [children];\r\n            }\r\n\r\n            // Array children\r\n            if (Array.isArray(children)) {\r\n                return children.flat();\r\n            }\r\n\r\n            // Slots object\r\n            if (typeof children === 'object' && children !== null) {\r\n                const slots = children as Record<string, () => unknown[]>;\r\n                if (typeof slots.default === 'function') {\r\n                    return slots.default();\r\n                }\r\n            }\r\n\r\n            return [children];\r\n        },\r\n\r\n        getKey(element: unknown): string | number | undefined {\r\n            const key = (element as VueVNode).key;\r\n            return key !== null ? key : undefined;\r\n        },\r\n\r\n        isClientBoundary(component: unknown): boolean {\r\n            if (typeof component !== 'function' && typeof component !== 'object') {\r\n                return false;\r\n            }\r\n\r\n            const comp = component as {\r\n                $$typeof?: symbol;\r\n                __flight_client?: boolean;\r\n            };\r\n\r\n            // Check for Flight client marker\r\n            if (comp.__flight_client === true) return true;\r\n\r\n            // Check for client reference symbol\r\n            if (comp.$$typeof === CLIENT_REFERENCE) return true;\r\n\r\n            return false;\r\n        },\r\n\r\n        createElement(\r\n            component: (props: Record<string, unknown>) => unknown,\r\n            props: Record<string, unknown>\r\n        ): unknown {\r\n            // Create a Vue VNode using h() if available\r\n            if (Vue?.h) {\r\n                return Vue.h(component, props);\r\n            }\r\n\r\n            // Fallback: create VNode structure directly\r\n            return {\r\n                __v_isVNode: true,\r\n                type: component,\r\n                props,\r\n                key: null,\r\n                children: props.children ?? null,\r\n            } as VueVNode;\r\n        },\r\n\r\n        async renderToString(element: unknown): Promise<string> {\r\n            if (renderToString && Vue?.createSSRApp) {\r\n                // Create SSR app wrapper\r\n                const app = Vue.createSSRApp({\r\n                    render: () => element\r\n                });\r\n                return renderToString(app);\r\n            }\r\n            throw new Error(\r\n                'renderToString not provided. Pass Vue and renderToString when creating the adapter: ' +\r\n                'createVueAdapter({ Vue, renderToString })'\r\n            );\r\n        },\r\n    };\r\n}\r\n\r\n// ============================================================================\r\n// Vue Client Consumer\r\n// ============================================================================\r\n\r\n/**\r\n * Options for Vue consumer\r\n */\r\nexport interface VueConsumerOptions {\r\n    /** Registry of client components */\r\n    registry?: Map<string, () => Promise<unknown>>;\r\n}\r\n\r\n/**\r\n * Create a Vue client-side consumer for Flight payloads\r\n */\r\nexport function createVueConsumer(deps: VueDependencies, options: VueConsumerOptions = {}) {\r\n    const { Vue } = deps;\r\n    const { registry = new Map() } = options;\r\n\r\n    return {\r\n        /**\r\n         * Register a client component\r\n         */\r\n        register(id: string, loader: () => Promise<unknown>): void {\r\n            registry.set(id, loader);\r\n        },\r\n\r\n        /**\r\n         * Convert Flight elements to Vue VNodes\r\n         */\r\n        toVueElement(element: import('../payload.js').FlightElement): unknown {\r\n            switch (element.$$type) {\r\n                case 'null':\r\n                    return null;\r\n\r\n                case 'text':\r\n                    return element.value;\r\n\r\n                case 'host': {\r\n                    const children = element.children.map(c => this.toVueElement(c));\r\n                    return Vue.h(\r\n                        element.tag,\r\n                        { ...element.props, key: element.key },\r\n                        children\r\n                    );\r\n                }\r\n\r\n                case 'fragment': {\r\n                    const children = element.children.map(c => this.toVueElement(c));\r\n                    return Vue.h(Vue.Fragment!, null, children);\r\n                }\r\n\r\n                case 'suspense': {\r\n                    if (Vue.Suspense) {\r\n                        const fallback = this.toVueElement(element.fallback);\r\n                        const children = element.children.map(c => this.toVueElement(c));\r\n                        return Vue.h(Vue.Suspense, null, {\r\n                            default: () => children,\r\n                            fallback: () => fallback,\r\n                        });\r\n                    }\r\n                    // Fallback: render children directly\r\n                    const children = element.children.map(c => this.toVueElement(c));\r\n                    return Vue.h(Vue.Fragment!, null, children);\r\n                }\r\n\r\n                case 'client': {\r\n                    const loader = registry.get(element.ref);\r\n                    if (!loader) {\r\n                        console.warn(`[Flight] Client component not registered: ${element.ref}`);\r\n                        if (element.ssr) {\r\n                            return Vue.h('div', {\r\n                                innerHTML: element.ssr\r\n                            });\r\n                        }\r\n                        return null;\r\n                    }\r\n\r\n                    // Create async component\r\n                    const AsyncComponent = {\r\n                        async setup() {\r\n                            const mod = await loader() as { default?: unknown };\r\n                            return () => Vue.h(mod.default ?? mod as unknown);\r\n                        }\r\n                    };\r\n\r\n                    return Vue.h(AsyncComponent);\r\n                }\r\n\r\n                case 'lazy': {\r\n                    if (element.fallback) {\r\n                        return this.toVueElement(element.fallback);\r\n                    }\r\n                    return Vue.h('div', { 'data-flight-pending': element.id });\r\n                }\r\n\r\n                default:\r\n                    return null;\r\n            }\r\n        },\r\n    };\r\n}\r\n\r\n// ============================================================================\r\n// Utility Types\r\n// ============================================================================\r\n\r\n/**\r\n * Type helper for Vue Server Component\r\n */\r\nexport type VueServerComponent<P = Record<string, unknown>> = (\r\n    props: P,\r\n    ctx: import('../context.js').ServerContext\r\n) => Promise<VueVNode> | VueVNode;\r\n\r\n/**\r\n * Mark a Vue component as a client component\r\n */\r\nexport function markAsVueClientComponent<T extends object>(\r\n    component: T,\r\n    moduleId: string,\r\n    exportName = 'default'\r\n): T {\r\n    const marked = component as T & {\r\n        $$typeof: symbol;\r\n        __flight_client: boolean;\r\n        __flight_module: string;\r\n        __flight_export: string;\r\n    };\r\n\r\n    marked.$$typeof = CLIENT_REFERENCE;\r\n    marked.__flight_client = true;\r\n    marked.__flight_module = moduleId;\r\n    marked.__flight_export = exportName;\r\n\r\n    return marked;\r\n}\r\n"]}