@warlock.js/core 5.31.0 → 5.33.0

package/esm/upgrade/run-upgrade.mjs

@@ -5,7 +5,7 @@ import { CODEMODS } from "./codemods/index.mjs";
 import { unifiedDiff } from "./diff.mjs";
 import { UPGRADE_NOTES } from "./notes.mjs";
 import path from "node:path";
-import { existsSync, readFileSync, writeFileSync } from "node:fs";
+import { existsSync, mkdirSync, readFileSync, readdirSync, rmSync, writeFileSync } from "node:fs";
 import glob from "fast-glob";
 
 //#region ../../packages/core/src/upgrade/run-upgrade.ts
@@ -64,6 +64,15 @@ async function runUpgrade(options) {
 		relativePath: (sourceFile) => relativeOf.get(sourceFile) ?? path.relative(root, sourceFile.getFilePath()).split(path.sep).join("/"),
 		text: {
 			read: (file) => textFiles.read(file),
+			list: () => readdirSync(root),
+			remove: (file, change) => {
+				textFiles.remove(file);
+				if (activeCodemod) applied.push({
+					codemod: activeCodemod.id,
+					file,
+					...change
+				});
+			},
 			write: (file, content, change) => {
 				textFiles.write(file, content);
 				if (activeCodemod) applied.push({
@@ -143,8 +152,15 @@ async function runUpgrade(options) {
 	});
 	for (const change of textFiles.changes()) changes.push(change);
 	changes.sort((left, right) => left.file.localeCompare(right.file));
-	if (!options.dryRun) for (const change of changes) writeFileSync(path.join(root, change.file), change.after);
-	const packageJsonChanged = changes.some((change) => change.file === "package.json" && applied.some((item) => item.codemod === "warlock-versions" && item.file === "package.json"));
+	if (!options.dryRun) for (const change of changes) {
+		const target = path.join(root, change.file);
+		if (change.after === void 0) rmSync(target, { force: true });
+		else {
+			mkdirSync(path.dirname(target), { recursive: true });
+			writeFileSync(target, change.after);
+		}
+	}
+	const packageJsonChanged = changes.some((change) => change.file === "package.json");
 	return {
 		from,
 		to,
@@ -154,7 +170,7 @@ async function runUpgrade(options) {
 		manual,
 		notes: UPGRADE_NOTES.filter((note) => compareVersions(note.version, from) > 0 && compareVersions(note.version, to) <= 0),
 		changedFiles: changes.map((change) => change.file),
-		diff: changes.map((change) => unifiedDiff(change.file, change.before, change.after)).join(""),
+		diff: changes.map((change) => unifiedDiff(change.file, change.before, change.after ?? "")).join(""),
 		...packageJsonChanged && { installHint: getInstallCommand(await detectPackageManager(root)) }
 	};
 }
@@ -233,14 +249,17 @@ function createTextFiles(root) {
 		write: (file, content) => {
 			entry(file).current = content;
 		},
-		changes: () => [...files.entries()].filter(([, value]) => value.current !== void 0 && value.current !== value.before).map(([file, value]) => ({
+		remove: (file) => {
+			entry(file).current = void 0;
+		},
+		changes: () => [...files.entries()].filter(([, value]) => value.current !== value.before).map(([file, value]) => ({
 			file,
 			before: value.before ?? "",
-			after: value.current ?? ""
+			after: value.current
 		}))
 	};
 }
 
 //#endregion
-export { UpgradeUsageError, runUpgrade };
+export { UpgradeUsageError, detectInstalledVersion, runUpgrade };
 //# sourceMappingURL=run-upgrade.mjs.map

package/esm/upgrade/run-upgrade.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"run-upgrade.mjs","names":[],"sources":["../../../../../../../../packages/core/src/upgrade/run-upgrade.ts"],"sourcesContent":["import glob from \"fast-glob\";\nimport { existsSync, readFileSync, writeFileSync } from \"node:fs\";\nimport path from \"node:path\";\nimport { detectPackageManager, getInstallCommand } from \"../updater/package-manager\";\nimport { CODEMODS } from \"./codemods\";\nimport { unifiedDiff } from \"./diff\";\nimport { loadTsMorph } from \"./load-ts-morph\";\nimport { UPGRADE_NOTES } from \"./notes\";\nimport type {\n  AppliedChange,\n  Codemod,\n  CodemodContext,\n  ManualItem,\n  SourceEdit,\n  SourceFile,\n  TextFiles,\n  TsMorphModule,\n  UpgradeResult,\n} from \"./types\";\nimport { compareVersions, normalizeVersion, parseVersion } from \"./version\";\n\nexport type RunUpgradeOptions = {\n  /** App root. Defaults to the current directory. */\n  root?: string;\n  /** Target version, e.g. `5.31` or `5.31.0`. */\n  to: string;\n  /** Version upgrading from; detected from the installed `@warlock.js/core` when omitted. */\n  from?: string;\n  /** Compute and report everything, write nothing. */\n  dryRun?: boolean;\n  /** Override the codemod list (tests). */\n  codemods?: readonly Codemod[];\n  /** Override how ts-morph is loaded (tests). */\n  loadTsMorph?: (root: string) => Promise<TsMorphModule>;\n};\n\n/** Thrown for a request the command cannot act on (bad versions, nothing to detect). */\nexport class UpgradeUsageError extends Error {\n  public override readonly name = \"UpgradeUsageError\";\n}\n\n/**\n * Apply the mechanical edits for every breaking change between two releases\n * and list what needs a decision. Writes nothing with `dryRun`.\n */\nexport async function runUpgrade(options: RunUpgradeOptions): Promise<UpgradeResult> {\n  const root = path.resolve(options.root ?? process.cwd());\n  const to = toVersion(options.to);\n  const from = options.from ? toVersion(options.from) : detectInstalledVersion(root);\n\n  if (compareVersions(from, to) >= 0) {\n    throw new UpgradeUsageError(notNewerMessage(from, to, options.from !== undefined));\n  }\n\n  const selected = (options.codemods ?? CODEMODS).filter(\n    (codemod) =>\n      codemod.version === \"target\" ||\n      (compareVersions(codemod.version, from) > 0 && compareVersions(codemod.version, to) <= 0),\n  );\n\n  const tsMorph = await (options.loadTsMorph ?? loadTsMorph)(root);\n  const project = new tsMorph.Project({\n    skipAddingFilesFromTsConfig: true,\n    skipFileDependencyResolution: true,\n    compilerOptions: { jsx: tsMorph.ts.JsxEmit.Preserve, allowJs: false },\n  });\n\n  const relativePaths = await glob(\"src/**/*.{ts,tsx}\", {\n    cwd: root,\n    ignore: [\"**/node_modules/**\", \"**/dist/**\", \"**/.warlock/**\", \"**/*.d.ts\"],\n    dot: false,\n  });\n  relativePaths.sort();\n\n  const originals = new Map<string, string>();\n  const sourceFiles: SourceFile[] = [];\n  for (const relative of relativePaths) {\n    const content = readFileSync(path.join(root, relative), \"utf8\");\n    originals.set(relative, content);\n    sourceFiles.push(\n      project.createSourceFile(path.join(root, relative), content, { overwrite: true }),\n    );\n  }\n\n  const relativeOf = new Map<SourceFile, string>(\n    sourceFiles.map((sourceFile, index) => [sourceFile, relativePaths[index] ?? \"\"]),\n  );\n\n  const applied: AppliedChange[] = [];\n  const manual: ManualItem[] = [];\n  const textFiles = createTextFiles(root);\n  let activeCodemod: Codemod | undefined;\n\n  const text: TextFiles = {\n    read: (file) => textFiles.read(file),\n    write: (file, content, change) => {\n      textFiles.write(file, content);\n      if (activeCodemod) {\n        applied.push({ codemod: activeCodemod.id, file, ...change });\n      }\n    },\n  };\n\n  const context: CodemodContext = {\n    tsMorph,\n    sourceFiles,\n    relativePath: (sourceFile) =>\n      relativeOf.get(sourceFile) ??\n      path.relative(root, sourceFile.getFilePath()).split(path.sep).join(\"/\"),\n    text,\n    targetVersion: to,\n  };\n\n  const summary: UpgradeResult[\"codemods\"] = [];\n\n  for (const codemod of selected) {\n    activeCodemod = codemod;\n    const appliedBefore = applied.length;\n    const output = codemod.run(context);\n\n    for (const finding of output.manual) {\n      manual.push({ ...finding, codemod: codemod.id, skill: codemod.skill });\n    }\n\n    const byFile = new Map<string, SourceEdit[]>();\n    for (const edit of output.edits) {\n      const list = byFile.get(edit.file) ?? [];\n      list.push(edit);\n      byFile.set(edit.file, list);\n    }\n\n    for (const [file, edits] of byFile) {\n      const sourceFile = sourceFiles[relativePaths.indexOf(file)];\n      if (!sourceFile) continue;\n\n      let content = sourceFile.getFullText();\n      let lowestStart = Number.POSITIVE_INFINITY;\n      for (const edit of [...edits].sort((left, right) => right.start - left.start)) {\n        // Overlapping edits (one inside another) would corrupt the file: keep the outer one.\n        if (edit.end > lowestStart) {\n          manual.push({\n            codemod: codemod.id,\n            skill: codemod.skill,\n            file,\n            line: edit.line,\n            hint: `Not edited automatically (overlaps another change): ${edit.description}. Run the upgrade again after reviewing.`,\n          });\n          continue;\n        }\n        content = content.slice(0, edit.start) + edit.text + content.slice(edit.end);\n        lowestStart = edit.start;\n        applied.push({ codemod: codemod.id, file, line: edit.line, description: edit.description });\n      }\n\n      sourceFile.replaceWithText(content);\n    }\n\n    summary.push({\n      id: codemod.id,\n      version: codemod.version === \"target\" ? to : codemod.version,\n      title: codemod.title,\n      applied: applied.length - appliedBefore,\n      manual: manual.filter((item) => item.codemod === codemod.id).length,\n    });\n  }\n  activeCodemod = undefined;\n\n  applied.sort(byFileAndLine);\n  manual.sort(byFileAndLine);\n\n  const changes: { file: string; before: string; after: string }[] = [];\n  sourceFiles.forEach((sourceFile, index) => {\n    const file = relativePaths[index];\n    if (file === undefined) return;\n    const before = originals.get(file) ?? \"\";\n    const after = sourceFile.getFullText();\n    if (before !== after) changes.push({ file, before, after });\n  });\n  for (const change of textFiles.changes()) changes.push(change);\n  changes.sort((left, right) => left.file.localeCompare(right.file));\n\n  if (!options.dryRun) {\n    for (const change of changes) writeFileSync(path.join(root, change.file), change.after);\n  }\n\n  const packageJsonChanged = changes.some(\n    (change) =>\n      change.file === \"package.json\" &&\n      applied.some((item) => item.codemod === \"warlock-versions\" && item.file === \"package.json\"),\n  );\n\n  return {\n    from,\n    to,\n    dryRun: options.dryRun === true,\n    codemods: summary,\n    applied,\n    manual,\n    notes: UPGRADE_NOTES.filter(\n      (note) => compareVersions(note.version, from) > 0 && compareVersions(note.version, to) <= 0,\n    ),\n    changedFiles: changes.map((change) => change.file),\n    diff: changes.map((change) => unifiedDiff(change.file, change.before, change.after)).join(\"\"),\n    ...(packageJsonChanged && {\n      installHint: getInstallCommand(await detectPackageManager(root)),\n    }),\n  };\n}\n\n/**\n * Explain why `--to` is not newer than the starting version. The usual cause\n * is running the command after installing the new release: the starting\n * version is read from the installed `@warlock.js/core`, which is then already\n * the target, so the command needs `--from`.\n */\nfunction notNewerMessage(from: string, to: string, fromWasPassed: boolean): string {\n  if (fromWasPassed) {\n    return `--from ${from} is not older than --to ${to}. Pass the version this app is upgrading from.`;\n  }\n\n  const example = `warlock upgrade --from ${previousMinor(to)} --to ${to}`;\n\n  if (compareVersions(from, to) === 0) {\n    return `The installed @warlock.js/core is already ${from}, the --to version, so the version this app is upgrading from cannot be detected. Pass it with --from <previous version>, e.g. ${example}.`;\n  }\n\n  return `This app is already on ${from}; --to ${to} is not newer. If the detected version is wrong, pass --from <previous version>, e.g. ${example}.`;\n}\n\n/** `5.31.0` → `5.30`. A major's first release has no minor to step back to, so it gets a placeholder. */\nfunction previousMinor(version: string): string {\n  const [major, minor] = parseVersion(version) ?? [0, 0, 0];\n\n  return minor > 0 ? `${major}.${minor - 1}` : \"<previous version>\";\n}\n\nfunction toVersion(value: string): string {\n  try {\n    return normalizeVersion(value);\n  } catch (error) {\n    throw new UpgradeUsageError(error instanceof Error ? error.message : String(error));\n  }\n}\n\n/** The installed `@warlock.js/core`, or the version its package.json range names. */\nexport function detectInstalledVersion(root: string): string {\n  const installed = path.join(root, \"node_modules\", \"@warlock.js\", \"core\", \"package.json\");\n  if (existsSync(installed)) {\n    const version = (JSON.parse(readFileSync(installed, \"utf8\")) as { version?: unknown }).version;\n    if (typeof version === \"string\" && parseVersion(version))\n      return normalizeVersion(stripRange(version));\n  }\n\n  const manifest = path.join(root, \"package.json\");\n  if (existsSync(manifest)) {\n    const pkg = JSON.parse(readFileSync(manifest, \"utf8\")) as {\n      dependencies?: Record<string, unknown>;\n      devDependencies?: Record<string, unknown>;\n    };\n    const spec =\n      pkg.dependencies?.[\"@warlock.js/core\"] ?? pkg.devDependencies?.[\"@warlock.js/core\"];\n    const parsed = typeof spec === \"string\" ? parseVersion(spec) : undefined;\n    if (parsed) return parsed.join(\".\");\n  }\n\n  throw new UpgradeUsageError(\n    \"Could not tell which Warlock version this app is on (no installed @warlock.js/core). Pass it with --from, e.g. --from 5.29.\",\n  );\n}\n\nfunction stripRange(version: string): string {\n  return (parseVersion(version) ?? [0, 0, 0]).join(\".\");\n}\n\nfunction byFileAndLine(\n  left: { file: string; line: number },\n  right: { file: string; line: number },\n) {\n  return left.file.localeCompare(right.file) || left.line - right.line;\n}\n\n/** Non-TypeScript files a codemod reads and rewrites, buffered until the end. */\nfunction createTextFiles(root: string) {\n  const files = new Map<string, { before: string | undefined; current: string | undefined }>();\n\n  const entry = (file: string) => {\n    let existing = files.get(file);\n    if (!existing) {\n      const absolute = path.join(root, file);\n      const content = existsSync(absolute) ? readFileSync(absolute, \"utf8\") : undefined;\n      existing = { before: content, current: content };\n      files.set(file, existing);\n    }\n    return existing;\n  };\n\n  return {\n    read: (file: string) => entry(file).current,\n    write: (file: string, content: string) => {\n      entry(file).current = content;\n    },\n    changes: () =>\n      [...files.entries()]\n        .filter(([, value]) => value.current !== undefined && value.current !== value.before)\n        .map(([file, value]) => ({ file, before: value.before ?? \"\", after: value.current ?? \"\" })),\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"run-upgrade.mjs","names":[],"sources":["../../../../../../../../packages/core/src/upgrade/run-upgrade.ts"],"sourcesContent":["import glob from \"fast-glob\";\nimport { existsSync, mkdirSync, readdirSync, readFileSync, rmSync, writeFileSync } from \"node:fs\";\nimport path from \"node:path\";\nimport { detectPackageManager, getInstallCommand } from \"../updater/package-manager\";\nimport { CODEMODS } from \"./codemods\";\nimport { unifiedDiff } from \"./diff\";\nimport { loadTsMorph } from \"./load-ts-morph\";\nimport { UPGRADE_NOTES } from \"./notes\";\nimport type {\n  AppliedChange,\n  Codemod,\n  CodemodContext,\n  ManualItem,\n  SourceEdit,\n  SourceFile,\n  TextFiles,\n  TsMorphModule,\n  UpgradeResult,\n} from \"./types\";\nimport { compareVersions, normalizeVersion, parseVersion } from \"./version\";\n\nexport type RunUpgradeOptions = {\n  /** App root. Defaults to the current directory. */\n  root?: string;\n  /** Target version, e.g. `5.31` or `5.31.0`. */\n  to: string;\n  /** Version upgrading from; detected from the installed `@warlock.js/core` when omitted. */\n  from?: string;\n  /** Compute and report everything, write nothing. */\n  dryRun?: boolean;\n  /** Override the codemod list (tests). */\n  codemods?: readonly Codemod[];\n  /** Override how ts-morph is loaded (tests). */\n  loadTsMorph?: (root: string) => Promise<TsMorphModule>;\n};\n\n/** Thrown for a request the command cannot act on (bad versions, nothing to detect). */\nexport class UpgradeUsageError extends Error {\n  public override readonly name = \"UpgradeUsageError\";\n}\n\n/**\n * Apply the mechanical edits for every breaking change between two releases\n * and list what needs a decision. Writes nothing with `dryRun`.\n */\nexport async function runUpgrade(options: RunUpgradeOptions): Promise<UpgradeResult> {\n  const root = path.resolve(options.root ?? process.cwd());\n  const to = toVersion(options.to);\n  const from = options.from ? toVersion(options.from) : detectInstalledVersion(root);\n\n  if (compareVersions(from, to) >= 0) {\n    throw new UpgradeUsageError(notNewerMessage(from, to, options.from !== undefined));\n  }\n\n  const selected = (options.codemods ?? CODEMODS).filter(\n    (codemod) =>\n      codemod.version === \"target\" ||\n      (compareVersions(codemod.version, from) > 0 && compareVersions(codemod.version, to) <= 0),\n  );\n\n  const tsMorph = await (options.loadTsMorph ?? loadTsMorph)(root);\n  const project = new tsMorph.Project({\n    skipAddingFilesFromTsConfig: true,\n    skipFileDependencyResolution: true,\n    compilerOptions: { jsx: tsMorph.ts.JsxEmit.Preserve, allowJs: false },\n  });\n\n  const relativePaths = await glob(\"src/**/*.{ts,tsx}\", {\n    cwd: root,\n    ignore: [\"**/node_modules/**\", \"**/dist/**\", \"**/.warlock/**\", \"**/*.d.ts\"],\n    dot: false,\n  });\n  relativePaths.sort();\n\n  const originals = new Map<string, string>();\n  const sourceFiles: SourceFile[] = [];\n  for (const relative of relativePaths) {\n    const content = readFileSync(path.join(root, relative), \"utf8\");\n    originals.set(relative, content);\n    sourceFiles.push(\n      project.createSourceFile(path.join(root, relative), content, { overwrite: true }),\n    );\n  }\n\n  const relativeOf = new Map<SourceFile, string>(\n    sourceFiles.map((sourceFile, index) => [sourceFile, relativePaths[index] ?? \"\"]),\n  );\n\n  const applied: AppliedChange[] = [];\n  const manual: ManualItem[] = [];\n  const textFiles = createTextFiles(root);\n  let activeCodemod: Codemod | undefined;\n\n  const text: TextFiles = {\n    read: (file) => textFiles.read(file),\n    list: () => readdirSync(root),\n    remove: (file, change) => {\n      textFiles.remove(file);\n      if (activeCodemod) applied.push({ codemod: activeCodemod.id, file, ...change });\n    },\n    write: (file, content, change) => {\n      textFiles.write(file, content);\n      if (activeCodemod) {\n        applied.push({ codemod: activeCodemod.id, file, ...change });\n      }\n    },\n  };\n\n  const context: CodemodContext = {\n    tsMorph,\n    sourceFiles,\n    relativePath: (sourceFile) =>\n      relativeOf.get(sourceFile) ??\n      path.relative(root, sourceFile.getFilePath()).split(path.sep).join(\"/\"),\n    text,\n    targetVersion: to,\n  };\n\n  const summary: UpgradeResult[\"codemods\"] = [];\n\n  for (const codemod of selected) {\n    activeCodemod = codemod;\n    const appliedBefore = applied.length;\n    const output = codemod.run(context);\n\n    for (const finding of output.manual) {\n      manual.push({ ...finding, codemod: codemod.id, skill: codemod.skill });\n    }\n\n    const byFile = new Map<string, SourceEdit[]>();\n    for (const edit of output.edits) {\n      const list = byFile.get(edit.file) ?? [];\n      list.push(edit);\n      byFile.set(edit.file, list);\n    }\n\n    for (const [file, edits] of byFile) {\n      const sourceFile = sourceFiles[relativePaths.indexOf(file)];\n      if (!sourceFile) continue;\n\n      let content = sourceFile.getFullText();\n      let lowestStart = Number.POSITIVE_INFINITY;\n      for (const edit of [...edits].sort((left, right) => right.start - left.start)) {\n        // Overlapping edits (one inside another) would corrupt the file: keep the outer one.\n        if (edit.end > lowestStart) {\n          manual.push({\n            codemod: codemod.id,\n            skill: codemod.skill,\n            file,\n            line: edit.line,\n            hint: `Not edited automatically (overlaps another change): ${edit.description}. Run the upgrade again after reviewing.`,\n          });\n          continue;\n        }\n        content = content.slice(0, edit.start) + edit.text + content.slice(edit.end);\n        lowestStart = edit.start;\n        applied.push({ codemod: codemod.id, file, line: edit.line, description: edit.description });\n      }\n\n      sourceFile.replaceWithText(content);\n    }\n\n    summary.push({\n      id: codemod.id,\n      version: codemod.version === \"target\" ? to : codemod.version,\n      title: codemod.title,\n      applied: applied.length - appliedBefore,\n      manual: manual.filter((item) => item.codemod === codemod.id).length,\n    });\n  }\n  activeCodemod = undefined;\n\n  applied.sort(byFileAndLine);\n  manual.sort(byFileAndLine);\n\n  const changes: { file: string; before: string; after: string | undefined }[] = [];\n  sourceFiles.forEach((sourceFile, index) => {\n    const file = relativePaths[index];\n    if (file === undefined) return;\n    const before = originals.get(file) ?? \"\";\n    const after = sourceFile.getFullText();\n    if (before !== after) changes.push({ file, before, after });\n  });\n  for (const change of textFiles.changes()) changes.push(change);\n  changes.sort((left, right) => left.file.localeCompare(right.file));\n\n  if (!options.dryRun) {\n    for (const change of changes) {\n      const target = path.join(root, change.file);\n      if (change.after === undefined) rmSync(target, { force: true });\n      else {\n        mkdirSync(path.dirname(target), { recursive: true });\n        writeFileSync(target, change.after);\n      }\n    }\n  }\n\n  const packageJsonChanged = changes.some((change) => change.file === \"package.json\");\n\n  return {\n    from,\n    to,\n    dryRun: options.dryRun === true,\n    codemods: summary,\n    applied,\n    manual,\n    notes: UPGRADE_NOTES.filter(\n      (note) => compareVersions(note.version, from) > 0 && compareVersions(note.version, to) <= 0,\n    ),\n    changedFiles: changes.map((change) => change.file),\n    diff: changes\n      .map((change) => unifiedDiff(change.file, change.before, change.after ?? \"\"))\n      .join(\"\"),\n    ...(packageJsonChanged && {\n      installHint: getInstallCommand(await detectPackageManager(root)),\n    }),\n  };\n}\n\n/**\n * Explain why `--to` is not newer than the starting version. The usual cause\n * is running the command after installing the new release: the starting\n * version is read from the installed `@warlock.js/core`, which is then already\n * the target, so the command needs `--from`.\n */\nfunction notNewerMessage(from: string, to: string, fromWasPassed: boolean): string {\n  if (fromWasPassed) {\n    return `--from ${from} is not older than --to ${to}. Pass the version this app is upgrading from.`;\n  }\n\n  const example = `warlock upgrade --from ${previousMinor(to)} --to ${to}`;\n\n  if (compareVersions(from, to) === 0) {\n    return `The installed @warlock.js/core is already ${from}, the --to version, so the version this app is upgrading from cannot be detected. Pass it with --from <previous version>, e.g. ${example}.`;\n  }\n\n  return `This app is already on ${from}; --to ${to} is not newer. If the detected version is wrong, pass --from <previous version>, e.g. ${example}.`;\n}\n\n/** `5.31.0` → `5.30`. A major's first release has no minor to step back to, so it gets a placeholder. */\nfunction previousMinor(version: string): string {\n  const [major, minor] = parseVersion(version) ?? [0, 0, 0];\n\n  return minor > 0 ? `${major}.${minor - 1}` : \"<previous version>\";\n}\n\nfunction toVersion(value: string): string {\n  try {\n    return normalizeVersion(value);\n  } catch (error) {\n    throw new UpgradeUsageError(error instanceof Error ? error.message : String(error));\n  }\n}\n\n/** The installed `@warlock.js/core`, or the version its package.json range names. */\nexport function detectInstalledVersion(root: string): string {\n  const installed = path.join(root, \"node_modules\", \"@warlock.js\", \"core\", \"package.json\");\n  if (existsSync(installed)) {\n    const version = (JSON.parse(readFileSync(installed, \"utf8\")) as { version?: unknown }).version;\n    if (typeof version === \"string\" && parseVersion(version))\n      return normalizeVersion(stripRange(version));\n  }\n\n  const manifest = path.join(root, \"package.json\");\n  if (existsSync(manifest)) {\n    const pkg = JSON.parse(readFileSync(manifest, \"utf8\")) as {\n      dependencies?: Record<string, unknown>;\n      devDependencies?: Record<string, unknown>;\n    };\n    const spec =\n      pkg.dependencies?.[\"@warlock.js/core\"] ?? pkg.devDependencies?.[\"@warlock.js/core\"];\n    const parsed = typeof spec === \"string\" ? parseVersion(spec) : undefined;\n    if (parsed) return parsed.join(\".\");\n  }\n\n  throw new UpgradeUsageError(\n    \"Could not tell which Warlock version this app is on (no installed @warlock.js/core). Pass it with --from, e.g. --from 5.29.\",\n  );\n}\n\nfunction stripRange(version: string): string {\n  return (parseVersion(version) ?? [0, 0, 0]).join(\".\");\n}\n\nfunction byFileAndLine(\n  left: { file: string; line: number },\n  right: { file: string; line: number },\n) {\n  return left.file.localeCompare(right.file) || left.line - right.line;\n}\n\n/** Non-TypeScript files a codemod reads and rewrites, buffered until the end. */\nfunction createTextFiles(root: string) {\n  const files = new Map<string, { before: string | undefined; current: string | undefined }>();\n\n  const entry = (file: string) => {\n    let existing = files.get(file);\n    if (!existing) {\n      const absolute = path.join(root, file);\n      const content = existsSync(absolute) ? readFileSync(absolute, \"utf8\") : undefined;\n      existing = { before: content, current: content };\n      files.set(file, existing);\n    }\n    return existing;\n  };\n\n  return {\n    read: (file: string) => entry(file).current,\n    write: (file: string, content: string) => {\n      entry(file).current = content;\n    },\n    remove: (file: string) => {\n      entry(file).current = undefined;\n    },\n    changes: () =>\n      [...files.entries()]\n        .filter(([, value]) => value.current !== value.before)\n        .map(([file, value]) => ({ file, before: value.before ?? \"\", after: value.current })),\n  };\n}\n"],"mappings":"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"}

package/esm/use-cases/index.d.mts

@@ -4,4 +4,5 @@ import { broadcastUseCaseResult } from "./use-case-broadcast.mjs";
 import { fireLifecycleEvent, globalEventsCallbacksMap, globalUseCasesEvents } from "./use-case-events.mjs";
 import { PipelineOptions, runPipeline } from "./use-case-pipeline.mjs";
 import { BadSchemaUseCaseError } from "./use-case.errors.mjs";
-import { $registerUseCase, $unregisterUseCase, addUseCaseHistory, getUseCase, getUseCaseHistory, getUseCases, increaseUseCaseFailedCalls, increaseUseCaseSuccessCalls } from "./use-cases-registry.mjs";
+import { $registerUseCase, $unregisterUseCase, addUseCaseHistory, getUseCase, getUseCaseHistory, getUseCases, increaseUseCaseFailedCalls, increaseUseCaseSuccessCalls } from "./use-cases-registry.mjs";
+export { $registerUseCase, $unregisterUseCase, BadSchemaUseCaseError, PipelineOptions, RegisteredUseCase, UseCase, UseCaseAfterMiddleware, UseCaseBeforeMiddleware, UseCaseBroadcastChannel, UseCaseBroadcastEvent, UseCaseBroadcastOption, UseCaseConfigurations, UseCaseContext, UseCaseErrorResult, UseCaseEventsCallbacksMap, UseCaseGuard, UseCaseHandler, UseCaseOnExecutingContext, UseCaseResult, UseCaseRuntimeOptions, UseCaseWithSchema, addUseCaseHistory, broadcastUseCaseResult, fireLifecycleEvent, getUseCase, getUseCaseHistory, getUseCases, globalEventsCallbacksMap, globalUseCasesEvents, increaseUseCaseFailedCalls, increaseUseCaseSuccessCalls, runPipeline, useCase };

package/esm/use-cases/index.mjs

@@ -5,4 +5,4 @@ import { runPipeline } from "./use-case-pipeline.mjs";
 import { $registerUseCase, $unregisterUseCase, addUseCaseHistory, getUseCase, getUseCaseHistory, getUseCases, increaseUseCaseFailedCalls, increaseUseCaseSuccessCalls } from "./use-cases-registry.mjs";
 import { useCase } from "./use-case.mjs";
 
-export {  };
+export { $registerUseCase, $unregisterUseCase, BadSchemaUseCaseError, addUseCaseHistory, broadcastUseCaseResult, fireLifecycleEvent, getUseCase, getUseCaseHistory, getUseCases, globalEventsCallbacksMap, globalUseCasesEvents, increaseUseCaseFailedCalls, increaseUseCaseSuccessCalls, runPipeline, useCase };

package/esm/use-cases/types.d.mts

@@ -1,14 +1,13 @@
 import { BenchmarkOptions } from "../benchmark/types.mjs";
 import { Infer, ObjectValidator } from "@warlock.js/seal";
 import { RetryOptions } from "@mongez/reinforcements";
-
 //#region ../../packages/core/src/use-cases/types.d.ts
 /**
  * Shared context object passed through the entire use case pipeline.
  * Contains the optional schema and can be enriched by guards/middleware
  * with arbitrary data (e.g., currentUser, permissions, request metadata).
  */
-type UseCaseContext = {
+export type UseCaseContext = {
   schema?: ObjectValidator;
 } & Record<string, any>;
 /**
@@ -30,7 +29,7 @@ type UseCaseContext = {
  * @template Input - The shape of the use case input data
  * @template Ctx - The shape of the shared context
  */
-type UseCaseGuard<Input, Ctx extends UseCaseContext = UseCaseContext> = (data: Readonly<Input>, ctx: Ctx) => void | Promise<void>;
+export type UseCaseGuard<Input, Ctx extends UseCaseContext = UseCaseContext> = (data: Readonly<Input>, ctx: Ctx) => void | Promise<void>;
 /**
  * Before middleware that runs **after** schema validation.
  *
@@ -47,7 +46,7 @@ type UseCaseGuard<Input, Ctx extends UseCaseContext = UseCaseContext> = (data: R
  * @template Input - The shape of the use case input data
  * @template Ctx - The shape of the shared context
  */
-type UseCaseBeforeMiddleware<Input, Ctx extends UseCaseContext = UseCaseContext> = (data: Input, ctx: Ctx) => Input | Promise<Input>;
+export type UseCaseBeforeMiddleware<Input, Ctx extends UseCaseContext = UseCaseContext> = (data: Input, ctx: Ctx) => Input | Promise<Input>;
 /**
  * After middleware that runs **after** the handler succeeds.
  *
@@ -65,17 +64,23 @@ type UseCaseBeforeMiddleware<Input, Ctx extends UseCaseContext = UseCaseContext>
  * @template Output - The shape of the use case output data
  * @template Ctx - The shape of the shared context
  */
-type UseCaseAfterMiddleware<Output, Ctx extends UseCaseContext = UseCaseContext> = (output: Output, ctx: Ctx) => void | Promise<void>;
+export type UseCaseAfterMiddleware<Output, Ctx extends UseCaseContext = UseCaseContext> = (output: Output, ctx: Ctx) => void | Promise<void>;
 /**
  * Context passed to `onExecuting` lifecycle event callbacks.
  * Fired at the start of each use case execution, before guards run.
  */
-type UseCaseOnExecutingContext = {
-  /** The shared pipeline context */ctx: UseCaseContext; /** Unique execution ID */
-  id: string; /** Use case name */
-  name: string; /** Raw input data */
-  data: any; /** Schema validator (if defined) */
-  schema?: ObjectValidator; /** Timestamp when execution started */
+export type UseCaseOnExecutingContext = {
+  /** The shared pipeline context */
+  ctx: UseCaseContext;
+  /** Unique execution ID */
+  id: string;
+  /** Use case name */
+  name: string;
+  /** Raw input data */
+  data: any;
+  /** Schema validator (if defined) */
+  schema?: ObjectValidator;
+  /** Timestamp when execution started */
   startedAt: Date;
 };
 /**
@@ -84,11 +89,16 @@ type UseCaseOnExecutingContext = {
  * An envelope (not the bare payload) so consumers get a correlation `id` for
  * tracing/idempotency under at-least-once delivery.
  */
-type UseCaseBroadcastEvent = {
-  /** Use case name */useCase: string; /** Channel/event name — defaults to the use case name */
-  event: string; /** Execution id (correlation / idempotency) */
-  id: string; /** Emission timestamp */
-  at: Date; /** The output as-is, or the projected shape from `broadcast.output` */
+export type UseCaseBroadcastEvent = {
+  /** Use case name */
+  useCase: string;
+  /** Channel/event name — defaults to the use case name */
+  event: string;
+  /** Execution id (correlation / idempotency) */
+  id: string;
+  /** Emission timestamp */
+  at: Date;
+  /** The output as-is, or the projected shape from `broadcast.output` */
   payload: unknown;
 };
 /**
@@ -104,7 +114,7 @@ type UseCaseBroadcastEvent = {
  * broadcast: { enabled: true, channels: [heraldBroadcast({ broker: "default" })] }
  * ```
  */
-interface UseCaseBroadcastChannel {
+export interface UseCaseBroadcastChannel {
   broadcast(event: UseCaseBroadcastEvent): void | Promise<void>;
 }
 /**
@@ -113,8 +123,10 @@ interface UseCaseBroadcastChannel {
  *
  * @template Output - The shape of the handler's return value
  */
-type UseCaseBroadcastOption<Output> = boolean | {
-  /** Channel/event name; defaults to the use case name */event?: string; /** Project the payload before broadcasting (e.g. strip sensitive fields) */
+export type UseCaseBroadcastOption<Output> = boolean | {
+  /** Channel/event name; defaults to the use case name */
+  event?: string;
+  /** Project the payload before broadcasting (e.g. strip sensitive fields) */
   output?: (output: Output, result: UseCaseResult<Output>) => unknown;
 };
 /**
@@ -143,16 +155,26 @@ type UseCaseBroadcastOption<Output> = boolean | {
  * @template Input - The shape of the input data (before transformation)
  * @template Ctx - The shape of the shared context
  */
-type UseCase<Output = any, Input = any, Ctx extends UseCaseContext = UseCaseContext> = {
-  /** Unique use case identifier, used for registration, logging, and cache keys */name: string; /** Human-readable description, surfaced in the registry and observability */
-  description?: string; /** Core business logic handler. Receives validated + transformed data and context */
-  handler: (data: Input, ctx: Ctx) => Promise<Output>; /** Optional schema validator (from @warlock.js/seal). Runs after guards */
-  schema?: ObjectValidator; /** Guards to run before validation. Sequential, can enrich ctx, cannot mutate data */
-  guards?: UseCaseGuard<Input, Ctx>[]; /** Before middleware to run after validation. Sequential, can transform data */
-  before?: UseCaseBeforeMiddleware<Input, Ctx>[]; /** After middleware to run on success. Fire-and-forget, errors are logged not thrown */
-  after?: UseCaseAfterMiddleware<Output, Ctx>[]; /** Lifecycle callback: fires when execution starts (before guards) */
-  onExecuting?: (ctx: UseCaseOnExecutingContext) => void; /** Lifecycle callback: fires on successful completion with full result snapshot */
-  onCompleted?: (result: UseCaseResult<Output>) => void; /** Lifecycle callback: fires on error with error details and execution context */
+export type UseCase<Output = any, Input = any, Ctx extends UseCaseContext = UseCaseContext> = {
+  /** Unique use case identifier, used for registration, logging, and cache keys */
+  name: string;
+  /** Human-readable description, surfaced in the registry and observability */
+  description?: string;
+  /** Core business logic handler. Receives validated + transformed data and context */
+  handler: (data: Input, ctx: Ctx) => Promise<Output>;
+  /** Optional schema validator (from @warlock.js/seal). Runs after guards */
+  schema?: ObjectValidator;
+  /** Guards to run before validation. Sequential, can enrich ctx, cannot mutate data */
+  guards?: UseCaseGuard<Input, Ctx>[];
+  /** Before middleware to run after validation. Sequential, can transform data */
+  before?: UseCaseBeforeMiddleware<Input, Ctx>[];
+  /** After middleware to run on success. Fire-and-forget, errors are logged not thrown */
+  after?: UseCaseAfterMiddleware<Output, Ctx>[];
+  /** Lifecycle callback: fires when execution starts (before guards) */
+  onExecuting?: (ctx: UseCaseOnExecutingContext) => void;
+  /** Lifecycle callback: fires on successful completion with full result snapshot */
+  onCompleted?: (result: UseCaseResult<Output>) => void;
+  /** Lifecycle callback: fires on error with error details and execution context */
   onError?: (ctx: UseCaseErrorResult) => void;
   /**
    * Retry configuration (from `@mongez/reinforcements`). When set, the **handler**
@@ -178,7 +200,7 @@ type UseCase<Output = any, Input = any, Ctx extends UseCaseContext = UseCaseCont
  * @template Schema - The schema validator the input is inferred from
  * @template Ctx - The shape of the shared context
  */
-type UseCaseWithSchema<Output, Schema extends ObjectValidator, Ctx extends UseCaseContext = UseCaseContext> = Omit<UseCase<Output, Infer<Schema>, Ctx>, "schema"> & {
+export type UseCaseWithSchema<Output, Schema extends ObjectValidator, Ctx extends UseCaseContext = UseCaseContext> = Omit<UseCase<Output, Infer<Schema>, Ctx>, "schema"> & {
   schema: Schema;
 };
 /**
@@ -188,17 +210,21 @@ type UseCaseWithSchema<Output, Schema extends ObjectValidator, Ctx extends UseCa
  * @template Output - The shape of the handler's return value
  * @template Input - The shape of the input data
  */
-type UseCaseHandler<Output, Input> = ((data: Input, options?: UseCaseRuntimeOptions<Output>) => Promise<Output>) & {
+export type UseCaseHandler<Output, Input> = ((data: Input, options?: UseCaseRuntimeOptions<Output>) => Promise<Output>) & {
   $cleanup: () => void;
 };
 /**
  * A registered use case with call tracking metadata.
  * Created internally when a use case is registered via `useCase()`.
  */
-type RegisteredUseCase<Output = any, Input = any> = UseCase<Output, Input> & {
-  /** Execution call counters */calls: {
-    /** Number of successful executions */success: number; /** Number of failed executions */
-    failed: number; /** Total executions (success + failed) */
+export type RegisteredUseCase<Output = any, Input = any> = UseCase<Output, Input> & {
+  /** Execution call counters */
+  calls: {
+    /** Number of successful executions */
+    success: number;
+    /** Number of failed executions */
+    failed: number;
+    /** Total executions (success + failed) */
     total: number;
   };
 };
@@ -217,19 +243,25 @@ type RegisteredUseCase<Output = any, Input = any> = UseCase<Output, Input> & {
  *
  * @template Output - The shape of the use case output data
  */
-type UseCaseRuntimeOptions<Output = any> = {
-  /** Override the auto-generated execution ID */id?: string; /** Provide a pre-populated context object */
-  ctx?: UseCaseContext; /** Invocation-level lifecycle callback: fires first, before use case and global */
-  onExecuting?: (ctx: UseCaseOnExecutingContext) => void; /** Invocation-level lifecycle callback: fires first on success */
-  onCompleted?: (result: UseCaseResult<Output>) => void; /** Invocation-level lifecycle callback: fires first on error */
+export type UseCaseRuntimeOptions<Output = any> = {
+  /** Override the auto-generated execution ID */
+  id?: string;
+  /** Provide a pre-populated context object */
+  ctx?: UseCaseContext;
+  /** Invocation-level lifecycle callback: fires first, before use case and global */
+  onExecuting?: (ctx: UseCaseOnExecutingContext) => void;
+  /** Invocation-level lifecycle callback: fires first on success */
+  onCompleted?: (result: UseCaseResult<Output>) => void;
+  /** Invocation-level lifecycle callback: fires first on error */
   onError?: (ctx: UseCaseErrorResult) => void;
 };
 /**
  * Error result snapshot, emitted via `onError` lifecycle callbacks.
  * Contains all fields from `UseCaseResult` except `output`, plus the thrown error.
  */
-type UseCaseErrorResult = Omit<UseCaseResult, "output"> & {
-  /** The error that caused the failure */error: Error;
+export type UseCaseErrorResult = Omit<UseCaseResult, "output"> & {
+  /** The error that caused the failure */
+  error: Error;
 };
 /**
  * Success result snapshot, emitted via `onCompleted` lifecycle callbacks
@@ -237,21 +269,35 @@ type UseCaseErrorResult = Omit<UseCaseResult, "output"> & {
  *
  * @template Output - The shape of the handler's return value
  */
-type UseCaseResult<Output = any> = {
-  /** Handler return value (undefined if execution failed) */output?: Output; /** The pipeline context at time of completion */
-  ctx: UseCaseContext; /** Timestamp when execution started */
-  startedAt: Date; /** Timestamp when execution ended */
-  endedAt: Date; /** Unique execution ID */
-  id: string; /** Use case name */
-  name: string; /** Success or failed call count at time of completion (matches the outcome) */
-  calls: number; /** Retry state (present only if retry was configured) */
+export type UseCaseResult<Output = any> = {
+  /** Handler return value (undefined if execution failed) */
+  output?: Output;
+  /** The pipeline context at time of completion */
+  ctx: UseCaseContext;
+  /** Timestamp when execution started */
+  startedAt: Date;
+  /** Timestamp when execution ended */
+  endedAt: Date;
+  /** Unique execution ID */
+  id: string;
+  /** Use case name */
+  name: string;
+  /** Success or failed call count at time of completion (matches the outcome) */
+  calls: number;
+  /** Retry state (present only if retry was configured) */
   retries?: {
-    /** Total allowed attempts (initial try + retries) */attempts: number; /** Delay between attempts in ms */
-    delay?: number; /** Actual retry attempts performed (0 = succeeded on first try) */
+    /** Total allowed attempts (initial try + retries) */
+    attempts: number;
+    /** Delay between attempts in ms */
+    delay?: number;
+    /** Actual retry attempts performed (0 = succeeded on first try) */
     currentRetry: number;
-  }; /** Benchmark result (present only if benchmark was enabled) */
+  };
+  /** Benchmark result (present only if benchmark was enabled) */
   benchmarkResult?: {
-    /** Execution time in milliseconds */latency: number; /** Performance classification */
+    /** Execution time in milliseconds */
+    latency: number;
+    /** Performance classification */
     state: "poor" | "good" | "excellent";
   };
 };
@@ -259,7 +305,7 @@ type UseCaseResult<Output = any> = {
  * Internal registry of global lifecycle event callback arrays.
  * Used by `globalUseCasesEvents` to manage subscriptions.
  */
-type UseCaseEventsCallbacksMap = {
+export type UseCaseEventsCallbacksMap = {
   onExecuting: ((ctx: UseCaseOnExecutingContext) => void)[];
   onCompleted: ((result: UseCaseResult<any>) => void)[];
   onError: ((ctx: UseCaseErrorResult) => void)[];
@@ -279,7 +325,7 @@ type UseCaseEventsCallbacksMap = {
  * } satisfies UseCaseConfigurations;
  * ```
  */
-type UseCaseConfigurations = {
+export type UseCaseConfigurations = {
   /**
    * Default retry for all use cases (from `@mongez/reinforcements`).
    * When set, every use case retries its handler unless it overrides `retry`.
@@ -289,18 +335,25 @@ type UseCaseConfigurations = {
    * Default benchmark setting for all use cases.
    * For standalone benchmark usage, use `config.get("benchmark")` instead.
    */
-  benchmark?: boolean | BenchmarkOptions; /** Broadcast transport — registered channels plus a global kill-switch */
+  benchmark?: boolean | BenchmarkOptions;
+  /** Broadcast transport — registered channels plus a global kill-switch */
   broadcast?: {
-    /** Global on/off — `false` disables broadcasting for every use case */enabled?: boolean; /** Channels every broadcast fans out to */
+    /** Global on/off — `false` disables broadcasting for every use case */
+    enabled?: boolean;
+    /** Channels every broadcast fans out to */
     channels?: UseCaseBroadcastChannel[];
-  }; /** Per-step debug logging through `@warlock.js/logger` (default: false) */
-  log?: boolean; /** Execution history cache settings */
+  };
+  /** Per-step debug logging through `@warlock.js/logger` (default: false) */
+  log?: boolean;
+  /** Execution history cache settings */
   history?: {
-    /** Enable/disable history storage (default: true) */enabled?: boolean; /** Cache TTL in seconds (default: 3600). `false` uses the cache driver default */
-    ttl?: number | false; /** Max history entries kept per use case before oldest are evicted (default: 100) */
+    /** Enable/disable history storage (default: true) */
+    enabled?: boolean;
+    /** Cache TTL in seconds (default: 3600). `false` uses the cache driver default */
+    ttl?: number | false;
+    /** Max history entries kept per use case before oldest are evicted (default: 100) */
     maxEntries?: number;
   };
 };
 //#endregion
-export { RegisteredUseCase, UseCase, UseCaseAfterMiddleware, UseCaseBeforeMiddleware, UseCaseBroadcastChannel, UseCaseBroadcastEvent, UseCaseBroadcastOption, UseCaseConfigurations, UseCaseContext, UseCaseErrorResult, UseCaseEventsCallbacksMap, UseCaseGuard, UseCaseHandler, UseCaseOnExecutingContext, UseCaseResult, UseCaseRuntimeOptions, UseCaseWithSchema };
 //# sourceMappingURL=types.d.mts.map

package/esm/use-cases/types.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/use-cases/types.ts"],"mappings":";;;;;;;AASA;;;KAAY,cAAA;EACV,MAAA,GAAS,eAAA;AAAA,IACP,MAAM;;;AAAA;AAqBV;;;;;;;;;;;;;;;;KAAY,YAAA,oBAAgC,cAAA,GAAiB,cAAA,KAC3D,IAAA,EAAM,QAAA,CAAS,KAAA,GACf,GAAA,EAAK,GAAA,YACK,OAAA;;;;;;AAAO;AAkBnB;;;;;;;;;;KAAY,uBAAA,oBAA2C,cAAA,GAAiB,cAAA,KACtE,IAAA,EAAM,KAAA,EACN,GAAA,EAAK,GAAA,KACF,KAAA,GAAQ,OAAA,CAAQ,KAAA;;;;;;;;;;;;;;AAAK;AAmB1B;;;KAAY,sBAAA,qBAA2C,cAAA,GAAiB,cAAA,KACtE,MAAA,EAAQ,MAAA,EACR,GAAA,EAAK,GAAA,YACK,OAAA;;;;;KAMA,yBAAA;EANO,kCAQjB,GAAA,EAAK,cAAA,EAXoC;EAazC,EAAA,UAbsE;EAetE,IAAA,UAdA;EAgBA,IAAA,OAfA;EAiBA,MAAA,GAAS,eAAA,EAhBQ;EAkBjB,SAAA,EAAW,IAAA;AAAA;;;;;;;KASD,qBAAA;EAnBV,oBAqBA,OAAA,UAnBA;EAqBA,KAAA,UAjBA;EAmBA,EAAA,UAjBS;EAmBT,EAAA,EAAI,IAAI,EAjBG;EAmBX,OAAA;AAAA;AAVF;;;;;;;;;;;AAUS;AAgBT;AA1BA,UA0BiB,uBAAA;EACf,SAAA,CAAU,KAAA,EAAO,qBAAA,UAA+B,OAAO;AAAA;;;;;;AAAA;KAS7C,sBAAA;EAAsB,wDAI5B,KAAA,WAEkB;EAAlB,MAAA,IAAU,MAAA,EAAQ,MAAA,EAAQ,MAAA,EAAQ,aAAA,CAAc,MAAA;AAAA;;;;;;;;;;;;AAAO;AA6B7D;;;;;;;;;;;;;;KAAY,OAAA,wCAA+C,cAAA,GAAiB,cAAA;EAYjE,iFAVT,IAAA,UAYuC;EAVvC,WAAA,WAYoB;EAVpB,OAAA,GAAU,IAAA,EAAM,KAAA,EAAO,GAAA,EAAK,GAAA,KAAQ,OAAA,CAAQ,MAAA,GAYrB;EAVvB,MAAA,GAAS,eAAA,EAiBD;EAfR,MAAA,GAAS,YAAA,CAAa,KAAA,EAAO,GAAA,KAyBM;EAvBnC,MAAA,GAAS,uBAAA,CAAwB,KAAA,EAAO,GAAA,KAuBN;EArBlC,KAAA,GAAQ,sBAAA,CAAuB,MAAA,EAAQ,GAAA,KAdrB;EAgBlB,WAAA,IAAe,GAAA,EAAK,yBAAA,WAhByB;EAkB7C,WAAA,IAAe,MAAA,EAAQ,aAAA,CAAc,MAAA,YAlBqC;EAoB1E,OAAA,IAAW,GAAA,EAAK,kBAAA;EAhBhB;;;;EAqBA,KAAA,GAAQ,YAAA;EAnBe;;;;EAwBvB,SAAA,aAAsB,gBAAA;EApBtB;;;;EAyBA,SAAA,GAAY,sBAAA,CAAuB,MAAA;AAAA;;;;;;;;;KAWzB,iBAAA,wBAEK,eAAA,cACH,cAAA,GAAiB,cAAA,IAC3B,IAAA,CAAK,OAAA,CAAQ,MAAA,EAAQ,KAAA,CAAM,MAAA,GAAS,GAAA;EACtC,MAAA,EAAQ,MAAA;AAAA;;;;;;;;KAUE,cAAA,oBACV,IAAA,EAAM,KAAA,EACN,OAAA,GAAU,qBAAA,CAAsB,MAAA,MAC7B,OAAA,CAAQ,MAAA;EACX,QAAA;AAAA;;;;AA9ByC;KAqC/B,iBAAA,8BAA+C,OAAA,CAAQ,MAAA,EAAQ,KAAA;EA1B9C,8BA4B3B,KAAA;IA1Be,sCA4Bb,OAAA,UA3B2B;IA6B3B,MAAA,UA5B2B;IA8B3B,KAAA;EAAA;AAAA;;;;;;;;;;;;;;;;KAmBQ,qBAAA;EAhDV,+CAkDA,EAAA,WAlDc;EAoDd,GAAA,GAAM,cAAA,EA1CI;EA4CV,WAAA,IAAe,GAAA,EAAK,yBAAA,WA5CI;EA8CxB,WAAA,IAAe,MAAA,EAAQ,aAAA,CAAc,MAAA,YA5CL;EA8ChC,OAAA,IAAW,GAAA,EAAK,kBAAA;AAAA;;;;;KAON,kBAAA,GAAqB,IAAA,CAAK,aAAA;EAtD9B,wCAwDN,KAAA,EAAO,KAAA;AAAA;;;;;;;KASG,aAAA;EAvDA,2DAyDV,MAAA,GAAS,MAAA,EAzDkB;EA2D3B,GAAA,EAAK,cAAA,EA3DoE;EA6DzE,SAAA,EAAW,IAAA,EA7DqD;EA+DhE,OAAA,EAAS,IAAA,EA/DmB;EAiE5B,EAAA,UAjEyD;EAmEzD,IAAA,UAnEyE;EAqEzE,KAAA,UAjEE;EAmEF,OAAA;IA/DE,qDAiEA,QAAA,UAjEK;IAmEL,KAAA,WAhD6B;IAkD7B,YAAA;EAAA,GA5CkB;EA+CpB,eAAA;IA7CuB,qCA+CrB,OAAA,UA7CgC;IA+ChC,KAAA;EAAA;AAAA;;;;;KAQQ,yBAAA;EACV,WAAA,IAAe,GAAA,EAAK,yBAAA;EACpB,WAAA,IAAe,MAAA,EAAQ,aAAA;EACvB,OAAA,IAAW,GAAA,EAAK,kBAAA;AAAA;;;;;AA1DkB;AAOpC;;;;;;;;;;KAqEY,qBAAA;EAnEH;;AAAK;AASd;EA+DE,KAAA,GAAQ,YAAA;EA/De;;;;EAoEvB,SAAA,aAAsB,gBAAA,EA5DT;EA8Db,SAAA;IAtEwB,uEAwEtB,OAAA,YAtEO;IAwEP,QAAA,GAAW,uBAAA;EAAA,GApEb;EAuEA,GAAA,YArEA;EAuEA,OAAA;IArEA,qDAuEE,OAAA,YAnEF;IAqEE,GAAA,mBAjEA;IAmEA,UAAA;EAAA;AAAA"}
+{"version":3,"file":"types.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/use-cases/types.ts"],"mappings":";;;;;;;;;YASY;EACV,SAAS;IACP;;;;;;;;;;;;;;;;;;;;YAqBQ,aAAa,OAAO,YAAY,iBAAiB,mBAC3D,MAAM,SAAS,QACf,KAAK,eACK;;;;;;;;;;;;;;;;;YAkBA,wBAAwB,OAAO,YAAY,iBAAiB,mBACtE,MAAM,OACN,KAAK,QACF,QAAQ,QAAQ;;;;;;;;;;;;;;;;;;YAmBT,uBAAuB,QAAQ,YAAY,iBAAiB,mBACtE,QAAQ,QACR,KAAK,eACK;;;;;YAMA;;EAEV,KAAK;;EAEL;;EAEA;;EAEA;;EAEA,SAAS;;EAET,WAAW;;;;;;;;YASD;;EAEV;;EAEA;;EAEA;;EAEA,IAAI;;EAEJ;;;;;;;;;;;;;;;iBAgBe;EACf,UAAU,OAAO,+BAA+B;;;;;;;;YAStC,uBAAuB;;EAI7B;;EAEA,UAAU,QAAQ,QAAQ,QAAQ,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;YA6B1C,QAAQ,cAAc,aAAa,YAAY,iBAAiB;;EAE1E;;EAEA;;EAEA,UAAU,MAAM,OAAO,KAAK,QAAQ,QAAQ;;EAE5C,SAAS;;EAET,SAAS,aAAa,OAAO;;EAE7B,SAAS,wBAAwB,OAAO;;EAExC,QAAQ,uBAAuB,QAAQ;;EAEvC,eAAe,KAAK;;EAEpB,eAAe,QAAQ,cAAc;;EAErC,WAAW,KAAK;;;;;EAKhB,QAAQ;;;;;EAKR,sBAAsB;;;;;EAKtB,YAAY,uBAAuB;;;;;;;;;;YAWzB,kBACV,QACA,eAAe,iBACf,YAAY,iBAAiB,kBAC3B,KAAK,QAAQ,QAAQ,MAAM,SAAS;EACtC,QAAQ;;;;;;;;;YAUE,eAAe,QAAQ,WACjC,MAAM,OACN,UAAU,sBAAsB,YAC7B,QAAQ;EACX;;;;;;YAOU,kBAAkB,cAAc,eAAe,QAAQ,QAAQ;;EAEzE;;IAEE;;IAEA;;IAEA;;;;;;;;;;;;;;;;;;YAmBQ,sBAAsB;;EAEhC;;EAEA,MAAM;;EAEN,eAAe,KAAK;;EAEpB,eAAe,QAAQ,cAAc;;EAErC,WAAW,KAAK;;;;;;YAON,qBAAqB,KAAK;;EAEpC,OAAO;;;;;;;;YASG,cAAc;;EAExB,SAAS;;EAET,KAAK;;EAEL,WAAW;;EAEX,SAAS;;EAET;;EAEA;;EAEA;;EAEA;;IAEE;;IAEA;;IAEA;;;EAGF;;IAEE;;IAEA;;;;;;;YAQQ;EACV,eAAe,KAAK;EACpB,eAAe,QAAQ;EACvB,WAAW,KAAK;;;;;;;;;;;;;;;;;YAkBN;;;;;EAKV,QAAQ;;;;;EAKR,sBAAsB;;EAEtB;;IAEE;;IAEA,WAAW;;;EAGb;;EAEA;;IAEE;;IAEA;;IAEA"}

package/esm/use-cases/use-case-broadcast.d.mts

@@ -1,5 +1,4 @@
 import { UseCaseBroadcastOption, UseCaseConfigurations, UseCaseResult } from "./types.mjs";
-
 //#region ../../packages/core/src/use-cases/use-case-broadcast.d.ts
 /**
  * Broadcast a successful use-case result through the globally-configured channels.
@@ -11,7 +10,7 @@ import { UseCaseBroadcastOption, UseCaseConfigurations, UseCaseResult } from "./
  * @example
  * await broadcastUseCaseResult({ name, id, output, result, broadcast, config });
  */
-declare function broadcastUseCaseResult<Output>(params: {
+export declare function broadcastUseCaseResult<Output>(params: {
   name: string;
   id: string;
   output: Output;
@@ -20,5 +19,4 @@ declare function broadcastUseCaseResult<Output>(params: {
   config?: UseCaseConfigurations["broadcast"];
 }): Promise<void>;
 //#endregion
-export { broadcastUseCaseResult };
 //# sourceMappingURL=use-case-broadcast.d.mts.map

package/esm/use-cases/use-case-broadcast.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"use-case-broadcast.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/use-cases/use-case-broadcast.ts"],"mappings":";;;;;AAkBA;;;;;;;;iBAAsB,sBAAA,SAA+B,MAAA;EACnD,IAAA;EACA,EAAA;EACA,MAAA,EAAQ,MAAA;EACR,MAAA,EAAQ,aAAA,CAAc,MAAA;EACtB,SAAA,GAAY,sBAAA,CAAuB,MAAA;EACnC,MAAA,GAAS,qBAAA;AAAA,IACP,OAAA"}
+{"version":3,"file":"use-case-broadcast.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/use-cases/use-case-broadcast.ts"],"mappings":";;;;;;;;;;;;wBAkBsB,uBAAuB,QAAQ;EACnD;EACA;EACA,QAAQ;EACR,QAAQ,cAAc;EACtB,YAAY,uBAAuB;EACnC,SAAS;IACP"}

package/esm/use-cases/use-case-events.d.mts

@@ -1,10 +1,9 @@
 import { UseCaseErrorResult, UseCaseEventsCallbacksMap, UseCaseOnExecutingContext, UseCaseResult } from "./types.mjs";
-
 //#region ../../packages/core/src/use-cases/use-case-events.d.ts
 /**
  * Global event callbacks — shared across all use case instances.
  */
-declare const globalEventsCallbacksMap: UseCaseEventsCallbacksMap;
+export declare const globalEventsCallbacksMap: UseCaseEventsCallbacksMap;
 /**
  * Subscribe to lifecycle events fired by any use case.
  *
@@ -12,7 +11,7 @@ declare const globalEventsCallbacksMap: UseCaseEventsCallbacksMap;
  * globalUseCasesEvents.onCompleted((result) => metrics.track(result.name, result.benchmarkResult));
  * globalUseCasesEvents.onError((ctx) => logger.error(ctx.name, ctx.error));
  */
-declare const globalUseCasesEvents: {
+export declare const globalUseCasesEvents: {
   onExecuting(callback: (ctx: UseCaseOnExecutingContext) => void): {
     unsubscribe: () => void;
   };
@@ -30,11 +29,10 @@ declare const globalUseCasesEvents: {
  * observer can't stall the others, and a throwing one can't break the pipeline (e.g.
  * a successful use case must not fail because a metrics/broadcast observer threw).
  */
-declare function fireLifecycleEvent<EventCtx>(ctx: EventCtx, observers: {
+export declare function fireLifecycleEvent<EventCtx>(ctx: EventCtx, observers: {
   invocation?: ((ctx: EventCtx) => void | Promise<void>)[];
   useCase?: ((ctx: EventCtx) => void | Promise<void>)[];
   global?: ((ctx: EventCtx) => void | Promise<void>)[];
 }): Promise<void>;
 //#endregion
-export { fireLifecycleEvent, globalEventsCallbacksMap, globalUseCasesEvents };
 //# sourceMappingURL=use-case-events.d.mts.map

package/esm/use-cases/use-case-events.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"use-case-events.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/use-cases/use-case-events.ts"],"mappings":";;;;;AAWA;cAAa,wBAAA,EAA0B,yBAItC;;;AAAA;AASD;;;;cAAa,oBAAA;yBACY,GAAA,EAAK,yBAAA;;;sBASV,QAAA,GAAa,MAAA,EAAQ,aAAA,CAAc,MAAA;;;qBASlC,GAAA,EAAK,kBAAA;;;;;;;;;;;iBAkBJ,kBAAA,WACpB,GAAA,EAAK,QAAA,EACL,SAAA;EACE,UAAA,KAAe,GAAA,EAAK,QAAA,YAAoB,OAAA;EACxC,OAAA,KAAY,GAAA,EAAK,QAAA,YAAoB,OAAA;EACrC,MAAA,KAAW,GAAA,EAAK,QAAA,YAAoB,OAAA;AAAA,IACrC,OAAA"}
+{"version":3,"file":"use-case-events.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/use-cases/use-case-events.ts"],"mappings":";;;;;qBAWa,0BAA0B;;;;;;;;qBAa1B;EACX,YAAW,WAAY,KAAK;IAGxB;;EAMJ,YAAY,QAAM,WAAa,QAAQ,cAAc;IAGjD;;EAMJ,QAAO,WAAY,KAAK;IAGpB;;;;;;;;;;wBAegB,mBAAmB,UACvC,KAAK,UACL;EACE,eAAe,KAAK,oBAAoB;EACxC,YAAY,KAAK,oBAAoB;EACrC,WAAW,KAAK,oBAAoB;IACrC"}

package/esm/use-cases/use-case-pipeline.d.mts

@@ -1,8 +1,7 @@
 import { UseCaseBeforeMiddleware, UseCaseContext, UseCaseGuard, UseCaseOnExecutingContext } from "./types.mjs";
 import { ObjectValidator } from "@warlock.js/seal";
-
 //#region ../../packages/core/src/use-cases/use-case-pipeline.d.ts
-type PipelineOptions<Input> = {
+export type PipelineOptions<Input> = {
   name: string;
   id: string;
   data: Input;
@@ -10,8 +9,10 @@ type PipelineOptions<Input> = {
   startedAt: Date;
   schema?: ObjectValidator;
   guards?: UseCaseGuard<Input>[];
-  before?: UseCaseBeforeMiddleware<Input>[]; /** Invocation-level onExecuting override */
-  onExecuting?: (ctx: UseCaseOnExecutingContext) => void; /** Use-case-level onExecuting */
+  before?: UseCaseBeforeMiddleware<Input>[];
+  /** Invocation-level onExecuting override */
+  onExecuting?: (ctx: UseCaseOnExecutingContext) => void;
+  /** Use-case-level onExecuting */
   ucOnExecuting?: (ctx: UseCaseOnExecutingContext) => void;
 };
 /**
@@ -27,7 +28,6 @@ type PipelineOptions<Input> = {
  * @example
  * const data = await runPipeline({ name, id, data, ctx, startedAt, schema, guards, before });
  */
-declare function runPipeline<Input>(opts: PipelineOptions<Input>): Promise<Input>;
+export declare function runPipeline<Input>(opts: PipelineOptions<Input>): Promise<Input>;
 //#endregion
-export { PipelineOptions, runPipeline };
 //# sourceMappingURL=use-case-pipeline.d.mts.map

package/esm/use-cases/use-case-pipeline.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"use-case-pipeline.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/use-cases/use-case-pipeline.ts"],"mappings":";;;;KAWY,eAAA;EACV,IAAA;EACA,EAAA;EACA,IAAA,EAAM,KAAA;EACN,GAAA,EAAK,cAAA;EACL,SAAA,EAAW,IAAA;EACX,MAAA,GAAS,eAAA;EACT,MAAA,GAAS,YAAA,CAAa,KAAA;EACtB,MAAA,GAAS,uBAAA,CAAwB,KAAA,KADX;EAGtB,WAAA,IAAe,GAAA,EAAK,yBAAA,WAFa;EAIjC,aAAA,IAAiB,GAAA,EAAK,yBAAA;AAAA;;;;;;;;;;;;;;iBAgBF,WAAA,QAAmB,IAAA,EAAM,eAAA,CAAgB,KAAA,IAAS,OAAA,CAAQ,KAAA"}
+{"version":3,"file":"use-case-pipeline.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/use-cases/use-case-pipeline.ts"],"mappings":";;;YAWY,gBAAgB;EAC1B;EACA;EACA,MAAM;EACN,KAAK;EACL,WAAW;EACX,SAAS;EACT,SAAS,aAAa;EACtB,SAAS,wBAAwB;;EAEjC,eAAe,KAAK;;EAEpB,iBAAiB,KAAK;;;;;;;;;;;;;;;wBAgBF,YAAY,OAAO,MAAM,gBAAgB,SAAS,QAAQ"}