@thewhateverapp/platform 0.13.9 → 0.13.11

package/dist/kv/providers/three-tier-kv.js

@@ -0,0 +1,69 @@
+/**
+ * Three-Tier KV Provider
+ *
+ * Implements the three-tier fallback system:
+ * 1. Production - Real Cloudflare KV binding
+ * 2. Preview via Proxy - HTTP proxy to skeleton worker
+ * 3. Mock/In-Memory - Fallback when skeleton not ready
+ */
+import { CloudflareKV } from './cloudflare-kv';
+import { HTTPProxyKV } from './http-proxy-kv';
+import { MockKV } from '../mock';
+import { ThreeTierProvider } from '../../providers/three-tier-provider';
+/**
+ * Three-Tier KV Provider
+ *
+ * Automatically selects between production, preview proxy, and mock based on availability
+ * and skeleton deployment readiness.
+ */
+export class ThreeTierKV {
+    provider;
+    constructor(config) {
+        const production = config.production ? new CloudflareKV(config.production) : undefined;
+        const previewProxy = config.previewProxy ? new HTTPProxyKV(config.previewProxy) : undefined;
+        const mock = new MockKV({ debug: config.debug });
+        this.provider = new ThreeTierProvider({
+            production,
+            previewProxy,
+            mock,
+            debug: config.debug,
+        });
+    }
+    async get(key) {
+        return this.provider.execute('GET', (kv) => kv.get(key));
+    }
+    async put(key, value, options) {
+        return this.provider.execute('PUT', (kv) => kv.put(key, value, options));
+    }
+    async getJson(key) {
+        return this.provider.execute('GET_JSON', (kv) => kv.getJson(key));
+    }
+    async putJson(key, value, options) {
+        return this.provider.execute('PUT_JSON', (kv) => kv.putJson(key, value, options));
+    }
+    async set(key, value, options) {
+        return this.put(key, value, options);
+    }
+    async delete(key) {
+        return this.provider.execute('DELETE', (kv) => kv.delete(key));
+    }
+    async deleteMany(keys) {
+        return this.provider.execute('DELETE_MANY', (kv) => kv.deleteMany(keys));
+    }
+    async has(key) {
+        return this.provider.execute('HAS', (kv) => kv.has(key));
+    }
+    async list(prefix) {
+        return this.provider.execute('LIST', (kv) => kv.list(prefix));
+    }
+    async getMetadata(key) {
+        return this.provider.execute('GET_METADATA', (kv) => kv.getMetadata(key));
+    }
+    async increment(key, amount = 1) {
+        return this.provider.execute('INCREMENT', (kv) => kv.increment(key, amount));
+    }
+    async decrement(key, amount = 1) {
+        return this.provider.execute('DECREMENT', (kv) => kv.decrement(key, amount));
+    }
+}
+//# sourceMappingURL=three-tier-kv.js.map

package/dist/kv/providers/three-tier-kv.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"three-tier-kv.js","sourceRoot":"","sources":["../../../src/kv/providers/three-tier-kv.ts"],"names":[],"mappings":"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"}

