@craft-ts/deploy 0.7.0-beta.15

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Romain Geffrault
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,41 @@
+# @craft-ts/deploy
+
+Provider-neutral deployment contract for CraftTS applications.
+
+> **Experimental.** Manifest fields, diagnostic codes and the provider contract
+> can still change between minor versions. The serialised manifest carries
+> `protocolVersion: '1'`, and one produced by another protocol is refused rather
+> than reinterpreted, so a change breaks loudly at the check. Pin the version if
+> you build a pipeline on it.
+
+The package holds the typed manifest an application writes in
+`craft.deploy.ts`, the checks that run before a build, and the capability
+matrix of the deployment providers. It never deploys anything: publishing and
+provisioning belong to a provider package.
+
+```ts
+import { defineCraftDeployment } from '@craft-ts/deploy';
+
+export default defineCraftDeployment({
+  name: 'demo-ssr',
+  runtime: 'node',
+  platform: 'docker',
+  server: {
+    entry: 'dist/apps/demo-ssr/server/server.js',
+    source: 'apps/demo-ssr/src/production-server.ts',
+    healthPath: '/health',
+    readyPath: '/ready',
+  },
+});
+```
+
+Three notions stay distinct everywhere:
+
+| Notion     | Question it answers                              | Examples                             |
+| ---------- | ------------------------------------------------ | ------------------------------------ |
+| `runtime`  | What shape does the bundle execute in?           | `static`, `node`, `worker`, `lambda` |
+| `platform` | Which technical platform runs it?                | `cloudflare`, `aws`, `docker`        |
+| provider   | Which integration builds, publishes, provisions? | `alchemy`, `vercel`, `docker`        |
+
+See the [deployment guide](../../apps/docs/guide/deployment/index.md) for the
+manifest reference, the diagnostics and the provider matrix.

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@craft-ts/deploy",
+  "version": "0.7.0-beta.15",
+  "description": "Provider-neutral deployment contract for CraftTS: manifest, validation and capability matrix",
+  "author": "Romain Geffrault",
+  "license": "MIT",
+  "homepage": "https://craft-ts.github.io/craft/",
+  "bugs": {
+    "url": "https://github.com/craft-ts/craft-ts/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/craft-ts/craft-ts.git"
+  },
+  "keywords": [
+    "craft-ts",
+    "deployment",
+    "manifest",
+    "worker",
+    "lambda",
+    "ssr",
+    "typescript"
+  ],
+  "engines": {
+    "node": ">=20.19.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "sideEffects": false,
+  "type": "module",
+  "main": "./src/index.js",
+  "types": "./src/index.d.ts",
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "types": "./src/index.d.ts",
+      "default": "./src/index.js"
+    }
+  },
+  "module": "./src/index.js"
+}

package/src/index.d.ts

@@ -0,0 +1,18 @@
+export { CRAFT_DEPLOYMENT_PLATFORMS, CRAFT_DEPLOYMENT_PROTOCOL_VERSION, CRAFT_DEPLOYMENT_RUNTIMES, CRAFT_SOURCE_MAP_POLICIES, CRAFT_STATIC_MODES, defineCraftDeployment, } from './lib/manifest.js';
+export type { CraftDeploymentArtifact, CraftDeploymentArtifactInput, CraftDeploymentBinding, CraftDeploymentClient, CraftDeploymentDefinition, CraftDeploymentEnvironmentVariable, CraftDeploymentFunctions, CraftDeploymentFunctionsInput, CraftDeploymentLambda, CraftDeploymentLambdaInput, CraftDeploymentManifest, CraftDeploymentPlatform, CraftDeploymentRuntime, CraftDeploymentServer, CraftDeploymentServerInput, CraftDeploymentStatic, CraftDeploymentStaticInput, CraftDeploymentWorker, CraftDeploymentWorkerInput, CraftLambdaDeploymentDefinition, CraftLambdaDeploymentManifest, CraftNodeDeploymentDefinition, CraftNodeDeploymentManifest, CraftSourceMapPolicy, CraftStaticDeploymentDefinition, CraftStaticDeploymentManifest, CraftStaticMode, CraftWorkerDeploymentDefinition, CraftWorkerDeploymentManifest, } from './lib/manifest.js';
+export { CRAFT_DEPLOYMENT_DIAGNOSTIC_CODES, CRAFT_DEPLOYMENT_DIAGNOSTICS, } from './lib/diagnostics.js';
+export type { CraftDeploymentDiagnostic, CraftDeploymentDiagnosticCode, CraftDeploymentDiagnosticDescription, CraftDeploymentSeverity, } from './lib/diagnostics.js';
+export { formatCraftDeploymentDiagnostic, formatCraftDeploymentPlan, } from './lib/format.js';
+export { parseCraftDeploymentManifest, resolveCraftDeploymentManifest, serializeCraftDeploymentManifest, } from './lib/protocol.js';
+export type { CraftDeploymentParseResult } from './lib/protocol.js';
+export { validateCraftDeploymentDefinition } from './lib/validate.js';
+export type { CraftDeploymentValidation } from './lib/validate.js';
+export { CRAFT_DEPLOYMENT_CAPABILITIES, CRAFT_DEPLOYMENT_PROVIDERS, CRAFT_DEPLOYMENT_RESOURCE_ACTIONS, CRAFT_RUNTIME_PLATFORMS, findCraftDeploymentProvider, isCraftDeploymentProviderModule, isRuntimeSupportedByPlatform, requiredCapability, } from './lib/providers.js';
+export type { CraftDeploymentCapability, CraftDeploymentPlan, CraftDeploymentPlannedResource, CraftDeploymentProvider, CraftDeploymentProviderDescriptor, CraftDeploymentProviderModule, CraftDeploymentRequest, CraftDeploymentResourceAction, CraftDeploymentResult, } from './lib/providers.js';
+export { checkCraftDeployment } from './lib/check.js';
+export type { CraftDeploymentCheckOptions, CraftDeploymentCheckResult, } from './lib/check.js';
+export { checkCraftDeploymentArtifact } from './lib/artifact.js';
+export type { CraftArtifactCheckOptions } from './lib/artifact.js';
+export { collectEnvironmentReads, isNodeBuiltin, readCraftModuleGraph, } from './lib/sources.js';
+export type { CraftModuleGraph, CraftModuleImport } from './lib/sources.js';
+//# sourceMappingURL=index.d.ts.map

