@warlock.js/core 5.31.0 → 5.32.0

package/esm/upgrade/codemods/logger-sync-calls.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"logger-sync-calls.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/upgrade/codemods/logger-sync-calls.ts"],"sourcesContent":["import type { Codemod, CodemodOutput } from \"../types\";\nimport { importedLocalNames, manualAt, replaceNode } from \"./helpers\";\n\nconst SYNC_METHODS = new Set([\n  \"info\",\n  \"warn\",\n  \"error\",\n  \"debug\",\n  \"success\",\n  \"fatal\",\n  \"log\",\n  \"assert\",\n]);\n\n/**\n * 5.30: `log.info()` and its siblings return the logger instead of a promise.\n * Removes `await` in front of them; a `.then()` chained on one is listed for\n * review (code that must wait for delivery calls `await log.flush()`).\n */\nexport const loggerSyncCalls: Codemod = {\n  id: \"logger-sync-calls\",\n  version: \"5.30.0\",\n  package: \"@warlock.js/logger\",\n  title: \"Remove `await` from synchronous log calls\",\n  skill: \"upgrade-from-5-29\",\n  run(context) {\n    const { Node, SyntaxKind } = context.tsMorph;\n    const output: CodemodOutput = { edits: [], manual: [] };\n\n    for (const sourceFile of context.sourceFiles) {\n      const loggers = importedLocalNames(sourceFile, \"@warlock.js/logger\", \"log\");\n      if (loggers.size === 0) continue;\n\n      const isLogCall = (node: import(\"ts-morph\").Node): boolean => {\n        if (!Node.isCallExpression(node)) return false;\n        const callee = node.getExpression();\n        if (!Node.isPropertyAccessExpression(callee)) return false;\n        const owner = callee.getExpression();\n        return (\n          Node.isIdentifier(owner) &&\n          loggers.has(owner.getText()) &&\n          SYNC_METHODS.has(callee.getName())\n        );\n      };\n\n      for (const awaitExpression of sourceFile.getDescendantsOfKind(SyntaxKind.AwaitExpression)) {\n        const argument = awaitExpression.getExpression();\n        if (!isLogCall(argument)) continue;\n        output.edits.push(\n          replaceNode(\n            context,\n            awaitExpression,\n            argument.getText(),\n            `removed await before ${argument.getText().split(\"(\")[0]}()`,\n          ),\n        );\n      }\n\n      for (const access of sourceFile.getDescendantsOfKind(SyntaxKind.PropertyAccessExpression)) {\n        if (access.getName() !== \"then\" || !isLogCall(access.getExpression())) continue;\n        output.manual.push(\n          manualAt(\n            context,\n            access,\n            \"`.then()` on a log call: log calls return the logger now. Run the callback directly, or `await log.flush()` first if it must wait for delivery.\",\n          ),\n        );\n      }\n    }\n\n    return output;\n  },\n};\n"],"mappings":";;;AAGA,MAAM,eAAe,IAAI,IAAI;CAC3B;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF,CAAC;;;;;;AAOD,MAAa,kBAA2B;CACtC,IAAI;CACJ,SAAS;CACT,SAAS;CACT,OAAO;CACP,OAAO;CACP,IAAI,SAAS;EACX,MAAM,EAAE,MAAM,eAAe,QAAQ;EACrC,MAAM,SAAwB;GAAE,OAAO,CAAC;GAAG,QAAQ,CAAC;EAAE;EAEtD,KAAK,MAAM,cAAc,QAAQ,aAAa;GAC5C,MAAM,UAAU,mBAAmB,YAAY,sBAAsB,KAAK;GAC1E,IAAI,QAAQ,SAAS,GAAG;GAExB,MAAM,aAAa,SAA2C;IAC5D,IAAI,CAAC,KAAK,iBAAiB,IAAI,GAAG,OAAO;IACzC,MAAM,SAAS,KAAK,cAAc;IAClC,IAAI,CAAC,KAAK,2BAA2B,MAAM,GAAG,OAAO;IACrD,MAAM,QAAQ,OAAO,cAAc;IACnC,OACE,KAAK,aAAa,KAAK,KACvB,QAAQ,IAAI,MAAM,QAAQ,CAAC,KAC3B,aAAa,IAAI,OAAO,QAAQ,CAAC;GAErC;GAEA,KAAK,MAAM,mBAAmB,WAAW,qBAAqB,WAAW,eAAe,GAAG;IACzF,MAAM,WAAW,gBAAgB,cAAc;IAC/C,IAAI,CAAC,UAAU,QAAQ,GAAG;IAC1B,OAAO,MAAM,KACX,YACE,SACA,iBACA,SAAS,QAAQ,GACjB,wBAAwB,SAAS,QAAQ,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,GAC3D,CACF;GACF;GAEA,KAAK,MAAM,UAAU,WAAW,qBAAqB,WAAW,wBAAwB,GAAG;IACzF,IAAI,OAAO,QAAQ,MAAM,UAAU,CAAC,UAAU,OAAO,cAAc,CAAC,GAAG;IACvE,OAAO,OAAO,KACZ,SACE,SACA,QACA,iJACF,CACF;GACF;EACF;EAEA,OAAO;CACT;AACF"}
+{"version":3,"file":"logger-sync-calls.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/upgrade/codemods/logger-sync-calls.ts"],"sourcesContent":["import type { Codemod, CodemodOutput } from \"../types\";\nimport { importedLocalNames, manualAt, replaceNode } from \"./helpers\";\n\nconst SYNC_METHODS = new Set([\n  \"info\",\n  \"warn\",\n  \"error\",\n  \"debug\",\n  \"success\",\n  \"fatal\",\n  \"log\",\n  \"assert\",\n]);\n\n/**\n * 5.30: `log.info()` and its siblings return the logger instead of a promise.\n * Removes `await` in front of them; a `.then()` chained on one is listed for\n * review (code that must wait for delivery calls `await log.flush()`).\n */\nexport const loggerSyncCalls: Codemod = {\n  id: \"logger-sync-calls\",\n  version: \"5.30.0\",\n  package: \"@warlock.js/logger\",\n  title: \"Remove `await` from synchronous log calls\",\n  skill: \"upgrade-from-5-29\",\n  run(context) {\n    const { Node, SyntaxKind } = context.tsMorph;\n    const output: CodemodOutput = { edits: [], manual: [] };\n\n    for (const sourceFile of context.sourceFiles) {\n      const loggers = importedLocalNames(sourceFile, \"@warlock.js/logger\", \"log\");\n      if (loggers.size === 0) continue;\n\n      const isLogCall = (node: import(\"ts-morph\").Node): boolean => {\n        if (!Node.isCallExpression(node)) return false;\n        const callee = node.getExpression();\n        if (!Node.isPropertyAccessExpression(callee)) return false;\n        const owner = callee.getExpression();\n        return (\n          Node.isIdentifier(owner) &&\n          loggers.has(owner.getText()) &&\n          SYNC_METHODS.has(callee.getName())\n        );\n      };\n\n      for (const awaitExpression of sourceFile.getDescendantsOfKind(SyntaxKind.AwaitExpression)) {\n        const argument = awaitExpression.getExpression();\n        if (!isLogCall(argument)) continue;\n        output.edits.push(\n          replaceNode(\n            context,\n            awaitExpression,\n            argument.getText(),\n            `removed await before ${argument.getText().split(\"(\")[0]}()`,\n          ),\n        );\n      }\n\n      for (const access of sourceFile.getDescendantsOfKind(SyntaxKind.PropertyAccessExpression)) {\n        if (access.getName() !== \"then\" || !isLogCall(access.getExpression())) continue;\n        output.manual.push(\n          manualAt(\n            context,\n            access,\n            \"`.then()` on a log call: log calls return the logger now. Run the callback directly, or `await log.flush()` first if it must wait for delivery.\",\n          ),\n        );\n      }\n    }\n\n    return output;\n  },\n};\n"],"mappings":";;;AAGA,MAAM,+BAAe,IAAI,IAAI;CAC3B;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF,CAAC;;;;;;AAOD,MAAa,kBAA2B;CACtC,IAAI;CACJ,SAAS;CACT,SAAS;CACT,OAAO;CACP,OAAO;CACP,IAAI,SAAS;EACX,MAAM,EAAE,MAAM,eAAe,QAAQ;EACrC,MAAM,SAAwB;GAAE,OAAO,CAAC;GAAG,QAAQ,CAAC;EAAE;EAEtD,KAAK,MAAM,cAAc,QAAQ,aAAa;GAC5C,MAAM,UAAU,mBAAmB,YAAY,sBAAsB,KAAK;GAC1E,IAAI,QAAQ,SAAS,GAAG;GAExB,MAAM,aAAa,SAA2C;IAC5D,IAAI,CAAC,KAAK,iBAAiB,IAAI,GAAG,OAAO;IACzC,MAAM,SAAS,KAAK,cAAc;IAClC,IAAI,CAAC,KAAK,2BAA2B,MAAM,GAAG,OAAO;IACrD,MAAM,QAAQ,OAAO,cAAc;IACnC,OACE,KAAK,aAAa,KAAK,KACvB,QAAQ,IAAI,MAAM,QAAQ,CAAC,KAC3B,aAAa,IAAI,OAAO,QAAQ,CAAC;GAErC;GAEA,KAAK,MAAM,mBAAmB,WAAW,qBAAqB,WAAW,eAAe,GAAG;IACzF,MAAM,WAAW,gBAAgB,cAAc;IAC/C,IAAI,CAAC,UAAU,QAAQ,GAAG;IAC1B,OAAO,MAAM,KACX,YACE,SACA,iBACA,SAAS,QAAQ,GACjB,wBAAwB,SAAS,QAAQ,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,GAC3D,CACF;GACF;GAEA,KAAK,MAAM,UAAU,WAAW,qBAAqB,WAAW,wBAAwB,GAAG;IACzF,IAAI,OAAO,QAAQ,MAAM,UAAU,CAAC,UAAU,OAAO,cAAc,CAAC,GAAG;IACvE,OAAO,OAAO,KACZ,SACE,SACA,QACA,iJACF,CACF;GACF;EACF;EAEA,OAAO;CACT;AACF"}

