@craft-ts/deploy 0.7.0-beta.15

package/src/lib/check.js.map

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

package/src/lib/diagnostics.d.ts

@@ -0,0 +1,38 @@
+import type { CraftDeploymentPlatform, CraftDeploymentRuntime } from './manifest.js';
+export type CraftDeploymentSeverity = 'error' | 'warning';
+export declare const CRAFT_DEPLOYMENT_DIAGNOSTIC_CODES: readonly ["CRAFT_DEPLOY_CONFIG_NOT_FOUND", "CRAFT_DEPLOY_CONFIG_LOAD_FAILED", "CRAFT_DEPLOY_CONFIG_NO_DEFAULT_EXPORT", "CRAFT_DEPLOY_MANIFEST_NOT_AN_OBJECT", "CRAFT_DEPLOY_MANIFEST_MISSING_FIELD", "CRAFT_DEPLOY_MANIFEST_INVALID_FIELD", "CRAFT_DEPLOY_MANIFEST_UNKNOWN_RUNTIME", "CRAFT_DEPLOY_MANIFEST_UNKNOWN_PLATFORM", "CRAFT_DEPLOY_MANIFEST_SECTION_MISSING", "CRAFT_DEPLOY_MANIFEST_SECTION_UNEXPECTED", "CRAFT_DEPLOY_PROTOCOL_VERSION_UNSUPPORTED", "CRAFT_DEPLOY_RUNTIME_MISMATCH", "CRAFT_DEPLOY_PLATFORM_MISMATCH", "CRAFT_DEPLOY_RUNTIME_PLATFORM_INCOMPATIBLE", "CRAFT_DEPLOY_PROVIDER_UNKNOWN", "CRAFT_DEPLOY_PROVIDER_CAPABILITY_MISSING", "CRAFT_DEPLOY_PROVIDER_PLATFORM_UNSUPPORTED", "CRAFT_DEPLOY_PROVIDER_NOT_INSTALLED", "CRAFT_DEPLOY_PROVIDER_INVALID_MODULE", "CRAFT_DEPLOY_PROVIDER_CREDENTIALS_MISSING", "CRAFT_DEPLOY_PROVIDER_STATE_UNAVAILABLE", "CRAFT_DEPLOY_PROVIDER_TOOLCHAIN_MISSING", "CRAFT_DEPLOY_PROVIDER_UNSUPPORTED_RESOURCE", "CRAFT_DEPLOY_DEPLOY_NOT_CONFIRMED", "CRAFT_DEPLOY_PATH_MISSING", "CRAFT_DEPLOY_NODE_BUILTIN_IMPORT", "CRAFT_DEPLOY_HEALTH_PATH_MISSING", "CRAFT_DEPLOY_READY_PATH_MISSING", "CRAFT_DEPLOY_SSG_ROUTES_MISSING", "CRAFT_DEPLOY_SSG_ROUTE_NOT_STATIC", "CRAFT_DEPLOY_SPA_FALLBACK_MISSING", "CRAFT_DEPLOY_ENV_NAME_INVALID", "CRAFT_DEPLOY_ENV_VALUE_FORBIDDEN", "CRAFT_DEPLOY_ENV_UNDECLARED", "CRAFT_DEPLOY_FUNCTION_ID_DUPLICATE", "CRAFT_DEPLOY_FUNCTION_ID_UNKNOWN", "CRAFT_DEPLOY_ARTIFACT_MISSING", "CRAFT_DEPLOY_ARTIFACT_NO_ENTRY", "CRAFT_DEPLOY_ARTIFACT_NO_JAVASCRIPT", "CRAFT_DEPLOY_ARTIFACT_SOURCE_MAP", "CRAFT_DEPLOY_SSG_ROUTE_NOT_RENDERED"];
+export type CraftDeploymentDiagnosticCode = (typeof CRAFT_DEPLOYMENT_DIAGNOSTIC_CODES)[number];
+/**
+ * A single deployment problem. The shape mirrors the reference page: a reader
+ * must find the concerned runtime or platform, the file, the cause and the
+ * expected correction without opening the source of the checker.
+ */
+export type CraftDeploymentDiagnostic = Readonly<{
+    code: CraftDeploymentDiagnosticCode;
+    severity: CraftDeploymentSeverity;
+    /** What is wrong, stated as a fact. */
+    message: string;
+    /** What the author has to change. */
+    fix: string;
+    /** Dotted path inside the manifest, e.g. `server.entry`. */
+    path?: string;
+    /** Path relative to the checked root. */
+    file?: string;
+    line?: number;
+    runtime?: CraftDeploymentRuntime;
+    platform?: CraftDeploymentPlatform;
+    provider?: string;
+}>;
+export type CraftDeploymentDiagnosticDescription = Readonly<{
+    code: CraftDeploymentDiagnosticCode;
+    title: string;
+    cause: string;
+    fix: string;
+}>;
+/**
+ * Documentation of every code the checker can emit. The reference page and
+ * this table are verified against each other, so a new code cannot ship
+ * undocumented.
+ */
+export declare const CRAFT_DEPLOYMENT_DIAGNOSTICS: Readonly<Record<CraftDeploymentDiagnosticCode, CraftDeploymentDiagnosticDescription>>;
+//# sourceMappingURL=diagnostics.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../../../../../libs/deploy/src/lib/diagnostics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,uBAAuB,EACvB,sBAAsB,EACvB,MAAM,eAAe,CAAC;AAEvB,MAAM,MAAM,uBAAuB,GAAG,OAAO,GAAG,SAAS,CAAC;AAE1D,eAAO,MAAM,iCAAiC,2iDA0CpC,CAAC;AAEX,MAAM,MAAM,6BAA6B,GACvC,CAAC,OAAO,iCAAiC,CAAC,CAAC,MAAM,CAAC,CAAC;AAErD;;;;GAIG;AACH,MAAM,MAAM,yBAAyB,GAAG,QAAQ,CAAC;IAC/C,IAAI,EAAE,6BAA6B,CAAC;IACpC,QAAQ,EAAE,uBAAuB,CAAC;IAClC,uCAAuC;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,qCAAqC;IACrC,GAAG,EAAE,MAAM,CAAC;IACZ,4DAA4D;IAC5D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,yCAAyC;IACzC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,sBAAsB,CAAC;IACjC,QAAQ,CAAC,EAAE,uBAAuB,CAAC;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC,CAAC;AAEH,MAAM,MAAM,oCAAoC,GAAG,QAAQ,CAAC;IAC1D,IAAI,EAAE,6BAA6B,CAAC;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb,CAAC,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,4BAA4B,EAAE,QAAQ,CACjD,MAAM,CAAC,6BAA6B,EAAE,oCAAoC,CAAC,CAwR3E,CAAC"}

package/src/lib/diagnostics.js

