@webflow/cloud-app 0.1.0-beta.7

package/dist/ports/logger.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.silentLogger = exports.consoleLogger = void 0;
+/** Default logger that writes to the console. Useful for the CLI and local runs. */
+exports.consoleLogger = {
+    debug: (message, ...args) => console.debug(message, ...args),
+    info: (message, ...args) => console.info(message, ...args),
+    warn: (message, ...args) => console.warn(message, ...args),
+    error: (message, ...args) => console.error(message, ...args),
+};
+/** Logger that drops everything. Useful for tests and headless callers. */
+exports.silentLogger = {
+    debug: () => { },
+    info: () => { },
+    warn: () => { },
+    error: () => { },
+};
+//# sourceMappingURL=logger.js.map

package/dist/ports/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/ports/logger.ts"],"names":[],"mappings":";;;AAkBA,oFAAoF;AACvE,QAAA,aAAa,GAAW;IACnC,KAAK,EAAE,CAAC,OAAO,EAAE,GAAG,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC;IAC5D,IAAI,EAAE,CAAC,OAAO,EAAE,GAAG,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC;IAC1D,IAAI,EAAE,CAAC,OAAO,EAAE,GAAG,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC;IAC1D,KAAK,EAAE,CAAC,OAAO,EAAE,GAAG,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC;CAC7D,CAAC;AAEF,2EAA2E;AAC9D,QAAA,YAAY,GAAW;IAClC,KAAK,EAAE,GAAG,EAAE,GAAE,CAAC;IACf,IAAI,EAAE,GAAG,EAAE,GAAE,CAAC;IACd,IAAI,EAAE,GAAG,EAAE,GAAE,CAAC;IACd,KAAK,EAAE,GAAG,EAAE,GAAE,CAAC;CAChB,CAAC"}

package/dist/ports/telemetry.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Telemetry port.
+ *
+ * The engine emits spans for the build phases (detect, install, build,
+ * dry-run) through this port. cosmic-builder wraps `dd-trace` so its existing
+ * Datadog dashboards keep working; the CLI and headless hosts pass the no-op.
+ * Keeping `dd-trace` out of the engine is what lets it stay public and
+ * dependency-light.
+ */
+export type TagValue = string | number | boolean;
+export interface Span {
+    /** Attach a tag to the span (e.g. `framework`, `deployment.type`). */
+    setTag(key: string, value: TagValue): void;
+    /** Finish the span. Pass an error to mark it failed. */
+    end(error?: unknown): void;
+}
+export interface Telemetry {
+    /** Start a span for a build phase. Tags may be supplied up front. */
+    startSpan(name: string, tags?: Record<string, TagValue>): Span;
+}
+/** Telemetry that records nothing. Default when a host injects none. */
+export declare const noopTelemetry: Telemetry;
+//# sourceMappingURL=telemetry.d.ts.map

package/dist/ports/telemetry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.d.ts","sourceRoot":"","sources":["../../src/ports/telemetry.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAEjD,MAAM,WAAW,IAAI;IACnB,sEAAsE;IACtE,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,GAAG,IAAI,CAAC;IAC3C,wDAAwD;IACxD,GAAG,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;CAC5B;AAED,MAAM,WAAW,SAAS;IACxB,qEAAqE;IACrE,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,GAAG,IAAI,CAAC;CAChE;AAOD,wEAAwE;AACxE,eAAO,MAAM,aAAa,EAAE,SAE3B,CAAC"}

package/dist/ports/telemetry.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.noopTelemetry = void 0;
+const noopSpan = {
+    setTag: () => { },
+    end: () => { },
+};
+/** Telemetry that records nothing. Default when a host injects none. */
+exports.noopTelemetry = {
+    startSpan: () => noopSpan,
+};
+//# sourceMappingURL=telemetry.js.map