package/dist/providers/three-tier-provider.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Three-Tier Provider System
+ *
+ * Provides a unified fallback chain for platform services:
+ * 1. Production - Real Cloudflare bindings (KV, D1, R2)
+ * 2. Preview via Proxy - HTTP proxy to skeleton worker
+ * 3. Mock/In-Memory - Fallback when skeleton not ready
+ *
+ * This ensures graceful degradation during the first ~60 seconds of tile generation
+ * when the skeleton deployment might return 530 errors or not be ready yet.
+ */
+/**
+ * Provider mode enum
+ */
+export declare enum ProviderMode {
+    Production = "production",
+    PreviewProxy = "preview-proxy",
+    Mock = "mock"
+}
+/**
+ * Check if an error indicates the skeleton deployment isn't ready
+ */
+export declare function isSkeletonNotReadyError(error: unknown): boolean;
+/**
+ * Three-tier provider configuration
+ */
+export interface ThreeTierConfig<TProduction, TProxy, TMock> {
+    /** Production provider (real Cloudflare bindings) */
+    production?: TProduction;
+    /** Preview proxy provider (HTTP to skeleton worker) */
+    previewProxy?: TProxy;
+    /** Mock provider (in-memory fallback) */
+    mock: TMock;
+    /** Debug logging */
+    debug?: boolean;
+}
+/**
+ * Three-tier provider base class
+ *
+ * Implements the three-tier fallback logic:
+ * 1. Use production if available
+ * 2. Use preview proxy if available, fall back to mock on skeleton errors
+ * 3. Use mock as final fallback
+ */
+export declare class ThreeTierProvider<TProvider> {
+    private production?;
+    private previewProxy?;
+    private mock;
+    private debug;
+    private currentMode;
+    private skeletonFailed;
+    private failureCount;
+    private readonly maxFailures;
+    constructor(config: ThreeTierConfig<TProvider, TProvider, TProvider>);
+    private log;
+    /**
+     * Get the appropriate provider based on current mode and fallback logic
+     */
+    private getProvider;
+    /**
+     * Execute an operation with automatic fallback
+     */
+    execute<T>(operation: string, fn: (provider: TProvider) => Promise<T>): Promise<T>;
+    /**
+     * Get the current provider mode
+     */
+    getMode(): ProviderMode;
+    /**
+     * Check if skeleton has failed
+     */
+    isSkeletonFailed(): boolean;
+    /**
+     * Reset skeleton failure state (for testing)
+     */
+    resetSkeletonState(): void;
+}
+//# sourceMappingURL=three-tier-provider.d.ts.map

package/dist/providers/three-tier-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"three-tier-provider.d.ts","sourceRoot":"","sources":["../../src/providers/three-tier-provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH;;GAEG;AACH,oBAAY,YAAY;IACtB,UAAU,eAAe;IACzB,YAAY,kBAAkB;IAC9B,IAAI,SAAS;CACd;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAkB/D;AAED;;GAEG;AACH,MAAM,WAAW,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK;IACzD,qDAAqD;IACrD,UAAU,CAAC,EAAE,WAAW,CAAC;IACzB,uDAAuD;IACvD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,yCAAyC;IACzC,IAAI,EAAE,KAAK,CAAC;IACZ,oBAAoB;IACpB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;;;;;;GAOG;AACH,qBAAa,iBAAiB,CAAC,SAAS;IACtC,OAAO,CAAC,UAAU,CAAC,CAAY;IAC/B,OAAO,CAAC,YAAY,CAAC,CAAY;IACjC,OAAO,CAAC,IAAI,CAAY;IACxB,OAAO,CAAC,KAAK,CAAU;IAEvB,OAAO,CAAC,WAAW,CAAe;IAClC,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAK;gBAErB,MAAM,EAAE,eAAe,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,CAAC;IAmBpE,OAAO,CAAC,GAAG;IAMX;;OAEG;IACH,OAAO,CAAC,WAAW;IAqBnB;;OAEG;IACG,OAAO,CAAC,CAAC,EACb,SAAS,EAAE,MAAM,EACjB,EAAE,EAAE,CAAC,QAAQ,EAAE,SAAS,KAAK,OAAO,CAAC,CAAC,CAAC,GACtC,OAAO,CAAC,CAAC,CAAC;IA2Cb;;OAEG;IACH,OAAO,IAAI,YAAY;IAUvB;;OAEG;IACH,gBAAgB,IAAI,OAAO;IAI3B;;OAEG;IACH,kBAAkB,IAAI,IAAI;CAI3B"}

package/dist/providers/three-tier-provider.js

