refactor: dynamically build wrangler.jsonc and inject project uuid

Author: matthewvolk

packages/cli/src/commands/build.ts

@@ -1,10 +1,12 @@
 import { Command, Option } from 'commander';
 import consola from 'consola';
 import { execa } from 'execa';
-import { copyFile, cp, rm } from 'node:fs/promises';
+import { copyFile, cp, rm, writeFile } from 'node:fs/promises';
 import { join } from 'node:path';
 
 import { getModuleCliPath } from '../lib/get-module-cli-path';
+import { getProjectConfig } from '../lib/project-config';
+import { getWranglerConfig } from '../lib/wrangler-config';
 
 const WRANGLER_VERSION = '4.24.3';
 
@@ -16,22 +18,31 @@ export const build = new Command('build')
       'catalyst',
     ]),
   )
-  .action(async () => {
+  .action(async (options) => {
     const coreDir = process.cwd();
 
     try {
       const openNextOutDir = join(coreDir, '.open-next');
       const bigcommerceDistDir = join(coreDir, '.bigcommerce', 'dist');
 
+      const config = getProjectConfig();
+      const projectUuid = options.projectUuid ?? config.get('projectUuid');
+
+      if (!projectUuid) {
+        throw new Error('Project UUID is required. Please run `link` or provide `--project-uuid`');
+      }
+
+      const wranglerConfig = getWranglerConfig(projectUuid, 'PLACEHOLDER_KV_ID');
+
       consola.start('Copying templates...');
 
       await copyFile(
         join(getModuleCliPath(), 'templates', 'open-next.config.ts'),
         join(coreDir, 'open-next.config.ts'),
       );
-      await copyFile(
-        join(getModuleCliPath(), 'templates', 'wrangler.jsonc'),
+      await writeFile(
         join(coreDir, '.bigcommerce', 'wrangler.jsonc'),
+        JSON.stringify(wranglerConfig, null, 2),
       );
 
       consola.success('Templates copied');

packages/cli/src/lib/wrangler-config.ts

@@ -0,0 +1,56 @@
+export function getWranglerConfig(projectUuid: string, kvNamespaceId: string) {
+  return {
+    $schema: 'node_modules/wrangler/config-schema.json',
+    main: '.open-next/worker.js',
+    name: `project-${projectUuid}`,
+    compatibility_date: '2025-07-15',
+    compatibility_flags: ['nodejs_compat', 'global_fetch_strictly_public'],
+    observability: {
+      enabled: true,
+      head_sampling_rate: 0.05,
+      logs: {
+        enabled: true,
+        head_sampling_rate: 1,
+        invocation_logs: false,
+      },
+    },
+    assets: {
+      directory: '.open-next/assets',
+      binding: 'ASSETS',
+    },
+    services: [
+      {
+        binding: 'WORKER_SELF_REFERENCE',
+        service: `project-${projectUuid}`,
+      },
+    ],
+    kv_namespaces: [
+      {
+        binding: 'NEXT_INC_CACHE_KV',
+        id: kvNamespaceId,
+      },
+    ],
+    durable_objects: {
+      bindings: [
+        {
+          name: 'NEXT_CACHE_DO_QUEUE',
+          class_name: 'DOQueueHandler',
+        },
+        {
+          name: 'NEXT_TAG_CACHE_DO_SHARDED',
+          class_name: 'DOShardedTagCache',
+        },
+        {
+          name: 'NEXT_CACHE_DO_PURGE',
+          class_name: 'BucketCachePurge',
+        },
+      ],
+    },
+    migrations: [
+      {
+        tag: 'v1',
+        new_sqlite_classes: ['DOQueueHandler', 'DOShardedTagCache', 'BucketCachePurge'],
+      },
+    ],
+  };
+}

packages/cli/templates/wrangler.jsonc

@@ -0,0 +1,12 @@
+import { expect, test } from 'vitest';
+
+import { getWranglerConfig } from '../../src/lib/wrangler-config';
+
+test('returns a config with name identical to worker self reference service', () => {
+  const config = getWranglerConfig('uuid', 'kv-namespace-id');
+
+  expect(config.name).toBe(`project-uuid`);
+  expect(
+    config.services.find((service) => service.binding === 'WORKER_SELF_REFERENCE')?.service,
+  ).toBe(`project-uuid`);
+});