@thewhateverapp/platform 0.13.10 → 0.13.11

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,CA8DjB;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, HTTPProxyR2 } from './providers';
+import { CloudflareR2, ThreeTierR2 } from './providers';
 import { getPlatformEnv, isPlatformEnvConfigured } from '../env';
 /**
  * Get a storage instance for the current request
@@ -62,31 +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 HTTP proxy marker (set by platform-config module in preview mode)
-    if (env.__STORAGE_HTTP_PROXY__) {
-        const proxyOptions = env.__STORAGE_HTTP_PROXY__;
-        console.log('[PLATFORM-SDK] Using HTTPProxyR2 with deployment URL:', proxyOptions.deploymentUrl);
-        return new HTTPProxyR2(proxyOptions);
-    }
-    // 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,WAAW,EAA2B,MAAM,aAAa,CAAC;AACjF,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,8EAA8E;IAC9E,IAAI,GAAG,CAAC,sBAAsB,EAAE,CAAC;QAC/B,MAAM,YAAY,GAAG,GAAG,CAAC,sBAA4C,CAAC;QACtE,OAAO,CAAC,GAAG,CAAC,uDAAuD,EAAE,YAAY,CAAC,aAAa,CAAC,CAAC;QACjG,OAAO,IAAI,WAAW,CAAC,YAAY,CAAC,CAAC;IACvC,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/index.d.ts

@@ -5,4 +5,5 @@
  */
 export { CloudflareR2 } from './cloudflare-r2';
 export { HTTPProxyR2, type HTTPProxyR2Options } from './http-proxy-r2';
+export { ThreeTierR2, type ThreeTierR2Config } from './three-tier-r2';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/r2/providers/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,KAAK,kBAAkB,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/r2/providers/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,KAAK,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACvE,OAAO,EAAE,WAAW,EAAE,KAAK,iBAAiB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/r2/providers/index.js

@@ -5,6 +5,7 @@
  */
 export { CloudflareR2 } from './cloudflare-r2';
 export { HTTPProxyR2 } from './http-proxy-r2';
+export { ThreeTierR2 } from './three-tier-r2';
 // Future providers:
 // export { AWSS3 } from './aws-s3';
 // export { BackblazeB2 } from './backblaze-b2';

package/dist/r2/providers/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/r2/providers/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAA2B,MAAM,iBAAiB,CAAC;AAEvE,oBAAoB;AACpB,oCAAoC;AACpC,gDAAgD"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/r2/providers/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAA2B,MAAM,iBAAiB,CAAC;AACvE,OAAO,EAAE,WAAW,EAA0B,MAAM,iBAAiB,CAAC;AAEtE,oBAAoB;AACpB,oCAAoC;AACpC,gDAAgD"}

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

