@webflow/cloud-app 0.1.0-beta.9 → 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.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;;;GAGG;AACH,eAAO,MAAM,2BAA2B,eAAe,CAAC;AAExD;;;;;;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

@@ -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

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/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"}

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

@@ -0,0 +1,89 @@
+"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.ensureCompatibleCloudflareAdapter = ensureCompatibleCloudflareAdapter;
+const semver = __importStar(require("semver"));
+const utils_1 = require("../../../utils");
+/**
+ * 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.
+ */
+async function ensureCompatibleCloudflareAdapter(params) {
+    const { log, runCommand, cwd, adapterName, compatibleRange, declaredVersion } = params;
+    if (!declaredVersion) {
+        log.warn(`Installing ${adapterName}@${compatibleRange} (required for Cloudflare deployment)...`);
+        await (0, utils_1.npm)({
+            log,
+            runCommand,
+            cwd,
+            args: ['install', '--save', `${adapterName}@${compatibleRange}`],
+        });
+        return;
+    }
+    const declaredRange = semver.validRange(declaredVersion);
+    if (!declaredRange) {
+        // workspace:/file:/npm: alias and other non-semver specs — can't compare, leave as-is.
+        log.warn(`Cannot verify ${adapterName}@${declaredVersion} against the compatible range ${compatibleRange}; ` +
+            `leaving it as declared. If the build fails, pin ${adapterName}@${compatibleRange} manually.`);
+        return;
+    }
+    if (semver.subset(declaredRange, compatibleRange)) {
+        // Every version the declared range allows is already compatible.
+        return;
+    }
+    log.warn(`${adapterName}@${declaredVersion} is outside the range compatible with your Astro version ` +
+        `(${compatibleRange}). Installing ${adapterName}@${compatibleRange} to avoid broken asset serving ` +
+        `or missing-export build failures on mounted apps.`);
+    await (0, utils_1.npm)({
+        log,
+        runCommand,
+        cwd,
+        args: ['install', '--save', `${adapterName}@${compatibleRange}`],
+    });
+}
+//# sourceMappingURL=ensure-compatible-cloudflare-adapter.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ensure-compatible-cloudflare-adapter.js","sourceRoot":"","sources":["../../../../src/frameworks/astro/adapter-patches/ensure-compatible-cloudflare-adapter.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAqCA,8EA4CC;AAjFD,+CAAiC;AAGjC,0CAAqC;AAiBrC;;;;;;;;;;;;;;;;GAgBG;AACI,KAAK,UAAU,iCAAiC,CACrD,MAA+C;IAE/C,MAAM,EAAE,GAAG,EAAE,UAAU,EAAE,GAAG,EAAE,WAAW,EAAE,eAAe,EAAE,eAAe,EAAE,GAAG,MAAM,CAAC;IAEvF,IAAI,CAAC,eAAe,EAAE,CAAC;QACrB,GAAG,CAAC,IAAI,CACN,cAAc,WAAW,IAAI,eAAe,0CAA0C,CACvF,CAAC;QACF,MAAM,IAAA,WAAG,EAAC;YACR,GAAG;YACH,UAAU;YACV,GAAG;YACH,IAAI,EAAE,CAAC,SAAS,EAAE,QAAQ,EAAE,GAAG,WAAW,IAAI,eAAe,EAAE,CAAC;SACjE,CAAC,CAAC;QACH,OAAO;IACT,CAAC;IAED,MAAM,aAAa,GAAG,MAAM,CAAC,UAAU,CAAC,eAAe,CAAC,CAAC;IACzD,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,uFAAuF;QACvF,GAAG,CAAC,IAAI,CACN,iBAAiB,WAAW,IAAI,eAAe,iCAAiC,eAAe,IAAI;YACjG,mDAAmD,WAAW,IAAI,eAAe,YAAY,CAChG,CAAC;QACF,OAAO;IACT,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,CAAC,aAAa,EAAE,eAAe,CAAC,EAAE,CAAC;QAClD,iEAAiE;QACjE,OAAO;IACT,CAAC;IAED,GAAG,CAAC,IAAI,CACN,GAAG,WAAW,IAAI,eAAe,2DAA2D;QAC1F,IAAI,eAAe,iBAAiB,WAAW,IAAI,eAAe,iCAAiC;QACnG,mDAAmD,CACtD,CAAC;IACF,MAAM,IAAA,WAAG,EAAC;QACR,GAAG;QACH,UAAU;QACV,GAAG;QACH,IAAI,EAAE,CAAC,SAAS,EAAE,QAAQ,EAAE,GAAG,WAAW,IAAI,eAAe,EAAE,CAAC;KACjE,CAAC,CAAC;AACL,CAAC"}

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

