@webflow/cloud-app 0.1.0-beta.8 → 0.1.0

package/README.md

@@ -100,62 +100,31 @@ repo). Which copy of `@webflow/cloud-app` they load is decided by **where
 `npm install` ran**, not by how the code is bundled and not at runtime — a
 `require("@webflow/cloud-app")` just reads whatever `npm` put in `node_modules`.
 
-| Scenario                                                                     | `node_modules/@webflow/cloud-app` is… | Source                |
-| ---------------------------------------------------------------------------- | ------------------------------------- | --------------------- |
-| End user runs `npm i -g @webflow/webflow-cli`                                | the registry copy npm fetched         | npm registry          |
-| Engineer working in the webflow-cli repo (`npm ci`, build, run local `dist`) | a symlink to `apps/webflow-cloud-app` | workspace (repo tree) |
-| CI for webflow-cli (unit, regression, e2e)                                   | a symlink to `apps/webflow-cloud-app` | workspace (repo tree) |
-| cosmic-builder (separate repo)                                               | the registry copy npm fetched         | npm registry          |
-
-- **Inside this monorepo the CLI always uses the workspace copy.**
-  `apps/webflow-cloud-app` is a workspace member, so npm links it by name
-  while the declared version matches — `apps/webflow-cli`
-  depends on it at an exact pin equal to this package's version (enforced in CI
-  by `npm run check:cloud-app-pin`; a mismatched pin would make npm silently
-  install the registry copy instead). Edit the source here and it takes effect on
-  the next build.
+| Scenario                                                                     | `node_modules/@webflow/cloud-app` is…                                                        | Source                                |
+| ---------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------- | ------------------------------------- |
+| End user runs `npm i -g @webflow/webflow-cli`                                | the registry copy npm fetched                                                                | npm registry                          |
+| Engineer working in the webflow-cli repo (`npm ci`, build, run local `dist`) | a symlink to `apps/webflow-cloud-app`                                                        | workspace (repo tree)                 |
+| CI for webflow-cli (unit, regression)                                        | a symlink to `apps/webflow-cloud-app`                                                        | workspace (repo tree)                 |
+| CI for webflow-cli (e2e, temp workspace outside the repo)                    | a tarball packed from this folder, or the published version the CLI depends on while it lags | workspace (repo tree) or npm registry |
+| cosmic-builder (separate repo)                                               | the registry copy npm fetched                                                                | npm registry                          |
+
+- **Inside this monorepo the CLI uses the workspace copy while it depends on
+  this package's current version.** `apps/webflow-cli` depends on it through an
+  npm alias to an exact version (`npm:@webflow/cloud-app@<version>`, enforced in
+  CI by `npm run check:cloud-app-pin`). While that version equals this package's
+  version, npm links the workspace copy, so editing the source here takes effect
+  on the next build. When this package has moved ahead, the CLI keeps using the
+  published version its alias names until the alias is changed on purpose.
 - **The published CLI uses the registry copy.** The engine is kept external in
   the CLI's tsup bundle (it is CJS, not inlined), so the shipped `dist` keeps
   `require("@webflow/cloud-app")` and resolves it at the user's install time.
-  The CLI's `package.json` carries an exact pin (not a caret, since this is a
-  prerelease line the CLI is built and tested against), so released builds
-  resolve exactly that version from npm.
+  The alias names an exact version, so released builds resolve exactly that
+  version from npm.
 - **cosmic-builder is a different repo**, so it has no workspace copy and always
-  resolves from the registry. That is why publishing to npm (below) still
+  resolves from the registry. That is why publishing to npm still
   matters even though the CLI links the workspace in development.
 
 ## Publishing
 
