@warlock.js/core 5.31.0 → 5.33.0

package/esm/errors/error-codes.d.mts

@@ -34,27 +34,35 @@
  * it imports nothing.
  */
 /** The area a code belongs to, matching its first digit. */
-type ErrorCodeArea = "config" | "boot" | "routing" | "validation" | "http" | "database" | "cli" | "environment" | "convention";
+export type ErrorCodeArea = "config" | "boot" | "routing" | "validation" | "http" | "database" | "cli" | "environment" | "convention";
 /**
  * Who has to act: `code` problems are fixed in the project's source or config,
  * `environment` problems on the machine running it.
  */
-type ErrorCodeCategory = "code" | "environment";
+export type ErrorCodeCategory = "code" | "environment";
 /** One registry entry. */
-type ErrorCodeDefinition = {
-  /** The stable code, e.g. `"WL3001"`. */readonly code: string; /** The area, matching the first digit. */
-  readonly area: ErrorCodeArea; /** Whether the project or the machine has to change. */
-  readonly category: ErrorCodeCategory; /** One-line name of the problem. */
-  readonly title: string; /** One-line "what to do". */
-  readonly fix: string; /** Slug of the skill that explains the fix (`packages/<pkg>/skills/<slug>/SKILL.md`). */
-  readonly skill: string; /** Names of the error classes that carry this code, when an error class does. */
-  readonly errorNames?: readonly string[]; /** Set when the code is no longer emitted. Retired codes are never reused. */
+export type ErrorCodeDefinition = {
+  /** The stable code, e.g. `"WL3001"`. */
+  readonly code: string;
+  /** The area, matching the first digit. */
+  readonly area: ErrorCodeArea;
+  /** Whether the project or the machine has to change. */
+  readonly category: ErrorCodeCategory;
+  /** One-line name of the problem. */
+  readonly title: string;
+  /** One-line "what to do". */
+  readonly fix: string;
+  /** Slug of the skill that explains the fix (`packages/<pkg>/skills/<slug>/SKILL.md`). */
+  readonly skill: string;
+  /** Names of the error classes that carry this code, when an error class does. */
+  readonly errorNames?: readonly string[];
+  /** Set when the code is no longer emitted. Retired codes are never reused. */
   readonly retired?: true;
 };
 /** Base URL of the error-code reference; each code is an anchor on that page. */
-declare const ERROR_CODES_DOCS_URL = "https://warlock.js.org/v/latest/core/cli/error-codes/";
+export declare const ERROR_CODES_DOCS_URL = "https://warlock.js.org/v/latest/core/cli/error-codes/";
 /** The registry, keyed by code. */
-declare const ERROR_CODES: {
+export declare const ERROR_CODES: {
   readonly WL1001: {
     readonly code: "WL1001";
     readonly area: "config";
@@ -76,7 +84,7 @@ declare const ERROR_CODES: {
     readonly area: "config";
     readonly category: "code";
     readonly title: "The rate-limit store cannot use the configured cache driver";
-    readonly fix: "Use a redis, pg or memory cache driver for http.rateLimit store \"cache\", or set store: \"memory\".";
+    readonly fix: 'Use a redis, pg or memory cache driver for http.rateLimit store "cache", or set store: "memory".';
     readonly skill: "configure-app";
     readonly errorNames: readonly ["UnsupportedRateLimitDriverError"];
   };
@@ -181,7 +189,7 @@ declare const ERROR_CODES: {
     readonly area: "boot";
     readonly category: "code";
     readonly title: "Storage was used before the storage connector ran";
-    readonly fix: "Add src/config/storage.ts; in a custom command add \"storage\" to preload.connectors.";
+    readonly fix: 'Add src/config/storage.ts; in a custom command add "storage" to preload.connectors.';
     readonly skill: "store-file";
     readonly errorNames: readonly ["StorageNotInitializedError"];
   };
@@ -198,7 +206,7 @@ declare const ERROR_CODES: {
     readonly area: "routing";
     readonly category: "code";
     readonly title: "A route name is already taken";
-    readonly fix: "Rename one of the two routes with the \"name\" route option; pages and API routes share one namespace.";
+    readonly fix: 'Rename one of the two routes with the "name" route option; pages and API routes share one namespace.';
     readonly skill: "register-route";
     readonly errorNames: readonly ["RouteNameTakenError"];
   };
@@ -534,7 +542,7 @@ declare const ERROR_CODES: {
     readonly area: "convention";
     readonly category: "code";
     readonly title: "tsconfig.json enables legacy experimentalDecorators";
-    readonly fix: "Remove \"experimentalDecorators\": true from tsconfig.json; Cascade uses standard decorators.";
+    readonly fix: 'Remove "experimentalDecorators": true from tsconfig.json; Cascade uses standard decorators.';
     readonly skill: "lower-stage3-decorators";
   };
   readonly WL9005: {
@@ -627,16 +635,16 @@ declare const ERROR_CODES: {
   };
 };
 /** Every registered code, as a union. */
-type WarlockErrorCode = keyof typeof ERROR_CODES;
+export type WarlockErrorCode = keyof typeof ERROR_CODES;
 /** Whether `value` is a registered code. */
-declare function isWarlockErrorCode(value: unknown): value is WarlockErrorCode;
+export declare function isWarlockErrorCode(value: unknown): value is WarlockErrorCode;
 /**
  * The registry entry for a code, or `undefined` for an unknown one. Case and
  * surrounding whitespace are ignored, so `explainErrorCode(" wl3001 ")` works.
  */
-declare function explainErrorCode(code: string): ErrorCodeDefinition | undefined;
+export declare function explainErrorCode(code: string): ErrorCodeDefinition | undefined;
 /** The docs URL of a code: the reference page with the code as its anchor. */
-declare function errorCodeDocsUrl(code: WarlockErrorCode): string;
+export declare function errorCodeDocsUrl(code: WarlockErrorCode): string;
 /**
  * The Warlock code of a thrown value, or `undefined` when it has none.
  *
@@ -647,7 +655,6 @@ declare function errorCodeDocsUrl(code: WarlockErrorCode): string;
  * by name rather than `instanceof` keeps the answer right when two copies of
  * core are loaded.
  */
-declare function errorCodeOf(error: unknown): WarlockErrorCode | undefined;
+export declare function errorCodeOf(error: unknown): WarlockErrorCode | undefined;
 //#endregion
-export { ERROR_CODES, ERROR_CODES_DOCS_URL, ErrorCodeArea, ErrorCodeCategory, ErrorCodeDefinition, WarlockErrorCode, errorCodeDocsUrl, errorCodeOf, explainErrorCode, isWarlockErrorCode };
 //# sourceMappingURL=error-codes.d.mts.map

package/esm/errors/error-codes.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"error-codes.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/errors/error-codes.ts"],"mappings":";;AAoCA;;;;AAAyB;AAezB;;;;AAA6B;AAG7B;;;;;;;;;;;;;;;AAgBkB;AAIlB;;;;AAAiC;AAGjC;;;KAzCY,aAAA;;;;;KAeA,iBAAA;;KAGA,mBAAA;mDAED,IAAA;WAEA,IAAA,EAAM,aAAA;WAEN,QAAA,EAAU,iBAAiB;WAE3B,KAAA;WAEA,GAAA;WAEA,KAAA;WAEA,UAAA;WAEA,OAAA;AAAA;;cAIE,oBAAA;;cAGA,WAAA;EAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KA+kBD,gBAAA,gBAAgC,WAAW;;iBAGvC,kBAAA,CAAmB,KAAA,YAAiB,KAAA,IAAS,gBAAgB;;;;;iBAQ7D,gBAAA,CAAiB,IAAA,WAAe,mBAAmB;;iBAOnD,gBAAA,CAAiB,IAAsB,EAAhB,gBAAgB;;;;;;;;;;;iBA8BvC,WAAA,CAAY,KAAA,YAAiB,gBAAgB"}
+{"version":3,"file":"error-codes.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/errors/error-codes.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;YAoCY;;;;;YAeA;;YAGA;;WAED;;WAEA,MAAM;;WAEN,UAAU;;WAEV;;WAEA;;WAEA;;WAEA;;WAEA;;;qBAIE;;qBAGA;;aAGT;aACA;aACA;aACA;aACA;aACA;;;aAGA;aACA;aACA;aACA;aACA;aACA;;;aAGA;aACA;aACA;aACA;aACA;aACA;aACA;;;aAGA;aACA;aACA;aACA;aACA;aACA;aACA;;;aAGA;aACA;aACA;aACA;aACA;aACA;aACA;;;aAGA;aACA;aACA;aACA;aACA;aACA;aACA;;;aAGA;aACA;aACA;aACA;aACA;aACA;aACA;;;aAGA;aACA;aACA;aACA;aACA;aACA;aACA;;;aAGA;aACA;aACA;aACA;aACA;aACA;;;aAKA;aACA;aACA;aACA;aACA;aACA;aACA;;;aAGA;aACA;aACA;aACA;aACA;aACA;;;aAGA;aACA;aACA;aACA;aACA;aACA;;;aAGA;aACA;aACA;aACA;aACA;aACA;aACA;;;aAGA;aACA;aACA;aACA;aACA;aACA;aACA;;;aAGA;aACA;aACA;aACA;aACA;aACA;aACA;;;aAGA;aACA;aACA;aACA;aACA;aACA;;;aAKA;aACA;aACA;aACA;aACA;aACA;aACA;;;aAGA;aACA;aACA;aACA;aACA;aACA;;;aAGA;aACA;aACA;aACA;aACA;aACA;;;aAGA;aACA;aACA;aACA;aACA;aACA;;;aAGA;aACA;aACA;aACA;aACA;aACA;;;aAGA;aACA;aACA;aACA;aACA;aACA;;;aAKA;aACA;aACA;aACA;aACA;aACA;;;aAKA;aACA;aACA;aACA;aACA;aACA;aACA;;;aAGA;aACA;aACA;aACA;aACA;aACA;;;aAGA;aACA;aACA;aACA;aACA;aACA;;;aAGA;aACA;aACA;aACA;aACA;aACA;;;aAKA;aACA;aACA;aACA;aACA;aACA;aACA;;;aAGA;aACA;aACA;aACA;aACA;aACA;aACA;;;aAKA;aACA;aACA;aACA;aACA;aACA;aACA;;;aAGA;aACA;aACA;aACA;aACA;aACA;aACA;;;aAGA;aACA;aACA;aACA;aACA;aACA;;;aAGA;aACA;aACA;aACA;aACA;aACA;;;aAGA;aACA;aACA;aACA;aACA;aACA;;;aAGA;aACA;aACA;aACA;aACA;aACA;;;aAGA;aACA;aACA;aACA;aACA;aACA;;;aAGA;aACA;aACA;aACA;aACA;aACA;;;aAGA;aACA;aACA;aACA;aACA;aACA;;;aAGA;aACA;aACA;aACA;aACA;aACA;;;aAGA;aACA;aACA;aACA;aACA;aACA;;;aAGA;aACA;aACA;aACA;aACA;aACA;;;aAGA;aACA;aACA;aACA;aACA;aACA;;;aAGA;aACA;aACA;aACA;aACA;aACA;;;aAGA;aACA;aACA;aACA;aACA;aACA;;;aAGA;aACA;aACA;aACA;aACA;aACA;;;aAKA;aACA;aACA;aACA;aACA;aACA;;;aAGA;aACA;aACA;aACA;aACA;aACA;;;aAGA;aACA;aACA;aACA;aACA;aACA;;;aAGA;aACA;aACA;aACA;aACA;aACA;aACA;;;aAGA;aACA;aACA;aACA;aACA;aACA;aACA;;;aAGA;aACA;aACA;aACA;aACA;aACA;;;aAGA;aACA;aACA;aACA;aACA;aACA;;;aAGA;aACA;aACA;aACA;aACA;aACA;;;aAGA;aACA;aACA;aACA;aACA;aACA;;;aAKA;aACA;aACA;aACA;aACA;aACA;;;aAGA;aACA;aACA;aACA;aACA;aACA;;;aAGA;aACA;aACA;aACA;aACA;aACA;;;aAGA;aACA;aACA;aACA;aACA;aACA;;;aAGA;aACA;aACA;aACA;aACA;aACA;;;aAGA;aACA;aACA;aACA;aACA;aACA;;;aAGA;aACA;aACA;aACA;aACA;aACA;;;aAGA;aACA;aACA;aACA;aACA;aACA;;;aAGA;aACA;aACA;aACA;aACA;aACA;;;aAGA;aACA;aACA;aACA;aACA;aACA;;;aAGA;aACA;aACA;aACA;aACA;aACA;;;aAGA;aACA;aACA;aACA;aACA;aACA;;;aAGA;aACA;aACA;aACA;aACA;aACA;;;aAGA;aACA;aACA;aACA;aACA;aACA;;;aAGA;aACA;aACA;aACA;aACA;aACA;;;;YAKQ,gCAAgC;;wBAG5B,mBAAmB,iBAAiB,SAAS;;;;;wBAQ7C,iBAAiB,eAAe;;wBAOhC,iBAAiB,MAAM;;;;;;;;;;;wBA8BvB,YAAY,iBAAiB"}

package/esm/errors/warlock-error.d.mts

@@ -1,5 +1,4 @@
 import { WarlockErrorCode } from "./error-codes.mjs";
-
 //#region ../../packages/core/src/errors/warlock-error.d.ts
 /**
  * A framework error with a stable {@link WarlockErrorCode}.
@@ -11,7 +10,7 @@ import { WarlockErrorCode } from "./error-codes.mjs";
  * @example
  * throw new WarlockError("WL3003", `Route name "${name}" not found`);
  */
-declare class WarlockError extends Error {
+export declare class WarlockError extends Error {
   /** Stable Warlock error code; `warlock explain <code>` prints the fix. */
   readonly code: WarlockErrorCode;
   constructor(code: WarlockErrorCode, message: string, options?: {
@@ -19,5 +18,4 @@ declare class WarlockError extends Error {
   });
 }
 //#endregion
-export { WarlockError };
 //# sourceMappingURL=warlock-error.d.mts.map

package/esm/errors/warlock-error.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"warlock-error.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/errors/warlock-error.ts"],"mappings":";;;;;AAYA;;;;;;;;cAAa,YAAA,SAAqB,KAAA;EAEhB;EAAA,SAAA,IAAA,EAAM,gBAAA;cAEH,IAAA,EAAM,gBAAA,EAAkB,OAAA,UAAiB,OAAA;IAAY,KAAA;EAAA;AAAA"}
+{"version":3,"file":"warlock-error.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/errors/warlock-error.ts"],"mappings":";;;;;;;;;;;;qBAYa,qBAAqB;;WAEhB,MAAM;EAEtB,YAAmB,MAAM,kBAAkB,iBAAiB;IAAY"}

package/esm/generations/add-command.action.mjs

@@ -138,7 +138,8 @@ async function approvePnpmSharpBuild() {
 	const layout = pnpmBuildApprovalLayout(getPnpmVersion(rootPath()));
 	if (layout === "packageJson") {
 		const packageJsonPath = rootPath("package.json");
-		await putJsonFileAsync(packageJsonPath, mergePackageJsonBuildApprovals(await getJsonFileAsync(packageJsonPath), ["sharp"]));
+		const packageJson = await getJsonFileAsync(packageJsonPath);
+		await putJsonFileAsync(packageJsonPath, mergePackageJsonBuildApprovals(packageJson, ["sharp"]));
 		return;
 	}
 	const current = hasWorkspaceFile ? await getFileAsync(workspacePath) : "";
@@ -207,5 +208,5 @@ function validateFeatures(features) {
 }
 
 //#endregion
-export { addCommandAction };
+export { addCommandAction, allowedFeatures, featuresMap, installDependencies, resolveWarlockDependencyVersions };
 //# sourceMappingURL=add-command.action.mjs.map

package/esm/generations/add-command.action.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"add-command.action.mjs","names":[],"sources":["../../../../../../../../packages/core/src/generations/add-command.action.ts"],"sourcesContent":["import { colors } from \"@mongez/copper\";\nimport {\n  fileExistsAsync,\n  getFileAsync,\n  getJsonFileAsync,\n  putFileAsync,\n  putJsonFileAsync,\n  recordSkippedFile,\n} from \"./generation-fs\";\nimport { isGenerationDryRun, setGenerationDetail } from \"./generation-run\";\nimport { execSync } from \"node:child_process\";\nimport type { CommandActionData } from \"../commands/types\";\nimport {\n  detectPackageManager,\n  getAddCommand,\n  getExactAddCommand,\n  type PackageManager,\n} from \"../updater/package-manager\";\nimport { rootPath, srcPath } from \"../utils\";\nimport { getWarlockVersion } from \"../utils/framework-vesion\";\nimport { featuresMap } from \"./features\";\nimport {\n  getPnpmVersion,\n  isInsideParentPnpmWorkspace,\n  mergeOnlyBuiltDependencies,\n  mergePackageJsonBuildApprovals,\n  mergePnpmSharpApproval,\n  pnpmBuildApprovalLayout,\n} from \"./pnpm-build-approvals\";\n\nexport { featuresMap };\nexport type { FeatureDefinition } from \"./features\";\n\n/**\n * The parts of a project `package.json` this action reads or writes. Deliberately\n * partial — it describes what we touch, not the whole manifest.\n */\ntype ProjectPackageJson = {\n  dependencies?: Record<string, string>;\n  devDependencies?: Record<string, string>;\n  scripts?: Record<string, string>;\n};\n\nexport const allowedFeatures = Object.keys(featuresMap);\n\nfunction isWarlockPackage(packageName: string): boolean {\n  return packageName.startsWith(\"@warlock.js/\");\n}\n\n/**\n * Resolve the internal feature-map placeholder to the version of Core that is\n * actually executing the command. Every @warlock.js package is lockstep, so\n * Core is the single source of truth; non-Warlock dependencies are untouched.\n */\nexport function resolveWarlockDependencyVersions(\n  dependencies: Record<string, string>,\n  frameworkVersion: string,\n): void {\n  for (const dependency of Object.keys(dependencies)) {\n    if (isWarlockPackage(dependency)) {\n      dependencies[dependency] = frameworkVersion;\n    }\n  }\n}\n\nfunction resolveFeatures(features: string[], visited = new Set<string>()): string[] {\n  const resolved: string[] = [];\n\n  for (const feature of features) {\n    if (visited.has(feature)) continue;\n    visited.add(feature);\n\n    const def = featuresMap[feature];\n\n    // `addCommandAction` runs `validateFeatures()` before calling this, and the\n    // recursive calls below pass `requires` entries that come out of the map\n    // itself — so every lookup resolves. Skipping an unresolvable one keeps a\n    // typo from crashing the command with `Cannot read properties of\n    // undefined`, which names neither the feature nor the fact that it was the\n    // ARGUMENT that was wrong.\n    if (def === undefined) continue;\n\n    if (def.requires?.length) {\n      resolved.push(...resolveFeatures(def.requires, visited));\n    }\n\n    resolved.push(feature);\n  }\n\n  return resolved;\n}\n\nexport async function addCommandAction(options: CommandActionData) {\n  const features = options.args;\n  const { packageManager, list, noInstall } = options.options;\n\n  if (list) {\n    setGenerationDetail(\n      \"features\",\n      allowedFeatures.map((feature) => ({\n        name: feature,\n        description: featuresMap[feature]?.description ?? \"\",\n      })),\n    );\n\n    console.log(\"Available Features:\");\n\n    for (const feature of allowedFeatures) {\n      const definition = featuresMap[feature];\n\n      // `allowedFeatures` is derived from this same map, so this resolves.\n      if (definition === undefined) continue;\n\n      console.log(`- ${colors.yellowBright(feature)}: ${colors.green(definition.description)}`);\n    }\n\n    process.exit(0);\n  }\n\n  validateFeatures(features);\n\n  const resolvedFeatures = resolveFeatures(features);\n\n  const dependencies: Record<string, string> = {};\n  const devDependencies: Record<string, string> = {};\n  const ejectConfigs: Record<string, { content: string; name: string }> = {};\n  const scripts: Record<string, string> = {};\n\n  for (const feature of resolvedFeatures) {\n    const featurePackages = featuresMap[feature as keyof typeof featuresMap];\n\n    // Validated upstream; see the note in resolveFeatures above.\n    if (featurePackages === undefined) continue;\n\n    Object.assign(dependencies, featurePackages.dependencies);\n    if (featurePackages.devDependencies) {\n      Object.assign(devDependencies, featurePackages.devDependencies);\n    }\n\n    if (featurePackages.ejectConfig) {\n      ejectConfigs[featurePackages.ejectConfig.name] = featurePackages.ejectConfig;\n    }\n\n    if (featurePackages.script) {\n      Object.assign(scripts, featurePackages.script);\n    }\n  }\n\n  // Pin every @warlock.js/* feature package to the INSTALLED framework version so\n  // a scaffolded project's features match its core version instead of drifting to\n  // the feature map's static range.\n  const frameworkVersion = await getWarlockVersion();\n  resolveWarlockDependencyVersions(dependencies, frameworkVersion);\n  resolveWarlockDependencyVersions(devDependencies, frameworkVersion);\n\n  const currentPackageJson = await getJsonFileAsync<ProjectPackageJson>(rootPath(\"package.json\"));\n\n  // Fresh templates may omit one of the maps — guard before reading.\n  currentPackageJson.dependencies = currentPackageJson.dependencies ?? {};\n  currentPackageJson.devDependencies = currentPackageJson.devDependencies ?? {};\n\n  // Skip anything already present so we never downgrade an existing pin.\n  for (const dependency of Object.keys(dependencies)) {\n    if (currentPackageJson.dependencies[dependency]) {\n      console.log(`${colors.yellowBright(dependency)} is already installed, skipping...`);\n      delete dependencies[dependency];\n    }\n  }\n\n  for (const devDependency of Object.keys(devDependencies)) {\n    if (currentPackageJson.devDependencies[devDependency]) {\n      console.log(`${colors.yellowBright(devDependency)} is already installed, skipping...`);\n      delete devDependencies[devDependency];\n    }\n  }\n\n  setGenerationDetail(\"features\", resolvedFeatures);\n  setGenerationDetail(\"dependencies\", { ...dependencies });\n  setGenerationDetail(\"devDependencies\", { ...devDependencies });\n\n  if (isGenerationDryRun()) {\n    // A preview installs nothing; package.json is \"edited\" in the overlay so\n    // the report lists it, and later steps read the previewed manifest.\n    console.log(\n      `Dry run: would install ${colors.magenta(Object.keys({ ...dependencies, ...devDependencies }).join(\", \") || \"nothing\")}`,\n    );\n    await recordDependencies(dependencies, devDependencies);\n  } else if (noInstall) {\n    await recordDependencies(dependencies, devDependencies);\n  } else {\n    const resolvedPackageManager =\n      (packageManager as PackageManager | undefined) ?? (await detectPackageManager());\n    if (resolvedPackageManager === \"pnpm\" && dependencies.sharp !== undefined) {\n      await approvePnpmSharpBuild();\n    }\n    await installDependencies(\n      packageManager as PackageManager | undefined,\n      dependencies,\n      devDependencies,\n    );\n  }\n\n  for (const [name, config] of Object.entries(ejectConfigs)) {\n    if (await fileExistsAsync(srcPath(`config/${name}.ts`))) {\n      recordSkippedFile(srcPath(`config/${name}.ts`), \"exists\");\n      console.log(`${colors.yellowBright(name)} config already exists, skipping...`);\n      continue;\n    }\n\n    console.log(`Creating ${colors.magenta(name)} config...`);\n\n    await putFileAsync(srcPath(`config/${name}.ts`), config.content);\n\n    console.log(`${colors.green(name)} config created successfully`);\n  }\n\n  // now loop again over features to execute onExecuting\n  for (const feature of resolvedFeatures) {\n    const featurePackages = featuresMap[feature as keyof typeof featuresMap];\n\n    if (featurePackages?.onExecuting) {\n      await featurePackages.onExecuting(options);\n    }\n  }\n\n  setGenerationDetail(\"scripts\", { ...scripts });\n\n  if (Object.keys(scripts).length > 0) {\n    console.log(`Adding scripts ${colors.magenta(Object.keys(scripts).join(\", \"))}`);\n    const packageJsonPath = rootPath(\"package.json\");\n    const packageJson = await getJsonFileAsync<ProjectPackageJson>(packageJsonPath);\n    packageJson.scripts = { ...(packageJson.scripts ?? {}), ...scripts };\n    await putJsonFileAsync(packageJsonPath, packageJson);\n\n    console.log(`Scripts added successfully ${colors.green(Object.keys(scripts).join(\", \"))}`);\n  }\n}\n\n/**\n * Let pnpm run sharp's install script, written where the INSTALLED pnpm reads\n * approvals (see `pnpmBuildApprovalLayout`). pnpm 9 and 10.0–10.4 reject a\n * settings-only `pnpm-workspace.yaml`, so for them the approval goes into\n * package.json and no workspace file is created.\n *\n * An app inside a parent pnpm workspace gets no per-app policy: the parent's\n * workspace owns it, and a nested workspace file would make a second root.\n */\nasync function approvePnpmSharpBuild(): Promise<void> {\n  const workspacePath = rootPath(\"pnpm-workspace.yaml\");\n  const hasWorkspaceFile = await fileExistsAsync(workspacePath);\n\n  if (!hasWorkspaceFile && isInsideParentPnpmWorkspace(rootPath())) {\n    console.log(\n      `${colors.yellowBright(\"sharp\")} needs its install script approved in the parent pnpm workspace's settings.`,\n    );\n    return;\n  }\n\n  const layout = pnpmBuildApprovalLayout(getPnpmVersion(rootPath()));\n\n  if (layout === \"packageJson\") {\n    const packageJsonPath = rootPath(\"package.json\");\n    const packageJson = await getJsonFileAsync<ProjectPackageJson>(packageJsonPath);\n\n    await putJsonFileAsync(packageJsonPath, mergePackageJsonBuildApprovals(packageJson, [\"sharp\"]));\n    return;\n  }\n\n  const current = hasWorkspaceFile ? await getFileAsync(workspacePath) : \"\";\n  const updated =\n    layout === \"onlyBuiltDependencies\"\n      ? mergeOnlyBuiltDependencies(current, [\"sharp\"])\n      : mergePnpmSharpApproval(current);\n\n  if (updated !== current) await putFileAsync(workspacePath, updated);\n}\n\n/**\n * Install the resolved dependency sets through the project's package manager.\n * Runs two passes (prod then dev) so each lands in the correct section.\n */\nexport async function installDependencies(\n  packageManager: PackageManager | undefined,\n  dependencies: Record<string, string>,\n  devDependencies: Record<string, string>,\n  exec: (command: string, options: { cwd: string; stdio: \"inherit\" }) => unknown = execSync,\n) {\n  // `--package-manager` is optional; without it, fall back to the lockfile.\n  const resolvedPackageManager = packageManager ?? (await detectPackageManager());\n  const packageManagerCommand = getAddCommand(resolvedPackageManager);\n  const exactPackageManagerCommand = getExactAddCommand(resolvedPackageManager);\n\n  const installDependencySet = (dependencySet: Record<string, string>, development: boolean) => {\n    const regularSpecs: string[] = [];\n    const exactWarlockSpecs: string[] = [];\n\n    for (const [name, version] of Object.entries(dependencySet)) {\n      const spec = `${name}@${version}`;\n      (isWarlockPackage(name) ? exactWarlockSpecs : regularSpecs).push(spec);\n    }\n\n    const developmentFlag = development ? \" -D\" : \"\";\n    const runInstall = (command: string, specs: string[]) => {\n      if (specs.length === 0) return;\n\n      exec(`${command} ${specs.join(\" \")}${developmentFlag}`, {\n        cwd: process.cwd(),\n        stdio: \"inherit\",\n      });\n    };\n\n    runInstall(packageManagerCommand, regularSpecs);\n    runInstall(exactPackageManagerCommand, exactWarlockSpecs);\n  };\n\n  if (Object.keys(dependencies).length > 0) {\n    console.log(`Installing dependencies ${colors.magenta(Object.keys(dependencies).join(\", \"))}`);\n\n    installDependencySet(dependencies, false);\n\n    console.log(\n      `Dependencies installed successfully ${colors.green(Object.keys(dependencies).join(\", \"))}`,\n    );\n  }\n\n  if (Object.keys(devDependencies).length > 0) {\n    console.log(\n      `Installing dev dependencies ${colors.magenta(Object.keys(devDependencies).join(\", \"))}`,\n    );\n\n    installDependencySet(devDependencies, true);\n\n    console.log(\n      `Dev dependencies installed successfully ${colors.green(Object.keys(devDependencies).join(\", \"))}`,\n    );\n  }\n}\n\n/**\n * Write the resolved dependency sets into package.json without installing.\n * Used by `--no-install` so a scaffolder can batch every feature into one\n * install pass after the command returns. Versions come from the feature map.\n */\nasync function recordDependencies(\n  dependencies: Record<string, string>,\n  devDependencies: Record<string, string>,\n) {\n  if (Object.keys(dependencies).length === 0 && Object.keys(devDependencies).length === 0) {\n    return;\n  }\n\n  const packageJsonPath = rootPath(\"package.json\");\n  const packageJson = await getJsonFileAsync<ProjectPackageJson>(packageJsonPath);\n\n  packageJson.dependencies = packageJson.dependencies ?? {};\n  packageJson.devDependencies = packageJson.devDependencies ?? {};\n\n  Object.assign(packageJson.dependencies, dependencies);\n  Object.assign(packageJson.devDependencies, devDependencies);\n\n  await putJsonFileAsync(packageJsonPath, packageJson);\n\n  const recorded = [...Object.keys(dependencies), ...Object.keys(devDependencies)];\n\n  console.log(\n    `Recorded ${colors.green(recorded.join(\", \"))} in package.json (${isGenerationDryRun() ? \"dry run: nothing installed\" : \"install skipped via --no-install\"})`,\n  );\n}\n\nfunction validateFeatures(features: string[]) {\n  for (const feature of features) {\n    if (!allowedFeatures.includes(feature)) {\n      console.log(\n        `Feature ${colors.redBright(feature)} is not allowed, allowed features are: ${colors.green(allowedFeatures.join(\", \"))}`,\n      );\n      process.exit(1);\n    }\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"add-command.action.mjs","names":[],"sources":["../../../../../../../../packages/core/src/generations/add-command.action.ts"],"sourcesContent":["import { colors } from \"@mongez/copper\";\nimport {\n  fileExistsAsync,\n  getFileAsync,\n  getJsonFileAsync,\n  putFileAsync,\n  putJsonFileAsync,\n  recordSkippedFile,\n} from \"./generation-fs\";\nimport { isGenerationDryRun, setGenerationDetail } from \"./generation-run\";\nimport { execSync } from \"node:child_process\";\nimport type { CommandActionData } from \"../commands/types\";\nimport {\n  detectPackageManager,\n  getAddCommand,\n  getExactAddCommand,\n  type PackageManager,\n} from \"../updater/package-manager\";\nimport { rootPath, srcPath } from \"../utils\";\nimport { getWarlockVersion } from \"../utils/framework-vesion\";\nimport { featuresMap } from \"./features\";\nimport {\n  getPnpmVersion,\n  isInsideParentPnpmWorkspace,\n  mergeOnlyBuiltDependencies,\n  mergePackageJsonBuildApprovals,\n  mergePnpmSharpApproval,\n  pnpmBuildApprovalLayout,\n} from \"./pnpm-build-approvals\";\n\nexport { featuresMap };\nexport type { FeatureDefinition } from \"./features\";\n\n/**\n * The parts of a project `package.json` this action reads or writes. Deliberately\n * partial — it describes what we touch, not the whole manifest.\n */\ntype ProjectPackageJson = {\n  dependencies?: Record<string, string>;\n  devDependencies?: Record<string, string>;\n  scripts?: Record<string, string>;\n};\n\nexport const allowedFeatures = Object.keys(featuresMap);\n\nfunction isWarlockPackage(packageName: string): boolean {\n  return packageName.startsWith(\"@warlock.js/\");\n}\n\n/**\n * Resolve the internal feature-map placeholder to the version of Core that is\n * actually executing the command. Every @warlock.js package is lockstep, so\n * Core is the single source of truth; non-Warlock dependencies are untouched.\n */\nexport function resolveWarlockDependencyVersions(\n  dependencies: Record<string, string>,\n  frameworkVersion: string,\n): void {\n  for (const dependency of Object.keys(dependencies)) {\n    if (isWarlockPackage(dependency)) {\n      dependencies[dependency] = frameworkVersion;\n    }\n  }\n}\n\nfunction resolveFeatures(features: string[], visited = new Set<string>()): string[] {\n  const resolved: string[] = [];\n\n  for (const feature of features) {\n    if (visited.has(feature)) continue;\n    visited.add(feature);\n\n    const def = featuresMap[feature];\n\n    // `addCommandAction` runs `validateFeatures()` before calling this, and the\n    // recursive calls below pass `requires` entries that come out of the map\n    // itself — so every lookup resolves. Skipping an unresolvable one keeps a\n    // typo from crashing the command with `Cannot read properties of\n    // undefined`, which names neither the feature nor the fact that it was the\n    // ARGUMENT that was wrong.\n    if (def === undefined) continue;\n\n    if (def.requires?.length) {\n      resolved.push(...resolveFeatures(def.requires, visited));\n    }\n\n    resolved.push(feature);\n  }\n\n  return resolved;\n}\n\nexport async function addCommandAction(options: CommandActionData) {\n  const features = options.args;\n  const { packageManager, list, noInstall } = options.options;\n\n  if (list) {\n    setGenerationDetail(\n      \"features\",\n      allowedFeatures.map((feature) => ({\n        name: feature,\n        description: featuresMap[feature]?.description ?? \"\",\n      })),\n    );\n\n    console.log(\"Available Features:\");\n\n    for (const feature of allowedFeatures) {\n      const definition = featuresMap[feature];\n\n      // `allowedFeatures` is derived from this same map, so this resolves.\n      if (definition === undefined) continue;\n\n      console.log(`- ${colors.yellowBright(feature)}: ${colors.green(definition.description)}`);\n    }\n\n    process.exit(0);\n  }\n\n  validateFeatures(features);\n\n  const resolvedFeatures = resolveFeatures(features);\n\n  const dependencies: Record<string, string> = {};\n  const devDependencies: Record<string, string> = {};\n  const ejectConfigs: Record<string, { content: string; name: string }> = {};\n  const scripts: Record<string, string> = {};\n\n  for (const feature of resolvedFeatures) {\n    const featurePackages = featuresMap[feature as keyof typeof featuresMap];\n\n    // Validated upstream; see the note in resolveFeatures above.\n    if (featurePackages === undefined) continue;\n\n    Object.assign(dependencies, featurePackages.dependencies);\n    if (featurePackages.devDependencies) {\n      Object.assign(devDependencies, featurePackages.devDependencies);\n    }\n\n    if (featurePackages.ejectConfig) {\n      ejectConfigs[featurePackages.ejectConfig.name] = featurePackages.ejectConfig;\n    }\n\n    if (featurePackages.script) {\n      Object.assign(scripts, featurePackages.script);\n    }\n  }\n\n  // Pin every @warlock.js/* feature package to the INSTALLED framework version so\n  // a scaffolded project's features match its core version instead of drifting to\n  // the feature map's static range.\n  const frameworkVersion = await getWarlockVersion();\n  resolveWarlockDependencyVersions(dependencies, frameworkVersion);\n  resolveWarlockDependencyVersions(devDependencies, frameworkVersion);\n\n  const currentPackageJson = await getJsonFileAsync<ProjectPackageJson>(rootPath(\"package.json\"));\n\n  // Fresh templates may omit one of the maps — guard before reading.\n  currentPackageJson.dependencies = currentPackageJson.dependencies ?? {};\n  currentPackageJson.devDependencies = currentPackageJson.devDependencies ?? {};\n\n  // Skip anything already present so we never downgrade an existing pin.\n  for (const dependency of Object.keys(dependencies)) {\n    if (currentPackageJson.dependencies[dependency]) {\n      console.log(`${colors.yellowBright(dependency)} is already installed, skipping...`);\n      delete dependencies[dependency];\n    }\n  }\n\n  for (const devDependency of Object.keys(devDependencies)) {\n    if (currentPackageJson.devDependencies[devDependency]) {\n      console.log(`${colors.yellowBright(devDependency)} is already installed, skipping...`);\n      delete devDependencies[devDependency];\n    }\n  }\n\n  setGenerationDetail(\"features\", resolvedFeatures);\n  setGenerationDetail(\"dependencies\", { ...dependencies });\n  setGenerationDetail(\"devDependencies\", { ...devDependencies });\n\n  if (isGenerationDryRun()) {\n    // A preview installs nothing; package.json is \"edited\" in the overlay so\n    // the report lists it, and later steps read the previewed manifest.\n    console.log(\n      `Dry run: would install ${colors.magenta(Object.keys({ ...dependencies, ...devDependencies }).join(\", \") || \"nothing\")}`,\n    );\n    await recordDependencies(dependencies, devDependencies);\n  } else if (noInstall) {\n    await recordDependencies(dependencies, devDependencies);\n  } else {\n    const resolvedPackageManager =\n      (packageManager as PackageManager | undefined) ?? (await detectPackageManager());\n    if (resolvedPackageManager === \"pnpm\" && dependencies.sharp !== undefined) {\n      await approvePnpmSharpBuild();\n    }\n    await installDependencies(\n      packageManager as PackageManager | undefined,\n      dependencies,\n      devDependencies,\n    );\n  }\n\n  for (const [name, config] of Object.entries(ejectConfigs)) {\n    if (await fileExistsAsync(srcPath(`config/${name}.ts`))) {\n      recordSkippedFile(srcPath(`config/${name}.ts`), \"exists\");\n      console.log(`${colors.yellowBright(name)} config already exists, skipping...`);\n      continue;\n    }\n\n    console.log(`Creating ${colors.magenta(name)} config...`);\n\n    await putFileAsync(srcPath(`config/${name}.ts`), config.content);\n\n    console.log(`${colors.green(name)} config created successfully`);\n  }\n\n  // now loop again over features to execute onExecuting\n  for (const feature of resolvedFeatures) {\n    const featurePackages = featuresMap[feature as keyof typeof featuresMap];\n\n    if (featurePackages?.onExecuting) {\n      await featurePackages.onExecuting(options);\n    }\n  }\n\n  setGenerationDetail(\"scripts\", { ...scripts });\n\n  if (Object.keys(scripts).length > 0) {\n    console.log(`Adding scripts ${colors.magenta(Object.keys(scripts).join(\", \"))}`);\n    const packageJsonPath = rootPath(\"package.json\");\n    const packageJson = await getJsonFileAsync<ProjectPackageJson>(packageJsonPath);\n    packageJson.scripts = { ...(packageJson.scripts ?? {}), ...scripts };\n    await putJsonFileAsync(packageJsonPath, packageJson);\n\n    console.log(`Scripts added successfully ${colors.green(Object.keys(scripts).join(\", \"))}`);\n  }\n}\n\n/**\n * Let pnpm run sharp's install script, written where the INSTALLED pnpm reads\n * approvals (see `pnpmBuildApprovalLayout`). pnpm 9 and 10.0–10.4 reject a\n * settings-only `pnpm-workspace.yaml`, so for them the approval goes into\n * package.json and no workspace file is created.\n *\n * An app inside a parent pnpm workspace gets no per-app policy: the parent's\n * workspace owns it, and a nested workspace file would make a second root.\n */\nasync function approvePnpmSharpBuild(): Promise<void> {\n  const workspacePath = rootPath(\"pnpm-workspace.yaml\");\n  const hasWorkspaceFile = await fileExistsAsync(workspacePath);\n\n  if (!hasWorkspaceFile && isInsideParentPnpmWorkspace(rootPath())) {\n    console.log(\n      `${colors.yellowBright(\"sharp\")} needs its install script approved in the parent pnpm workspace's settings.`,\n    );\n    return;\n  }\n\n  const layout = pnpmBuildApprovalLayout(getPnpmVersion(rootPath()));\n\n  if (layout === \"packageJson\") {\n    const packageJsonPath = rootPath(\"package.json\");\n    const packageJson = await getJsonFileAsync<ProjectPackageJson>(packageJsonPath);\n\n    await putJsonFileAsync(packageJsonPath, mergePackageJsonBuildApprovals(packageJson, [\"sharp\"]));\n    return;\n  }\n\n  const current = hasWorkspaceFile ? await getFileAsync(workspacePath) : \"\";\n  const updated =\n    layout === \"onlyBuiltDependencies\"\n      ? mergeOnlyBuiltDependencies(current, [\"sharp\"])\n      : mergePnpmSharpApproval(current);\n\n  if (updated !== current) await putFileAsync(workspacePath, updated);\n}\n\n/**\n * Install the resolved dependency sets through the project's package manager.\n * Runs two passes (prod then dev) so each lands in the correct section.\n */\nexport async function installDependencies(\n  packageManager: PackageManager | undefined,\n  dependencies: Record<string, string>,\n  devDependencies: Record<string, string>,\n  exec: (command: string, options: { cwd: string; stdio: \"inherit\" }) => unknown = execSync,\n) {\n  // `--package-manager` is optional; without it, fall back to the lockfile.\n  const resolvedPackageManager = packageManager ?? (await detectPackageManager());\n  const packageManagerCommand = getAddCommand(resolvedPackageManager);\n  const exactPackageManagerCommand = getExactAddCommand(resolvedPackageManager);\n\n  const installDependencySet = (dependencySet: Record<string, string>, development: boolean) => {\n    const regularSpecs: string[] = [];\n    const exactWarlockSpecs: string[] = [];\n\n    for (const [name, version] of Object.entries(dependencySet)) {\n      const spec = `${name}@${version}`;\n      (isWarlockPackage(name) ? exactWarlockSpecs : regularSpecs).push(spec);\n    }\n\n    const developmentFlag = development ? \" -D\" : \"\";\n    const runInstall = (command: string, specs: string[]) => {\n      if (specs.length === 0) return;\n\n      exec(`${command} ${specs.join(\" \")}${developmentFlag}`, {\n        cwd: process.cwd(),\n        stdio: \"inherit\",\n      });\n    };\n\n    runInstall(packageManagerCommand, regularSpecs);\n    runInstall(exactPackageManagerCommand, exactWarlockSpecs);\n  };\n\n  if (Object.keys(dependencies).length > 0) {\n    console.log(`Installing dependencies ${colors.magenta(Object.keys(dependencies).join(\", \"))}`);\n\n    installDependencySet(dependencies, false);\n\n    console.log(\n      `Dependencies installed successfully ${colors.green(Object.keys(dependencies).join(\", \"))}`,\n    );\n  }\n\n  if (Object.keys(devDependencies).length > 0) {\n    console.log(\n      `Installing dev dependencies ${colors.magenta(Object.keys(devDependencies).join(\", \"))}`,\n    );\n\n    installDependencySet(devDependencies, true);\n\n    console.log(\n      `Dev dependencies installed successfully ${colors.green(Object.keys(devDependencies).join(\", \"))}`,\n    );\n  }\n}\n\n/**\n * Write the resolved dependency sets into package.json without installing.\n * Used by `--no-install` so a scaffolder can batch every feature into one\n * install pass after the command returns. Versions come from the feature map.\n */\nasync function recordDependencies(\n  dependencies: Record<string, string>,\n  devDependencies: Record<string, string>,\n) {\n  if (Object.keys(dependencies).length === 0 && Object.keys(devDependencies).length === 0) {\n    return;\n  }\n\n  const packageJsonPath = rootPath(\"package.json\");\n  const packageJson = await getJsonFileAsync<ProjectPackageJson>(packageJsonPath);\n\n  packageJson.dependencies = packageJson.dependencies ?? {};\n  packageJson.devDependencies = packageJson.devDependencies ?? {};\n\n  Object.assign(packageJson.dependencies, dependencies);\n  Object.assign(packageJson.devDependencies, devDependencies);\n\n  await putJsonFileAsync(packageJsonPath, packageJson);\n\n  const recorded = [...Object.keys(dependencies), ...Object.keys(devDependencies)];\n\n  console.log(\n    `Recorded ${colors.green(recorded.join(\", \"))} in package.json (${isGenerationDryRun() ? \"dry run: nothing installed\" : \"install skipped via --no-install\"})`,\n  );\n}\n\nfunction validateFeatures(features: string[]) {\n  for (const feature of features) {\n    if (!allowedFeatures.includes(feature)) {\n      console.log(\n        `Feature ${colors.redBright(feature)} is not allowed, allowed features are: ${colors.green(allowedFeatures.join(\", \"))}`,\n      );\n      process.exit(1);\n    }\n  }\n}\n"],"mappings":"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"}

package/esm/generations/features/bull-board.feature.mjs

@@ -22,7 +22,8 @@ async function addDashboardConfigBlock() {
 `);
 		return;
 	}
-	const insertion = insertQueueDashboardBlock(await getFileAsync(configPath));
+	const current = await getFileAsync(configPath);
+	const insertion = insertQueueDashboardBlock(current);
 	if (insertion.status === "already-present") {
 		console.log(`${colors.yellowBright("dashboard")} config already present in src/config/queue.ts, skipping...`);
 		return;

package/esm/generations/features/bull-board.feature.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"bull-board.feature.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/generations/features/bull-board.feature.ts"],"sourcesContent":["import { colors } from \"@mongez/copper\";\nimport { fileExistsAsync, getFileAsync, getJsonFileAsync, putFileAsync } from \"../generation-fs\";\nimport type { CommandActionData } from \"../../commands/types\";\nimport { rootPath, srcPath } from \"../../utils\";\nimport { insertQueueDashboardBlock } from \"./shared/insert-queue-dashboard-block\";\nimport type { FeatureDefinition } from \"./types\";\n\n/** The parts of `package.json` this feature reads to check for its prerequisite. */\ntype ProjectPackageJson = {\n  dependencies?: Record<string, string>;\n  devDependencies?: Record<string, string>;\n};\n\n/**\n * Defensive floor: `requires: [\"queue\"]` normally installs queue first, so\n * this only fires when the dashboard step runs without it (e.g. called\n * directly), and then fails loudly instead of writing a half-wired config.\n */\nasync function isQueueInstalled(): Promise<boolean> {\n  const packageJson = await getJsonFileAsync<ProjectPackageJson>(rootPath(\"package.json\"));\n\n  return Boolean(\n    packageJson.dependencies?.[\"@warlock.js/queue\"] ||\n    packageJson.devDependencies?.[\"@warlock.js/queue\"],\n  );\n}\n\n/** Insert the `dashboard` block into `src/config/queue.ts`, without reformatting it. */\nasync function addDashboardConfigBlock(): Promise<void> {\n  const configPath = srcPath(\"config/queue.ts\");\n\n  if (!(await fileExistsAsync(configPath))) {\n    console.log(\n      `${colors.yellowBright(\"src/config/queue.ts\")} not found — add this to your queue config yourself:\\n` +\n        '  dashboard: { enabled: true, path: \"/admin/queues\", middleware: [] },\\n',\n    );\n\n    return;\n  }\n\n  const current = await getFileAsync(configPath);\n  const insertion = insertQueueDashboardBlock(current);\n\n  if (insertion.status === \"already-present\") {\n    console.log(\n      `${colors.yellowBright(\"dashboard\")} config already present in src/config/queue.ts, skipping...`,\n    );\n\n    return;\n  }\n\n  if (insertion.status === \"unrecognised\") {\n    console.log(\n      `${colors.yellowBright(\"!\")} src/config/queue.ts has no recognisable ${colors.yellowBright(\"queueConfig\")} object — ` +\n        \"add the dashboard block yourself:\\n\" +\n        '  dashboard: { enabled: true, path: \"/admin/queues\", middleware: [] },\\n',\n    );\n\n    return;\n  }\n\n  await putFileAsync(configPath, insertion.next);\n  console.log(`${colors.green(\"✓\")} Added dashboard config to src/config/queue.ts`);\n}\n\n/**\n * Wire the dashboard into the app: verify queue is installed, then add the\n * `dashboard` block to its config.\n */\nasync function completeBullBoardInstallation(_options: CommandActionData): Promise<void> {\n  if (!(await isQueueInstalled())) {\n    console.log(\n      `${colors.redBright(\"✗\")} @warlock.js/queue is not installed — run ` +\n        `${colors.yellowBright(\"warlock add queue\")} first, then ${colors.yellowBright(\"warlock add bull-board\")}.`,\n    );\n    process.exitCode = 1;\n\n    return;\n  }\n\n  await addDashboardConfigBlock();\n\n  console.log(\n    \"\\nNext: guard the dashboard with a middleware before it ships to production — an empty \" +\n      'middleware list throws QueueDashboardUnguardedError at boot when NODE_ENV is \"production\".',\n  );\n}\n\n/** `warlock add bull-board` — a config-driven bull-board dashboard for @warlock.js/queue. */\nexport const bullBoardFeature: FeatureDefinition = {\n  description:\n    \"Installs @bull-board/api and @bull-board/fastify and adds a dashboard block to src/config/queue.ts. Adds the queue feature first when it is missing.\",\n  requires: [\"queue\"],\n  dependencies: {\n    \"@bull-board/api\": \"^9.10.2\",\n    \"@bull-board/fastify\": \"^9.10.2\",\n  },\n  onExecuting: completeBullBoardInstallation,\n};\n"],"mappings":";;;;;;;;;;;;AAkBA,eAAe,mBAAqC;CAClD,MAAM,cAAc,MAAM,iBAAqC,SAAS,cAAc,CAAC;CAEvF,OAAO,QACL,YAAY,eAAe,wBAC3B,YAAY,kBAAkB,oBAChC;AACF;;AAGA,eAAe,0BAAyC;CACtD,MAAM,aAAa,QAAQ,iBAAiB;CAE5C,IAAI,CAAE,MAAM,gBAAgB,UAAU,GAAI;EACxC,QAAQ,IACN,GAAG,OAAO,aAAa,qBAAqB,EAAE;CAEhD;EAEA;CACF;CAGA,MAAM,YAAY,0BAA0B,MADtB,aAAa,UAAU,CACM;CAEnD,IAAI,UAAU,WAAW,mBAAmB;EAC1C,QAAQ,IACN,GAAG,OAAO,aAAa,WAAW,EAAE,4DACtC;EAEA;CACF;CAEA,IAAI,UAAU,WAAW,gBAAgB;EACvC,QAAQ,IACN,GAAG,OAAO,aAAa,GAAG,EAAE,2CAA2C,OAAO,aAAa,aAAa,EAAE;;CAG5G;EAEA;CACF;CAEA,MAAM,aAAa,YAAY,UAAU,IAAI;CAC7C,QAAQ,IAAI,GAAG,OAAO,MAAM,GAAG,EAAE,+CAA+C;AAClF;;;;;AAMA,eAAe,8BAA8B,UAA4C;CACvF,IAAI,CAAE,MAAM,iBAAiB,GAAI;EAC/B,QAAQ,IACN,GAAG,OAAO,UAAU,GAAG,EAAE,4CACpB,OAAO,aAAa,mBAAmB,EAAE,eAAe,OAAO,aAAa,wBAAwB,EAAE,EAC7G;EACA,QAAQ,WAAW;EAEnB;CACF;CAEA,MAAM,wBAAwB;CAE9B,QAAQ,IACN,qLAEF;AACF;;AAGA,MAAa,mBAAsC;CACjD,aACE;CACF,UAAU,CAAC,OAAO;CAClB,cAAc;EACZ,mBAAmB;EACnB,uBAAuB;CACzB;CACA,aAAa;AACf"}
+{"version":3,"file":"bull-board.feature.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/generations/features/bull-board.feature.ts"],"sourcesContent":["import { colors } from \"@mongez/copper\";\nimport { fileExistsAsync, getFileAsync, getJsonFileAsync, putFileAsync } from \"../generation-fs\";\nimport type { CommandActionData } from \"../../commands/types\";\nimport { rootPath, srcPath } from \"../../utils\";\nimport { insertQueueDashboardBlock } from \"./shared/insert-queue-dashboard-block\";\nimport type { FeatureDefinition } from \"./types\";\n\n/** The parts of `package.json` this feature reads to check for its prerequisite. */\ntype ProjectPackageJson = {\n  dependencies?: Record<string, string>;\n  devDependencies?: Record<string, string>;\n};\n\n/**\n * Defensive floor: `requires: [\"queue\"]` normally installs queue first, so\n * this only fires when the dashboard step runs without it (e.g. called\n * directly), and then fails loudly instead of writing a half-wired config.\n */\nasync function isQueueInstalled(): Promise<boolean> {\n  const packageJson = await getJsonFileAsync<ProjectPackageJson>(rootPath(\"package.json\"));\n\n  return Boolean(\n    packageJson.dependencies?.[\"@warlock.js/queue\"] ||\n    packageJson.devDependencies?.[\"@warlock.js/queue\"],\n  );\n}\n\n/** Insert the `dashboard` block into `src/config/queue.ts`, without reformatting it. */\nasync function addDashboardConfigBlock(): Promise<void> {\n  const configPath = srcPath(\"config/queue.ts\");\n\n  if (!(await fileExistsAsync(configPath))) {\n    console.log(\n      `${colors.yellowBright(\"src/config/queue.ts\")} not found — add this to your queue config yourself:\\n` +\n        '  dashboard: { enabled: true, path: \"/admin/queues\", middleware: [] },\\n',\n    );\n\n    return;\n  }\n\n  const current = await getFileAsync(configPath);\n  const insertion = insertQueueDashboardBlock(current);\n\n  if (insertion.status === \"already-present\") {\n    console.log(\n      `${colors.yellowBright(\"dashboard\")} config already present in src/config/queue.ts, skipping...`,\n    );\n\n    return;\n  }\n\n  if (insertion.status === \"unrecognised\") {\n    console.log(\n      `${colors.yellowBright(\"!\")} src/config/queue.ts has no recognisable ${colors.yellowBright(\"queueConfig\")} object — ` +\n        \"add the dashboard block yourself:\\n\" +\n        '  dashboard: { enabled: true, path: \"/admin/queues\", middleware: [] },\\n',\n    );\n\n    return;\n  }\n\n  await putFileAsync(configPath, insertion.next);\n  console.log(`${colors.green(\"✓\")} Added dashboard config to src/config/queue.ts`);\n}\n\n/**\n * Wire the dashboard into the app: verify queue is installed, then add the\n * `dashboard` block to its config.\n */\nasync function completeBullBoardInstallation(_options: CommandActionData): Promise<void> {\n  if (!(await isQueueInstalled())) {\n    console.log(\n      `${colors.redBright(\"✗\")} @warlock.js/queue is not installed — run ` +\n        `${colors.yellowBright(\"warlock add queue\")} first, then ${colors.yellowBright(\"warlock add bull-board\")}.`,\n    );\n    process.exitCode = 1;\n\n    return;\n  }\n\n  await addDashboardConfigBlock();\n\n  console.log(\n    \"\\nNext: guard the dashboard with a middleware before it ships to production — an empty \" +\n      'middleware list throws QueueDashboardUnguardedError at boot when NODE_ENV is \"production\".',\n  );\n}\n\n/** `warlock add bull-board` — a config-driven bull-board dashboard for @warlock.js/queue. */\nexport const bullBoardFeature: FeatureDefinition = {\n  description:\n    \"Installs @bull-board/api and @bull-board/fastify and adds a dashboard block to src/config/queue.ts. Adds the queue feature first when it is missing.\",\n  requires: [\"queue\"],\n  dependencies: {\n    \"@bull-board/api\": \"^9.10.2\",\n    \"@bull-board/fastify\": \"^9.10.2\",\n  },\n  onExecuting: completeBullBoardInstallation,\n};\n"],"mappings":";;;;;;;;;;;;AAkBA,eAAe,mBAAqC;CAClD,MAAM,cAAc,MAAM,iBAAqC,SAAS,cAAc,CAAC;CAEvF,OAAO,QACL,YAAY,eAAe,wBAC3B,YAAY,kBAAkB,oBAChC;AACF;;AAGA,eAAe,0BAAyC;CACtD,MAAM,aAAa,QAAQ,iBAAiB;CAE5C,IAAI,CAAE,MAAM,gBAAgB,UAAU,GAAI;EACxC,QAAQ,IACN,GAAG,OAAO,aAAa,qBAAqB,EAAE;CAEhD;EAEA;CACF;CAEA,MAAM,UAAU,MAAM,aAAa,UAAU;CAC7C,MAAM,YAAY,0BAA0B,OAAO;CAEnD,IAAI,UAAU,WAAW,mBAAmB;EAC1C,QAAQ,IACN,GAAG,OAAO,aAAa,WAAW,EAAE,4DACtC;EAEA;CACF;CAEA,IAAI,UAAU,WAAW,gBAAgB;EACvC,QAAQ,IACN,GAAG,OAAO,aAAa,GAAG,EAAE,2CAA2C,OAAO,aAAa,aAAa,EAAE;;CAG5G;EAEA;CACF;CAEA,MAAM,aAAa,YAAY,UAAU,IAAI;CAC7C,QAAQ,IAAI,GAAG,OAAO,MAAM,GAAG,EAAE,+CAA+C;AAClF;;;;;AAMA,eAAe,8BAA8B,UAA4C;CACvF,IAAI,CAAE,MAAM,iBAAiB,GAAI;EAC/B,QAAQ,IACN,GAAG,OAAO,UAAU,GAAG,EAAE,4CACpB,OAAO,aAAa,mBAAmB,EAAE,eAAe,OAAO,aAAa,wBAAwB,EAAE,EAC7G;EACA,QAAQ,WAAW;EAEnB;CACF;CAEA,MAAM,wBAAwB;CAE9B,QAAQ,IACN,qLAEF;AACF;;AAGA,MAAa,mBAAsC;CACjD,aACE;CACF,UAAU,CAAC,OAAO;CAClB,cAAc;EACZ,mBAAmB;EACnB,uBAAuB;CACzB;CACA,aAAa;AACf"}