@@ -15,8 +15,8 @@ export interface EnsureFixedCloudflareAdapterParams {
 /**
  * Ensure the project resolves a `@astrojs/cloudflare` adapter at or above the release that
  * fixes the base-path bug (withastro/astro#16276, fixed in 13.3.1). Companion to
- * `assertAdapterNestedUnderMount`: forcing a fixed adapter is what keeps that guard nearly
- * unreachable — a buggy 13.0.0–13.3.0 adapter emits the client tree
+ * `stripCloudflareBaseNesting`: forcing a fixed adapter is what keeps the strip a rare
+ * backstop rather than load-bearing — a buggy 13.0.0–13.3.0 adapter emits the client tree
  * WITHOUT the base prefix, so assets end up at the wrong URL no matter how we copy them.
  *
  * - Adapter absent → install our pinned version.

package/dist/frameworks/astro/adapter-patches/ensure-fixed-cloudflare-adapter.js

@@ -39,8 +39,8 @@ const utils_1 = require("../../../utils");
 /**
  * Ensure the project resolves a `@astrojs/cloudflare` adapter at or above the release that
  * fixes the base-path bug (withastro/astro#16276, fixed in 13.3.1). Companion to
- * `assertAdapterNestedUnderMount`: forcing a fixed adapter is what keeps that guard nearly
- * unreachable — a buggy 13.0.0–13.3.0 adapter emits the client tree
+ * `stripCloudflareBaseNesting`: forcing a fixed adapter is what keeps the strip a rare
+ * backstop rather than load-bearing — a buggy 13.0.0–13.3.0 adapter emits the client tree
  * WITHOUT the base prefix, so assets end up at the wrong URL no matter how we copy them.
  *
  * - Adapter absent → install our pinned version.

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

@@ -0,0 +1,39 @@
+/** One Astro line and the `@astrojs/cloudflare` range that is compatible with it. */
+export interface AdapterCompatRow {
+    /** Matched against the project's declared Astro version (coerced to its floor). */
+    astroRange: string;
+    /** The `@astrojs/cloudflare` range to install/clamp to for this Astro line. */
+    adapterRange: string;
+}
+/**
+ * Astro -> `@astrojs/cloudflare` compatibility, newest Astro line first.
+ *
+ * The adapter's own peerDependencies are too loose to trust: 14.2.0 imports
+ * `beginContentEntryCollection`, an export that only exists in astro@7.2.0, yet
+ * still declares peer `astro@^7.0.0`. An unbounded `^14.0.0` install therefore
+ * floats to 14.2.x and breaks Astro 7.0/7.1 builds. We pin a bounded window per
+ * Astro line instead: wide enough to pull the latest compatible adapter, capped
+ * below the first release that needs a newer Astro than the declared line
+ * guarantees.
+ *
+ * Each floor also sits at or above the base-path fix (withastro/astro#16276,
+ * adapter 13.3.1; every 14.x is clean), so resolving from this table keeps the
+ * verbatim `dist/client` copy correct.
+ *
+ * Keyed on the declared Astro floor: a project that declares `astro@^7.0.0`
+ * promises to run on 7.0, so its adapter must stay 7.0-compatible (< 14.2.0)
+ * even if the caret later floats Astro up. Adapter 14.1.x works across all of
+ * 7.x, so clamping down is always safe.
+ */
+export declare const CLOUDFLARE_ADAPTER_TABLE: readonly AdapterCompatRow[];
+/**
+ * Resolve the compatible `@astrojs/cloudflare` range for a declared Astro version.
+ *
+ * Matches the first table row the Astro version's floor satisfies. Throws when
+ * the version is unparseable or outside every known line, so a builder fails
+ * loudly rather than silently installing an unbounded adapter.
+ *
+ * @param declaredAstroVersion The `astro` spec from package.json (e.g. `^7.0.0`).
+ */
+export declare function resolveCloudflareAdapterRange(declaredAstroVersion: string | undefined): string;
+//# sourceMappingURL=resolve-cloudflare-adapter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-cloudflare-adapter.d.ts","sourceRoot":"","sources":["../../../../src/frameworks/astro/adapter-patches/resolve-cloudflare-adapter.ts"],"names":[],"mappings":"AAIA,qFAAqF;AACrF,MAAM,WAAW,gBAAgB;IAC/B,mFAAmF;IACnF,UAAU,EAAE,MAAM,CAAC;IACnB,+EAA+E;IAC/E,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,wBAAwB,EAAE,SAAS,gBAAgB,EAQ/D,CAAC;AAEF;;;;;;;;GAQG;AACH,wBAAgB,6BAA6B,CAAC,oBAAoB,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CA2B9F"}

package/dist/frameworks/astro/adapter-patches/resolve-cloudflare-adapter.js

@@ -0,0 +1,93 @@
+"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.CLOUDFLARE_ADAPTER_TABLE = void 0;
+exports.resolveCloudflareAdapterRange = resolveCloudflareAdapterRange;
+const semver = __importStar(require("semver"));
+const errors_1 = require("../../errors");
+/**
+ * Astro -> `@astrojs/cloudflare` compatibility, newest Astro line first.
+ *
+ * The adapter's own peerDependencies are too loose to trust: 14.2.0 imports
+ * `beginContentEntryCollection`, an export that only exists in astro@7.2.0, yet
+ * still declares peer `astro@^7.0.0`. An unbounded `^14.0.0` install therefore
+ * floats to 14.2.x and breaks Astro 7.0/7.1 builds. We pin a bounded window per
+ * Astro line instead: wide enough to pull the latest compatible adapter, capped
+ * below the first release that needs a newer Astro than the declared line
+ * guarantees.
+ *
+ * Each floor also sits at or above the base-path fix (withastro/astro#16276,
+ * adapter 13.3.1; every 14.x is clean), so resolving from this table keeps the
+ * verbatim `dist/client` copy correct.
+ *
+ * Keyed on the declared Astro floor: a project that declares `astro@^7.0.0`
+ * promises to run on 7.0, so its adapter must stay 7.0-compatible (< 14.2.0)
+ * even if the caret later floats Astro up. Adapter 14.1.x works across all of
+ * 7.x, so clamping down is always safe.
+ */
+exports.CLOUDFLARE_ADAPTER_TABLE = [
+    // Bounded at `<8.0.0` on purpose: `Astro7Builder.detect` accepts major >= 7, so a
+    // future Astro 8 would land here. Leaving it open-ended would silently hand Astro 8
+    // a `^14.2.0` adapter that only peers `astro@^7`. The bound makes an unmapped major
+    // fail loudly (see resolveCloudflareAdapterRange) until a row is added for it.
+    { astroRange: '>=7.2.0 <8.0.0', adapterRange: '^14.2.0' },
+    { astroRange: '>=7.0.0 <7.2.0', adapterRange: '>=14.1.7 <14.2.0' },
+    { astroRange: '>=6.0.0 <7.0.0', adapterRange: '^13.3.1' },
+];
+/**
+ * Resolve the compatible `@astrojs/cloudflare` range for a declared Astro version.
+ *
+ * Matches the first table row the Astro version's floor satisfies. Throws when
+ * the version is unparseable or outside every known line, so a builder fails
+ * loudly rather than silently installing an unbounded adapter.
+ *
+ * @param declaredAstroVersion The `astro` spec from package.json (e.g. `^7.0.0`).
+ */
+function resolveCloudflareAdapterRange(declaredAstroVersion) {
+    const coerced = declaredAstroVersion ? semver.coerce(declaredAstroVersion) : null;
+    if (!coerced) {
+        throw new errors_1.FrameworkValidationError(`Cannot resolve a @astrojs/cloudflare version: unrecognized Astro version "${declaredAstroVersion ?? '(absent)'}".`, {
+            remediation: 'Pin a concrete Astro version, e.g.: npm install astro@^7.0.0',
+        });
+    }
+    const row = exports.CLOUDFLARE_ADAPTER_TABLE.find((candidate) => semver.satisfies(coerced, candidate.astroRange));
+    if (!row) {
+        throw new errors_1.FrameworkValidationError(`No @astrojs/cloudflare mapping for Astro ${coerced.version}. Add a row to CLOUDFLARE_ADAPTER_TABLE.`, {
+            remediation: 'This Astro version is outside the range this builder supports. Pin a supported Astro major, or update CLOUDFLARE_ADAPTER_TABLE.',
+        });
+    }
+    return row.adapterRange;
+}
+//# sourceMappingURL=resolve-cloudflare-adapter.js.map

package/dist/frameworks/astro/adapter-patches/resolve-cloudflare-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-cloudflare-adapter.js","sourceRoot":"","sources":["../../../../src/frameworks/astro/adapter-patches/resolve-cloudflare-adapter.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmDA,sEA2BC;AA9ED,+CAAiC;AAEjC,yCAAwD;AAUxD;;;;;;;;;;;;;;;;;;;GAmBG;AACU,QAAA,wBAAwB,GAAgC;IACnE,kFAAkF;IAClF,oFAAoF;IACpF,oFAAoF;IACpF,+EAA+E;IAC/E,EAAE,UAAU,EAAE,gBAAgB,EAAE,YAAY,EAAE,SAAS,EAAE;IACzD,EAAE,UAAU,EAAE,gBAAgB,EAAE,YAAY,EAAE,kBAAkB,EAAE;IAClE,EAAE,UAAU,EAAE,gBAAgB,EAAE,YAAY,EAAE,SAAS,EAAE;CAC1D,CAAC;AAEF;;;;;;;;GAQG;AACH,SAAgB,6BAA6B,CAAC,oBAAwC;IACpF,MAAM,OAAO,GAAG,oBAAoB,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAClF,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,iCAAwB,CAChC,6EACE,oBAAoB,IAAI,UAC1B,IAAI,EACJ;YACE,WAAW,EAAE,8DAA8D;SAC5E,CACF,CAAC;IACJ,CAAC;IAED,MAAM,GAAG,GAAG,gCAAwB,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CACtD,MAAM,CAAC,SAAS,CAAC,OAAO,EAAE,SAAS,CAAC,UAAU,CAAC,CAChD,CAAC;IACF,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,iCAAwB,CAChC,4CAA4C,OAAO,CAAC,OAAO,0CAA0C,EACrG;YACE,WAAW,EACT,iIAAiI;SACpI,CACF,CAAC;IACJ,CAAC;IAED,OAAO,GAAG,CAAC,YAAY,CAAC;AAC1B,CAAC"}

package/dist/frameworks/astro/adapter-patches/strip-cloudflare-base-nesting.d.ts

@@ -0,0 +1,2 @@
+export declare function stripCloudflareBaseNesting(cwd: string, assetsPath: string, cleanMountPath: string): string;
+//# sourceMappingURL=strip-cloudflare-base-nesting.d.ts.map

package/dist/frameworks/astro/adapter-patches/strip-cloudflare-base-nesting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"strip-cloudflare-base-nesting.d.ts","sourceRoot":"","sources":["../../../../src/frameworks/astro/adapter-patches/strip-cloudflare-base-nesting.ts"],"names":[],"mappings":"AA6CA,wBAAgB,0BAA0B,CACxC,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,MAAM,EAClB,cAAc,EAAE,MAAM,GACrB,MAAM,CAkBR"}