-Published **manually** from this folder — there is no GitHub Action. Its release
-cadence follows the build engine, not the CLI. It is a regular changesets
-workspace package, but `changeset publish` always publishes with `--tag latest`,
-which would move `latest` onto a beta, so it must already be on npm before a CLI
-release: `publish-packages.sh` refuses to run otherwise, and skips it once it is.
-Don't add changesets for this package — changesets can't increment a prerelease
-(it would turn `0.1.0-beta.7` into `0.1.0`); bump the version by hand. CI fails
-(`npm run check:cloud-app-pin`) if a changeset names it.
-
-This is a prerelease line (`0.1.0-beta.x`), so always pass an explicit
-`--tag` — npm would otherwise move the `latest` tag onto a beta. The CLI pins
-this exact version, so move the pin in the same PR (CI runs
-`npm run check:cloud-app-pin`):
-
-```bash
-# from apps/webflow-cloud-app
-npm version prerelease --preid beta --no-git-tag-version   # 0.1.0-beta.7 → 0.1.0-beta.8
-# set "@webflow/cloud-app" in apps/webflow-cli/package.json to the same version
-# and run `npm install` from the repo root
-npm publish --tag beta                                     # installs via @webflow/cloud-app@beta
-```
-
-To test a build against the consumers (webflow-cli, cosmic-builder) before a
-real release, publish the same version under a throwaway ticket-scoped tag so
-it never touches `latest` or `beta`:
-
-```bash
-npm publish --tag beta7-cloud888     # installs via @webflow/cloud-app@beta7-cloud888
-```
-
-Consumers then pin that exact version (e.g. `"@webflow/cloud-app": "0.1.0-beta.8"`)
-and CI resolves it from the registry. Remove a throwaway tag when done with
-`npm dist-tag rm @webflow/cloud-app beta7-cloud888`.
+Release instructions for the Cloud team are in
+[RELEASING.md](./RELEASING.md).

package/dist/bindings.d.ts

@@ -174,6 +174,11 @@ export declare function hasAnyBindings(bindings: WebflowBindings | undefined): b
 export declare function validateR2BucketName(name: string): void;
 /** Enforce per-type count limits and R2 naming rules. Mirrors the deployer's checks. */
 export declare function validateBindings(bindings: WebflowBindings): void;
+/**
+ * `compatibility_date` written into the binding bridge. A schema placeholder the deployer
+ * ignores, not a date the user chose; the compat date policy never treats it as one.
+ */
+export declare const BINDINGS_BRIDGE_COMPAT_DATE = "2025-01-01";
 /**
  * Synthesize the wrangler-shaped binding bridge from webflow.json bindings.
  *

package/dist/bindings.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bindings.d.ts","sourceRoot":"","sources":["../src/bindings.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,uEAAuE;AACvE,eAAO,MAAM,qBAAqB,IAAI,CAAC;AASvC,eAAO,MAAM,eAAe;;;;;;;;;gCAEZ,CAAC;AACjB,eAAO,MAAM,eAAe;;;;;;;;;gCAEZ,CAAC;AACjB,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;gCAOZ,CAAC;AAEjB,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gCAMX,CAAC;AAEjB,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAE7D,6FAA6F;AAC7F,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,eAAe,GAAG,SAAS,CAGvE;AAED,+DAA+D;AAC/D,wBAAgB,cAAc,CAAC,QAAQ,EAAE,eAAe,GAAG,SAAS,GAAG,OAAO,CAG7E;AAED,2GAA2G;AAC3G,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAgBvD;AAED,wFAAwF;AACxF,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI,CAmBhE;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,eAAe,EACzB,IAAI,SAAgB,GACnB,YAAY,CAmBd"}
+{"version":3,"file":"bindings.d.ts","sourceRoot":"","sources":["../src/bindings.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,uEAAuE;AACvE,eAAO,MAAM,qBAAqB,IAAI,CAAC;AAUvC,eAAO,MAAM,eAAe;;;;;;;;;gCAEZ,CAAC;AACjB,eAAO,MAAM,eAAe;;;;;;;;;gCAEZ,CAAC;AACjB,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;gCAOZ,CAAC;AAEjB,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gCAMX,CAAC;AAEjB,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAE7D,6FAA6F;AAC7F,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,eAAe,GAAG,SAAS,CAGvE;AAED,+DAA+D;AAC/D,wBAAgB,cAAc,CAAC,QAAQ,EAAE,eAAe,GAAG,SAAS,GAAG,OAAO,CAG7E;AAED,2GAA2G;AAC3G,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAgBvD;AAED,wFAAwF;AACxF,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI,CAmBhE;AAED;;;GAGG;AACH,eAAO,MAAM,2BAA2B,eAAe,CAAC;AAExD;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,eAAe,EACzB,IAAI,SAAgB,GACnB,YAAY,CAmBd"}

package/dist/bindings.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.BindingsSchema = exports.D1BindingSchema = exports.R2BindingSchema = exports.KvBindingSchema = exports.MAX_BINDINGS_PER_TYPE = void 0;
+exports.BINDINGS_BRIDGE_COMPAT_DATE = exports.BindingsSchema = exports.D1BindingSchema = exports.R2BindingSchema = exports.KvBindingSchema = exports.MAX_BINDINGS_PER_TYPE = void 0;
 exports.parseBindings = parseBindings;
 exports.hasAnyBindings = hasAnyBindings;
 exports.validateR2BucketName = validateR2BucketName;
@@ -25,8 +25,9 @@ const zod_1 = require("zod");
 const errors_1 = require("./frameworks/errors");
 /** Max number of each binding type, matching the deployer's limits. */
 exports.MAX_BINDINGS_PER_TYPE = 5;