package/esm/generations/features/index.mjs

@@ -19,6 +19,7 @@ import { mongodbFeature } from "./mongodb.feature.mjs";
 import { mysqlFeature } from "./mysql.feature.mjs";
 import { notificationsFeature } from "./notifications.feature.mjs";
 import { postgresFeature } from "./postgres.feature.mjs";
+import { processFeature } from "./process.feature.mjs";
 import { queueFeature } from "./queue.feature.mjs";
 import { reactEmailFeature } from "./react-email.feature.mjs";
 import { reactFeature } from "./react.feature.mjs";
@@ -60,6 +61,7 @@ const featuresMap = {
 	shadcn: shadcnFeature,
 	sitemap: sitemapFeature,
 	devtools: devtoolsFeature,
+	process: processFeature,
 	herald: heraldFeature,
 	queue: queueFeature,
 	"bull-board": bullBoardFeature,

package/esm/generations/features/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/generations/features/index.ts"],"sourcesContent":["import { accessFeature } from \"./access.feature\";\nimport { aiAnthropicFeature } from \"./ai-anthropic.feature\";\nimport { aiBedrockFeature } from \"./ai-bedrock.feature\";\nimport { aiGoogleFeature } from \"./ai-google.feature\";\nimport { aiOllamaFeature } from \"./ai-ollama.feature\";\nimport { aiOpenaiFeature } from \"./ai-openai.feature\";\nimport { aiPanopticFeature } from \"./ai-panoptic.feature\";\nimport { aiToolsFeature } from \"./ai-tools.feature\";\nimport { aiWorkspaceFeature } from \"./ai-workspace.feature\";\nimport { aiFeature } from \"./ai.feature\";\nimport { authGoogleFeature } from \"./auth-google.feature\";\nimport { authPasskeysFeature } from \"./auth-passkeys.feature\";\nimport { bullBoardFeature } from \"./bull-board.feature\";\nimport { devtoolsFeature } from \"./devtools.feature\";\nimport { heraldFeature } from \"./herald.feature\";\nimport { imageFeature } from \"./image.feature\";\nimport { mailFeature } from \"./mail.feature\";\nimport { mongodbFeature } from \"./mongodb.feature\";\nimport { mysqlFeature } from \"./mysql.feature\";\nimport { notificationsFeature } from \"./notifications.feature\";\nimport { postgresFeature } from \"./postgres.feature\";\nimport { queueFeature } from \"./queue.feature\";\nimport { reactEmailFeature } from \"./react-email.feature\";\nimport { reactFeature } from \"./react.feature\";\nimport { redisFeature } from \"./redis.feature\";\nimport { s3Feature } from \"./s3.feature\";\nimport { schedulerFeature } from \"./scheduler.feature\";\nimport { sesFeature } from \"./ses.feature\";\nimport { shadcnFeature } from \"./shadcn.feature\";\nimport { sitemapFeature } from \"./sitemap.feature\";\nimport { socketFeature } from \"./socket.feature\";\nimport { tailwindFeature } from \"./tailwind.feature\";\nimport { testFeature } from \"./test.feature\";\nimport type { FeatureDefinition } from \"./types\";\nimport { webFeature } from \"./web.feature\";\n\nexport type { FeatureDefinition } from \"./types\";\n\n/**\n * The feature registry `warlock add` dispatches against.\n *\n * This file is an INDEX, nothing more: every entry lives in its own module\n * alongside the `onExecuting` body it runs. Key order is load-bearing — it is\n * the order `--list` prints and the order the \"not allowed\" error lists — so\n * add new features in the place they should appear, not alphabetically.\n */\nexport const featuresMap: Record<string, FeatureDefinition> = {\n  \"react-email\": reactEmailFeature,\n  react: reactFeature,\n  image: imageFeature,\n  mail: mailFeature,\n  ses: sesFeature,\n  mongodb: mongodbFeature,\n  scheduler: schedulerFeature,\n  // swagger / postman intentionally omitted — those packages do not exist yet;\n  // they will ship together in the unified @warlock.js/api-docs package.\n  postgres: postgresFeature,\n  mysql: mysqlFeature,\n  redis: redisFeature,\n  s3: s3Feature,\n  test: testFeature,\n  web: webFeature,\n  // Directly after `web`, and only there: it `requires` it, it is useless\n  // without it, and a reader scanning `--list` for the page stack should meet\n  // the two together rather than find styling filed between queues and sockets.\n  tailwind: tailwindFeature,\n  // Immediately after `tailwind`, for the same reason `tailwind` follows `web`:\n  // it `requires` it, it appends to the stylesheet that feature creates, and the\n  // three of them are one stack a reader should meet in build order.\n  shadcn: shadcnFeature,\n  // Directly after the web/tailwind/shadcn stack, for the same reason: it\n  // `requires` web (it reads the page registry `listRoutablePages()`\n  // exposes) and a reader scanning `--list` for the page stack should meet it\n  // there rather than filed between queues and sockets.\n  sitemap: sitemapFeature,\n  devtools: devtoolsFeature,\n  herald: heraldFeature,\n  queue: queueFeature,\n  // Directly after `queue`, for the same reason `tailwind` follows `web`: it\n  // needs queue already installed and configured, and a reader scanning\n  // `--list` for job-queue features should meet the two together.\n  \"bull-board\": bullBoardFeature,\n  socket: socketFeature,\n  notifications: notificationsFeature,\n  access: accessFeature,\n  // Login methods for @warlock.js/auth — \"<package>-<vendor>\" like the ai-* entries.\n  \"auth-google\": authGoogleFeature,\n  \"auth-passkeys\": authPasskeysFeature,\n  ai: aiFeature,\n  \"ai-openai\": aiOpenaiFeature,\n  \"ai-google\": aiGoogleFeature,\n  \"ai-anthropic\": aiAnthropicFeature,\n  \"ai-bedrock\": aiBedrockFeature,\n  \"ai-ollama\": aiOllamaFeature,\n  \"ai-tools\": aiToolsFeature,\n  \"ai-panoptic\": aiPanopticFeature,\n  \"ai-workspace\": aiWorkspaceFeature,\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8CA,MAAa,cAAiD;CAC5D,eAAe;CACf,OAAO;CACP,OAAO;CACP,MAAM;CACN,KAAK;CACL,SAAS;CACT,WAAW;CAGX,UAAU;CACV,OAAO;CACP,OAAO;CACP,IAAI;CACJ,MAAM;CACN,KAAK;CAIL,UAAU;CAIV,QAAQ;CAKR,SAAS;CACT,UAAU;CACV,QAAQ;CACR,OAAO;CAIP,cAAc;CACd,QAAQ;CACR,eAAe;CACf,QAAQ;CAER,eAAe;CACf,iBAAiB;CACjB,IAAI;CACJ,aAAa;CACb,aAAa;CACb,gBAAgB;CAChB,cAAc;CACd,aAAa;CACb,YAAY;CACZ,eAAe;CACf,gBAAgB;AAClB"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/generations/features/index.ts"],"sourcesContent":["import { accessFeature } from \"./access.feature\";\nimport { aiAnthropicFeature } from \"./ai-anthropic.feature\";\nimport { aiBedrockFeature } from \"./ai-bedrock.feature\";\nimport { aiGoogleFeature } from \"./ai-google.feature\";\nimport { aiOllamaFeature } from \"./ai-ollama.feature\";\nimport { aiOpenaiFeature } from \"./ai-openai.feature\";\nimport { aiPanopticFeature } from \"./ai-panoptic.feature\";\nimport { aiToolsFeature } from \"./ai-tools.feature\";\nimport { aiWorkspaceFeature } from \"./ai-workspace.feature\";\nimport { aiFeature } from \"./ai.feature\";\nimport { authGoogleFeature } from \"./auth-google.feature\";\nimport { authPasskeysFeature } from \"./auth-passkeys.feature\";\nimport { bullBoardFeature } from \"./bull-board.feature\";\nimport { devtoolsFeature } from \"./devtools.feature\";\nimport { heraldFeature } from \"./herald.feature\";\nimport { imageFeature } from \"./image.feature\";\nimport { mailFeature } from \"./mail.feature\";\nimport { mongodbFeature } from \"./mongodb.feature\";\nimport { mysqlFeature } from \"./mysql.feature\";\nimport { notificationsFeature } from \"./notifications.feature\";\nimport { postgresFeature } from \"./postgres.feature\";\nimport { processFeature } from \"./process.feature\";\nimport { queueFeature } from \"./queue.feature\";\nimport { reactEmailFeature } from \"./react-email.feature\";\nimport { reactFeature } from \"./react.feature\";\nimport { redisFeature } from \"./redis.feature\";\nimport { s3Feature } from \"./s3.feature\";\nimport { schedulerFeature } from \"./scheduler.feature\";\nimport { sesFeature } from \"./ses.feature\";\nimport { shadcnFeature } from \"./shadcn.feature\";\nimport { sitemapFeature } from \"./sitemap.feature\";\nimport { socketFeature } from \"./socket.feature\";\nimport { tailwindFeature } from \"./tailwind.feature\";\nimport { testFeature } from \"./test.feature\";\nimport type { FeatureDefinition } from \"./types\";\nimport { webFeature } from \"./web.feature\";\n\nexport type { FeatureDefinition } from \"./types\";\n\n/**\n * The feature registry `warlock add` dispatches against.\n *\n * This file is an INDEX, nothing more: every entry lives in its own module\n * alongside the `onExecuting` body it runs. Key order is load-bearing — it is\n * the order `--list` prints and the order the \"not allowed\" error lists — so\n * add new features in the place they should appear, not alphabetically.\n */\nexport const featuresMap: Record<string, FeatureDefinition> = {\n  \"react-email\": reactEmailFeature,\n  react: reactFeature,\n  image: imageFeature,\n  mail: mailFeature,\n  ses: sesFeature,\n  mongodb: mongodbFeature,\n  scheduler: schedulerFeature,\n  // swagger / postman intentionally omitted — those packages do not exist yet;\n  // they will ship together in the unified @warlock.js/api-docs package.\n  postgres: postgresFeature,\n  mysql: mysqlFeature,\n  redis: redisFeature,\n  s3: s3Feature,\n  test: testFeature,\n  web: webFeature,\n  // Directly after `web`, and only there: it `requires` it, it is useless\n  // without it, and a reader scanning `--list` for the page stack should meet\n  // the two together rather than find styling filed between queues and sockets.\n  tailwind: tailwindFeature,\n  // Immediately after `tailwind`, for the same reason `tailwind` follows `web`:\n  // it `requires` it, it appends to the stylesheet that feature creates, and the\n  // three of them are one stack a reader should meet in build order.\n  shadcn: shadcnFeature,\n  // Directly after the web/tailwind/shadcn stack, for the same reason: it\n  // `requires` web (it reads the page registry `listRoutablePages()`\n  // exposes) and a reader scanning `--list` for the page stack should meet it\n  // there rather than filed between queues and sockets.\n  sitemap: sitemapFeature,\n  devtools: devtoolsFeature,\n  process: processFeature,\n  herald: heraldFeature,\n  queue: queueFeature,\n  // Directly after `queue`, for the same reason `tailwind` follows `web`: it\n  // needs queue already installed and configured, and a reader scanning\n  // `--list` for job-queue features should meet the two together.\n  \"bull-board\": bullBoardFeature,\n  socket: socketFeature,\n  notifications: notificationsFeature,\n  access: accessFeature,\n  // Login methods for @warlock.js/auth — \"<package>-<vendor>\" like the ai-* entries.\n  \"auth-google\": authGoogleFeature,\n  \"auth-passkeys\": authPasskeysFeature,\n  ai: aiFeature,\n  \"ai-openai\": aiOpenaiFeature,\n  \"ai-google\": aiGoogleFeature,\n  \"ai-anthropic\": aiAnthropicFeature,\n  \"ai-bedrock\": aiBedrockFeature,\n  \"ai-ollama\": aiOllamaFeature,\n  \"ai-tools\": aiToolsFeature,\n  \"ai-panoptic\": aiPanopticFeature,\n  \"ai-workspace\": aiWorkspaceFeature,\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+CA,MAAa,cAAiD;CAC5D,eAAe;CACf,OAAO;CACP,OAAO;CACP,MAAM;CACN,KAAK;CACL,SAAS;CACT,WAAW;CAGX,UAAU;CACV,OAAO;CACP,OAAO;CACP,IAAI;CACJ,MAAM;CACN,KAAK;CAIL,UAAU;CAIV,QAAQ;CAKR,SAAS;CACT,UAAU;CACV,SAAS;CACT,QAAQ;CACR,OAAO;CAIP,cAAc;CACd,QAAQ;CACR,eAAe;CACf,QAAQ;CAER,eAAe;CACf,iBAAiB;CACjB,IAAI;CACJ,aAAa;CACb,aAAa;CACb,gBAAgB;CAChB,cAAc;CACd,aAAa;CACb,YAAY;CACZ,eAAe;CACf,gBAAgB;AAClB"}