@@ -0,0 +1,297 @@
+export const CRAFT_DEPLOYMENT_DIAGNOSTIC_CODES = [
+    'CRAFT_DEPLOY_CONFIG_NOT_FOUND',
+    'CRAFT_DEPLOY_CONFIG_LOAD_FAILED',
+    'CRAFT_DEPLOY_CONFIG_NO_DEFAULT_EXPORT',
+    'CRAFT_DEPLOY_MANIFEST_NOT_AN_OBJECT',
+    'CRAFT_DEPLOY_MANIFEST_MISSING_FIELD',
+    'CRAFT_DEPLOY_MANIFEST_INVALID_FIELD',
+    'CRAFT_DEPLOY_MANIFEST_UNKNOWN_RUNTIME',
+    'CRAFT_DEPLOY_MANIFEST_UNKNOWN_PLATFORM',
+    'CRAFT_DEPLOY_MANIFEST_SECTION_MISSING',
+    'CRAFT_DEPLOY_MANIFEST_SECTION_UNEXPECTED',
+    'CRAFT_DEPLOY_PROTOCOL_VERSION_UNSUPPORTED',
+    'CRAFT_DEPLOY_RUNTIME_MISMATCH',
+    'CRAFT_DEPLOY_PLATFORM_MISMATCH',
+    'CRAFT_DEPLOY_RUNTIME_PLATFORM_INCOMPATIBLE',
+    'CRAFT_DEPLOY_PROVIDER_UNKNOWN',
+    'CRAFT_DEPLOY_PROVIDER_CAPABILITY_MISSING',
+    'CRAFT_DEPLOY_PROVIDER_PLATFORM_UNSUPPORTED',
+    'CRAFT_DEPLOY_PROVIDER_NOT_INSTALLED',
+    'CRAFT_DEPLOY_PROVIDER_INVALID_MODULE',
+    'CRAFT_DEPLOY_PROVIDER_CREDENTIALS_MISSING',
+    'CRAFT_DEPLOY_PROVIDER_STATE_UNAVAILABLE',
+    'CRAFT_DEPLOY_PROVIDER_TOOLCHAIN_MISSING',
+    'CRAFT_DEPLOY_PROVIDER_UNSUPPORTED_RESOURCE',
+    'CRAFT_DEPLOY_DEPLOY_NOT_CONFIRMED',
+    'CRAFT_DEPLOY_PATH_MISSING',
+    'CRAFT_DEPLOY_NODE_BUILTIN_IMPORT',
+    'CRAFT_DEPLOY_HEALTH_PATH_MISSING',
+    'CRAFT_DEPLOY_READY_PATH_MISSING',
+    'CRAFT_DEPLOY_SSG_ROUTES_MISSING',
+    'CRAFT_DEPLOY_SSG_ROUTE_NOT_STATIC',
+    'CRAFT_DEPLOY_SPA_FALLBACK_MISSING',
+    'CRAFT_DEPLOY_ENV_NAME_INVALID',
+    'CRAFT_DEPLOY_ENV_VALUE_FORBIDDEN',
+    'CRAFT_DEPLOY_ENV_UNDECLARED',
+    'CRAFT_DEPLOY_FUNCTION_ID_DUPLICATE',
+    'CRAFT_DEPLOY_FUNCTION_ID_UNKNOWN',
+    'CRAFT_DEPLOY_ARTIFACT_MISSING',
+    'CRAFT_DEPLOY_ARTIFACT_NO_ENTRY',
+    'CRAFT_DEPLOY_ARTIFACT_NO_JAVASCRIPT',
+    'CRAFT_DEPLOY_ARTIFACT_SOURCE_MAP',
+    'CRAFT_DEPLOY_SSG_ROUTE_NOT_RENDERED',
+];
+/**
+ * Documentation of every code the checker can emit. The reference page and
+ * this table are verified against each other, so a new code cannot ship
+ * undocumented.
+ */
+export const CRAFT_DEPLOYMENT_DIAGNOSTICS = Object.freeze({
+    CRAFT_DEPLOY_CONFIG_NOT_FOUND: {
+        code: 'CRAFT_DEPLOY_CONFIG_NOT_FOUND',
+        title: 'No deployment manifest found',
+        cause: 'No `craft.deploy.ts`, `craft.deploy.mjs`, `craft.deploy.js` or `craft.deploy.json` was found in the checked directory.',
+        fix: 'Create a manifest with `defineCraftDeployment` or point the CLI at one with `--config`.',
+    },
+    CRAFT_DEPLOY_CONFIG_LOAD_FAILED: {
+        code: 'CRAFT_DEPLOY_CONFIG_LOAD_FAILED',
+        title: 'The deployment manifest could not be imported',
+        cause: 'Loading the manifest threw, or the serialised manifest is not valid JSON. A TypeScript manifest also fails when the running Node cannot strip types and TypeScript is not installed.',
+        fix: 'Fix the thrown error, or run the CLI under a TypeScript loader, or commit a `craft.deploy.json` produced by the build.',
+    },
+    CRAFT_DEPLOY_CONFIG_NO_DEFAULT_EXPORT: {
+        code: 'CRAFT_DEPLOY_CONFIG_NO_DEFAULT_EXPORT',
+        title: 'The deployment manifest has no default export',
+        cause: 'The module loaded but exposes no default export to read.',
+        fix: 'Add `export default defineCraftDeployment({ ... })`.',
+    },
+    CRAFT_DEPLOY_MANIFEST_NOT_AN_OBJECT: {
+        code: 'CRAFT_DEPLOY_MANIFEST_NOT_AN_OBJECT',
+        title: 'The manifest is not an object',
+        cause: 'The default export or the parsed JSON is not a plain object.',
+        fix: 'Export the object returned by `defineCraftDeployment`.',
+    },
+    CRAFT_DEPLOY_MANIFEST_MISSING_FIELD: {
+        code: 'CRAFT_DEPLOY_MANIFEST_MISSING_FIELD',
+        title: 'A required manifest field is missing',
+        cause: 'A field the runtime or the providers need is absent.',
+        fix: 'Add the field reported by `path`.',
+    },
+    CRAFT_DEPLOY_MANIFEST_INVALID_FIELD: {
+        code: 'CRAFT_DEPLOY_MANIFEST_INVALID_FIELD',
+        title: 'A manifest field has an invalid value',
+        cause: 'The field exists but its type or its shape does not match the contract.',
+        fix: 'Correct the value reported by `path`; the message states what was expected.',
+    },
+    CRAFT_DEPLOY_MANIFEST_UNKNOWN_RUNTIME: {
+        code: 'CRAFT_DEPLOY_MANIFEST_UNKNOWN_RUNTIME',
+        title: 'Unknown runtime',
+        cause: '`runtime` is not one of `static`, `node`, `worker` or `lambda`.',
+        fix: 'Pick one of the four supported runtimes.',
+    },
+    CRAFT_DEPLOY_MANIFEST_UNKNOWN_PLATFORM: {
+        code: 'CRAFT_DEPLOY_MANIFEST_UNKNOWN_PLATFORM',
+        title: 'Unknown platform',
+        cause: '`platform` is not part of the documented platform list.',
+        fix: 'Pick a supported platform, or open an issue to add it to the matrix.',
+    },
+    CRAFT_DEPLOY_MANIFEST_SECTION_MISSING: {
+        code: 'CRAFT_DEPLOY_MANIFEST_SECTION_MISSING',
+        title: 'The runtime section is missing',
+        cause: 'Each runtime requires its own section: `static` and `client`, `server`, `worker` or `lambda`.',
+        fix: 'Add the section the runtime requires.',
+    },
+    CRAFT_DEPLOY_MANIFEST_SECTION_UNEXPECTED: {
+        code: 'CRAFT_DEPLOY_MANIFEST_SECTION_UNEXPECTED',
+        title: 'A section does not belong to this runtime',
+        cause: 'A section of another runtime is present; nothing would ever execute it.',
+        fix: 'Remove the section, or change the runtime to the one that uses it.',
+    },
+    CRAFT_DEPLOY_PROTOCOL_VERSION_UNSUPPORTED: {
+        code: 'CRAFT_DEPLOY_PROTOCOL_VERSION_UNSUPPORTED',
+        title: 'Unsupported manifest protocol version',
+        cause: 'The serialised manifest was produced by another version of the protocol.',
+        fix: 'Rebuild the manifest with the current CraftTS tooling, or follow the migration notes.',
+    },
+    CRAFT_DEPLOY_RUNTIME_MISMATCH: {
+        code: 'CRAFT_DEPLOY_RUNTIME_MISMATCH',
+        title: 'The requested runtime is not the manifest runtime',
+        cause: '`--runtime` was passed with a value the manifest does not declare.',
+        fix: 'Drop the flag, or change `runtime` in the manifest.',
+    },
+    CRAFT_DEPLOY_PLATFORM_MISMATCH: {
+        code: 'CRAFT_DEPLOY_PLATFORM_MISMATCH',
+        title: 'The requested platform is not the manifest platform',
+        cause: '`--platform` was passed with a value the manifest does not declare.',
+        fix: 'Drop the flag, or change `platform` in the manifest.',
+    },
+    CRAFT_DEPLOY_RUNTIME_PLATFORM_INCOMPATIBLE: {
+        code: 'CRAFT_DEPLOY_RUNTIME_PLATFORM_INCOMPATIBLE',
+        title: 'This platform cannot execute this runtime',
+        cause: 'The platform has no execution shape for the declared runtime, for instance a `lambda` runtime on Cloudflare.',
+        fix: 'Change the runtime or the platform; the compatibility matrix lists the supported pairs.',
+    },
+    CRAFT_DEPLOY_PROVIDER_UNKNOWN: {
+        code: 'CRAFT_DEPLOY_PROVIDER_UNKNOWN',
+        title: 'Unknown provider',
+        cause: 'The provider name is absent from the capability matrix.',
+        fix: 'Use a documented provider name, or register the provider before checking.',
+    },
+    CRAFT_DEPLOY_PROVIDER_CAPABILITY_MISSING: {
+        code: 'CRAFT_DEPLOY_PROVIDER_CAPABILITY_MISSING',
+        title: 'The provider does not support this runtime',
+        cause: 'The capability required by the runtime, and by the static mode when relevant, is not offered by the provider.',
+        fix: 'Choose a provider that declares the capability, or change the runtime or the static mode.',
+    },
+    CRAFT_DEPLOY_PROVIDER_PLATFORM_UNSUPPORTED: {
+        code: 'CRAFT_DEPLOY_PROVIDER_PLATFORM_UNSUPPORTED',
+        title: 'The provider does not target this platform',
+        cause: 'The provider cannot deploy to the platform declared by the manifest.',
+        fix: 'Choose a provider that targets the platform, or change the platform.',
+    },
+    CRAFT_DEPLOY_PROVIDER_NOT_INSTALLED: {
+        code: 'CRAFT_DEPLOY_PROVIDER_NOT_INSTALLED',
+        title: 'The provider package is not installed',
+        cause: 'The CLI resolves a provider from `@craft-ts/deploy-<name>` at run time, and that package is absent from the project.',
+        fix: 'Install the provider package, or point `--provider-module` at the module that exports it.',
+    },
+    CRAFT_DEPLOY_PROVIDER_INVALID_MODULE: {
+        code: 'CRAFT_DEPLOY_PROVIDER_INVALID_MODULE',
+        title: 'The provider package does not export a provider',
+        cause: 'The module loaded but exposes no `createCraftDeploymentProvider` factory.',
+        fix: 'Export `createCraftDeploymentProvider(options?)` returning a `CraftDeploymentProvider`.',
+    },
+    CRAFT_DEPLOY_PROVIDER_CREDENTIALS_MISSING: {
+        code: 'CRAFT_DEPLOY_PROVIDER_CREDENTIALS_MISSING',
+        title: 'The provider has no credentials',
+        cause: 'A credential the platform requires is absent from the environment. The tooling never stores one, so it can only report the name it expected.',
+        fix: 'Export the named variable in the shell or the CI secret store, then run the command again.',
+    },
+    CRAFT_DEPLOY_PROVIDER_STATE_UNAVAILABLE: {
+        code: 'CRAFT_DEPLOY_PROVIDER_STATE_UNAVAILABLE',
+        title: 'The provider state cannot be read',
+        cause: 'An infrastructure provider reconciles against a recorded state; without it, a deployment cannot tell a creation from an update.',
+        fix: 'Make the state backend reachable, or initialise it for this stage before deploying.',
+    },
+    CRAFT_DEPLOY_PROVIDER_TOOLCHAIN_MISSING: {
+        code: 'CRAFT_DEPLOY_PROVIDER_TOOLCHAIN_MISSING',
+        title: 'A tool the provider drives is missing',
+        cause: 'The provider shells out to a CLI or imports a runtime package that is not installed.',
+        fix: 'Install the reported tool, or choose a provider that does not need it.',
+    },
+    CRAFT_DEPLOY_PROVIDER_UNSUPPORTED_RESOURCE: {
+        code: 'CRAFT_DEPLOY_PROVIDER_UNSUPPORTED_RESOURCE',
+        title: 'The provider has no resource for this part of the manifest',
+        cause: 'The runtime, the platform or a declared binding maps to nothing the provider knows how to create.',
+        fix: 'Remove the declaration, or deploy that part with a provider that supports it.',
+    },
+    CRAFT_DEPLOY_DEPLOY_NOT_CONFIRMED: {
+        code: 'CRAFT_DEPLOY_DEPLOY_NOT_CONFIRMED',
+        title: 'A deployment was requested without confirmation',
+        cause: '`craft-ts deploy` mutates an infrastructure, so it refuses to run until the plan has been approved explicitly.',
+        fix: 'Review `craft-ts deploy preview`, then pass `--yes` to apply it.',
+    },
+    CRAFT_DEPLOY_PATH_MISSING: {
+        code: 'CRAFT_DEPLOY_PATH_MISSING',
+        title: 'A declared path does not exist',
+        cause: 'An entry point, an output directory or a configuration file declared by the manifest is absent from disk.',
+        fix: 'Run the build that produces it, or correct the path in the manifest.',
+    },
+    CRAFT_DEPLOY_NODE_BUILTIN_IMPORT: {
+        code: 'CRAFT_DEPLOY_NODE_BUILTIN_IMPORT',
+        title: 'A Node built-in is imported by a Worker or Lambda entry',
+        cause: 'The module graph reachable from the entry imports a Node built-in such as `node:fs` or `node:http`, which a Worker runtime does not provide.',
+        fix: 'Replace the built-in with a Web API, or move the code behind a platform adapter that the Worker entry does not import.',
+    },
+    CRAFT_DEPLOY_HEALTH_PATH_MISSING: {
+        code: 'CRAFT_DEPLOY_HEALTH_PATH_MISSING',
+        title: 'The health route is not served by the SSR entry',
+        cause: 'The path declared as `server.healthPath` was not found in the module graph of the SSR entry.',
+        fix: 'Serve the declared path, or align the manifest with the path the server exposes.',
+    },
+    CRAFT_DEPLOY_READY_PATH_MISSING: {
+        code: 'CRAFT_DEPLOY_READY_PATH_MISSING',
+        title: 'The readiness route is not served by the SSR entry',
+        cause: 'The path declared as `server.readyPath` was not found in the module graph of the SSR entry.',
+        fix: 'Serve the declared path, or align the manifest with the path the server exposes.',
+    },
+    CRAFT_DEPLOY_SSG_ROUTES_MISSING: {
+        code: 'CRAFT_DEPLOY_SSG_ROUTES_MISSING',
+        title: 'The SSG mode declares no route',
+        cause: 'A `ssg` deployment pre-renders one HTML file per route and the route list is empty.',
+        fix: 'List the routes in `static.routes`, or switch the mode to `spa`.',
+    },
+    CRAFT_DEPLOY_SSG_ROUTE_NOT_STATIC: {
+        code: 'CRAFT_DEPLOY_SSG_ROUTE_NOT_STATIC',
+        title: 'An SSG route cannot be pre-rendered',
+        cause: 'The route is not an absolute literal path: it carries a `:param`, a wildcard or a query string, so no single HTML file represents it.',
+        fix: 'Expand the route into its literal paths, or declare it in `static.serverRoutes`.',
+    },
+    CRAFT_DEPLOY_SPA_FALLBACK_MISSING: {
+        code: 'CRAFT_DEPLOY_SPA_FALLBACK_MISSING',
+        title: 'The SPA fallback document is missing from the client output',
+        cause: 'A `spa` deployment answers unknown paths with the fallback document, which is absent from the built output.',
+        fix: 'Build the client, or correct `static.fallback`.',
+    },
+    CRAFT_DEPLOY_ENV_NAME_INVALID: {
+        code: 'CRAFT_DEPLOY_ENV_NAME_INVALID',
+        title: 'Invalid environment variable name',
+        cause: 'A declared name is not an upper snake case identifier, which several platforms reject.',
+        fix: 'Rename the variable to `UPPER_SNAKE_CASE`.',
+    },
+    CRAFT_DEPLOY_ENV_VALUE_FORBIDDEN: {
+        code: 'CRAFT_DEPLOY_ENV_VALUE_FORBIDDEN',
+        title: 'An environment variable carries a value',
+        cause: 'The manifest is committed and read by every provider, so it declares names and requirements only.',
+        fix: 'Remove the value and provide it through the CI or the provider secret store.',
+    },
+    CRAFT_DEPLOY_ENV_UNDECLARED: {
+        code: 'CRAFT_DEPLOY_ENV_UNDECLARED',
+        title: 'An environment variable is read but not declared',
+        cause: 'The module graph of the runtime entry reads a variable the manifest does not list, so no provider can know it must be set.',
+        fix: 'Declare the variable in `env`, or stop reading it from the runtime entry.',
+    },
+    CRAFT_DEPLOY_FUNCTION_ID_DUPLICATE: {
+        code: 'CRAFT_DEPLOY_FUNCTION_ID_DUPLICATE',
+        title: 'A server-function identifier is declared twice',
+        cause: 'The identifier is the routing key of the protocol, so a duplicate makes the exposed contract ambiguous.',
+        fix: 'Keep one declaration per identifier.',
+    },
+    CRAFT_DEPLOY_FUNCTION_ID_UNKNOWN: {
+        code: 'CRAFT_DEPLOY_FUNCTION_ID_UNKNOWN',
+        title: 'A declared server-function identifier is not in the registry entry',
+        cause: 'The identifier does not appear in the module graph of `functions.entry`.',
+        fix: 'Register the function in the entry, or remove the identifier from the manifest.',
+    },
+    CRAFT_DEPLOY_ARTIFACT_MISSING: {
+        code: 'CRAFT_DEPLOY_ARTIFACT_MISSING',
+        title: 'The artefact directory does not exist',
+        cause: 'The directory the provider would publish has not been produced.',
+        fix: 'Run the declared build command before checking the artefact.',
+    },
+    CRAFT_DEPLOY_ARTIFACT_NO_ENTRY: {
+        code: 'CRAFT_DEPLOY_ARTIFACT_NO_ENTRY',
+        title: 'The artefact has no browser entry point',
+        cause: 'The public directory contains no `index.html`.',
+        fix: 'Check the build output directory declared in `client.outDir`.',
+    },
+    CRAFT_DEPLOY_ARTIFACT_NO_JAVASCRIPT: {
+        code: 'CRAFT_DEPLOY_ARTIFACT_NO_JAVASCRIPT',
+        title: 'The artefact contains no JavaScript',
+        cause: 'The public directory has no `.js` or `.mjs` file, which means the build produced nothing executable.',
+        fix: 'Check the build command and its output directory.',
+    },
+    CRAFT_DEPLOY_ARTIFACT_SOURCE_MAP: {
+        code: 'CRAFT_DEPLOY_ARTIFACT_SOURCE_MAP',
+        title: 'The artefact ships source maps',
+        cause: 'The source map policy is `forbidden` and the public directory contains `.map` files.',
+        fix: 'Disable source maps in the production build, or relax `artifact.sourceMaps`.',
+    },
+    CRAFT_DEPLOY_SSG_ROUTE_NOT_RENDERED: {
+        code: 'CRAFT_DEPLOY_SSG_ROUTE_NOT_RENDERED',
+        title: 'A declared SSG route has no pre-rendered document',
+        cause: 'The artefact contains neither `<route>.html` nor `<route>/index.html` for a route listed in `static.routes`.',
+        fix: 'Run the pre-render step for that route, or remove it from `static.routes`.',
+    },
+});
+//# sourceMappingURL=diagnostics.js.map

