@frontmcp/ui 0.5.1 → 0.6.1

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 '@frontmcp/uipack/dependency';
+/**
+ * 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,6BAA6B,CAAC;AAEtF;;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"}

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 '@frontmcp/uipack/dependency';
+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,43 @@
+/**
+ * In-Memory Bundler Module
+ *
+ * Provides fast, secure bundling for JSX/TSX/MDX sources.
+ * Used for building widget templates at both build-time and runtime.
+ *
+ * Features:
+ * - esbuild-based transformation (fallback to SWC)
+ * - Content-addressable caching
+ * - Security validation and sandboxing
+ * - SSR support for React components
+ *
+ * @example
+ * ```typescript
+ * import { createBundler } from '@frontmcp/ui/bundler';
+ *
+ * const bundler = createBundler();
+ *
+ * // Bundle JSX source
+ * const result = await bundler.bundle({
+ *   source: 'const App = () => <div>Hello</div>; export default App;',
+ *   sourceType: 'jsx',
+ * });
+ *
+ * // SSR rendering
+ * const ssrResult = await bundler.bundleSSR({
+ *   source: 'export default ({ data }) => <div>{data.message}</div>',
+ *   context: { data: { message: 'Hello' } },
+ * });
+ * ```
+ *
+ * @packageDocumentation
+ */
+export { InMemoryBundler, createBundler, SecurityError, ExecutionError } from './bundler';
+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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAMH,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAM1F,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"}