@@ -0,0 +1,43 @@
+/**
+ * Three-Tier R2 Storage Provider
+ *
+ * Implements the three-tier fallback system:
+ * 1. Production - Real Cloudflare R2 binding
+ * 2. Preview via Proxy - HTTP proxy to skeleton worker
+ * 3. Mock/In-Memory - Fallback when skeleton not ready
+ */
+import type { StorageProvider, StorageObject, StorageMetadata, ListOptions, ListResult, PutOptions, PutResult, GetOptions } from '../types';
+import { type HTTPProxyR2Options } from './http-proxy-r2';
+/**
+ * Three-tier R2 configuration
+ */
+export interface ThreeTierR2Config {
+    /** Production R2 binding (if available) */
+    production?: R2Bucket;
+    /** Public URL for production storage */
+    publicUrl?: string;
+    /** Preview proxy configuration (if in preview mode) */
+    previewProxy?: HTTPProxyR2Options;
+    /** Debug logging */
+    debug?: boolean;
+}
+/**
+ * Three-Tier R2 Storage Provider
+ *
+ * Automatically selects between production, preview proxy, and mock based on availability
+ * and skeleton deployment readiness.
+ */
+export declare class ThreeTierR2 implements StorageProvider {
+    private provider;
+    constructor(config: ThreeTierR2Config);
+    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=three-tier-r2.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"three-tier-r2.d.ts","sourceRoot":"","sources":["../../../src/r2/providers/three-tier-r2.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,eAAe,EACf,aAAa,EACb,eAAe,EACf,WAAW,EACX,UAAU,EACV,UAAU,EACV,SAAS,EACT,UAAU,EACX,MAAM,UAAU,CAAC;AAElB,OAAO,EAAe,KAAK,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAIvE;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,2CAA2C;IAC3C,UAAU,CAAC,EAAE,QAAQ,CAAC;IACtB,wCAAwC;IACxC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uDAAuD;IACvD,YAAY,CAAC,EAAE,kBAAkB,CAAC;IAClC,oBAAoB;IACpB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;;;;GAKG;AACH,qBAAa,WAAY,YAAW,eAAe;IACjD,OAAO,CAAC,QAAQ,CAAqC;gBAEzC,MAAM,EAAE,iBAAiB;IAiB/B,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;IAI/G,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAIrE,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIlC,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzC,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAIlD,IAAI,CAAC,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;IAIhD,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIrC,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpE,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;CAoBlC"}

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

@@ -0,0 +1,82 @@
+/**
+ * Three-Tier R2 Storage Provider
+ *
+ * Implements the three-tier fallback system:
+ * 1. Production - Real Cloudflare R2 binding
+ * 2. Preview via Proxy - HTTP proxy to skeleton worker
+ * 3. Mock/In-Memory - Fallback when skeleton not ready
+ */
+import { CloudflareR2 } from './cloudflare-r2';
+import { HTTPProxyR2 } from './http-proxy-r2';
+import { MockR2Provider } from '../mock-provider';
+import { ThreeTierProvider } from '../../providers/three-tier-provider';
+/**
+ * Three-Tier R2 Storage Provider
+ *
+ * Automatically selects between production, preview proxy, and mock based on availability
+ * and skeleton deployment readiness.
+ */
+export class ThreeTierR2 {
+    provider;
+    constructor(config) {
+        const production = config.production
+            ? new CloudflareR2(config.production, config.publicUrl)
+            : undefined;
+        const previewProxy = config.previewProxy
+            ? new HTTPProxyR2(config.previewProxy)
+            : undefined;
+        const mock = new MockR2Provider({ debug: config.debug });
+        this.provider = new ThreeTierProvider({
+            production,
+            previewProxy,
+            mock,
+            debug: config.debug,
+        });
+    }
+    async put(key, value, options) {
+        return this.provider.execute('PUT', (storage) => storage.put(key, value, options));
+    }
+    async get(key, options) {
+        return this.provider.execute('GET', (storage) => storage.get(key, options));
+    }
+    async delete(key) {
+        return this.provider.execute('DELETE', (storage) => storage.delete(key));
+    }
+    async deleteMany(keys) {
+        return this.provider.execute('DELETE_MANY', (storage) => storage.deleteMany(keys));
+    }
+    async head(key) {
+        return this.provider.execute('HEAD', (storage) => storage.head(key));
+    }
+    async list(options) {
+        return this.provider.execute('LIST', (storage) => storage.list(options));
+    }
+    async exists(key) {
+        return this.provider.execute('EXISTS', (storage) => storage.exists(key));
+    }
+    async copy(sourceKey, destinationKey) {
+        return this.provider.execute('COPY', (storage) => storage.copy(sourceKey, destinationKey));
+    }
+    getPublicUrl(key) {
+        // For public URL, we can't use async execute, so we need to get the provider synchronously
+        // In preview mode with skeleton not ready, return mock URL
+        // In production, delegate to the production provider
+        try {
+            // Try to get the current mode
+            const mode = this.provider.getMode();
+            if (mode === 'production') {
+                // Get production provider - this is a bit hacky but necessary for sync method
+                const config = this.provider;
+                const production = config.production;
+                if (production?.getPublicUrl) {
+                    return production.getPublicUrl(key);
+                }
+            }
+        }
+        catch (e) {
+            // If anything fails, return mock URL
+        }
+        return `https://mock-r2.storage/${key}`;
+    }
+}
+//# sourceMappingURL=three-tier-r2.js.map

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

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thewhateverapp/platform",
-  "version": "0.13.10",
+  "version": "0.13.11",
   "description": "Universal SDK for The Whatever App platform services",
   "type": "module",
   "main": "./dist/index.js",