@frontmcp/uipack 0.6.1

package/bundler/file-cache/component-builder.d.ts

@@ -0,0 +1,167 @@
+/**
+ * Component Builder
+ *
+ * Builds file-based UI components with caching and CDN dependency resolution.
+ * Handles the complete build pipeline from source to cached manifest.
+ *
+ * @packageDocumentation
+ */
+import type { ComponentBuildManifest, FileBundleOptions, CDNDependency, CDNPlatformType } from '../../dependency/types';
+import type { BuildCacheStorage } from './storage/interface';
+/**
+ * Options for building a component.
+ */
+export interface ComponentBuildOptions {
+    /**
+     * Entry file path.
+     */
+    entryPath: string;
+    /**
+     * Tool name for the component.
+     */
+    toolName: string;
+    /**
+     * Packages to load from CDN.
+     */
+    externals?: string[];
+    /**
+     * Explicit CDN dependency overrides.
+     */
+    dependencies?: Record<string, CDNDependency>;
+    /**
+     * Bundle options.
+     */
+    bundleOptions?: FileBundleOptions;
+    /**
+     * Target platform for CDN selection.
+     * @default 'unknown'
+     */
+    platform?: CDNPlatformType;
+    /**
+     * Whether to skip cache lookup.
+     * @default false
+     */
+    skipCache?: boolean;
+    /**
+     * Whether to perform SSR.
+     * @default false
+     */
+    ssr?: boolean;
+    /**
+     * SSR context data.
+     */
+    ssrContext?: Record<string, unknown>;
+    /**
+     * Custom code execution function for SSR.
+     * Allows different strategies for Node.js vs browser environments.
+     * If not provided, uses `new Function()` which works in both environments.
+     *
+     * @example
+     * ```typescript
+     * // Custom execution with vm module
+     * import { createContext, runInContext } from 'vm';
+     *
+     * const options = {
+     *   executeCode: (code, exports, module, React) => {
+     *     const context = createContext({ exports, module, React });
+     *     runInContext(code, context);
+     *   }
+     * };
+     * ```
+     */
+    executeCode?: (code: string, exports: Record<string, unknown>, module: {
+        exports: Record<string, unknown>;
+    }, React: unknown) => void;
+}
+/**
+ * Result of a build operation.
+ */
+export interface ComponentBuildResult {
+    /**
+     * The build manifest.
+     */
+    manifest: ComponentBuildManifest;
+    /**
+     * Whether the result came from cache.
+     */
+    cached: boolean;
+    /**
+     * Build time in milliseconds.
+     */
+    buildTimeMs: number;
+}
+/**
+ * Component builder for file-based UI templates.
+ *
+ * Handles the complete build pipeline:
+ * 1. Check cache for existing build
+ * 2. Parse entry file for imports
+ * 3. Resolve external dependencies to CDN URLs
+ * 4. Bundle the component with esbuild
+ * 5. Generate import map for CDN dependencies
+ * 6. Store result in cache
+ *
+ * @example
+ * ```typescript
+ * const storage = new FilesystemStorage({ cacheDir: '.cache' });
+ * await storage.initialize();
+ *
+ * const builder = new ComponentBuilder(storage);
+ *
+ * const result = await builder.build({
+ *   entryPath: './widgets/chart.tsx',
+ *   toolName: 'chart_display',
+ *   externals: ['chart.js', 'react'],
+ *   platform: 'claude',
+ * });
+ *
+ * console.log(result.manifest.outputs.code);
+ * console.log(result.manifest.importMap);
+ * ```
+ */
+export declare class ComponentBuilder {
+    private readonly storage;
+    private esbuild;
+    constructor(storage: BuildCacheStorage);
+    /**
+     * Build a component from a file path.
+     */
+    build(options: ComponentBuildOptions): Promise<ComponentBuildResult>;
+    /**
+     * Build multiple components.
+     */
+    buildMany(options: ComponentBuildOptions[]): Promise<ComponentBuildResult[]>;
+    /**
+     * Check if a component needs rebuilding.
+     */
+    needsRebuild(options: Pick<ComponentBuildOptions, 'entryPath' | 'externals' | 'dependencies' | 'bundleOptions'>): Promise<boolean>;
+    /**
+     * Get a cached build if it exists.
+     */
+    getCached(options: Pick<ComponentBuildOptions, 'entryPath' | 'externals' | 'dependencies' | 'bundleOptions'>): Promise<ComponentBuildManifest | undefined>;
+    /**
+     * Invalidate a cached build.
+     */
+    invalidate(contentHash: string): Promise<boolean>;
+    /**
+     * Generate complete HTML for a built component.
+     */
+    generateHTML(manifest: ComponentBuildManifest, minify?: boolean): string;
+    /**
+     * Bundle a component using esbuild.
+     */
+    private bundleComponent;
+    /**
+     * Perform server-side rendering.
+     */
+    private renderSSR;
+}
+/**
+ * Create a component builder with filesystem storage.
+ */
+export declare function createFilesystemBuilder(cacheDir?: string): Promise<ComponentBuilder>;
+/**
+ * Create a component builder with Redis storage.
+ */
+export declare function createRedisBuilder(redisClient: import('./storage/redis.js').RedisClient, keyPrefix?: string): Promise<ComponentBuilder>;
+//# sourceMappingURL=component-builder.d.ts.map