package/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../libs/deploy/src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,0BAA0B,EAC1B,iCAAiC,EACjC,yBAAyB,EACzB,yBAAyB,EACzB,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EACV,uBAAuB,EACvB,4BAA4B,EAC5B,sBAAsB,EACtB,qBAAqB,EACrB,yBAAyB,EACzB,kCAAkC,EAClC,wBAAwB,EACxB,6BAA6B,EAC7B,qBAAqB,EACrB,0BAA0B,EAC1B,uBAAuB,EACvB,uBAAuB,EACvB,sBAAsB,EACtB,qBAAqB,EACrB,0BAA0B,EAC1B,qBAAqB,EACrB,0BAA0B,EAC1B,qBAAqB,EACrB,0BAA0B,EAC1B,+BAA+B,EAC/B,6BAA6B,EAC7B,6BAA6B,EAC7B,2BAA2B,EAC3B,oBAAoB,EACpB,+BAA+B,EAC/B,6BAA6B,EAC7B,eAAe,EACf,+BAA+B,EAC/B,6BAA6B,GAC9B,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,iCAAiC,EACjC,4BAA4B,GAC7B,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EACV,yBAAyB,EACzB,6BAA6B,EAC7B,oCAAoC,EACpC,uBAAuB,GACxB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,+BAA+B,EAC/B,yBAAyB,GAC1B,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,4BAA4B,EAC5B,8BAA8B,EAC9B,gCAAgC,GACjC,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAE,0BAA0B,EAAE,MAAM,mBAAmB,CAAC;AAEpE,OAAO,EAAE,iCAAiC,EAAE,MAAM,mBAAmB,CAAC;AACtE,YAAY,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AAEnE,OAAO,EACL,6BAA6B,EAC7B,0BAA0B,EAC1B,iCAAiC,EACjC,uBAAuB,EACvB,2BAA2B,EAC3B,+BAA+B,EAC/B,4BAA4B,EAC5B,kBAAkB,GACnB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,yBAAyB,EACzB,mBAAmB,EACnB,8BAA8B,EAC9B,uBAAuB,EACvB,iCAAiC,EACjC,6BAA6B,EAC7B,sBAAsB,EACtB,6BAA6B,EAC7B,qBAAqB,GACtB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACtD,YAAY,EACV,2BAA2B,EAC3B,0BAA0B,GAC3B,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,4BAA4B,EAAE,MAAM,mBAAmB,CAAC;AACjE,YAAY,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AAEnE,OAAO,EACL,uBAAuB,EACvB,aAAa,EACb,oBAAoB,GACrB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC"}

package/src/index.js

@@ -0,0 +1,10 @@
+export { CRAFT_DEPLOYMENT_PLATFORMS, CRAFT_DEPLOYMENT_PROTOCOL_VERSION, CRAFT_DEPLOYMENT_RUNTIMES, CRAFT_SOURCE_MAP_POLICIES, CRAFT_STATIC_MODES, defineCraftDeployment, } from './lib/manifest.js';
+export { CRAFT_DEPLOYMENT_DIAGNOSTIC_CODES, CRAFT_DEPLOYMENT_DIAGNOSTICS, } from './lib/diagnostics.js';
+export { formatCraftDeploymentDiagnostic, formatCraftDeploymentPlan, } from './lib/format.js';
+export { parseCraftDeploymentManifest, resolveCraftDeploymentManifest, serializeCraftDeploymentManifest, } from './lib/protocol.js';
+export { validateCraftDeploymentDefinition } from './lib/validate.js';
+export { CRAFT_DEPLOYMENT_CAPABILITIES, CRAFT_DEPLOYMENT_PROVIDERS, CRAFT_DEPLOYMENT_RESOURCE_ACTIONS, CRAFT_RUNTIME_PLATFORMS, findCraftDeploymentProvider, isCraftDeploymentProviderModule, isRuntimeSupportedByPlatform, requiredCapability, } from './lib/providers.js';
+export { checkCraftDeployment } from './lib/check.js';
+export { checkCraftDeploymentArtifact } from './lib/artifact.js';
+export { collectEnvironmentReads, isNodeBuiltin, readCraftModuleGraph, } from './lib/sources.js';
+//# sourceMappingURL=index.js.map

