@frontmcp/uipack 0.6.1

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

@@ -0,0 +1,139 @@
+/**
+ * Redis Build Cache Storage
+ *
+ * Redis-based cache storage for production environments.
+ * Uses Redis TTL for expiration and optional compression.
+ *
+ * @packageDocumentation
+ */
+import type { ComponentBuildManifest, CacheStats } from '../../../dependency/types';
+import type { BuildCacheStorage, StorageOptions } from './interface';
+/**
+ * Redis client interface (compatible with ioredis and redis packages).
+ */
+export interface RedisClient {
+    get(key: string): Promise<string | null>;
+    set(key: string, value: string, mode?: string, duration?: number): Promise<unknown>;
+    setex(key: string, seconds: number, value: string): Promise<unknown>;
+    del(key: string | string[]): Promise<number>;
+    exists(key: string | string[]): Promise<number>;
+    keys(pattern: string): Promise<string[]>;
+    ttl(key: string): Promise<number>;
+    expire(key: string, seconds: number): Promise<number>;
+    quit(): Promise<unknown>;
+    ping(): Promise<string>;
+}
+/**
+ * Options specific to Redis storage.
+ */
+export interface RedisStorageOptions extends StorageOptions {
+    /**
+     * Redis client instance.
+     * Must be provided.
+     */
+    client: RedisClient;
+    /**
+     * Key prefix for cache entries.
+     * @default 'frontmcp:ui:build:'
+     */
+    keyPrefix?: string;
+    /**
+     * Whether to use JSON.stringify/parse (vs raw storage).
+     * @default true
+     */
+    json?: boolean;
+}
+/**
+ * Redis-based build cache storage.
+ *
+ * Stores build manifests in Redis with automatic TTL expiration.
+ * Suitable for production environments with multiple server instances.
+ *
+ * @example
+ * ```typescript
+ * import Redis from 'ioredis';
+ *
+ * const redis = new Redis(process.env.REDIS_URL);
+ * const storage = new RedisStorage({
+ *   client: redis,
+ *   keyPrefix: 'myapp:builds:',
+ *   defaultTtl: 3600, // 1 hour
+ * });
+ *
+ * await storage.initialize();
+ * await storage.set('abc123', manifest);
+ * ```
+ */
+export declare class RedisStorage implements BuildCacheStorage {
+    readonly type = "redis";
+    private readonly options;
+    private initialized;
+    private localStats;
+    constructor(options: RedisStorageOptions);
+    /**
+     * Initialize the Redis connection.
+     */
+    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.
+     * Redis handles TTL expiration automatically, so this just refreshes stats.
+     */
+    cleanup(): Promise<number>;
+    /**
+     * Close the Redis connection.
+     */
+    close(): Promise<void>;
+    /**
+     * Get the Redis key for a cache key.
+     */
+    private getRedisKey;
+    /**
+     * Get the Redis key for stats.
+     */
+    private getStatsKey;
+    /**
+     * Ensure the storage is initialized.
+     */
+    private ensureInitialized;
+    /**
+     * Load stats from Redis.
+     */
+    private loadStats;
+    /**
+     * Persist stats to Redis.
+     */
+    private persistStats;
+    /**
+     * Update hit rate statistic.
+     */
+    private updateHitRate;
+}
+/**
+ * Create a Redis storage instance.
+ */
+export declare function createRedisStorage(options: RedisStorageOptions): RedisStorage;
+//# sourceMappingURL=redis.d.ts.map

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

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

package/bundler/index.d.ts

