feat(cloudflare): add Workers.DevUrl and Workers.DevDomain bindings

[sam-goodwin]

A Worker by default is allocated a workers.dev subdomain computed from its name and your account's worker subdomain.

E.g.

${workerName}.${subdomain}.workers.dev

Use the Worker.DevDomain and Worker.DevUrl bindings to inject a Worker's own subdomain or URL into its script.

import { Worker } from "alchemy/cloudflare";

const worker = await Worker("api", {
  name: "api-worker",
  entrypoint: "./src/api.ts",
  // workers.dev URL must be enabled (is by default)
  // url: true,
  bindings: {
    // ${workerName}.${subdomain}.workers.dev
    DEV_DOMAIN: Worker.DevDomain,
    // https://${workerName}.${subdomain}.workers.dev
    DEV_URL: Worker.DevUrl,
  },
});

[pkg-pr-new]

Open in StackBlitz

npm i https://pkg.pr.new/sam-goodwin/alchemy@928

commit: 5c2d786

[github-actions]

🚀 Website Preview Deployed

Your website preview is ready!

Preview URL: https://d8fabe19-alchemy-website.alchemy-run.workers.dev

This preview was built from commit 670cd79

---

_{🤖 This comment will be updated automatically when you push new commits to this PR.}

[john-royal]

A few questions:

• Why do we have both DevDomain and DevUrl? How common is it to need the domain without the http(s) prefix?
• Should this also take worker versions into account? Would definitely make it more complicated since I'm not sure if there's a way to determine the version ID without injecting something into the worker runtime that can read a version metadata binding.

[sam-goodwin]

Good idea from @Mkassabov, why not just bundle it with other data into a single always-available binding.

type MEtadata = {
  url: string;
  devDomain: string;
  commit: string;
  appName: string;
  stage: string;
  scope: string[];
  // .. what else?
}