package/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../libs/deploy/src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,0BAA0B,EAC1B,iCAAiC,EACjC,yBAAyB,EACzB,yBAAyB,EACzB,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,mBAAmB,CAAC;AAiC3B,OAAO,EACL,iCAAiC,EACjC,4BAA4B,GAC7B,MAAM,sBAAsB,CAAC;AAQ9B,OAAO,EACL,+BAA+B,EAC/B,yBAAyB,GAC1B,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,4BAA4B,EAC5B,8BAA8B,EAC9B,gCAAgC,GACjC,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,iCAAiC,EAAE,MAAM,mBAAmB,CAAC;AAGtE,OAAO,EACL,6BAA6B,EAC7B,0BAA0B,EAC1B,iCAAiC,EACjC,uBAAuB,EACvB,2BAA2B,EAC3B,+BAA+B,EAC/B,4BAA4B,EAC5B,kBAAkB,GACnB,MAAM,oBAAoB,CAAC;AAa5B,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAMtD,OAAO,EAAE,4BAA4B,EAAE,MAAM,mBAAmB,CAAC;AAGjE,OAAO,EACL,uBAAuB,EACvB,aAAa,EACb,oBAAoB,GACrB,MAAM,kBAAkB,CAAC","sourcesContent":["export {\n  CRAFT_DEPLOYMENT_PLATFORMS,\n  CRAFT_DEPLOYMENT_PROTOCOL_VERSION,\n  CRAFT_DEPLOYMENT_RUNTIMES,\n  CRAFT_SOURCE_MAP_POLICIES,\n  CRAFT_STATIC_MODES,\n  defineCraftDeployment,\n} from './lib/manifest.js';\nexport type {\n  CraftDeploymentArtifact,\n  CraftDeploymentArtifactInput,\n  CraftDeploymentBinding,\n  CraftDeploymentClient,\n  CraftDeploymentDefinition,\n  CraftDeploymentEnvironmentVariable,\n  CraftDeploymentFunctions,\n  CraftDeploymentFunctionsInput,\n  CraftDeploymentLambda,\n  CraftDeploymentLambdaInput,\n  CraftDeploymentManifest,\n  CraftDeploymentPlatform,\n  CraftDeploymentRuntime,\n  CraftDeploymentServer,\n  CraftDeploymentServerInput,\n  CraftDeploymentStatic,\n  CraftDeploymentStaticInput,\n  CraftDeploymentWorker,\n  CraftDeploymentWorkerInput,\n  CraftLambdaDeploymentDefinition,\n  CraftLambdaDeploymentManifest,\n  CraftNodeDeploymentDefinition,\n  CraftNodeDeploymentManifest,\n  CraftSourceMapPolicy,\n  CraftStaticDeploymentDefinition,\n  CraftStaticDeploymentManifest,\n  CraftStaticMode,\n  CraftWorkerDeploymentDefinition,\n  CraftWorkerDeploymentManifest,\n} from './lib/manifest.js';\n\nexport {\n  CRAFT_DEPLOYMENT_DIAGNOSTIC_CODES,\n  CRAFT_DEPLOYMENT_DIAGNOSTICS,\n} from './lib/diagnostics.js';\nexport type {\n  CraftDeploymentDiagnostic,\n  CraftDeploymentDiagnosticCode,\n  CraftDeploymentDiagnosticDescription,\n  CraftDeploymentSeverity,\n} from './lib/diagnostics.js';\n\nexport {\n  formatCraftDeploymentDiagnostic,\n  formatCraftDeploymentPlan,\n} from './lib/format.js';\n\nexport {\n  parseCraftDeploymentManifest,\n  resolveCraftDeploymentManifest,\n  serializeCraftDeploymentManifest,\n} from './lib/protocol.js';\nexport type { CraftDeploymentParseResult } from './lib/protocol.js';\n\nexport { validateCraftDeploymentDefinition } from './lib/validate.js';\nexport type { CraftDeploymentValidation } from './lib/validate.js';\n\nexport {\n  CRAFT_DEPLOYMENT_CAPABILITIES,\n  CRAFT_DEPLOYMENT_PROVIDERS,\n  CRAFT_DEPLOYMENT_RESOURCE_ACTIONS,\n  CRAFT_RUNTIME_PLATFORMS,\n  findCraftDeploymentProvider,\n  isCraftDeploymentProviderModule,\n  isRuntimeSupportedByPlatform,\n  requiredCapability,\n} from './lib/providers.js';\nexport type {\n  CraftDeploymentCapability,\n  CraftDeploymentPlan,\n  CraftDeploymentPlannedResource,\n  CraftDeploymentProvider,\n  CraftDeploymentProviderDescriptor,\n  CraftDeploymentProviderModule,\n  CraftDeploymentRequest,\n  CraftDeploymentResourceAction,\n  CraftDeploymentResult,\n} from './lib/providers.js';\n\nexport { checkCraftDeployment } from './lib/check.js';\nexport type {\n  CraftDeploymentCheckOptions,\n  CraftDeploymentCheckResult,\n} from './lib/check.js';\n\nexport { checkCraftDeploymentArtifact } from './lib/artifact.js';\nexport type { CraftArtifactCheckOptions } from './lib/artifact.js';\n\nexport {\n  collectEnvironmentReads,\n  isNodeBuiltin,\n  readCraftModuleGraph,\n} from './lib/sources.js';\nexport type { CraftModuleGraph, CraftModuleImport } from './lib/sources.js';\n"]}