-// Cloudflare assigns the real ids at deploy time; these only satisfy the
-// build-phase wrangler schema + `wrangler deploy --dry-run`.
+// Cloudflare assigns the real ids at deploy time. The user wrangler schema and
+// `wrangler deploy --dry-run` accept bindings without ids; the placeholders keep
+// the bridge valid against the strict `loadWranglerJson` schema.
 const KV_ID_PLACEHOLDER = '0'.repeat(32);
 const D1_ID_PLACEHOLDER = '00000000-0000-0000-0000-000000000000';
 // `binding` is the JS binding name (e.g. `env.MY_KV`). `id` / `database_id` are
@@ -90,6 +91,11 @@ function validateBindings(bindings) {
         validateR2BucketName(bucket.bucket_name);
     }
 }
+/**
+ * `compatibility_date` written into the binding bridge. A schema placeholder the deployer
+ * ignores, not a date the user chose; the compat date policy never treats it as one.
+ */
+exports.BINDINGS_BRIDGE_COMPAT_DATE = '2025-01-01';
 /**
  * Synthesize the wrangler-shaped binding bridge from webflow.json bindings.
  *
@@ -100,7 +106,7 @@ function validateBindings(bindings) {
 function bindingsToWranglerJson(bindings, name = 'webflow-app') {
     return {
         name,
-        compatibility_date: '2025-01-01',
+        compatibility_date: exports.BINDINGS_BRIDGE_COMPAT_DATE,
         kv_namespaces: (bindings.kv ?? []).map((k) => ({
             binding: k.binding,
             id: k.id ?? KV_ID_PLACEHOLDER,

package/dist/bindings.js.map

@@ -1 +1 @@
-{"version":3,"file":"bindings.js","sourceRoot":"","sources":["../src/bindings.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"bindings.js","sourceRoot":"","sources":["../src/bindings.ts"],"names":[],"mappings":"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"}

package/dist/compat-date.d.ts

@@ -0,0 +1,68 @@
+import type { Logger } from './ports';
+/**
+ * Lowest `compatibility_date` the platform runs a worker at once the policy is on.
+ * workerd only provides a working `node:http` / `node:https` client from this date.
+ */
+export declare const COMPAT_DATE_FLOOR = "2025-08-16";
+/**
+ * Where the build records the date it settled on, next to `clouduser.wrangler.json`
+ * (which already travels from the build to the deploy). Keep in sync with the
+ * deployer.
+ */
+export declare const COMPAT_DATE_RECORD_FILE = "clouduser.compat-date.json";
+export type CompatDateSource = 'template' | 'floor' | 'user';
+export interface CompatDateInputs {
+    /** `compatibility_date` of the template the build's wrangler.json was copied from. */
+    templateDate: string;
+    /** `compatibility_date` from the user's own wrangler config, if any. */
+    userDate?: string;
+    /**
+     * When false the template date is used unchanged. When true, the result is always
+     * a valid date at or above COMPAT_DATE_FLOOR: the user's date when it qualifies,
+     * otherwise the template's date or the floor, whichever is later.
+     */
+    policyEnabled: boolean;
+    /** Injected for tests. */
+    now?: Date;
+}
+export interface CompatDateResolution {
+    date: string;
+    source: CompatDateSource;
+    /** Present when the user's date was unusable. */
+    warning?: string;
+}
+/** What the build leaves for the deploy. */
+export interface CompatDateRecord {
+    compatibilityDate: string;
+    source: CompatDateSource;
+}
+/**
+ * Pure resolution of the date a worker is built and deployed with.
+ *
+ *   policy off                                     -> template date, unchanged
+ *   policy on, user date valid, <= today, >= floor -> user date
+ *   policy on, otherwise                           -> default, plus a warning if a
+ *                                                     user date was given but unusable
+ *
+ * where default = the template date if it is a valid date at or above the floor,
+ * else the floor.
+ */
+export declare function resolveCompatDate(inputs: CompatDateInputs): CompatDateResolution;
+/**
+ * Settles the date on `<cwd>/wrangler.json` (just copied from the framework
+ * template) and records it for the deploy.
+ *
+ * `userCompatDate` is the date from the user's own wrangler config, if any. The
+ * bindings-bridge placeholder is not a user choice and is ignored. With the policy
+ * off nothing changes and no record is written; a record already in the checkout is
+ * removed either way, because the deploy trusts that file and a repo must not be
+ * able to supply it.
+ *
+ * Never throws: an error keeps the template date and logs a warning, so this cannot
+ * fail a build.
+ */
+export declare function applyCompatDateAtBuild(log: Logger, cwd: string, userCompatDate: string | undefined, opts?: {
+    policyEnabled?: boolean;
+    now?: Date;
+}): CompatDateResolution | undefined;
+//# sourceMappingURL=compat-date.d.ts.map