package/dist/ports/telemetry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.js","sourceRoot":"","sources":["../../src/ports/telemetry.ts"],"names":[],"mappings":";;;AAuBA,MAAM,QAAQ,GAAS;IACrB,MAAM,EAAE,GAAG,EAAE,GAAE,CAAC;IAChB,GAAG,EAAE,GAAG,EAAE,GAAE,CAAC;CACd,CAAC;AAEF,wEAAwE;AAC3D,QAAA,aAAa,GAAc;IACtC,SAAS,EAAE,GAAG,EAAE,CAAC,QAAQ;CAC1B,CAAC"}

package/dist/toolchain/errors.d.ts

@@ -0,0 +1,32 @@
+import { WebflowAppError } from '../errors';
+import type { NodeVersionDeclarationSource } from './types';
+export type NodeToolchainFailurePhase = 'provisioning' | 'verification';
+/** Stable, customer-safe categories a host can persist and render. */
+export type NodeToolchainFailureCode = 'NVM_PROVISION_FAILED' | 'NODE_RUNTIME_VERIFICATION_FAILED';
+export interface NodeToolchainErrorOptions {
+    code: NodeToolchainFailureCode;
+    phase: NodeToolchainFailurePhase;
+    declarationSource?: NodeVersionDeclarationSource;
+    requestedVersion?: string;
+    resolvedVersion?: string;
+    remediation: string;
+    /** Provisioning and verification errors may be retried by a host. */
+    retryable: boolean;
+    cause?: unknown;
+}
+/**
+ * A Node-toolchain failure with a stable code and safe remediation. Hosts can
+ * log its cause privately while sending only these fields to customer surfaces.
+ */
+export declare class NodeToolchainError extends WebflowAppError {
+    readonly code: NodeToolchainFailureCode;
+    readonly phase: NodeToolchainFailurePhase;
+    readonly declarationSource?: NodeVersionDeclarationSource;
+    readonly requestedVersion?: string;
+    readonly resolvedVersion?: string;
+    readonly remediation: string;
+    readonly retryable: boolean;
+    readonly cause?: unknown;
+    constructor(message: string, options: NodeToolchainErrorOptions);
+}
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/toolchain/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAE5C,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,SAAS,CAAC;AAE5D,MAAM,MAAM,yBAAyB,GAAG,cAAc,GAAG,cAAc,CAAC;AAExE,sEAAsE;AACtE,MAAM,MAAM,wBAAwB,GAAG,sBAAsB,GAAG,kCAAkC,CAAC;AAEnG,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,wBAAwB,CAAC;IAC/B,KAAK,EAAE,yBAAyB,CAAC;IACjC,iBAAiB,CAAC,EAAE,4BAA4B,CAAC;IACjD,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,qEAAqE;IACrE,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;;GAGG;AACH,qBAAa,kBAAmB,SAAQ,eAAe;IACrD,QAAQ,CAAC,IAAI,EAAE,wBAAwB,CAAC;IACxC,QAAQ,CAAC,KAAK,EAAE,yBAAyB,CAAC;IAC1C,QAAQ,CAAC,iBAAiB,CAAC,EAAE,4BAA4B,CAAC;IAC1D,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;gBAEb,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,yBAAyB;CAWhE"}

package/dist/toolchain/errors.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NodeToolchainError = void 0;
+const errors_1 = require("../errors");
+/**
+ * A Node-toolchain failure with a stable code and safe remediation. Hosts can
+ * log its cause privately while sending only these fields to customer surfaces.
+ */
+class NodeToolchainError extends errors_1.WebflowAppError {
+    code;
+    phase;
+    declarationSource;
+    requestedVersion;
+    resolvedVersion;
+    remediation;
+    retryable;
+    cause;
+    constructor(message, options) {
+        super(message);
+        this.code = options.code;
+        this.phase = options.phase;
+        this.declarationSource = options.declarationSource;
+        this.requestedVersion = options.requestedVersion;
+        this.resolvedVersion = options.resolvedVersion;
+        this.remediation = options.remediation;
+        this.retryable = options.retryable;
+        this.cause = options.cause;
+    }
+}
+exports.NodeToolchainError = NodeToolchainError;
+//# sourceMappingURL=errors.js.map

