@webflow/cloud-app 0.1.0-beta.7

package/dist/frameworks/registry.js

@@ -0,0 +1,257 @@
+"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;
+    };
+})();
+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 });
+exports.FrameworkBuilder = exports.StaticBuilder = exports.ViteBuilder = exports.NextJsBuilder = exports.Astro7Builder = exports.Astro6Builder = exports.Astro5Builder = exports.ALLOWED_FRAMEWORKS = exports.FRAMEWORK_BUILDERS = void 0;
+exports.detectFrameworkBuilder = detectFrameworkBuilder;
+exports.detectFrameworkFromBuiltOutput = detectFrameworkFromBuiltOutput;
+exports.detectAndCreateBuilder = detectAndCreateBuilder;
+exports.resolveIsStaticApp = resolveIsStaticApp;
+exports.detectStaticApp = detectStaticApp;
+exports.getCustomerMajorVersion = getCustomerMajorVersion;
+exports.validateFrameworkName = validateFrameworkName;
+/**
+ * Framework Registry
+ *
+ * Central registry for all framework builders. Handles framework detection and
+ * builder creation.
+ */
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const cosmic_deploy_contract_1 = require("@webflow/cosmic-deploy-contract");
+const errors_1 = require("./errors");
+const utils_1 = require("../utils");
+const astro_1 = require("./astro");
+const nextjs_1 = require("./nextjs");
+const vite_1 = require("./vite");
+const static_1 = require("./static");
+// ───────────────────────────────────────────────────────────────────────────
+// FRAMEWORK REGISTRY
+// ───────────────────────────────────────────────────────────────────────────
+/**
+ * All registered framework builders, in detection order.
+ *
+ * IMPORTANT: Order matters — first match wins. More specific frameworks must
+ * come before generic ones.
+ *
+ * - Astro 7 before Astro 6 before Astro 5 (version-specific, newest first)
+ * - Next.js before Vite (uses Vite internally)
+ * - Vite before Static (Vite catches generic Vite SPAs)
+ * - Static last: matches only an explicit `framework: "static"` here; implicit
+ *   no-framework detection is a filesystem fallback the host resolves via
+ *   `resolveIsStaticApp` before calling into detection.
+ */
+exports.FRAMEWORK_BUILDERS = [
+    astro_1.Astro7Builder,
+    astro_1.Astro6Builder,
+    astro_1.Astro5Builder,
+    nextjs_1.NextJsBuilder,
+    vite_1.ViteBuilder,
+    static_1.StaticBuilder,
+];
+/**
+ * Allowed framework names for webflow.json. Single source of truth is the
+ * deploy contract's `Framework` enum — what's deployable is what's allowed.
+ *
+ * Note: Astro version (5 vs 6) is detected automatically from package.json.
+ * Users should always specify 'astro', not 'astro5' or 'astro6'.
+ */
+exports.ALLOWED_FRAMEWORKS = cosmic_deploy_contract_1.Framework.options;
+// ───────────────────────────────────────────────────────────────────────────
+// DETECTION
+// ───────────────────────────────────────────────────────────────────────────
+/**
+ * Detect which framework builder should handle this project. First-match-wins;
+ * order in FRAMEWORK_BUILDERS determines precedence.
+ *
+ * @returns The first matching builder class, or null if no match.
+ */
+function detectFrameworkBuilder(packageJson, webflowJson) {
+    for (const Builder of exports.FRAMEWORK_BUILDERS) {
+        const result = Builder.detect(packageJson, webflowJson);
+        if (result.detected) {
+            return { Builder, result };
+        }
+    }
+    return null;
+}
+/**
+ * Detect which framework produced the build artifacts in `cwd`.
+ *
+ * Used at deploy time when webflow.json may not have been written by the
+ * producer. Iterates registered builders and returns the first one whose
+ * `detectFromBuiltOutput` recognizes the output. Returns null if none match.
+ */
+function detectFrameworkFromBuiltOutput(cwd) {
+    for (const Builder of exports.FRAMEWORK_BUILDERS) {
+        if (Builder.detectFromBuiltOutput(cwd)) {
+            return Builder;
+        }
+    }
+    return null;
+}
+/**
+ * Detect and create the appropriate framework builder.
+ *
+ * @throws FrameworkDetectionError if no framework can be detected
+ */
+function detectAndCreateBuilder(ctx, webflowJson) {
+    const match = detectFrameworkBuilder(ctx.packageJson, webflowJson);
+    if (!match) {
+        throw new errors_1.FrameworkDetectionError('Could not detect framework from package.json or webflow.json', {
+            remediation: 'Create a webflow.json file with: { "cloud": { "framework": "astro" } } ' +
+                `(or one of: ${exports.ALLOWED_FRAMEWORKS.join(', ')}). ` +
+                'For a no-framework static site, use { "cloud": { "framework": "static" } }.',
+        });
+    }
+    ctx.log.info(`Detected framework: ${match.result.reason}`);
+    return new match.Builder(ctx);
+}
+/**
+ * Decide whether a project is a no-framework static app.
+ *
+ * Two ways in:
+ *   - **explicit**: webflow.json declares `framework: "static"`. This wins
+ *     unconditionally — even with a package.json present — so the explicit
+ *     opt-in is honored ahead of the package/index guard in the build flow.
+ *   - **inferred (zero-config)**: no package.json, a real `index.html` file at
+ *     the root, no *other* framework explicitly declared, and **no runtime/build
+ *     indicators** (`hasRuntimeIndicators`). `index.html` + no package.json is
+ *     only a preflight signal; a repo that also ships a build/server manifest
+ *     (requirements.txt, composer.json, Gemfile, Dockerfile, …) is a mixed
+ *     static+runtime repo and must NOT be silently published — the caller
+ *     rejects that case. The caller resolves `hasRootIndexHtmlFile` with a
+ *     regular-file check (not `existsSync`), so a directory or symlink named
+ *     `index.html` does not trigger inference.
+ */
+function resolveIsStaticApp(params) {
+    const { hasPackageJson, specifiedFramework, hasRootIndexHtmlFile, hasRuntimeIndicators } = params;
+    if (specifiedFramework === 'static') {
+        return true;
+    }
+    const declaresOtherFramework = specifiedFramework != null && specifiedFramework !== 'static';
+    return (!hasPackageJson && !declaresOtherFramework && hasRootIndexHtmlFile && !hasRuntimeIndicators);
+}
+/**
+ * Resolve whether `cwd` is a no-framework static app, doing the filesystem
+ * checks that `resolveIsStaticApp` needs: a regular-file root index.html and a
+ * recursive scan for runtime indicators. This is the single implementation both
+ * producers (cosmic-builder, webflow-cli) call, so static detection is
+ * identical everywhere.
+ *
+ * `index.html` + no package.json is only a preflight signal: a repo that also
+ * ships a build/server manifest is a mixed static+runtime repo whose source
+ * must not be silently published as assets. On the inference path (no explicit
+ * framework) such a repo is rejected loudly, naming the offending files. An
+ * explicit `framework: "static"` is honored even when those files are present.
+ *
+ * Requires a regular file for the inferred index.html (lstat, not existsSync)
+ * so a directory or symlink named index.html can't trigger inference.
+ *
+ * @throws FrameworkDetectionError for a mixed static+runtime repo on inference.
+ */
+function detectStaticApp(cwd, packageJson, webflowJson) {
+    const specifiedFramework = webflowJson?.cloud?.framework;
+    const indexHtmlStat = fs.lstatSync(path.join(cwd, 'index.html'), { throwIfNoEntry: false });
+    const hasRootIndexHtmlFile = indexHtmlStat?.isFile() ?? false;
+    const runtimeIndicators = (0, static_1.findRuntimeBuildIndicators)(cwd);
+    const isStatic = resolveIsStaticApp({
+        hasPackageJson: packageJson != null,
+        specifiedFramework,
+        hasRootIndexHtmlFile,
+        hasRuntimeIndicators: runtimeIndicators.length > 0,
+    });
+    if (!packageJson &&
+        !isStatic &&
+        hasRootIndexHtmlFile &&
+        runtimeIndicators.length > 0 &&
+        specifiedFramework == null) {
+        throw new errors_1.FrameworkDetectionError(`Found index.html but also build/runtime indicators (${runtimeIndicators.join(', ')}); this is not a no-framework static app and will not be published as static assets.`, {
+            remediation: 'Remove those files, or declare a framework in webflow.json (e.g. { "cloud": { "framework": "static" } } to force static).',
+        });
+    }
+    return { isStatic };
+}
+// ───────────────────────────────────────────────────────────────────────────
+// TELEMETRY
+// ───────────────────────────────────────────────────────────────────────────
+/**
+ * Read the customer's installed major version of a framework's primary npm
+ * package. Used only for metric tagging.
+ *
+ * `getMajorVersion` is defensive on empty/non-semver input (dist-tags, git
+ * URLs, 'workspace:*', etc.), so the 'unknown' fallback is unreachable in the
+ * normal path — kept for resilience to silent dep-tree changes.
+ */
+function getCustomerMajorVersion(packageName, packageJson) {
+    const spec = packageJson.dependencies?.[packageName] ?? packageJson.devDependencies?.[packageName] ?? '';
+    const major = (0, utils_1.getMajorVersion)(spec);
+    return major !== null ? String(major) : 'unknown';
+}
+// ───────────────────────────────────────────────────────────────────────────
+// VALIDATION
+// ───────────────────────────────────────────────────────────────────────────
+/**
+ * Validate that a framework name from webflow.json is supported.
+ *
+ * @throws FrameworkDetectionError if framework is not supported
+ */
+function validateFrameworkName(frameworkName) {
+    if (!exports.ALLOWED_FRAMEWORKS.includes(frameworkName)) {
+        throw new errors_1.FrameworkDetectionError(`Framework "${frameworkName}" is not supported`, {
+            remediation: `Must be one of: ${exports.ALLOWED_FRAMEWORKS.join(', ')}`,
+        });
+    }
+}
+// ───────────────────────────────────────────────────────────────────────────
+// EXPORTS
+// ───────────────────────────────────────────────────────────────────────────
+var astro_2 = require("./astro");
+Object.defineProperty(exports, "Astro5Builder", { enumerable: true, get: function () { return astro_2.Astro5Builder; } });
+Object.defineProperty(exports, "Astro6Builder", { enumerable: true, get: function () { return astro_2.Astro6Builder; } });
+Object.defineProperty(exports, "Astro7Builder", { enumerable: true, get: function () { return astro_2.Astro7Builder; } });
+var nextjs_2 = require("./nextjs");
+Object.defineProperty(exports, "NextJsBuilder", { enumerable: true, get: function () { return nextjs_2.NextJsBuilder; } });
+var vite_2 = require("./vite");
+Object.defineProperty(exports, "ViteBuilder", { enumerable: true, get: function () { return vite_2.ViteBuilder; } });
+var static_2 = require("./static");
+Object.defineProperty(exports, "StaticBuilder", { enumerable: true, get: function () { return static_2.StaticBuilder; } });
+var base_1 = require("./base");
+Object.defineProperty(exports, "FrameworkBuilder", { enumerable: true, get: function () { return base_1.FrameworkBuilder; } });
+__exportStar(require("./types"), exports);
+__exportStar(require("./errors"), exports);
+//# sourceMappingURL=registry.js.map