@@ -0,0 +1,165 @@
+/**
+ * Three-Tier Provider System
+ *
+ * Provides a unified fallback chain for platform services:
+ * 1. Production - Real Cloudflare bindings (KV, D1, R2)
+ * 2. Preview via Proxy - HTTP proxy to skeleton worker
+ * 3. Mock/In-Memory - Fallback when skeleton not ready
+ *
+ * This ensures graceful degradation during the first ~60 seconds of tile generation
+ * when the skeleton deployment might return 530 errors or not be ready yet.
+ */
+/**
+ * Provider mode enum
+ */
+export var ProviderMode;
+(function (ProviderMode) {
+    ProviderMode["Production"] = "production";
+    ProviderMode["PreviewProxy"] = "preview-proxy";
+    ProviderMode["Mock"] = "mock";
+})(ProviderMode || (ProviderMode = {}));
+/**
+ * Check if an error indicates the skeleton deployment isn't ready
+ */
+export function isSkeletonNotReadyError(error) {
+    if (!(error instanceof Error))
+        return false;
+    const message = error.message.toLowerCase();
+    // 530 errors indicate the Worker isn't ready yet
+    if (message.includes('530'))
+        return true;
+    // Network errors during initial deployment
+    if (message.includes('fetch failed') || message.includes('network error'))
+        return true;
+    // Connection refused during deployment
+    if (message.includes('econnrefused') || message.includes('connection refused'))
+        return true;
+    // Timeout errors
+    if (message.includes('timeout'))
+        return true;
+    return false;
+}
+/**
+ * Three-tier provider base class
+ *
+ * Implements the three-tier fallback logic:
+ * 1. Use production if available
+ * 2. Use preview proxy if available, fall back to mock on skeleton errors
+ * 3. Use mock as final fallback
+ */
+export class ThreeTierProvider {
+    production;
+    previewProxy;
+    mock;
+    debug;
+    currentMode;
+    skeletonFailed = false;
+    failureCount = 0;
+    maxFailures = 3;
+    constructor(config) {
+        this.production = config.production;
+        this.previewProxy = config.previewProxy;
+        this.mock = config.mock;
+        this.debug = config.debug ?? false;
+        // Determine initial mode
+        if (this.production) {
+            this.currentMode = ProviderMode.Production;
+            this.log('Initialized in PRODUCTION mode');
+        }
+        else if (this.previewProxy) {
+            this.currentMode = ProviderMode.PreviewProxy;
+            this.log('Initialized in PREVIEW PROXY mode with mock fallback');
+        }
+        else {
+            this.currentMode = ProviderMode.Mock;
+            this.log('Initialized in MOCK mode');
+        }
+    }
+    log(message, ...args) {
+        if (this.debug) {
+            console.log(`[ThreeTierProvider:${this.currentMode}] ${message}`, ...args);
+        }
+    }
+    /**
+     * Get the appropriate provider based on current mode and fallback logic
+     */
+    getProvider() {
+        // If in production mode, always use production
+        if (this.currentMode === ProviderMode.Production) {
+            return this.production;
+        }
+        // If in preview proxy mode and skeleton has failed, use mock
+        if (this.currentMode === ProviderMode.PreviewProxy && this.skeletonFailed) {
+            this.log('Using MOCK (skeleton previously failed)');
+            return this.mock;
+        }
+        // If in preview proxy mode, use proxy
+        if (this.currentMode === ProviderMode.PreviewProxy && this.previewProxy) {
+            return this.previewProxy;
+        }
+        // Default to mock
+        return this.mock;
+    }
+    /**
+     * Execute an operation with automatic fallback
+     */
+    async execute(operation, fn) {
+        // If in production mode, no fallback needed
+        if (this.currentMode === ProviderMode.Production) {
+            return fn(this.production);
+        }
+        // If skeleton already failed or in mock mode, use mock directly
+        if (this.skeletonFailed || this.currentMode === ProviderMode.Mock) {
+            this.log(`${operation}: Using mock`);
+            return fn(this.mock);
+        }
+        // Try preview proxy with fallback to mock
+        try {
+            this.log(`${operation}: Trying preview proxy`);
+            return await fn(this.previewProxy);
+        }
+        catch (error) {
+            // Check if this is a skeleton-not-ready error
+            if (isSkeletonNotReadyError(error)) {
+                this.failureCount++;
+                console.warn(`[ThreeTierProvider] ${operation}: Skeleton not ready (attempt ${this.failureCount}/${this.maxFailures}), falling back to mock:`, error instanceof Error ? error.message : error);
+                // After max failures, mark skeleton as failed
+                if (this.failureCount >= this.maxFailures) {
+                    this.skeletonFailed = true;
+                    console.warn(`[ThreeTierProvider] Skeleton marked as unavailable after ${this.maxFailures} failures`);
+                }
+                // Fall back to mock
+                this.log(`${operation}: Using mock fallback`);
+                return fn(this.mock);
+            }
+            // For other errors, re-throw (don't mask genuine errors)
+            throw error;
+        }
+    }
+    /**
+     * Get the current provider mode
+     */
+    getMode() {
+        if (this.currentMode === ProviderMode.Production) {
+            return ProviderMode.Production;
+        }
+        if (this.skeletonFailed) {
+            return ProviderMode.Mock;
+        }
+        return this.currentMode;
+    }
+    /**
+     * Check if skeleton has failed
+     */
+    isSkeletonFailed() {
+        return this.skeletonFailed;
+    }
+    /**
+     * Reset skeleton failure state (for testing)
+     */
+    resetSkeletonState() {
+        this.skeletonFailed = false;
+        this.failureCount = 0;
+    }
+}
+//# sourceMappingURL=three-tier-provider.js.map