@@ -0,0 +1,35 @@
+/**
+ * In-Memory Bundler Module
+ *
+ * Provides caching, security validation, and sandboxing for UI component builds.
+ * Used for building widget templates at both build-time and runtime.
+ *
+ * Features:
+ * - Content-addressable caching
+ * - Security validation and sandboxing
+ * - File-based component caching (filesystem and Redis)
+ *
+ * Note: The main InMemoryBundler with SSR support is in @frontmcp/ui package
+ * as it requires React for server-side rendering.
+ *
+ * @example
+ * ```typescript
+ * import { ComponentBuilder, createFilesystemBuilder } from '@frontmcp/uipack/bundler';
+ *
+ * const builder = createFilesystemBuilder({ cacheDir: '.cache' });
+ * const result = await builder.buildComponent(options);
+ * ```
+ *
+ * @packageDocumentation
+ */
+export { SecurityError } from './sandbox/policy';
+export { ExecutionError } from './sandbox/executor';
+export type { SourceType, OutputFormat, BundleOptions, SSRBundleOptions, BundlerOptions, EsbuildTransformOptions, BundleResult, SSRResult, BundleMetrics, SecurityPolicy, SecurityViolation, CacheEntry, TransformContext, TargetPlatform, StaticHTMLExternalConfig, StaticHTMLOptions, StaticHTMLResult, } from './types';
+export { DEFAULT_SECURITY_POLICY, DEFAULT_BUNDLE_OPTIONS, DEFAULT_BUNDLER_OPTIONS, DEFAULT_STATIC_HTML_OPTIONS, STATIC_HTML_CDN, getCdnTypeForPlatform, } from './types';
+export { BundlerCache, hashContent, createCacheKey } from './cache';
+export type { CacheOptions, CacheStats } from './cache';
+export { validateSource, validateImports, validateSize, mergePolicy, throwOnViolations } from './sandbox/policy';
+export { executeCode, executeDefault, isExecutionError } from './sandbox/executor';
+export type { ExecutionContext, ExecutionResult } from './sandbox/executor';
+export { type BuildCacheStorage, type StorageOptions, type CacheEntry as FileCacheEntry, type CacheEntryMetadata, DEFAULT_STORAGE_OPTIONS, calculateManifestSize, FilesystemStorage, createFilesystemStorage, type FilesystemStorageOptions, RedisStorage, createRedisStorage, type RedisStorageOptions, type RedisClient, sha256, sha256Buffer, hashFile, hashFiles, calculateComponentHash, calculateQuickHash, generateBuildId, buildIdFromHash, type ComponentHashOptions, type ComponentHashResult, ComponentBuilder, createFilesystemBuilder, createRedisBuilder, type ComponentBuildOptions, type ComponentBuildResult, } from './file-cache';
+//# sourceMappingURL=index.d.ts.map

package/bundler/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/bundler/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAQH,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAMpD,YAAY,EAEV,UAAU,EACV,YAAY,EAEZ,aAAa,EACb,gBAAgB,EAChB,cAAc,EACd,uBAAuB,EAEvB,YAAY,EACZ,SAAS,EACT,aAAa,EAEb,cAAc,EACd,iBAAiB,EAEjB,UAAU,EAEV,gBAAgB,EAEhB,cAAc,EACd,wBAAwB,EACxB,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,SAAS,CAAC;AAEjB,OAAO,EAEL,uBAAuB,EACvB,sBAAsB,EACtB,uBAAuB,EAEvB,2BAA2B,EAC3B,eAAe,EACf,qBAAqB,GACtB,MAAM,SAAS,CAAC;AAMjB,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAEpE,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAMxD,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,YAAY,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAMjH,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEnF,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAM5E,OAAO,EAEL,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACnB,KAAK,UAAU,IAAI,cAAc,EACjC,KAAK,kBAAkB,EACvB,uBAAuB,EACvB,qBAAqB,EAErB,iBAAiB,EACjB,uBAAuB,EACvB,KAAK,wBAAwB,EAE7B,YAAY,EACZ,kBAAkB,EAClB,KAAK,mBAAmB,EACxB,KAAK,WAAW,EAEhB,MAAM,EACN,YAAY,EACZ,QAAQ,EACR,SAAS,EACT,sBAAsB,EACtB,kBAAkB,EAClB,eAAe,EACf,eAAe,EACf,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EAExB,gBAAgB,EAChB,uBAAuB,EACvB,kBAAkB,EAClB,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,GAC1B,MAAM,cAAc,CAAC"}