package/esm/upgrade/codemods/request-log-snapshot.mjs

@@ -2,7 +2,7 @@ import { importedLocalNames, manualAt, replaceNode } from "./helpers.mjs";
 
 //#region ../../packages/core/src/upgrade/codemods/request-log-snapshot.ts
 /** Fields of the `RequestLogSnapshot` a log channel now receives. */
-const SNAPSHOT_FIELDS = new Set([
+const SNAPSHOT_FIELDS = /* @__PURE__ */ new Set([
 	"id",
 	"method",
 	"url",

package/esm/upgrade/codemods/request-log-snapshot.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"request-log-snapshot.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/upgrade/codemods/request-log-snapshot.ts"],"sourcesContent":["import type * as TsMorph from \"ts-morph\";\nimport type { Codemod, CodemodOutput } from \"../types\";\nimport { importedLocalNames, manualAt, replaceNode } from \"./helpers\";\n\n/** Fields of the `RequestLogSnapshot` a log channel now receives. */\nconst SNAPSHOT_FIELDS = new Set([\n  \"id\",\n  \"method\",\n  \"url\",\n  \"route\",\n  \"name\",\n  \"ip\",\n  \"userAgent\",\n  \"query\",\n  \"body\",\n  \"statusCode\",\n]);\n\n/** `request.<a>.<b>` reads with a snapshot equivalent. */\nconst REWRITES: Record<string, string> = {\n  \"baseRequest.url\": \"url\",\n  \"baseRequest.method\": \"method\",\n  \"baseRequest.ip\": \"ip\",\n  \"route.path\": \"route\",\n  \"route.name\": \"name\",\n};\n\n/**\n * 5.30: request log entries carry a plain `RequestLogSnapshot` in\n * `context.request`, not the `Request` instance. Inside custom log channels,\n * rewrites the reads that have a direct snapshot field and lists the rest.\n */\nexport const requestLogSnapshot: Codemod = {\n  id: \"request-log-snapshot\",\n  version: \"5.30.0\",\n  package: \"@warlock.js/core\",\n  title: \"Read request log snapshots in custom log channels\",\n  skill: \"upgrade-from-5-29\",\n  run(context) {\n    const { Node, SyntaxKind } = context.tsMorph;\n    const output: CodemodOutput = { edits: [], manual: [] };\n\n    for (const sourceFile of context.sourceFiles) {\n      if (importedLocalNames(sourceFile, \"@warlock.js/logger\", \"LogChannel\").size === 0) continue;\n\n      for (const access of sourceFile.getDescendantsOfKind(SyntaxKind.PropertyAccessExpression)) {\n        const owner = access.getExpression();\n        // `<anything>.context.request` / `.context.response`\n        if (!Node.isPropertyAccessExpression(owner) || owner.getName() !== \"context\") continue;\n        const target = access.getName();\n        if (target !== \"request\" && target !== \"response\") continue;\n\n        const chain = memberChain(Node, access);\n        if (chain.length === 0) continue;\n\n        const first = chain[0] as TsMorph.PropertyAccessExpression;\n        const second = chain[1];\n        const pair = second ? `${first.getName()}.${second.getName()}` : undefined;\n        const replacement = pair ? REWRITES[pair] : undefined;\n\n        if (target === \"request\" && replacement && second) {\n          output.edits.push(\n            replaceNode(\n              context,\n              second,\n              `${access.getText()}.${replacement}`,\n              `context.request.${pair} → context.request.${replacement}`,\n            ),\n          );\n          continue;\n        }\n\n        const field = first.getName();\n        const isCall = Node.isCallExpression(first.getParent());\n        // `route` is the matched pattern string now, not the route object.\n        const readsRouteObject = target === \"request\" && field === \"route\" && second !== undefined;\n        if (!SNAPSHOT_FIELDS.has(field) || isCall || readsRouteObject) {\n          output.manual.push(\n            manualAt(\n              context,\n              first,\n              `\\`context.${target}.${field}\\` is not on the log snapshot ({ id, method, url, route, name, ip, userAgent, query?, body? }). Read a snapshot field, or call \\`request.toLogSnapshot()\\` where the entry is logged.`,\n            ),\n          );\n        }\n      }\n    }\n\n    return output;\n  },\n};\n\n/** `x.context.request.a.b` → [`…request.a`, `…request.a.b`]. */\nfunction memberChain(\n  Node: typeof TsMorph.Node,\n  start: TsMorph.PropertyAccessExpression,\n): TsMorph.PropertyAccessExpression[] {\n  const chain: TsMorph.PropertyAccessExpression[] = [];\n  let current: TsMorph.Node = start;\n\n  for (;;) {\n    const parent = current.getParent();\n    if (!parent || !Node.isPropertyAccessExpression(parent) || parent.getExpression() !== current) {\n      return chain;\n    }\n    chain.push(parent);\n    current = parent;\n  }\n}\n"],"mappings":";;;;AAKA,MAAM,kBAAkB,IAAI,IAAI;CAC9B;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF,CAAC;;AAGD,MAAM,WAAmC;CACvC,mBAAmB;CACnB,sBAAsB;CACtB,kBAAkB;CAClB,cAAc;CACd,cAAc;AAChB;;;;;;AAOA,MAAa,qBAA8B;CACzC,IAAI;CACJ,SAAS;CACT,SAAS;CACT,OAAO;CACP,OAAO;CACP,IAAI,SAAS;EACX,MAAM,EAAE,MAAM,eAAe,QAAQ;EACrC,MAAM,SAAwB;GAAE,OAAO,CAAC;GAAG,QAAQ,CAAC;EAAE;EAEtD,KAAK,MAAM,cAAc,QAAQ,aAAa;GAC5C,IAAI,mBAAmB,YAAY,sBAAsB,YAAY,CAAC,CAAC,SAAS,GAAG;GAEnF,KAAK,MAAM,UAAU,WAAW,qBAAqB,WAAW,wBAAwB,GAAG;IACzF,MAAM,QAAQ,OAAO,cAAc;IAEnC,IAAI,CAAC,KAAK,2BAA2B,KAAK,KAAK,MAAM,QAAQ,MAAM,WAAW;IAC9E,MAAM,SAAS,OAAO,QAAQ;IAC9B,IAAI,WAAW,aAAa,WAAW,YAAY;IAEnD,MAAM,QAAQ,YAAY,MAAM,MAAM;IACtC,IAAI,MAAM,WAAW,GAAG;IAExB,MAAM,QAAQ,MAAM;IACpB,MAAM,SAAS,MAAM;IACrB,MAAM,OAAO,SAAS,GAAG,MAAM,QAAQ,EAAE,GAAG,OAAO,QAAQ,MAAM;IACjE,MAAM,cAAc,OAAO,SAAS,QAAQ;IAE5C,IAAI,WAAW,aAAa,eAAe,QAAQ;KACjD,OAAO,MAAM,KACX,YACE,SACA,QACA,GAAG,OAAO,QAAQ,EAAE,GAAG,eACvB,mBAAmB,KAAK,qBAAqB,aAC/C,CACF;KACA;IACF;IAEA,MAAM,QAAQ,MAAM,QAAQ;IAC5B,MAAM,SAAS,KAAK,iBAAiB,MAAM,UAAU,CAAC;IAEtD,MAAM,mBAAmB,WAAW,aAAa,UAAU,WAAW,WAAW;IACjF,IAAI,CAAC,gBAAgB,IAAI,KAAK,KAAK,UAAU,kBAC3C,OAAO,OAAO,KACZ,SACE,SACA,OACA,aAAa,OAAO,GAAG,MAAM,sLAC/B,CACF;GAEJ;EACF;EAEA,OAAO;CACT;AACF;;AAGA,SAAS,YACP,MACA,OACoC;CACpC,MAAM,QAA4C,CAAC;CACnD,IAAI,UAAwB;CAE5B,SAAS;EACP,MAAM,SAAS,QAAQ,UAAU;EACjC,IAAI,CAAC,UAAU,CAAC,KAAK,2BAA2B,MAAM,KAAK,OAAO,cAAc,MAAM,SACpF,OAAO;EAET,MAAM,KAAK,MAAM;EACjB,UAAU;CACZ;AACF"}
+{"version":3,"file":"request-log-snapshot.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/upgrade/codemods/request-log-snapshot.ts"],"sourcesContent":["import type * as TsMorph from \"ts-morph\";\nimport type { Codemod, CodemodOutput } from \"../types\";\nimport { importedLocalNames, manualAt, replaceNode } from \"./helpers\";\n\n/** Fields of the `RequestLogSnapshot` a log channel now receives. */\nconst SNAPSHOT_FIELDS = new Set([\n  \"id\",\n  \"method\",\n  \"url\",\n  \"route\",\n  \"name\",\n  \"ip\",\n  \"userAgent\",\n  \"query\",\n  \"body\",\n  \"statusCode\",\n]);\n\n/** `request.<a>.<b>` reads with a snapshot equivalent. */\nconst REWRITES: Record<string, string> = {\n  \"baseRequest.url\": \"url\",\n  \"baseRequest.method\": \"method\",\n  \"baseRequest.ip\": \"ip\",\n  \"route.path\": \"route\",\n  \"route.name\": \"name\",\n};\n\n/**\n * 5.30: request log entries carry a plain `RequestLogSnapshot` in\n * `context.request`, not the `Request` instance. Inside custom log channels,\n * rewrites the reads that have a direct snapshot field and lists the rest.\n */\nexport const requestLogSnapshot: Codemod = {\n  id: \"request-log-snapshot\",\n  version: \"5.30.0\",\n  package: \"@warlock.js/core\",\n  title: \"Read request log snapshots in custom log channels\",\n  skill: \"upgrade-from-5-29\",\n  run(context) {\n    const { Node, SyntaxKind } = context.tsMorph;\n    const output: CodemodOutput = { edits: [], manual: [] };\n\n    for (const sourceFile of context.sourceFiles) {\n      if (importedLocalNames(sourceFile, \"@warlock.js/logger\", \"LogChannel\").size === 0) continue;\n\n      for (const access of sourceFile.getDescendantsOfKind(SyntaxKind.PropertyAccessExpression)) {\n        const owner = access.getExpression();\n        // `<anything>.context.request` / `.context.response`\n        if (!Node.isPropertyAccessExpression(owner) || owner.getName() !== \"context\") continue;\n        const target = access.getName();\n        if (target !== \"request\" && target !== \"response\") continue;\n\n        const chain = memberChain(Node, access);\n        if (chain.length === 0) continue;\n\n        const first = chain[0] as TsMorph.PropertyAccessExpression;\n        const second = chain[1];\n        const pair = second ? `${first.getName()}.${second.getName()}` : undefined;\n        const replacement = pair ? REWRITES[pair] : undefined;\n\n        if (target === \"request\" && replacement && second) {\n          output.edits.push(\n            replaceNode(\n              context,\n              second,\n              `${access.getText()}.${replacement}`,\n              `context.request.${pair} → context.request.${replacement}`,\n            ),\n          );\n          continue;\n        }\n\n        const field = first.getName();\n        const isCall = Node.isCallExpression(first.getParent());\n        // `route` is the matched pattern string now, not the route object.\n        const readsRouteObject = target === \"request\" && field === \"route\" && second !== undefined;\n        if (!SNAPSHOT_FIELDS.has(field) || isCall || readsRouteObject) {\n          output.manual.push(\n            manualAt(\n              context,\n              first,\n              `\\`context.${target}.${field}\\` is not on the log snapshot ({ id, method, url, route, name, ip, userAgent, query?, body? }). Read a snapshot field, or call \\`request.toLogSnapshot()\\` where the entry is logged.`,\n            ),\n          );\n        }\n      }\n    }\n\n    return output;\n  },\n};\n\n/** `x.context.request.a.b` → [`…request.a`, `…request.a.b`]. */\nfunction memberChain(\n  Node: typeof TsMorph.Node,\n  start: TsMorph.PropertyAccessExpression,\n): TsMorph.PropertyAccessExpression[] {\n  const chain: TsMorph.PropertyAccessExpression[] = [];\n  let current: TsMorph.Node = start;\n\n  for (;;) {\n    const parent = current.getParent();\n    if (!parent || !Node.isPropertyAccessExpression(parent) || parent.getExpression() !== current) {\n      return chain;\n    }\n    chain.push(parent);\n    current = parent;\n  }\n}\n"],"mappings":";;;;AAKA,MAAM,kCAAkB,IAAI,IAAI;CAC9B;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF,CAAC;;AAGD,MAAM,WAAmC;CACvC,mBAAmB;CACnB,sBAAsB;CACtB,kBAAkB;CAClB,cAAc;CACd,cAAc;AAChB;;;;;;AAOA,MAAa,qBAA8B;CACzC,IAAI;CACJ,SAAS;CACT,SAAS;CACT,OAAO;CACP,OAAO;CACP,IAAI,SAAS;EACX,MAAM,EAAE,MAAM,eAAe,QAAQ;EACrC,MAAM,SAAwB;GAAE,OAAO,CAAC;GAAG,QAAQ,CAAC;EAAE;EAEtD,KAAK,MAAM,cAAc,QAAQ,aAAa;GAC5C,IAAI,mBAAmB,YAAY,sBAAsB,YAAY,CAAC,CAAC,SAAS,GAAG;GAEnF,KAAK,MAAM,UAAU,WAAW,qBAAqB,WAAW,wBAAwB,GAAG;IACzF,MAAM,QAAQ,OAAO,cAAc;IAEnC,IAAI,CAAC,KAAK,2BAA2B,KAAK,KAAK,MAAM,QAAQ,MAAM,WAAW;IAC9E,MAAM,SAAS,OAAO,QAAQ;IAC9B,IAAI,WAAW,aAAa,WAAW,YAAY;IAEnD,MAAM,QAAQ,YAAY,MAAM,MAAM;IACtC,IAAI,MAAM,WAAW,GAAG;IAExB,MAAM,QAAQ,MAAM;IACpB,MAAM,SAAS,MAAM;IACrB,MAAM,OAAO,SAAS,GAAG,MAAM,QAAQ,EAAE,GAAG,OAAO,QAAQ,MAAM;IACjE,MAAM,cAAc,OAAO,SAAS,QAAQ;IAE5C,IAAI,WAAW,aAAa,eAAe,QAAQ;KACjD,OAAO,MAAM,KACX,YACE,SACA,QACA,GAAG,OAAO,QAAQ,EAAE,GAAG,eACvB,mBAAmB,KAAK,qBAAqB,aAC/C,CACF;KACA;IACF;IAEA,MAAM,QAAQ,MAAM,QAAQ;IAC5B,MAAM,SAAS,KAAK,iBAAiB,MAAM,UAAU,CAAC;IAEtD,MAAM,mBAAmB,WAAW,aAAa,UAAU,WAAW,WAAW;IACjF,IAAI,CAAC,gBAAgB,IAAI,KAAK,KAAK,UAAU,kBAC3C,OAAO,OAAO,KACZ,SACE,SACA,OACA,aAAa,OAAO,GAAG,MAAM,sLAC/B,CACF;GAEJ;EACF;EAEA,OAAO;CACT;AACF;;AAGA,SAAS,YACP,MACA,OACoC;CACpC,MAAM,QAA4C,CAAC;CACnD,IAAI,UAAwB;CAE5B,SAAS;EACP,MAAM,SAAS,QAAQ,UAAU;EACjC,IAAI,CAAC,UAAU,CAAC,KAAK,2BAA2B,MAAM,KAAK,OAAO,cAAc,MAAM,SACpF,OAAO;EAET,MAAM,KAAK,MAAM;EACjB,UAAU;CACZ;AACF"}

package/esm/upgrade/diff.mjs

@@ -75,7 +75,7 @@ function formatHunks(operations) {
 	while (cursor < changed.length) {
 		const firstChange = changed[cursor] ?? 0;
 		let lastChange = firstChange;
-		while (cursor + 1 < changed.length && (changed[cursor + 1] ?? 0) - lastChange <= CONTEXT * 2) {
+		while (cursor + 1 < changed.length && (changed[cursor + 1] ?? 0) - lastChange <= 6) {
 			cursor++;
 			lastChange = changed[cursor] ?? lastChange;
 		}

package/esm/upgrade/diff.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"diff.mjs","names":[],"sources":["../../../../../../../../packages/core/src/upgrade/diff.ts"],"sourcesContent":["/**\n * A minimal unified diff (`diff -u` shape, 3 lines of context) between two\n * versions of one file, enough for `warlock upgrade --dry-run` to show what\n * it would change. Line-based longest common subsequence; files too large for\n * that are shown as one replaced hunk.\n */\nconst CONTEXT = 3;\nconst MAX_CELLS = 16_000_000;\n\ntype Operation = { type: \"same\" | \"removed\" | \"added\"; text: string };\n\nexport function unifiedDiff(file: string, before: string, after: string): string {\n  if (before === after) return \"\";\n\n  const oldLines = splitLines(before);\n  const newLines = splitLines(after);\n  const operations = diffLines(oldLines, newLines);\n\n  const header = `--- a/${file}\\n+++ b/${file}\\n`;\n  return header + formatHunks(operations);\n}\n\nfunction splitLines(text: string): string[] {\n  if (text === \"\") return [];\n  const lines = text.split(\"\\n\");\n  if (lines[lines.length - 1] === \"\") lines.pop();\n  return lines;\n}\n\nfunction diffLines(oldLines: string[], newLines: string[]): Operation[] {\n  const n = oldLines.length;\n  const m = newLines.length;\n\n  if (n * m > MAX_CELLS) {\n    return [\n      ...oldLines.map((text): Operation => ({ type: \"removed\", text })),\n      ...newLines.map((text): Operation => ({ type: \"added\", text })),\n    ];\n  }\n\n  // lengths[i][j] = LCS length of oldLines[i..] and newLines[j..]\n  const lengths: Uint32Array[] = [];\n  for (let i = 0; i <= n; i++) lengths.push(new Uint32Array(m + 1));\n\n  for (let i = n - 1; i >= 0; i--) {\n    const row = lengths[i] as Uint32Array;\n    const below = lengths[i + 1] as Uint32Array;\n    for (let j = m - 1; j >= 0; j--) {\n      row[j] =\n        oldLines[i] === newLines[j]\n          ? (below[j + 1] ?? 0) + 1\n          : Math.max(below[j] ?? 0, row[j + 1] ?? 0);\n    }\n  }\n\n  const operations: Operation[] = [];\n  let i = 0;\n  let j = 0;\n  while (i < n && j < m) {\n    if (oldLines[i] === newLines[j]) {\n      operations.push({ type: \"same\", text: oldLines[i] ?? \"\" });\n      i++;\n      j++;\n    } else if ((lengths[i + 1]?.[j] ?? 0) >= (lengths[i]?.[j + 1] ?? 0)) {\n      operations.push({ type: \"removed\", text: oldLines[i] ?? \"\" });\n      i++;\n    } else {\n      operations.push({ type: \"added\", text: newLines[j] ?? \"\" });\n      j++;\n    }\n  }\n  while (i < n) operations.push({ type: \"removed\", text: oldLines[i++] ?? \"\" });\n  while (j < m) operations.push({ type: \"added\", text: newLines[j++] ?? \"\" });\n\n  return operations;\n}\n\nfunction formatHunks(operations: Operation[]): string {\n  const changed = operations\n    .map((operation, index) => (operation.type === \"same\" ? -1 : index))\n    .filter((index) => index >= 0);\n\n  let output = \"\";\n  let cursor = 0;\n\n  while (cursor < changed.length) {\n    const firstChange = changed[cursor] ?? 0;\n    let lastChange = firstChange;\n    // Merge changes whose context windows touch.\n    while (cursor + 1 < changed.length && (changed[cursor + 1] ?? 0) - lastChange <= CONTEXT * 2) {\n      cursor++;\n      lastChange = changed[cursor] ?? lastChange;\n    }\n    cursor++;\n\n    const start = Math.max(0, firstChange - CONTEXT);\n    const end = Math.min(operations.length, lastChange + CONTEXT + 1);\n\n    let oldStart = 1;\n    let newStart = 1;\n    for (let index = 0; index < start; index++) {\n      const type = operations[index]?.type;\n      if (type !== \"added\") oldStart++;\n      if (type !== \"removed\") newStart++;\n    }\n\n    let oldCount = 0;\n    let newCount = 0;\n    let body = \"\";\n    for (let index = start; index < end; index++) {\n      const operation = operations[index];\n      if (!operation) continue;\n      if (operation.type === \"same\") {\n        oldCount++;\n        newCount++;\n        body += ` ${operation.text}\\n`;\n      } else if (operation.type === \"removed\") {\n        oldCount++;\n        body += `-${operation.text}\\n`;\n      } else {\n        newCount++;\n        body += `+${operation.text}\\n`;\n      }\n    }\n\n    const oldRange = oldCount === 0 ? `${oldStart - 1},0` : `${oldStart},${oldCount}`;\n    const newRange = newCount === 0 ? `${newStart - 1},0` : `${newStart},${newCount}`;\n    output += `@@ -${oldRange} +${newRange} @@\\n${body}`;\n  }\n\n  return output;\n}\n"],"mappings":"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"}
+{"version":3,"file":"diff.mjs","names":[],"sources":["../../../../../../../../packages/core/src/upgrade/diff.ts"],"sourcesContent":["/**\n * A minimal unified diff (`diff -u` shape, 3 lines of context) between two\n * versions of one file, enough for `warlock upgrade --dry-run` to show what\n * it would change. Line-based longest common subsequence; files too large for\n * that are shown as one replaced hunk.\n */\nconst CONTEXT = 3;\nconst MAX_CELLS = 16_000_000;\n\ntype Operation = { type: \"same\" | \"removed\" | \"added\"; text: string };\n\nexport function unifiedDiff(file: string, before: string, after: string): string {\n  if (before === after) return \"\";\n\n  const oldLines = splitLines(before);\n  const newLines = splitLines(after);\n  const operations = diffLines(oldLines, newLines);\n\n  const header = `--- a/${file}\\n+++ b/${file}\\n`;\n  return header + formatHunks(operations);\n}\n\nfunction splitLines(text: string): string[] {\n  if (text === \"\") return [];\n  const lines = text.split(\"\\n\");\n  if (lines[lines.length - 1] === \"\") lines.pop();\n  return lines;\n}\n\nfunction diffLines(oldLines: string[], newLines: string[]): Operation[] {\n  const n = oldLines.length;\n  const m = newLines.length;\n\n  if (n * m > MAX_CELLS) {\n    return [\n      ...oldLines.map((text): Operation => ({ type: \"removed\", text })),\n      ...newLines.map((text): Operation => ({ type: \"added\", text })),\n    ];\n  }\n\n  // lengths[i][j] = LCS length of oldLines[i..] and newLines[j..]\n  const lengths: Uint32Array[] = [];\n  for (let i = 0; i <= n; i++) lengths.push(new Uint32Array(m + 1));\n\n  for (let i = n - 1; i >= 0; i--) {\n    const row = lengths[i] as Uint32Array;\n    const below = lengths[i + 1] as Uint32Array;\n    for (let j = m - 1; j >= 0; j--) {\n      row[j] =\n        oldLines[i] === newLines[j]\n          ? (below[j + 1] ?? 0) + 1\n          : Math.max(below[j] ?? 0, row[j + 1] ?? 0);\n    }\n  }\n\n  const operations: Operation[] = [];\n  let i = 0;\n  let j = 0;\n  while (i < n && j < m) {\n    if (oldLines[i] === newLines[j]) {\n      operations.push({ type: \"same\", text: oldLines[i] ?? \"\" });\n      i++;\n      j++;\n    } else if ((lengths[i + 1]?.[j] ?? 0) >= (lengths[i]?.[j + 1] ?? 0)) {\n      operations.push({ type: \"removed\", text: oldLines[i] ?? \"\" });\n      i++;\n    } else {\n      operations.push({ type: \"added\", text: newLines[j] ?? \"\" });\n      j++;\n    }\n  }\n  while (i < n) operations.push({ type: \"removed\", text: oldLines[i++] ?? \"\" });\n  while (j < m) operations.push({ type: \"added\", text: newLines[j++] ?? \"\" });\n\n  return operations;\n}\n\nfunction formatHunks(operations: Operation[]): string {\n  const changed = operations\n    .map((operation, index) => (operation.type === \"same\" ? -1 : index))\n    .filter((index) => index >= 0);\n\n  let output = \"\";\n  let cursor = 0;\n\n  while (cursor < changed.length) {\n    const firstChange = changed[cursor] ?? 0;\n    let lastChange = firstChange;\n    // Merge changes whose context windows touch.\n    while (cursor + 1 < changed.length && (changed[cursor + 1] ?? 0) - lastChange <= CONTEXT * 2) {\n      cursor++;\n      lastChange = changed[cursor] ?? lastChange;\n    }\n    cursor++;\n\n    const start = Math.max(0, firstChange - CONTEXT);\n    const end = Math.min(operations.length, lastChange + CONTEXT + 1);\n\n    let oldStart = 1;\n    let newStart = 1;\n    for (let index = 0; index < start; index++) {\n      const type = operations[index]?.type;\n      if (type !== \"added\") oldStart++;\n      if (type !== \"removed\") newStart++;\n    }\n\n    let oldCount = 0;\n    let newCount = 0;\n    let body = \"\";\n    for (let index = start; index < end; index++) {\n      const operation = operations[index];\n      if (!operation) continue;\n      if (operation.type === \"same\") {\n        oldCount++;\n        newCount++;\n        body += ` ${operation.text}\\n`;\n      } else if (operation.type === \"removed\") {\n        oldCount++;\n        body += `-${operation.text}\\n`;\n      } else {\n        newCount++;\n        body += `+${operation.text}\\n`;\n      }\n    }\n\n    const oldRange = oldCount === 0 ? `${oldStart - 1},0` : `${oldStart},${oldCount}`;\n    const newRange = newCount === 0 ? `${newStart - 1},0` : `${newStart},${newCount}`;\n    output += `@@ -${oldRange} +${newRange} @@\\n${body}`;\n  }\n\n  return output;\n}\n"],"mappings":";;;;;;;AAMA,MAAM,UAAU;AAChB,MAAM,YAAY;AAIlB,SAAgB,YAAY,MAAc,QAAgB,OAAuB;CAC/E,IAAI,WAAW,OAAO,OAAO;CAI7B,MAAM,aAAa,UAFF,WAAW,MAEQ,GADnB,WAAW,KACkB,CAAC;CAG/C,OAAO,SADiB,KAAK,UAAU,KAAK,MAC5B,YAAY,UAAU;AACxC;AAEA,SAAS,WAAW,MAAwB;CAC1C,IAAI,SAAS,IAAI,OAAO,CAAC;CACzB,MAAM,QAAQ,KAAK,MAAM,IAAI;CAC7B,IAAI,MAAM,MAAM,SAAS,OAAO,IAAI,MAAM,IAAI;CAC9C,OAAO;AACT;AAEA,SAAS,UAAU,UAAoB,UAAiC;CACtE,MAAM,IAAI,SAAS;CACnB,MAAM,IAAI,SAAS;CAEnB,IAAI,IAAI,IAAI,WACV,OAAO,CACL,GAAG,SAAS,KAAK,UAAqB;EAAE,MAAM;EAAW;CAAK,EAAE,GAChE,GAAG,SAAS,KAAK,UAAqB;EAAE,MAAM;EAAS;CAAK,EAAE,CAChE;CAIF,MAAM,UAAyB,CAAC;CAChC,KAAK,IAAI,IAAI,GAAG,KAAK,GAAG,KAAK,QAAQ,KAAK,IAAI,YAAY,IAAI,CAAC,CAAC;CAEhE,KAAK,IAAI,IAAI,IAAI,GAAG,KAAK,GAAG,KAAK;EAC/B,MAAM,MAAM,QAAQ;EACpB,MAAM,QAAQ,QAAQ,IAAI;EAC1B,KAAK,IAAI,IAAI,IAAI,GAAG,KAAK,GAAG,KAC1B,IAAI,KACF,SAAS,OAAO,SAAS,MACpB,MAAM,IAAI,MAAM,KAAK,IACtB,KAAK,IAAI,MAAM,MAAM,GAAG,IAAI,IAAI,MAAM,CAAC;CAEjD;CAEA,MAAM,aAA0B,CAAC;CACjC,IAAI,IAAI;CACR,IAAI,IAAI;CACR,OAAO,IAAI,KAAK,IAAI,GAClB,IAAI,SAAS,OAAO,SAAS,IAAI;EAC/B,WAAW,KAAK;GAAE,MAAM;GAAQ,MAAM,SAAS,MAAM;EAAG,CAAC;EACzD;EACA;CACF,OAAO,KAAK,QAAQ,IAAI,EAAE,GAAG,MAAM,OAAO,QAAQ,EAAE,GAAG,IAAI,MAAM,IAAI;EACnE,WAAW,KAAK;GAAE,MAAM;GAAW,MAAM,SAAS,MAAM;EAAG,CAAC;EAC5D;CACF,OAAO;EACL,WAAW,KAAK;GAAE,MAAM;GAAS,MAAM,SAAS,MAAM;EAAG,CAAC;EAC1D;CACF;CAEF,OAAO,IAAI,GAAG,WAAW,KAAK;EAAE,MAAM;EAAW,MAAM,SAAS,QAAQ;CAAG,CAAC;CAC5E,OAAO,IAAI,GAAG,WAAW,KAAK;EAAE,MAAM;EAAS,MAAM,SAAS,QAAQ;CAAG,CAAC;CAE1E,OAAO;AACT;AAEA,SAAS,YAAY,YAAiC;CACpD,MAAM,UAAU,WACb,KAAK,WAAW,UAAW,UAAU,SAAS,SAAS,KAAK,KAAM,CAAC,CACnE,QAAQ,UAAU,SAAS,CAAC;CAE/B,IAAI,SAAS;CACb,IAAI,SAAS;CAEb,OAAO,SAAS,QAAQ,QAAQ;EAC9B,MAAM,cAAc,QAAQ,WAAW;EACvC,IAAI,aAAa;EAEjB,OAAO,SAAS,IAAI,QAAQ,WAAW,QAAQ,SAAS,MAAM,KAAK,cAAc,GAAa;GAC5F;GACA,aAAa,QAAQ,WAAW;EAClC;EACA;EAEA,MAAM,QAAQ,KAAK,IAAI,GAAG,cAAc,OAAO;EAC/C,MAAM,MAAM,KAAK,IAAI,WAAW,QAAQ,aAAa,UAAU,CAAC;EAEhE,IAAI,WAAW;EACf,IAAI,WAAW;EACf,KAAK,IAAI,QAAQ,GAAG,QAAQ,OAAO,SAAS;GAC1C,MAAM,OAAO,WAAW,MAAM,EAAE;GAChC,IAAI,SAAS,SAAS;GACtB,IAAI,SAAS,WAAW;EAC1B;EAEA,IAAI,WAAW;EACf,IAAI,WAAW;EACf,IAAI,OAAO;EACX,KAAK,IAAI,QAAQ,OAAO,QAAQ,KAAK,SAAS;GAC5C,MAAM,YAAY,WAAW;GAC7B,IAAI,CAAC,WAAW;GAChB,IAAI,UAAU,SAAS,QAAQ;IAC7B;IACA;IACA,QAAQ,IAAI,UAAU,KAAK;GAC7B,OAAO,IAAI,UAAU,SAAS,WAAW;IACvC;IACA,QAAQ,IAAI,UAAU,KAAK;GAC7B,OAAO;IACL;IACA,QAAQ,IAAI,UAAU,KAAK;GAC7B;EACF;EAEA,MAAM,WAAW,aAAa,IAAI,GAAG,WAAW,EAAE,MAAM,GAAG,SAAS,GAAG;EACvE,MAAM,WAAW,aAAa,IAAI,GAAG,WAAW,EAAE,MAAM,GAAG,SAAS,GAAG;EACvE,UAAU,OAAO,SAAS,IAAI,SAAS,OAAO;CAChD;CAEA,OAAO;AACT"}

package/esm/upgrade/load-ts-morph.mjs

@@ -28,7 +28,8 @@ function tsMorphInstallCommand(packageManager) {
 */
 async function loadTsMorph(root) {
 	try {
-		return fromNamespace(await import(pathToFileURL(createRequire(path.join(root, "package.json")).resolve("ts-morph")).href));
+		const resolved = createRequire(path.join(root, "package.json")).resolve("ts-morph");
+		return fromNamespace(await import(pathToFileURL(resolved).href));
 	} catch {}
 	try {
 		return fromNamespace(await import("ts-morph"));
@@ -44,5 +45,5 @@ function fromNamespace(namespace) {
 }
 
 //#endregion
-export { TsMorphMissingError, loadTsMorph };
+export { TsMorphMissingError, loadTsMorph, tsMorphInstallCommand };
 //# sourceMappingURL=load-ts-morph.mjs.map

package/esm/upgrade/load-ts-morph.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"load-ts-morph.mjs","names":[],"sources":["../../../../../../../../packages/core/src/upgrade/load-ts-morph.ts"],"sourcesContent":["import { createRequire } from \"node:module\";\nimport path from \"node:path\";\nimport { pathToFileURL } from \"node:url\";\nimport { detectPackageManager, type PackageManager } from \"../updater/package-manager\";\nimport type { TsMorphModule } from \"./types\";\n\n/** Thrown when `ts-morph` is not installed; the message says how to add it. */\nexport class TsMorphMissingError extends Error {\n  public override readonly name = \"TsMorphMissingError\";\n\n  public constructor(public readonly installCommand: string) {\n    super(\n      `warlock upgrade edits source files with ts-morph, which is not installed. ` +\n        `Add it as a development dependency, then run the command again:\\n\\n  ${installCommand}\\n`,\n    );\n  }\n}\n\n/** The dev-dependency install command for `ts-morph` with this package manager. */\nexport function tsMorphInstallCommand(packageManager: PackageManager): string {\n  switch (packageManager) {\n    case \"pnpm\":\n      return \"pnpm add --save-dev ts-morph\";\n    case \"yarn\":\n      return \"yarn add --dev ts-morph\";\n    case \"bun\":\n      return \"bun add --dev ts-morph\";\n    default:\n      return \"npm install --save-dev ts-morph\";\n  }\n}\n\n/**\n * Load `ts-morph` lazily: it is an optional peer of `@warlock.js/core`, needed\n * only by `warlock upgrade`. Resolved from the app first (where the user\n * installs it), then from core's own location.\n */\nexport async function loadTsMorph(root: string): Promise<TsMorphModule> {\n  try {\n    const resolved = createRequire(path.join(root, \"package.json\")).resolve(\"ts-morph\");\n    return fromNamespace(await import(pathToFileURL(resolved).href));\n  } catch {\n    // Not in the app; try core's own resolution below.\n  }\n\n  try {\n    return fromNamespace(await import(\"ts-morph\"));\n  } catch {\n    throw new TsMorphMissingError(tsMorphInstallCommand(await detectPackageManager(root)));\n  }\n}\n\n/** A CommonJS package imported from ESM may expose its API on `default` only. */\nfunction fromNamespace(namespace: unknown): TsMorphModule {\n  const candidate = namespace as { Project?: unknown; default?: unknown };\n  if (typeof candidate.Project === \"function\") return namespace as TsMorphModule;\n  return candidate.default as TsMorphModule;\n}\n"],"mappings":";;;;;;;AAOA,IAAa,sBAAb,cAAyC,MAAM;CAG7C,AAAO,YAAY,AAAgB,gBAAwB;EACzD,MACE,kJAC0E,eAAe,GAC3F;EAJiC;cAFH;CAOhC;AACF;;AAGA,SAAgB,sBAAsB,gBAAwC;CAC5E,QAAQ,gBAAR;EACE,KAAK,QACH,OAAO;EACT,KAAK,QACH,OAAO;EACT,KAAK,OACH,OAAO;EACT,SACE,OAAO;CACX;AACF;;;;;;AAOA,eAAsB,YAAY,MAAsC;CACtE,IAAI;EAEF,OAAO,cAAc,MAAM,OAAO,cADjB,cAAc,KAAK,KAAK,MAAM,cAAc,CAAC,CAAC,CAAC,QAAQ,UACjB,CAAC,CAAC,CAAC,KAAK;CACjE,QAAQ,CAER;CAEA,IAAI;EACF,OAAO,cAAc,MAAM,OAAO,WAAW;CAC/C,QAAQ;EACN,MAAM,IAAI,oBAAoB,sBAAsB,MAAM,qBAAqB,IAAI,CAAC,CAAC;CACvF;AACF;;AAGA,SAAS,cAAc,WAAmC;CACxD,MAAM,YAAY;CAClB,IAAI,OAAO,UAAU,YAAY,YAAY,OAAO;CACpD,OAAO,UAAU;AACnB"}
+{"version":3,"file":"load-ts-morph.mjs","names":[],"sources":["../../../../../../../../packages/core/src/upgrade/load-ts-morph.ts"],"sourcesContent":["import { createRequire } from \"node:module\";\nimport path from \"node:path\";\nimport { pathToFileURL } from \"node:url\";\nimport { detectPackageManager, type PackageManager } from \"../updater/package-manager\";\nimport type { TsMorphModule } from \"./types\";\n\n/** Thrown when `ts-morph` is not installed; the message says how to add it. */\nexport class TsMorphMissingError extends Error {\n  public override readonly name = \"TsMorphMissingError\";\n\n  public constructor(public readonly installCommand: string) {\n    super(\n      `warlock upgrade edits source files with ts-morph, which is not installed. ` +\n        `Add it as a development dependency, then run the command again:\\n\\n  ${installCommand}\\n`,\n    );\n  }\n}\n\n/** The dev-dependency install command for `ts-morph` with this package manager. */\nexport function tsMorphInstallCommand(packageManager: PackageManager): string {\n  switch (packageManager) {\n    case \"pnpm\":\n      return \"pnpm add --save-dev ts-morph\";\n    case \"yarn\":\n      return \"yarn add --dev ts-morph\";\n    case \"bun\":\n      return \"bun add --dev ts-morph\";\n    default:\n      return \"npm install --save-dev ts-morph\";\n  }\n}\n\n/**\n * Load `ts-morph` lazily: it is an optional peer of `@warlock.js/core`, needed\n * only by `warlock upgrade`. Resolved from the app first (where the user\n * installs it), then from core's own location.\n */\nexport async function loadTsMorph(root: string): Promise<TsMorphModule> {\n  try {\n    const resolved = createRequire(path.join(root, \"package.json\")).resolve(\"ts-morph\");\n    return fromNamespace(await import(pathToFileURL(resolved).href));\n  } catch {\n    // Not in the app; try core's own resolution below.\n  }\n\n  try {\n    return fromNamespace(await import(\"ts-morph\"));\n  } catch {\n    throw new TsMorphMissingError(tsMorphInstallCommand(await detectPackageManager(root)));\n  }\n}\n\n/** A CommonJS package imported from ESM may expose its API on `default` only. */\nfunction fromNamespace(namespace: unknown): TsMorphModule {\n  const candidate = namespace as { Project?: unknown; default?: unknown };\n  if (typeof candidate.Project === \"function\") return namespace as TsMorphModule;\n  return candidate.default as TsMorphModule;\n}\n"],"mappings":";;;;;;;AAOA,IAAa,sBAAb,cAAyC,MAAM;CAG7C,AAAO,YAAY,AAAgB,gBAAwB;EACzD,MACE,kJAC0E,eAAe,GAC3F;EAJiC;cAFH;CAOhC;AACF;;AAGA,SAAgB,sBAAsB,gBAAwC;CAC5E,QAAQ,gBAAR;EACE,KAAK,QACH,OAAO;EACT,KAAK,QACH,OAAO;EACT,KAAK,OACH,OAAO;EACT,SACE,OAAO;CACX;AACF;;;;;;AAOA,eAAsB,YAAY,MAAsC;CACtE,IAAI;EACF,MAAM,WAAW,cAAc,KAAK,KAAK,MAAM,cAAc,CAAC,CAAC,CAAC,QAAQ,UAAU;EAClF,OAAO,cAAc,MAAM,OAAO,cAAc,QAAQ,CAAC,CAAC,KAAK;CACjE,QAAQ,CAER;CAEA,IAAI;EACF,OAAO,cAAc,MAAM,OAAO,WAAW;CAC/C,QAAQ;EACN,MAAM,IAAI,oBAAoB,sBAAsB,MAAM,qBAAqB,IAAI,CAAC,CAAC;CACvF;AACF;;AAGA,SAAS,cAAc,WAAmC;CACxD,MAAM,YAAY;CAClB,IAAI,OAAO,UAAU,YAAY,YAAY,OAAO;CACpD,OAAO,UAAU;AACnB"}

package/esm/upgrade/run-upgrade.mjs

@@ -242,5 +242,5 @@ function createTextFiles(root) {
 }
 
 //#endregion
-export { UpgradeUsageError, runUpgrade };
+export { UpgradeUsageError, detectInstalledVersion, runUpgrade };
 //# sourceMappingURL=run-upgrade.mjs.map

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":"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"}
+{"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"}