package/dist/providers/three-tier-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"three-tier-provider.js","sourceRoot":"","sources":["../../src/providers/three-tier-provider.ts"],"names":[],"mappings":"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"}

package/dist/r2/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/r2/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAKrF,mBAAmB,SAAS,CAAC;AAE7B;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CACxB,GAAG,CAAC,EAAE,cAAc,GAAG;IAAE,GAAG,EAAE,oBAAoB,CAAA;CAAE,GAAG,oBAAoB,GAC1E,eAAe,CAuDjB;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,oBAAoB,GAAG,eAAe,CAexE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/r2/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAKrF,mBAAmB,SAAS,CAAC;AAE7B;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CACxB,GAAG,CAAC,EAAE,cAAc,GAAG;IAAE,GAAG,EAAE,oBAAoB,CAAA;CAAE,GAAG,oBAAoB,GAC1E,eAAe,CAyCjB;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,oBAAoB,GAAG,eAAe,CAexE"}

package/dist/r2/index.js

@@ -25,7 +25,7 @@
  * }
  * ```
  */
-import { CloudflareR2 } from './providers';
+import { CloudflareR2, ThreeTierR2 } from './providers';
 import { getPlatformEnv, isPlatformEnvConfigured } from '../env';
 /**
  * Get a storage instance for the current request
@@ -62,25 +62,18 @@ export function getStorage(req) {
     if (!env) {
         throw new Error('No environment found in request. Ensure you are running in edge runtime.');
     }
-    // Check for R2 binding
-    if (!env.STORAGE) {
+    // Use three-tier provider system
+    const config = {
+        production: env.STORAGE,
+        publicUrl: env.STORAGE_PUBLIC_URL,
+        previewProxy: env.__STORAGE_HTTP_PROXY__,
+        debug: true,
+    };
+    // If no production binding and no preview proxy, throw error
+    if (!config.production && !config.previewProxy) {
         throw new Error('No R2 bucket binding found. Add an R2 bucket binding named "STORAGE" to your wrangler.jsonc');
     }
-    // Get provider from environment (defaults to 'r2')
-    const provider = env.STORAGE_PROVIDER || 'r2';
-    switch (provider) {
-        case 'r2':
-            return new CloudflareR2(env.STORAGE, env.STORAGE_PUBLIC_URL);
-        case 's3':
-            // Future: AWS S3 implementation
-            throw new Error('AWS S3 provider not yet implemented. Use STORAGE_PROVIDER=r2 or remove STORAGE_PROVIDER.');
-        case 'backblaze':
-            // Future: Backblaze B2 implementation
-            throw new Error('Backblaze B2 provider not yet implemented. Use STORAGE_PROVIDER=r2 or remove STORAGE_PROVIDER.');
-        default:
-            console.warn(`Unknown STORAGE_PROVIDER: ${provider}. Falling back to Cloudflare R2.`);
-            return new CloudflareR2(env.STORAGE, env.STORAGE_PUBLIC_URL);
-    }
+    return new ThreeTierR2(config);
 }
 /**
  * Create a storage instance directly (for advanced usage)

package/dist/r2/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/r2/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,uBAAuB,EAAE,MAAM,QAAQ,CAAC;AAKjE;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,UAAU,CACxB,GAA2E;IAE3E,IAAI,GAAqC,CAAC;IAE1C,2DAA2D;IAC3D,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,IAAI,CAAC,uBAAuB,EAAE,EAAE,CAAC;YAC/B,MAAM,IAAI,KAAK,CACb,6EAA6E;gBAC3E,qHAAqH,CACxH,CAAC;QACJ,CAAC;QACD,GAAG,GAAG,cAAc,EAA0B,CAAC;IACjD,CAAC;SAAM,IAAI,KAAK,IAAI,GAAG,EAAE,CAAC;QACxB,GAAG,GAAG,GAAG,CAAC,GAAG,CAAC;IAChB,CAAC;SAAM,IAAI,SAAS,IAAI,GAAG,EAAE,CAAC;QAC5B,oBAAoB;QACpB,GAAG,GAAG,GAA2B,CAAC;IACpC,CAAC;SAAM,CAAC;QACN,GAAG,GAAI,GAAW,CAAC,GAAG,CAAC;IACzB,CAAC;IAED,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CAAC,0EAA0E,CAAC,CAAC;IAC9F,CAAC;IAED,uBAAuB;IACvB,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CACb,6FAA6F,CAC9F,CAAC;IACJ,CAAC;IAED,mDAAmD;IACnD,MAAM,QAAQ,GAAG,GAAG,CAAC,gBAAgB,IAAI,IAAI,CAAC;IAE9C,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,IAAI;YACP,OAAO,IAAI,YAAY,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,kBAAkB,CAAC,CAAC;QAE/D,KAAK,IAAI;YACP,gCAAgC;YAChC,MAAM,IAAI,KAAK,CACb,0FAA0F,CAC3F,CAAC;QAEJ,KAAK,WAAW;YACd,sCAAsC;YACtC,MAAM,IAAI,KAAK,CACb,gGAAgG,CACjG,CAAC;QAEJ;YACE,OAAO,CAAC,IAAI,CAAC,6BAA6B,QAAQ,kCAAkC,CAAC,CAAC;YACtF,OAAO,IAAI,YAAY,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,kBAAkB,CAAC,CAAC;IACjE,CAAC;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,aAAa,CAAC,GAAyB;IACrD,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;IACjD,CAAC;IAED,MAAM,QAAQ,GAAG,GAAG,CAAC,gBAAgB,IAAI,IAAI,CAAC;IAE9C,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,IAAI;YACP,OAAO,IAAI,YAAY,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,kBAAkB,CAAC,CAAC;QAE/D;YACE,OAAO,CAAC,IAAI,CAAC,6BAA6B,QAAQ,kCAAkC,CAAC,CAAC;YACtF,OAAO,IAAI,YAAY,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,kBAAkB,CAAC,CAAC;IACjE,CAAC;AACH,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/r2/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAGH,OAAO,EAAE,YAAY,EAAE,WAAW,EAAmD,MAAM,aAAa,CAAC;AACzG,OAAO,EAAE,cAAc,EAAE,uBAAuB,EAAE,MAAM,QAAQ,CAAC;AAKjE;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,UAAU,CACxB,GAA2E;IAE3E,IAAI,GAAqC,CAAC;IAE1C,2DAA2D;IAC3D,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,IAAI,CAAC,uBAAuB,EAAE,EAAE,CAAC;YAC/B,MAAM,IAAI,KAAK,CACb,6EAA6E;gBAC3E,qHAAqH,CACxH,CAAC;QACJ,CAAC;QACD,GAAG,GAAG,cAAc,EAA0B,CAAC;IACjD,CAAC;SAAM,IAAI,KAAK,IAAI,GAAG,EAAE,CAAC;QACxB,GAAG,GAAG,GAAG,CAAC,GAAG,CAAC;IAChB,CAAC;SAAM,IAAI,SAAS,IAAI,GAAG,EAAE,CAAC;QAC5B,oBAAoB;QACpB,GAAG,GAAG,GAA2B,CAAC;IACpC,CAAC;SAAM,CAAC;QACN,GAAG,GAAI,GAAW,CAAC,GAAG,CAAC;IACzB,CAAC;IAED,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CAAC,0EAA0E,CAAC,CAAC;IAC9F,CAAC;IAED,iCAAiC;IACjC,MAAM,MAAM,GAAsB;QAChC,UAAU,EAAE,GAAG,CAAC,OAAO;QACvB,SAAS,EAAE,GAAG,CAAC,kBAAkB;QACjC,YAAY,EAAE,GAAG,CAAC,sBAAwD;QAC1E,KAAK,EAAE,IAAI;KACZ,CAAC;IAEF,6DAA6D;IAC7D,IAAI,CAAC,MAAM,CAAC,UAAU,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC;QAC/C,MAAM,IAAI,KAAK,CACb,6FAA6F,CAC9F,CAAC;IACJ,CAAC;IAED,OAAO,IAAI,WAAW,CAAC,MAAM,CAAC,CAAC;AACjC,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,aAAa,CAAC,GAAyB;IACrD,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;IACjD,CAAC;IAED,MAAM,QAAQ,GAAG,GAAG,CAAC,gBAAgB,IAAI,IAAI,CAAC;IAE9C,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,IAAI;YACP,OAAO,IAAI,YAAY,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,kBAAkB,CAAC,CAAC;QAE/D;YACE,OAAO,CAAC,IAAI,CAAC,6BAA6B,QAAQ,kCAAkC,CAAC,CAAC;YACtF,OAAO,IAAI,YAAY,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,kBAAkB,CAAC,CAAC;IACjE,CAAC;AACH,CAAC"}

package/dist/r2/mock-provider.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Simple in-memory mock R2 storage provider
+ * Implements StorageProvider interface for preview/testing
+ */
+import type { StorageProvider, StorageObject, StorageMetadata, ListOptions, ListResult, PutOptions, PutResult, GetOptions } from './types';
+export declare class MockR2Provider implements StorageProvider {
+    private objects;
+    private debug;
+    constructor(config?: {
+        debug?: boolean;
+    });
+    private log;
+    put(key: string, value: ArrayBuffer | ReadableStream | Blob | string, options?: PutOptions): Promise<PutResult>;
+    get(key: string, options?: GetOptions): Promise<StorageObject | null>;
+    delete(key: string): Promise<void>;
+    deleteMany(keys: string[]): Promise<void>;
+    head(key: string): Promise<StorageMetadata | null>;
+    list(options?: ListOptions): Promise<ListResult>;
+    exists(key: string): Promise<boolean>;
+    copy(sourceKey: string, destinationKey: string): Promise<void>;
+    getPublicUrl(key: string): string;
+}
+//# sourceMappingURL=mock-provider.d.ts.map

package/dist/r2/mock-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-provider.d.ts","sourceRoot":"","sources":["../../src/r2/mock-provider.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EACV,eAAe,EACf,aAAa,EACb,eAAe,EACf,WAAW,EACX,UAAU,EACV,UAAU,EACV,SAAS,EACT,UAAU,EACX,MAAM,SAAS,CAAC;AAWjB,qBAAa,cAAe,YAAW,eAAe;IACpD,OAAO,CAAC,OAAO,CAA6C;IAC5D,OAAO,CAAC,KAAK,CAAU;gBAEX,MAAM,GAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAO;IAI5C,OAAO,CAAC,GAAG;IAML,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,cAAc,GAAG,IAAI,GAAG,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC;IAiD/G,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAwBrE,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKlC,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAOzC,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAkBlD,IAAI,CAAC,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;IAmChD,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAKrC,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAepE,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;CAKlC"}

package/dist/r2/mock-provider.js

@@ -0,0 +1,161 @@
+/**
+ * Simple in-memory mock R2 storage provider
+ * Implements StorageProvider interface for preview/testing
+ */
+export class MockR2Provider {
+    objects = new Map();
+    debug;
+    constructor(config = {}) {
+        this.debug = config.debug ?? false;
+    }
+    log(message, ...args) {
+        if (this.debug) {
+            console.log(`[MockR2] ${message}`, ...args);
+        }
+    }
+    async put(key, value, options) {
+        this.log('PUT', key, options);
+        // Convert value to ArrayBuffer
+        let buffer;
+        if (typeof value === 'string') {
+            buffer = new TextEncoder().encode(value).buffer;
+        }
+        else if (value instanceof Blob) {
+            buffer = await value.arrayBuffer();
+        }
+        else if (value instanceof ReadableStream) {
+            // Read stream to buffer
+            const reader = value.getReader();
+            const chunks = [];
+            while (true) {
+                const { done, value: chunk } = await reader.read();
+                if (done)
+                    break;
+                chunks.push(chunk);
+            }
+            const totalLength = chunks.reduce((acc, chunk) => acc + chunk.length, 0);
+            const combined = new Uint8Array(totalLength);
+            let offset = 0;
+            for (const chunk of chunks) {
+                combined.set(chunk, offset);
+                offset += chunk.length;
+            }
+            buffer = combined.buffer;
+        }
+        else {
+            buffer = value;
+        }
+        const obj = {
+            key,
+            value: buffer,
+            metadata: options?.customMetadata,
+            contentType: options?.metadata?.contentType,
+            uploaded: new Date(),
+            size: buffer.byteLength,
+        };
+        this.objects.set(key, obj);
+        return {
+            key,
+            etag: `mock-etag-${Date.now()}`,
+            size: buffer.byteLength,
+            versionId: `mock-version-${Date.now()}`,
+        };
+    }
+    async get(key, options) {
+        this.log('GET', key, options);
+        const obj = this.objects.get(key);
+        if (!obj) {
+            return null;
+        }
+        return {
+            key: obj.key,
+            body: new ReadableStream({
+                start(controller) {
+                    controller.enqueue(new Uint8Array(obj.value));
+                    controller.close();
+                },
+            }),
+            size: obj.size,
+            etag: `mock-etag-${obj.uploaded.getTime()}`,
+            uploaded: obj.uploaded,
+            httpMetadata: obj.contentType ? { contentType: obj.contentType } : {},
+            metadata: obj.metadata,
+        };
+    }
+    async delete(key) {
+        this.log('DELETE', key);
+        this.objects.delete(key);
+    }
+    async deleteMany(keys) {
+        this.log('DELETE_MANY', keys);
+        for (const key of keys) {
+            this.objects.delete(key);
+        }
+    }
+    async head(key) {
+        this.log('HEAD', key);
+        const obj = this.objects.get(key);
+        if (!obj) {
+            return null;
+        }
+        return {
+            key: obj.key,
+            size: obj.size,
+            etag: `mock-etag-${obj.uploaded.getTime()}`,
+            uploaded: obj.uploaded,
+            httpMetadata: obj.contentType ? { contentType: obj.contentType } : {},
+            metadata: obj.metadata,
+        };
+    }
+    async list(options) {
+        this.log('LIST', options);
+        let keys = Array.from(this.objects.keys());
+        // Filter by prefix
+        if (options?.prefix) {
+            keys = keys.filter((key) => key.startsWith(options.prefix));
+        }
+        // Apply limit
+        const limit = options?.limit || 1000;
+        const truncated = keys.length > limit;
+        keys = keys.slice(0, limit);
+        // Get metadata for each key
+        const objects = keys.map((key) => {
+            const obj = this.objects.get(key);
+            return {
+                key: obj.key,
+                size: obj.size,
+                etag: `mock-etag-${obj.uploaded.getTime()}`,
+                uploaded: obj.uploaded,
+                httpMetadata: obj.contentType ? { contentType: obj.contentType } : undefined,
+                metadata: obj.metadata,
+            };
+        });
+        return {
+            objects,
+            truncated,
+            cursor: truncated ? keys[keys.length - 1] : undefined,
+        };
+    }
+    async exists(key) {
+        this.log('EXISTS', key);
+        return this.objects.has(key);
+    }
+    async copy(sourceKey, destinationKey) {
+        this.log('COPY', sourceKey, '->', destinationKey);
+        const obj = this.objects.get(sourceKey);
+        if (!obj) {
+            throw new Error(`Source key not found: ${sourceKey}`);
+        }
+        this.objects.set(destinationKey, {
+            ...obj,
+            key: destinationKey,
+            uploaded: new Date(),
+        });
+    }
+    getPublicUrl(key) {
+        this.log('GET_PUBLIC_URL', key);
+        // Return a mock public URL
+        return `https://mock-r2.storage/${key}`;
+    }
+}
+//# sourceMappingURL=mock-provider.js.map

