@webflow/cloud-app 0.1.0-beta.10

package/dist/frameworks/nextjs/adapter-resolver.js

@@ -0,0 +1,246 @@
+"use strict";
+/**
+ * Cloudflare adapter version resolution for Next.js.
+ *
+ * `@opennextjs/cloudflare` declares a `next` peer dependency whose range moves
+ * with each release and sometimes carves out "dead zones" — Next.js versions
+ * that are newer than an old floor but excluded by a tighter upper bound (e.g.
+ * peer `>=15.5.18 <16 || >=16.2.6` excludes next@16.0.0–16.2.5). Installing the
+ * adapter with no version constraint always pulls the latest, so an app pinned
+ * inside a dead zone fails with a cryptic npm `ERESOLVE` before the build even
+ * starts.
+ *
+ * This module resolves the concrete Next.js version the app will install and
+ * picks the highest published adapter release whose peer range accepts it,
+ * pinning that version explicitly. When the version cannot be determined it
+ * signals a fallback to the previous "install latest" behaviour; when no
+ * release is compatible it raises an actionable error instead of letting npm
+ * fail opaquely.
+ *
+ * All metadata is read through the app's own npm configuration (`npm view` run
+ * in the app directory), so adapter selection and the subsequent install
+ * resolve against the same registry, scoped registry, and auth.
+ */
+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.defaultAdapterResolverIO = void 0;
+exports.selectAdapterVersion = selectAdapterVersion;
+exports.resolveCompatibleAdapterVersion = resolveCompatibleAdapterVersion;
+const node_child_process_1 = require("node:child_process");
+const node_util_1 = require("node:util");
+const semver = __importStar(require("semver"));
+const errors_1 = require("../errors");
+const execFileAsync = (0, node_util_1.promisify)(node_child_process_1.execFile);
+/**
+ * Generous stdout cap for `npm view`: the adapter's full metadata (one manifest
+ * per published version) is a few MB and grows as releases accumulate.
+ */
+const NPM_MAX_BUFFER = 32 * 1024 * 1024;
+/** The framework package the adapter declares as a peer dependency. */
+const NEXT_PACKAGE = 'next';
+/**
+ * Pick the highest stable adapter version whose declared `next` peer range is
+ * satisfied by `installedNext`.
+ *
+ * Versions that declare no `next` peer dependency are ignored: they predate the
+ * adapter pinning Next.js and silently installing one would mask a real
+ * incompatibility. Prerelease adapter versions are ignored too. Returns null
+ * when nothing matches.
+ */
+function selectAdapterVersion(installedNext, candidates) {
+    const compatible = candidates
+        .filter((c) => c.nextPeerRange !== undefined)
+        .filter((c) => semver.valid(c.version) !== null && semver.prerelease(c.version) === null)
+        .filter((c) => semver.satisfies(installedNext, c.nextPeerRange, { includePrerelease: false }))
+        .map((c) => c.version);
+    if (compatible.length === 0) {
+        return null;
+    }
+    return compatible.sort(semver.rcompare)[0];
+}
+/**
+ * Resolve the adapter version to install for a project pinned to `nextSpec`,
+ * reading all metadata through the app's npm config at `cwd`.
+ *
+ * - Returns a concrete version string to pin when a compatible release exists.
+ * - Returns null when the Next.js version can't be determined or the metadata
+ *   lookup fails — the caller should fall back to installing the latest adapter
+ *   (the previous behaviour), which is no worse than before.
+ * - Throws {@link FrameworkValidationError} when the Next.js version is known
+ *   but no published adapter release accepts it, surfacing a clear remediation
+ *   instead of a downstream npm `ERESOLVE`.
+ */
+async function resolveCompatibleAdapterVersion(log, adapterName, nextSpec, cwd, io = exports.defaultAdapterResolverIO) {
+    let installedNext;
+    try {
+        installedNext = await io.resolveInstalledNextVersion(nextSpec, cwd);
+    }
+    catch (err) {
+        log.warn(`Could not determine the Next.js version from "${nextSpec}" (${errorMessage(err)}); ` +
+            `installing the latest ${adapterName}.`);
+        return null;
+    }
+    if (installedNext === null || semver.prerelease(installedNext) !== null) {
+        log.info(`Next.js version "${installedNext ?? nextSpec}" is unpinned, a prerelease, or local; ` +
+            `installing the latest ${adapterName}.`);
+        return null;
+    }
+    let candidates;
+    try {
+        candidates = await io.fetchAdapterCandidates(adapterName, cwd);
+    }
+    catch (err) {
+        log.warn(`Could not fetch ${adapterName} versions (${errorMessage(err)}); installing the latest.`);
+        return null;
+    }
+    const selected = selectAdapterVersion(installedNext, candidates);
+    if (selected !== null) {
+        log.info(`Resolved ${adapterName}@${selected} as compatible with next@${installedNext}.`);
+        return selected;
+    }
+    const supported = summarizeSupportedRanges(candidates);
+    // The build's top-level handler logs only `error.message`, so the actionable
+    // guidance must live in the message itself — not just in `remediation`.
+    throw new errors_1.FrameworkValidationError(`No ${adapterName} release is compatible with the installed Next.js version (next@${installedNext}). ` +
+        `Supported Next.js ranges: ${supported}. ` +
+        `Upgrade Next.js to a version within a supported range (e.g. the latest patch of your major), ` +
+        `or add a compatible ${adapterName} version to package.json.`, {
+        remediation: `Upgrade Next.js to a version within a supported range (for example, the latest patch of your major), ` +
+            `or add a compatible "${adapterName}" version to your package.json yourself.`,
+        documentationUrl: 'https://opennext.js.org/cloudflare',
+    });
+}
+/**
+ * Distinct `next` peer ranges across stable adapter releases, newest first,
+ * capped at a few entries — used to make the dead-zone error actionable.
+ */
+function summarizeSupportedRanges(candidates) {
+    const seen = new Set();
+    const ranges = [];
+    const stable = candidates
+        .filter((c) => c.nextPeerRange !== undefined)
+        .filter((c) => semver.valid(c.version) !== null && semver.prerelease(c.version) === null)
+        .sort((a, b) => semver.rcompare(a.version, b.version));
+    for (const c of stable) {
+        const range = c.nextPeerRange;
+        if (!seen.has(range)) {
+            seen.add(range);
+            ranges.push(range);
+        }
+    }
+    return ranges.slice(0, 3).join('; ') || '(none published)';
+}
+function errorMessage(err) {
+    return err instanceof Error ? err.message : String(err);
+}
+/** Run `npm view <args> --json` in `cwd` and return the parsed JSON (or null). */
+async function npmViewJson(args, cwd) {
+    const { stdout } = await execFileAsync('npm', ['view', ...args, '--json'], {
+        cwd,
+        maxBuffer: NPM_MAX_BUFFER,
+    });
+    const trimmed = stdout.trim();
+    return trimmed === '' ? null : JSON.parse(trimmed);
+}
+/**
+ * Read every published adapter version and its `next` peer range via `npm view`
+ * run in the app's `cwd`, so the metadata comes from the same registry/auth
+ * surface the install uses.
+ *
+ * `npm view <pkg>@>=0.0.0 --json` returns one manifest per published version
+ * (a single object when only one matches) with a stable shape — unlike
+ * field-filtered queries, whose JSON collapses to bare values when some versions
+ * omit the field. Each element redundantly carries the full packument, so the
+ * payload is a few MB; acceptable for this one-time, adapter-absent build step.
+ */
+async function fetchAdapterCandidatesViaNpm(adapterName, cwd) {
+    const parsed = await npmViewJson([`${adapterName}@>=0.0.0`], cwd);
+    const manifests = Array.isArray(parsed)
+        ? parsed
+        : parsed !== null
+            ? [parsed]
+            : [];
+    const candidates = [];
+    for (const manifest of manifests) {
+        if (typeof manifest.version !== 'string') {
+            continue;
+        }
+        const nextPeerRange = manifest.peerDependencies?.[NEXT_PACKAGE];
+        candidates.push({
+            version: manifest.version,
+            nextPeerRange: typeof nextPeerRange === 'string' ? nextPeerRange : undefined,
+        });
+    }
+    return candidates;
+}
+/**
+ * Resolve the concrete Next.js version npm would install for `nextSpec`, using
+ * the app's npm config at `cwd`.
+ *
+ * Exact pins skip the network. Ranges (`^`, `~`, `>=`, …) and dist-tags
+ * (`latest`, `canary`) are resolved with `npm view`. Non-registry specs
+ * (`file:`, `link:`, `workspace:`, `git+…`) make `npm view` exit non-zero; the
+ * caller treats the rejection as "unresolvable" and falls back to installing
+ * the latest adapter.
+ */
+async function resolveInstalledNextVersionViaNpm(nextSpec, cwd) {
+    const spec = nextSpec.trim();
+    if (spec === '') {
+        return null;
+    }
+    if (semver.valid(spec) !== null) {
+        return spec;
+    }
+    const parsed = await npmViewJson([`${NEXT_PACKAGE}@${spec}`, 'version'], cwd);
+    const list = Array.isArray(parsed)
+        ? parsed.filter((v) => typeof v === 'string')
+        : typeof parsed === 'string'
+            ? [parsed]
+            : [];
+    const valid = list.filter((v) => semver.valid(v) !== null);
+    if (valid.length === 0) {
+        return null;
+    }
+    // Mirror npm's default of installing the highest matching version, preferring
+    // a stable release over a prerelease when both match.
+    const stable = valid.filter((v) => semver.prerelease(v) === null);
+    return (stable.length > 0 ? stable : valid).sort(semver.rcompare)[0];
+}
+/** Production I/O: `npm view` run in the app's cwd. */
+exports.defaultAdapterResolverIO = {
+    fetchAdapterCandidates: fetchAdapterCandidatesViaNpm,
+    resolveInstalledNextVersion: resolveInstalledNextVersionViaNpm,
+};
+//# sourceMappingURL=adapter-resolver.js.map