package/bundler/file-cache/component-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-builder.d.ts","sourceRoot":"","sources":["../../../src/bundler/file-cache/component-builder.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,OAAO,KAAK,EACV,sBAAsB,EACtB,iBAAiB,EACjB,aAAa,EACb,eAAe,EAGhB,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAS7D;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IAErB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAE7C;;OAEG;IACH,aAAa,CAAC,EAAE,iBAAiB,CAAC;IAElC;;;OAGG;IACH,QAAQ,CAAC,EAAE,eAAe,CAAC;IAE3B;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;;OAGG;IACH,GAAG,CAAC,EAAE,OAAO,CAAC;IAEd;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAErC;;;;;;;;;;;;;;;;;OAiBG;IACH,WAAW,CAAC,EAAE,CACZ,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,EAC5C,KAAK,EAAE,OAAO,KACX,IAAI,CAAC;CACX;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,QAAQ,EAAE,sBAAsB,CAAC;IAEjC;;OAEG;IACH,MAAM,EAAE,OAAO,CAAC;IAEhB;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;CACrB;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoB;IAC5C,OAAO,CAAC,OAAO,CAAyC;gBAE5C,OAAO,EAAE,iBAAiB;IAItC;;OAEG;IACG,KAAK,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAyI1E;;OAEG;IACG,SAAS,CAAC,OAAO,EAAE,qBAAqB,EAAE,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC;IAIlF;;OAEG;IACG,YAAY,CAChB,OAAO,EAAE,IAAI,CAAC,qBAAqB,EAAE,WAAW,GAAG,WAAW,GAAG,cAAc,GAAG,eAAe,CAAC,GACjG,OAAO,CAAC,OAAO,CAAC;IAcnB;;OAEG;IACG,SAAS,CACb,OAAO,EAAE,IAAI,CAAC,qBAAqB,EAAE,WAAW,GAAG,WAAW,GAAG,cAAc,GAAG,eAAe,CAAC,GACjG,OAAO,CAAC,sBAAsB,GAAG,SAAS,CAAC;IAa9C;;OAEG;IACG,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIvD;;OAEG;IACH,YAAY,CAAC,QAAQ,EAAE,sBAAsB,EAAE,MAAM,UAAQ,GAAG,MAAM;IAatE;;OAEG;YACW,eAAe;IA4C7B;;OAEG;YACW,SAAS;CAuDxB;AAMD;;GAEG;AACH,wBAAsB,uBAAuB,CAAC,QAAQ,SAA2B,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAK5G;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,WAAW,EAAE,OAAO,oBAAoB,EAAE,WAAW,EACrD,SAAS,SAAuB,GAC/B,OAAO,CAAC,gBAAgB,CAAC,CAQ3B"}