package/dist/compat-date.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compat-date.d.ts","sourceRoot":"","sources":["../src/compat-date.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAGtC;;;GAGG;AACH,eAAO,MAAM,iBAAiB,eAAe,CAAC;AAE9C;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,+BAA+B,CAAC;AAEpE,MAAM,MAAM,gBAAgB,GAAG,UAAU,GAAG,OAAO,GAAG,MAAM,CAAC;AAE7D,MAAM,WAAW,gBAAgB;IAC/B,sFAAsF;IACtF,YAAY,EAAE,MAAM,CAAC;IACrB,wEAAwE;IACxE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,aAAa,EAAE,OAAO,CAAC;IACvB,0BAA0B;IAC1B,GAAG,CAAC,EAAE,IAAI,CAAC;CACZ;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,gBAAgB,CAAC;IACzB,iDAAiD;IACjD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,4CAA4C;AAC5C,MAAM,WAAW,gBAAgB;IAC/B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,MAAM,EAAE,gBAAgB,CAAC;CAC1B;AAUD;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,gBAAgB,GAAG,oBAAoB,CAgChF;AAMD;;;;;;;;;;;;GAYG;AACH,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,EACX,cAAc,EAAE,MAAM,GAAG,SAAS,EAClC,IAAI,GAAE;IAAE,aAAa,CAAC,EAAE,OAAO,CAAC;IAAC,GAAG,CAAC,EAAE,IAAI,CAAA;CAAO,GACjD,oBAAoB,GAAG,SAAS,CAwClC"}

package/dist/compat-date.js