package/src/lib/artifact.d.ts

@@ -0,0 +1,18 @@
+import type { CraftDeploymentDiagnostic } from './diagnostics.js';
+import type { CraftDeploymentManifest } from './manifest.js';
+export type CraftArtifactCheckOptions = Readonly<{
+    /** Directory the manifest paths are relative to. */
+    rootDir?: string;
+    manifest: CraftDeploymentManifest;
+}>;
+/**
+ * Inspects the produced artefact rather than the sources.
+ *
+ * This is the stable API behind the `production:check` smoke: a build can only
+ * be published once the directory a provider would upload holds an entry
+ * point, executable JavaScript and nothing the source map policy forbids.
+ */
+export declare function checkCraftDeploymentArtifact(options: CraftArtifactCheckOptions): readonly CraftDeploymentDiagnostic[];
+/** A route is rendered as `<route>.html` or as `<route>/index.html`. */
+export declare function hasPrerenderedDocument(publicDir: string, route: string): boolean;
+//# sourceMappingURL=artifact.d.ts.map

package/src/lib/artifact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact.d.ts","sourceRoot":"","sources":["../../../../../libs/deploy/src/lib/artifact.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAC;AAClE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAE7D,MAAM,MAAM,yBAAyB,GAAG,QAAQ,CAAC;IAC/C,oDAAoD;IACpD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,uBAAuB,CAAC;CACnC,CAAC,CAAC;AAEH;;;;;;GAMG;AACH,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,yBAAyB,GACjC,SAAS,yBAAyB,EAAE,CAiGtC;AAED,wEAAwE;AACxE,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,GACZ,OAAO,CAKT"}

package/src/lib/artifact.js

@@ -0,0 +1,121 @@
+import { existsSync, readdirSync, statSync } from 'node:fs';
+import { join, relative, resolve } from 'node:path';
+/**
+ * Inspects the produced artefact rather than the sources.
+ *
+ * This is the stable API behind the `production:check` smoke: a build can only
+ * be published once the directory a provider would upload holds an entry
+ * point, executable JavaScript and nothing the source map policy forbids.
+ */
+export function checkCraftDeploymentArtifact(options) {
+    const rootDir = resolve(options.rootDir ?? process.cwd());
+    const manifest = options.manifest;
+    const publicDir = manifest.artifact.publicDir;
+    const diagnostics = [];
+    if (!publicDir)
+        return diagnostics;
+    const absolutePublicDir = resolve(rootDir, publicDir);
+    if (!existsSync(absolutePublicDir)) {
+        return [
+            {
+                code: 'CRAFT_DEPLOY_ARTIFACT_MISSING',
+                severity: 'error',
+                path: 'artifact.publicDir',
+                file: publicDir,
+                runtime: manifest.runtime,
+                platform: manifest.platform,
+                message: `The artefact directory \`${publicDir}\` does not exist.`,
+                fix: 'Run the declared build command before checking the artefact.',
+            },
+        ];
+    }
+    const files = listFiles(absolutePublicDir);
+    const relativeFiles = files.map((file) => relative(rootDir, file));
+    if (!existsSync(join(absolutePublicDir, 'index.html'))) {
+        diagnostics.push({
+            code: 'CRAFT_DEPLOY_ARTIFACT_NO_ENTRY',
+            severity: 'error',
+            path: 'artifact.publicDir',
+            file: join(publicDir, 'index.html'),
+            runtime: manifest.runtime,
+            message: `\`${publicDir}\` contains no \`index.html\`.`,
+            fix: 'Check the build output directory declared in `client.outDir`.',
+        });
+    }
+    if (!files.some((file) => /\.m?js$/.test(file))) {
+        diagnostics.push({
+            code: 'CRAFT_DEPLOY_ARTIFACT_NO_JAVASCRIPT',
+            severity: 'error',
+            path: 'artifact.publicDir',
+            file: publicDir,
+            runtime: manifest.runtime,
+            message: `\`${publicDir}\` contains no JavaScript file.`,
+            fix: 'Check the build command and its output directory.',
+        });
+    }
+    if (manifest.artifact.sourceMaps === 'forbidden') {
+        for (const file of relativeFiles.filter((name) => name.endsWith('.map'))) {
+            diagnostics.push({
+                code: 'CRAFT_DEPLOY_ARTIFACT_SOURCE_MAP',
+                severity: 'error',
+                path: 'artifact.sourceMaps',
+                file,
+                runtime: manifest.runtime,
+                message: `\`${file}\` is a source map and the policy is \`forbidden\`.`,
+                fix: 'Disable source maps in the production build, or relax `artifact.sourceMaps`.',
+            });
+        }
+    }
+    if (manifest.runtime === 'static') {
+        if (manifest.static.mode === 'spa') {
+            const fallback = join(publicDir, manifest.static.fallback);
+            if (!existsSync(resolve(rootDir, fallback))) {
+                diagnostics.push({
+                    code: 'CRAFT_DEPLOY_SPA_FALLBACK_MISSING',
+                    severity: 'error',
+                    path: 'static.fallback',
+                    file: fallback,
+                    runtime: 'static',
+                    message: `The SPA fallback \`${fallback}\` is missing from the artefact.`,
+                    fix: 'Build the client, or correct `static.fallback`.',
+                });
+            }
+        }
+        else {
+            for (const [index, route] of manifest.static.routes.entries()) {
+                if (!hasPrerenderedDocument(absolutePublicDir, route)) {
+                    diagnostics.push({
+                        code: 'CRAFT_DEPLOY_SSG_ROUTE_NOT_RENDERED',
+                        severity: 'error',
+                        path: `static.routes[${index}]`,
+                        file: publicDir,
+                        runtime: 'static',
+                        message: `No pre-rendered document was found for \`${route}\`.`,
+                        fix: 'Run the pre-render step for that route, or remove it from `static.routes`.',
+                    });
+                }
+            }
+        }
+    }
+    return diagnostics;
+}
+/** A route is rendered as `<route>.html` or as `<route>/index.html`. */
+export function hasPrerenderedDocument(publicDir, route) {
+    const segments = route.split('/').filter((segment) => segment.length > 0);
+    if (segments.length === 0)
+        return existsSync(join(publicDir, 'index.html'));
+    const base = join(publicDir, ...segments);
+    return existsSync(`${base}.html`) || existsSync(join(base, 'index.html'));
+}
+function listFiles(directory) {
+    const files = [];
+    for (const entry of readdirSync(directory)) {
+        const path = join(directory, entry);
+        if (statSync(path).isDirectory())
+            files.push(...listFiles(path));
+        else
+            files.push(path);
+    }
+    return files;
+}
+//# sourceMappingURL=artifact.js.map

