@thewhateverapp/platform 0.7.22 → 0.7.24

package/dist/ai/index.d.ts

@@ -6,9 +6,13 @@
  *
  * @example
  * ```typescript
- * import { getAI } from '@thewhateverapp/platform';
+ * import { getCloudflareContext } from '@opennextjs/cloudflare';
+ * import { configurePlatformEnv, getAI } from '@thewhateverapp/platform';
  *
  * export async function POST(req: NextRequest) {
+ *   // Configure env once per request
+ *   configurePlatformEnv(() => getCloudflareContext().env);
+ *
  *   const ai = await getAI();
  *
  *   // Simple text generation
@@ -38,7 +42,8 @@ export type * from './types';
  *
  * Automatically retrieves configuration from the environment.
  *
- * @param req - NextRequest, object with env property, or env object directly
+ * @param req - Optional: NextRequest, object with env property, or env object directly.
+ *              If not provided, uses the env configured via configurePlatformEnv().
  * @returns AI service provider instance
  */
 export declare function getAI(req?: AIRequest | {

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ai/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,OAAO,KAAK,EACV,iBAAiB,EACjB,SAAS,EACT,KAAK,EAIN,MAAM,SAAS,CAAC;AAGjB,mBAAmB,SAAS,CAAC;AAK7B;;;;;;;GAOG;AACH,wBAAsB,KAAK,CACzB,GAAG,CAAC,EAAE,SAAS,GAAG;IAAE,GAAG,EAAE,KAAK,CAAA;CAAE,GAAG,KAAK,GACvC,OAAO,CAAC,iBAAiB,CAAC,CAmD5B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,iBAAiB,CAGvF"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ai/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAEH,OAAO,KAAK,EACV,iBAAiB,EACjB,SAAS,EACT,KAAK,EAIN,MAAM,SAAS,CAAC;AAIjB,mBAAmB,SAAS,CAAC;AAK7B;;;;;;;;GAQG;AACH,wBAAsB,KAAK,CACzB,GAAG,CAAC,EAAE,SAAS,GAAG;IAAE,GAAG,EAAE,KAAK,CAAA;CAAE,GAAG,KAAK,GACvC,OAAO,CAAC,iBAAiB,CAAC,CAmC5B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,iBAAiB,CAGvF"}

package/dist/ai/index.js

@@ -6,9 +6,13 @@
  *
  * @example
  * ```typescript
- * import { getAI } from '@thewhateverapp/platform';
+ * import { getCloudflareContext } from '@opennextjs/cloudflare';
+ * import { configurePlatformEnv, getAI } from '@thewhateverapp/platform';
  *
  * export async function POST(req: NextRequest) {
+ *   // Configure env once per request
+ *   configurePlatformEnv(() => getCloudflareContext().env);
+ *
  *   const ai = await getAI();
  *
  *   // Simple text generation
@@ -31,6 +35,7 @@
  * }
  * ```
  */
+import { getPlatformEnv, isPlatformEnvConfigured } from '../env';
 // Default platform API URL
 const DEFAULT_PLATFORM_API = 'https://api.thewhatever.app';
 /**
@@ -38,34 +43,19 @@ const DEFAULT_PLATFORM_API = 'https://api.thewhatever.app';
  *
  * Automatically retrieves configuration from the environment.
  *
- * @param req - NextRequest, object with env property, or env object directly
+ * @param req - Optional: NextRequest, object with env property, or env object directly.
+ *              If not provided, uses the env configured via configurePlatformEnv().
  * @returns AI service provider instance
  */
 export async function getAI(req) {
     let env;
-    // If no argument provided, try to get context from OpenNext
+    // If no argument provided, use the configured env provider
     if (!req) {
-        try {
-            // Import getCloudflareContext from @opennextjs/cloudflare
-            // This is available in OpenNext apps running on Cloudflare Workers
-            // @ts-ignore - dynamic import, only available at runtime in OpenNext apps
-            const { getCloudflareContext } = await import('@opennextjs/cloudflare');
-            // Try sync first (works in production worker context)
-            let context;
-            try {
-                context = getCloudflareContext();
-            }
-            catch {
-                // Fall back to async if sync fails (e.g., during SSG or Node.js context)
-                context = await getCloudflareContext({ async: true });
-            }
-            env = context.env;
-        }
-        catch (error) {
-            const errMsg = error instanceof Error ? error.message : String(error);
-            throw new Error(`getAI() failed: ${errMsg}. ` +
-                'In API routes, you can pass env directly: getAI({ env: getCloudflareContext().env })');
+        if (!isPlatformEnvConfigured()) {
+            throw new Error('getAI() called without env and configurePlatformEnv() was not called. ' +
+                'Either pass env directly: getAI({ env }) or call configurePlatformEnv(() => getCloudflareContext().env) first.');
         }
+        env = getPlatformEnv();
     }
     else if ('env' in req) {
         env = req.env;

package/dist/ai/index.js.map

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

package/dist/database/index.d.ts

@@ -6,10 +6,14 @@
  *
  * @example
  * ```typescript