@@ -0,0 +1,169 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.COMPAT_DATE_RECORD_FILE = exports.COMPAT_DATE_FLOOR = void 0;
+exports.resolveCompatDate = resolveCompatDate;
+exports.applyCompatDateAtBuild = applyCompatDateAtBuild;
+/**
+ * Build-phase `compatibility_date` policy.
+ *
+ * wrangler bundles the worker at build time, and the date decides whether Node's
+ * `http`/`https` are inlined unenv polyfills or native imports. A bundle built at
+ * an old date still throws at a newer runtime date (so SDKs on Node's http client,
+ * like Sentry's server transport, silently drop data), and a bundle built at a new
+ * date fails to start at an old one. So the build settles the date once, on the
+ * `wrangler.json` it just copied from the framework template, and records it for
+ * the deploy, which applies the record and never decides a date itself.
+ *
+ * The policy is switched on by the host (the server's feature gate, via
+ * `compatDatePolicy`); off keeps today's behavior exactly.
+ */
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const bindings_1 = require("./bindings");
+/**
+ * Lowest `compatibility_date` the platform runs a worker at once the policy is on.
+ * workerd only provides a working `node:http` / `node:https` client from this date.
+ */
+exports.COMPAT_DATE_FLOOR = '2025-08-16';
+/**
+ * Where the build records the date it settled on, next to `clouduser.wrangler.json`
+ * (which already travels from the build to the deploy). Keep in sync with the
+ * deployer.
+ */
+exports.COMPAT_DATE_RECORD_FILE = 'clouduser.compat-date.json';
+function isValidDate(value) {
+    if (!/^\d{4}-\d{2}-\d{2}$/.test(value)) {
+        return false;
+    }
+    const parsed = new Date(`${value}T00:00:00Z`);
+    return !Number.isNaN(parsed.getTime()) && parsed.toISOString().slice(0, 10) === value;
+}
+/**
+ * Pure resolution of the date a worker is built and deployed with.
+ *
+ *   policy off                                     -> template date, unchanged
+ *   policy on, user date valid, <= today, >= floor -> user date
+ *   policy on, otherwise                           -> default, plus a warning if a
+ *                                                     user date was given but unusable
+ *
+ * where default = the template date if it is a valid date at or above the floor,
+ * else the floor.
+ */
+function resolveCompatDate(inputs) {
+    const { templateDate, userDate, policyEnabled } = inputs;
+    const today = (inputs.now ?? new Date()).toISOString().slice(0, 10);
+    if (!policyEnabled) {
+        return { date: templateDate, source: 'template' };
+    }
+    const templateUsable = isValidDate(templateDate) && templateDate >= exports.COMPAT_DATE_FLOOR;
+    const fallback = templateUsable
+        ? { date: templateDate, source: 'template' }
+        : { date: exports.COMPAT_DATE_FLOOR, source: 'floor' };
+    if (userDate === undefined) {
+        return fallback;
+    }
+    let problem;
+    if (!isValidDate(userDate)) {
+        problem = 'is not a valid YYYY-MM-DD date';
+    }
+    else if (userDate > today) {
+        problem = 'is in the future';
+    }
+    else if (userDate < exports.COMPAT_DATE_FLOOR) {
+        problem = `is below the platform minimum ${exports.COMPAT_DATE_FLOOR}`;
+    }
+    if (problem) {
+        return {
+            ...fallback,
+            warning: `compatibility_date ${userDate} in your wrangler config ${problem}, using ${fallback.date}`,
+        };
+    }
+    return { date: userDate, source: 'user' };
+}
+function recordPath(cwd) {
+    return path.join(cwd, exports.COMPAT_DATE_RECORD_FILE);
+}
+/**
+ * Settles the date on `<cwd>/wrangler.json` (just copied from the framework
+ * template) and records it for the deploy.
+ *
+ * `userCompatDate` is the date from the user's own wrangler config, if any. The
+ * bindings-bridge placeholder is not a user choice and is ignored. With the policy
+ * off nothing changes and no record is written; a record already in the checkout is
+ * removed either way, because the deploy trusts that file and a repo must not be
+ * able to supply it.
+ *
+ * Never throws: an error keeps the template date and logs a warning, so this cannot
+ * fail a build.
+ */
+function applyCompatDateAtBuild(log, cwd, userCompatDate, opts = {}) {
+    try {
+        fs.rmSync(recordPath(cwd), { force: true });
+        const wranglerPath = path.join(cwd, 'wrangler.json');
+        const generated = JSON.parse(fs.readFileSync(wranglerPath, 'utf8'));
+        const templateDate = generated.compatibility_date;
+        const userDate = userCompatDate === bindings_1.BINDINGS_BRIDGE_COMPAT_DATE ? undefined : userCompatDate;
+        const policyEnabled = opts.policyEnabled === true;
+        const resolution = resolveCompatDate({ templateDate, userDate, policyEnabled, now: opts.now });
+        log.info(`compatibility_date: ${resolution.date} (${resolution.source}; policy ${policyEnabled ? 'on' : 'off'}, template ${templateDate}${userDate ? `, user ${userDate}` : ''})`);
+        if (resolution.warning) {
+            log.warn(resolution.warning);
+        }
+        if (policyEnabled) {
+            if (resolution.date !== templateDate) {
+                generated.compatibility_date = resolution.date;
+                fs.writeFileSync(wranglerPath, `${JSON.stringify(generated, null, 2)}\n`);
+            }
+            const record = {
+                compatibilityDate: resolution.date,
+                source: resolution.source,
+            };
+            fs.writeFileSync(recordPath(cwd), JSON.stringify(record));
+        }
+        return resolution;
+    }
+    catch (err) {
+        log.warn(`could not apply the compatibility_date policy, keeping the template date: ${err}`);
+        try {
+            fs.rmSync(recordPath(cwd), { force: true });
+        }
+        catch {
+            // nothing more to do
+        }
+        return undefined;
+    }
+}
+//# sourceMappingURL=compat-date.js.map