package/dist/r2/mock-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-provider.js","sourceRoot":"","sources":["../../src/r2/mock-provider.ts"],"names":[],"mappings":"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"}

package/dist/r2/providers/http-proxy-r2.d.ts

@@ -0,0 +1,40 @@
+/**
+ * HTTP Proxy R2 provider for preview mode
+ *
+ * Proxies all R2 storage operations to a deployed tile's /proxy/storage/op endpoint.
+ * Used in browser previews to access real Cloudflare R2 via the deployed skeleton tile.
+ */
+import type { StorageProvider, StorageValue, PutOptions, PutResult, GetOptions, StorageObject, StorageMetadata, ListOptions, ListResult, PublicUrlOptions, SignedUrlOptions } from '../types';
+export interface HTTPProxyR2Options {
+    /** Base URL of the deployed tile (e.g., https://tile-id.whatever.tube) */
+    deploymentUrl: string;
+    /** Optional auth token for authenticated requests */
+    authToken?: string;
+}
+/**
+ * HTTP Proxy R2 implementation
+ *
+ * All operations are proxied to the deployed tile's /proxy/storage/op endpoint.
+ */
+export declare class HTTPProxyR2 implements StorageProvider {
+    private deploymentUrl;
+    private authToken?;
+    private prefix;
+    constructor(options: HTTPProxyR2Options);
+    private proxyRequest;
+    /**
+     * Encode data to base64 for transmission
+     */
+    private encodeData;
+    put(key: string, data: StorageValue, options?: PutOptions): Promise<PutResult>;
+    get(key: string, options?: GetOptions): Promise<StorageObject | null>;
+    delete(key: string): Promise<void>;
+    deleteMany(keys: string[]): Promise<void>;
+    exists(key: string): Promise<boolean>;
+    list(options?: ListOptions): Promise<ListResult>;
+    head(key: string): Promise<StorageMetadata | null>;
+    getPublicUrl(key: string, options?: PublicUrlOptions): string;
+    getSignedUrl(key: string, options?: SignedUrlOptions): Promise<string>;
+    copy(sourceKey: string, destinationKey: string): Promise<void>;
+}
+//# sourceMappingURL=http-proxy-r2.d.ts.map

package/dist/r2/providers/http-proxy-r2.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-proxy-r2.d.ts","sourceRoot":"","sources":["../../../src/r2/providers/http-proxy-r2.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,eAAe,EACf,YAAY,EACZ,UAAU,EACV,SAAS,EACT,UAAU,EACV,aAAa,EACb,eAAe,EACf,WAAW,EACX,UAAU,EACV,gBAAgB,EAChB,gBAAgB,EACjB,MAAM,UAAU,CAAC;AAElB,MAAM,WAAW,kBAAkB;IACjC,0EAA0E;IAC1E,aAAa,EAAE,MAAM,CAAC;IACtB,qDAAqD;IACrD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;GAIG;AACH,qBAAa,WAAY,YAAW,eAAe;IACjD,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,SAAS,CAAC,CAAS;IAC3B,OAAO,CAAC,MAAM,CAAmB;gBAErB,OAAO,EAAE,kBAAkB;YAMzB,YAAY;IAiC1B;;OAEG;YACW,UAAU;IA8ClB,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC;IAU9E,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAkDrE,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIlC,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAKrC,IAAI,CAAC,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;IAKhD,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAexD,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,MAAM;IAQvD,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC;IAItE,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAQrE"}