package/src/lib/artifact.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact.js","sourceRoot":"","sources":["../../../../../libs/deploy/src/lib/artifact.ts"],"names":[],"mappings":"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","sourcesContent":["import { existsSync, readdirSync, statSync } from 'node:fs';\nimport { join, relative, resolve } from 'node:path';\nimport type { CraftDeploymentDiagnostic } from './diagnostics.js';\nimport type { CraftDeploymentManifest } from './manifest.js';\n\nexport type CraftArtifactCheckOptions = Readonly<{\n  /** Directory the manifest paths are relative to. */\n  rootDir?: string;\n  manifest: CraftDeploymentManifest;\n}>;\n\n/**\n * Inspects the produced artefact rather than the sources.\n *\n * This is the stable API behind the `production:check` smoke: a build can only\n * be published once the directory a provider would upload holds an entry\n * point, executable JavaScript and nothing the source map policy forbids.\n */\nexport function checkCraftDeploymentArtifact(\n  options: CraftArtifactCheckOptions,\n): readonly CraftDeploymentDiagnostic[] {\n  const rootDir = resolve(options.rootDir ?? process.cwd());\n  const manifest = options.manifest;\n  const publicDir = manifest.artifact.publicDir;\n  const diagnostics: CraftDeploymentDiagnostic[] = [];\n\n  if (!publicDir) return diagnostics;\n\n  const absolutePublicDir = resolve(rootDir, publicDir);\n  if (!existsSync(absolutePublicDir)) {\n    return [\n      {\n        code: 'CRAFT_DEPLOY_ARTIFACT_MISSING',\n        severity: 'error',\n        path: 'artifact.publicDir',\n        file: publicDir,\n        runtime: manifest.runtime,\n        platform: manifest.platform,\n        message: `The artefact directory \\`${publicDir}\\` does not exist.`,\n        fix: 'Run the declared build command before checking the artefact.',\n      },\n    ];\n  }\n\n  const files = listFiles(absolutePublicDir);\n  const relativeFiles = files.map((file) => relative(rootDir, file));\n\n  if (!existsSync(join(absolutePublicDir, 'index.html'))) {\n    diagnostics.push({\n      code: 'CRAFT_DEPLOY_ARTIFACT_NO_ENTRY',\n      severity: 'error',\n      path: 'artifact.publicDir',\n      file: join(publicDir, 'index.html'),\n      runtime: manifest.runtime,\n      message: `\\`${publicDir}\\` contains no \\`index.html\\`.`,\n      fix: 'Check the build output directory declared in `client.outDir`.',\n    });\n  }\n\n  if (!files.some((file) => /\\.m?js$/.test(file))) {\n    diagnostics.push({\n      code: 'CRAFT_DEPLOY_ARTIFACT_NO_JAVASCRIPT',\n      severity: 'error',\n      path: 'artifact.publicDir',\n      file: publicDir,\n      runtime: manifest.runtime,\n      message: `\\`${publicDir}\\` contains no JavaScript file.`,\n      fix: 'Check the build command and its output directory.',\n    });\n  }\n\n  if (manifest.artifact.sourceMaps === 'forbidden') {\n    for (const file of relativeFiles.filter((name) => name.endsWith('.map'))) {\n      diagnostics.push({\n        code: 'CRAFT_DEPLOY_ARTIFACT_SOURCE_MAP',\n        severity: 'error',\n        path: 'artifact.sourceMaps',\n        file,\n        runtime: manifest.runtime,\n        message: `\\`${file}\\` is a source map and the policy is \\`forbidden\\`.`,\n        fix: 'Disable source maps in the production build, or relax `artifact.sourceMaps`.',\n      });\n    }\n  }\n\n  if (manifest.runtime === 'static') {\n    if (manifest.static.mode === 'spa') {\n      const fallback = join(publicDir, manifest.static.fallback);\n      if (!existsSync(resolve(rootDir, fallback))) {\n        diagnostics.push({\n          code: 'CRAFT_DEPLOY_SPA_FALLBACK_MISSING',\n          severity: 'error',\n          path: 'static.fallback',\n          file: fallback,\n          runtime: 'static',\n          message: `The SPA fallback \\`${fallback}\\` is missing from the artefact.`,\n          fix: 'Build the client, or correct `static.fallback`.',\n        });\n      }\n    } else {\n      for (const [index, route] of manifest.static.routes.entries()) {\n        if (!hasPrerenderedDocument(absolutePublicDir, route)) {\n          diagnostics.push({\n            code: 'CRAFT_DEPLOY_SSG_ROUTE_NOT_RENDERED',\n            severity: 'error',\n            path: `static.routes[${index}]`,\n            file: publicDir,\n            runtime: 'static',\n            message: `No pre-rendered document was found for \\`${route}\\`.`,\n            fix: 'Run the pre-render step for that route, or remove it from `static.routes`.',\n          });\n        }\n      }\n    }\n  }\n\n  return diagnostics;\n}\n\n/** A route is rendered as `<route>.html` or as `<route>/index.html`. */\nexport function hasPrerenderedDocument(\n  publicDir: string,\n  route: string,\n): boolean {\n  const segments = route.split('/').filter((segment) => segment.length > 0);\n  if (segments.length === 0) return existsSync(join(publicDir, 'index.html'));\n  const base = join(publicDir, ...segments);\n  return existsSync(`${base}.html`) || existsSync(join(base, 'index.html'));\n}\n\nfunction listFiles(directory: string): readonly string[] {\n  const files: string[] = [];\n  for (const entry of readdirSync(directory)) {\n    const path = join(directory, entry);\n    if (statSync(path).isDirectory()) files.push(...listFiles(path));\n    else files.push(path);\n  }\n  return files;\n}\n"]}