- * import { getDatabase } from '@thewhateverapp/platform';
+ * import { getCloudflareContext } from '@opennextjs/cloudflare';
+ * import { configurePlatformEnv, getDatabase } from '@thewhateverapp/platform';
  *
  * export async function GET(req: NextRequest) {
- *   const db = await getDatabase(req);
+ *   // Configure env once per request
+ *   configurePlatformEnv(() => getCloudflareContext().env);
+ *
+ *   const db = await getDatabase();
  *   const todos = db.collection('todos');
  *   const result = await todos.find({ completed: false });
  *   return NextResponse.json(result);
@@ -27,7 +31,8 @@ export type * from './types';
  * - 'mongo-atlas': MongoDB Atlas for complex queries
  * - 'planetscale': PlanetScale for relational needs
  *
- * @param req - NextRequest, object with env property, or env object directly
+ * @param req - Optional: NextRequest, object with env property, or env object directly.
+ *              If not provided, uses the env configured via configurePlatformEnv().
  * @returns Database provider instance
  */
 export declare function getDatabase(req?: DatabaseRequest | {

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/database/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAIhF,mBAAmB,SAAS,CAAC;AAE7B;;;;;;;;;;;GAWG;AACH,wBAAsB,WAAW,CAC/B,GAAG,CAAC,EAAE,eAAe,GAAG;IAAE,GAAG,EAAE,aAAa,CAAA;CAAE,GAAG,aAAa,GAC7D,OAAO,CAAC,gBAAgB,CAAC,CAsF3B;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,aAAa,GAAG,gBAAgB,CAenE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/database/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAKhF,mBAAmB,SAAS,CAAC;AAE7B;;;;;;;;;;;;GAYG;AACH,wBAAsB,WAAW,CAC/B,GAAG,CAAC,EAAE,eAAe,GAAG;IAAE,GAAG,EAAE,aAAa,CAAA;CAAE,GAAG,aAAa,GAC7D,OAAO,CAAC,gBAAgB,CAAC,CA6D3B;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,aAAa,GAAG,gBAAgB,CAenE"}

package/dist/database/index.js

@@ -6,10 +6,14 @@
  *
  * @example
  * ```typescript
- * import { getDatabase } from '@thewhateverapp/platform';
+ * import { getCloudflareContext } from '@opennextjs/cloudflare';
+ * import { configurePlatformEnv, getDatabase } from '@thewhateverapp/platform';
  *
  * export async function GET(req: NextRequest) {
- *   const db = await getDatabase(req);
+ *   // Configure env once per request
+ *   configurePlatformEnv(() => getCloudflareContext().env);
+ *
+ *   const db = await getDatabase();
  *   const todos = db.collection('todos');
  *   const result = await todos.find({ completed: false });
  *   return NextResponse.json(result);
@@ -17,6 +21,7 @@
  * ```
  */
 import { FlexDB } from './providers';
+import { getPlatformEnv, isPlatformEnvConfigured } from '../env';
 /**
  * Get a database instance for the current request
  *
@@ -26,40 +31,19 @@ import { FlexDB } from './providers';
  * - 'mongo-atlas': MongoDB Atlas for complex queries
  * - 'planetscale': PlanetScale for relational needs
  *
- * @param req - NextRequest, object with env property, or env object directly
+ * @param req - Optional: NextRequest, object with env property, or env object directly.
+ *              If not provided, uses the env configured via configurePlatformEnv().
  * @returns Database provider instance
  */
 export async function getDatabase(req) {
     let env;
-    // If no argument provided, try to get context from OpenNext
+    // If no argument provided, use the configured env provider
     if (!req) {
-        try {
-            // Import getCloudflareContext from @opennextjs/cloudflare
-            // This is available in OpenNext apps running on Cloudflare Workers
-            // @ts-ignore - dynamic import, only available at runtime in OpenNext apps
-            const { getCloudflareContext } = await import('@opennextjs/cloudflare');
-            // Try sync first (works in production worker context)
-            let context;
-            try {
-                context = getCloudflareContext();
-            }
-            catch {
-                // Fall back to async if sync fails (e.g., during SSG or Node.js context)
-                context = await getCloudflareContext({ async: true });
-            }
-            env = context.env;
-            // Validate that DB is actually a D1Database with expected methods
-            if (env.DB && typeof env.DB.exec !== 'function') {
-                console.error('[Platform SDK] env.DB exists but is not a valid D1Database:', typeof env.DB);
-                throw new Error(`DB binding exists but is not a valid D1Database. Got type: ${typeof env.DB}. ` +
-                    'This may be a configuration issue with OpenNext or wrangler.json bindings.');
-            }
-        }
-        catch (error) {
-            const errMsg = error instanceof Error ? error.message : String(error);
-            throw new Error(`getDatabase() failed: ${errMsg}. ` +
-                'In API routes, you can pass env directly: getDatabase({ env: getCloudflareContext().env })');
+        if (!isPlatformEnvConfigured()) {
+            throw new Error('getDatabase() called without env and configurePlatformEnv() was not called. ' +
+                'Either pass env directly: getDatabase({ env }) or call configurePlatformEnv(() => getCloudflareContext().env) first.');
         }
+        env = getPlatformEnv();
     }
     else if ('env' in req) {
         env = req.env;

package/dist/database/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/database/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAGH,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAKrC;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,GAA8D;IAE9D,IAAI,GAA8B,CAAC;IAEnC,4DAA4D;IAC5D,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,IAAI,CAAC;YACH,0DAA0D;YAC1D,mEAAmE;YACnE,0EAA0E;YAC1E,MAAM,EAAE,oBAAoB,EAAE,GAAG,MAAM,MAAM,CAAC,wBAAwB,CAAC,CAAC;YAExE,sDAAsD;YACtD,IAAI,OAA2C,CAAC;YAChD,IAAI,CAAC;gBACH,OAAO,GAAI,oBAAqD,EAAE,CAAC;YACrE,CAAC;YAAC,MAAM,CAAC;gBACP,yEAAyE;gBACzE,OAAO,GAAG,MAAO,oBAAmF,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YACxH,CAAC;YAED,GAAG,GAAG,OAAO,CAAC,GAAoB,CAAC;YAEnC,kEAAkE;YAClE,IAAI,GAAG,CAAC,EAAE,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;gBAChD,OAAO,CAAC,KAAK,CAAC,6DAA6D,EAAE,OAAO,GAAG,CAAC,EAAE,CAAC,CAAC;gBAC5F,MAAM,IAAI,KAAK,CACb,8DAA8D,OAAO,GAAG,CAAC,EAAE,IAAI;oBAC/E,4EAA4E,CAC7E,CAAC;YACJ,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,MAAM,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACtE,MAAM,IAAI,KAAK,CACb,yBAAyB,MAAM,IAAI;gBACnC,4FAA4F,CAC7F,CAAC;QACJ,CAAC;IACH,CAAC;SAAM,IAAI,KAAK,IAAI,GAAG,EAAE,CAAC;QACxB,GAAG,GAAG,GAAG,CAAC,GAAG,CAAC;IAChB,CAAC;SAAM,IAAI,IAAI,IAAI,GAAG,EAAE,CAAC;QACvB,oBAAoB;QACpB,GAAG,GAAG,GAAoB,CAAC;IAC7B,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,EAAE,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CACb,2FAA2F,CAC5F,CAAC;IACJ,CAAC;IAED,qDAAqD;IACrD,MAAM,QAAQ,GAAG,GAAG,CAAC,WAAW,IAAI,MAAM,CAAC;IAE3C,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,MAAM;YACT,OAAO,IAAI,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAE5B,KAAK,OAAO;YACV,iCAAiC;YACjC,MAAM,IAAI,KAAK,CACb,mFAAmF,CACpF,CAAC;QAEJ,KAAK,aAAa;YAChB,uCAAuC;YACvC,MAAM,IAAI,KAAK,CACb,yFAAyF,CAC1F,CAAC;QAEJ,KAAK,aAAa;YAChB,qCAAqC;YACrC,MAAM,IAAI,KAAK,CACb,uFAAuF,CACxF,CAAC;QAEJ;YACE,OAAO,CAAC,IAAI,CAAC,wBAAwB,QAAQ,2BAA2B,CAAC,CAAC;YAC1E,OAAO,IAAI,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC9B,CAAC;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,cAAc,CAAC,GAAkB;IAC/C,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;IACnD,CAAC;IAED,MAAM,QAAQ,GAAG,GAAG,CAAC,WAAW,IAAI,MAAM,CAAC;IAE3C,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,MAAM;YACT,OAAO,IAAI,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAE5B;YACE,OAAO,CAAC,IAAI,CAAC,wBAAwB,QAAQ,2BAA2B,CAAC,CAAC;YAC1E,OAAO,IAAI,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC9B,CAAC;AACH,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/database/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAGH,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,cAAc,EAAE,uBAAuB,EAAE,MAAM,QAAQ,CAAC;AAKjE;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,GAA8D;IAE9D,IAAI,GAA8B,CAAC;IAEnC,2DAA2D;IAC3D,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,IAAI,CAAC,uBAAuB,EAAE,EAAE,CAAC;YAC/B,MAAM,IAAI,KAAK,CACb,8EAA8E;gBAC5E,sHAAsH,CACzH,CAAC;QACJ,CAAC;QACD,GAAG,GAAG,cAAc,EAAmB,CAAC;IAC1C,CAAC;SAAM,IAAI,KAAK,IAAI,GAAG,EAAE,CAAC;QACxB,GAAG,GAAG,GAAG,CAAC,GAAG,CAAC;IAChB,CAAC;SAAM,IAAI,IAAI,IAAI,GAAG,EAAE,CAAC;QACvB,oBAAoB;QACpB,GAAG,GAAG,GAAoB,CAAC;IAC7B,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,EAAE,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CACb,2FAA2F,CAC5F,CAAC;IACJ,CAAC;IAED,qDAAqD;IACrD,MAAM,QAAQ,GAAG,GAAG,CAAC,WAAW,IAAI,MAAM,CAAC;IAE3C,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,MAAM;YACT,OAAO,IAAI,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAE5B,KAAK,OAAO;YACV,iCAAiC;YACjC,MAAM,IAAI,KAAK,CACb,mFAAmF,CACpF,CAAC;QAEJ,KAAK,aAAa;YAChB,uCAAuC;YACvC,MAAM,IAAI,KAAK,CACb,yFAAyF,CAC1F,CAAC;QAEJ,KAAK,aAAa;YAChB,qCAAqC;YACrC,MAAM,IAAI,KAAK,CACb,uFAAuF,CACxF,CAAC;QAEJ;YACE,OAAO,CAAC,IAAI,CAAC,wBAAwB,QAAQ,2BAA2B,CAAC,CAAC;YAC1E,OAAO,IAAI,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC9B,CAAC;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,cAAc,CAAC,GAAkB;IAC/C,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;IACnD,CAAC;IAED,MAAM,QAAQ,GAAG,GAAG,CAAC,WAAW,IAAI,MAAM,CAAC;IAE3C,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,MAAM;YACT,OAAO,IAAI,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAE5B;YACE,OAAO,CAAC,IAAI,CAAC,wBAAwB,QAAQ,2BAA2B,CAAC,CAAC;YAC1E,OAAO,IAAI,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC9B,CAAC;AACH,CAAC"}

package/dist/env.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Environment Provider for Platform SDK
+ *
+ * This module provides a dependency injection mechanism for accessing
+ * Cloudflare bindings (KV, R2, D1, etc.) without the SDK needing to
+ * import @opennextjs/cloudflare directly.
+ *
+ * @example
+ * ```typescript
+ * // In your OpenNext app (e.g., layout.tsx or API route)
+ * import { getCloudflareContext } from '@opennextjs/cloudflare';
+ * import { configurePlatformEnv } from '@thewhateverapp/platform';
+ *
+ * // Configure once per request
+ * configurePlatformEnv(() => getCloudflareContext().env);
+ *
+ * // Then use SDK functions normally
+ * const kv = await getKV();
+ * ```
+ */
+export interface PlatformEnv {
+    KV?: KVNamespace;
+    DB?: D1Database;
+    STORAGE?: R2Bucket;
+    STORAGE_PUBLIC_URL?: string;
+    DB_PROVIDER?: string;
+    KV_PROVIDER?: string;
+    STORAGE_PROVIDER?: string;
+    API_KEY?: string;
+    APP_ID?: string;
+    PLATFORM_API_URL?: string;
+    [key: string]: unknown;
+}
+type EnvProvider = () => PlatformEnv;
+/**
+ * Configure the SDK's environment provider.
+ *
+ * Call this at the start of each request handler to wire in the
+ * Cloudflare context from OpenNext.
+ *
+ * @example
+ * ```typescript
+ * import { getCloudflareContext } from '@opennextjs/cloudflare';
+ * import { configurePlatformEnv } from '@thewhateverapp/platform';
+ *
+ * export async function POST(req: Request) {
+ *   configurePlatformEnv(() => getCloudflareContext().env);
+ *   // ... rest of handler
+ * }
+ * ```
+ */
+export declare function configurePlatformEnv(provider: EnvProvider): void;
+/**
+ * Get the current environment.
+ *
+ * @throws Error if configurePlatformEnv() hasn't been called
+ */
+export declare function getPlatformEnv(): PlatformEnv;
+/**
+ * Check if the environment provider has been configured.
+ */
+export declare function isPlatformEnvConfigured(): boolean;
+/**
+ * Reset the environment provider (mainly for testing).
+ */
+export declare function resetPlatformEnv(): void;
+export {};
+//# sourceMappingURL=env.d.ts.map

package/dist/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,MAAM,WAAW,WAAW;IAC1B,EAAE,CAAC,EAAE,WAAW,CAAC;IACjB,EAAE,CAAC,EAAE,UAAU,CAAC;IAChB,OAAO,CAAC,EAAE,QAAQ,CAAC;IACnB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,KAAK,WAAW,GAAG,MAAM,WAAW,CAAC;AAIrC;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,WAAW,GAAG,IAAI,CAEhE;AAED;;;;GAIG;AACH,wBAAgB,cAAc,IAAI,WAAW,CAQ5C;AAED;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,OAAO,CAEjD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAEvC"}

package/dist/env.js

@@ -0,0 +1,66 @@
+/**
+ * Environment Provider for Platform SDK
+ *
+ * This module provides a dependency injection mechanism for accessing
+ * Cloudflare bindings (KV, R2, D1, etc.) without the SDK needing to
+ * import @opennextjs/cloudflare directly.
+ *
+ * @example
+ * ```typescript
+ * // In your OpenNext app (e.g., layout.tsx or API route)
+ * import { getCloudflareContext } from '@opennextjs/cloudflare';
+ * import { configurePlatformEnv } from '@thewhateverapp/platform';
+ *
+ * // Configure once per request
+ * configurePlatformEnv(() => getCloudflareContext().env);
+ *
+ * // Then use SDK functions normally
+ * const kv = await getKV();
+ * ```
+ */
+let envProvider = null;
+/**
+ * Configure the SDK's environment provider.
+ *
+ * Call this at the start of each request handler to wire in the
+ * Cloudflare context from OpenNext.
+ *
+ * @example
+ * ```typescript
+ * import { getCloudflareContext } from '@opennextjs/cloudflare';
+ * import { configurePlatformEnv } from '@thewhateverapp/platform';
+ *
+ * export async function POST(req: Request) {
+ *   configurePlatformEnv(() => getCloudflareContext().env);
+ *   // ... rest of handler
+ * }
+ * ```
+ */
+export function configurePlatformEnv(provider) {
+    envProvider = provider;
+}
+/**
+ * Get the current environment.
+ *
+ * @throws Error if configurePlatformEnv() hasn't been called
+ */
+export function getPlatformEnv() {
+    if (!envProvider) {
+        throw new Error('Platform SDK env not configured. ' +
+            'Call configurePlatformEnv(() => getCloudflareContext().env) at the start of your request handler.');
+    }
+    return envProvider();
+}
+/**
+ * Check if the environment provider has been configured.
+ */
+export function isPlatformEnvConfigured() {
+    return envProvider !== null;
+}
+/**
+ * Reset the environment provider (mainly for testing).
+ */
+export function resetPlatformEnv() {
+    envProvider = null;
+}
+//# sourceMappingURL=env.js.map

package/dist/env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAkBH,IAAI,WAAW,GAAuB,IAAI,CAAC;AAE3C;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,oBAAoB,CAAC,QAAqB;IACxD,WAAW,GAAG,QAAQ,CAAC;AACzB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc;IAC5B,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CACb,mCAAmC;YACjC,mGAAmG,CACtG,CAAC;IACJ,CAAC;IACD,OAAO,WAAW,EAAE,CAAC;AACvB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB;IACrC,OAAO,WAAW,KAAK,IAAI,CAAC;AAC9B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB;IAC9B,WAAW,GAAG,IAAI,CAAC;AACrB,CAAC"}

package/dist/index.d.ts

@@ -6,10 +6,14 @@
  * ## Quick Start (for tiles/apps)
  *
  * ```typescript
- * import { getDatabase, getKV, getAI, getStorage } from '@thewhateverapp/platform';
+ * import { getCloudflareContext } from '@opennextjs/cloudflare';
+ * import { configurePlatformEnv, getDatabase, getKV, getAI } from '@thewhateverapp/platform';
  *
  * // In your API route
  * export async function POST(req: NextRequest) {
+ *   // Configure env once at the start of each request
+ *   configurePlatformEnv(() => getCloudflareContext().env);
+ *
  *   const db = await getDatabase();
  *   const ai = await getAI();
  *
@@ -20,6 +24,8 @@
  * }
  * ```
  */
+export { configurePlatformEnv, getPlatformEnv, isPlatformEnvConfigured, resetPlatformEnv, } from './env';
+export type { PlatformEnv } from './env';
 export { createPlatform, WhateverPlatform } from './platform';
 export type * from './types';
 export { getDatabase, createDatabase } from './database';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAGH,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAG9D,mBAAmB,SAAS,CAAC;AAO7B,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACzD,YAAY,EACV,gBAAgB,EAChB,UAAU,EACV,KAAK,EACL,MAAM,EACN,WAAW,EACX,eAAe,EACf,gBAAgB,EAChB,YAAY,EACZ,YAAY,GACb,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AACvC,YAAY,EACV,UAAU,EACV,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,WAAW,EACX,OAAO,EACP,UAAU,GACX,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,MAAM,CAAC;AACjD,YAAY,EACV,eAAe,EACf,aAAa,EACb,eAAe,EACf,WAAW,IAAI,kBAAkB,EACjC,UAAU,IAAI,iBAAiB,EAC/B,UAAU,IAAI,iBAAiB,EAC/B,SAAS,IAAI,gBAAgB,EAC7B,UAAU,IAAI,iBAAiB,GAChC,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AACvC,YAAY,EACV,iBAAiB,EACjB,UAAU,EACV,YAAY,EACZ,UAAU,EACV,aAAa,EACb,cAAc,EACd,UAAU,GACX,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,YAAY,EACV,iBAAiB,EACjB,OAAO,EACP,MAAM,GACP,MAAM,oBAAoB,CAAC;AAM5B,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACnC,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACnC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAGH,OAAO,EACL,oBAAoB,EACpB,cAAc,EACd,uBAAuB,EACvB,gBAAgB,GACjB,MAAM,OAAO,CAAC;AACf,YAAY,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AAGzC,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAG9D,mBAAmB,SAAS,CAAC;AAO7B,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACzD,YAAY,EACV,gBAAgB,EAChB,UAAU,EACV,KAAK,EACL,MAAM,EACN,WAAW,EACX,eAAe,EACf,gBAAgB,EAChB,YAAY,EACZ,YAAY,GACb,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AACvC,YAAY,EACV,UAAU,EACV,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,WAAW,EACX,OAAO,EACP,UAAU,GACX,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,MAAM,CAAC;AACjD,YAAY,EACV,eAAe,EACf,aAAa,EACb,eAAe,EACf,WAAW,IAAI,kBAAkB,EACjC,UAAU,IAAI,iBAAiB,EAC/B,UAAU,IAAI,iBAAiB,EAC/B,SAAS,IAAI,gBAAgB,EAC7B,UAAU,IAAI,iBAAiB,GAChC,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AACvC,YAAY,EACV,iBAAiB,EACjB,UAAU,EACV,YAAY,EACZ,UAAU,EACV,aAAa,EACb,cAAc,EACd,UAAU,GACX,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,YAAY,EACV,iBAAiB,EACjB,OAAO,EACP,MAAM,GACP,MAAM,oBAAoB,CAAC;AAM5B,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACnC,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACnC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -6,10 +6,14 @@
  * ## Quick Start (for tiles/apps)
  *
  * ```typescript
- * import { getDatabase, getKV, getAI, getStorage } from '@thewhateverapp/platform';
+ * import { getCloudflareContext } from '@opennextjs/cloudflare';
+ * import { configurePlatformEnv, getDatabase, getKV, getAI } from '@thewhateverapp/platform';
  *
  * // In your API route
  * export async function POST(req: NextRequest) {
+ *   // Configure env once at the start of each request
+ *   configurePlatformEnv(() => getCloudflareContext().env);
+ *
  *   const db = await getDatabase();
  *   const ai = await getAI();
  *
@@ -20,6 +24,8 @@
  * }
  * ```
  */
+// Environment configuration (must be called before using SDK in OpenNext)
+export { configurePlatformEnv, getPlatformEnv, isPlatformEnvConfigured, resetPlatformEnv, } from './env';
 // Main exports
 export { createPlatform, WhateverPlatform } from './platform';
 // =============================================================================

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,eAAe;AACf,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAK9D,gFAAgF;AAChF,mEAAmE;AACnE,gFAAgF;AAEhF,mDAAmD;AACnD,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAazD,yCAAyC;AACzC,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AAWvC,gCAAgC;AAChC,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,MAAM,CAAC;AAYjD,6DAA6D;AAC7D,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AAWvC,mDAAmD;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAO5C,gFAAgF;AAChF,mDAAmD;AACnD,gFAAgF;AAEhF,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACnC,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACnC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,0EAA0E;AAC1E,OAAO,EACL,oBAAoB,EACpB,cAAc,EACd,uBAAuB,EACvB,gBAAgB,GACjB,MAAM,OAAO,CAAC;AAGf,eAAe;AACf,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAK9D,gFAAgF;AAChF,mEAAmE;AACnE,gFAAgF;AAEhF,mDAAmD;AACnD,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAazD,yCAAyC;AACzC,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AAWvC,gCAAgC;AAChC,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,MAAM,CAAC;AAYjD,6DAA6D;AAC7D,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AAWvC,mDAAmD;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAO5C,gFAAgF;AAChF,mDAAmD;AACnD,gFAAgF;AAEhF,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACnC,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACnC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/kv/index.d.ts

@@ -6,10 +6,14 @@
  *
  * @example
  * ```typescript
- * import { getKV } from '@thewhateverapp/platform';
+ * import { getCloudflareContext } from '@opennextjs/cloudflare';
+ * import { configurePlatformEnv, getKV } from '@thewhateverapp/platform';
  *
  * export async function GET(req: NextRequest) {
- *   const kv = await getKV(req);
+ *   // Configure env once per request
+ *   configurePlatformEnv(() => getCloudflareContext().env);
+ *
+ *   const kv = await getKV();
  *
  *   // Store data
  *   await kv.set('user:123', { name: 'Alice', score: 100 });
@@ -31,7 +35,8 @@ export type * from './types';
  * - 'upstash': Upstash Redis
  * - 'vercel': Vercel KV
  *
- * @param req - NextRequest, object with env property, or env object directly
+ * @param req - Optional: NextRequest, object with env property, or env object directly.
+ *              If not provided, uses the env configured via configurePlatformEnv().
  * @returns KV provider instance
  */
 export declare function getKV(req?: KVRequest | {

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/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,CAAC,EAAE,SAAS,GAAG;IAAE,GAAG,EAAE,eAAe,CAAA;CAAE,GAAG,eAAe,GAAG,OAAO,CAAC,UAAU,CAAC,CAgF7G;AAED;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,eAAe,GAAG,UAAU,CAezD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/kv/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAKtE,mBAAmB,SAAS,CAAC;AAE7B;;;;;;;;;;;GAWG;AACH,wBAAsB,KAAK,CAAC,GAAG,CAAC,EAAE,SAAS,GAAG;IAAE,GAAG,EAAE,eAAe,CAAA;CAAE,GAAG,eAAe,GAAG,OAAO,CAAC,UAAU,CAAC,CAuD7G;AAED;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,eAAe,GAAG,UAAU,CAezD"}

package/dist/kv/index.js

@@ -6,10 +6,14 @@
  *
  * @example
  * ```typescript
- * import { getKV } from '@thewhateverapp/platform';
+ * import { getCloudflareContext } from '@opennextjs/cloudflare';
+ * import { configurePlatformEnv, getKV } from '@thewhateverapp/platform';
  *
  * export async function GET(req: NextRequest) {
- *   const kv = await getKV(req);
+ *   // Configure env once per request
+ *   configurePlatformEnv(() => getCloudflareContext().env);
+ *
+ *   const kv = await getKV();
  *
  *   // Store data
  *   await kv.set('user:123', { name: 'Alice', score: 100 });
@@ -22,6 +26,7 @@
  * ```
  */
 import { CloudflareKV } from './providers';
+import { getPlatformEnv, isPlatformEnvConfigured } from '../env';
 /**
  * Get a KV instance for the current request
  *
@@ -30,40 +35,19 @@ import { CloudflareKV } from './providers';
  * - 'upstash': Upstash Redis
  * - 'vercel': Vercel KV
  *
- * @param req - NextRequest, object with env property, or env object directly
+ * @param req - Optional: NextRequest, object with env property, or env object directly.
+ *              If not provided, uses the env configured via configurePlatformEnv().
  * @returns KV provider instance
  */
 export async function getKV(req) {
     let env;
-    // If no argument provided, try to get context from OpenNext
+    // If no argument provided, use the configured env provider
     if (!req) {
-        try {
-            // Import getCloudflareContext from @opennextjs/cloudflare
-            // This is available in OpenNext apps running on Cloudflare Workers
-            // @ts-ignore - dynamic import, only available at runtime in OpenNext apps
-            const { getCloudflareContext } = await import('@opennextjs/cloudflare');
-            // Try sync first (works in production worker context)
-            let context;
-            try {
-                context = getCloudflareContext();
-            }
-            catch {
-                // Fall back to async if sync fails (e.g., during SSG or Node.js context)
-                context = await getCloudflareContext({ async: true });
-            }
-            env = context.env;
-            // Validate that KV is actually a KVNamespace with expected methods
-            if (env.KV && typeof env.KV.put !== 'function') {
-                console.error('[Platform SDK] env.KV exists but is not a valid KVNamespace:', typeof env.KV, env.KV);
-                throw new Error(`KV binding exists but is not a valid KVNamespace. Got type: ${typeof env.KV}. ` +
-                    'This may be a configuration issue with OpenNext or wrangler.json bindings.');
-            }
-        }
-        catch (error) {
-            const errMsg = error instanceof Error ? error.message : String(error);
-            throw new Error(`getKV() failed: ${errMsg}. ` +
-                'In API routes, you can pass env directly: getKV({ env: getCloudflareContext().env })');
+        if (!isPlatformEnvConfigured()) {
+            throw new Error('getKV() called without env and configurePlatformEnv() was not called. ' +
+                'Either pass env directly: getKV({ env }) or call configurePlatformEnv(() => getCloudflareContext().env) first.');
         }
+        env = getPlatformEnv();
     }
     else if ('env' in req) {
         env = req.env;

package/dist/kv/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/kv/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/kv/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,CAAC,KAAK,UAAU,KAAK,CAAC,GAA4D;IACtF,IAAI,GAAgC,CAAC;IAErC,2DAA2D;IAC3D,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,IAAI,CAAC,uBAAuB,EAAE,EAAE,CAAC;YAC/B,MAAM,IAAI,KAAK,CACb,wEAAwE;gBACtE,gHAAgH,CACnH,CAAC;QACJ,CAAC;QACD,GAAG,GAAG,cAAc,EAAqB,CAAC;IAC5C,CAAC;SAAM,IAAI,KAAK,IAAI,GAAG,EAAE,CAAC;QACxB,GAAG,GAAG,GAAG,CAAC,GAAG,CAAC;IAChB,CAAC;SAAM,IAAI,IAAI,IAAI,GAAG,EAAE,CAAC;QACvB,oBAAoB;QACpB,GAAG,GAAG,GAAsB,CAAC;IAC/B,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,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/kv/providers/cloudflare-kv.d.ts

@@ -11,7 +11,7 @@ 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>;
+    put(key: string, value: KVValue, options?: KVSetOptions): Promise<void>;
     delete(key: string): Promise<void>;
     deleteMany(keys: string[]): Promise<void>;
     has(key: string): Promise<boolean>;

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

@@ -25,7 +25,7 @@ export class CloudflareKV {
                 return (await this.kv.get(key, 'text'));
         }
     }
-    async set(key, value, options) {
+    async put(key, value, options) {
         const kvOptions = {};
         if (options?.ttl) {
             kvOptions.expirationTtl = options.ttl;
@@ -101,7 +101,7 @@ export class CloudflareKV {
         const current = await this.get(key, 'text');
         const currentValue = current ? parseInt(current, 10) : 0;
         const newValue = currentValue + amount;
-        await this.set(key, String(newValue));
+        await this.put(key, String(newValue));
         return newValue;
     }
     /**

package/dist/kv/types.d.ts

@@ -15,12 +15,12 @@ export interface KVProvider {
      */
     get<T = string>(key: string, type?: KVValueType): Promise<T | null>;
     /**
-     * Set a value by key
-     * @param key - The key to set
+     * Store a value by key (matches Cloudflare's native KV API)
+     * @param key - The key to store
      * @param value - The value to store
      * @param options - Optional storage options (TTL, metadata)
      */
-    set(key: string, value: KVValue, options?: KVSetOptions): Promise<void>;
+    put(key: string, value: KVValue, options?: KVSetOptions): Promise<void>;
     /**
      * Delete a value by key
      * @param key - The key to delete

package/dist/r2/index.d.ts

@@ -6,10 +6,14 @@
  *
  * @example
  * ```typescript
- * import { getStorage } from '@thewhateverapp/platform';
+ * import { getCloudflareContext } from '@opennextjs/cloudflare';
+ * import { configurePlatformEnv, getStorage } from '@thewhateverapp/platform';
  *
  * export async function POST(req: NextRequest) {
- *   const storage = await getStorage(req);
+ *   // Configure env once per request
+ *   configurePlatformEnv(() => getCloudflareContext().env);
+ *
+ *   const storage = await getStorage();
  *
  *   // Upload a file
  *   const file = await req.formData().get('file') as File;
@@ -31,7 +35,8 @@ export type * from './types';
  * - 's3': AWS S3
  * - 'backblaze': Backblaze B2
  *
- * @param req - NextRequest, object with env property, or env object directly
+ * @param req - Optional: NextRequest, object with env property, or env object directly.
+ *              If not provided, uses the env configured via configurePlatformEnv().
  * @returns Storage provider instance
  */
 export declare function getStorage(req?: StorageRequest | {

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/r2/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,CAAC,EAAE,cAAc,GAAG;IAAE,GAAG,EAAE,oBAAoB,CAAA;CAAE,GAAG,oBAAoB,GAC1E,OAAO,CAAC,eAAe,CAAC,CAgF1B;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,wBAAsB,UAAU,CAC9B,GAAG,CAAC,EAAE,cAAc,GAAG;IAAE,GAAG,EAAE,oBAAoB,CAAA;CAAE,GAAG,oBAAoB,GAC1E,OAAO,CAAC,eAAe,CAAC,CAuD1B;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,oBAAoB,GAAG,eAAe,CAexE"}

package/dist/r2/index.js

@@ -6,10 +6,14 @@
  *
  * @example
  * ```typescript
- * import { getStorage } from '@thewhateverapp/platform';
+ * import { getCloudflareContext } from '@opennextjs/cloudflare';
+ * import { configurePlatformEnv, getStorage } from '@thewhateverapp/platform';
  *
  * export async function POST(req: NextRequest) {
- *   const storage = await getStorage(req);
+ *   // Configure env once per request
+ *   configurePlatformEnv(() => getCloudflareContext().env);
+ *
+ *   const storage = await getStorage();
  *
  *   // Upload a file
  *   const file = await req.formData().get('file') as File;
@@ -22,6 +26,7 @@
  * ```
  */
 import { CloudflareR2 } from './providers';
+import { getPlatformEnv, isPlatformEnvConfigured } from '../env';
 /**
  * Get a storage instance for the current request
  *
@@ -30,40 +35,19 @@ import { CloudflareR2 } from './providers';
  * - 's3': AWS S3
  * - 'backblaze': Backblaze B2
  *
- * @param req - NextRequest, object with env property, or env object directly
+ * @param req - Optional: NextRequest, object with env property, or env object directly.
+ *              If not provided, uses the env configured via configurePlatformEnv().
  * @returns Storage provider instance
  */
 export async function getStorage(req) {
     let env;
-    // If no argument provided, try to get context from OpenNext
+    // If no argument provided, use the configured env provider
     if (!req) {
-        try {
-            // Import getCloudflareContext from @opennextjs/cloudflare
-            // This is available in OpenNext apps running on Cloudflare Workers
-            // @ts-ignore - dynamic import, only available at runtime in OpenNext apps
-            const { getCloudflareContext } = await import('@opennextjs/cloudflare');
-            // Try sync first (works in production worker context)
-            let context;
-            try {
-                context = getCloudflareContext();
-            }
-            catch {
-                // Fall back to async if sync fails (e.g., during SSG or Node.js context)
-                context = await getCloudflareContext({ async: true });
-            }
-            env = context.env;
-            // Validate that STORAGE is actually an R2Bucket with expected methods
-            if (env.STORAGE && typeof env.STORAGE.put !== 'function') {
-                console.error('[Platform SDK] env.STORAGE exists but is not a valid R2Bucket:', typeof env.STORAGE);
-                throw new Error(`STORAGE binding exists but is not a valid R2Bucket. Got type: ${typeof env.STORAGE}. ` +
-                    'This may be a configuration issue with OpenNext or wrangler.json bindings.');
-            }
-        }
-        catch (error) {
-            const errMsg = error instanceof Error ? error.message : String(error);
-            throw new Error(`getStorage() failed: ${errMsg}. ` +
-                'In API routes, you can pass env directly: getStorage({ env: getCloudflareContext().env })');
+        if (!isPlatformEnvConfigured()) {
+            throw new Error('getStorage() called without env and configurePlatformEnv() was not called. ' +
+                'Either pass env directly: getStorage({ env }) or call configurePlatformEnv(() => getCloudflareContext().env) first.');
         }
+        env = getPlatformEnv();
     }
     else if ('env' in req) {
         env = req.env;

package/dist/r2/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/r2/index.ts"],"names":[],"mappings":"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"}
+{"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,CAAC,KAAK,UAAU,UAAU,CAC9B,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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thewhateverapp/platform",
-  "version": "0.7.22",
+  "version": "0.7.24",
   "description": "Universal SDK for The Whatever App platform services",
   "type": "module",
   "main": "./dist/index.js",
@@ -53,6 +53,12 @@
     "typescript": "^5.7.3"
   },
   "peerDependencies": {
-    "@cloudflare/workers-types": "^4.0.0"
+    "@cloudflare/workers-types": "^4.0.0",
+    "@opennextjs/cloudflare": "^1.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@opennextjs/cloudflare": {
+      "optional": true
+    }
   }
 }