package/dist/toolchain/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/toolchain/errors.ts"],"names":[],"mappings":";;;AAAA,sCAA4C;AAqB5C;;;GAGG;AACH,MAAa,kBAAmB,SAAQ,wBAAe;IAC5C,IAAI,CAA2B;IAC/B,KAAK,CAA4B;IACjC,iBAAiB,CAAgC;IACjD,gBAAgB,CAAU;IAC1B,eAAe,CAAU;IACzB,WAAW,CAAS;IACpB,SAAS,CAAU;IACnB,KAAK,CAAW;IAEzB,YAAY,OAAe,EAAE,OAAkC;QAC7D,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;QACzB,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAC3B,IAAI,CAAC,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC;QACnD,IAAI,CAAC,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC;QACjD,IAAI,CAAC,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC;QAC/C,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;QACvC,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;QACnC,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;IAC7B,CAAC;CACF;AArBD,gDAqBC"}

package/dist/toolchain/resolver.d.ts

@@ -0,0 +1,25 @@
+import type { PackageJson } from '../config/package-json';
+import type { NodeToolchainPolicy, ResolvedNodeToolchain } from './types';
+/**
+ * Initial hosted-build policy. The resolver accepts a policy from the host so
+ * later LTS releases do not require changing customer-facing resolution logic.
+ */
+export declare const DEFAULT_NODE_TOOLCHAIN_POLICY: NodeToolchainPolicy;
+export interface ResolveNodeToolchainOptions {
+    /** Ephemeral project workspace containing version files and package.json. */
+    projectDir: string;
+    packageJson: PackageJson;
+    /** Omit to use the initial Node 24 policy. */
+    policy?: NodeToolchainPolicy;
+}
+/**
+ * Resolve a project's Node declaration to one exact version allowed by the
+ * policy. Version declarations use the Cloud contract's precedence order:
+ * .nvmrc, then .node-version, then package.json engines. Lower-priority
+ * declarations are ignored unless they resolve to a different supported
+ * release, in which case the result is marked as conflicting. An invalid or
+ * unsupported selected declaration falls back to the host default and returns
+ * a customer-safe warning.
+ */
+export declare function resolveNodeToolchain(options: ResolveNodeToolchainOptions): ResolvedNodeToolchain;
+//# sourceMappingURL=resolver.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.d.ts","sourceRoot":"","sources":["../../src/toolchain/resolver.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAE1D,OAAO,KAAK,EACV,mBAAmB,EAEnB,qBAAqB,EACtB,MAAM,SAAS,CAAC;AAEjB;;;GAGG;AACH,eAAO,MAAM,6BAA6B,EAAE,mBAI3C,CAAC;AAEF,MAAM,WAAW,2BAA2B;IAC1C,6EAA6E;IAC7E,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,WAAW,CAAC;IACzB,8CAA8C;IAC9C,MAAM,CAAC,EAAE,mBAAmB,CAAC;CAC9B;AAuBD;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,2BAA2B,GAAG,qBAAqB,CA4EhG"}

package/dist/toolchain/resolver.js