package/src/lib/diagnostics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.js","sourceRoot":"","sources":["../../../../../libs/deploy/src/lib/diagnostics.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  CraftDeploymentPlatform,\n  CraftDeploymentRuntime,\n} from './manifest.js';\n\nexport type CraftDeploymentSeverity = 'error' | 'warning';\n\nexport const CRAFT_DEPLOYMENT_DIAGNOSTIC_CODES = [\n  'CRAFT_DEPLOY_CONFIG_NOT_FOUND',\n  'CRAFT_DEPLOY_CONFIG_LOAD_FAILED',\n  'CRAFT_DEPLOY_CONFIG_NO_DEFAULT_EXPORT',\n  'CRAFT_DEPLOY_MANIFEST_NOT_AN_OBJECT',\n  'CRAFT_DEPLOY_MANIFEST_MISSING_FIELD',\n  'CRAFT_DEPLOY_MANIFEST_INVALID_FIELD',\n  'CRAFT_DEPLOY_MANIFEST_UNKNOWN_RUNTIME',\n  'CRAFT_DEPLOY_MANIFEST_UNKNOWN_PLATFORM',\n  'CRAFT_DEPLOY_MANIFEST_SECTION_MISSING',\n  'CRAFT_DEPLOY_MANIFEST_SECTION_UNEXPECTED',\n  'CRAFT_DEPLOY_PROTOCOL_VERSION_UNSUPPORTED',\n  'CRAFT_DEPLOY_RUNTIME_MISMATCH',\n  'CRAFT_DEPLOY_PLATFORM_MISMATCH',\n  'CRAFT_DEPLOY_RUNTIME_PLATFORM_INCOMPATIBLE',\n  'CRAFT_DEPLOY_PROVIDER_UNKNOWN',\n  'CRAFT_DEPLOY_PROVIDER_CAPABILITY_MISSING',\n  'CRAFT_DEPLOY_PROVIDER_PLATFORM_UNSUPPORTED',\n  'CRAFT_DEPLOY_PROVIDER_NOT_INSTALLED',\n  'CRAFT_DEPLOY_PROVIDER_INVALID_MODULE',\n  'CRAFT_DEPLOY_PROVIDER_CREDENTIALS_MISSING',\n  'CRAFT_DEPLOY_PROVIDER_STATE_UNAVAILABLE',\n  'CRAFT_DEPLOY_PROVIDER_TOOLCHAIN_MISSING',\n  'CRAFT_DEPLOY_PROVIDER_UNSUPPORTED_RESOURCE',\n  'CRAFT_DEPLOY_DEPLOY_NOT_CONFIRMED',\n  'CRAFT_DEPLOY_PATH_MISSING',\n  'CRAFT_DEPLOY_NODE_BUILTIN_IMPORT',\n  'CRAFT_DEPLOY_HEALTH_PATH_MISSING',\n  'CRAFT_DEPLOY_READY_PATH_MISSING',\n  'CRAFT_DEPLOY_SSG_ROUTES_MISSING',\n  'CRAFT_DEPLOY_SSG_ROUTE_NOT_STATIC',\n  'CRAFT_DEPLOY_SPA_FALLBACK_MISSING',\n  'CRAFT_DEPLOY_ENV_NAME_INVALID',\n  'CRAFT_DEPLOY_ENV_VALUE_FORBIDDEN',\n  'CRAFT_DEPLOY_ENV_UNDECLARED',\n  'CRAFT_DEPLOY_FUNCTION_ID_DUPLICATE',\n  'CRAFT_DEPLOY_FUNCTION_ID_UNKNOWN',\n  'CRAFT_DEPLOY_ARTIFACT_MISSING',\n  'CRAFT_DEPLOY_ARTIFACT_NO_ENTRY',\n  'CRAFT_DEPLOY_ARTIFACT_NO_JAVASCRIPT',\n  'CRAFT_DEPLOY_ARTIFACT_SOURCE_MAP',\n  'CRAFT_DEPLOY_SSG_ROUTE_NOT_RENDERED',\n] as const;\n\nexport type CraftDeploymentDiagnosticCode =\n  (typeof CRAFT_DEPLOYMENT_DIAGNOSTIC_CODES)[number];\n\n/**\n * A single deployment problem. The shape mirrors the reference page: a reader\n * must find the concerned runtime or platform, the file, the cause and the\n * expected correction without opening the source of the checker.\n */\nexport type CraftDeploymentDiagnostic = Readonly<{\n  code: CraftDeploymentDiagnosticCode;\n  severity: CraftDeploymentSeverity;\n  /** What is wrong, stated as a fact. */\n  message: string;\n  /** What the author has to change. */\n  fix: string;\n  /** Dotted path inside the manifest, e.g. `server.entry`. */\n  path?: string;\n  /** Path relative to the checked root. */\n  file?: string;\n  line?: number;\n  runtime?: CraftDeploymentRuntime;\n  platform?: CraftDeploymentPlatform;\n  provider?: string;\n}>;\n\nexport type CraftDeploymentDiagnosticDescription = Readonly<{\n  code: CraftDeploymentDiagnosticCode;\n  title: string;\n  cause: string;\n  fix: string;\n}>;\n\n/**\n * Documentation of every code the checker can emit. The reference page and\n * this table are verified against each other, so a new code cannot ship\n * undocumented.\n */\nexport const CRAFT_DEPLOYMENT_DIAGNOSTICS: Readonly<\n  Record<CraftDeploymentDiagnosticCode, CraftDeploymentDiagnosticDescription>\n> = Object.freeze({\n  CRAFT_DEPLOY_CONFIG_NOT_FOUND: {\n    code: 'CRAFT_DEPLOY_CONFIG_NOT_FOUND',\n    title: 'No deployment manifest found',\n    cause:\n      'No `craft.deploy.ts`, `craft.deploy.mjs`, `craft.deploy.js` or `craft.deploy.json` was found in the checked directory.',\n    fix: 'Create a manifest with `defineCraftDeployment` or point the CLI at one with `--config`.',\n  },\n  CRAFT_DEPLOY_CONFIG_LOAD_FAILED: {\n    code: 'CRAFT_DEPLOY_CONFIG_LOAD_FAILED',\n    title: 'The deployment manifest could not be imported',\n    cause:\n      'Loading the manifest threw, or the serialised manifest is not valid JSON. A TypeScript manifest also fails when the running Node cannot strip types and TypeScript is not installed.',\n    fix: 'Fix the thrown error, or run the CLI under a TypeScript loader, or commit a `craft.deploy.json` produced by the build.',\n  },\n  CRAFT_DEPLOY_CONFIG_NO_DEFAULT_EXPORT: {\n    code: 'CRAFT_DEPLOY_CONFIG_NO_DEFAULT_EXPORT',\n    title: 'The deployment manifest has no default export',\n    cause: 'The module loaded but exposes no default export to read.',\n    fix: 'Add `export default defineCraftDeployment({ ... })`.',\n  },\n  CRAFT_DEPLOY_MANIFEST_NOT_AN_OBJECT: {\n    code: 'CRAFT_DEPLOY_MANIFEST_NOT_AN_OBJECT',\n    title: 'The manifest is not an object',\n    cause: 'The default export or the parsed JSON is not a plain object.',\n    fix: 'Export the object returned by `defineCraftDeployment`.',\n  },\n  CRAFT_DEPLOY_MANIFEST_MISSING_FIELD: {\n    code: 'CRAFT_DEPLOY_MANIFEST_MISSING_FIELD',\n    title: 'A required manifest field is missing',\n    cause: 'A field the runtime or the providers need is absent.',\n    fix: 'Add the field reported by `path`.',\n  },\n  CRAFT_DEPLOY_MANIFEST_INVALID_FIELD: {\n    code: 'CRAFT_DEPLOY_MANIFEST_INVALID_FIELD',\n    title: 'A manifest field has an invalid value',\n    cause:\n      'The field exists but its type or its shape does not match the contract.',\n    fix: 'Correct the value reported by `path`; the message states what was expected.',\n  },\n  CRAFT_DEPLOY_MANIFEST_UNKNOWN_RUNTIME: {\n    code: 'CRAFT_DEPLOY_MANIFEST_UNKNOWN_RUNTIME',\n    title: 'Unknown runtime',\n    cause: '`runtime` is not one of `static`, `node`, `worker` or `lambda`.',\n    fix: 'Pick one of the four supported runtimes.',\n  },\n  CRAFT_DEPLOY_MANIFEST_UNKNOWN_PLATFORM: {\n    code: 'CRAFT_DEPLOY_MANIFEST_UNKNOWN_PLATFORM',\n    title: 'Unknown platform',\n    cause: '`platform` is not part of the documented platform list.',\n    fix: 'Pick a supported platform, or open an issue to add it to the matrix.',\n  },\n  CRAFT_DEPLOY_MANIFEST_SECTION_MISSING: {\n    code: 'CRAFT_DEPLOY_MANIFEST_SECTION_MISSING',\n    title: 'The runtime section is missing',\n    cause:\n      'Each runtime requires its own section: `static` and `client`, `server`, `worker` or `lambda`.',\n    fix: 'Add the section the runtime requires.',\n  },\n  CRAFT_DEPLOY_MANIFEST_SECTION_UNEXPECTED: {\n    code: 'CRAFT_DEPLOY_MANIFEST_SECTION_UNEXPECTED',\n    title: 'A section does not belong to this runtime',\n    cause:\n      'A section of another runtime is present; nothing would ever execute it.',\n    fix: 'Remove the section, or change the runtime to the one that uses it.',\n  },\n  CRAFT_DEPLOY_PROTOCOL_VERSION_UNSUPPORTED: {\n    code: 'CRAFT_DEPLOY_PROTOCOL_VERSION_UNSUPPORTED',\n    title: 'Unsupported manifest protocol version',\n    cause:\n      'The serialised manifest was produced by another version of the protocol.',\n    fix: 'Rebuild the manifest with the current CraftTS tooling, or follow the migration notes.',\n  },\n  CRAFT_DEPLOY_RUNTIME_MISMATCH: {\n    code: 'CRAFT_DEPLOY_RUNTIME_MISMATCH',\n    title: 'The requested runtime is not the manifest runtime',\n    cause: '`--runtime` was passed with a value the manifest does not declare.',\n    fix: 'Drop the flag, or change `runtime` in the manifest.',\n  },\n  CRAFT_DEPLOY_PLATFORM_MISMATCH: {\n    code: 'CRAFT_DEPLOY_PLATFORM_MISMATCH',\n    title: 'The requested platform is not the manifest platform',\n    cause:\n      '`--platform` was passed with a value the manifest does not declare.',\n    fix: 'Drop the flag, or change `platform` in the manifest.',\n  },\n  CRAFT_DEPLOY_RUNTIME_PLATFORM_INCOMPATIBLE: {\n    code: 'CRAFT_DEPLOY_RUNTIME_PLATFORM_INCOMPATIBLE',\n    title: 'This platform cannot execute this runtime',\n    cause:\n      'The platform has no execution shape for the declared runtime, for instance a `lambda` runtime on Cloudflare.',\n    fix: 'Change the runtime or the platform; the compatibility matrix lists the supported pairs.',\n  },\n  CRAFT_DEPLOY_PROVIDER_UNKNOWN: {\n    code: 'CRAFT_DEPLOY_PROVIDER_UNKNOWN',\n    title: 'Unknown provider',\n    cause: 'The provider name is absent from the capability matrix.',\n    fix: 'Use a documented provider name, or register the provider before checking.',\n  },\n  CRAFT_DEPLOY_PROVIDER_CAPABILITY_MISSING: {\n    code: 'CRAFT_DEPLOY_PROVIDER_CAPABILITY_MISSING',\n    title: 'The provider does not support this runtime',\n    cause:\n      'The capability required by the runtime, and by the static mode when relevant, is not offered by the provider.',\n    fix: 'Choose a provider that declares the capability, or change the runtime or the static mode.',\n  },\n  CRAFT_DEPLOY_PROVIDER_PLATFORM_UNSUPPORTED: {\n    code: 'CRAFT_DEPLOY_PROVIDER_PLATFORM_UNSUPPORTED',\n    title: 'The provider does not target this platform',\n    cause:\n      'The provider cannot deploy to the platform declared by the manifest.',\n    fix: 'Choose a provider that targets the platform, or change the platform.',\n  },\n  CRAFT_DEPLOY_PROVIDER_NOT_INSTALLED: {\n    code: 'CRAFT_DEPLOY_PROVIDER_NOT_INSTALLED',\n    title: 'The provider package is not installed',\n    cause:\n      'The CLI resolves a provider from `@craft-ts/deploy-<name>` at run time, and that package is absent from the project.',\n    fix: 'Install the provider package, or point `--provider-module` at the module that exports it.',\n  },\n  CRAFT_DEPLOY_PROVIDER_INVALID_MODULE: {\n    code: 'CRAFT_DEPLOY_PROVIDER_INVALID_MODULE',\n    title: 'The provider package does not export a provider',\n    cause:\n      'The module loaded but exposes no `createCraftDeploymentProvider` factory.',\n    fix: 'Export `createCraftDeploymentProvider(options?)` returning a `CraftDeploymentProvider`.',\n  },\n  CRAFT_DEPLOY_PROVIDER_CREDENTIALS_MISSING: {\n    code: 'CRAFT_DEPLOY_PROVIDER_CREDENTIALS_MISSING',\n    title: 'The provider has no credentials',\n    cause:\n      'A credential the platform requires is absent from the environment. The tooling never stores one, so it can only report the name it expected.',\n    fix: 'Export the named variable in the shell or the CI secret store, then run the command again.',\n  },\n  CRAFT_DEPLOY_PROVIDER_STATE_UNAVAILABLE: {\n    code: 'CRAFT_DEPLOY_PROVIDER_STATE_UNAVAILABLE',\n    title: 'The provider state cannot be read',\n    cause:\n      'An infrastructure provider reconciles against a recorded state; without it, a deployment cannot tell a creation from an update.',\n    fix: 'Make the state backend reachable, or initialise it for this stage before deploying.',\n  },\n  CRAFT_DEPLOY_PROVIDER_TOOLCHAIN_MISSING: {\n    code: 'CRAFT_DEPLOY_PROVIDER_TOOLCHAIN_MISSING',\n    title: 'A tool the provider drives is missing',\n    cause:\n      'The provider shells out to a CLI or imports a runtime package that is not installed.',\n    fix: 'Install the reported tool, or choose a provider that does not need it.',\n  },\n  CRAFT_DEPLOY_PROVIDER_UNSUPPORTED_RESOURCE: {\n    code: 'CRAFT_DEPLOY_PROVIDER_UNSUPPORTED_RESOURCE',\n    title: 'The provider has no resource for this part of the manifest',\n    cause:\n      'The runtime, the platform or a declared binding maps to nothing the provider knows how to create.',\n    fix: 'Remove the declaration, or deploy that part with a provider that supports it.',\n  },\n  CRAFT_DEPLOY_DEPLOY_NOT_CONFIRMED: {\n    code: 'CRAFT_DEPLOY_DEPLOY_NOT_CONFIRMED',\n    title: 'A deployment was requested without confirmation',\n    cause:\n      '`craft-ts deploy` mutates an infrastructure, so it refuses to run until the plan has been approved explicitly.',\n    fix: 'Review `craft-ts deploy preview`, then pass `--yes` to apply it.',\n  },\n  CRAFT_DEPLOY_PATH_MISSING: {\n    code: 'CRAFT_DEPLOY_PATH_MISSING',\n    title: 'A declared path does not exist',\n    cause:\n      'An entry point, an output directory or a configuration file declared by the manifest is absent from disk.',\n    fix: 'Run the build that produces it, or correct the path in the manifest.',\n  },\n  CRAFT_DEPLOY_NODE_BUILTIN_IMPORT: {\n    code: 'CRAFT_DEPLOY_NODE_BUILTIN_IMPORT',\n    title: 'A Node built-in is imported by a Worker or Lambda entry',\n    cause:\n      'The module graph reachable from the entry imports a Node built-in such as `node:fs` or `node:http`, which a Worker runtime does not provide.',\n    fix: 'Replace the built-in with a Web API, or move the code behind a platform adapter that the Worker entry does not import.',\n  },\n  CRAFT_DEPLOY_HEALTH_PATH_MISSING: {\n    code: 'CRAFT_DEPLOY_HEALTH_PATH_MISSING',\n    title: 'The health route is not served by the SSR entry',\n    cause:\n      'The path declared as `server.healthPath` was not found in the module graph of the SSR entry.',\n    fix: 'Serve the declared path, or align the manifest with the path the server exposes.',\n  },\n  CRAFT_DEPLOY_READY_PATH_MISSING: {\n    code: 'CRAFT_DEPLOY_READY_PATH_MISSING',\n    title: 'The readiness route is not served by the SSR entry',\n    cause:\n      'The path declared as `server.readyPath` was not found in the module graph of the SSR entry.',\n    fix: 'Serve the declared path, or align the manifest with the path the server exposes.',\n  },\n  CRAFT_DEPLOY_SSG_ROUTES_MISSING: {\n    code: 'CRAFT_DEPLOY_SSG_ROUTES_MISSING',\n    title: 'The SSG mode declares no route',\n    cause:\n      'A `ssg` deployment pre-renders one HTML file per route and the route list is empty.',\n    fix: 'List the routes in `static.routes`, or switch the mode to `spa`.',\n  },\n  CRAFT_DEPLOY_SSG_ROUTE_NOT_STATIC: {\n    code: 'CRAFT_DEPLOY_SSG_ROUTE_NOT_STATIC',\n    title: 'An SSG route cannot be pre-rendered',\n    cause:\n      'The route is not an absolute literal path: it carries a `:param`, a wildcard or a query string, so no single HTML file represents it.',\n    fix: 'Expand the route into its literal paths, or declare it in `static.serverRoutes`.',\n  },\n  CRAFT_DEPLOY_SPA_FALLBACK_MISSING: {\n    code: 'CRAFT_DEPLOY_SPA_FALLBACK_MISSING',\n    title: 'The SPA fallback document is missing from the client output',\n    cause:\n      'A `spa` deployment answers unknown paths with the fallback document, which is absent from the built output.',\n    fix: 'Build the client, or correct `static.fallback`.',\n  },\n  CRAFT_DEPLOY_ENV_NAME_INVALID: {\n    code: 'CRAFT_DEPLOY_ENV_NAME_INVALID',\n    title: 'Invalid environment variable name',\n    cause:\n      'A declared name is not an upper snake case identifier, which several platforms reject.',\n    fix: 'Rename the variable to `UPPER_SNAKE_CASE`.',\n  },\n  CRAFT_DEPLOY_ENV_VALUE_FORBIDDEN: {\n    code: 'CRAFT_DEPLOY_ENV_VALUE_FORBIDDEN',\n    title: 'An environment variable carries a value',\n    cause:\n      'The manifest is committed and read by every provider, so it declares names and requirements only.',\n    fix: 'Remove the value and provide it through the CI or the provider secret store.',\n  },\n  CRAFT_DEPLOY_ENV_UNDECLARED: {\n    code: 'CRAFT_DEPLOY_ENV_UNDECLARED',\n    title: 'An environment variable is read but not declared',\n    cause:\n      'The module graph of the runtime entry reads a variable the manifest does not list, so no provider can know it must be set.',\n    fix: 'Declare the variable in `env`, or stop reading it from the runtime entry.',\n  },\n  CRAFT_DEPLOY_FUNCTION_ID_DUPLICATE: {\n    code: 'CRAFT_DEPLOY_FUNCTION_ID_DUPLICATE',\n    title: 'A server-function identifier is declared twice',\n    cause:\n      'The identifier is the routing key of the protocol, so a duplicate makes the exposed contract ambiguous.',\n    fix: 'Keep one declaration per identifier.',\n  },\n  CRAFT_DEPLOY_FUNCTION_ID_UNKNOWN: {\n    code: 'CRAFT_DEPLOY_FUNCTION_ID_UNKNOWN',\n    title: 'A declared server-function identifier is not in the registry entry',\n    cause:\n      'The identifier does not appear in the module graph of `functions.entry`.',\n    fix: 'Register the function in the entry, or remove the identifier from the manifest.',\n  },\n  CRAFT_DEPLOY_ARTIFACT_MISSING: {\n    code: 'CRAFT_DEPLOY_ARTIFACT_MISSING',\n    title: 'The artefact directory does not exist',\n    cause: 'The directory the provider would publish has not been produced.',\n    fix: 'Run the declared build command before checking the artefact.',\n  },\n  CRAFT_DEPLOY_ARTIFACT_NO_ENTRY: {\n    code: 'CRAFT_DEPLOY_ARTIFACT_NO_ENTRY',\n    title: 'The artefact has no browser entry point',\n    cause: 'The public directory contains no `index.html`.',\n    fix: 'Check the build output directory declared in `client.outDir`.',\n  },\n  CRAFT_DEPLOY_ARTIFACT_NO_JAVASCRIPT: {\n    code: 'CRAFT_DEPLOY_ARTIFACT_NO_JAVASCRIPT',\n    title: 'The artefact contains no JavaScript',\n    cause:\n      'The public directory has no `.js` or `.mjs` file, which means the build produced nothing executable.',\n    fix: 'Check the build command and its output directory.',\n  },\n  CRAFT_DEPLOY_ARTIFACT_SOURCE_MAP: {\n    code: 'CRAFT_DEPLOY_ARTIFACT_SOURCE_MAP',\n    title: 'The artefact ships source maps',\n    cause:\n      'The source map policy is `forbidden` and the public directory contains `.map` files.',\n    fix: 'Disable source maps in the production build, or relax `artifact.sourceMaps`.',\n  },\n  CRAFT_DEPLOY_SSG_ROUTE_NOT_RENDERED: {\n    code: 'CRAFT_DEPLOY_SSG_ROUTE_NOT_RENDERED',\n    title: 'A declared SSG route has no pre-rendered document',\n    cause:\n      'The artefact contains neither `<route>.html` nor `<route>/index.html` for a route listed in `static.routes`.',\n    fix: 'Run the pre-render step for that route, or remove it from `static.routes`.',\n  },\n});\n"]}