package/dist/compat-date.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compat-date.js","sourceRoot":"","sources":["../src/compat-date.ts"],"names":[],"mappings":"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"}

package/dist/diagnostics.d.ts

@@ -0,0 +1,23 @@
+export type DiagnosticLevel = 'warn' | 'error';
+export declare const DiagnosticCode: {
+    readonly ASTRO_SESSION_BINDING_MISSING: "ASTRO_SESSION_BINDING_MISSING";
+    readonly WRANGLER_JSON_INVALID: "WRANGLER_JSON_INVALID";
+};
+export type DiagnosticCode = (typeof DiagnosticCode)[keyof typeof DiagnosticCode];
+export interface Diagnostic {
+    level: DiagnosticLevel;
+    code: DiagnosticCode;
+    /** One sentence: what is wrong and what it breaks. No newlines. */
+    message: string;
+    /** One sentence: the exact change to make. No newlines. */
+    fix?: string;
+}
+export declare const DIAGNOSTIC_LINE_PATTERN: RegExp;
+export declare function formatDiagnostic({ level, code, message, fix }: Diagnostic): string;
+export declare function parseDiagnostic(line: string): {
+    level: DiagnosticLevel;
+    code: string;
+    message: string;
+    fix?: string;
+} | undefined;
+//# sourceMappingURL=diagnostics.d.ts.map

package/dist/diagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../src/diagnostics.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,OAAO,CAAC;AAE/C,eAAO,MAAM,cAAc;;;CAGjB,CAAC;AAEX,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,OAAO,cAAc,CAAC,CAAC;AAElF,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,eAAe,CAAC;IACvB,IAAI,EAAE,cAAc,CAAC;IACrB,mEAAmE;IACnE,OAAO,EAAE,MAAM,CAAC;IAChB,2DAA2D;IAC3D,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAID,eAAO,MAAM,uBAAuB,QAC6B,CAAC;AAElE,wBAAgB,gBAAgB,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,EAAE,UAAU,GAAG,MAAM,CAKlF;AAED,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,GACX;IAAE,KAAK,EAAE,eAAe,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAOrF"}

package/dist/diagnostics.js