package/src/lib/check.d.ts

@@ -0,0 +1,31 @@
+import type { CraftDeploymentDiagnostic } from './diagnostics.js';
+import { type CraftDeploymentManifest } from './manifest.js';
+export type CraftDeploymentCheckOptions = Readonly<{
+    /** Directory the manifest paths are relative to. Defaults to `cwd`. */
+    rootDir?: string;
+    /** Raw manifest, typically the default export of `craft.deploy.ts`. */
+    definition: unknown;
+    /** Provider the deployment targets, checked against the capability matrix. */
+    provider?: string;
+    /** Asserts the manifest declares this runtime. */
+    runtime?: string;
+    /** Asserts the manifest declares this platform. */
+    platform?: string;
+    /** Also inspect the produced artefact, which requires a completed build. */
+    artifact?: boolean;
+}>;
+export type CraftDeploymentCheckResult = Readonly<{
+    passed: boolean;
+    /** `null` when the manifest could not be resolved. */
+    manifest: CraftDeploymentManifest | null;
+    diagnostics: readonly CraftDeploymentDiagnostic[];
+}>;
+/**
+ * Runs every deployment check that does not need a provider account.
+ *
+ * The order matters: nothing filesystem-related runs while the manifest itself
+ * is unusable, so an author never reads a page of path errors caused by a
+ * single missing field.
+ */
+export declare function checkCraftDeployment(options: CraftDeploymentCheckOptions): CraftDeploymentCheckResult;
+//# sourceMappingURL=check.d.ts.map

package/src/lib/check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check.d.ts","sourceRoot":"","sources":["../../../../../libs/deploy/src/lib/check.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,yBAAyB,EAE1B,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAGL,KAAK,uBAAuB,EAC7B,MAAM,eAAe,CAAC;AAcvB,MAAM,MAAM,2BAA2B,GAAG,QAAQ,CAAC;IACjD,uEAAuE;IACvE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uEAAuE;IACvE,UAAU,EAAE,OAAO,CAAC;IACpB,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kDAAkD;IAClD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mDAAmD;IACnD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,CAAC,CAAC;AAEH,MAAM,MAAM,0BAA0B,GAAG,QAAQ,CAAC;IAChD,MAAM,EAAE,OAAO,CAAC;IAChB,sDAAsD;IACtD,QAAQ,EAAE,uBAAuB,GAAG,IAAI,CAAC;IACzC,WAAW,EAAE,SAAS,yBAAyB,EAAE,CAAC;CACnD,CAAC,CAAC;AAEH;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,2BAA2B,GACnC,0BAA0B,CAyB5B"}

package/src/lib/check.js