package/src/lib/format.d.ts

@@ -0,0 +1,17 @@
+import type { CraftDeploymentDiagnostic } from './diagnostics.js';
+import type { CraftDeploymentPlan } from './providers.js';
+/**
+ * Renders a diagnostic on one line, followed by the correction.
+ *
+ * The location comes first so an editor or a CI log parser finds the file, and
+ * the fix is never dropped: a code without a correction is what makes a check
+ * get disabled instead of satisfied.
+ */
+export declare function formatCraftDeploymentDiagnostic(diagnostic: CraftDeploymentDiagnostic): string;
+/**
+ * Renders a plan as the approval surface it is: one line per resource, the
+ * action first so a `delete` cannot be skimmed past, then the facts that
+ * justify it.
+ */
+export declare function formatCraftDeploymentPlan(plan: CraftDeploymentPlan): string;
+//# sourceMappingURL=format.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../../../../libs/deploy/src/lib/format.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAC;AAClE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAE1D;;;;;;GAMG;AACH,wBAAgB,+BAA+B,CAC7C,UAAU,EAAE,yBAAyB,GACpC,MAAM,CAgBR;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,mBAAmB,GAAG,MAAM,CAmB3E"}

package/src/lib/format.js

@@ -0,0 +1,42 @@
+/**
+ * Renders a diagnostic on one line, followed by the correction.
+ *
+ * The location comes first so an editor or a CI log parser finds the file, and
+ * the fix is never dropped: a code without a correction is what makes a check
+ * get disabled instead of satisfied.
+ */
+export function formatCraftDeploymentDiagnostic(diagnostic) {
+    const location = diagnostic.file
+        ? `${diagnostic.file}${diagnostic.line ? `:${diagnostic.line}` : ''}`
+        : (diagnostic.path ?? 'craft.deploy');
+    const target = [
+        diagnostic.runtime && `runtime ${diagnostic.runtime}`,
+        diagnostic.platform && `platform ${diagnostic.platform}`,
+        diagnostic.provider && `provider ${diagnostic.provider}`,
+    ]
+        .filter((part) => typeof part === 'string')
+        .join(', ');
+    const header = `${diagnostic.severity} ${location} ${diagnostic.code}${target ? ` (${target})` : ''}: ${diagnostic.message}`;
+    return `${header}\n  fix: ${diagnostic.fix}`;
+}
+/**
+ * Renders a plan as the approval surface it is: one line per resource, the
+ * action first so a `delete` cannot be skimmed past, then the facts that
+ * justify it.
+ */
+export function formatCraftDeploymentPlan(plan) {
+    const lines = [
+        `plan: ${plan.provider} → stage ${plan.stage} (${plan.resources.length} resource(s))`,
+    ];
+    for (const resource of plan.resources) {
+        lines.push(`  ${resource.action.padEnd(9)} ${resource.type} ${resource.name}`);
+        for (const [key, value] of Object.entries(resource.details)) {
+            lines.push(`    ${key}: ${value}`);
+        }
+    }
+    for (const note of plan.notes) {
+        lines.push(`  note: ${note}`);
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=format.js.map

package/src/lib/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../../../../../libs/deploy/src/lib/format.ts"],"names":[],"mappings":"AAGA;;;;;;GAMG;AACH,MAAM,UAAU,+BAA+B,CAC7C,UAAqC;IAErC,MAAM,QAAQ,GAAG,UAAU,CAAC,IAAI;QAC9B,CAAC,CAAC,GAAG,UAAU,CAAC,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE;QACrE,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,IAAI,cAAc,CAAC,CAAC;IACxC,MAAM,MAAM,GAAG;QACb,UAAU,CAAC,OAAO,IAAI,WAAW,UAAU,CAAC,OAAO,EAAE;QACrD,UAAU,CAAC,QAAQ,IAAI,YAAY,UAAU,CAAC,QAAQ,EAAE;QACxD,UAAU,CAAC,QAAQ,IAAI,YAAY,UAAU,CAAC,QAAQ,EAAE;KACzD;SACE,MAAM,CAAC,CAAC,IAAI,EAAkB,EAAE,CAAC,OAAO,IAAI,KAAK,QAAQ,CAAC;SAC1D,IAAI,CAAC,IAAI,CAAC,CAAC;IAEd,MAAM,MAAM,GAAG,GAAG,UAAU,CAAC,QAAQ,IAAI,QAAQ,IAAI,UAAU,CAAC,IAAI,GAClE,MAAM,CAAC,CAAC,CAAC,KAAK,MAAM,GAAG,CAAC,CAAC,CAAC,EAC5B,KAAK,UAAU,CAAC,OAAO,EAAE,CAAC;IAC1B,OAAO,GAAG,MAAM,YAAY,UAAU,CAAC,GAAG,EAAE,CAAC;AAC/C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,yBAAyB,CAAC,IAAyB;IACjE,MAAM,KAAK,GAAG;QACZ,SAAS,IAAI,CAAC,QAAQ,YAAY,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC,SAAS,CAAC,MAAM,eAAe;KACtF,CAAC;IAEF,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;QACtC,KAAK,CAAC,IAAI,CACR,KAAK,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC,IAAI,IAAI,QAAQ,CAAC,IAAI,EAAE,CACnE,CAAC;QACF,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;YAC5D,KAAK,CAAC,IAAI,CAAC,OAAO,GAAG,KAAK,KAAK,EAAE,CAAC,CAAC;QACrC,CAAC;IACH,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QAC9B,KAAK,CAAC,IAAI,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC;IAChC,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC","sourcesContent":["import type { CraftDeploymentDiagnostic } from './diagnostics.js';\nimport type { CraftDeploymentPlan } from './providers.js';\n\n/**\n * Renders a diagnostic on one line, followed by the correction.\n *\n * The location comes first so an editor or a CI log parser finds the file, and\n * the fix is never dropped: a code without a correction is what makes a check\n * get disabled instead of satisfied.\n */\nexport function formatCraftDeploymentDiagnostic(\n  diagnostic: CraftDeploymentDiagnostic,\n): string {\n  const location = diagnostic.file\n    ? `${diagnostic.file}${diagnostic.line ? `:${diagnostic.line}` : ''}`\n    : (diagnostic.path ?? 'craft.deploy');\n  const target = [\n    diagnostic.runtime && `runtime ${diagnostic.runtime}`,\n    diagnostic.platform && `platform ${diagnostic.platform}`,\n    diagnostic.provider && `provider ${diagnostic.provider}`,\n  ]\n    .filter((part): part is string => typeof part === 'string')\n    .join(', ');\n\n  const header = `${diagnostic.severity} ${location} ${diagnostic.code}${\n    target ? ` (${target})` : ''\n  }: ${diagnostic.message}`;\n  return `${header}\\n  fix: ${diagnostic.fix}`;\n}\n\n/**\n * Renders a plan as the approval surface it is: one line per resource, the\n * action first so a `delete` cannot be skimmed past, then the facts that\n * justify it.\n */\nexport function formatCraftDeploymentPlan(plan: CraftDeploymentPlan): string {\n  const lines = [\n    `plan: ${plan.provider} → stage ${plan.stage} (${plan.resources.length} resource(s))`,\n  ];\n\n  for (const resource of plan.resources) {\n    lines.push(\n      `  ${resource.action.padEnd(9)} ${resource.type} ${resource.name}`,\n    );\n    for (const [key, value] of Object.entries(resource.details)) {\n      lines.push(`    ${key}: ${value}`);\n    }\n  }\n\n  for (const note of plan.notes) {\n    lines.push(`  note: ${note}`);\n  }\n\n  return lines.join('\\n');\n}\n"]}