@thewhateverapp/platform 0.0.1

package/dist/edge/database/types.js

@@ -0,0 +1,8 @@
+/**
+ * Database abstraction types for edge runtime
+ *
+ * Provides a MongoDB-like interface that can be implemented by various providers
+ * (FlexDB/D1, Turso, MongoDB Atlas, etc.) allowing seamless upgrades as apps scale.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/edge/database/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/edge/database/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/edge/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Edge runtime exports
+ *
+ * Services and utilities designed specifically for Cloudflare Workers / Pages edge runtime
+ */
+export { getDatabase, createDatabase } from './database';
+export type * from './database/types';
+export { getKV, createKV } from './kv';
+export type * from './kv/types';
+export { getStorage, createStorage } from './storage';
+export type * from './storage/types';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/edge/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACzD,mBAAmB,kBAAkB,CAAC;AAGtC,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AACvC,mBAAmB,YAAY,CAAC;AAGhC,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AACtD,mBAAmB,iBAAiB,CAAC"}

package/dist/edge/index.js

@@ -0,0 +1,12 @@
+/**
+ * Edge runtime exports
+ *
+ * Services and utilities designed specifically for Cloudflare Workers / Pages edge runtime
+ */
+// Database exports
+export { getDatabase, createDatabase } from './database';
+// KV (Key-Value) exports
+export { getKV, createKV } from './kv';
+// Storage (Object Storage / R2) exports
+export { getStorage, createStorage } from './storage';
+//# sourceMappingURL=index.js.map

package/dist/edge/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/edge/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,mBAAmB;AACnB,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAGzD,yBAAyB;AACzB,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AAGvC,wCAAwC;AACxC,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC"}

package/dist/edge/kv/index.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Edge KV (Key-Value) Storage API
+ *
+ * Provides a simple key-value store interface for user-generated apps.
+ * Automatically selects the appropriate provider based on environment configuration.
+ *
+ * @example
+ * ```typescript
+ * import { getKV } from '@thewhateverapp/platform/edge';
+ *
+ * export async function GET(req: NextRequest) {
+ *   const kv = await getKV(req);
+ *
+ *   // Store data
+ *   await kv.set('user:123', { name: 'Alice', score: 100 });
+ *
+ *   // Retrieve data
+ *   const user = await kv.get('user:123', 'json');
+ *
+ *   return NextResponse.json(user);
+ * }
+ * ```
+ */
+import type { KVProvider, CloudflareKVEnv, KVRequest } from './types';
+export type * from './types';
+/**
+ * Get a KV instance for the current request
+ *
+ * Automatically selects the appropriate provider based on environment:
+ * - 'cloudflare' (default): Cloudflare KV
+ * - 'upstash': Upstash Redis
+ * - 'vercel': Vercel KV
+ *
+ * @param req - NextRequest or object with env property
+ * @returns KV provider instance
+ */
+export declare function getKV(req: KVRequest | {
+    env: CloudflareKVEnv;
+}): Promise<KVProvider>;
+/**
+ * Create a KV instance directly (for advanced usage)
+ *
+ * @example
+ * ```typescript
+ * const kv = createKV({ KV: env.KV });
+ * await kv.set('key', 'value');
+ * ```
+ */
+export declare function createKV(env: CloudflareKVEnv): KVProvider;
+//# sourceMappingURL=index.d.ts.map

package/dist/edge/kv/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/edge/kv/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAItE,mBAAmB,SAAS,CAAC;AAE7B;;;;;;;;;;GAUG;AACH,wBAAsB,KAAK,CAAC,GAAG,EAAE,SAAS,GAAG;IAAE,GAAG,EAAE,eAAe,CAAA;CAAE,GAAG,OAAO,CAAC,UAAU,CAAC,CAqC1F;AAED;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,eAAe,GAAG,UAAU,CAezD"}

package/dist/edge/kv/index.js

