@webflow/cloud-app 0.1.0 → 1.0.0

package/README.md

@@ -10,13 +10,7 @@ config, runs the build, and produces a worker-ready output directory. No
 `wrangler.json`, no adapter packages in your `package.json`, no generated config
 files in your tree — all of that happens in an ephemeral build workspace.
 
-This is the same engine the Webflow CLI and Webflow Cloud's server-side builder
-use, so a build is identical wherever it runs.
-
-> **Status:** early. The public API and the host port seam below are stable; the
-> framework build pipeline is being extracted from the canonical
-> (cosmic-builder) implementation. `buildApp` throws `NotImplementedError` until
-> that lands.
+> **Status:** early. The public API and the host port seam below are stable.
 
 ## Install
 
@@ -42,16 +36,16 @@ const result = await buildApp({
 console.log(result.framework, result.deploymentType, result.entrypointPath);
 ```
 
-## Ports — running the same engine anywhere
+## Ports — running the engine anywhere
 
 Everything environment-specific is injected, so the engine itself is pure build
-logic and stays public-safe (no auth, upload, secrets, or vendor SDKs baked in).
+logic: no auth, no secrets, no vendor SDKs baked in.
 
 | Port         | Required | Default                                   | Why a host overrides it                                                |
 | ------------ | -------- | ----------------------------------------- | ---------------------------------------------------------------------- |
-| `logger`     | yes      | `consoleLogger` / `silentLogger` provided | route output into oclif spinners, ECS structured logs, etc.            |
+| `logger`     | yes      | `consoleLogger` / `silentLogger` provided | route output into a spinner, structured logs, etc.                     |
 | `runCommand` | yes      | `nodeCommandRunner` provided              | control/sandbox how `npm`, the framework build, and `wrangler` execute |
-| `telemetry`  | no       | `noopTelemetry`                           | wrap `dd-trace` so existing dashboards keep working                    |
+| `telemetry`  | no       | `noopTelemetry`                           | forward build events into your own tracing                             |
 | `fs`         | no       | `nodeFileSystem`                          | plug in a virtual filesystem (e.g. browser-based agents)               |
 
 ## `webflow.json`
@@ -76,7 +70,7 @@ You declare the binding name (and, for R2/D1, the resource name) — Webflow Clo
 provisions the resource and namespaces it per environment. KV ids / D1
 `database_id`s are assigned for you; omit them. Limits: up to 5 of each type; R2
 bucket names are lowercase alphanumeric + hyphens, ≤27 chars. (`vars` is not
-supported yet — it needs deployer support to propagate.)
+supported yet.)
 
 The deploy-contract fields (`contract_version`, `framework`, `deployment_type`,
 `entrypoint_path`, `skip_no_bundle`) are filled in by the build and validated
@@ -86,45 +80,8 @@ before output is produced.
 ## Development
 
 ```bash
-npm install      # from the monorepo root
+npm install
 npm test         # jest
 npm run build    # tsc → dist/
 npm run type-check
 ```
-
-## How consumers resolve this package
-
-Two consumers build with this engine: the Webflow CLI (`apps/webflow-cli`, same
-monorepo) and the cosmic-builder image (`webflow/infrastructure`, a separate
-repo). Which copy of `@webflow/cloud-app` they load is decided by **where
-`npm install` ran**, not by how the code is bundled and not at runtime — a
-`require("@webflow/cloud-app")` just reads whatever `npm` put in `node_modules`.
-
-| Scenario                                                                     | `node_modules/@webflow/cloud-app` is…                                                        | Source                                |
-| ---------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------- | ------------------------------------- |
-| End user runs `npm i -g @webflow/webflow-cli`                                | the registry copy npm fetched                                                                | npm registry                          |
-| Engineer working in the webflow-cli repo (`npm ci`, build, run local `dist`) | a symlink to `apps/webflow-cloud-app`                                                        | workspace (repo tree)                 |
-| CI for webflow-cli (unit, regression)                                        | a symlink to `apps/webflow-cloud-app`                                                        | workspace (repo tree)                 |
-| CI for webflow-cli (e2e, temp workspace outside the repo)                    | a tarball packed from this folder, or the published version the CLI depends on while it lags | workspace (repo tree) or npm registry |
-| cosmic-builder (separate repo)                                               | the registry copy npm fetched                                                                | npm registry                          |
-
-- **Inside this monorepo the CLI uses the workspace copy while it depends on
-  this package's current version.** `apps/webflow-cli` depends on it through an
-  npm alias to an exact version (`npm:@webflow/cloud-app@<version>`, enforced in
-  CI by `npm run check:cloud-app-pin`). While that version equals this package's
-  version, npm links the workspace copy, so editing the source here takes effect
-  on the next build. When this package has moved ahead, the CLI keeps using the
-  published version its alias names until the alias is changed on purpose.
-- **The published CLI uses the registry copy.** The engine is kept external in
-  the CLI's tsup bundle (it is CJS, not inlined), so the shipped `dist` keeps
-  `require("@webflow/cloud-app")` and resolves it at the user's install time.
-  The alias names an exact version, so released builds resolve exactly that
-  version from npm.
-- **cosmic-builder is a different repo**, so it has no workspace copy and always
-  resolves from the registry. That is why publishing to npm still
-  matters even though the CLI links the workspace in development.
-
-## Publishing
-
-Release instructions for the Cloud team are in
-[RELEASING.md](./RELEASING.md).

package/dist/assetVersionToken.d.ts

@@ -0,0 +1,9 @@
+/** Hosts check this before requesting versioned framework output from a release. */
+export declare const ASSET_VERSION_TOKEN_SUPPORT = 1;
+/** Typed host input wins over customer/process env during template rendering. */
+export declare function assetVersionTemplateEnvironment(token: string | undefined): {
+    WEBFLOW_ASSET_VERSION_TOKEN: string;
+};
+/** Run after dependency installation; older frameworks silently ignore this input. */
+export declare function assertAssetVersionFrameworkSupport(token: string | undefined, framework: 'nextjs' | 'astro', cwd: string): void;
+//# sourceMappingURL=assetVersionToken.d.ts.map

package/dist/assetVersionToken.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assetVersionToken.d.ts","sourceRoot":"","sources":["../src/assetVersionToken.ts"],"names":[],"mappings":"AAKA,oFAAoF;AACpF,eAAO,MAAM,2BAA2B,IAAI,CAAC;AAS7C,iFAAiF;AACjF,wBAAgB,+BAA+B,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG;IAC1E,2BAA2B,EAAE,MAAM,CAAC;CACrC,CAEA;AAED,sFAAsF;AACtF,wBAAgB,kCAAkC,CAChD,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,SAAS,EAAE,QAAQ,GAAG,OAAO,EAC7B,GAAG,EAAE,MAAM,GACV,IAAI,CAaN"}

package/dist/assetVersionToken.js

@@ -0,0 +1,37 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ASSET_VERSION_TOKEN_SUPPORT = void 0;
+exports.assetVersionTemplateEnvironment = assetVersionTemplateEnvironment;
+exports.assertAssetVersionFrameworkSupport = assertAssetVersionFrameworkSupport;
+const zod_1 = require("zod");
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const semver_1 = require("semver");
+/** Hosts check this before requesting versioned framework output from a release. */
+exports.ASSET_VERSION_TOKEN_SUPPORT = 1;
+const tokenSchema = zod_1.z
+    .string()
+    .min(1)
+    .max(128)
+    .regex(/^[A-Za-z0-9_-]+$/)
+    .refine((token) => !token.startsWith('dpl_'), 'The dpl_ prefix is reserved');
+/** Typed host input wins over customer/process env during template rendering. */
+function assetVersionTemplateEnvironment(token) {
+    return { WEBFLOW_ASSET_VERSION_TOKEN: token === undefined ? '' : tokenSchema.parse(token) };
+}
+/** Run after dependency installation; older frameworks silently ignore this input. */
+function assertAssetVersionFrameworkSupport(token, framework, cwd) {
+    if (token === undefined)
+        return;
+    const packageName = framework === 'nextjs' ? 'next' : 'astro';
+    const installed = zod_1.z
+        .object({ version: zod_1.z.string() })
+        .parse(JSON.parse(node_fs_1.default.readFileSync(node_path_1.default.join(cwd, 'node_modules', packageName, 'package.json'), 'utf8')));
+    const supported = framework === 'nextjs' ? '>=14.1.4' : '>=5.15.0';
+    if (!(0, semver_1.satisfies)(installed.version, supported, { includePrerelease: true }))
+        throw new Error(`Asset version tokens require ${framework} ${supported}`);
+}
+//# sourceMappingURL=assetVersionToken.js.map

package/dist/assetVersionToken.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assetVersionToken.js","sourceRoot":"","sources":["../src/assetVersionToken.ts"],"names":[],"mappings":";;;;;;AAgBA,0EAIC;AAGD,gFAiBC;AAxCD,6BAAwB;AACxB,sDAAyB;AACzB,0DAA6B;AAC7B,mCAAmC;AAEnC,oFAAoF;AACvE,QAAA,2BAA2B,GAAG,CAAC,CAAC;AAE7C,MAAM,WAAW,GAAG,OAAC;KAClB,MAAM,EAAE;KACR,GAAG,CAAC,CAAC,CAAC;KACN,GAAG,CAAC,GAAG,CAAC;KACR,KAAK,CAAC,kBAAkB,CAAC;KACzB,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,6BAA6B,CAAC,CAAC;AAE/E,iFAAiF;AACjF,SAAgB,+BAA+B,CAAC,KAAyB;IAGvE,OAAO,EAAE,2BAA2B,EAAE,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;AAC9F,CAAC;AAED,sFAAsF;AACtF,SAAgB,kCAAkC,CAChD,KAAyB,EACzB,SAA6B,EAC7B,GAAW;IAEX,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO;IAChC,MAAM,WAAW,GAAG,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC;IAC9D,MAAM,SAAS,GAAG,OAAC;SAChB,MAAM,CAAC,EAAE,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE,EAAE,CAAC;SAC/B,KAAK,CACJ,IAAI,CAAC,KAAK,CACR,iBAAE,CAAC,YAAY,CAAC,mBAAI,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,EAAE,WAAW,EAAE,cAAc,CAAC,EAAE,MAAM,CAAC,CACrF,CACF,CAAC;IACJ,MAAM,SAAS,GAAG,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC;IACnE,IAAI,CAAC,IAAA,kBAAS,EAAC,SAAS,CAAC,OAAO,EAAE,SAAS,EAAE,EAAE,iBAAiB,EAAE,IAAI,EAAE,CAAC;QACvE,MAAM,IAAI,KAAK,CAAC,gCAAgC,SAAS,IAAI,SAAS,EAAE,CAAC,CAAC;AAC9E,CAAC"}

package/dist/bindings.d.ts

@@ -20,151 +20,33 @@ export declare const MAX_BINDINGS_PER_TYPE = 5;
 export declare const KvBindingSchema: z.ZodObject<{
     binding: z.ZodString;
     id: z.ZodOptional<z.ZodString>;
-}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-    binding: z.ZodString;
-    id: z.ZodOptional<z.ZodString>;
-}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-    binding: z.ZodString;
-    id: z.ZodOptional<z.ZodString>;
-}, z.ZodTypeAny, "passthrough">>;
+}, z.core.$loose>;
 export declare const R2BindingSchema: z.ZodObject<{
     binding: z.ZodString;
     bucket_name: z.ZodString;
-}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-    binding: z.ZodString;
-    bucket_name: z.ZodString;
-}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-    binding: z.ZodString;
-    bucket_name: z.ZodString;
-}, z.ZodTypeAny, "passthrough">>;
+}, z.core.$loose>;
 export declare const D1BindingSchema: z.ZodObject<{
     binding: z.ZodString;
     database_name: z.ZodString;
     database_id: z.ZodOptional<z.ZodString>;
     migrations_dir: z.ZodOptional<z.ZodString>;
-}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-    binding: z.ZodString;
-    database_name: z.ZodString;
-    database_id: z.ZodOptional<z.ZodString>;
-    migrations_dir: z.ZodOptional<z.ZodString>;
-}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-    binding: z.ZodString;
-    database_name: z.ZodString;
-    database_id: z.ZodOptional<z.ZodString>;
-    migrations_dir: z.ZodOptional<z.ZodString>;
-}, z.ZodTypeAny, "passthrough">>;
+}, z.core.$loose>;
 export declare const BindingsSchema: z.ZodObject<{
     kv: z.ZodOptional<z.ZodArray<z.ZodObject<{
         binding: z.ZodString;
         id: z.ZodOptional<z.ZodString>;
-    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-        binding: z.ZodString;
-        id: z.ZodOptional<z.ZodString>;
-    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-        binding: z.ZodString;
-        id: z.ZodOptional<z.ZodString>;
-    }, z.ZodTypeAny, "passthrough">>, "many">>;
-    r2: z.ZodOptional<z.ZodArray<z.ZodObject<{
-        binding: z.ZodString;
-        bucket_name: z.ZodString;
-    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-        binding: z.ZodString;
-        bucket_name: z.ZodString;
-    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-        binding: z.ZodString;
-        bucket_name: z.ZodString;
-    }, z.ZodTypeAny, "passthrough">>, "many">>;
-    d1: z.ZodOptional<z.ZodArray<z.ZodObject<{
-        binding: z.ZodString;
-        database_name: z.ZodString;
-        database_id: z.ZodOptional<z.ZodString>;
-        migrations_dir: z.ZodOptional<z.ZodString>;
-    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-        binding: z.ZodString;
-        database_name: z.ZodString;
-        database_id: z.ZodOptional<z.ZodString>;
-        migrations_dir: z.ZodOptional<z.ZodString>;
-    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-        binding: z.ZodString;
-        database_name: z.ZodString;
-        database_id: z.ZodOptional<z.ZodString>;
-        migrations_dir: z.ZodOptional<z.ZodString>;
-    }, z.ZodTypeAny, "passthrough">>, "many">>;
-}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-    kv: z.ZodOptional<z.ZodArray<z.ZodObject<{
-        binding: z.ZodString;
-        id: z.ZodOptional<z.ZodString>;
-    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-        binding: z.ZodString;
-        id: z.ZodOptional<z.ZodString>;
-    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-        binding: z.ZodString;
-        id: z.ZodOptional<z.ZodString>;
-    }, z.ZodTypeAny, "passthrough">>, "many">>;
+    }, z.core.$loose>>>;
     r2: z.ZodOptional<z.ZodArray<z.ZodObject<{
         binding: z.ZodString;
         bucket_name: z.ZodString;
-    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-        binding: z.ZodString;
-        bucket_name: z.ZodString;
-    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-        binding: z.ZodString;
-        bucket_name: z.ZodString;
-    }, z.ZodTypeAny, "passthrough">>, "many">>;
+    }, z.core.$loose>>>;
     d1: z.ZodOptional<z.ZodArray<z.ZodObject<{
         binding: z.ZodString;
         database_name: z.ZodString;
         database_id: z.ZodOptional<z.ZodString>;
         migrations_dir: z.ZodOptional<z.ZodString>;
-    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-        binding: z.ZodString;
-        database_name: z.ZodString;
-        database_id: z.ZodOptional<z.ZodString>;
-        migrations_dir: z.ZodOptional<z.ZodString>;
-    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-        binding: z.ZodString;
-        database_name: z.ZodString;
-        database_id: z.ZodOptional<z.ZodString>;
-        migrations_dir: z.ZodOptional<z.ZodString>;
-    }, z.ZodTypeAny, "passthrough">>, "many">>;
-}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-    kv: z.ZodOptional<z.ZodArray<z.ZodObject<{
-        binding: z.ZodString;
-        id: z.ZodOptional<z.ZodString>;
-    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-        binding: z.ZodString;
-        id: z.ZodOptional<z.ZodString>;
-    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-        binding: z.ZodString;
-        id: z.ZodOptional<z.ZodString>;
-    }, z.ZodTypeAny, "passthrough">>, "many">>;
-    r2: z.ZodOptional<z.ZodArray<z.ZodObject<{
-        binding: z.ZodString;
-        bucket_name: z.ZodString;
-    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-        binding: z.ZodString;
-        bucket_name: z.ZodString;
-    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-        binding: z.ZodString;
-        bucket_name: z.ZodString;
-    }, z.ZodTypeAny, "passthrough">>, "many">>;
-    d1: z.ZodOptional<z.ZodArray<z.ZodObject<{
-        binding: z.ZodString;
-        database_name: z.ZodString;
-        database_id: z.ZodOptional<z.ZodString>;
-        migrations_dir: z.ZodOptional<z.ZodString>;
-    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-        binding: z.ZodString;
-        database_name: z.ZodString;
-        database_id: z.ZodOptional<z.ZodString>;
-        migrations_dir: z.ZodOptional<z.ZodString>;
-    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-        binding: z.ZodString;
-        database_name: z.ZodString;
-        database_id: z.ZodOptional<z.ZodString>;
-        migrations_dir: z.ZodOptional<z.ZodString>;
-    }, z.ZodTypeAny, "passthrough">>, "many">>;
-}, z.ZodTypeAny, "passthrough">>;
+    }, z.core.$loose>>>;
+}, z.core.$loose>;
 export type WebflowBindings = z.infer<typeof BindingsSchema>;
 /** Parse the raw `cloud.bindings` block. Returns undefined if it's absent/invalid-shaped. */
 export declare function parseBindings(raw: unknown): WebflowBindings | undefined;

package/dist/bindings.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bindings.d.ts","sourceRoot":"","sources":["../src/bindings.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,uEAAuE;AACvE,eAAO,MAAM,qBAAqB,IAAI,CAAC;AAUvC,eAAO,MAAM,eAAe;;;;;;;;;gCAEZ,CAAC;AACjB,eAAO,MAAM,eAAe;;;;;;;;;gCAEZ,CAAC;AACjB,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;gCAOZ,CAAC;AAEjB,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gCAMX,CAAC;AAEjB,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAE7D,6FAA6F;AAC7F,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,eAAe,GAAG,SAAS,CAGvE;AAED,+DAA+D;AAC/D,wBAAgB,cAAc,CAAC,QAAQ,EAAE,eAAe,GAAG,SAAS,GAAG,OAAO,CAG7E;AAED,2GAA2G;AAC3G,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAgBvD;AAED,wFAAwF;AACxF,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI,CAmBhE;AAED;;;GAGG;AACH,eAAO,MAAM,2BAA2B,eAAe,CAAC;AAExD;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,eAAe,EACzB,IAAI,SAAgB,GACnB,YAAY,CAmBd"}
+{"version":3,"file":"bindings.d.ts","sourceRoot":"","sources":["../src/bindings.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,uEAAuE;AACvE,eAAO,MAAM,qBAAqB,IAAI,CAAC;AAUvC,eAAO,MAAM,eAAe;;;iBAEZ,CAAC;AACjB,eAAO,MAAM,eAAe;;;iBAEZ,CAAC;AACjB,eAAO,MAAM,eAAe;;;;;iBAOZ,CAAC;AAEjB,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;iBAMX,CAAC;AAEjB,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAE7D,6FAA6F;AAC7F,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,eAAe,GAAG,SAAS,CAGvE;AAED,+DAA+D;AAC/D,wBAAgB,cAAc,CAAC,QAAQ,EAAE,eAAe,GAAG,SAAS,GAAG,OAAO,CAG7E;AAED,2GAA2G;AAC3G,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAgBvD;AAED,wFAAwF;AACxF,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI,CAmBhE;AAED;;;GAGG;AACH,eAAO,MAAM,2BAA2B,eAAe,CAAC;AAExD;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,eAAe,EACzB,IAAI,SAAgB,GACnB,YAAY,CAmBd"}

package/dist/config/package-json.d.ts

@@ -5,41 +5,14 @@ import { z } from 'zod';
  * Only the fields used by the framework builder are validated here.
  */
 export declare const PackageJsonSchema: z.ZodObject<{
-    /** Package name */
     name: z.ZodOptional<z.ZodString>;
-    /** Package version */
     version: z.ZodOptional<z.ZodString>;
-    /** Production dependencies (package name -> version specifier) */
     dependencies: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
-    /** Development dependencies (package name -> version specifier) */
     devDependencies: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
-    /** Runtime declarations. `node` is deliberately retained as unknown so the
-     * toolchain resolver can warn and fall back for a malformed customer
-     * declaration rather than rejecting the entire package.json. */
     engines: z.ZodOptional<z.ZodObject<{
         node: z.ZodOptional<z.ZodUnknown>;
-    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-        node: z.ZodOptional<z.ZodUnknown>;
-    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-        node: z.ZodOptional<z.ZodUnknown>;
-    }, z.ZodTypeAny, "passthrough">>>;
-}, "strip", z.ZodTypeAny, {
-    name?: string | undefined;
-    version?: string | undefined;
-    dependencies?: Record<string, string> | undefined;
-    devDependencies?: Record<string, string> | undefined;
-    engines?: z.objectOutputType<{
-        node: z.ZodOptional<z.ZodUnknown>;
-    }, z.ZodTypeAny, "passthrough"> | undefined;
-}, {
-    name?: string | undefined;
-    version?: string | undefined;
-    dependencies?: Record<string, string> | undefined;
-    devDependencies?: Record<string, string> | undefined;
-    engines?: z.objectInputType<{
-        node: z.ZodOptional<z.ZodUnknown>;
-    }, z.ZodTypeAny, "passthrough"> | undefined;
-}>;
+    }, z.core.$loose>>;
+}, z.core.$strip>;
 /**
  * Package.json structure (minimal fields we need).
  */

package/dist/config/package-json.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"package-json.d.ts","sourceRoot":"","sources":["../../src/config/package-json.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;GAIG;AACH,eAAO,MAAM,iBAAiB;IAC5B,mBAAmB;;IAEnB,sBAAsB;;IAEtB,kEAAkE;;IAElE,mEAAmE;;IAEnE;;oEAEgE;;;;;;;;;;;;;;;;;;;;;;;;EAOhE,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAoBpE"}
+{"version":3,"file":"package-json.d.ts","sourceRoot":"","sources":["../../src/config/package-json.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;GAIG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;iBAkB5B,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAoBpE"}

package/dist/config/package-json.js

@@ -49,9 +49,9 @@ exports.PackageJsonSchema = zod_1.z.object({
     /** Package version */
     version: zod_1.z.string().optional(),
     /** Production dependencies (package name -> version specifier) */
-    dependencies: zod_1.z.record(zod_1.z.string()).optional(),
+    dependencies: zod_1.z.record(zod_1.z.string(), zod_1.z.string()).optional(),
     /** Development dependencies (package name -> version specifier) */
-    devDependencies: zod_1.z.record(zod_1.z.string()).optional(),
+    devDependencies: zod_1.z.record(zod_1.z.string(), zod_1.z.string()).optional(),
     /** Runtime declarations. `node` is deliberately retained as unknown so the
      * toolchain resolver can warn and fall back for a malformed customer
      * declaration rather than rejecting the entire package.json. */

package/dist/config/package-json.js.map

@@ -1 +1 @@
-{"version":3,"file":"package-json.js","sourceRoot":"","sources":["../../src/config/package-json.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4CA,0CAoBC;AAhED,4CAA8B;AAC9B,gDAAkC;AAElC,6BAAwB;AAExB;;;;GAIG;AACU,QAAA,iBAAiB,GAAG,OAAC,CAAC,MAAM,CAAC;IACxC,mBAAmB;IACnB,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,sBAAsB;IACtB,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,kEAAkE;IAClE,YAAY,EAAE,OAAC,CAAC,MAAM,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC7C,mEAAmE;IACnE,eAAe,EAAE,OAAC,CAAC,MAAM,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IAChD;;oEAEgE;IAChE,OAAO,EAAE,OAAC;SACP,MAAM,CAAC;QACN,IAAI,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;KAC7B,CAAC;SACD,WAAW,EAAE;SACb,QAAQ,EAAE;CACd,CAAC,CAAC;AAOH;;;;;;;;GAQG;AACH,SAAgB,eAAe,CAAC,GAAW;IACzC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;IAChD,IAAI,CAAC,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,EAAE,cAAc,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;QACtD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAEvD,IAAI,QAAiB,CAAC;IACtB,IAAI,CAAC;QACH,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,iCAAiC,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;IACnE,CAAC;IAED,IAAI,CAAC;QACH,OAAO,yBAAiB,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC3C,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,uCAAuC,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;IACzE,CAAC;AACH,CAAC"}
+{"version":3,"file":"package-json.js","sourceRoot":"","sources":["../../src/config/package-json.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4CA,0CAoBC;AAhED,4CAA8B;AAC9B,gDAAkC;AAElC,6BAAwB;AAExB;;;;GAIG;AACU,QAAA,iBAAiB,GAAG,OAAC,CAAC,MAAM,CAAC;IACxC,mBAAmB;IACnB,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,sBAAsB;IACtB,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,kEAAkE;IAClE,YAAY,EAAE,OAAC,CAAC,MAAM,CAAC,OAAC,CAAC,MAAM,EAAE,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACzD,mEAAmE;IACnE,eAAe,EAAE,OAAC,CAAC,MAAM,CAAC,OAAC,CAAC,MAAM,EAAE,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC5D;;oEAEgE;IAChE,OAAO,EAAE,OAAC;SACP,MAAM,CAAC;QACN,IAAI,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;KAC7B,CAAC;SACD,WAAW,EAAE;SACb,QAAQ,EAAE;CACd,CAAC,CAAC;AAOH;;;;;;;;GAQG;AACH,SAAgB,eAAe,CAAC,GAAW;IACzC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;IAChD,IAAI,CAAC,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,EAAE,cAAc,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;QACtD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAEvD,IAAI,QAAiB,CAAC;IACtB,IAAI,CAAC;QACH,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,iCAAiC,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;IACnE,CAAC;IAED,IAAI,CAAC;QACH,OAAO,yBAAiB,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC3C,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,uCAAuC,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;IACzE,CAAC;AACH,CAAC"}

package/dist/failure-diagnostic.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Public build-failure diagnostics for hosts. `diagnoseBuildFailure` maps an
+ * error, walking a bounded and cycle-safe cause chain, to a
+ * `BuildFailureDiagnostic`: a `BuildFailureKind` from `BUILD_FAILURE_KINDS`, a
+ * bounded snake_case code and the optional
+ * `BuildFailureStage` it was called with. These values are safe to attach to
+ * telemetry and never include error messages or stacks.
+ */
+export declare const BUILD_FAILURE_KINDS: readonly ["detection", "validation", "config", "build", "toolchain", "command", "unknown"];
+export type BuildFailureKind = (typeof BUILD_FAILURE_KINDS)[number];
+export type BuildFailureStage = 'detect' | 'validate' | 'installDependencies' | 'prepareConfig' | 'build' | 'postBuild' | 'wranglerDryRun' | 'package' | 'upload' | 'unknown';
+export interface BuildFailureDiagnostic {
+    kind: BuildFailureKind;
+    /** Bounded snake_case sub-code, e.g. 'npm_eresolve', 'node_provision_failed', 'command_failed'. */
+    code: string;
+    stage?: BuildFailureStage;
+}
+export declare function diagnoseBuildFailure(error: unknown, stage?: BuildFailureStage): BuildFailureDiagnostic;
+//# sourceMappingURL=failure-diagnostic.d.ts.map

package/dist/failure-diagnostic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"failure-diagnostic.d.ts","sourceRoot":"","sources":["../src/failure-diagnostic.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAYH,eAAO,MAAM,mBAAmB,4FAQtB,CAAC;AAEX,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEpE,MAAM,MAAM,iBAAiB,GACzB,QAAQ,GACR,UAAU,GACV,qBAAqB,GACrB,eAAe,GACf,OAAO,GACP,WAAW,GACX,gBAAgB,GAChB,SAAS,GACT,QAAQ,GACR,SAAS,CAAC;AAEd,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,gBAAgB,CAAC;IACvB,mGAAmG;IACnG,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,iBAAiB,CAAC;CAC3B;AAyFD,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,OAAO,EACd,KAAK,CAAC,EAAE,iBAAiB,GACxB,sBAAsB,CAuCxB"}

package/dist/failure-diagnostic.js

@@ -0,0 +1,140 @@
+"use strict";
+/**
+ * Public build-failure diagnostics for hosts. `diagnoseBuildFailure` maps an
+ * error, walking a bounded and cycle-safe cause chain, to a
+ * `BuildFailureDiagnostic`: a `BuildFailureKind` from `BUILD_FAILURE_KINDS`, a
+ * bounded snake_case code and the optional
+ * `BuildFailureStage` it was called with. These values are safe to attach to
+ * telemetry and never include error messages or stacks.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BUILD_FAILURE_KINDS = void 0;
+exports.diagnoseBuildFailure = diagnoseBuildFailure;
+const errors_1 = require("./errors");
+const errors_2 = require("./frameworks/errors");
+const command_runner_1 = require("./ports/command-runner");
+const errors_3 = require("./toolchain/errors");
+exports.BUILD_FAILURE_KINDS = [
+    'detection',
+    'validation',
+    'config',
+    'build',
+    'toolchain',
+    'command',
+    'unknown',
+];
+const MAX_CAUSE_LINKS = 5;
+const CODE_PATTERN = /^[a-z0-9_]{1,40}$/;
+const NPM_ERROR_CODE_PATTERN = /npm (?:ERR!|error) code (\S+)/;
+// Subprocess output can contain project-controlled text. Only known codes may
+// become telemetry values; a character/length bound does not bound cardinality.
+// This is a curated telemetry allowlist, not an exhaustive npm error registry.
+// References for npm codes, usage errors, integrity errors, and system/DNS errors:
+// https://github.com/npm/cli/blob/v11.4.2/lib/utils/error-message.js
+// https://github.com/npm/cli/blob/v11.4.2/lib/base-cmd.js
+// https://github.com/npm/ssri/blob/main/lib/index.js
+// https://docs.libuv.org/en/v1.x/errors.html#error-constants
+// Legacy request socket timeout: https://github.com/request/request/blob/master/request.js
+const NPM_ERROR_CODES = new Set([
+    'ERESOLVE',
+    'ETARGET',
+    'E404',
+    'E401',
+    'E403',
+    'EINTEGRITY',
+    'ENOTFOUND',
+    'EAI_AGAIN',
+    'ECONNRESET',
+    'ECONNREFUSED',
+    'ETIMEDOUT',
+    'ESOCKETTIMEDOUT',
+    'ENETUNREACH',
+    'EACCES',
+    'EPERM',
+    'ENOSPC',
+    'ENOENT',
+    'EEXIST',
+    'EUSAGE',
+    'EBADENGINE',
+]);
+const NODE_TOOLCHAIN_CODES = {
+    NVM_PROVISION_FAILED: 'node_provision_failed',
+    NODE_RUNTIME_VERIFICATION_FAILED: 'node_runtime_verification_failed',
+};
+/**
+ * Hosts carry structurally identical framework error trees with no inheritance
+ * link to this package — the CLI's legacy builder and cosmic-builder's legacy
+ * engine each define their own `Framework*Error` classes — so `name` is the
+ * only shared contract, and nothing else about the object is inspected.
+ */
+const FRAMEWORK_ERROR_NAMES = {
+    FrameworkDetectionError: { kind: 'detection', code: 'detection_failed' },
+    FrameworkValidationError: { kind: 'validation', code: 'validation_failed' },
+    FrameworkConfigError: { kind: 'config', code: 'config_failed' },
+    FrameworkBuildError: { kind: 'build', code: 'build_failed' },
+};
+function boundCode(kind, code) {
+    if (typeof code === 'string' && CODE_PATTERN.test(code))
+        return code;
+    return kind === 'command' ? 'command_failed' : `${kind}_unknown`;
+}
+function diagnostic(kind, code, stage) {
+    return { kind, code: boundCode(kind, code), stage };
+}
+function commandFailureCode(error) {
+    const match = NPM_ERROR_CODE_PATTERN.exec(error.stderr) ?? NPM_ERROR_CODE_PATTERN.exec(error.stdout);
+    if (!match || !NPM_ERROR_CODES.has(match[1].toUpperCase()))
+        return 'command_failed';
+    return `npm_${match[1].toLowerCase()}`;
+}
+function causeOf(error) {
+    if (typeof error !== 'object' || error === null)
+        return undefined;
+    return error.cause;
+}
+function frameworkErrorByName(error) {
+    if (typeof error !== 'object' || error === null)
+        return undefined;
+    const { name } = error;
+    if (typeof name !== 'string' || !Object.hasOwn(FRAMEWORK_ERROR_NAMES, name))
+        return undefined;
+    return FRAMEWORK_ERROR_NAMES[name];
+}
+function diagnoseBuildFailure(error, stage) {
+    const seen = new Set();
+    let current = error;
+    for (let link = 0; link < MAX_CAUSE_LINKS; link++) {
+        if (seen.has(current))
+            break;
+        seen.add(current);
+        if (current instanceof errors_2.FrameworkDetectionError) {
+            return diagnostic('detection', 'detection_failed', stage);
+        }
+        if (current instanceof errors_2.FrameworkValidationError) {
+            return diagnostic('validation', 'validation_failed', stage);
+        }
+        if (current instanceof errors_2.FrameworkConfigError) {
+            return diagnostic('config', 'config_failed', stage);
+        }
+        if (current instanceof errors_2.FrameworkBuildError) {
+            return diagnostic('build', 'build_failed', stage);
+        }
+        if (current instanceof errors_3.NodeToolchainError) {
+            return diagnostic('toolchain', NODE_TOOLCHAIN_CODES[current.code], stage);
+        }
+        if (current instanceof command_runner_1.CommandError) {
+            return diagnostic('command', commandFailureCode(current), stage);
+        }
+        const frameworkByName = frameworkErrorByName(current);
+        if (frameworkByName) {
+            return diagnostic(frameworkByName.kind, frameworkByName.code, stage);
+        }
+        if (current instanceof errors_1.WebflowAppError)
+            break;
+        current = causeOf(current);
+        if (current === undefined)
+            break;
+    }
+    return diagnostic('unknown', 'unknown', stage);
+}
+//# sourceMappingURL=failure-diagnostic.js.map

package/dist/failure-diagnostic.js.map

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

package/dist/frameworks/base.d.ts

@@ -1,4 +1,4 @@
-import type { BuildContext, BuildOutput, FrameworkInfo, PackageJson, WebflowJson, DetectionResult, AdapterPackage, IntegrationPackage, WebflowLoaderConfig, NodeVersionRequirement } from './types';
+import type { BuildContext, BuildOutput, FrameworkInfo, FrameworkSupportStatus, PackageJson, WebflowJson, DetectionResult, AdapterPackage, IntegrationPackage, WebflowLoaderConfig, NodeVersionRequirement } from './types';
 export declare abstract class FrameworkBuilder {
     /**
      * Canonical framework name (e.g. 'nextjs', 'astro', 'vite').
@@ -109,6 +109,18 @@ export declare abstract class FrameworkBuilder {
      * the deploy contract).
      */
     getFrameworkVersion(): string | undefined;
+    /**
+     * Optional framework support status (e.g. Next.js EOL window). Default null;
+     * frameworks that track support override. Called after dependencies are
+     * installed so the concrete installed version is available.
+     */
+    getFrameworkSupport(): FrameworkSupportStatus | null;
+    /**
+     * Emit an out-of-support warning (via `log`) and record version / supported
+     * tags (via `telemetry`) when {@link getFrameworkSupport} returns a status.
+     * Default no-op; Next.js overrides.
+     */
+    reportFrameworkSupport(): FrameworkSupportStatus | null;
     /** Check if a dependency exists in package.json (deps or devDeps). */
     protected hasDependency(name: string): boolean;
     /** Get a dependency version from package.json (deps or devDeps). */

package/dist/frameworks/base.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/frameworks/base.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EACV,YAAY,EACZ,WAAW,EACX,aAAa,EACb,WAAW,EACX,WAAW,EACX,eAAe,EACf,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EACnB,sBAAsB,EACvB,MAAM,SAAS,CAAC;AAEjB,8BAAsB,gBAAgB;IACpC;;;OAGG;IACH,MAAM,CAAC,aAAa,SAAM;IAE1B,SAAS,CAAC,GAAG,EAAE,YAAY,CAAC;gBAEhB,GAAG,EAAE,YAAY;IAQ7B;;OAEG;IACH,QAAQ,KAAK,IAAI,IAAI,aAAa,CAAC;IAEnC;;;;;OAKG;IACH,MAAM,CAAC,MAAM,CAAC,YAAY,EAAE,WAAW,EAAE,YAAY,CAAC,EAAE,WAAW,GAAG,eAAe;IAIrF;;;;;;;OAOG;IACH,MAAM,CAAC,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAInD;;;;;OAKG;IACH,MAAM,CAAC,uBAAuB,IAAI,WAAW;IAI7C;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAElC;;OAEG;IACH,QAAQ,CAAC,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC;IAE7C;;;OAGG;IACH,QAAQ,CAAC,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAEvC;;;;;OAKG;IACH,QAAQ,CAAC,eAAe,IAAI,MAAM,GAAG,IAAI;IAEzC;;;OAGG;IACH,uBAAuB,IAAI,WAAW;IAItC,yDAAyD;IACzD,QAAQ,CAAC,uBAAuB,IAAI,MAAM;IAM1C;;;OAGG;IACH,QAAQ,CAAC,oBAAoB,IAAI,cAAc,GAAG,IAAI;IAEtD;;;OAGG;IACH,QAAQ,CAAC,uBAAuB,IAAI,kBAAkB,EAAE;IAExD;;;OAGG;IACH,QAAQ,CAAC,gBAAgB,IAAI,mBAAmB,GAAG,IAAI;IAEvD;;;OAGG;IACH,QAAQ,CAAC,yBAAyB,IAAI,sBAAsB,GAAG,IAAI;IAMnE;;;OAGG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAIhC;;;OAGG;IACH,wBAAwB,IAAI,MAAM,EAAE;IAIpC;;;OAGG;IACH,qBAAqB,IAAI,MAAM,EAAE;IAIjC;;;;;;;;;OASG;IACH,mBAAmB,IAAI,MAAM,GAAG,SAAS;IAQzC,sEAAsE;IACtE,SAAS,CAAC,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAK9C,oEAAoE;IACpE,SAAS,CAAC,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAKhE;;;;;OAKG;IACH,SAAS,CAAC,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAMtE,gCAAgC;IAChC,SAAS,KAAK,GAAG,wBAEhB;IAED,wCAAwC;IACxC,SAAS,KAAK,UAAU,+BAEvB;IAED,mCAAmC;IACnC,SAAS,KAAK,SAAS,2BAEtB;IAED,oCAAoC;IACpC,SAAS,KAAK,EAAE,gCAEf;IAED,4DAA4D;IAC5D,SAAS,KAAK,GAAG,WAEhB;CACF"}
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/frameworks/base.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EACV,YAAY,EACZ,WAAW,EACX,aAAa,EACb,sBAAsB,EACtB,WAAW,EACX,WAAW,EACX,eAAe,EACf,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EACnB,sBAAsB,EACvB,MAAM,SAAS,CAAC;AAEjB,8BAAsB,gBAAgB;IACpC;;;OAGG;IACH,MAAM,CAAC,aAAa,SAAM;IAE1B,SAAS,CAAC,GAAG,EAAE,YAAY,CAAC;gBAEhB,GAAG,EAAE,YAAY;IAQ7B;;OAEG;IACH,QAAQ,KAAK,IAAI,IAAI,aAAa,CAAC;IAEnC;;;;;OAKG;IACH,MAAM,CAAC,MAAM,CAAC,YAAY,EAAE,WAAW,EAAE,YAAY,CAAC,EAAE,WAAW,GAAG,eAAe;IAIrF;;;;;;;OAOG;IACH,MAAM,CAAC,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAInD;;;;;OAKG;IACH,MAAM,CAAC,uBAAuB,IAAI,WAAW;IAI7C;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAElC;;OAEG;IACH,QAAQ,CAAC,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC;IAE7C;;;OAGG;IACH,QAAQ,CAAC,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAEvC;;;;;OAKG;IACH,QAAQ,CAAC,eAAe,IAAI,MAAM,GAAG,IAAI;IAEzC;;;OAGG;IACH,uBAAuB,IAAI,WAAW;IAItC,yDAAyD;IACzD,QAAQ,CAAC,uBAAuB,IAAI,MAAM;IAM1C;;;OAGG;IACH,QAAQ,CAAC,oBAAoB,IAAI,cAAc,GAAG,IAAI;IAEtD;;;OAGG;IACH,QAAQ,CAAC,uBAAuB,IAAI,kBAAkB,EAAE;IAExD;;;OAGG;IACH,QAAQ,CAAC,gBAAgB,IAAI,mBAAmB,GAAG,IAAI;IAEvD;;;OAGG;IACH,QAAQ,CAAC,yBAAyB,IAAI,sBAAsB,GAAG,IAAI;IAMnE;;;OAGG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAIhC;;;OAGG;IACH,wBAAwB,IAAI,MAAM,EAAE;IAIpC;;;OAGG;IACH,qBAAqB,IAAI,MAAM,EAAE;IAIjC;;;;;;;;;OASG;IACH,mBAAmB,IAAI,MAAM,GAAG,SAAS;IAIzC;;;;OAIG;IACH,mBAAmB,IAAI,sBAAsB,GAAG,IAAI;IAIpD;;;;OAIG;IACH,sBAAsB,IAAI,sBAAsB,GAAG,IAAI;IAQvD,sEAAsE;IACtE,SAAS,CAAC,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAK9C,oEAAoE;IACpE,SAAS,CAAC,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAKhE;;;;;OAKG;IACH,SAAS,CAAC,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAMtE,gCAAgC;IAChC,SAAS,KAAK,GAAG,wBAEhB;IAED,wCAAwC;IACxC,SAAS,KAAK,UAAU,+BAEvB;IAED,mCAAmC;IACnC,SAAS,KAAK,SAAS,2BAEtB;IAED,oCAAoC;IACpC,SAAS,KAAK,EAAE,gCAEf;IAED,4DAA4D;IAC5D,SAAS,KAAK,GAAG,WAEhB;CACF"}

package/dist/frameworks/base.js

@@ -125,6 +125,22 @@ class FrameworkBuilder {
     getFrameworkVersion() {
         return undefined;
     }
+    /**
+     * Optional framework support status (e.g. Next.js EOL window). Default null;
+     * frameworks that track support override. Called after dependencies are
+     * installed so the concrete installed version is available.
+     */
+    getFrameworkSupport() {
+        return null;
+    }
+    /**
+     * Emit an out-of-support warning (via `log`) and record version / supported
+     * tags (via `telemetry`) when {@link getFrameworkSupport} returns a status.
+     * Default no-op; Next.js overrides.
+     */
+    reportFrameworkSupport() {
+        return null;
+    }
     // ═══════════════════════════════════════════════════════════════════════════
     // PROTECTED HELPER METHODS
     // ═══════════════════════════════════════════════════════════════════════════

package/dist/frameworks/base.js.map

@@ -1 +1 @@
-{"version":3,"file":"base.js","sourceRoot":"","sources":["../../src/frameworks/base.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;;;;;;GAMG;AACH,+CAAiC;AAejC,MAAsB,gBAAgB;IACpC;;;OAGG;IACH,MAAM,CAAC,aAAa,GAAG,EAAE,CAAC;IAEhB,GAAG,CAAe;IAE5B,YAAY,GAAiB;QAC3B,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;IACjB,CAAC;IAWD;;;;;OAKG;IACH,MAAM,CAAC,MAAM,CAAC,YAAyB,EAAE,YAA0B;QACjE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;IAC7B,CAAC;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,qBAAqB,CAAC,IAAY;QACvC,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,uBAAuB;QAC5B,MAAM,IAAI,KAAK,CAAC,uEAAuE,CAAC,CAAC;IAC3F,CAAC;IA4BD;;;OAGG;IACH,uBAAuB;QACrB,OAAQ,IAAI,CAAC,WAAuC,CAAC,uBAAuB,EAAE,CAAC;IACjF,CAAC;IAiCD,8EAA8E;IAC9E,gDAAgD;IAChD,8EAA8E;IAE9E;;;OAGG;IACH,KAAK,CAAC,SAAS;QACb,iBAAiB;IACnB,CAAC;IAED;;;OAGG;IACH,wBAAwB;QACtB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED;;;OAGG;IACH,qBAAqB;QACnB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED;;;;;;;;;OASG;IACH,mBAAmB;QACjB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,8EAA8E;IAC9E,2BAA2B;IAC3B,8EAA8E;IAE9E,sEAAsE;IAC5D,aAAa,CAAC,IAAY;QAClC,MAAM,EAAE,WAAW,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC;QACjC,OAAO,IAAI,IAAI,CAAC,WAAW,CAAC,YAAY,IAAI,EAAE,CAAC,IAAI,IAAI,IAAI,CAAC,WAAW,CAAC,eAAe,IAAI,EAAE,CAAC,CAAC;IACjG,CAAC;IAED,oEAAoE;IAC1D,oBAAoB,CAAC,IAAY;QACzC,MAAM,EAAE,WAAW,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC;QACjC,OAAO,WAAW,CAAC,YAAY,EAAE,CAAC,IAAI,CAAC,IAAI,WAAW,CAAC,eAAe,EAAE,CAAC,IAAI,CAAC,CAAC;IACjF,CAAC;IAED;;;;;OAKG;IACO,uBAAuB,CAAC,OAAe;QAC/C,MAAM,IAAI,GAAG,IAAI,CAAC,oBAAoB,CAAC,OAAO,CAAC,CAAC;QAChD,IAAI,CAAC,IAAI;YAAE,OAAO,SAAS,CAAC;QAC5B,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IACtC,CAAC;IAED,gCAAgC;IAChC,IAAc,GAAG;QACf,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;IACtB,CAAC;IAED,wCAAwC;IACxC,IAAc,UAAU;QACtB,OAAO,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC;IAC7B,CAAC;IAED,mCAAmC;IACnC,IAAc,SAAS;QACrB,OAAO,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC;IAC5B,CAAC;IAED,oCAAoC;IACpC,IAAc,EAAE;QACd,OAAO,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;IACrB,CAAC;IAED,4DAA4D;IAC5D,IAAc,GAAG;QACf,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;IACtB,CAAC;;AApNH,4CAqNC"}
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../src/frameworks/base.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;;;;;;GAMG;AACH,+CAAiC;AAgBjC,MAAsB,gBAAgB;IACpC;;;OAGG;IACH,MAAM,CAAC,aAAa,GAAG,EAAE,CAAC;IAEhB,GAAG,CAAe;IAE5B,YAAY,GAAiB;QAC3B,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;IACjB,CAAC;IAWD;;;;;OAKG;IACH,MAAM,CAAC,MAAM,CAAC,YAAyB,EAAE,YAA0B;QACjE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;IAC7B,CAAC;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,qBAAqB,CAAC,IAAY;QACvC,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,uBAAuB;QAC5B,MAAM,IAAI,KAAK,CAAC,uEAAuE,CAAC,CAAC;IAC3F,CAAC;IA4BD;;;OAGG;IACH,uBAAuB;QACrB,OAAQ,IAAI,CAAC,WAAuC,CAAC,uBAAuB,EAAE,CAAC;IACjF,CAAC;IAiCD,8EAA8E;IAC9E,gDAAgD;IAChD,8EAA8E;IAE9E;;;OAGG;IACH,KAAK,CAAC,SAAS;QACb,iBAAiB;IACnB,CAAC;IAED;;;OAGG;IACH,wBAAwB;QACtB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED;;;OAGG;IACH,qBAAqB;QACnB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED;;;;;;;;;OASG;IACH,mBAAmB;QACjB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED;;;;OAIG;IACH,mBAAmB;QACjB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;OAIG;IACH,sBAAsB;QACpB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,8EAA8E;IAC9E,2BAA2B;IAC3B,8EAA8E;IAE9E,sEAAsE;IAC5D,aAAa,CAAC,IAAY;QAClC,MAAM,EAAE,WAAW,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC;QACjC,OAAO,IAAI,IAAI,CAAC,WAAW,CAAC,YAAY,IAAI,EAAE,CAAC,IAAI,IAAI,IAAI,CAAC,WAAW,CAAC,eAAe,IAAI,EAAE,CAAC,CAAC;IACjG,CAAC;IAED,oEAAoE;IAC1D,oBAAoB,CAAC,IAAY;QACzC,MAAM,EAAE,WAAW,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC;QACjC,OAAO,WAAW,CAAC,YAAY,EAAE,CAAC,IAAI,CAAC,IAAI,WAAW,CAAC,eAAe,EAAE,CAAC,IAAI,CAAC,CAAC;IACjF,CAAC;IAED;;;;;OAKG;IACO,uBAAuB,CAAC,OAAe;QAC/C,MAAM,IAAI,GAAG,IAAI,CAAC,oBAAoB,CAAC,OAAO,CAAC,CAAC;QAChD,IAAI,CAAC,IAAI;YAAE,OAAO,SAAS,CAAC;QAC5B,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IACtC,CAAC;IAED,gCAAgC;IAChC,IAAc,GAAG;QACf,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;IACtB,CAAC;IAED,wCAAwC;IACxC,IAAc,UAAU;QACtB,OAAO,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC;IAC7B,CAAC;IAED,mCAAmC;IACnC,IAAc,SAAS;QACrB,OAAO,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC;IAC5B,CAAC;IAED,oCAAoC;IACpC,IAAc,EAAE;QACd,OAAO,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;IACrB,CAAC;IAED,4DAA4D;IAC5D,IAAc,GAAG;QACf,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;IACtB,CAAC;;AAtOH,4CAuOC"}