@@ -0,0 +1,200 @@
+"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.DEFAULT_NODE_TOOLCHAIN_POLICY = void 0;
+exports.resolveNodeToolchain = resolveNodeToolchain;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const semver = __importStar(require("semver"));
+/**
+ * Initial hosted-build policy. The resolver accepts a policy from the host so
+ * later LTS releases do not require changing customer-facing resolution logic.
+ */
+exports.DEFAULT_NODE_TOOLCHAIN_POLICY = {
+    defaultVersion: '24.15.0',
+    supportedVersions: ['24.15.0'],
+    supportedLtsVersions: ['24.15.0'],
+};
+/**
+ * Resolve a project's Node declaration to one exact version allowed by the
+ * policy. Version declarations use the Cloud contract's precedence order:
+ * .nvmrc, then .node-version, then package.json engines. Lower-priority
+ * declarations are ignored unless they resolve to a different supported
+ * release, in which case the result is marked as conflicting. An invalid or
+ * unsupported selected declaration falls back to the host default and returns
+ * a customer-safe warning.
+ */
+function resolveNodeToolchain(options) {
+    const policy = normalizePolicy(options.policy ?? exports.DEFAULT_NODE_TOOLCHAIN_POLICY);
+    const declarations = readDeclarations(options.projectDir, options.packageJson);
+    const declaration = declarations[0];
+    if (!declaration) {
+        return {
+            declarationSource: 'default',
+            resolvedVersion: policy.defaultVersion,
+            resolution: 'default',
+        };
+    }
+    if (!isValidDeclaration(declaration)) {
+        return {
+            declarationSource: declaration.source,
+            requestedVersion: declaration.requestedVersion,
+            resolvedVersion: policy.defaultVersion,
+            resolution: 'invalid',
+            warning: `The Node.js version declared in ${sourceLabel(declaration.source)} is invalid` +
+                `${declaration.requestedVersion ? ` (${declaration.requestedVersion})` : ''}. ` +
+                `Using the baseline Node.js ${policy.defaultVersion} instead.`,
+        };
+    }
+    const resolvedVersion = resolveSupportedVersion(declaration, policy);
+    if (!resolvedVersion) {
+        return {
+            declarationSource: declaration.source,
+            requestedVersion: declaration.requestedVersion,
+            resolvedVersion: policy.defaultVersion,
+            resolution: declaration.kind === 'lts' ? 'unresolvable' : 'unsupported',
+            warning: declaration.kind === 'lts'
+                ? `The Node.js LTS version requested by ${sourceLabel(declaration.source)} could not be resolved ` +
+                    `from Webflow Cloud's supported LTS releases. Using the baseline Node.js ${policy.defaultVersion} instead.`
+                : `The Node.js version requested by ${sourceLabel(declaration.source)} (${declaration.requestedVersion}) ` +
+                    `is not supported by Webflow Cloud. Using the baseline Node.js ${policy.defaultVersion} instead.`,
+        };
+    }
+    const conflictingDeclarationSources = declarations
+        .slice(1)
+        .filter(isValidDeclaration)
+        .flatMap((lowerPriority) => {
+        const lowerPriorityVersion = resolveSupportedVersion(lowerPriority, policy);
+        return lowerPriorityVersion && lowerPriorityVersion !== resolvedVersion
+            ? [lowerPriority.source]
+            : [];
+    });
+    if (conflictingDeclarationSources.length > 0) {
+        return {
+            declarationSource: declaration.source,
+            requestedVersion: declaration.requestedVersion,
+            resolvedVersion,
+            resolution: 'conflicting',
+            conflictingDeclarationSources,
+            warning: `Conflicting Node.js version declarations were found. Using ${sourceLabel(declaration.source)} ` +
+                `(${declaration.requestedVersion}) according to precedence.`,
+        };
+    }
+    return {
+        declarationSource: declaration.source,
+        requestedVersion: declaration.requestedVersion,
+        resolvedVersion,
+        resolution: 'declared',
+        warning: declaration.requestedVersion === resolvedVersion
+            ? undefined
+            : `Resolved ${sourceLabel(declaration.source)} (${declaration.requestedVersion}) to supported Node.js ${resolvedVersion}.`,
+    };
+}
+function normalizePolicy(policy) {
+    const supportedVersions = policy.supportedVersions.map((version) => semver.valid(version));
+    if (supportedVersions.some((version) => version === null)) {
+        throw new TypeError('Node toolchain policy supportedVersions must contain exact semver versions.');
+    }
+    const defaultVersion = semver.valid(policy.defaultVersion);
+    if (!defaultVersion || !supportedVersions.includes(defaultVersion)) {
+        throw new TypeError('Node toolchain policy defaultVersion must be an exact supported semver version.');
+    }
+    const supportedLtsVersions = policy.supportedLtsVersions.map((version) => semver.valid(version));
+    if (supportedLtsVersions.some((version) => version === null) ||
+        supportedLtsVersions.some((version) => !supportedVersions.includes(version))) {
+        throw new TypeError('Node toolchain policy supportedLtsVersions must contain exact supported semver versions.');
+    }
+    return {
+        defaultVersion,
+        supportedVersions: supportedVersions.sort(semver.rcompare),
+        supportedLtsVersions: supportedLtsVersions.sort(semver.rcompare),
+    };
+}
+function readDeclarations(projectDir, packageJson) {
+    const declarations = [];
+    const nvmrc = readVersionFile(projectDir, '.nvmrc');
+    if (nvmrc !== undefined) {
+        declarations.push(parseDeclaration('nvmrc', nvmrc));
+    }
+    const nodeVersion = readVersionFile(projectDir, '.node-version');
+    if (nodeVersion !== undefined) {
+        declarations.push(parseDeclaration('node-version', nodeVersion));
+    }
+    if (packageJson.engines?.node !== undefined) {
+        declarations.push(parseDeclaration('package-engines', packageJson.engines.node));
+    }
+    return declarations;
+}
+function readVersionFile(projectDir, filename) {
+    const filePath = path.join(projectDir, filename);
+    if (!fs.statSync(filePath, { throwIfNoEntry: false })) {
+        return undefined;
+    }
+    const declaration = fs.readFileSync(filePath, 'utf8').trim();
+    return declaration || undefined;
+}
+function parseDeclaration(source, raw) {
+    if (typeof raw !== 'string' || raw.trim() === '') {
+        return { source, requestedVersion: typeof raw === 'string' ? raw : undefined };
+    }
+    const requestedVersion = raw.trim();
+    // NVM's generic LTS alias can safely resolve to the host's current LTS
+    // allowlist. Named LTS aliases are intentionally not supported in v1.
+    if (source !== 'package-engines' && requestedVersion === 'lts/*') {
+        return { source, requestedVersion, kind: 'lts' };
+    }
+    const range = semver.validRange(requestedVersion.startsWith('v') ? requestedVersion.slice(1) : requestedVersion);
+    if (range === null) {
+        return { source, requestedVersion };
+    }
+    return { source, requestedVersion, kind: 'range', range };
+}
+function isValidDeclaration(declaration) {
+    return 'kind' in declaration;
+}
+function resolveSupportedVersion(declaration, policy) {
+    if (declaration.kind === 'lts') {
+        return policy.supportedLtsVersions[0];
+    }
+    return policy.supportedVersions.find((version) => semver.satisfies(version, declaration.range));
+}
+function sourceLabel(source) {
+    if (source === 'nvmrc')
+        return '.nvmrc';
+    if (source === 'node-version')
+        return '.node-version';
+    return 'package.json#engines.node';
+}
+//# sourceMappingURL=resolver.js.map

