@growthbook/proxy-eval 1.1.0 → 1.1.1

package/example/cloudflare/package.json

@@ -0,0 +1,19 @@
+{
+  "name": "growthbook-edge-eval-cloudflare",
+  "version": "0.1.0",
+  "description": "GrowthBook edge evaluation for Cloudflare Workers",
+  "main": "src/index.ts",
+  "scripts": {
+    "dev": "wrangler dev",
+    "deploy": "wrangler deploy",
+    "build": "wrangler build"
+  },
+  "dependencies": {
+    "@growthbook/proxy-eval": "^1.1.1"
+  },
+  "devDependencies": {
+    "@cloudflare/workers-types": "^4.20250926.0",
+    "typescript": "^5.8.2",
+    "wrangler": "^4.40.1"
+  }
+}

package/example/cloudflare/src/index.ts

@@ -0,0 +1,119 @@
+import { evaluateFeatures } from "@growthbook/proxy-eval";
+import { StickyBucketService } from "@growthbook/growthbook";
+
+interface Env {
+  ENVIRONMENT: string;
+
+  KV_GB_PAYLOAD: KVNamespace;
+  // NOTE: Be sure to connect a GrowthBook SDK Webhook to your KV store.
+  // Use the webhook type "Cloudflare KV" in the SDK webhook settings.
+}
+
+interface PostBody {
+  payload: any;
+  attributes: Record<string, any>;
+  forcedVariations?: Record<string, number>;
+  forcedFeatures?: Map<string, any>;
+  url?: string;
+  // NOTE: For advanced experimentation, you may want to connect a KV or cookie Sticky Bucket service
+  stickyBucketService?:
+    | (StickyBucketService & {
+    // For cookie-based service, should be a no-op:
+    connect: () => Promise<void>;
+    // For write-buffer flushes (ex: GB Proxy's implementation of RedisStickyBucketService):
+    onEvaluate?: () => Promise<void>;
+  })
+    | null;
+  ctx?: { verboseDebugging?: boolean };
+}
+
+const KV_KEY = "gb_payload";
+const CACHE_TTL = 60 * 1000; // 1 min
+
+// Cache payload from KV
+let cachedPayload: any = null;
+let lastFetch = 0;
+
+
+export default {
+  fetch: async function (
+    request: Request,
+    env: Env,
+    ctx: ExecutionContext,
+  ): Promise<Response> {
+    // Handle CORS preflight requests
+    if (request.method === 'OPTIONS') {
+      return new Response(null, {
+        status: 204,
+        headers: getCORSHeaders(),
+      });
+    }
+
+    // Only allow POST requests
+    if (request.method !== 'POST') {
+      return new Response(null, {
+        status: 405,
+        headers: {
+          'Allow': 'POST',
+          ...getCORSHeaders(),
+        }
+      });
+    }
+
+    try {
+      const body = await request.json<PostBody>().catch(() => null);
+      if (!body || typeof body !== "object") {
+        return handleInvalidRequest();
+      }
+
+      if (!cachedPayload || Date.now() - lastFetch > CACHE_TTL) {
+        cachedPayload = await env.KV_GB_PAYLOAD.get(KV_KEY, 'json');
+        lastFetch = Date.now();
+      }
+
+      const { attributes = {}, forcedVariations = {}, forcedFeatures = [], url = "" } = body;
+      const forcedFeaturesMap = new Map(forcedFeatures);
+
+      const evalResponse = await evaluateFeatures({
+        payload: cachedPayload,
+        attributes,
+        forcedVariations,
+        forcedFeatures: forcedFeaturesMap,
+        url,
+        // stickyBucketService,
+      });
+
+      // Return success response
+      return new Response(
+        JSON.stringify(evalResponse),
+        {
+          status: 200,
+          headers: {
+            'Content-Type': 'application/json',
+            ...getCORSHeaders(),
+          }
+        }
+      );
+
+    } catch (error) {
+      console.error(error);
+      return handleInvalidRequest();
+    }
+  }
+}
+
+function getCORSHeaders(): Record<string, string> {
+  return {
+    'Access-Control-Allow-Origin': '*', // Configure this appropriately for production
+    'Access-Control-Allow-Methods': 'POST, OPTIONS',
+    'Access-Control-Allow-Headers': 'Content-Type, Authorization',
+    'Access-Control-Max-Age': '86400',
+  };
+}
+
+function handleInvalidRequest(): Response {
+  return new Response(null, {
+    status: 500,
+    headers: getCORSHeaders(),
+  });
+}

package/example/cloudflare/tsconfig.json

@@ -0,0 +1,20 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "lib": ["ES2022"],
+    "module": "ES2022",
+    "moduleResolution": "bundler",
+    "allowSyntheticDefaultImports": true,
+    "esModuleInterop": true,
+    "allowJs": true,
+    "strict": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "noEmit": true,
+    "types": ["@cloudflare/workers-types"]
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}

package/example/cloudflare/wrangler.toml.example.toml

@@ -0,0 +1,14 @@
+name = "growthbook-edge-evaluator"
+main = "src/index.ts"
+compatibility_date = "2025-09-25"
+
+# Variable bindings. These are arbitrary, plaintext strings (similar to environment variables)
+# Note: Use secrets to store sensitive data.
+# Docs: https://developers.cloudflare.com/workers/platform/environment-variables
+
+kv_namespaces = [
+  { binding = "KV_GB_PAYLOAD", id = "qwerty123" }
+]
+
+[vars]
+NODE_ENV="production"

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@growthbook/proxy-eval",
   "description": "Remote evaluation service for proxies, edge workers, or backend APIs",
-  "version": "1.1.0",
+  "version": "1.1.1",
   "main": "dist/index.js",
   "license": "MIT",
   "repository": {
@@ -18,7 +18,7 @@
     "dev": "tsc --watch"
   },
   "dependencies": {
-    "@growthbook/growthbook": "^1.6.1"
+    "@growthbook/growthbook": "^1.6.3"
   },
   "devDependencies": {
     "rimraf": "^6.0.1",