package/dist/frameworks/nextjs/adapter-resolver.js.map

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

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

@@ -0,0 +1,38 @@
+import { FrameworkBuilder } from '../base';
+import type { BuildOutput, FrameworkInfo, PackageJson, WebflowJson, DetectionResult, AdapterPackage, IntegrationPackage, WebflowLoaderConfig, NodeVersionRequirement } from '../types';
+export declare class NextJsBuilder extends FrameworkBuilder {
+    static frameworkName: string;
+    get info(): FrameworkInfo;
+    getFrameworkVersion(): string | undefined;
+    /**
+     * Detect if this is a Next.js project.
+     */
+    static detect(packageJson: PackageJson, webflowJson?: WebflowJson): DetectionResult;
+    validate(): Promise<void>;
+    getCloudflareAdapter(): AdapterPackage;
+    getRequiredIntegrations(): IntegrationPackage[];
+    installDependencies(): Promise<void>;
+    getWebflowLoader(): WebflowLoaderConfig;
+    getUserConfigPatterns(): string[];
+    getWranglerTemplatePath(): string;
+    getAdditionalConfigFiles(): string[];
+    /** Checks if open-next.config.ts exists. */
+    private findOpenNextConfig;
+    /**
+     * Ensures open-next.config.ts exists.
+     * - If it exists: leave it alone for opennextjs-cloudflare to validate.
+     * - If missing: create it from the template.
+     */
+    private ensureOpenNextConfig;
+    prepareConfig(): Promise<void>;
+    getBuildCommand(): string;
+    getNodeVersionRequirement(): NodeVersionRequirement | null;
+    static getOutputDeployMetadata(): BuildOutput;
+    /**
+     * Detect Next.js from built output: presence of `./worker.js` (the bundled
+     * entrypoint produced by `opennextjs-cloudflare build`). Mirrors the legacy
+     * fallback the deploy phase used to hardcode.
+     */
+    static detectFromBuiltOutput(cwd: string): boolean;
+}
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/frameworks/nextjs/index.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAC3C,OAAO,KAAK,EACV,WAAW,EACX,aAAa,EACb,WAAW,EACX,WAAW,EACX,eAAe,EACf,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EACnB,sBAAsB,EACvB,MAAM,UAAU,CAAC;AAQlB,qBAAa,aAAc,SAAQ,gBAAgB;IACjD,OAAgB,aAAa,SAAY;IAMzC,IAAI,IAAI,IAAI,aAAa,CAOxB;IAEQ,mBAAmB,IAAI,MAAM,GAAG,SAAS;IAQlD;;OAEG;WACa,MAAM,CAAC,WAAW,EAAE,WAAW,EAAE,WAAW,CAAC,EAAE,WAAW,GAAG,eAAe;IA2BtF,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAmB/B,oBAAoB,IAAI,cAAc;IAStC,uBAAuB,IAAI,kBAAkB,EAAE;IAKzC,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC;IAiC1C,gBAAgB,IAAI,mBAAmB;IAQvC,qBAAqB,IAAI,MAAM,EAAE;IAIjC,uBAAuB,IAAI,MAAM;IAIjC,wBAAwB,IAAI,MAAM,EAAE;IAKpC,4CAA4C;IAC5C,OAAO,CAAC,kBAAkB;IAQ1B;;;;OAIG;IACH,OAAO,CAAC,oBAAoB;IAwBtB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IA6DpC,eAAe,IAAI,MAAM;IAIzB,yBAAyB,IAAI,sBAAsB,GAAG,IAAI;WAW1C,uBAAuB,IAAI,WAAW;IAUtD;;;;OAIG;WACa,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;CAG5D"}