@@ -0,0 +1,278 @@
+import { existsSync } from 'node:fs';
+import { relative, resolve } from 'node:path';
+import { checkCraftDeploymentArtifact } from './artifact.js';
+import { CRAFT_DEPLOYMENT_PLATFORMS, CRAFT_DEPLOYMENT_RUNTIMES, } from './manifest.js';
+import { findCraftDeploymentProvider, requiredCapability, } from './providers.js';
+import { resolveCraftDeploymentManifest } from './protocol.js';
+import { collectEnvironmentReads, isNodeBuiltin, readCraftModuleGraph, } from './sources.js';
+import { validateCraftDeploymentDefinition } from './validate.js';
+/**
+ * Runs every deployment check that does not need a provider account.
+ *
+ * The order matters: nothing filesystem-related runs while the manifest itself
+ * is unusable, so an author never reads a page of path errors caused by a
+ * single missing field.
+ */
+export function checkCraftDeployment(options) {
+    const rootDir = resolve(options.rootDir ?? process.cwd());
+    const validation = validateCraftDeploymentDefinition(options.definition);
+    const diagnostics = [...validation.diagnostics];
+    if (!validation.definition) {
+        return { passed: false, manifest: null, diagnostics };
+    }
+    const manifest = resolveCraftDeploymentManifest(validation.definition);
+    checkRequestedTarget(options, manifest, diagnostics);
+    checkProvider(options.provider, manifest, diagnostics);
+    checkDeclaredPaths(rootDir, manifest, options.artifact === true, diagnostics);
+    checkModuleGraphs(rootDir, manifest, diagnostics);
+    if (options.artifact === true) {
+        diagnostics.push(...checkCraftDeploymentArtifact({ rootDir, manifest }));
+    }
+    return {
+        passed: diagnostics.every((diagnostic) => diagnostic.severity !== 'error'),
+        manifest,
+        diagnostics,
+    };
+}
+function checkRequestedTarget(options, manifest, diagnostics) {
+    if (options.runtime !== undefined && options.runtime !== manifest.runtime) {
+        diagnostics.push({
+            code: 'CRAFT_DEPLOY_RUNTIME_MISMATCH',
+            severity: 'error',
+            path: 'runtime',
+            runtime: manifest.runtime,
+            message: `The check requested the \`${options.runtime}\` runtime and the manifest declares \`${manifest.runtime}\`.`,
+            fix: CRAFT_DEPLOYMENT_RUNTIMES.includes(options.runtime)
+                ? 'Drop `--runtime`, or change `runtime` in the manifest.'
+                : `Use one of ${CRAFT_DEPLOYMENT_RUNTIMES.join(', ')}.`,
+        });
+    }
+    if (options.platform !== undefined &&
+        options.platform !== manifest.platform) {
+        diagnostics.push({
+            code: 'CRAFT_DEPLOY_PLATFORM_MISMATCH',
+            severity: 'error',
+            path: 'platform',
+            platform: manifest.platform,
+            message: `The check requested the \`${options.platform}\` platform and the manifest declares \`${manifest.platform}\`.`,
+            fix: CRAFT_DEPLOYMENT_PLATFORMS.includes(options.platform)
+                ? 'Drop `--platform`, or change `platform` in the manifest.'
+                : `Use one of ${CRAFT_DEPLOYMENT_PLATFORMS.join(', ')}.`,
+        });
+    }
+}
+function checkProvider(provider, manifest, diagnostics) {
+    if (provider === undefined)
+        return;
+    const descriptor = findCraftDeploymentProvider(provider);
+    if (!descriptor) {
+        diagnostics.push({
+            code: 'CRAFT_DEPLOY_PROVIDER_UNKNOWN',
+            severity: 'error',
+            provider,
+            message: `\`${provider}\` is not in the provider capability matrix.`,
+            fix: 'Use a documented provider name, or register the provider before checking.',
+        });
+        return;
+    }
+    const capability = requiredCapability(manifest.runtime, manifest.runtime === 'static' ? manifest.static.mode : undefined);
+    if (!descriptor.capabilities.includes(capability)) {
+        diagnostics.push({
+            code: 'CRAFT_DEPLOY_PROVIDER_CAPABILITY_MISSING',
+            severity: 'error',
+            provider,
+            runtime: manifest.runtime,
+            message: `\`${provider}\` does not declare the \`${capability}\` capability.`,
+            fix: `Choose a provider declaring \`${capability}\`, or change the runtime or the static mode.`,
+        });
+    }
+    if (!descriptor.platforms.includes(manifest.platform)) {
+        diagnostics.push({
+            code: 'CRAFT_DEPLOY_PROVIDER_PLATFORM_UNSUPPORTED',
+            severity: 'error',
+            provider,
+            platform: manifest.platform,
+            message: `\`${provider}\` does not deploy to \`${manifest.platform}\`.`,
+            fix: `Use one of ${descriptor.platforms.join(', ')}, or change the platform.`,
+        });
+    }
+}
+function declaredPaths(manifest) {
+    const paths = [];
+    const runtimeSection = manifest.runtime === 'node'
+        ? { key: 'server', section: manifest.server }
+        : manifest.runtime === 'worker'
+            ? { key: 'worker', section: manifest.worker }
+            : manifest.runtime === 'lambda'
+                ? { key: 'lambda', section: manifest.lambda }
+                : null;
+    if (runtimeSection) {
+        paths.push({
+            path: `${runtimeSection.key}.entry`,
+            value: runtimeSection.section.entry,
+            kind: 'output',
+        });
+        if (runtimeSection.section.source) {
+            paths.push({
+                path: `${runtimeSection.key}.source`,
+                value: runtimeSection.section.source,
+                kind: 'source',
+            });
+        }
+    }
+    if (manifest.functions) {
+        paths.push({
+            path: 'functions.entry',
+            value: manifest.functions.entry,
+            kind: 'source',
+        });
+    }
+    if (manifest.client) {
+        paths.push({
+            path: 'client.outDir',
+            value: manifest.client.outDir,
+            kind: 'output',
+        });
+    }
+    for (const [index, file] of manifest.artifact.configFiles.entries()) {
+        paths.push({
+            path: `artifact.configFiles[${index}]`,
+            value: file,
+            kind: 'source',
+        });
+    }
+    return paths;
+}
+function checkDeclaredPaths(rootDir, manifest, artifactMode, diagnostics) {
+    for (const declared of declaredPaths(manifest)) {
+        if (existsSync(resolve(rootDir, declared.value)))
+            continue;
+        // Before the build, a missing output is expected; it only becomes an
+        // error once the check claims to inspect the artefact.
+        const severity = declared.kind === 'source' || artifactMode ? 'error' : 'warning';
+        diagnostics.push({
+            code: 'CRAFT_DEPLOY_PATH_MISSING',
+            severity,
+            path: declared.path,
+            file: declared.value,
+            runtime: manifest.runtime,
+            message: `\`${declared.value}\` does not exist.`,
+            fix: declared.kind === 'output'
+                ? 'Run the declared build command, or correct the path in the manifest.'
+                : 'Correct the path in the manifest.',
+        });
+    }
+}
+function checkModuleGraphs(rootDir, manifest, diagnostics) {
+    const runtimeEntry = analysisEntry(manifest);
+    if (runtimeEntry !== null) {
+        const graph = readCraftModuleGraph(resolve(rootDir, runtimeEntry));
+        if (graph.missingEntry === null) {
+            if (manifest.runtime === 'worker' || manifest.runtime === 'lambda') {
+                checkNodeBuiltins(rootDir, manifest, graph, diagnostics);
+            }
+            if (manifest.runtime === 'node') {
+                checkHealthRoutes(manifest, graph, diagnostics);
+            }
+            checkEnvironment(manifest, graph, runtimeEntry, diagnostics);
+        }
+    }
+    checkFunctionIds(rootDir, manifest, diagnostics);
+}
+/** Module the static analysis reads: the source when declared, else the build output. */
+function analysisEntry(manifest) {
+    if (manifest.runtime === 'node') {
+        return manifest.server.source ?? manifest.server.entry;
+    }
+    if (manifest.runtime === 'worker') {
+        return manifest.worker.source ?? manifest.worker.entry;
+    }
+    if (manifest.runtime === 'lambda') {
+        return manifest.lambda.source ?? manifest.lambda.entry;
+    }
+    return null;
+}
+function checkNodeBuiltins(rootDir, manifest, graph, diagnostics) {
+    for (const moduleImport of graph.imports) {
+        if (!isNodeBuiltin(moduleImport.specifier))
+            continue;
+        diagnostics.push({
+            code: 'CRAFT_DEPLOY_NODE_BUILTIN_IMPORT',
+            severity: 'error',
+            file: relative(rootDir, moduleImport.file),
+            line: moduleImport.line,
+            runtime: manifest.runtime,
+            platform: manifest.platform,
+            message: `\`${moduleImport.specifier}\` is a Node built-in and the \`${manifest.runtime}\` runtime does not provide it.`,
+            fix: 'Replace it with a Web API, or move the code behind an adapter this entry does not import.',
+        });
+    }
+}
+function checkHealthRoutes(manifest, graph, diagnostics) {
+    const routes = [
+        {
+            code: 'CRAFT_DEPLOY_HEALTH_PATH_MISSING',
+            path: 'server.healthPath',
+            value: manifest.server.healthPath,
+        },
+        {
+            code: 'CRAFT_DEPLOY_READY_PATH_MISSING',
+            path: 'server.readyPath',
+            value: manifest.server.readyPath,
+        },
+    ];
+    for (const route of routes) {
+        if (graph.source.includes(`'${route.value}'`))
+            continue;
+        if (graph.source.includes(`"${route.value}"`))
+            continue;
+        if (graph.source.includes(`\`${route.value}\``))
+            continue;
+        diagnostics.push({
+            code: route.code,
+            severity: 'error',
+            path: route.path,
+            runtime: 'node',
+            message: `The SSR entry never mentions \`${route.value}\`.`,
+            fix: 'Serve the declared path, or align the manifest with the path the server exposes.',
+        });
+    }
+}
+function checkEnvironment(manifest, graph, entry, diagnostics) {
+    const declared = new Set(manifest.env.map((variable) => variable.name));
+    for (const name of collectEnvironmentReads(graph.source)) {
+        if (declared.has(name))
+            continue;
+        diagnostics.push({
+            code: 'CRAFT_DEPLOY_ENV_UNDECLARED',
+            severity: 'warning',
+            path: 'env',
+            file: entry,
+            runtime: manifest.runtime,
+            message: `\`${name}\` is read by the runtime entry and is not declared in \`env\`.`,
+            fix: `Add \`{ name: '${name}', required: … }\` to \`env\`, or stop reading it from the entry.`,
+        });
+    }
+}
+function checkFunctionIds(rootDir, manifest, diagnostics) {
+    const functions = manifest.functions;
+    if (!functions || functions.ids.length === 0)
+        return;
+    const graph = readCraftModuleGraph(resolve(rootDir, functions.entry));
+    if (graph.missingEntry !== null)
+        return;
+    for (const [index, id] of functions.ids.entries()) {
+        if (graph.source.includes(id))
+            continue;
+        diagnostics.push({
+            code: 'CRAFT_DEPLOY_FUNCTION_ID_UNKNOWN',
+            severity: 'warning',
+            path: `functions.ids[${index}]`,
+            file: functions.entry,
+            runtime: manifest.runtime,
+            message: `\`${id}\` does not appear in the module graph of \`${functions.entry}\`.`,
+            fix: 'Register the function in the entry, or remove the identifier from the manifest.',
+        });
+    }
+}
+//# sourceMappingURL=check.js.map