package/esm/generations/features/notifications.feature.mjs

@@ -103,7 +103,8 @@ async function pointConfigAtLegacyModel() {
 }
 async function completeNotificationsInstallation(_options) {
 	const modelPath = srcPath("app/notifications/models/notification/notification.model.ts");
-	if (await fileExistsAsync(srcPath("app/notifications/notification.model.ts"))) {
+	const legacyModelPath = srcPath("app/notifications/notification.model.ts");
+	if (await fileExistsAsync(legacyModelPath)) {
 		if (!await fileExistsAsync(modelPath)) await pointConfigAtLegacyModel();
 		console.log(`${colors.yellowBright("src/app/notifications")} already scaffolded (5.29 layout), skipping...`);
 		return;

package/esm/generations/features/notifications.feature.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"notifications.feature.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/generations/features/notifications.feature.ts"],"sourcesContent":["import { colors } from \"@mongez/copper\";\nimport { dirname } from \"node:path\";\nimport {\n  directoryExistsAsync,\n  ensureDirectoryAsync,\n  fileExistsAsync,\n  getFileAsync,\n  putFileAsync,\n  recordSkippedFile,\n} from \"../generation-fs\";\nimport type { CommandActionData } from \"../../commands/types\";\nimport { srcPath } from \"../../utils\";\nimport {\n  listNotificationsControllerStub,\n  listNotificationsSchemaStub,\n  markAllNotificationsReadControllerStub,\n  markNotificationReadControllerStub,\n  markNotificationReadServiceStub,\n  notificationControllerSpecStub,\n  notificationTestFixtureStub,\n  notificationLocalesStub,\n  notificationMigrationStub,\n  notificationModelStub,\n  notificationResourceStub,\n  notificationRoutesStub,\n  notificationsConfigStub,\n  notificationsRequestTypeStub,\n  unreadNotificationsCountControllerStub,\n} from \"../stubs\";\nimport { migrationTimestamp } from \"./shared/migration-timestamp\";\nimport { type FeatureDefinition, INSTALLED_WARLOCK_VERSION } from \"./types\";\n\n/**\n * The module's controllers, with the route each one serves. A spec per\n * controller is written next to it when the app has the test feature.\n */\nconst notificationControllers = [\n  {\n    file: \"list-notifications.controller\",\n    stub: listNotificationsControllerStub,\n    method: \"GET\",\n    path: \"/notifications\",\n  },\n  {\n    file: \"unread-notifications-count.controller\",\n    stub: unreadNotificationsCountControllerStub,\n    method: \"GET\",\n    path: \"/notifications/unread-count\",\n  },\n  {\n    file: \"mark-notification-read.controller\",\n    stub: markNotificationReadControllerStub,\n    method: \"PATCH\",\n    path: \"/notifications/1/read\",\n  },\n  {\n    file: \"mark-all-notifications-read.controller\",\n    stub: markAllNotificationsReadControllerStub,\n    method: \"PATCH\",\n    path: \"/notifications/read-all\",\n  },\n] as const;\n\n/** The model's import path in the ejected config, before and since 5.30. */\nconst MODEL_IMPORT = \"app/notifications/models/notification/notification.model\";\nconst LEGACY_MODEL_IMPORT = \"app/notifications/notification.model\";\n\n/**\n * Write one module file unless it already exists. A file the app already has\n * is the app's own code: it is reported and left alone, never overwritten.\n */\nasync function writeModuleFile(relativePath: string, content: string, skipped: string[]) {\n  const path = srcPath(\"app/notifications\", relativePath);\n\n  if (await fileExistsAsync(path)) {\n    skipped.push(relativePath);\n    recordSkippedFile(path, \"exists\");\n    return;\n  }\n\n  await ensureDirectoryAsync(dirname(path));\n  await putFileAsync(path, content);\n  console.log(`${colors.green(\"✓\")} Created src/app/notifications/${relativePath}`);\n}\n\n/**\n * Add the module's `notFound` message to an existing utils/locales.json, or\n * create the file. Existing keys win; a file that is not a JSON object, or\n * that renames its group, is left for the app to update by hand.\n */\nasync function registerNotificationLocales(skipped: string[]) {\n  const localesPath = srcPath(\"app/notifications/utils/locales.json\");\n\n  if (!(await fileExistsAsync(localesPath))) {\n    await writeModuleFile(\"utils/locales.json\", notificationLocalesStub, skipped);\n    return;\n  }\n\n  const defaults = JSON.parse(notificationLocalesStub) as Record<string, unknown>;\n  let dictionary: Record<string, unknown>;\n\n  try {\n    const parsed: unknown = JSON.parse(await getFileAsync(localesPath));\n\n    if (parsed === null || Array.isArray(parsed) || typeof parsed !== \"object\") throw new Error();\n\n    dictionary = parsed as Record<string, unknown>;\n  } catch {\n    console.log(\n      `${colors.yellowBright(\"notifications\")} locale JSON is invalid; add notFound to src/app/notifications/utils/locales.json manually.`,\n    );\n    return;\n  }\n\n  // A root `$group` renames the file's namespace, so the service's\n  // t(\"notifications.notFound\") would not find a key merged here.\n  if (dictionary.$group !== undefined && dictionary.$group !== \"notifications\") {\n    console.log(\n      `${colors.yellowBright(\"notifications\")} locale JSON declares a different $group; add notifications.notFound manually.`,\n    );\n    return;\n  }\n\n  const missing = Object.keys(defaults).filter((key) => dictionary[key] === undefined);\n\n  if (missing.length === 0) return;\n\n  for (const key of missing) dictionary[key] = defaults[key];\n\n  await putFileAsync(localesPath, `${JSON.stringify(dictionary, null, 2)}\\n`);\n  console.log(\n    `${colors.green(\"✓\")} Added ${missing.join(\", \")} to src/app/notifications/utils/locales.json`,\n  );\n}\n\n/**\n * The config ejected just before this runs imports the 5.30 model path. In an\n * app scaffolded by 5.29 the model is still at the module root, so point the\n * import there instead of at a file that does not exist.\n */\nasync function pointConfigAtLegacyModel() {\n  const configPath = srcPath(\"config/notifications.ts\");\n\n  if (!(await fileExistsAsync(configPath))) return;\n\n  const config = await getFileAsync(configPath);\n\n  if (!config.includes(`\"${MODEL_IMPORT}\"`)) return;\n\n  await putFileAsync(configPath, config.replace(`\"${MODEL_IMPORT}\"`, `\"${LEGACY_MODEL_IMPORT}\"`));\n  console.log(\n    `${colors.green(\"✓\")} src/config/notifications.ts imports the existing model at ${LEGACY_MODEL_IMPORT}`,\n  );\n}\n\nasync function completeNotificationsInstallation(_options: CommandActionData) {\n  const modelPath = srcPath(\"app/notifications/models/notification/notification.model.ts\");\n  // Where 5.29 and earlier wrote the model.\n  const legacyModelPath = srcPath(\"app/notifications/notification.model.ts\");\n\n  // The model file is the sentinel for \"notifications already scaffolded\" —\n  // its presence means the migration was created too (timestamped, so we must\n  // not re-emit a duplicate on a second run).\n  if (await fileExistsAsync(legacyModelPath)) {\n    if (!(await fileExistsAsync(modelPath))) await pointConfigAtLegacyModel();\n\n    console.log(\n      `${colors.yellowBright(\"src/app/notifications\")} already scaffolded (5.29 layout), skipping...`,\n    );\n    return;\n  }\n\n  if (await fileExistsAsync(modelPath)) {\n    console.log(`${colors.yellowBright(\"src/app/notifications\")} already scaffolded, skipping...`);\n    return;\n  }\n\n  const skipped: string[] = [];\n  // An app that already has its own notifications module may keep its model\n  // anywhere in it; a second Notification model would collide with it.\n  const moduleExists = await directoryExistsAsync(srcPath(\"app/notifications\"));\n\n  // 1. Model + migration under models/notification/, like every other module.\n  //    The migration's MM-DD-YYYY_HH-MM-SS prefix lets cascade infer its\n  //    createdAt and order it deterministically.\n  if (moduleExists) {\n    console.log(\n      `${colors.yellowBright(\"src/app/notifications\")} already exists: not adding a Notification model or migration. config/notifications.ts must import your model.`,\n    );\n  } else {\n    await writeModuleFile(\n      \"models/notification/notification.model.ts\",\n      notificationModelStub,\n      skipped,\n    );\n    await writeModuleFile(\n      `models/notification/migrations/${migrationTimestamp()}-notification.migration.ts`,\n      notificationMigrationStub,\n      skipped,\n    );\n  }\n\n  // 2. One responsibility per file: output resource, validated list query,\n  //    guarded request type, service, translations.\n  await writeModuleFile(\"resources/notification.resource.ts\", notificationResourceStub, skipped);\n  await writeModuleFile(\n    \"schema/list-notifications.schema.ts\",\n    listNotificationsSchemaStub,\n    skipped,\n  );\n  await writeModuleFile(\n    \"types/notifications-request.type.ts\",\n    notificationsRequestTypeStub,\n    skipped,\n  );\n  await writeModuleFile(\n    \"services/mark-notification-read.service.ts\",\n    markNotificationReadServiceStub,\n    skipped,\n  );\n  await registerNotificationLocales(skipped);\n\n  // 3. HTTP surface — list, unread count, mark read, mark all read, one\n  //    controller per file, gated by authMiddleware in routes.ts.\n  const withSpecs = await fileExistsAsync(srcPath(\"test-setup.ts\"));\n  if (withSpecs) {\n    await writeModuleFile(\"tests/notifications.fixture.ts\", notificationTestFixtureStub, skipped);\n  }\n\n  for (const controller of notificationControllers) {\n    await writeModuleFile(`controllers/${controller.file}.ts`, controller.stub, skipped);\n\n    if (withSpecs) {\n      await writeModuleFile(\n        `controllers/${controller.file}.spec.ts`,\n        notificationControllerSpecStub(controller.method, controller.path),\n        skipped,\n      );\n    }\n  }\n\n  await writeModuleFile(\"routes.ts\", notificationRoutesStub, skipped);\n\n  if (skipped.length > 0) {\n    console.log(\n      `${colors.yellowBright(\"Kept your existing files\")} (not overwritten): ${skipped\n        .map((file) => `src/app/notifications/${file}`)\n        .join(\", \")}`,\n    );\n  }\n}\n\nexport const notificationsFeature: FeatureDefinition = {\n  description:\n    \"Installs @warlock.js/notifications — multi-channel notifications (mail + in-app database). Pulls the mail feature, ejects config/notifications.ts, and scaffolds src/app/notifications: the Notification model + migration, a resource, a validated list query, and the recipient-scoped list / unread-count / mark-read / mark-all-read endpoints (one controller per file, a spec each when tests are set up)\",\n  // The ejected config wires a `mail` channel by default (needs nodemailer,\n  // via the `mail` feature); the scaffolded routes are gated by\n  // `authMiddleware`, so `@warlock.js/auth` is pulled in too.\n  requires: [\"mail\"],\n  dependencies: {\n    \"@warlock.js/notifications\": INSTALLED_WARLOCK_VERSION,\n    \"@warlock.js/auth\": INSTALLED_WARLOCK_VERSION,\n  },\n  ejectConfig: {\n    content: notificationsConfigStub,\n    name: \"notifications\",\n  },\n  onExecuting: completeNotificationsInstallation,\n};\n"],"mappings":"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"}
+{"version":3,"file":"notifications.feature.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/generations/features/notifications.feature.ts"],"sourcesContent":["import { colors } from \"@mongez/copper\";\nimport { dirname } from \"node:path\";\nimport {\n  directoryExistsAsync,\n  ensureDirectoryAsync,\n  fileExistsAsync,\n  getFileAsync,\n  putFileAsync,\n  recordSkippedFile,\n} from \"../generation-fs\";\nimport type { CommandActionData } from \"../../commands/types\";\nimport { srcPath } from \"../../utils\";\nimport {\n  listNotificationsControllerStub,\n  listNotificationsSchemaStub,\n  markAllNotificationsReadControllerStub,\n  markNotificationReadControllerStub,\n  markNotificationReadServiceStub,\n  notificationControllerSpecStub,\n  notificationTestFixtureStub,\n  notificationLocalesStub,\n  notificationMigrationStub,\n  notificationModelStub,\n  notificationResourceStub,\n  notificationRoutesStub,\n  notificationsConfigStub,\n  notificationsRequestTypeStub,\n  unreadNotificationsCountControllerStub,\n} from \"../stubs\";\nimport { migrationTimestamp } from \"./shared/migration-timestamp\";\nimport { type FeatureDefinition, INSTALLED_WARLOCK_VERSION } from \"./types\";\n\n/**\n * The module's controllers, with the route each one serves. A spec per\n * controller is written next to it when the app has the test feature.\n */\nconst notificationControllers = [\n  {\n    file: \"list-notifications.controller\",\n    stub: listNotificationsControllerStub,\n    method: \"GET\",\n    path: \"/notifications\",\n  },\n  {\n    file: \"unread-notifications-count.controller\",\n    stub: unreadNotificationsCountControllerStub,\n    method: \"GET\",\n    path: \"/notifications/unread-count\",\n  },\n  {\n    file: \"mark-notification-read.controller\",\n    stub: markNotificationReadControllerStub,\n    method: \"PATCH\",\n    path: \"/notifications/1/read\",\n  },\n  {\n    file: \"mark-all-notifications-read.controller\",\n    stub: markAllNotificationsReadControllerStub,\n    method: \"PATCH\",\n    path: \"/notifications/read-all\",\n  },\n] as const;\n\n/** The model's import path in the ejected config, before and since 5.30. */\nconst MODEL_IMPORT = \"app/notifications/models/notification/notification.model\";\nconst LEGACY_MODEL_IMPORT = \"app/notifications/notification.model\";\n\n/**\n * Write one module file unless it already exists. A file the app already has\n * is the app's own code: it is reported and left alone, never overwritten.\n */\nasync function writeModuleFile(relativePath: string, content: string, skipped: string[]) {\n  const path = srcPath(\"app/notifications\", relativePath);\n\n  if (await fileExistsAsync(path)) {\n    skipped.push(relativePath);\n    recordSkippedFile(path, \"exists\");\n    return;\n  }\n\n  await ensureDirectoryAsync(dirname(path));\n  await putFileAsync(path, content);\n  console.log(`${colors.green(\"✓\")} Created src/app/notifications/${relativePath}`);\n}\n\n/**\n * Add the module's `notFound` message to an existing utils/locales.json, or\n * create the file. Existing keys win; a file that is not a JSON object, or\n * that renames its group, is left for the app to update by hand.\n */\nasync function registerNotificationLocales(skipped: string[]) {\n  const localesPath = srcPath(\"app/notifications/utils/locales.json\");\n\n  if (!(await fileExistsAsync(localesPath))) {\n    await writeModuleFile(\"utils/locales.json\", notificationLocalesStub, skipped);\n    return;\n  }\n\n  const defaults = JSON.parse(notificationLocalesStub) as Record<string, unknown>;\n  let dictionary: Record<string, unknown>;\n\n  try {\n    const parsed: unknown = JSON.parse(await getFileAsync(localesPath));\n\n    if (parsed === null || Array.isArray(parsed) || typeof parsed !== \"object\") throw new Error();\n\n    dictionary = parsed as Record<string, unknown>;\n  } catch {\n    console.log(\n      `${colors.yellowBright(\"notifications\")} locale JSON is invalid; add notFound to src/app/notifications/utils/locales.json manually.`,\n    );\n    return;\n  }\n\n  // A root `$group` renames the file's namespace, so the service's\n  // t(\"notifications.notFound\") would not find a key merged here.\n  if (dictionary.$group !== undefined && dictionary.$group !== \"notifications\") {\n    console.log(\n      `${colors.yellowBright(\"notifications\")} locale JSON declares a different $group; add notifications.notFound manually.`,\n    );\n    return;\n  }\n\n  const missing = Object.keys(defaults).filter((key) => dictionary[key] === undefined);\n\n  if (missing.length === 0) return;\n\n  for (const key of missing) dictionary[key] = defaults[key];\n\n  await putFileAsync(localesPath, `${JSON.stringify(dictionary, null, 2)}\\n`);\n  console.log(\n    `${colors.green(\"✓\")} Added ${missing.join(\", \")} to src/app/notifications/utils/locales.json`,\n  );\n}\n\n/**\n * The config ejected just before this runs imports the 5.30 model path. In an\n * app scaffolded by 5.29 the model is still at the module root, so point the\n * import there instead of at a file that does not exist.\n */\nasync function pointConfigAtLegacyModel() {\n  const configPath = srcPath(\"config/notifications.ts\");\n\n  if (!(await fileExistsAsync(configPath))) return;\n\n  const config = await getFileAsync(configPath);\n\n  if (!config.includes(`\"${MODEL_IMPORT}\"`)) return;\n\n  await putFileAsync(configPath, config.replace(`\"${MODEL_IMPORT}\"`, `\"${LEGACY_MODEL_IMPORT}\"`));\n  console.log(\n    `${colors.green(\"✓\")} src/config/notifications.ts imports the existing model at ${LEGACY_MODEL_IMPORT}`,\n  );\n}\n\nasync function completeNotificationsInstallation(_options: CommandActionData) {\n  const modelPath = srcPath(\"app/notifications/models/notification/notification.model.ts\");\n  // Where 5.29 and earlier wrote the model.\n  const legacyModelPath = srcPath(\"app/notifications/notification.model.ts\");\n\n  // The model file is the sentinel for \"notifications already scaffolded\" —\n  // its presence means the migration was created too (timestamped, so we must\n  // not re-emit a duplicate on a second run).\n  if (await fileExistsAsync(legacyModelPath)) {\n    if (!(await fileExistsAsync(modelPath))) await pointConfigAtLegacyModel();\n\n    console.log(\n      `${colors.yellowBright(\"src/app/notifications\")} already scaffolded (5.29 layout), skipping...`,\n    );\n    return;\n  }\n\n  if (await fileExistsAsync(modelPath)) {\n    console.log(`${colors.yellowBright(\"src/app/notifications\")} already scaffolded, skipping...`);\n    return;\n  }\n\n  const skipped: string[] = [];\n  // An app that already has its own notifications module may keep its model\n  // anywhere in it; a second Notification model would collide with it.\n  const moduleExists = await directoryExistsAsync(srcPath(\"app/notifications\"));\n\n  // 1. Model + migration under models/notification/, like every other module.\n  //    The migration's MM-DD-YYYY_HH-MM-SS prefix lets cascade infer its\n  //    createdAt and order it deterministically.\n  if (moduleExists) {\n    console.log(\n      `${colors.yellowBright(\"src/app/notifications\")} already exists: not adding a Notification model or migration. config/notifications.ts must import your model.`,\n    );\n  } else {\n    await writeModuleFile(\n      \"models/notification/notification.model.ts\",\n      notificationModelStub,\n      skipped,\n    );\n    await writeModuleFile(\n      `models/notification/migrations/${migrationTimestamp()}-notification.migration.ts`,\n      notificationMigrationStub,\n      skipped,\n    );\n  }\n\n  // 2. One responsibility per file: output resource, validated list query,\n  //    guarded request type, service, translations.\n  await writeModuleFile(\"resources/notification.resource.ts\", notificationResourceStub, skipped);\n  await writeModuleFile(\n    \"schema/list-notifications.schema.ts\",\n    listNotificationsSchemaStub,\n    skipped,\n  );\n  await writeModuleFile(\n    \"types/notifications-request.type.ts\",\n    notificationsRequestTypeStub,\n    skipped,\n  );\n  await writeModuleFile(\n    \"services/mark-notification-read.service.ts\",\n    markNotificationReadServiceStub,\n    skipped,\n  );\n  await registerNotificationLocales(skipped);\n\n  // 3. HTTP surface — list, unread count, mark read, mark all read, one\n  //    controller per file, gated by authMiddleware in routes.ts.\n  const withSpecs = await fileExistsAsync(srcPath(\"test-setup.ts\"));\n  if (withSpecs) {\n    await writeModuleFile(\"tests/notifications.fixture.ts\", notificationTestFixtureStub, skipped);\n  }\n\n  for (const controller of notificationControllers) {\n    await writeModuleFile(`controllers/${controller.file}.ts`, controller.stub, skipped);\n\n    if (withSpecs) {\n      await writeModuleFile(\n        `controllers/${controller.file}.spec.ts`,\n        notificationControllerSpecStub(controller.method, controller.path),\n        skipped,\n      );\n    }\n  }\n\n  await writeModuleFile(\"routes.ts\", notificationRoutesStub, skipped);\n\n  if (skipped.length > 0) {\n    console.log(\n      `${colors.yellowBright(\"Kept your existing files\")} (not overwritten): ${skipped\n        .map((file) => `src/app/notifications/${file}`)\n        .join(\", \")}`,\n    );\n  }\n}\n\nexport const notificationsFeature: FeatureDefinition = {\n  description:\n    \"Installs @warlock.js/notifications — multi-channel notifications (mail + in-app database). Pulls the mail feature, ejects config/notifications.ts, and scaffolds src/app/notifications: the Notification model + migration, a resource, a validated list query, and the recipient-scoped list / unread-count / mark-read / mark-all-read endpoints (one controller per file, a spec each when tests are set up)\",\n  // The ejected config wires a `mail` channel by default (needs nodemailer,\n  // via the `mail` feature); the scaffolded routes are gated by\n  // `authMiddleware`, so `@warlock.js/auth` is pulled in too.\n  requires: [\"mail\"],\n  dependencies: {\n    \"@warlock.js/notifications\": INSTALLED_WARLOCK_VERSION,\n    \"@warlock.js/auth\": INSTALLED_WARLOCK_VERSION,\n  },\n  ejectConfig: {\n    content: notificationsConfigStub,\n    name: \"notifications\",\n  },\n  onExecuting: completeNotificationsInstallation,\n};\n"],"mappings":"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"}