package/dist/frameworks/nextjs/index.js

@@ -0,0 +1,268 @@
+"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.NextJsBuilder = void 0;
+/**
+ * Next.js Framework Builder
+ *
+ * Builds Next.js projects for Cloudflare Workers deployment using
+ * @opennextjs/cloudflare.
+ *
+ * - Requires @opennextjs/cloudflare
+ * - Build command: opennextjs-cloudflare build
+ * - Build output: .open-next/assets (static) + .open-next/worker.js (worker)
+ */
+const path = __importStar(require("node:path"));
+const fs = __importStar(require("node:fs"));
+const base_1 = require("../base");
+const errors_1 = require("../errors");
+const utils_1 = require("../../utils");
+const adapter_resolver_1 = require("./adapter-resolver");
+/** Base path for Next.js templates. */
+const TEMPLATE_BASE = path.join(__dirname, 'templates');
+class NextJsBuilder extends base_1.FrameworkBuilder {
+    static frameworkName = 'nextjs';
+    // ───────────────────────────────────────────────────────────────────────────
+    // FRAMEWORK INFO
+    // ───────────────────────────────────────────────────────────────────────────
+    get info() {
+        return {
+            name: 'nextjs',
+            version: '*',
+            displayName: 'Next.js',
+            packageName: 'next',
+        };
+    }
+    getFrameworkVersion() {
+        return this.resolveFrameworkVersion('next');
+    }
+    // ───────────────────────────────────────────────────────────────────────────
+    // DETECTION
+    // ───────────────────────────────────────────────────────────────────────────
+    /**
+     * Detect if this is a Next.js project.
+     */
+    static detect(packageJson, webflowJson) {
+        const specifiedFramework = webflowJson?.cloud?.framework;
+        if (specifiedFramework === 'nextjs') {
+            return { detected: true, reason: 'Specified as nextjs in webflow.json' };
+        }
+        // If webflow.json specifies a DIFFERENT framework, don't match.
+        if (specifiedFramework && specifiedFramework !== 'nextjs') {
+            return { detected: false };
+        }
+        const hasNext = packageJson.dependencies?.next !== undefined ||
+            packageJson.devDependencies?.next !== undefined;
+        if (hasNext) {
+            return { detected: true, reason: 'Found "next" in package.json' };
+        }
+        return { detected: false };
+    }
+    // ───────────────────────────────────────────────────────────────────────────
+    // VALIDATION
+    // ───────────────────────────────────────────────────────────────────────────
+    async validate() {
+        const { log, packageJson } = this.ctx;
+        const nextVersion = packageJson.dependencies?.next || packageJson.devDependencies?.next;
+        if (!nextVersion) {
+            throw new errors_1.FrameworkValidationError('Next.js is not installed in this project.', {
+                remediation: 'Install Next.js by running: npm install next',
+                documentationUrl: 'https://nextjs.org/docs/getting-started/installation',
+            });
+        }
+        log.info(`Validated Next.js project: next@${nextVersion}`);
+    }
+    // ───────────────────────────────────────────────────────────────────────────
+    // DEPENDENCIES
+    // ───────────────────────────────────────────────────────────────────────────
+    getCloudflareAdapter() {
+        return {
+            name: '@opennextjs/cloudflare',
+            // Fallback used only when a compatible version can't be resolved from the
+            // user's Next.js pin; installDependencies() normally pins an exact version.
+            version: '*',
+        };
+    }
+    getRequiredIntegrations() {
+        // No additional integrations required.
+        return [];
+    }
+    async installDependencies() {
+        const { log, cwd, runCommand } = this.ctx;
+        const adapter = this.getCloudflareAdapter();
+        // Respect an adapter version the user already pinned — don't second-guess it.
+        if (this.hasDependency(adapter.name)) {
+            return;
+        }
+        log.warn(`nextjs integration requires ${adapter.name} and this project doesn't have it. installing now...`);
+        // Pin the adapter to a release whose `next` peer range accepts the user's
+        // pinned Next.js, avoiding npm ERESOLVE peer-dependency dead zones. A null
+        // result means the Next.js version couldn't be determined — fall back to the
+        // latest adapter (prior behaviour); a genuinely incompatible Next.js throws.
+        const nextSpec = this.getDependencyVersion('next') ?? '';
+        const resolvedVersion = await (0, adapter_resolver_1.resolveCompatibleAdapterVersion)(log, adapter.name, nextSpec, cwd);
+        const args = resolvedVersion === null
+            ? ['install', '--save', adapter.name]
+            : ['install', '--save', '--save-exact', `${adapter.name}@${resolvedVersion}`];
+        await (0, utils_1.npm)({ log, runCommand, cwd, args });
+    }
+    // ───────────────────────────────────────────────────────────────────────────
+    // CONFIGURATION
+    // ───────────────────────────────────────────────────────────────────────────
+    getWebflowLoader() {
+        return {
+            templatePath: path.join(TEMPLATE_BASE, 'webflow-loader.ts'),
+            destinationName: 'webflow-loader.ts',
+            configPath: './webflow-loader.ts',
+        };
+    }
+    getUserConfigPatterns() {
+        return ['next.config.mjs', 'next.config.cjs', 'next.config.js', 'next.config.ts'];
+    }
+    getWranglerTemplatePath() {
+        return path.join(TEMPLATE_BASE, 'wrangler.json');
+    }
+    getAdditionalConfigFiles() {
+        const loader = this.getWebflowLoader();
+        return [loader.templatePath, path.join(TEMPLATE_BASE, 'open-next.config.ts')];
+    }
+    /** Checks if open-next.config.ts exists. */
+    findOpenNextConfig() {
+        const filename = 'open-next.config.ts';
+        if (fs.existsSync(path.join(this.cwd, filename))) {
+            return filename;
+        }
+        return undefined;
+    }
+    /**
+     * Ensures open-next.config.ts exists.
+     * - If it exists: leave it alone for opennextjs-cloudflare to validate.
+     * - If missing: create it from the template.
+     */
+    ensureOpenNextConfig(templatePath) {
+        const { log, cwd } = this.ctx;
+        const existingConfig = this.findOpenNextConfig();
+        if (existingConfig) {
+            log.info(`${existingConfig} found, skipping creation (opennextjs-cloudflare will validate)`);
+            return;
+        }
+        log.info('open-next.config not found, creating open-next.config.ts with default Webflow Cloud configuration...');
+        if (!fs.existsSync(templatePath)) {
+            throw new Error(`open-next.config.ts template not found at ${templatePath}. This is a Webflow Cloud build system error.`);
+        }
+        const configPath = path.join(cwd, 'open-next.config.ts');
+        fs.copyFileSync(templatePath, configPath);
+        log.info('open-next.config.ts created successfully');
+    }
+    async prepareConfig() {
+        const { log, cwd, userEnv } = this.ctx;
+        // Rename user's next.config.* to clouduser.next.config.*; if there is no
+        // user config, write an empty stub so the generated template's static
+        // import always resolves.
+        const renamedUserConfig = (0, utils_1.renameUserConfig)(log, cwd, 'next.config', ['mjs', 'cjs', 'js', 'ts']);
+        if (renamedUserConfig === null) {
+            log.info('no user next.config.{mjs,cjs,js,ts} found — writing empty clouduser.next.config.ts stub');
+            fs.writeFileSync(path.join(cwd, 'clouduser.next.config.ts'), 'export default {};\n');
+        }
+        else if (path.extname(renamedUserConfig) !== '.ts') {
+            // Next.js 16 type-checks next.config.ts with tsc, whose default module
+            // resolution can't find `.mjs`/`.cjs`/`.js` siblings of an extensionless
+            // import. Write a type-only shim so tsc resolves the import; runtime
+            // resolution is handled by Next.js's TS config loader and ignores .d.ts.
+            log.info(`writing clouduser.next.config.d.ts shim for ${path.basename(renamedUserConfig)}`);
+            fs.writeFileSync(path.join(cwd, 'clouduser.next.config.d.ts'), "import type { UserNextConfig } from './next.config.webflow';\ndeclare const config: UserNextConfig;\nexport default config;\n");
+        }
+        // Copy the merge-logic library (real source, not a template).
+        const webflowConfigSrc = path.join(TEMPLATE_BASE, 'next.config.webflow.ts');
+        if ((0, utils_1.fileExists)(webflowConfigSrc)) {
+            log.info('Copying next.config.webflow.ts...');
+            fs.copyFileSync(webflowConfigSrc, path.join(cwd, 'next.config.webflow.ts'));
+        }
+        // Render the single next.config.ts template.
+        const templatePath = path.join(TEMPLATE_BASE, 'next.config.ts.template');
+        const destPath = path.join(cwd, 'next.config.ts');
+        log.info('Generating next.config.ts from template...');
+        await (0, utils_1.envsubst)(log, templatePath, destPath, {
+            ...process.env,
+            ...userEnv,
+        });
+        // Copy webflow-loader.ts.
+        const loader = this.getWebflowLoader();
+        if ((0, utils_1.fileExists)(loader.templatePath)) {
+            log.info(`Copying ${loader.destinationName}...`);
+            fs.copyFileSync(loader.templatePath, path.join(cwd, loader.destinationName));
+        }
+        // Ensure open-next.config.ts exists.
+        this.ensureOpenNextConfig(path.join(TEMPLATE_BASE, 'open-next.config.ts'));
+        // wrangler.json is owned exclusively by `handleWranglerJson`, which runs
+        // before this hook and is the only function permitted to write
+        // /wrangler.json. Copying the framework template here would clobber its
+        // user-binding merge.
+    }
+    // ───────────────────────────────────────────────────────────────────────────
+    // BUILD
+    // ───────────────────────────────────────────────────────────────────────────
+    getBuildCommand() {
+        return 'opennextjs-cloudflare build';
+    }
+    getNodeVersionRequirement() {
+        return {
+            minimum: '18.0.0',
+            severity: 'error',
+        };
+    }
+    // ───────────────────────────────────────────────────────────────────────────
+    // OUTPUT
+    // ───────────────────────────────────────────────────────────────────────────
+    static getOutputDeployMetadata() {
+        return {
+            staticAssetsPath: '.open-next/assets',
+            workerEntryPath: '.open-next/worker.js',
+            deploymentType: 'ssr',
+            // After wrangler dry-run, the bundled output is ./worker.js
+            dryRunEntryPath: './worker.js',
+        };
+    }
+    /**
+     * Detect Next.js from built output: presence of `./worker.js` (the bundled
+     * entrypoint produced by `opennextjs-cloudflare build`). Mirrors the legacy
+     * fallback the deploy phase used to hardcode.
+     */
+    static detectFromBuiltOutput(cwd) {
+        return fs.statSync(path.join(cwd, './worker.js'), { throwIfNoEntry: false })?.isFile() ?? false;
+    }
+}
+exports.NextJsBuilder = NextJsBuilder;
+//# sourceMappingURL=index.js.map