package/bundler/file-cache/hash-calculator.d.ts

@@ -0,0 +1,155 @@
+/**
+ * Hash Calculator
+ *
+ * SHA-256 based hash calculation for cache keys.
+ * Combines file contents, dependencies, and build options
+ * to create deterministic cache keys for incremental builds.
+ *
+ * @packageDocumentation
+ */
+import type { FileBundleOptions, CDNDependency } from '../../dependency/types';
+/**
+ * Calculate SHA-256 hash of a string.
+ *
+ * @param content - Content to hash
+ * @returns Hex-encoded SHA-256 hash
+ */
+export declare function sha256(content: string): string;
+/**
+ * Calculate SHA-256 hash of a buffer.
+ *
+ * @param buffer - Buffer to hash
+ * @returns Hex-encoded SHA-256 hash
+ */
+export declare function sha256Buffer(buffer: Buffer): string;
+/**
+ * Calculate hash of a file's contents.
+ *
+ * @param filePath - Path to the file
+ * @returns SHA-256 hash or undefined if file doesn't exist
+ */
+export declare function hashFile(filePath: string): Promise<string | undefined>;
+/**
+ * Calculate combined hash of multiple files.
+ *
+ * @param filePaths - Paths to files
+ * @returns Combined SHA-256 hash
+ */
+export declare function hashFiles(filePaths: string[]): Promise<string>;
+/**
+ * Options for calculating a component hash.
+ */
+export interface ComponentHashOptions {
+    /**
+     * Entry file path.
+     */
+    entryPath: string;
+    /**
+     * Base directory for resolving relative imports.
+     * @default dirname(entryPath)
+     */
+    baseDir?: string;
+    /**
+     * External packages (excluded from hash).
+     */
+    externals?: string[];
+    /**
+     * Explicit CDN dependencies.
+     */
+    dependencies?: Record<string, CDNDependency>;
+    /**
+     * Bundle options.
+     */
+    bundleOptions?: FileBundleOptions;
+    /**
+     * Maximum depth for following imports.
+     * @default 10
+     */
+    maxDepth?: number;
+}
+/**
+ * Result of component hash calculation.
+ */
+export interface ComponentHashResult {
+    /**
+     * Combined SHA-256 hash.
+     */
+    hash: string;
+    /**
+     * Entry file hash.
+     */
+    entryHash: string;
+    /**
+     * All files included in the hash.
+     */
+    files: string[];
+    /**
+     * Individual file hashes.
+     */
+    fileHashes: Record<string, string>;
+    /**
+     * Hash of build options.
+     */
+    optionsHash: string;
+    /**
+     * Hash of external dependencies configuration.
+     */
+    dependenciesHash: string;
+}
+/**
+ * Calculate a deterministic hash for a file-based component.
+ *
+ * The hash includes:
+ * - Entry file content
+ * - All local dependencies (relative imports)
+ * - Bundle options
+ * - External dependency configurations
+ *
+ * External npm packages are NOT included in the hash since they're
+ * loaded from CDN and versioned separately.
+ *
+ * @param options - Hash calculation options
+ * @returns Hash result with details
+ *
+ * @example
+ * ```typescript
+ * const result = await calculateComponentHash({
+ *   entryPath: './src/widgets/chart.tsx',
+ *   externals: ['chart.js', 'react'],
+ *   bundleOptions: { minify: true },
+ * });
+ *
+ * console.log(result.hash); // '3a7bd...'
+ * console.log(result.files); // ['./src/widgets/chart.tsx', './src/widgets/utils.ts']
+ * ```
+ */
+export declare function calculateComponentHash(options: ComponentHashOptions): Promise<ComponentHashResult>;
+/**
+ * Calculate a quick hash for cache lookup (entry file only).
+ *
+ * This is faster than full component hash but may miss dependency changes.
+ * Use for quick cache existence checks, then verify with full hash.
+ *
+ * @param entryPath - Entry file path
+ * @param bundleOptions - Bundle options
+ * @returns Quick hash string
+ */
+export declare function calculateQuickHash(entryPath: string, bundleOptions?: FileBundleOptions): Promise<string>;
+/**
+ * Generate a unique build ID.
+ *
+ * Combines timestamp and random component for uniqueness.
+ *
+ * @returns UUID-like build ID
+ */
+export declare function generateBuildId(): string;
+/**
+ * Generate a build ID from a content hash.
+ *
+ * Creates a shorter, more readable ID while maintaining uniqueness.
+ *
+ * @param hash - Content hash
+ * @returns Shortened build ID
+ */
+export declare function buildIdFromHash(hash: string): string;
+//# sourceMappingURL=hash-calculator.d.ts.map