package/esm/generations/features/process.feature.mjs

@@ -0,0 +1,65 @@
+import { srcPath } from "../../utils/paths.mjs";
+import "../../utils/index.mjs";
+import { recordSkippedFile } from "../generation-run.mjs";
+import { fileExistsAsync, getFileAsync, putFileAsync } from "../generation-fs.mjs";
+import { INSTALLED_WARLOCK_VERSION } from "./types.mjs";
+
+//#region ../../packages/core/src/generations/features/process.feature.ts
+const processConfig = `import { rootPath } from "@warlock.js/core";
+import type { SupervisorOptions } from "@warlock.js/process";
+
+const processConfig = {
+  owner: "app",
+  registry: rootPath("storage/processes/registry.json"),
+  defaults: { timeoutMs: 300_000, memoryBytes: 512 * 1024 * 1024 },
+} satisfies SupervisorOptions;
+
+export default processConfig;
+`;
+const processes = `import { supervisor } from "@warlock.js/process";
+import processConfig from "../../config/process";
+
+export const processes = supervisor(processConfig);
+`;
+const lifecycle = `import { Application } from "@warlock.js/core";
+import { processes } from "./index";
+
+Application.onValidateBoot(async () => {
+  await processes.recover();
+});
+Application.onShutdown(async () => {
+  await processes.stopAll();
+});
+`;
+async function createOnce(file, content) {
+	if (await fileExistsAsync(file)) {
+		recordSkippedFile(file, "exists");
+		return;
+	}
+	await putFileAsync(file, content);
+}
+const processFeature = {
+	description: "App-owned processes and terminals; creates typed config, recovery and graceful shutdown hooks, and a development process panel.",
+	dependencies: { "@warlock.js/process": INSTALLED_WARLOCK_VERSION },
+	ejectConfig: {
+		name: "process",
+		content: processConfig
+	},
+	async onExecuting() {
+		await createOnce(srcPath("app/processes/index.ts"), processes);
+		await createOnce(srcPath("app/processes/lifecycle.ts"), lifecycle);
+		const main = srcPath("app/main.ts");
+		const content = await fileExistsAsync(main) ? await getFileAsync(main) : "";
+		if (!/import\s*["']\.\/processes\/lifecycle["']/.test(content)) await putFileAsync(main, `import "./processes/lifecycle";\n${content}`);
+		else recordSkippedFile(main, "exists");
+		await createOnce(srcPath("app/processes/devtools.ts"), `import { processes } from "./index";
+
+export const processPanel = { list: () => processes.list() };
+`);
+		console.log("Process supervision configured. Next: set a unique owner and registry per app instance in src/config/process.ts, then import { processes } from your app/processes module and await processes.spawn(...). Install devtools with warlock add devtools to view the Processes panel. Install node-pty separately for spawnPty(). macOS also needs the shipped identity helper compiled and WARLOCK_PROCESS_IDENTITY_HELPER configured; see the process package README.");
+	}
+};
+
+//#endregion
+export { processFeature };
+//# sourceMappingURL=process.feature.mjs.map

package/esm/generations/features/process.feature.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"process.feature.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/generations/features/process.feature.ts"],"sourcesContent":["import { srcPath } from \"../../utils\";\nimport { fileExistsAsync, getFileAsync, putFileAsync, recordSkippedFile } from \"../generation-fs\";\nimport { type FeatureDefinition, INSTALLED_WARLOCK_VERSION } from \"./types\";\n\nconst processConfig = `import { rootPath } from \"@warlock.js/core\";\nimport type { SupervisorOptions } from \"@warlock.js/process\";\n\nconst processConfig = {\n  owner: \"app\",\n  registry: rootPath(\"storage/processes/registry.json\"),\n  defaults: { timeoutMs: 300_000, memoryBytes: 512 * 1024 * 1024 },\n} satisfies SupervisorOptions;\n\nexport default processConfig;\n`;\n\nconst processes = `import { supervisor } from \"@warlock.js/process\";\nimport processConfig from \"../../config/process\";\n\nexport const processes = supervisor(processConfig);\n`;\n\nconst lifecycle = `import { Application } from \"@warlock.js/core\";\nimport { processes } from \"./index\";\n\nApplication.onValidateBoot(async () => {\n  await processes.recover();\n});\nApplication.onShutdown(async () => {\n  await processes.stopAll();\n});\n`;\n\nasync function createOnce(file: string, content: string): Promise<void> {\n  if (await fileExistsAsync(file)) {\n    recordSkippedFile(file, \"exists\");\n    return;\n  }\n  await putFileAsync(file, content);\n}\n\nexport const processFeature: FeatureDefinition = {\n  description:\n    \"App-owned processes and terminals; creates typed config, recovery and graceful shutdown hooks, and a development process panel.\",\n  dependencies: { \"@warlock.js/process\": INSTALLED_WARLOCK_VERSION },\n  ejectConfig: { name: \"process\", content: processConfig },\n  async onExecuting() {\n    await createOnce(srcPath(\"app/processes/index.ts\"), processes);\n    await createOnce(srcPath(\"app/processes/lifecycle.ts\"), lifecycle);\n    const main = srcPath(\"app/main.ts\");\n    const content = (await fileExistsAsync(main)) ? await getFileAsync(main) : \"\";\n    if (!/import\\s*[\"']\\.\\/processes\\/lifecycle[\"']/.test(content)) {\n      await putFileAsync(main, `import \"./processes/lifecycle\";\\n${content}`);\n    } else recordSkippedFile(main, \"exists\");\n    // Devtools discovers this source only in development and only when installed.\n    await createOnce(\n      srcPath(\"app/processes/devtools.ts\"),\n      `import { processes } from \"./index\";\n\nexport const processPanel = { list: () => processes.list() };\n`,\n    );\n    console.log(\n      \"Process supervision configured. Next: set a unique owner and registry per app instance in src/config/process.ts, then import { processes } from your app/processes module and await processes.spawn(...). Install devtools with warlock add devtools to view the Processes panel. Install node-pty separately for spawnPty(). macOS also needs the shipped identity helper compiled and WARLOCK_PROCESS_IDENTITY_HELPER configured; see the process package README.\",\n    );\n  },\n};\n"],"mappings":";;;;;;;AAIA,MAAM,gBAAgB;;;;;;;;;;;AAYtB,MAAM,YAAY;;;;;AAMlB,MAAM,YAAY;;;;;;;;;;AAWlB,eAAe,WAAW,MAAc,SAAgC;CACtE,IAAI,MAAM,gBAAgB,IAAI,GAAG;EAC/B,kBAAkB,MAAM,QAAQ;EAChC;CACF;CACA,MAAM,aAAa,MAAM,OAAO;AAClC;AAEA,MAAa,iBAAoC;CAC/C,aACE;CACF,cAAc,EAAE,uBAAuB,0BAA0B;CACjE,aAAa;EAAE,MAAM;EAAW,SAAS;CAAc;CACvD,MAAM,cAAc;EAClB,MAAM,WAAW,QAAQ,wBAAwB,GAAG,SAAS;EAC7D,MAAM,WAAW,QAAQ,4BAA4B,GAAG,SAAS;EACjE,MAAM,OAAO,QAAQ,aAAa;EAClC,MAAM,UAAW,MAAM,gBAAgB,IAAI,IAAK,MAAM,aAAa,IAAI,IAAI;EAC3E,IAAI,CAAC,4CAA4C,KAAK,OAAO,GAC3D,MAAM,aAAa,MAAM,oCAAoC,SAAS;OACjE,kBAAkB,MAAM,QAAQ;EAEvC,MAAM,WACJ,QAAQ,2BAA2B,GACnC;;;CAIF;EACA,QAAQ,IACN,qcACF;CACF;AACF"}

