github cloudflare/workers-sdk @cloudflare/build-output-utils@1.0.0-rc.0

Major Changes

  • #16917 d36b39d Thanks @jamesopstad! - Release the first 1.0.0 release candidate, which reads and writes Build Output v1

    Build Output now lives in .cloudflare/output/v1/. Only the .cloudflare/output/v<N>/ naming convention is permanent: a future breaking change to the format would use a new version directory. readBuildOutput() lists the version directories first and throws a BuildOutputError unless it finds exactly one v1 directory. This means output written by an older or newer tool, or a stale v0 tree left next to a fresh one, fails with a clear error instead of being misread or deployed.

    BuildOutputError now has a code (not-found, newer-version, older-version, multiple-versions, unknown-fields or invalid) plus foundVersions, supportedVersions, producer and unknownFields. Consumers can use these to show their own advice instead of parsing the message. When a config contains fields the reader doesn't support, the error lists each field and names the tool that wrote the output.

    The root config.json now nests account settings under settings, which is left out when none are set, and can record the tool that wrote the output in an optional producer field. writeRootConfig() takes an options object, matching the other write* functions:

    // Before
    await writeRootConfig(root, settings, buildContext);
    
    // After
    await writeRootConfig({
      root,
      settings,
      buildContext,
      producer: { name: "my-framework-adapter", version: "1.2.3" },
    });

Patch Changes

  • #16946 e97c9f8 Thanks @dependabot! - Update DEFAULT_COMPAT_DATE to 2026-11-16

    Use the bundled workerd release's compatibility date by default when scaffolding new projects or when no compatibility date is configured.

  • Updated dependencies [d36b39d, 0bf81ac, e97c9f8, 349fc4e]:

    • @cloudflare/config@1.0.0-rc.0

Don't miss a new workers-sdk release

NewReleases is sending notifications on new releases.