@webflow/cloud-app 0.1.0-beta.10

package/dist/toolchain/types.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Node runtime selection types.
+ *
+ * These are intentionally host-agnostic: the resolver determines what a
+ * project requests, while a host-provided runtime adapter decides how to make
+ * that version available.
+ */
+/** The file or manifest field that selected the Node version. */
+export type NodeVersionDeclarationSource = 'nvmrc' | 'node-version' | 'package-engines' | 'default';
+/**
+ * Stable outcome of resolving a repository's Node declaration. Hosts can use
+ * this for telemetry and customer-facing behavior without matching warnings.
+ */
+export type NodeToolchainResolution = 'declared' | 'default' | 'invalid' | 'unsupported' | 'unresolvable' | 'conflicting';
+/** Node releases a host permits for customer builds. Values must be exact semver versions. */
+export interface NodeToolchainPolicy {
+    /** Exact version used when the project does not declare one. */
+    defaultVersion: string;
+    /** Exact versions the host is prepared to provision. */
+    supportedVersions: readonly string[];
+    /** Exact supported releases the host designates as LTS. */
+    supportedLtsVersions: readonly string[];
+}
+/** The resolved, exact Node runtime a build should use. */
+export interface ResolvedNodeToolchain {
+    declarationSource: NodeVersionDeclarationSource;
+    /** Raw version declaration from the repository, omitted when the host default is used. */
+    requestedVersion?: string;
+    /** Exact supported Node release selected for this build. */
+    resolvedVersion: string;
+    /** Machine-readable resolution outcome. */
+    resolution: NodeToolchainResolution;
+    /** Lower-priority sources that requested a different supported release. */
+    conflictingDeclarationSources?: readonly Exclude<NodeVersionDeclarationSource, 'default'>[];
+    /** Non-fatal information a host may choose to expose in build logs. */
+    warning?: string;
+}
+/** Environment and version returned by a host's provisioned Node runtime. */
+export interface PreparedNodeRuntime {
+    /** Exact version that was provisioned and verified. */
+    version: string;
+    /** Environment that ensures `node` and `npm` resolve to this runtime. */
+    commandEnv: Record<string, string>;
+}
+/**
+ * Host-provided runtime implementation. `@webflow/cloud-app` never installs Node on
+ * its own; Cosmic can use NVM while other hosts provide a suitable adapter.
+ */
+export interface NodeRuntimePort {
+    prepare(toolchain: ResolvedNodeToolchain): Promise<PreparedNodeRuntime>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/toolchain/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/toolchain/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,iEAAiE;AACjE,MAAM,MAAM,4BAA4B,GAAG,OAAO,GAAG,cAAc,GAAG,iBAAiB,GAAG,SAAS,CAAC;AAEpG;;;GAGG;AACH,MAAM,MAAM,uBAAuB,GACjC,UAAU,GAAG,SAAS,GAAG,SAAS,GAAG,aAAa,GAAG,cAAc,GAAG,aAAa,CAAC;AAEtF,8FAA8F;AAC9F,MAAM,WAAW,mBAAmB;IAClC,gEAAgE;IAChE,cAAc,EAAE,MAAM,CAAC;IACvB,wDAAwD;IACxD,iBAAiB,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,2DAA2D;IAC3D,oBAAoB,EAAE,SAAS,MAAM,EAAE,CAAC;CACzC;AAED,2DAA2D;AAC3D,MAAM,WAAW,qBAAqB;IACpC,iBAAiB,EAAE,4BAA4B,CAAC;IAChD,0FAA0F;IAC1F,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,4DAA4D;IAC5D,eAAe,EAAE,MAAM,CAAC;IACxB,2CAA2C;IAC3C,UAAU,EAAE,uBAAuB,CAAC;IACpC,2EAA2E;IAC3E,6BAA6B,CAAC,EAAE,SAAS,OAAO,CAAC,4BAA4B,EAAE,SAAS,CAAC,EAAE,CAAC;IAC5F,uEAAuE;IACvE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,6EAA6E;AAC7E,MAAM,WAAW,mBAAmB;IAClC,uDAAuD;IACvD,OAAO,EAAE,MAAM,CAAC;IAChB,yEAAyE;IACzE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACpC;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,SAAS,EAAE,qBAAqB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;CACzE"}

package/dist/toolchain/types.js

@@ -0,0 +1,10 @@
+"use strict";
+/**
+ * Node runtime selection types.
+ *
+ * These are intentionally host-agnostic: the resolver determines what a
+ * project requests, while a host-provided runtime adapter decides how to make
+ * that version available.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/toolchain/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/toolchain/types.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG"}

package/dist/types.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Public types for the build engine.
+ *
+ * Framework / deployment vocabulary is re-used from
+ * `@webflow/cosmic-deploy-contract` so there's a single source of truth shared
+ * with the deployer — the engine never re-declares these.
+ */
+import type { Framework, DeploymentType, WebflowJsonV1 } from '@webflow/cosmic-deploy-contract';
+import type { Logger, CommandRunner, Telemetry, FileSystemPort } from './ports';
+/**
+ * Host-injected capabilities. `logger` and `runCommand` are required (every
+ * host has its own); `telemetry` and `fs` fall back to the no-op / node
+ * defaults when omitted.
+ */
+export interface BuildPorts {
+    logger: Logger;
+    runCommand: CommandRunner;
+    telemetry?: Telemetry;
+    fs?: FileSystemPort;
+}
+export interface BuildOptions {
+    /** The user's project root. Treated as read-only — never mutated in place. */
+    projectDir: string;
+    /** Where the worker-ready output (entry + assets + webflow.json) is emitted. */
+    outputDir: string;
+    /**
+     * Ephemeral build directory. The project is copied here, mutated, and built,
+     * leaving `projectDir` pristine. Defaults to a fresh temp directory.
+     */
+    workspaceDir?: string;
+    /** URL mount path the app is served under (a.k.a. COSMIC_MOUNT_PATH). */
+    mountPath?: string;
+    /** Deploy URL, substituted into generated framework config where needed. */
+    deployUrl?: string;
+    /** Framework override; normally read from `webflow.json#cloud.framework`. */
+    frameworkHint?: Framework;
+    /**
+     * Settle the worker's `compatibility_date` at build and record it for the deploy (see
+     * compat-date.ts). Off by default: the template date is used unchanged.
+     */
+    compatDatePolicy?: boolean;
+    /** Extra environment variables made available to the build. */
+    env?: Record<string, string>;
+    /** Host-injected ports. */
+    ports: BuildPorts;
+}
+export interface BuildResult {
+    /** Detected framework (the contract's coarse vocabulary: astro | nextjs | vite). */
+    framework: Framework;
+    /** Deployment type the deployer uses to pick its wrangler template. */
+    deploymentType: DeploymentType;
+    /** Path to the bundled worker entry, relative to `outputDir`. */
+    entrypointPath: string;
+    /** The contract-validated webflow.json that was emitted. */
+    webflowJson: WebflowJsonV1;
+    /** Directory containing the worker entry, static assets, and webflow.json. */
+    outputDir: string;
+}
+export interface FrameworkDetection {
+    /** Detected framework (coarse vocabulary). */
+    framework: Framework;
+    /**
+     * Builder major when a framework ships incompatible majors the engine treats
+     * as distinct internally (e.g. Astro 5 vs 6). Undefined when not applicable.
+     */
+    major?: number;
+    /** Human-readable explanation of how it was detected, for logging. */
+    reason: string;
+}
+export type { Framework, DeploymentType, WebflowJsonV1 } from '@webflow/cosmic-deploy-contract';
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAEhG,OAAO,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAEhF;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,aAAa,CAAC;IAC1B,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,EAAE,CAAC,EAAE,cAAc,CAAC;CACrB;AAED,MAAM,WAAW,YAAY;IAC3B,8EAA8E;IAC9E,UAAU,EAAE,MAAM,CAAC;IACnB,gFAAgF;IAChF,SAAS,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,yEAAyE;IACzE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4EAA4E;IAC5E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6EAA6E;IAC7E,aAAa,CAAC,EAAE,SAAS,CAAC;IAC1B;;;OAGG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,+DAA+D;IAC/D,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,2BAA2B;IAC3B,KAAK,EAAE,UAAU,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,oFAAoF;IACpF,SAAS,EAAE,SAAS,CAAC;IACrB,uEAAuE;IACvE,cAAc,EAAE,cAAc,CAAC;IAC/B,iEAAiE;IACjE,cAAc,EAAE,MAAM,CAAC;IACvB,4DAA4D;IAC5D,WAAW,EAAE,aAAa,CAAC;IAC3B,8EAA8E;IAC9E,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,8CAA8C;IAC9C,SAAS,EAAE,SAAS,CAAC;IACrB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sEAAsE;IACtE,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,YAAY,EAAE,SAAS,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC"}

package/dist/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/utils/fs.d.ts

@@ -0,0 +1,29 @@
+import type { Logger } from '../ports';
+export interface RecursiveCopyOptions {
+    /** Pattern(s) to exclude from copying (matched against the basename). */
+    exclude?: string | string[];
+}
+/**
+ * Recursively copy directory contents.
+ *
+ * @returns Number of files copied.
+ */
+export declare function recursiveCopy(log: Logger, src: string, dest: string, options?: RecursiveCopyOptions): number;
+/** Check if a file exists. */
+export declare function fileExists(filePath: string): boolean;
+/**
+ * Match a basename against a simple glob pattern where `*` matches any run of
+ * non-`/` characters. A pattern without `*` is an exact-name match. Used by the
+ * static builder's asset-exclusion policy.
+ */
+export declare function matchesExcludePattern(name: string, pattern: string): boolean;
+/**
+ * Rename a user config file to a `clouduser.*` prefix.
+ *
+ * Searches for a config file with the given base name and extensions, renaming
+ * the first found to `clouduser.{baseName}.{ext}`.
+ *
+ * @returns Path to the renamed file, or null if no config found.
+ */
+export declare function renameUserConfig(log: Logger, cwd: string, baseName: string, extensions: string[]): string | null;
+//# sourceMappingURL=fs.d.ts.map

package/dist/utils/fs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.d.ts","sourceRoot":"","sources":["../../src/utils/fs.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAEvC,MAAM,WAAW,oBAAoB;IACnC,yEAAyE;IACzE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;CAC7B;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,oBAAoB,GAC7B,MAAM,CAqCR;AAED,8BAA8B;AAC9B,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEpD;AAOD;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAM5E;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAAE,GACnB,MAAM,GAAG,IAAI,CAWf"}

package/dist/utils/fs.js

@@ -0,0 +1,126 @@
+"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.recursiveCopy = recursiveCopy;
+exports.fileExists = fileExists;
+exports.matchesExcludePattern = matchesExcludePattern;
+exports.renameUserConfig = renameUserConfig;
+/**
+ * Synchronous filesystem helpers used for in-workspace file manipulation
+ * (copying build artifacts, renaming user configs aside). These operate on the
+ * ephemeral workspace; workspace-level isolate/collect goes through the
+ * FileSystem port instead.
+ */
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+/**
+ * Recursively copy directory contents.
+ *
+ * @returns Number of files copied.
+ */
+function recursiveCopy(log, src, dest, options) {
+    const excludePatterns = options?.exclude
+        ? Array.isArray(options.exclude)
+            ? options.exclude
+            : [options.exclude]
+        : [];
+    const baseName = path.basename(src);
+    if (excludePatterns.some((p) => baseName === p)) {
+        log.debug(`Skipping excluded: ${src}`);
+        return 0;
+    }
+    const stat = fs.statSync(src, { throwIfNoEntry: false });
+    if (!stat) {
+        log.debug(`Source does not exist: ${src}`);
+        return 0;
+    }
+    if (stat.isDirectory()) {
+        log.debug(`Copying directory: ${src} -> ${dest}`);
+        const contents = fs.readdirSync(src);
+        let count = 0;
+        for (const entry of contents) {
+            count += recursiveCopy(log, path.join(src, entry), path.join(dest, entry), options);
+        }
+        return count;
+    }
+    const destDir = path.dirname(dest);
+    if (!fs.existsSync(destDir)) {
+        fs.mkdirSync(destDir, { recursive: true });
+    }
+    log.debug(`Copying file: ${src} -> ${dest}`);
+    fs.copyFileSync(src, dest);
+    return 1;
+}
+/** Check if a file exists. */
+function fileExists(filePath) {
+    return fs.existsSync(filePath);
+}
+/** Escape a string for safe embedding in a RegExp. */
+function escapeRegExp(s) {
+    return s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+/**
+ * Match a basename against a simple glob pattern where `*` matches any run of
+ * non-`/` characters. A pattern without `*` is an exact-name match. Used by the
+ * static builder's asset-exclusion policy.
+ */
+function matchesExcludePattern(name, pattern) {
+    if (!pattern.includes('*')) {
+        return name === pattern;
+    }
+    const escaped = pattern.split('*').map(escapeRegExp).join('[^/]*');
+    return new RegExp(`^${escaped}$`).test(name);
+}
+/**
+ * Rename a user config file to a `clouduser.*` prefix.
+ *
+ * Searches for a config file with the given base name and extensions, renaming
+ * the first found to `clouduser.{baseName}.{ext}`.
+ *
+ * @returns Path to the renamed file, or null if no config found.
+ */
+function renameUserConfig(log, cwd, baseName, extensions) {
+    for (const ext of extensions) {
+        const from = path.join(cwd, `${baseName}.${ext}`);
+        if (fs.existsSync(from)) {
+            const to = path.join(cwd, `clouduser.${baseName}.${ext}`);
+            log.info(`Renaming user config: ${baseName}.${ext} -> clouduser.${baseName}.${ext}`);
+            fs.renameSync(from, to);
+            return to;
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=fs.js.map

package/dist/utils/fs.js.map

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

package/dist/utils/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Utility barrel. Builders import helpers from here (`../../utils`), matching
+ * the cosmic-builder layout so the cloned builder tests can mock this module.
+ */
+export * from './version';
+export * from './node-version';
+export * from './reserved-env';
+export * from './fs';
+export * from './template';
+export * from './process';
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,MAAM,CAAC;AACrB,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC"}

package/dist/utils/index.js

@@ -0,0 +1,27 @@
+"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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * Utility barrel. Builders import helpers from here (`../../utils`), matching
+ * the cosmic-builder layout so the cloned builder tests can mock this module.
+ */
+__exportStar(require("./version"), exports);
+__exportStar(require("./node-version"), exports);
+__exportStar(require("./reserved-env"), exports);
+__exportStar(require("./fs"), exports);
+__exportStar(require("./template"), exports);
+__exportStar(require("./process"), exports);
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA;;;GAGG;AACH,4CAA0B;AAC1B,iDAA+B;AAC/B,iDAA+B;AAC/B,uCAAqB;AACrB,6CAA2B;AAC3B,4CAA0B"}

package/dist/utils/node-version.d.ts

@@ -0,0 +1,20 @@
+import type { Logger } from '../ports';
+import type { NodeVersionRequirement } from '../frameworks/types';
+/** Get the current Node.js version string (without the 'v' prefix). */
+export declare function getCurrentNodeVersion(): string;
+/** Get the major version from a version string using semver.coerce. */
+export declare function getNodeMajorVersion(version: string): number | null;
+/** Compare two version strings. -1 if a<b, 0 if a==b, 1 if a>b, null if incomparable. */
+export declare function compareNodeVersions(a: string, b: string): number | null;
+/** Check whether `current` meets the `minimum` requirement (current >= minimum). */
+export declare function meetsVersionRequirement(current: string, minimum: string): boolean;
+/**
+ * Validate that the current Node.js version meets the requirement.
+ *
+ * - 'warn': logs a warning but allows the build to continue
+ * - 'error': throws FrameworkValidationError, stopping the build
+ */
+export declare function validateNodeVersion(log: Logger, requirement: NodeVersionRequirement, frameworkName: string): void;
+/** Get a human-readable description of the Node.js version requirement. */
+export declare function describeRequirement(requirement: NodeVersionRequirement): string;
+//# sourceMappingURL=node-version.d.ts.map

package/dist/utils/node-version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-version.d.ts","sourceRoot":"","sources":["../../src/utils/node-version.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAEvC,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAElE,uEAAuE;AACvE,wBAAgB,qBAAqB,IAAI,MAAM,CAE9C;AAED,uEAAuE;AACvE,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGlE;AAED,yFAAyF;AACzF,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAKvE;AAED,oFAAoF;AACpF,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CASjF;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,MAAM,EACX,WAAW,EAAE,sBAAsB,EACnC,aAAa,EAAE,MAAM,GACpB,IAAI,CAwBN;AAED,2EAA2E;AAC3E,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,sBAAsB,GAAG,MAAM,CAG/E"}

package/dist/utils/node-version.js

@@ -0,0 +1,113 @@
+"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.getCurrentNodeVersion = getCurrentNodeVersion;
+exports.getNodeMajorVersion = getNodeMajorVersion;
+exports.compareNodeVersions = compareNodeVersions;
+exports.meetsVersionRequirement = meetsVersionRequirement;
+exports.validateNodeVersion = validateNodeVersion;
+exports.describeRequirement = describeRequirement;
+/**
+ * Node.js version validation.
+ *
+ * Checks that the current Node.js version meets framework requirements, using
+ * semver for all parsing and comparison.
+ *
+ * - 'warn' severity: logs a warning but continues
+ * - 'error' severity: throws FrameworkValidationError
+ */
+const semver = __importStar(require("semver"));
+const errors_1 = require("../frameworks/errors");
+/** Get the current Node.js version string (without the 'v' prefix). */
+function getCurrentNodeVersion() {
+    return process.version.slice(1);
+}
+/** Get the major version from a version string using semver.coerce. */
+function getNodeMajorVersion(version) {
+    const coerced = semver.coerce(version);
+    return coerced ? coerced.major : null;
+}
+/** Compare two version strings. -1 if a<b, 0 if a==b, 1 if a>b, null if incomparable. */
+function compareNodeVersions(a, b) {
+    const coercedA = semver.coerce(a);
+    const coercedB = semver.coerce(b);
+    if (!coercedA || !coercedB)
+        return null;
+    return semver.compare(coercedA, coercedB);
+}
+/** Check whether `current` meets the `minimum` requirement (current >= minimum). */
+function meetsVersionRequirement(current, minimum) {
+    const coercedCurrent = semver.coerce(current);
+    const coercedMinimum = semver.coerce(minimum);
+    if (!coercedCurrent || !coercedMinimum) {
+        return false;
+    }
+    return semver.gte(coercedCurrent, coercedMinimum);
+}
+/**
+ * Validate that the current Node.js version meets the requirement.
+ *
+ * - 'warn': logs a warning but allows the build to continue
+ * - 'error': throws FrameworkValidationError, stopping the build
+ */
+function validateNodeVersion(log, requirement, frameworkName) {
+    const current = getCurrentNodeVersion();
+    const minimum = requirement.minimum;
+    if (!meetsVersionRequirement(current, minimum)) {
+        const majorVersion = getNodeMajorVersion(minimum);
+        const message = `${frameworkName} requires Node.js ${minimum} or higher. ` + `Current version: ${current}`;
+        if (requirement.severity === 'error') {
+            throw new errors_1.FrameworkValidationError(message, {
+                remediation: `Please upgrade Node.js to ${minimum} or higher. ` +
+                    `You can use nvm, fnm, or similar tools to manage Node.js versions.\n\n` +
+                    `  nvm install ${majorVersion}\n` +
+                    `  nvm use ${majorVersion}`,
+                documentationUrl: 'https://nodejs.org/en/download/',
+            });
+        }
+        else {
+            log.warn(`${message}. Build may fail or behave unexpectedly.`);
+        }
+    }
+    else {
+        log.debug(`Node.js version ${current} meets requirement ${minimum}`);
+    }
+}
+/** Get a human-readable description of the Node.js version requirement. */
+function describeRequirement(requirement) {
+    const severity = requirement.severity === 'error' ? 'required' : 'recommended';
+    return `Node.js ${requirement.minimum}+ (${severity})`;
+}
+//# sourceMappingURL=node-version.js.map

package/dist/utils/node-version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-version.js","sourceRoot":"","sources":["../../src/utils/node-version.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgBA,sDAEC;AAGD,kDAGC;AAGD,kDAKC;AAGD,0DASC;AAQD,kDA4BC;AAGD,kDAGC;AAtFD;;;;;;;;GAQG;AACH,+CAAiC;AAGjC,iDAAgE;AAGhE,uEAAuE;AACvE,SAAgB,qBAAqB;IACnC,OAAO,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AAClC,CAAC;AAED,uEAAuE;AACvE,SAAgB,mBAAmB,CAAC,OAAe;IACjD,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACvC,OAAO,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;AACxC,CAAC;AAED,yFAAyF;AACzF,SAAgB,mBAAmB,CAAC,CAAS,EAAE,CAAS;IACtD,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAClC,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAClC,IAAI,CAAC,QAAQ,IAAI,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAC;IACxC,OAAO,MAAM,CAAC,OAAO,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;AAC5C,CAAC;AAED,oFAAoF;AACpF,SAAgB,uBAAuB,CAAC,OAAe,EAAE,OAAe;IACtE,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC9C,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAE9C,IAAI,CAAC,cAAc,IAAI,CAAC,cAAc,EAAE,CAAC;QACvC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,MAAM,CAAC,GAAG,CAAC,cAAc,EAAE,cAAc,CAAC,CAAC;AACpD,CAAC;AAED;;;;;GAKG;AACH,SAAgB,mBAAmB,CACjC,GAAW,EACX,WAAmC,EACnC,aAAqB;IAErB,MAAM,OAAO,GAAG,qBAAqB,EAAE,CAAC;IACxC,MAAM,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC;IAEpC,IAAI,CAAC,uBAAuB,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,CAAC;QAC/C,MAAM,YAAY,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAC;QAClD,MAAM,OAAO,GACX,GAAG,aAAa,qBAAqB,OAAO,cAAc,GAAG,oBAAoB,OAAO,EAAE,CAAC;QAE7F,IAAI,WAAW,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;YACrC,MAAM,IAAI,iCAAwB,CAAC,OAAO,EAAE;gBAC1C,WAAW,EACT,6BAA6B,OAAO,cAAc;oBAClD,wEAAwE;oBACxE,iBAAiB,YAAY,IAAI;oBACjC,aAAa,YAAY,EAAE;gBAC7B,gBAAgB,EAAE,iCAAiC;aACpD,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,GAAG,CAAC,IAAI,CAAC,GAAG,OAAO,0CAA0C,CAAC,CAAC;QACjE,CAAC;IACH,CAAC;SAAM,CAAC;QACN,GAAG,CAAC,KAAK,CAAC,mBAAmB,OAAO,sBAAsB,OAAO,EAAE,CAAC,CAAC;IACvE,CAAC;AACH,CAAC;AAED,2EAA2E;AAC3E,SAAgB,mBAAmB,CAAC,WAAmC;IACrE,MAAM,QAAQ,GAAG,WAAW,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,aAAa,CAAC;IAC/E,OAAO,WAAW,WAAW,CAAC,OAAO,MAAM,QAAQ,GAAG,CAAC;AACzD,CAAC"}

package/dist/utils/process.d.ts

@@ -0,0 +1,25 @@
+/**
+ * npm execution.
+ *
+ * The original cosmic-builder spawned npm directly. Here it runs through the
+ * injected CommandRunner port so the host controls execution (and can sandbox
+ * it). Kept as a free function — rather than a base-class method — so it can be
+ * mocked at the module boundary the same way the cosmic-builder tests do.
+ */
+import type { Logger, CommandRunner } from '../ports';
+/** Standard npm arguments to reduce noise. */
+export declare const NPM_ARGS: string[];
+export interface NpmOptions {
+    log: Logger;
+    runCommand: CommandRunner;
+    cwd: string;
+    args: string[];
+    env?: Record<string, string>;
+}
+/**
+ * Execute an npm command with standardized arguments and telemetry disabled.
+ *
+ * Rejects (via the runner's CommandError) on a non-zero exit.
+ */
+export declare function npm(options: NpmOptions): Promise<void>;
+//# sourceMappingURL=process.d.ts.map

package/dist/utils/process.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process.d.ts","sourceRoot":"","sources":["../../src/utils/process.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEtD,8CAA8C;AAC9C,eAAO,MAAM,QAAQ,UAAuE,CAAC;AAE7F,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,aAAa,CAAC;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B;AAED;;;;GAIG;AACH,wBAAsB,GAAG,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CA8B5D"}

package/dist/utils/process.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NPM_ARGS = void 0;
+exports.npm = npm;
+/** Standard npm arguments to reduce noise. */
+exports.NPM_ARGS = ['--no-update-notifier', '--no-progress', '--no-audit', '--no-fund'];
+/**
+ * Execute an npm command with standardized arguments and telemetry disabled.
+ *
+ * Rejects (via the runner's CommandError) on a non-zero exit.
+ */
+async function npm(options) {
+    const { log, runCommand, cwd, args } = options;
+    // Inherit the host environment as the base so registry auth, proxies, custom
+    // CAs (NODE_EXTRA_CA_CERTS), and npm config resolution keep working — this
+    // matches how the legacy cosmic-builder / CLI ran npm (inherited env). A host
+    // that needs a hermetic or secret-isolated build env should inject its own
+    // CommandRunner rather than relying on this default.
+    const env = {};
+    for (const [key, value] of Object.entries(process.env)) {
+        if (value !== undefined)
+            env[key] = value;
+    }
+    // Caller-supplied vars (e.g. the user's build env) override inherited ones.
+    Object.assign(env, options.env ?? {});
+    // Disable telemetry regardless of what was inherited or passed.
+    env.WRANGLER_SEND_METRICS = 'false';
+    env.NEXT_TELEMETRY_DISABLED = '1';
+    log.debug(`npm ${[...exports.NPM_ARGS, ...args].join(' ')} (in ${cwd})`);
+    await runCommand.run('npm', [...exports.NPM_ARGS, ...args], {
+        cwd,
+        env,
+        onOutput: (chunk) => {
+            const trimmed = chunk.replace(/\s+$/, '');
+            if (trimmed)
+                log.info(trimmed);
+        },
+    });
+}
+//# sourceMappingURL=process.js.map

package/dist/utils/process.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process.js","sourceRoot":"","sources":["../../src/utils/process.ts"],"names":[],"mappings":";;;AA0BA,kBA8BC;AA9CD,8CAA8C;AACjC,QAAA,QAAQ,GAAG,CAAC,sBAAsB,EAAE,eAAe,EAAE,YAAY,EAAE,WAAW,CAAC,CAAC;AAU7F;;;;GAIG;AACI,KAAK,UAAU,GAAG,CAAC,OAAmB;IAC3C,MAAM,EAAE,GAAG,EAAE,UAAU,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC;IAE/C,6EAA6E;IAC7E,2EAA2E;IAC3E,8EAA8E;IAC9E,2EAA2E;IAC3E,qDAAqD;IACrD,MAAM,GAAG,GAA2B,EAAE,CAAC;IACvC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACvD,IAAI,KAAK,KAAK,SAAS;YAAE,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IAC5C,CAAC;IAED,4EAA4E;IAC5E,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,OAAO,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC;IAEtC,gEAAgE;IAChE,GAAG,CAAC,qBAAqB,GAAG,OAAO,CAAC;IACpC,GAAG,CAAC,uBAAuB,GAAG,GAAG,CAAC;IAElC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,gBAAQ,EAAE,GAAG,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,GAAG,GAAG,CAAC,CAAC;IAEjE,MAAM,UAAU,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,GAAG,gBAAQ,EAAE,GAAG,IAAI,CAAC,EAAE;QAClD,GAAG;QACH,GAAG;QACH,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE;YAClB,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;YAC1C,IAAI,OAAO;gBAAE,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACjC,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/utils/reserved-env.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Environment variable names that Webflow Cloud reserves for internal use.
+ *
+ * The build/deploy pipeline injects these names and the deployer maps them to
+ * Cloudflare Worker bindings. If a user-defined env var collides with one of
+ * them, the deploy step fails when Cloudflare rejects the duplicate binding
+ * (e.g. `Binding name 'COSMIC_MOUNT_PATH' already in use`), which previously
+ * surfaced only as a silent hang.
+ *
+ * This is a safety net: the dashboard (UI) and API reject reserved names before
+ * they are ever stored. This filter only catches names that slip through. Keep
+ * it in sync with the monorepo source of truth at
+ * `packages/systems/cosmic/constants/reservedEnvVarNames.ts` and with the
+ * system env declarations in cosmic-builder's `images/env.ts`.
+ */
+/** Reserved name prefixes — any key starting with one of these is reserved. */
+export declare const RESERVED_ENV_VAR_PREFIXES: readonly ["COSMIC_", "CLOUDFLARE_", "WRANGLER_"];
+/** Reserved exact names not already covered by a reserved prefix. */
+export declare const RESERVED_ENV_VAR_NAMES: readonly ["APP_NAME", "APP_PATH", "COMMIT_HASH", "DEPLOYMENT_ID", "COMPLETION_URL", "STARTED_URL", "OUTPUT_URL", "REPO_URL", "TARBALL_URL", "UPLOAD_CREDENTIALS", "HOSTNAME", "NODE_ENV", "NODE_VERSION"];
+/**
+ * Returns true if `key` is reserved for Webflow Cloud internal use and must not
+ * be applied as a user-defined environment variable. Matching is
+ * case-insensitive and ignores surrounding whitespace.
+ */
+export declare function isReservedEnvVarName(key: string): boolean;
+//# sourceMappingURL=reserved-env.d.ts.map

package/dist/utils/reserved-env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reserved-env.d.ts","sourceRoot":"","sources":["../../src/utils/reserved-env.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,+EAA+E;AAC/E,eAAO,MAAM,yBAAyB,kDAAmD,CAAC;AAE1F,qEAAqE;AACrE,eAAO,MAAM,sBAAsB,2MAczB,CAAC;AAIX;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAMzD"}