Add routes option to cloudflare.Worker

platform/src/components/cloudflare/worker.ts

@@ -3,6 +3,7 @@ import path from "path";
 import crypto from "crypto";
 import {
   ComponentResourceOptions,
+  Output,
   output,
   all,
   jsonStringify,
@@ -66,6 +67,44 @@ export interface WorkerArgs {
    * ```
    */
   domain?: Input<string>;
+  /**
+   * Attach the Worker to one or more [route patterns](https://developers.cloudflare.com/workers/configuration/routing/routes/)
+   * instead of a dedicated custom domain.
+   *
+   * Unlike `domain`, which gives the Worker a full hostname, routes are
+   * pattern-based. This lets multiple Workers (or a Pages project) share a
+   * hostname and fall through to the origin for unmatched paths. Use routes
+   * when you want to put a Worker in front of only part of a site, e.g.
+   * `example.com/api/*`.
+   *
+   * Each pattern must start with a concrete hostname that belongs to a
+   * Cloudflare zone on the same account. Wildcard hostnames like `*.example.com`
+   * are not supported here.
+   *
+   * A proxied DNS record for the hostname must already exist in the zone —
+   * routes do not auto-manage DNS, unlike custom domains. You can create
+   * one in the Cloudflare dashboard or alongside the Worker with a
+   * `cloudflare.DnsRecord` resource.
+   *
+   * Cannot be used together with `domain`.
+   *
+   * @example
+   *
+   * ```js
+   * {
+   *   routes: ["example.com/api/*"]
+   * }
+   * ```
+   *
+   * Multiple patterns on the same Worker:
+   *
+   * ```js
+   * {
+   *   routes: ["example.com/api/*", "api.example.com/*"]
+   * }
+   * ```
+   */
+  routes?: Input<Input<string>[]>;
   /**
    * Configure how your function is bundled.
    *
@@ -294,6 +333,7 @@ export class Worker extends Component implements Link.Linkable {
   private workerUrl: WorkerUrl;
   private workerPlacement?: WorkerPlacement;
   private workerDomain?: cf.WorkerDomain;
+  private workerRoutes?: Output<cf.WorkersRoute[]>;
 
   constructor(name: string, args: WorkerArgs, opts?: ComponentResourceOptions) {
     super(__pulumiType, name, args, opts);
@@ -324,11 +364,13 @@ export class Worker extends Component implements Link.Linkable {
     const workerUrl = createWorkersUrl();
     const workerPlacement = createWorkerPlacement();
     const workerDomain = createWorkersDomain();
+    const workerRoutes = createWorkersRoutes();
 
     this.script = script;
     this.workerUrl = workerUrl;
     this.workerPlacement = workerPlacement;
     this.workerDomain = workerDomain;
+    this.workerRoutes = workerRoutes;
 
     all([dev, buildInput, script.scriptName]).apply(
       async ([dev, buildInput, scriptName]) => {
@@ -619,6 +661,43 @@ export class Worker extends Component implements Link.Linkable {
         { parent },
       );
     }
+
+    function createWorkersRoutes() {
+      if (!args.routes) return;
+      if (args.domain)
+        throw new VisibleError(
+          `Cannot set both "domain" and "routes" on the "${name}" Worker. Use "domain" for a dedicated hostname, or "routes" for pattern-based routing.`,
+        );
+
+      return output(args.routes).apply((patterns) =>
+        patterns.map((pattern, i) => {
+          const hostname = pattern.split("/")[0];
+          if (!hostname || hostname.includes("*"))
+            throw new VisibleError(
+              `Route pattern "${pattern}" on the "${name}" Worker must start with a concrete hostname (e.g. "example.com/*"). Wildcard hostnames are not supported.`,
+            );
+
+          const zone = new ZoneLookup(
+            `${name}Route${i}ZoneLookup`,
+            {
+              accountId: DEFAULT_ACCOUNT_ID,
+              domain: hostname,
+            },
+            { parent },
+          );
+
+          return new cf.WorkersRoute(
+            `${name}Route${i}`,
+            {
+              zoneId: zone.id,
+              pattern,
+              script: script.scriptName,
+            },
+            { parent },
+          );
+        }),
+      );
+    }
   }
 
   /**
@@ -639,6 +718,10 @@ export class Worker extends Component implements Link.Linkable {
        * The Cloudflare Worker script.
        */
       worker: this.script,
+      /**
+       * The Cloudflare Worker routes, if `routes` was set.
+       */
+      routes: this.workerRoutes,
     };
   }
 

platform/src/components/component.ts

@@ -184,6 +184,7 @@ export class Component extends ComponentResource {
               "cloudflare:index/dnsRecord:DnsRecord",
               "cloudflare:index/workersCronTrigger:WorkersCronTrigger",
               "cloudflare:index/workersCustomDomain:WorkersCustomDomain",
+              "cloudflare:index/workersRoute:WorkersRoute",
               "cloudflare:index/queueConsumer:QueueConsumer",
               "docker-build:index:Image",
               "vercel:index/dnsRecord:DnsRecord",