package/dist/toolchain/resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.js","sourceRoot":"","sources":["../../src/toolchain/resolver.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6DA,oDA4EC;AAzID,4CAA8B;AAC9B,gDAAkC;AAElC,+CAAiC;AAUjC;;;GAGG;AACU,QAAA,6BAA6B,GAAwB;IAChE,cAAc,EAAE,SAAS;IACzB,iBAAiB,EAAE,CAAC,SAAS,CAAC;IAC9B,oBAAoB,EAAE,CAAC,SAAS,CAAC;CAClC,CAAC;AA+BF;;;;;;;;GAQG;AACH,SAAgB,oBAAoB,CAAC,OAAoC;IACvE,MAAM,MAAM,GAAG,eAAe,CAAC,OAAO,CAAC,MAAM,IAAI,qCAA6B,CAAC,CAAC;IAChF,MAAM,YAAY,GAAG,gBAAgB,CAAC,OAAO,CAAC,UAAU,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;IAC/E,MAAM,WAAW,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC;IAEpC,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,OAAO;YACL,iBAAiB,EAAE,SAAS;YAC5B,eAAe,EAAE,MAAM,CAAC,cAAc;YACtC,UAAU,EAAE,SAAS;SACtB,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,kBAAkB,CAAC,WAAW,CAAC,EAAE,CAAC;QACrC,OAAO;YACL,iBAAiB,EAAE,WAAW,CAAC,MAAM;YACrC,gBAAgB,EAAE,WAAW,CAAC,gBAAgB;YAC9C,eAAe,EAAE,MAAM,CAAC,cAAc;YACtC,UAAU,EAAE,SAAS;YACrB,OAAO,EACL,mCAAmC,WAAW,CAAC,WAAW,CAAC,MAAM,CAAC,aAAa;gBAC/E,GAAG,WAAW,CAAC,gBAAgB,CAAC,CAAC,CAAC,KAAK,WAAW,CAAC,gBAAgB,GAAG,CAAC,CAAC,CAAC,EAAE,IAAI;gBAC/E,8BAA8B,MAAM,CAAC,cAAc,WAAW;SACjE,CAAC;IACJ,CAAC;IAED,MAAM,eAAe,GAAG,uBAAuB,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IAErE,IAAI,CAAC,eAAe,EAAE,CAAC;QACrB,OAAO;YACL,iBAAiB,EAAE,WAAW,CAAC,MAAM;YACrC,gBAAgB,EAAE,WAAW,CAAC,gBAAgB;YAC9C,eAAe,EAAE,MAAM,CAAC,cAAc;YACtC,UAAU,EAAE,WAAW,CAAC,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,aAAa;YACvE,OAAO,EACL,WAAW,CAAC,IAAI,KAAK,KAAK;gBACxB,CAAC,CAAC,wCAAwC,WAAW,CAAC,WAAW,CAAC,MAAM,CAAC,yBAAyB;oBAChG,2EAA2E,MAAM,CAAC,cAAc,WAAW;gBAC7G,CAAC,CAAC,oCAAoC,WAAW,CAAC,WAAW,CAAC,MAAM,CAAC,KAAK,WAAW,CAAC,gBAAgB,IAAI;oBACxG,iEAAiE,MAAM,CAAC,cAAc,WAAW;SACxG,CAAC;IACJ,CAAC;IAED,MAAM,6BAA6B,GAAG,YAAY;SAC/C,KAAK,CAAC,CAAC,CAAC;SACR,MAAM,CAAC,kBAAkB,CAAC;SAC1B,OAAO,CAAC,CAAC,aAAa,EAAE,EAAE;QACzB,MAAM,oBAAoB,GAAG,uBAAuB,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;QAC5E,OAAO,oBAAoB,IAAI,oBAAoB,KAAK,eAAe;YACrE,CAAC,CAAC,CAAC,aAAa,CAAC,MAAM,CAAC;YACxB,CAAC,CAAC,EAAE,CAAC;IACT,CAAC,CAAC,CAAC;IAEL,IAAI,6BAA6B,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC7C,OAAO;YACL,iBAAiB,EAAE,WAAW,CAAC,MAAM;YACrC,gBAAgB,EAAE,WAAW,CAAC,gBAAgB;YAC9C,eAAe;YACf,UAAU,EAAE,aAAa;YACzB,6BAA6B;YAC7B,OAAO,EACL,8DAA8D,WAAW,CAAC,WAAW,CAAC,MAAM,CAAC,GAAG;gBAChG,IAAI,WAAW,CAAC,gBAAgB,4BAA4B;SAC/D,CAAC;IACJ,CAAC;IAED,OAAO;QACL,iBAAiB,EAAE,WAAW,CAAC,MAAM;QACrC,gBAAgB,EAAE,WAAW,CAAC,gBAAgB;QAC9C,eAAe;QACf,UAAU,EAAE,UAAU;QACtB,OAAO,EACL,WAAW,CAAC,gBAAgB,KAAK,eAAe;YAC9C,CAAC,CAAC,SAAS;YACX,CAAC,CAAC,YAAY,WAAW,CAAC,WAAW,CAAC,MAAM,CAAC,KAAK,WAAW,CAAC,gBAAgB,0BAA0B,eAAe,GAAG;KAC/H,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CAAC,MAA2B;IAClD,MAAM,iBAAiB,GAAG,MAAM,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;IAC3F,IAAI,iBAAiB,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,KAAK,IAAI,CAAC,EAAE,CAAC;QAC1D,MAAM,IAAI,SAAS,CACjB,6EAA6E,CAC9E,CAAC;IACJ,CAAC;IAED,MAAM,cAAc,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;IAC3D,IAAI,CAAC,cAAc,IAAI,CAAC,iBAAiB,CAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC;QACnE,MAAM,IAAI,SAAS,CACjB,iFAAiF,CAClF,CAAC;IACJ,CAAC;IAED,MAAM,oBAAoB,GAAG,MAAM,CAAC,oBAAoB,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;IACjG,IACE,oBAAoB,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,KAAK,IAAI,CAAC;QACxD,oBAAoB,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,iBAAiB,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,EAC5E,CAAC;QACD,MAAM,IAAI,SAAS,CACjB,0FAA0F,CAC3F,CAAC;IACJ,CAAC;IAED,OAAO;QACL,cAAc;QACd,iBAAiB,EAAG,iBAA8B,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC;QACxE,oBAAoB,EAAG,oBAAiC,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC;KAC/E,CAAC;AACJ,CAAC;AAED,SAAS,gBAAgB,CACvB,UAAkB,EAClB,WAAwB;IAExB,MAAM,YAAY,GAAiC,EAAE,CAAC;IAEtD,MAAM,KAAK,GAAG,eAAe,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IACpD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,YAAY,CAAC,IAAI,CAAC,gBAAgB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;IACtD,CAAC;IAED,MAAM,WAAW,GAAG,eAAe,CAAC,UAAU,EAAE,eAAe,CAAC,CAAC;IACjE,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;QAC9B,YAAY,CAAC,IAAI,CAAC,gBAAgB,CAAC,cAAc,EAAE,WAAW,CAAC,CAAC,CAAC;IACnE,CAAC;IAED,IAAI,WAAW,CAAC,OAAO,EAAE,IAAI,KAAK,SAAS,EAAE,CAAC;QAC5C,YAAY,CAAC,IAAI,CAAC,gBAAgB,CAAC,iBAAiB,EAAE,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IACnF,CAAC;IAED,OAAO,YAAY,CAAC;AACtB,CAAC;AAED,SAAS,eAAe,CACtB,UAAkB,EAClB,QAAoC;IAEpC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IACjD,IAAI,CAAC,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,EAAE,cAAc,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;QACtD,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,WAAW,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;IAC7D,OAAO,WAAW,IAAI,SAAS,CAAC;AAClC,CAAC;AAED,SAAS,gBAAgB,CACvB,MAAwD,EACxD,GAAY;IAEZ,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACjD,OAAO,EAAE,MAAM,EAAE,gBAAgB,EAAE,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC;IACjF,CAAC;IAED,MAAM,gBAAgB,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IACpC,uEAAuE;IACvE,sEAAsE;IACtE,IAAI,MAAM,KAAK,iBAAiB,IAAI,gBAAgB,KAAK,OAAO,EAAE,CAAC;QACjE,OAAO,EAAE,MAAM,EAAE,gBAAgB,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;IACnD,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,CAAC,UAAU,CAC7B,gBAAgB,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAChF,CAAC;IACF,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACnB,OAAO,EAAE,MAAM,EAAE,gBAAgB,EAAE,CAAC;IACtC,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,gBAAgB,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;AAC5D,CAAC;AAED,SAAS,kBAAkB,CACzB,WAAuC;IAEvC,OAAO,MAAM,IAAI,WAAW,CAAC;AAC/B,CAAC;AAED,SAAS,uBAAuB,CAC9B,WAA+B,EAC/B,MAA2B;IAE3B,IAAI,WAAW,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;QAC/B,OAAO,MAAM,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC;IACxC,CAAC;IAED,OAAO,MAAM,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,EAAE,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC;AAClG,CAAC;AAED,SAAS,WAAW,CAAC,MAAwD;IAC3E,IAAI,MAAM,KAAK,OAAO;QAAE,OAAO,QAAQ,CAAC;IACxC,IAAI,MAAM,KAAK,cAAc;QAAE,OAAO,eAAe,CAAC;IACtD,OAAO,2BAA2B,CAAC;AACrC,CAAC"}

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,66 @@
+/**
+ * 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;
+    /** 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,+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"}