package/bundler/file-cache/hash-calculator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash-calculator.d.ts","sourceRoot":"","sources":["../../../src/bundler/file-cache/hash-calculator.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAOH,OAAO,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAM/E;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE9C;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED;;;;;GAKG;AACH,wBAAsB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAO5E;AAED;;;;;GAKG;AACH,wBAAsB,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAWpE;AAMD;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IAErB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAE7C;;OAEG;IACH,aAAa,CAAC,EAAE,iBAAiB,CAAC;IAElC;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,KAAK,EAAE,MAAM,EAAE,CAAC;IAEhB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEnC;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAsB,sBAAsB,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAmDxG;AAED;;;;;;;;;GASG;AACH,wBAAsB,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC,CAO9G;AA6HD;;;;;;GAMG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAIxC;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGpD"}

package/bundler/file-cache/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * File-Based Component Caching
+ *
+ * SHA-based caching system for file-based UI component builds.
+ * Supports filesystem (development) and Redis (production) storage.
+ *
+ * @packageDocumentation
+ */
+export { type BuildCacheStorage, type StorageOptions, type CacheEntry, type CacheEntryMetadata, DEFAULT_STORAGE_OPTIONS, calculateManifestSize, FilesystemStorage, createFilesystemStorage, type FilesystemStorageOptions, RedisStorage, createRedisStorage, type RedisStorageOptions, type RedisClient, } from './storage';
+export { sha256, sha256Buffer, hashFile, hashFiles, calculateComponentHash, calculateQuickHash, generateBuildId, buildIdFromHash, type ComponentHashOptions, type ComponentHashResult, } from './hash-calculator';
+export { ComponentBuilder, createFilesystemBuilder, createRedisBuilder, type ComponentBuildOptions, type ComponentBuildResult, } from './component-builder';
+//# sourceMappingURL=index.d.ts.map

package/bundler/file-cache/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/bundler/file-cache/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAEL,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACnB,KAAK,UAAU,EACf,KAAK,kBAAkB,EACvB,uBAAuB,EACvB,qBAAqB,EAErB,iBAAiB,EACjB,uBAAuB,EACvB,KAAK,wBAAwB,EAE7B,YAAY,EACZ,kBAAkB,EAClB,KAAK,mBAAmB,EACxB,KAAK,WAAW,GACjB,MAAM,WAAW,CAAC;AAGnB,OAAO,EACL,MAAM,EACN,YAAY,EACZ,QAAQ,EACR,SAAS,EACT,sBAAsB,EACtB,kBAAkB,EAClB,eAAe,EACf,eAAe,EACf,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,GACzB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,gBAAgB,EAChB,uBAAuB,EACvB,kBAAkB,EAClB,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,GAC1B,MAAM,qBAAqB,CAAC"}

package/bundler/file-cache/storage/filesystem.d.ts