package/dist/frameworks/registry.js.map

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

package/dist/frameworks/static/index.d.ts

@@ -0,0 +1,93 @@
+import { FrameworkBuilder } from '../base';
+import type { BuildOutput, FrameworkInfo, PackageJson, WebflowJson, DetectionResult, AdapterPackage, IntegrationPackage, WebflowLoaderConfig, NodeVersionRequirement } from '../types';
+/**
+ * `_headers` / `_redirects` are Cloudflare asset-root metadata, not page
+ * content. They're only honored at the root of the assets directory, so the
+ * host relocates them there (regardless of mount path) rather than copying
+ * them under the mount-path prefix.
+ */
+export declare const ASSET_ROOT_METADATA: string[];
+/**
+ * Non-dotfile basename patterns that must never be published as static assets
+ * (`*` is a simple glob — see `matchesExcludePattern`). Dotfiles are handled
+ * separately by `shouldExcludeStaticAsset` (all excluded except `.well-known`).
+ */
+export declare const STATIC_ASSET_EXCLUDES: string[];
+/**
+ * The static publication boundary: decide whether a repo-root entry must be
+ * withheld from the published assets. Because the asset source is the whole
+ * checkout, the safe default is to treat anything config/secret/metadata-shaped
+ * as non-public rather than to enumerate every risky name.
+ *
+ * Policy:
+ *   - `.well-known` IS published (ACME challenges, security.txt, etc.).
+ *   - every OTHER dotfile / dot-directory is withheld — this covers `.env*`,
+ *     `.envrc`, `.git`, `.git-credentials`, `.npmrc`, `.aws/`, `.docker/`,
+ *     `.ssh/`, `.dev.vars`, … in one rule instead of a leaky enumeration.
+ *   - `_headers` / `_redirects` are withheld here because they're relocated to
+ *     the assets root separately.
+ *   - plus the explicit non-dotfile deny patterns above (deps, control files,
+ *     tf state, key material).
+ */
+export declare function shouldExcludeStaticAsset(basename: string): boolean;
+/**
+ * Build/runtime/package/auth manifest files whose presence means the repo is
+ * NOT a no-framework static site — it has a build step or a server runtime.
+ *
+ * Zero-config static inference (`index.html` + no package.json) is only a
+ * preflight signal; per the Static Site Hosting PRD it must be rejected when
+ * any of these appear alongside, so we never silently publish a mixed
+ * static+runtime repo's source (e.g. `server.py` next to a Composer
+ * `auth.json`). Node's `package.json` is handled separately by the detection
+ * flow, so it isn't listed here.
+ */
+export declare const RUNTIME_BUILD_INDICATORS: string[];
+/**
+ * Clear server entrypoint filenames. Unlike manifests these are source files,
+ * but a repo whose published tree contains one is running a server, not serving
+ * static assets — so it must not be inferred as static.
+ */
+export declare const SERVER_ENTRYPOINT_FILES: string[];
+/**
+ * Scan the **published tree** (not just the root) for build/runtime/server
+ * indicators, returning their repo-relative paths.
+ *
+ * The static copy publishes the whole checkout recursively, so a manifest or
+ * server entrypoint nested under e.g. `api/` (a root `index.html` next to
+ * `api/requirements.txt` + `api/server.py`) is just as much a mixed
+ * static+runtime signal as one at the root — and its source would otherwise be
+ * served publicly. Directories that are never published (dotfiles/dot-dirs,
+ * `node_modules`, and anything `shouldExcludeStaticAsset` withholds) are not
+ * descended into, and symlinks are not followed — matching the copy policy.
+ *
+ * A **nested** `package.json` (below the root) counts here too: it marks a
+ * Node runtime whose sibling source (e.g. `api/index.js`) would otherwise be
+ * published verbatim. The *root* `package.json` is intentionally NOT a signal —
+ * its presence means the repo isn't a zero-config static app at all, which the
+ * upstream detection flow already handles (static inference requires that there
+ * be no root `package.json`).
+ */
+export declare function findRuntimeBuildIndicators(cwd: string): string[];
+export declare class StaticBuilder extends FrameworkBuilder {
+    static frameworkName: string;
+    get info(): FrameworkInfo;
+    /**
+     * Match only when webflow.json explicitly opts in with framework "static".
+     *
+     * Implicit detection for a no-framework app (no package.json / index.html at
+     * the root) is handled as a fallback in the host, which has the working
+     * directory that this static, package.json-only signature cannot see.
+     */
+    static detect(packageJson: PackageJson, webflowJson?: WebflowJson): DetectionResult;
+    validate(): Promise<void>;
+    installDependencies(): Promise<void>;
+    getCloudflareAdapter(): AdapterPackage | null;
+    getRequiredIntegrations(): IntegrationPackage[];
+    getWebflowLoader(): WebflowLoaderConfig | null;
+    getNodeVersionRequirement(): NodeVersionRequirement | null;
+    getWranglerTemplatePath(): string;
+    prepareConfig(): Promise<void>;
+    getBuildCommand(): string | null;
+    static getOutputDeployMetadata(): BuildOutput;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/frameworks/static/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/frameworks/static/index.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAE3C,OAAO,KAAK,EACV,WAAW,EACX,aAAa,EACb,WAAW,EACX,WAAW,EACX,eAAe,EACf,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EACnB,sBAAsB,EACvB,MAAM,UAAU,CAAC;AAKlB;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,UAA6B,CAAC;AAE9D;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,UA+BjC,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAWlE;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,wBAAwB,UAmCpC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,UAenC,CAAC;AAIF;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAoChE;AAED,qBAAa,aAAc,SAAQ,gBAAgB;IACjD,OAAgB,aAAa,SAAY;IAMzC,IAAI,IAAI,IAAI,aAAa,CASxB;IAMD;;;;;;OAMG;WACa,MAAM,CAAC,WAAW,EAAE,WAAW,EAAE,WAAW,CAAC,EAAE,WAAW,GAAG,eAAe;IAWtF,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAiBzB,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC;IAI1C,oBAAoB,IAAI,cAAc,GAAG,IAAI;IAI7C,uBAAuB,IAAI,kBAAkB,EAAE;IAI/C,gBAAgB,IAAI,mBAAmB,GAAG,IAAI;IAI9C,yBAAyB,IAAI,sBAAsB,GAAG,IAAI;IAS1D,uBAAuB,IAAI,MAAM;IAI3B,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAUpC,eAAe,IAAI,MAAM,GAAG,IAAI;WAShB,uBAAuB,IAAI,WAAW;CAYvD"}