package/esm/generations/features/shared/merge-web-sitemap-config.mjs

@@ -1,4 +1,5 @@
-import ts from "typescript";
+import { isExportAssignment, isIdentifier, isNumericLiteral, isObjectLiteralExpression, isPropertyAssignment, isShorthandPropertyAssignment, isStringLiteral, isVariableStatement, nameNode, parseSourceFile, topLevelDeclarations, valueText } from "../../../tooling/syntax/ast.mjs";
+import { parseSync } from "oxc-parser";
 
 //#region ../../packages/core/src/generations/features/shared/merge-web-sitemap-config.ts
 /**
@@ -35,12 +36,11 @@ import ts from "typescript";
 * @returns What happened, and the new text when there is any.
 */
 function mergeWebSitemapConfig(source) {
-	const sourceFile = ts.createSourceFile("web.ts", source, ts.ScriptTarget.ESNext, true, ts.ScriptKind.TS);
-	const objectLiteral = findExportedConfigObjectLiteral(sourceFile);
+	const objectLiteral = findExportedConfigObjectLiteral(parseSourceFile("web.ts", source));
 	if (!objectLiteral) return { status: "unrecognised" };
 	if (hasTopLevelSitemapProperty(objectLiteral)) return { status: "already-present" };
-	const bodyStart = objectLiteral.getStart(sourceFile) + 1;
-	const closingBraceIndex = objectLiteral.getEnd() - 1;
+	const bodyStart = objectLiteral.start + 1;
+	const closingBraceIndex = objectLiteral.end - 1;
 	const body = source.slice(bodyStart, closingBraceIndex);
 	const indentMatch = /\n([ \t]*)\S/.exec(body);
 	const indent = indentMatch ? indentMatch[1] : "  ";
@@ -55,14 +55,7 @@ function mergeWebSitemapConfig(source) {
 }
 /** Whether TEXT fails to parse as TypeScript source. */
 function hasSyntaxErrors(text) {
-	const { diagnostics } = ts.transpileModule(text, {
-		compilerOptions: {
-			module: ts.ModuleKind.ESNext,
-			target: ts.ScriptTarget.ESNext
-		},
-		reportDiagnostics: true
-	});
-	return Boolean(diagnostics && diagnostics.length > 0);
+	return parseSync("web.ts", text).errors.length > 0;
 }
 /**
 * Whether the exported config object literal already has a `sitemap`
@@ -71,11 +64,11 @@ function hasSyntaxErrors(text) {
 * and must not block adding the top-level one.
 */
 function hasTopLevelSitemapProperty(objectLiteral) {
-	return objectLiteral.properties.some((property) => (ts.isPropertyAssignment(property) || ts.isShorthandPropertyAssignment(property)) && propertyKeyName(property.name) === "sitemap");
+	return objectLiteral.properties.some((property) => (isPropertyAssignment(property) || isShorthandPropertyAssignment(property)) && propertyKeyName(nameNode(property)) === "sitemap");
 }
 /** The literal text of a property name node, when it is one of the plain shapes we care about. */
 function propertyKeyName(name) {
-	if (ts.isIdentifier(name) || ts.isStringLiteral(name) || ts.isNumericLiteral(name)) return name.text;
+	if (isIdentifier(name) || isStringLiteral(name) || isNumericLiteral(name)) return valueText(name);
 }
 /**
 * Find the object literal a source file's default export ultimately points
@@ -83,15 +76,15 @@ function propertyKeyName(name) {
 * file.
 */
 function findExportedConfigObjectLiteral(sourceFile) {
-	const exportAssignment = sourceFile.statements.find((statement) => ts.isExportAssignment(statement) && !statement.isExportEquals);
+	const exportAssignment = sourceFile.body.find((statement) => isExportAssignment(statement));
 	if (!exportAssignment) return void 0;
-	const { expression } = exportAssignment;
-	if (ts.isObjectLiteralExpression(expression)) return expression;
-	if (!ts.isIdentifier(expression)) return void 0;
-	const identifier = expression.text;
-	for (const statement of sourceFile.statements) {
-		if (!ts.isVariableStatement(statement)) continue;
-		for (const declaration of statement.declarationList.declarations) if (ts.isIdentifier(declaration.name) && declaration.name.text === identifier && declaration.initializer && ts.isObjectLiteralExpression(declaration.initializer)) return declaration.initializer;
+	const expression = exportAssignment.declaration;
+	if (isObjectLiteralExpression(expression)) return expression;
+	if (!isIdentifier(expression)) return void 0;
+	const identifier = valueText(expression);
+	for (const statement of topLevelDeclarations(sourceFile)) {
+		if (!isVariableStatement(statement)) continue;
+		for (const declaration of statement.declarations) if (isIdentifier(nameNode(declaration)) && valueText(declaration.id) === identifier && declaration.init && isObjectLiteralExpression(declaration.init)) return declaration.init;
 	}
 }
 /**