@@ -0,0 +1,149 @@
+/**
+ * Filesystem Build Cache Storage
+ *
+ * File-based cache storage for development environments.
+ * Uses LRU eviction and stores manifests as JSON files.
+ *
+ * @packageDocumentation
+ */
+import type { ComponentBuildManifest, CacheStats } from '../../../dependency/types';
+import type { BuildCacheStorage, StorageOptions } from './interface';
+/**
+ * Error thrown when cache storage fails to initialize.
+ */
+export declare class CacheInitializationError extends Error {
+    readonly cause?: unknown;
+    constructor(message: string, cause?: unknown);
+}
+/**
+ * Error thrown when a cache operation fails.
+ */
+export declare class CacheOperationError extends Error {
+    readonly cause?: unknown;
+    constructor(message: string, cause?: unknown);
+}
+/**
+ * Error thrown when storage is accessed before initialization.
+ */
+export declare class StorageNotInitializedError extends Error {
+    constructor();
+}
+/**
+ * Options specific to filesystem storage.
+ */
+export interface FilesystemStorageOptions extends StorageOptions {
+    /**
+     * Base directory for cache files.
+     * @default '.frontmcp-cache/builds'
+     */
+    cacheDir?: string;
+    /**
+     * File extension for cache files.
+     * @default '.json'
+     */
+    extension?: string;
+}
+/**
+ * Filesystem-based build cache storage.
+ *
+ * Stores each build manifest as a JSON file in the cache directory.
+ * Uses LRU eviction based on last access time when size limits are exceeded.
+ *
+ * Directory structure:
+ * ```
+ * .frontmcp-cache/builds/
+ *   ├── {hash1}.json
+ *   ├── {hash2}.json
+ *   └── ...
+ * ```
+ *
+ * @example
+ * ```typescript
+ * const storage = new FilesystemStorage({
+ *   cacheDir: '.cache/ui-builds',
+ *   maxSize: 50 * 1024 * 1024, // 50MB
+ * });
+ *
+ * await storage.initialize();
+ * await storage.set('abc123', manifest);
+ * const cached = await storage.get('abc123');
+ * ```
+ */
+export declare class FilesystemStorage implements BuildCacheStorage {
+    readonly type = "filesystem";
+    private readonly options;
+    private initialized;
+    private stats;
+    constructor(options?: FilesystemStorageOptions);
+    /**
+     * Initialize the storage directory.
+     */
+    initialize(): Promise<void>;
+    /**
+     * Get a cached manifest.
+     */
+    get(key: string): Promise<ComponentBuildManifest | undefined>;
+    /**
+     * Store a manifest in cache.
+     */
+    set(key: string, manifest: ComponentBuildManifest, ttl?: number): Promise<void>;
+    /**
+     * Check if a key exists.
+     */
+    has(key: string): Promise<boolean>;
+    /**
+     * Delete a cached entry.
+     */
+    delete(key: string): Promise<boolean>;
+    /**
+     * Clear all cached entries.
+     */
+    clear(): Promise<void>;
+    /**
+     * Get cache statistics.
+     */
+    getStats(): Promise<CacheStats>;
+    /**
+     * Clean up expired entries.
+     */
+    cleanup(): Promise<number>;
+    /**
+     * Close the storage (no-op for filesystem).
+     */
+    close(): Promise<void>;
+    /**
+     * Get the file path for a cache key.
+     * Uses SHA-256 hash to avoid collisions from key sanitization.
+     */
+    private getFilePath;
+    /**
+     * Write a cache entry to disk.
+     */
+    private writeEntry;
+    /**
+     * Ensure the storage is initialized.
+     */
+    private ensureInitialized;
+    /**
+     * Load stats from existing cache files.
+     * Reads entry metadata to get accurate manifest sizes.
+     */
+    private loadStats;
+    /**
+     * Ensure there's capacity for a new entry.
+     */
+    private ensureCapacity;
+    /**
+     * Evict the least recently used entry.
+     */
+    private evictLRU;
+    /**
+     * Update hit rate statistic.
+     */
+    private updateHitRate;
+}
+/**
+ * Create a filesystem storage instance.
+ */
+export declare function createFilesystemStorage(options?: FilesystemStorageOptions): FilesystemStorage;
+//# sourceMappingURL=filesystem.d.ts.map