@@ -0,0 +1,83 @@
+/**
+ * Edge KV (Key-Value) Storage API
+ *
+ * Provides a simple key-value store interface for user-generated apps.
+ * Automatically selects the appropriate provider based on environment configuration.
+ *
+ * @example
+ * ```typescript
+ * import { getKV } from '@thewhateverapp/platform/edge';
+ *
+ * export async function GET(req: NextRequest) {
+ *   const kv = await getKV(req);
+ *
+ *   // Store data
+ *   await kv.set('user:123', { name: 'Alice', score: 100 });
+ *
+ *   // Retrieve data
+ *   const user = await kv.get('user:123', 'json');
+ *
+ *   return NextResponse.json(user);
+ * }
+ * ```
+ */
+import { CloudflareKV } from './providers';
+/**
+ * Get a KV instance for the current request
+ *
+ * Automatically selects the appropriate provider based on environment:
+ * - 'cloudflare' (default): Cloudflare KV
+ * - 'upstash': Upstash Redis
+ * - 'vercel': Vercel KV
+ *
+ * @param req - NextRequest or object with env property
+ * @returns KV provider instance
+ */
+export async function getKV(req) {
+    const env = 'env' in req ? req.env : req.env;
+    if (!env) {
+        throw new Error('No environment found in request. Ensure you are running in edge runtime.');
+    }
+    // Check for KV binding
+    if (!env.KV) {
+        throw new Error('No KV namespace binding found. Add a KV namespace binding named "KV" to your wrangler.jsonc');
+    }
+    // Get provider from environment (defaults to 'cloudflare')
+    const provider = env.KV_PROVIDER || 'cloudflare';
+    switch (provider) {
+        case 'cloudflare':
+            return new CloudflareKV(env.KV);
+        case 'upstash':
+            // Future: Upstash Redis implementation
+            throw new Error('Upstash KV provider not yet implemented. Use KV_PROVIDER=cloudflare or remove KV_PROVIDER.');
+        case 'vercel':
+            // Future: Vercel KV implementation
+            throw new Error('Vercel KV provider not yet implemented. Use KV_PROVIDER=cloudflare or remove KV_PROVIDER.');
+        default:
+            console.warn(`Unknown KV_PROVIDER: ${provider}. Falling back to Cloudflare KV.`);
+            return new CloudflareKV(env.KV);
+    }
+}
+/**
+ * Create a KV instance directly (for advanced usage)
+ *
+ * @example
+ * ```typescript
+ * const kv = createKV({ KV: env.KV });
+ * await kv.set('key', 'value');
+ * ```
+ */
+export function createKV(env) {
+    if (!env.KV) {
+        throw new Error('No KV namespace binding found.');
+    }
+    const provider = env.KV_PROVIDER || 'cloudflare';
+    switch (provider) {
+        case 'cloudflare':
+            return new CloudflareKV(env.KV);
+        default:
+            console.warn(`Unknown KV_PROVIDER: ${provider}. Falling back to Cloudflare KV.`);
+            return new CloudflareKV(env.KV);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/edge/kv/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/edge/kv/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAK3C;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,KAAK,CAAC,GAAyC;IACnE,MAAM,GAAG,GAAG,KAAK,IAAI,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAE,GAAW,CAAC,GAAG,CAAC;IAEtD,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CAAC,0EAA0E,CAAC,CAAC;IAC9F,CAAC;IAED,uBAAuB;IACvB,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CACb,6FAA6F,CAC9F,CAAC;IACJ,CAAC;IAED,2DAA2D;IAC3D,MAAM,QAAQ,GAAG,GAAG,CAAC,WAAW,IAAI,YAAY,CAAC;IAEjD,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,YAAY;YACf,OAAO,IAAI,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAElC,KAAK,SAAS;YACZ,uCAAuC;YACvC,MAAM,IAAI,KAAK,CACb,4FAA4F,CAC7F,CAAC;QAEJ,KAAK,QAAQ;YACX,mCAAmC;YACnC,MAAM,IAAI,KAAK,CACb,2FAA2F,CAC5F,CAAC;QAEJ;YACE,OAAO,CAAC,IAAI,CAAC,wBAAwB,QAAQ,kCAAkC,CAAC,CAAC;YACjF,OAAO,IAAI,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACpC,CAAC;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,QAAQ,CAAC,GAAoB;IAC3C,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;IACpD,CAAC;IAED,MAAM,QAAQ,GAAG,GAAG,CAAC,WAAW,IAAI,YAAY,CAAC;IAEjD,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,YAAY;YACf,OAAO,IAAI,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAElC;YACE,OAAO,CAAC,IAAI,CAAC,wBAAwB,QAAQ,kCAAkC,CAAC,CAAC;YACjF,OAAO,IAAI,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACpC,CAAC;AACH,CAAC"}

package/dist/edge/kv/providers/cloudflare-kv.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Cloudflare KV provider implementation
+ *
+ * Direct wrapper around Cloudflare KV with consistent API
+ */
+import type { KVProvider, KVValue, KVValueType, KVSetOptions, KVListOptions, KVListResult, KVMetadata } from '../types';
+/**
+ * Cloudflare KV implementation
+ */
+export declare class CloudflareKV implements KVProvider {
+    private kv;
+    constructor(kv: KVNamespace);
+    get<T = string>(key: string, type?: KVValueType): Promise<T | null>;
+    set(key: string, value: KVValue, options?: KVSetOptions): Promise<void>;
+    delete(key: string): Promise<void>;
+    deleteMany(keys: string[]): Promise<void>;
+    has(key: string): Promise<boolean>;
+    list(options?: KVListOptions): Promise<KVListResult>;
+    getMetadata(key: string): Promise<KVMetadata | null>;
+    /**
+     * Increment a numeric value atomically
+     * Note: KV doesn't support atomic operations, so this is best-effort
+     */
+    increment(key: string, amount?: number): Promise<number>;
+    /**
+     * Decrement a numeric value atomically
+     * Note: KV doesn't support atomic operations, so this is best-effort
+     */
+    decrement(key: string, amount?: number): Promise<number>;
+}
+//# sourceMappingURL=cloudflare-kv.d.ts.map

package/dist/edge/kv/providers/cloudflare-kv.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloudflare-kv.d.ts","sourceRoot":"","sources":["../../../../src/edge/kv/providers/cloudflare-kv.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,UAAU,EACV,OAAO,EACP,WAAW,EACX,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,UAAU,EACX,MAAM,UAAU,CAAC;AAElB;;GAEG;AACH,qBAAa,YAAa,YAAW,UAAU;IACjC,OAAO,CAAC,EAAE;gBAAF,EAAE,EAAE,WAAW;IAE7B,GAAG,CAAC,CAAC,GAAG,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,WAAoB,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAmB3E,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IA4BvE,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIlC,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAKzC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAKlC,IAAI,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;IA4BpD,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAY1D;;;OAGG;IACG,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,GAAE,MAAU,GAAG,OAAO,CAAC,MAAM,CAAC;IAQjE;;;OAGG;IACG,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,GAAE,MAAU,GAAG,OAAO,CAAC,MAAM,CAAC;CAGlE"}

package/dist/edge/kv/providers/cloudflare-kv.js

@@ -0,0 +1,115 @@
+/**
+ * Cloudflare KV provider implementation
+ *
+ * Direct wrapper around Cloudflare KV with consistent API
+ */
+/**
+ * Cloudflare KV implementation
+ */
+export class CloudflareKV {
+    kv;
+    constructor(kv) {
+        this.kv = kv;
+    }
+    async get(key, type = 'text') {
+        switch (type) {
+            case 'text':
+                return (await this.kv.get(key, 'text'));
+            case 'json':
+                return (await this.kv.get(key, 'json'));
+            case 'arrayBuffer':
+                return (await this.kv.get(key, 'arrayBuffer'));
+            case 'stream':
+                return (await this.kv.get(key, 'stream'));
+            default:
+                return (await this.kv.get(key, 'text'));
+        }
+    }
+    async set(key, value, options) {
+        const kvOptions = {};
+        if (options?.ttl) {
+            kvOptions.expirationTtl = options.ttl;
+        }
+        if (options?.expirationTtl) {
+            kvOptions.expiration = options.expirationTtl;
+        }
+        if (options?.metadata) {
+            kvOptions.metadata = options.metadata;
+        }
+        // Handle different value types
+        if (typeof value === 'string') {
+            await this.kv.put(key, value, kvOptions);
+        }
+        else if (value instanceof ReadableStream) {
+            await this.kv.put(key, value, kvOptions);
+        }
+        else if (value instanceof ArrayBuffer) {
+            await this.kv.put(key, value, kvOptions);
+        }
+        else {
+            // Object - serialize to JSON
+            await this.kv.put(key, JSON.stringify(value), kvOptions);
+        }
+    }
+    async delete(key) {
+        await this.kv.delete(key);
+    }
+    async deleteMany(keys) {
+        // Cloudflare KV doesn't have batch delete, so delete one by one
+        await Promise.all(keys.map((key) => this.kv.delete(key)));
+    }
+    async has(key) {
+        const value = await this.kv.get(key, 'text');
+        return value !== null;
+    }
+    async list(options) {
+        const listOptions = {};
+        if (options?.prefix) {
+            listOptions.prefix = options.prefix;
+        }
+        if (options?.limit) {
+            listOptions.limit = options.limit;
+        }
+        if (options?.cursor) {
+            listOptions.cursor = options.cursor;
+        }
+        const result = await this.kv.list(listOptions);
+        return {
+            keys: result.keys.map((key) => ({
+                name: key.name,
+                expiration: key.expiration,
+                metadata: key.metadata,
+            })),
+            complete: result.list_complete,
+            cursor: !result.list_complete && result.keys.length > 0 ? undefined : undefined,
+        };
+    }
+    async getMetadata(key) {
+        const result = await this.kv.getWithMetadata(key, 'text');
+        if (result.value === null) {
+            return null;
+        }
+        return {
+            metadata: result.metadata,
+        };
+    }
+    /**
+     * Increment a numeric value atomically
+     * Note: KV doesn't support atomic operations, so this is best-effort
+     */
+    async increment(key, amount = 1) {
+        const current = await this.get(key, 'text');
+        const currentValue = current ? parseInt(current, 10) : 0;
+        const newValue = currentValue + amount;
+        await this.set(key, String(newValue));
+        return newValue;
+    }
+    /**
+     * Decrement a numeric value atomically
+     * Note: KV doesn't support atomic operations, so this is best-effort
+     */
+    async decrement(key, amount = 1) {
+        return this.increment(key, -amount);
+    }
+}
+//# sourceMappingURL=cloudflare-kv.js.map

package/dist/edge/kv/providers/cloudflare-kv.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloudflare-kv.js","sourceRoot":"","sources":["../../../../src/edge/kv/providers/cloudflare-kv.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAYH;;GAEG;AACH,MAAM,OAAO,YAAY;IACH;IAApB,YAAoB,EAAe;QAAf,OAAE,GAAF,EAAE,CAAa;IAAG,CAAC;IAEvC,KAAK,CAAC,GAAG,CAAa,GAAW,EAAE,OAAoB,MAAM;QAC3D,QAAQ,IAAI,EAAE,CAAC;YACb,KAAK,MAAM;gBACT,OAAO,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAa,CAAC;YAEtD,KAAK,MAAM;gBACT,OAAO,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAa,CAAC;YAEtD,KAAK,aAAa;gBAChB,OAAO,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,EAAE,aAAa,CAAC,CAAa,CAAC;YAE7D,KAAK,QAAQ;gBACX,OAAO,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAa,CAAC;YAExD;gBACE,OAAO,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAa,CAAC;QACxD,CAAC;IACH,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,GAAW,EAAE,KAAc,EAAE,OAAsB;QAC3D,MAAM,SAAS,GAA0B,EAAE,CAAC;QAE5C,IAAI,OAAO,EAAE,GAAG,EAAE,CAAC;YACjB,SAAS,CAAC,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC;QACxC,CAAC;QAED,IAAI,OAAO,EAAE,aAAa,EAAE,CAAC;YAC3B,SAAS,CAAC,UAAU,GAAG,OAAO,CAAC,aAAa,CAAC;QAC/C,CAAC;QAED,IAAI,OAAO,EAAE,QAAQ,EAAE,CAAC;YACtB,SAAS,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;QACxC,CAAC;QAED,+BAA+B;QAC/B,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,MAAM,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC;QAC3C,CAAC;aAAM,IAAI,KAAK,YAAY,cAAc,EAAE,CAAC;YAC3C,MAAM,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC;QAC3C,CAAC;aAAM,IAAI,KAAK,YAAY,WAAW,EAAE,CAAC;YACxC,MAAM,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC;QAC3C,CAAC;aAAM,CAAC;YACN,6BAA6B;YAC7B,MAAM,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,SAAS,CAAC,CAAC;QAC3D,CAAC;IACH,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,GAAW;QACtB,MAAM,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC5B,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,IAAc;QAC7B,gEAAgE;QAChE,MAAM,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAC5D,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,GAAW;QACnB,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QAC7C,OAAO,KAAK,KAAK,IAAI,CAAC;IACxB,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,OAAuB;QAChC,MAAM,WAAW,GAA2B,EAAE,CAAC;QAE/C,IAAI,OAAO,EAAE,MAAM,EAAE,CAAC;YACpB,WAAW,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QACtC,CAAC;QAED,IAAI,OAAO,EAAE,KAAK,EAAE,CAAC;YACnB,WAAW,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QACpC,CAAC;QAED,IAAI,OAAO,EAAE,MAAM,EAAE,CAAC;YACpB,WAAW,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QACtC,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAE/C,OAAO;YACL,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;gBAC9B,IAAI,EAAE,GAAG,CAAC,IAAI;gBACd,UAAU,EAAE,GAAG,CAAC,UAAU;gBAC1B,QAAQ,EAAE,GAAG,CAAC,QAA2C;aAC1D,CAAC,CAAC;YACH,QAAQ,EAAE,MAAM,CAAC,aAAa;YAC9B,MAAM,EAAE,CAAC,MAAM,CAAC,aAAa,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS;SAChF,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,GAAW;QAC3B,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,EAAE,CAAC,eAAe,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QAE1D,IAAI,MAAM,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;YAC1B,OAAO,IAAI,CAAC;QACd,CAAC;QAED,OAAO;YACL,QAAQ,EAAE,MAAM,CAAC,QAA2C;SAC7D,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,SAAS,CAAC,GAAW,EAAE,SAAiB,CAAC;QAC7C,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,GAAG,CAAS,GAAG,EAAE,MAAM,CAAC,CAAC;QACpD,MAAM,YAAY,GAAG,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACzD,MAAM,QAAQ,GAAG,YAAY,GAAG,MAAM,CAAC;QACvC,MAAM,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;QACtC,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,SAAS,CAAC,GAAW,EAAE,SAAiB,CAAC;QAC7C,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,CAAC;IACtC,CAAC;CACF"}

package/dist/edge/kv/providers/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * KV provider registry
+ *
+ * Export all available KV providers
+ */
+export { CloudflareKV } from './cloudflare-kv';
+//# sourceMappingURL=index.d.ts.map

package/dist/edge/kv/providers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/edge/kv/providers/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/edge/kv/providers/index.js

@@ -0,0 +1,10 @@
+/**
+ * KV provider registry
+ *
+ * Export all available KV providers
+ */
+export { CloudflareKV } from './cloudflare-kv';
+// Future providers:
+// export { UpstashKV } from './upstash-kv';
+// export { VercelKV } from './vercel-kv';
+//# sourceMappingURL=index.js.map

package/dist/edge/kv/providers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/edge/kv/providers/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/C,oBAAoB;AACpB,4CAA4C;AAC5C,0CAA0C"}

package/dist/edge/kv/types.d.ts

@@ -0,0 +1,155 @@
+/**
+ * KV (Key-Value) storage abstraction types for edge runtime
+ *
+ * Provides a simple key-value store interface that can be implemented by various providers
+ * (Cloudflare KV, Upstash Redis, Vercel KV, etc.) allowing seamless upgrades as apps scale.
+ */
+/**
+ * Main KV provider interface
+ */
+export interface KVProvider {
+    /**
+     * Get a value by key
+     * @param key - The key to retrieve
+     * @param type - Optional type hint ('text', 'json', 'arrayBuffer', 'stream')
+     */
+    get<T = string>(key: string, type?: KVValueType): Promise<T | null>;
+    /**
+     * Set a value by key
+     * @param key - The key to set
+     * @param value - The value to store
+     * @param options - Optional storage options (TTL, metadata)
+     */
+    set(key: string, value: KVValue, options?: KVSetOptions): Promise<void>;
+    /**
+     * Delete a value by key
+     * @param key - The key to delete
+     */
+    delete(key: string): Promise<void>;
+    /**
+     * Delete multiple values by keys
+     * @param keys - Array of keys to delete
+     */
+    deleteMany(keys: string[]): Promise<void>;
+    /**
+     * Check if a key exists
+     * @param key - The key to check
+     */
+    has(key: string): Promise<boolean>;
+    /**
+     * List keys matching a prefix
+     * @param options - List options (prefix, limit, cursor)
+     */
+    list(options?: KVListOptions): Promise<KVListResult>;
+    /**
+     * Get metadata for a key without retrieving the value
+     * @param key - The key to get metadata for
+     */
+    getMetadata(key: string): Promise<KVMetadata | null>;
+    /**
+     * Increment a numeric value atomically
+     * @param key - The key to increment
+     * @param amount - Amount to increment by (default: 1)
+     */
+    increment?(key: string, amount?: number): Promise<number>;
+    /**
+     * Decrement a numeric value atomically
+     * @param key - The key to decrement
+     * @param amount - Amount to decrement by (default: 1)
+     */
+    decrement?(key: string, amount?: number): Promise<number>;
+}
+/**
+ * Value types supported by KV
+ */
+export type KVValueType = 'text' | 'json' | 'arrayBuffer' | 'stream';
+/**
+ * Values that can be stored in KV
+ */
+export type KVValue = string | ReadableStream | ArrayBuffer | object;
+/**
+ * Options for setting values
+ */
+export interface KVSetOptions {
+    /**
+     * Time-to-live in seconds (0 = never expire)
+     */
+    ttl?: number;
+    /**
+     * Expiration timestamp (Unix seconds)
+     */
+    expirationTtl?: number;
+    /**
+     * Metadata to attach to the key-value pair
+     */
+    metadata?: Record<string, any>;
+}
+/**
+ * Options for listing keys
+ */
+export interface KVListOptions {
+    /**
+     * Filter keys by prefix
+     */
+    prefix?: string;
+    /**
+     * Maximum number of keys to return
+     */
+    limit?: number;
+    /**
+     * Cursor for pagination
+     */
+    cursor?: string;
+}
+/**
+ * Result from listing keys
+ */
+export interface KVListResult {
+    /**
+     * Array of keys with optional metadata
+     */
+    keys: Array<{
+        name: string;
+        expiration?: number;
+        metadata?: Record<string, any>;
+    }>;
+    /**
+     * Whether the list is complete
+     */
+    complete: boolean;
+    /**
+     * Cursor for next page (if not complete)
+     */
+    cursor?: string;
+}
+/**
+ * Metadata associated with a key
+ */
+export interface KVMetadata {
+    /**
+     * Expiration timestamp (Unix seconds)
+     */
+    expiration?: number;
+    /**
+     * Custom metadata
+     */
+    metadata?: Record<string, any>;
+}
+/**
+ * Cloudflare environment interface for KV
+ */
+export interface CloudflareKVEnv {
+    KV: KVNamespace;
+    KV_PROVIDER?: 'cloudflare' | 'upstash' | 'vercel';
+    UPSTASH_REDIS_REST_URL?: string;
+    UPSTASH_REDIS_REST_TOKEN?: string;
+    VERCEL_KV_REST_URL?: string;
+    VERCEL_KV_REST_TOKEN?: string;
+}
+/**
+ * Request wrapper for NextRequest compatibility
+ */
+export interface KVRequest {
+    env: CloudflareKVEnv;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/edge/kv/types.d.ts.map

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

package/dist/edge/kv/types.js

@@ -0,0 +1,8 @@
+/**
+ * KV (Key-Value) storage abstraction types for edge runtime
+ *
+ * Provides a simple key-value store interface that can be implemented by various providers
+ * (Cloudflare KV, Upstash Redis, Vercel KV, etc.) allowing seamless upgrades as apps scale.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/edge/kv/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/edge/kv/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/edge/storage/index.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Edge Object Storage API
+ *
+ * Provides an S3-like object storage interface for user-generated apps.
+ * Automatically selects the appropriate provider based on environment configuration.
+ *
+ * @example
+ * ```typescript
+ * import { getStorage } from '@thewhateverapp/platform/edge';
+ *
+ * export async function POST(req: NextRequest) {
+ *   const storage = await getStorage(req);
+ *
+ *   // Upload a file
+ *   const file = await req.formData().get('file') as File;
+ *   const result = await storage.put(`uploads/${file.name}`, file, {
+ *     contentType: file.type
+ *   });
+ *
+ *   return NextResponse.json({ url: result.url });
+ * }
+ * ```
+ */
+import type { StorageProvider, CloudflareStorageEnv, StorageRequest } from './types';
+export type * from './types';
+/**
+ * Get a storage instance for the current request
+ *
+ * Automatically selects the appropriate provider based on environment:
+ * - 'r2' (default): Cloudflare R2
+ * - 's3': AWS S3
+ * - 'backblaze': Backblaze B2
+ *
+ * @param req - NextRequest or object with env property
+ * @returns Storage provider instance
+ */
+export declare function getStorage(req: StorageRequest | {
+    env: CloudflareStorageEnv;
+}): Promise<StorageProvider>;
+/**
+ * Create a storage instance directly (for advanced usage)
+ *
+ * @example
+ * ```typescript
+ * const storage = createStorage({ STORAGE: env.STORAGE });
+ * await storage.put('file.txt', 'Hello World');
+ * ```
+ */
+export declare function createStorage(env: CloudflareStorageEnv): StorageProvider;
+//# sourceMappingURL=index.d.ts.map

package/dist/edge/storage/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/edge/storage/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAIrF,mBAAmB,SAAS,CAAC;AAE7B;;;;;;;;;;GAUG;AACH,wBAAsB,UAAU,CAC9B,GAAG,EAAE,cAAc,GAAG;IAAE,GAAG,EAAE,oBAAoB,CAAA;CAAE,GAClD,OAAO,CAAC,eAAe,CAAC,CAqC1B;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,oBAAoB,GAAG,eAAe,CAexE"}