@@ -0,0 +1,31 @@
+"use strict";
+// Machine-readable build diagnostics. The format and code registry match cosmic-builder's BUILD_DIAGNOSTICS.md
+// (keep codes in sync). Agents, the CLI and (later) the dashboard pick these
+// lines out of the build log by the `[cloud:<level>:<CODE>]` prefix, so a code
+// must never change meaning once shipped.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DIAGNOSTIC_LINE_PATTERN = exports.DiagnosticCode = void 0;
+exports.formatDiagnostic = formatDiagnostic;
+exports.parseDiagnostic = parseDiagnostic;
+exports.DiagnosticCode = {
+    ASTRO_SESSION_BINDING_MISSING: 'ASTRO_SESSION_BINDING_MISSING',
+    WRANGLER_JSON_INVALID: 'WRANGLER_JSON_INVALID',
+};
+// Matches the first line of a diagnostic. Errors may carry detail lines after it.
+// Leading whitespace is allowed because the CLI indents every log line.
+exports.DIAGNOSTIC_LINE_PATTERN = /^\s*\[cloud:(warn|error):([A-Z0-9_]+)\] (.*?)(?: Fix: (.*))?$/;
+function formatDiagnostic({ level, code, message, fix }) {
+    if (/[\r\n]/.test(message) || (fix && /[\r\n]/.test(fix))) {
+        throw new Error(`diagnostic ${code}: message and fix must be single-line`);
+    }
+    return `[cloud:${level}:${code}] ${message}` + (fix ? ` Fix: ${fix}` : '');
+}
+function parseDiagnostic(line) {
+    const match = exports.DIAGNOSTIC_LINE_PATTERN.exec(line.split(/\r?\n/, 1)[0].replace(/\r+$/, ''));
+    if (!match) {
+        return undefined;
+    }
+    const [, level, code, message, fix] = match;
+    return { level: level, code, message, ...(fix !== undefined ? { fix } : {}) };
+}
+//# sourceMappingURL=diagnostics.js.map

package/dist/diagnostics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.js","sourceRoot":"","sources":["../src/diagnostics.ts"],"names":[],"mappings":";AAAA,+GAA+G;AAC/G,6EAA6E;AAC7E,+EAA+E;AAC/E,0CAA0C;;;AAyB1C,4CAKC;AAED,0CASC;AArCY,QAAA,cAAc,GAAG;IAC5B,6BAA6B,EAAE,+BAA+B;IAC9D,qBAAqB,EAAE,uBAAuB;CACtC,CAAC;AAaX,kFAAkF;AAClF,wEAAwE;AAC3D,QAAA,uBAAuB,GAClC,+DAA+D,CAAC;AAElE,SAAgB,gBAAgB,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,EAAc;IACxE,IAAI,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;QAC1D,MAAM,IAAI,KAAK,CAAC,cAAc,IAAI,uCAAuC,CAAC,CAAC;IAC7E,CAAC;IACD,OAAO,UAAU,KAAK,IAAI,IAAI,KAAK,OAAO,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AAC7E,CAAC;AAED,SAAgB,eAAe,CAC7B,IAAY;IAEZ,MAAM,KAAK,GAAG,+BAAuB,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC;IAC1F,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,GAAG,KAAK,CAAC;IAC5C,OAAO,EAAE,KAAK,EAAE,KAAwB,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;AACnG,CAAC"}

package/dist/frameworks/astro/adapter-patches/assert-adapter-nested-under-mount.d.ts

@@ -20,9 +20,9 @@
  * Everything else passes: a missing `assetsPath`, a metadata-only tree, and an asset-less app
  * (an empty `<mount>/` dir still counts as nested).
  *
- * `ensureFixedCloudflareAdapter` forces a fixed adapter, which is what keeps this nearly
- * unreachable. It is reachable through a non-semver adapter spec (git URL, `file:`, alias) or a
- * cross-major pin the forced upgrade leaves alone.
+ * `ensureCompatibleCloudflareAdapter` clamps the adapter into a base-path-fixed range, which is
+ * what keeps this nearly unreachable. It is reachable through a non-semver adapter spec (git URL,
+ * `file:`, alias) whose range it cannot verify and therefore leaves alone.
  */
 export declare function assertAdapterNestedUnderMount(cwd: string, assetsPath: string, cleanMountPath: string): void;
 //# sourceMappingURL=assert-adapter-nested-under-mount.d.ts.map