package/bundler/file-cache/storage/filesystem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filesystem.d.ts","sourceRoot":"","sources":["../../../../src/bundler/file-cache/storage/filesystem.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,OAAO,KAAK,EAAE,sBAAsB,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACpF,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAc,MAAM,aAAa,CAAC;AAOjF;;GAEG;AACH,qBAAa,wBAAyB,SAAQ,KAAK;IACjD,SAAkB,KAAK,CAAC,EAAE,OAAO,CAAC;gBAEtB,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAK7C;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,SAAkB,KAAK,CAAC,EAAE,OAAO,CAAC;gBAEtB,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAK7C;AAED;;GAEG;AACH,qBAAa,0BAA2B,SAAQ,KAAK;;CAKpD;AAED;;GAEG;AACH,MAAM,WAAW,wBAAyB,SAAQ,cAAc;IAC9D;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAWD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,qBAAa,iBAAkB,YAAW,iBAAiB;IACzD,QAAQ,CAAC,IAAI,gBAAgB;IAE7B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqC;IAC7D,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,KAAK,CAMX;gBAEU,OAAO,GAAE,wBAA6B;IAOlD;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAYjC;;OAEG;IACG,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,GAAG,SAAS,CAAC;IA6CnE;;OAEG;IACG,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,sBAAsB,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA4BrF;;OAEG;IACG,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAuBxC;;OAEG;IACG,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAuB3C;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAmB5B;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,UAAU,CAAC;IAIrC;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC;IAsChC;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B;;;OAGG;IACH,OAAO,CAAC,WAAW;IAMnB;;OAEG;YACW,UAAU;IAKxB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAMzB;;;OAGG;YACW,SAAS;IA4BvB;;OAEG;YACW,cAAc;IAa5B;;OAEG;YACW,QAAQ;IAgDtB;;OAEG;IACH,OAAO,CAAC,aAAa;CAItB;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,CAAC,EAAE,wBAAwB,GAAG,iBAAiB,CAE7F"}

package/bundler/file-cache/storage/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Build Cache Storage
+ *
+ * Storage implementations for component build caching.
+ *
+ * @packageDocumentation
+ */
+export { type BuildCacheStorage, type StorageOptions, type CacheEntry, type CacheEntryMetadata, DEFAULT_STORAGE_OPTIONS, calculateManifestSize, } from './interface';
+export { FilesystemStorage, createFilesystemStorage, type FilesystemStorageOptions } from './filesystem';
+export { RedisStorage, createRedisStorage, type RedisStorageOptions, type RedisClient } from './redis';
+//# sourceMappingURL=index.d.ts.map

package/bundler/file-cache/storage/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/bundler/file-cache/storage/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACnB,KAAK,UAAU,EACf,KAAK,kBAAkB,EACvB,uBAAuB,EACvB,qBAAqB,GACtB,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,KAAK,wBAAwB,EAAE,MAAM,cAAc,CAAC;AAGzG,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,KAAK,mBAAmB,EAAE,KAAK,WAAW,EAAE,MAAM,SAAS,CAAC"}

package/bundler/file-cache/storage/interface.d.ts