package/dist/frameworks/nextjs/index.js.map

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

package/dist/frameworks/nextjs/templates/next.config.ts.template

@@ -0,0 +1,13 @@
+// Generated by the Webflow Cloud builder. Merge logic lives in ./next.config.webflow.ts.
+import userConfig from './clouduser.next.config';
+import { withWebflowOverrides } from './next.config.webflow';
+
+// Next.js disallows '/' as basePath, so '/' maps to ''.
+const mountPath: string = '${COSMIC_MOUNT_PATH}';
+export const webflowBasePath = mountPath === '/' ? '' : mountPath;
+export const webflowAssetPrefix = '${COSMIC_DEPLOY_URL}' + webflowBasePath;
+
+export default withWebflowOverrides(userConfig, {
+  basePath: webflowBasePath,
+  assetPrefix: webflowAssetPrefix,
+});

package/dist/frameworks/nextjs/templates/next.config.webflow.ts

@@ -0,0 +1,46 @@
+// Merge logic for the generated next.config.ts. Copied verbatim into the
+// user's project; types are local to avoid Next.js cross-version drift.
+import type { NextConfig } from 'next';
+
+type NextConfigContext = { defaultConfig: NextConfig };
+type UserNextConfigFn = (phase: string, ctx: NextConfigContext) => NextConfig | Promise<NextConfig>;
+
+export type UserNextConfig = NextConfig | UserNextConfigFn;
+export type WebflowOverridesOptions = { basePath: string; assetPrefix: string };
+
+/**
+ * Wrap the user's Next.js config with Webflow Cloud's required overrides.
+ * `userExport` is always provided — `{}` when the user ships no next.config.
+ */
+export function withWebflowOverrides(
+  userExport: UserNextConfig,
+  opts: WebflowOverridesOptions,
+): UserNextConfigFn {
+  return async function nextConfig(phase: string, ctx: NextConfigContext): Promise<NextConfig> {
+    const resolved = await resolveUserConfig(userExport, phase, ctx);
+    return {
+      ...resolved,
+      basePath: opts.basePath,
+      assetPrefix: opts.assetPrefix,
+      images: {
+        ...resolved.images,
+        // TODO: support non-custom loaders (imgix, cloudinary, akamai) if they work
+        loader: 'custom',
+        loaderFile: resolved.images?.loaderFile || './webflow-loader.ts',
+      },
+    };
+  };
+}
+
+async function resolveUserConfig(
+  userExport: UserNextConfig,
+  phase: string,
+  ctx: NextConfigContext,
+): Promise<NextConfig> {
+  if (typeof userExport === 'function') {
+    return (await userExport(phase, ctx)) ?? {};
+  }
+  // `export default null` is rare but not impossible; guard so the spread in
+  // withWebflowOverrides can't NPE.
+  return userExport ?? {};
+}

package/dist/frameworks/nextjs/templates/open-next.config.ts

@@ -0,0 +1,3 @@
+import { defineCloudflareConfig } from '@opennextjs/cloudflare';
+
+export default defineCloudflareConfig();