package/dist/frameworks/astro/adapter-patches/assert-adapter-nested-under-mount.js

@@ -92,9 +92,9 @@ function listEntries(dir) {
  * Everything else passes: a missing `assetsPath`, a metadata-only tree, and an asset-less app
  * (an empty `<mount>/` dir still counts as nested).
  *
- * `ensureFixedCloudflareAdapter` forces a fixed adapter, which is what keeps this nearly
- * unreachable. It is reachable through a non-semver adapter spec (git URL, `file:`, alias) or a
- * cross-major pin the forced upgrade leaves alone.
+ * `ensureCompatibleCloudflareAdapter` clamps the adapter into a base-path-fixed range, which is
+ * what keeps this nearly unreachable. It is reachable through a non-semver adapter spec (git URL,
+ * `file:`, alias) whose range it cannot verify and therefore leaves alone.
  */
 function assertAdapterNestedUnderMount(cwd, assetsPath, cleanMountPath) {
     if (!cleanMountPath) {

package/dist/frameworks/astro/adapter-patches/ensure-compatible-cloudflare-adapter.d.ts

@@ -0,0 +1,34 @@
+import type { Logger, CommandRunner } from '../../../ports';
+export interface EnsureCompatibleCloudflareAdapterParams {
+    log: Logger;
+    runCommand: CommandRunner;
+    cwd: string;
+    /** e.g. `@astrojs/cloudflare`. */
+    adapterName: string;
+    /**
+     * The adapter range compatible with the project's Astro version, from
+     * `resolveCloudflareAdapterRange` (e.g. `>=14.1.7 <14.2.0` or `^13.3.1`).
+     */
+    compatibleRange: string;
+    /** The user's declared adapter spec (from package.json), or undefined if absent. */
+    declaredVersion: string | undefined;
+}
+/**
+ * Ensure the project resolves a `@astrojs/cloudflare` within the range that is
+ * compatible with its Astro version (see `resolveCloudflareAdapterRange`).
+ *
+ * - Adapter absent -> install the compatible range.
+ * - Declared range NOT a subset of the compatible range -> force-install the
+ *   compatible range and warn. This catches both a too-low range (a base-path-buggy
+ *   13.x, withastro/astro#16276) and a too-high one (an unbounded `^14.0.0` that
+ *   floats to 14.2.x and breaks Astro 7.0/7.1, whose adapter peerDeps lie).
+ * - Declared range already within the compatible range -> leave it alone.
+ * - Unparseable spec (`workspace:` / `file:` / `npm:` alias) -> warn and leave it;
+ *   we cannot reason about the range, and forcing could clobber an intentional link.
+ *
+ * `npm install --save <pkg>@<range>` rewrites BOTH package.json and the lockfile
+ * entry for this package, so a forced install overrides a lockfile-pinned
+ * incompatible version.
+ */
+export declare function ensureCompatibleCloudflareAdapter(params: EnsureCompatibleCloudflareAdapterParams): Promise<void>;
+//# sourceMappingURL=ensure-compatible-cloudflare-adapter.d.ts.map

package/dist/frameworks/astro/adapter-patches/ensure-compatible-cloudflare-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ensure-compatible-cloudflare-adapter.d.ts","sourceRoot":"","sources":["../../../../src/frameworks/astro/adapter-patches/ensure-compatible-cloudflare-adapter.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAG5D,MAAM,WAAW,uCAAuC;IACtD,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,aAAa,CAAC;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,kCAAkC;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,eAAe,EAAE,MAAM,CAAC;IACxB,oFAAoF;IACpF,eAAe,EAAE,MAAM,GAAG,SAAS,CAAC;CACrC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,iCAAiC,CACrD,MAAM,EAAE,uCAAuC,GAC9C,OAAO,CAAC,IAAI,CAAC,CA0Cf"}