@@ -0,0 +1,152 @@
+/**
+ * Build Cache Storage Interface
+ *
+ * Abstract interface for storing and retrieving component build manifests.
+ * Implementations include filesystem (development) and Redis (production).
+ *
+ * @packageDocumentation
+ */
+import type { ComponentBuildManifest, CacheStats } from '../../../dependency/types';
+/**
+ * Options for storage initialization.
+ */
+export interface StorageOptions {
+    /**
+     * Maximum number of entries to store.
+     * @default 1000
+     */
+    maxEntries?: number;
+    /**
+     * Maximum total size in bytes.
+     * @default 104857600 (100MB)
+     */
+    maxSize?: number;
+    /**
+     * Default TTL in seconds.
+     * @default 86400 (24 hours)
+     */
+    defaultTtl?: number;
+    /**
+     * Whether to compress stored data.
+     * @default false
+     */
+    compress?: boolean;
+}
+/**
+ * Abstract interface for build cache storage.
+ *
+ * Implementations should handle:
+ * - Key-value storage of ComponentBuildManifest
+ * - TTL-based expiration
+ * - Size-based eviction
+ * - Concurrent access safety
+ */
+export interface BuildCacheStorage {
+    /**
+     * Storage identifier for logging/debugging.
+     */
+    readonly type: string;
+    /**
+     * Initialize the storage backend.
+     * Must be called before other operations.
+     */
+    initialize(): Promise<void>;
+    /**
+     * Retrieve a cached build manifest by key.
+     *
+     * @param key - Cache key (typically content hash)
+     * @returns Cached manifest or undefined if not found/expired
+     */
+    get(key: string): Promise<ComponentBuildManifest | undefined>;
+    /**
+     * Store a build manifest in cache.
+     *
+     * @param key - Cache key
+     * @param manifest - Build manifest to store
+     * @param ttl - Optional TTL in seconds (overrides default)
+     */
+    set(key: string, manifest: ComponentBuildManifest, ttl?: number): Promise<void>;
+    /**
+     * Check if a key exists in cache (and is not expired).
+     *
+     * @param key - Cache key to check
+     * @returns true if key exists and is valid
+     */
+    has(key: string): Promise<boolean>;
+    /**
+     * Delete a cached entry.
+     *
+     * @param key - Cache key to delete
+     * @returns true if entry was deleted, false if not found
+     */
+    delete(key: string): Promise<boolean>;
+    /**
+     * Clear all cached entries.
+     */
+    clear(): Promise<void>;
+    /**
+     * Get cache statistics.
+     */
+    getStats(): Promise<CacheStats>;
+    /**
+     * Clean up expired entries.
+     * Returns number of entries removed.
+     */
+    cleanup(): Promise<number>;
+    /**
+     * Close the storage connection.
+     * Should be called when the application shuts down.
+     */
+    close(): Promise<void>;
+}
+/**
+ * Metadata for a cached entry.
+ */
+export interface CacheEntryMetadata {
+    /**
+     * Cache key.
+     */
+    key: string;
+    /**
+     * Size of the cached data in bytes.
+     */
+    size: number;
+    /**
+     * Timestamp when entry was created (ms since epoch).
+     */
+    createdAt: number;
+    /**
+     * Timestamp when entry expires (ms since epoch).
+     */
+    expiresAt: number;
+    /**
+     * Last access timestamp (ms since epoch).
+     */
+    lastAccessedAt: number;
+    /**
+     * Number of times the entry has been accessed.
+     */
+    accessCount: number;
+}
+/**
+ * Wrapper around cached data with metadata.
+ */
+export interface CacheEntry<T = ComponentBuildManifest> {
+    /**
+     * The cached data.
+     */
+    data: T;
+    /**
+     * Entry metadata.
+     */
+    metadata: CacheEntryMetadata;
+}
+/**
+ * Default storage options.
+ */
+export declare const DEFAULT_STORAGE_OPTIONS: Required<StorageOptions>;
+/**
+ * Calculate the size of a manifest in bytes.
+ */
+export declare function calculateManifestSize(manifest: ComponentBuildManifest): number;
+//# sourceMappingURL=interface.d.ts.map

package/bundler/file-cache/storage/interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interface.d.ts","sourceRoot":"","sources":["../../../../src/bundler/file-cache/storage/interface.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,sBAAsB,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAEpF;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5B;;;;;OAKG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,GAAG,SAAS,CAAC,CAAC;IAE9D;;;;;;OAMG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,sBAAsB,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEhF;;;;;OAKG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEnC;;;;;OAKG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEtC;;OAEG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvB;;OAEG;IACH,QAAQ,IAAI,OAAO,CAAC,UAAU,CAAC,CAAC;IAEhC;;;OAGG;IACH,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAE3B;;;OAGG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,GAAG,EAAE,MAAM,CAAC;IAEZ;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,cAAc,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU,CAAC,CAAC,GAAG,sBAAsB;IACpD;;OAEG;IACH,IAAI,EAAE,CAAC,CAAC;IAER;;OAEG;IACH,QAAQ,EAAE,kBAAkB,CAAC;CAC9B;AAED;;GAEG;AACH,eAAO,MAAM,uBAAuB,EAAE,QAAQ,CAAC,cAAc,CAK5D,CAAC;AAEF;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,sBAAsB,GAAG,MAAM,CAQ9E"}