@pristine-ts/cli 2.0.7 → 2.0.17

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (243) hide show
  1. package/dist/lib/cjs/bootstrap/build-staleness-prompt.js +12 -13
  2. package/dist/lib/cjs/bootstrap/build-staleness-prompt.js.map +1 -1
  3. package/dist/lib/cjs/bootstrap/init-prompt.js +16 -47
  4. package/dist/lib/cjs/bootstrap/init-prompt.js.map +1 -1
  5. package/dist/lib/cjs/cli.configuration-keys.js +24 -0
  6. package/dist/lib/cjs/cli.configuration-keys.js.map +1 -0
  7. package/dist/lib/cjs/cli.js +23 -10
  8. package/dist/lib/cjs/cli.js.map +1 -1
  9. package/dist/lib/cjs/cli.module.js +29 -1
  10. package/dist/lib/cjs/cli.module.js.map +1 -1
  11. package/dist/lib/cjs/commands/commands.js +6 -0
  12. package/dist/lib/cjs/commands/commands.js.map +1 -1
  13. package/dist/lib/cjs/commands/logs-alias.command.js +49 -0
  14. package/dist/lib/cjs/commands/logs-alias.command.js.map +1 -0
  15. package/dist/lib/cjs/commands/logs.command-options.js +72 -0
  16. package/dist/lib/cjs/commands/logs.command-options.js.map +1 -0
  17. package/dist/lib/cjs/commands/logs.command.js +102 -0
  18. package/dist/lib/cjs/commands/logs.command.js.map +1 -0
  19. package/dist/lib/cjs/commands/requests-alias.command.js +49 -0
  20. package/dist/lib/cjs/commands/requests-alias.command.js.map +1 -0
  21. package/dist/lib/cjs/commands/requests.command-options.js +26 -0
  22. package/dist/lib/cjs/commands/requests.command-options.js.map +1 -0
  23. package/dist/lib/cjs/commands/requests.command.js +88 -0
  24. package/dist/lib/cjs/commands/requests.command.js.map +1 -0
  25. package/dist/lib/cjs/commands/trace-alias.command.js +49 -0
  26. package/dist/lib/cjs/commands/trace-alias.command.js.map +1 -0
  27. package/dist/lib/cjs/commands/trace.command-options.js +59 -0
  28. package/dist/lib/cjs/commands/trace.command-options.js.map +1 -0
  29. package/dist/lib/cjs/commands/trace.command.js +84 -0
  30. package/dist/lib/cjs/commands/trace.command.js.map +1 -0
  31. package/dist/lib/cjs/config/config-loader.js +34 -13
  32. package/dist/lib/cjs/config/config-loader.js.map +1 -1
  33. package/dist/lib/cjs/decorators/command-parameter.decorator.js +40 -0
  34. package/dist/lib/cjs/decorators/command-parameter.decorator.js.map +1 -0
  35. package/dist/lib/cjs/decorators/decorators.js +18 -0
  36. package/dist/lib/cjs/decorators/decorators.js.map +1 -0
  37. package/dist/lib/cjs/enums/cli-decorator-metadata-keyname.enum.js +14 -0
  38. package/dist/lib/cjs/enums/cli-decorator-metadata-keyname.enum.js.map +1 -0
  39. package/dist/lib/cjs/enums/enums.js +19 -0
  40. package/dist/lib/cjs/enums/enums.js.map +1 -0
  41. package/dist/lib/cjs/enums/terminal-key-name.enum.js +21 -0
  42. package/dist/lib/cjs/enums/terminal-key-name.enum.js.map +1 -0
  43. package/dist/lib/cjs/errors/cli-error-code.enum.js +11 -1
  44. package/dist/lib/cjs/errors/cli-error-code.enum.js.map +1 -1
  45. package/dist/lib/cjs/errors/errors.js +1 -0
  46. package/dist/lib/cjs/errors/errors.js.map +1 -1
  47. package/dist/lib/cjs/errors/prompt-cancelled.error.js +25 -0
  48. package/dist/lib/cjs/errors/prompt-cancelled.error.js.map +1 -0
  49. package/dist/lib/cjs/event-handlers/cli.event-handler.js +21 -65
  50. package/dist/lib/cjs/event-handlers/cli.event-handler.js.map +1 -1
  51. package/dist/lib/cjs/event-handlers/event-handlers.js +1 -0
  52. package/dist/lib/cjs/event-handlers/event-handlers.js.map +1 -1
  53. package/dist/lib/cjs/event-handlers/repl-start.event-handler.js +280 -0
  54. package/dist/lib/cjs/event-handlers/repl-start.event-handler.js.map +1 -0
  55. package/dist/lib/cjs/event-payloads/event-payloads.js +1 -0
  56. package/dist/lib/cjs/event-payloads/event-payloads.js.map +1 -1
  57. package/dist/lib/cjs/event-payloads/start-repl.event-payload.js +19 -0
  58. package/dist/lib/cjs/event-payloads/start-repl.event-payload.js.map +1 -0
  59. package/dist/lib/cjs/interfaces/interfaces.js +1 -0
  60. package/dist/lib/cjs/interfaces/interfaces.js.map +1 -1
  61. package/dist/lib/cjs/interfaces/terminal-key.interface.js +3 -0
  62. package/dist/lib/cjs/interfaces/terminal-key.interface.js.map +1 -0
  63. package/dist/lib/cjs/managers/cli-prompt.manager.js +181 -15
  64. package/dist/lib/cjs/managers/cli-prompt.manager.js.map +1 -1
  65. package/dist/lib/cjs/managers/managers.js +1 -0
  66. package/dist/lib/cjs/managers/managers.js.map +1 -1
  67. package/dist/lib/cjs/managers/terminal-key-reader.manager.js +99 -0
  68. package/dist/lib/cjs/managers/terminal-key-reader.manager.js.map +1 -0
  69. package/dist/lib/cjs/mappers/command-event.mapper.js +48 -8
  70. package/dist/lib/cjs/mappers/command-event.mapper.js.map +1 -1
  71. package/dist/lib/cjs/mappers/mappers.js +1 -0
  72. package/dist/lib/cjs/mappers/mappers.js.map +1 -1
  73. package/dist/lib/cjs/mappers/repl-start-event.mapper.js +80 -0
  74. package/dist/lib/cjs/mappers/repl-start-event.mapper.js.map +1 -0
  75. package/dist/lib/cjs/options/command-parameter.options.js +3 -0
  76. package/dist/lib/cjs/options/command-parameter.options.js.map +1 -0
  77. package/dist/lib/cjs/options/options.js +1 -0
  78. package/dist/lib/cjs/options/options.js.map +1 -1
  79. package/dist/lib/cjs/services/command-argument-resolver.js +62 -0
  80. package/dist/lib/cjs/services/command-argument-resolver.js.map +1 -0
  81. package/dist/lib/cjs/services/command-options-resolver.js +114 -0
  82. package/dist/lib/cjs/services/command-options-resolver.js.map +1 -0
  83. package/dist/lib/cjs/services/command-parameter-prompter.js +311 -0
  84. package/dist/lib/cjs/services/command-parameter-prompter.js.map +1 -0
  85. package/dist/lib/cjs/services/services.js +20 -0
  86. package/dist/lib/cjs/services/services.js.map +1 -0
  87. package/dist/lib/cjs/tsconfig.cjs.tsbuildinfo +1 -1
  88. package/dist/lib/cjs/types/start-repl-event-response.type.js +13 -0
  89. package/dist/lib/cjs/types/start-repl-event-response.type.js.map +1 -0
  90. package/dist/lib/cjs/types/types.js +1 -0
  91. package/dist/lib/cjs/types/types.js.map +1 -1
  92. package/dist/lib/cjs/utils/boolean-answer-parser.js +25 -0
  93. package/dist/lib/cjs/utils/boolean-answer-parser.js.map +1 -0
  94. package/dist/lib/cjs/utils/pristine-argv.js +87 -0
  95. package/dist/lib/cjs/utils/pristine-argv.js.map +1 -0
  96. package/dist/lib/cjs/utils/terminal-key-decoder.js +71 -0
  97. package/dist/lib/cjs/utils/terminal-key-decoder.js.map +1 -0
  98. package/dist/lib/esm/bootstrap/build-staleness-prompt.js +12 -13
  99. package/dist/lib/esm/bootstrap/build-staleness-prompt.js.map +1 -1
  100. package/dist/lib/esm/bootstrap/init-prompt.js +16 -47
  101. package/dist/lib/esm/bootstrap/init-prompt.js.map +1 -1
  102. package/dist/lib/esm/cli.configuration-keys.js +21 -0
  103. package/dist/lib/esm/cli.configuration-keys.js.map +1 -0
  104. package/dist/lib/esm/cli.js +23 -10
  105. package/dist/lib/esm/cli.js.map +1 -1
  106. package/dist/lib/esm/cli.module.js +29 -1
  107. package/dist/lib/esm/cli.module.js.map +1 -1
  108. package/dist/lib/esm/commands/commands.js +6 -0
  109. package/dist/lib/esm/commands/commands.js.map +1 -1
  110. package/dist/lib/esm/commands/logs-alias.command.js +46 -0
  111. package/dist/lib/esm/commands/logs-alias.command.js.map +1 -0
  112. package/dist/lib/esm/commands/logs.command-options.js +68 -0
  113. package/dist/lib/esm/commands/logs.command-options.js.map +1 -0
  114. package/dist/lib/esm/commands/logs.command.js +99 -0
  115. package/dist/lib/esm/commands/logs.command.js.map +1 -0
  116. package/dist/lib/esm/commands/requests-alias.command.js +46 -0
  117. package/dist/lib/esm/commands/requests-alias.command.js.map +1 -0
  118. package/dist/lib/esm/commands/requests.command-options.js +22 -0
  119. package/dist/lib/esm/commands/requests.command-options.js.map +1 -0
  120. package/dist/lib/esm/commands/requests.command.js +85 -0
  121. package/dist/lib/esm/commands/requests.command.js.map +1 -0
  122. package/dist/lib/esm/commands/trace-alias.command.js +46 -0
  123. package/dist/lib/esm/commands/trace-alias.command.js.map +1 -0
  124. package/dist/lib/esm/commands/trace.command-options.js +55 -0
  125. package/dist/lib/esm/commands/trace.command-options.js.map +1 -0
  126. package/dist/lib/esm/commands/trace.command.js +81 -0
  127. package/dist/lib/esm/commands/trace.command.js.map +1 -0
  128. package/dist/lib/esm/config/config-loader.js +34 -13
  129. package/dist/lib/esm/config/config-loader.js.map +1 -1
  130. package/dist/lib/esm/decorators/command-parameter.decorator.js +36 -0
  131. package/dist/lib/esm/decorators/command-parameter.decorator.js.map +1 -0
  132. package/dist/lib/esm/decorators/decorators.js +2 -0
  133. package/dist/lib/esm/decorators/decorators.js.map +1 -0
  134. package/dist/lib/esm/enums/cli-decorator-metadata-keyname.enum.js +11 -0
  135. package/dist/lib/esm/enums/cli-decorator-metadata-keyname.enum.js.map +1 -0
  136. package/dist/lib/esm/enums/enums.js +3 -0
  137. package/dist/lib/esm/enums/enums.js.map +1 -0
  138. package/dist/lib/esm/enums/terminal-key-name.enum.js +18 -0
  139. package/dist/lib/esm/enums/terminal-key-name.enum.js.map +1 -0
  140. package/dist/lib/esm/errors/cli-error-code.enum.js +11 -1
  141. package/dist/lib/esm/errors/cli-error-code.enum.js.map +1 -1
  142. package/dist/lib/esm/errors/errors.js +1 -0
  143. package/dist/lib/esm/errors/errors.js.map +1 -1
  144. package/dist/lib/esm/errors/prompt-cancelled.error.js +21 -0
  145. package/dist/lib/esm/errors/prompt-cancelled.error.js.map +1 -0
  146. package/dist/lib/esm/event-handlers/cli.event-handler.js +22 -66
  147. package/dist/lib/esm/event-handlers/cli.event-handler.js.map +1 -1
  148. package/dist/lib/esm/event-handlers/event-handlers.js +1 -0
  149. package/dist/lib/esm/event-handlers/event-handlers.js.map +1 -1
  150. package/dist/lib/esm/event-handlers/repl-start.event-handler.js +244 -0
  151. package/dist/lib/esm/event-handlers/repl-start.event-handler.js.map +1 -0
  152. package/dist/lib/esm/event-payloads/event-payloads.js +1 -0
  153. package/dist/lib/esm/event-payloads/event-payloads.js.map +1 -1
  154. package/dist/lib/esm/event-payloads/start-repl.event-payload.js +15 -0
  155. package/dist/lib/esm/event-payloads/start-repl.event-payload.js.map +1 -0
  156. package/dist/lib/esm/interfaces/interfaces.js +1 -0
  157. package/dist/lib/esm/interfaces/interfaces.js.map +1 -1
  158. package/dist/lib/esm/interfaces/terminal-key.interface.js +2 -0
  159. package/dist/lib/esm/interfaces/terminal-key.interface.js.map +1 -0
  160. package/dist/lib/esm/managers/cli-prompt.manager.js +182 -16
  161. package/dist/lib/esm/managers/cli-prompt.manager.js.map +1 -1
  162. package/dist/lib/esm/managers/managers.js +1 -0
  163. package/dist/lib/esm/managers/managers.js.map +1 -1
  164. package/dist/lib/esm/managers/terminal-key-reader.manager.js +96 -0
  165. package/dist/lib/esm/managers/terminal-key-reader.manager.js.map +1 -0
  166. package/dist/lib/esm/mappers/command-event.mapper.js +49 -9
  167. package/dist/lib/esm/mappers/command-event.mapper.js.map +1 -1
  168. package/dist/lib/esm/mappers/mappers.js +1 -0
  169. package/dist/lib/esm/mappers/mappers.js.map +1 -1
  170. package/dist/lib/esm/mappers/repl-start-event.mapper.js +77 -0
  171. package/dist/lib/esm/mappers/repl-start-event.mapper.js.map +1 -0
  172. package/dist/lib/esm/options/command-parameter.options.js +2 -0
  173. package/dist/lib/esm/options/command-parameter.options.js.map +1 -0
  174. package/dist/lib/esm/options/options.js +1 -0
  175. package/dist/lib/esm/options/options.js.map +1 -1
  176. package/dist/lib/esm/services/command-argument-resolver.js +59 -0
  177. package/dist/lib/esm/services/command-argument-resolver.js.map +1 -0
  178. package/dist/lib/esm/services/command-options-resolver.js +111 -0
  179. package/dist/lib/esm/services/command-options-resolver.js.map +1 -0
  180. package/dist/lib/esm/services/command-parameter-prompter.js +308 -0
  181. package/dist/lib/esm/services/command-parameter-prompter.js.map +1 -0
  182. package/dist/lib/esm/services/services.js +4 -0
  183. package/dist/lib/esm/services/services.js.map +1 -0
  184. package/dist/lib/esm/tsconfig.tsbuildinfo +1 -1
  185. package/dist/lib/esm/types/start-repl-event-response.type.js +9 -0
  186. package/dist/lib/esm/types/start-repl-event-response.type.js.map +1 -0
  187. package/dist/lib/esm/types/types.js +1 -0
  188. package/dist/lib/esm/types/types.js.map +1 -1
  189. package/dist/lib/esm/utils/boolean-answer-parser.js +21 -0
  190. package/dist/lib/esm/utils/boolean-answer-parser.js.map +1 -0
  191. package/dist/lib/esm/utils/pristine-argv.js +50 -0
  192. package/dist/lib/esm/utils/pristine-argv.js.map +1 -0
  193. package/dist/lib/esm/utils/terminal-key-decoder.js +67 -0
  194. package/dist/lib/esm/utils/terminal-key-decoder.js.map +1 -0
  195. package/dist/types/bootstrap/build-staleness-prompt.d.ts +3 -3
  196. package/dist/types/bootstrap/init-prompt.d.ts +5 -5
  197. package/dist/types/cli.configuration-keys.d.ts +32 -0
  198. package/dist/types/cli.d.ts +8 -4
  199. package/dist/types/cli.module.d.ts +4 -0
  200. package/dist/types/commands/commands.d.ts +6 -0
  201. package/dist/types/commands/logs-alias.command.d.ts +14 -0
  202. package/dist/types/commands/logs.command-options.d.ts +38 -0
  203. package/dist/types/commands/logs.command.d.ts +31 -0
  204. package/dist/types/commands/requests-alias.command.d.ts +14 -0
  205. package/dist/types/commands/requests.command-options.d.ts +8 -0
  206. package/dist/types/commands/requests.command.d.ts +25 -0
  207. package/dist/types/commands/trace-alias.command.d.ts +14 -0
  208. package/dist/types/commands/trace.command-options.d.ts +31 -0
  209. package/dist/types/commands/trace.command.d.ts +21 -0
  210. package/dist/types/config/config-loader.d.ts +15 -3
  211. package/dist/types/decorators/command-parameter.decorator.d.ts +30 -0
  212. package/dist/types/decorators/decorators.d.ts +1 -0
  213. package/dist/types/enums/cli-decorator-metadata-keyname.enum.d.ts +9 -0
  214. package/dist/types/enums/enums.d.ts +2 -0
  215. package/dist/types/enums/terminal-key-name.enum.d.ts +16 -0
  216. package/dist/types/errors/cli-error-code.enum.d.ts +12 -2
  217. package/dist/types/errors/errors.d.ts +1 -0
  218. package/dist/types/errors/prompt-cancelled.error.d.ts +13 -0
  219. package/dist/types/event-handlers/cli.event-handler.d.ts +16 -13
  220. package/dist/types/event-handlers/event-handlers.d.ts +1 -0
  221. package/dist/types/event-handlers/repl-start.event-handler.d.ts +70 -0
  222. package/dist/types/event-payloads/event-payloads.d.ts +1 -0
  223. package/dist/types/event-payloads/start-repl.event-payload.d.ts +13 -0
  224. package/dist/types/interfaces/interfaces.d.ts +1 -0
  225. package/dist/types/interfaces/terminal-key.interface.d.ts +11 -0
  226. package/dist/types/managers/cli-prompt.manager.d.ts +63 -6
  227. package/dist/types/managers/managers.d.ts +1 -0
  228. package/dist/types/managers/terminal-key-reader.manager.d.ts +31 -0
  229. package/dist/types/mappers/command-event.mapper.d.ts +10 -1
  230. package/dist/types/mappers/mappers.d.ts +1 -0
  231. package/dist/types/mappers/repl-start-event.mapper.d.ts +28 -0
  232. package/dist/types/options/command-parameter.options.d.ts +29 -0
  233. package/dist/types/options/options.d.ts +1 -0
  234. package/dist/types/services/command-argument-resolver.d.ts +24 -0
  235. package/dist/types/services/command-options-resolver.d.ts +35 -0
  236. package/dist/types/services/command-parameter-prompter.d.ts +113 -0
  237. package/dist/types/services/services.d.ts +3 -0
  238. package/dist/types/types/start-repl-event-response.type.d.ts +10 -0
  239. package/dist/types/types/types.d.ts +1 -0
  240. package/dist/types/utils/boolean-answer-parser.d.ts +11 -0
  241. package/dist/types/utils/pristine-argv.d.ts +33 -0
  242. package/dist/types/utils/terminal-key-decoder.d.ts +28 -0
  243. package/package.json +16 -12
@@ -25,7 +25,8 @@ import { DynamicImporter } from "../bootstrap/dynamic-importer";
25
25
  /**
26
26
  * Loads `pristine.config.ts` (preferred) or `pristine.config.js` (escape hatch for
27
27
  * pure-JS projects). Walks up from `process.cwd()` looking for the file, then loads it
28
- * through `jiti` (for `.ts`) or Node's dynamic `import()` (for `.js`).
28
+ * through Node's native dynamic `import()`: TypeScript type-stripping (Node >= 22.18)
29
+ * handles `.ts`, while `.js` loads directly.
29
30
  *
30
31
  * Returns a `ResolvedPristineConfig` carrying the file path (when found) and per-field
31
32
  * provenance, which `pristine p:config:print` uses to render an annotated dump.
@@ -94,26 +95,23 @@ let ConfigLoader = class ConfigLoader {
94
95
  }
95
96
  }
96
97
  /**
97
- * Loads a config file from `absolutePath`. `.ts` goes through `jiti`; `.js` uses Node's
98
- * native dynamic `import()`. Extracts the default export, falling back to a named
98
+ * Loads a config file from `absolutePath` via Node's native dynamic `import()`. A `.ts`
99
+ * config is handled by Node's built-in TypeScript type-stripping (Node >= 22.18); a `.js`
100
+ * config loads directly. Extracts the default export, falling back to a named
99
101
  * `pristineConfig` export for users who prefer not to use `export default`.
100
102
  * @private
101
103
  */
102
104
  importConfigFile(absolutePath) {
103
105
  return __awaiter(this, void 0, void 0, function* () {
104
- var _a, _b, _c, _d;
105
- const ext = path.extname(absolutePath).toLowerCase();
106
+ var _a, _b;
106
107
  let loaded;
107
- if (ext === ".ts") {
108
- const jitiModule = yield this.dynamicImporter.import("jiti");
109
- const createJiti = (_b = (_a = jitiModule.default) !== null && _a !== void 0 ? _a : jitiModule.createJiti) !== null && _b !== void 0 ? _b : jitiModule;
110
- const jiti = createJiti(absolutePath, { interopDefault: true });
111
- loaded = jiti(absolutePath);
112
- }
113
- else {
108
+ try {
114
109
  loaded = yield this.dynamicImporter.import(`file://${absolutePath}`);
115
110
  }
116
- const config = (_d = (_c = loaded === null || loaded === void 0 ? void 0 : loaded.default) !== null && _c !== void 0 ? _c : loaded === null || loaded === void 0 ? void 0 : loaded.pristineConfig) !== null && _d !== void 0 ? _d : loaded;
111
+ catch (error) {
112
+ throw this.describeImportError(error, absolutePath);
113
+ }
114
+ const config = (_b = (_a = loaded === null || loaded === void 0 ? void 0 : loaded.default) !== null && _a !== void 0 ? _a : loaded === null || loaded === void 0 ? void 0 : loaded.pristineConfig) !== null && _b !== void 0 ? _b : loaded;
117
115
  if (!config || typeof config !== "object") {
118
116
  throw new Error(`[pristine] Config file at '${absolutePath}' did not export a valid configuration. ` +
119
117
  `Use \`export default defineConfig({ ... })\` or \`export const pristineConfig = { ... }\`.`);
@@ -121,6 +119,29 @@ let ConfigLoader = class ConfigLoader {
121
119
  return config;
122
120
  });
123
121
  }
122
+ /**
123
+ * Translates Node's low-level module-loading failures for a `.ts` config into an
124
+ * actionable error. Native type-stripping has two distinct failure modes worth telling
125
+ * apart: the running Node is too old (or has stripping disabled) to import `.ts` at all
126
+ * (`ERR_UNKNOWN_FILE_EXTENSION`), versus a config written with non-erasable TypeScript that
127
+ * stripping refuses (`ERR_UNSUPPORTED_TYPESCRIPT_SYNTAX`). Any other error is passed through
128
+ * unchanged so genuine config bugs surface as-is.
129
+ * @private
130
+ */
131
+ describeImportError(error, absolutePath) {
132
+ var _a;
133
+ if ((error === null || error === void 0 ? void 0 : error.code) === "ERR_UNKNOWN_FILE_EXTENSION") {
134
+ return new Error(`[pristine] Loading '${absolutePath}' requires Node >= 22.18 (native TypeScript ` +
135
+ `type-stripping); you are running ${process.version}. Upgrade Node, or rename the ` +
136
+ `file to 'pristine.config.js'.`);
137
+ }
138
+ if ((error === null || error === void 0 ? void 0 : error.code) === "ERR_UNSUPPORTED_TYPESCRIPT_SYNTAX") {
139
+ return new Error(`[pristine] '${absolutePath}' uses TypeScript that Node cannot type-strip (enum, ` +
140
+ `namespace, parameter properties, ...). Use only erasable TypeScript in your config, ` +
141
+ `or rename the file to 'pristine.config.js'.\nOriginal error: ${(_a = error === null || error === void 0 ? void 0 : error.message) !== null && _a !== void 0 ? _a : error}`);
142
+ }
143
+ return error instanceof Error ? error : new Error(String(error));
144
+ }
124
145
  };
125
146
  ConfigLoader = __decorate([
126
147
  injectable(),
@@ -1 +1 @@
1
- {"version":3,"file":"config-loader.js","sourceRoot":"","sources":["../../../../src/config/config-loader.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"config-loader.js","sourceRoot":"","sources":["../../../../src/config/config-loader.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,36 @@
1
+ import { PropertyMetadata } from "@pristine-ts/metadata";
2
+ import { CliDecoratorMetadataKeynameEnum } from "../enums/cli-decorator-metadata-keyname.enum";
3
+ /**
4
+ * Describes a command-line parameter on a command's options class. Stored as property
5
+ * metadata and read by the CLI while resolving a command's arguments — before the arguments
6
+ * are mapped onto the options instance and validated.
7
+ *
8
+ * Two behaviors flow from the options:
9
+ *
10
+ * - `flag` rebinds the property to a differently-named flag (the property name is the
11
+ * default), so the property and the flag no longer have to be spelled identically.
12
+ * - `question` makes the CLI ask for the value interactively when the flag is absent
13
+ * (subject to configuration and an interactive terminal). Omit it to never prompt.
14
+ *
15
+ * ```ts
16
+ * import {IsString, IsOptional} from "@pristine-ts/class-validator";
17
+ * import {commandParameter} from "@pristine-ts/cli";
18
+ *
19
+ * export class MigrateCommandOptions {
20
+ * @commandParameter({flag: "db-url", question: "What is the database URL?"})
21
+ * @IsString()
22
+ * databaseUrl?: string; // bound to --db-url; asked for when missing
23
+ *
24
+ * @commandParameter({flag: "dir"}) // bound to --dir; never asked for
25
+ * @IsOptional()
26
+ * @IsString()
27
+ * migrationsDirectory?: string;
28
+ * }
29
+ * ```
30
+ */
31
+ export const commandParameter = (options = {}) => {
32
+ return (target, propertyKey) => {
33
+ PropertyMetadata.defineMetadata(target, propertyKey, CliDecoratorMetadataKeynameEnum.CommandParameter, options);
34
+ };
35
+ };
36
+ //# sourceMappingURL=command-parameter.decorator.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"command-parameter.decorator.js","sourceRoot":"","sources":["../../../../src/decorators/command-parameter.decorator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,gBAAgB,EAAC,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAC,+BAA+B,EAAC,MAAM,8CAA8C,CAAC;AAG7F;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,UAAmC,EAAE,EAAE,EAAE;IACxE,OAAO,CAAC,MAAW,EAAE,WAAmB,EAAE,EAAE;QAC1C,gBAAgB,CAAC,cAAc,CAAC,MAAM,EAAE,WAAW,EAAE,+BAA+B,CAAC,gBAAgB,EAAE,OAAO,CAAC,CAAC;IAClH,CAAC,CAAC;AACJ,CAAC,CAAC"}
@@ -0,0 +1,2 @@
1
+ export * from "./command-parameter.decorator";
2
+ //# sourceMappingURL=decorators.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"decorators.js","sourceRoot":"","sources":["../../../../src/decorators/decorators.ts"],"names":[],"mappings":"AAAA,cAAc,+BAA+B,CAAC"}
@@ -0,0 +1,11 @@
1
+ /**
2
+ * Metadata keynames written by `@pristine-ts/cli`'s own property/class decorators and read
3
+ * back when resolving a command's options. Namespaced under `cli:` so they never collide
4
+ * with the keys other Pristine decorators (validation, data-mapping, mysql, …) store on the
5
+ * same class.
6
+ */
7
+ export var CliDecoratorMetadataKeynameEnum;
8
+ (function (CliDecoratorMetadataKeynameEnum) {
9
+ CliDecoratorMetadataKeynameEnum["CommandParameter"] = "cli:command-parameter";
10
+ })(CliDecoratorMetadataKeynameEnum || (CliDecoratorMetadataKeynameEnum = {}));
11
+ //# sourceMappingURL=cli-decorator-metadata-keyname.enum.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cli-decorator-metadata-keyname.enum.js","sourceRoot":"","sources":["../../../../src/enums/cli-decorator-metadata-keyname.enum.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,CAAN,IAAY,+BAEX;AAFD,WAAY,+BAA+B;IACzC,6EAA0C,CAAA;AAC5C,CAAC,EAFW,+BAA+B,KAA/B,+BAA+B,QAE1C"}
@@ -0,0 +1,3 @@
1
+ export * from "./cli-decorator-metadata-keyname.enum";
2
+ export * from "./terminal-key-name.enum";
3
+ //# sourceMappingURL=enums.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"enums.js","sourceRoot":"","sources":["../../../../src/enums/enums.ts"],"names":[],"mappings":"AAAA,cAAc,uCAAuC,CAAC;AACtD,cAAc,0BAA0B,CAAC"}
@@ -0,0 +1,18 @@
1
+ /**
2
+ * The kinds of keypress the CLI's interactive prompts understand. `TerminalKeyDecoder`
3
+ * maps the raw bytes Node delivers from a raw-mode stdin onto one of these; every printable
4
+ * keystroke collapses to `Character` (with the literal character carried separately on
5
+ * {@link TerminalKey}). `Other` covers control/escape sequences the prompts don't act on
6
+ * (function keys, unhandled arrows) so callers can ignore them instead of echoing garbage.
7
+ */
8
+ export var TerminalKeyName;
9
+ (function (TerminalKeyName) {
10
+ TerminalKeyName["Up"] = "up";
11
+ TerminalKeyName["Down"] = "down";
12
+ TerminalKeyName["Enter"] = "enter";
13
+ TerminalKeyName["Backspace"] = "backspace";
14
+ TerminalKeyName["CtrlC"] = "ctrl-c";
15
+ TerminalKeyName["Character"] = "character";
16
+ TerminalKeyName["Other"] = "other";
17
+ })(TerminalKeyName || (TerminalKeyName = {}));
18
+ //# sourceMappingURL=terminal-key-name.enum.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"terminal-key-name.enum.js","sourceRoot":"","sources":["../../../../src/enums/terminal-key-name.enum.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,CAAN,IAAY,eAQX;AARD,WAAY,eAAe;IACzB,4BAAS,CAAA;IACT,gCAAa,CAAA;IACb,kCAAe,CAAA;IACf,0CAAuB,CAAA;IACvB,mCAAgB,CAAA;IAChB,0CAAuB,CAAA;IACvB,kCAAe,CAAA;AACjB,CAAC,EARW,eAAe,KAAf,eAAe,QAQ1B"}
@@ -3,12 +3,22 @@
3
3
  * (typed `PristineErrorCode | string`, so any enum value is accepted).
4
4
  *
5
5
  * Codes here describe CLI-specific failures — command resolution, argument mapping,
6
- * and argument validation.
6
+ * argument validation, and command-parameter binding.
7
7
  */
8
8
  export var CliErrorCode;
9
9
  (function (CliErrorCode) {
10
10
  CliErrorCode["CommandNotFound"] = "COMMAND_NOT_FOUND";
11
11
  CliErrorCode["ArgumentMappingFailed"] = "ARGUMENT_MAPPING_FAILED";
12
12
  CliErrorCode["ArgumentValidationFailed"] = "ARGUMENT_VALIDATION_FAILED";
13
+ /**
14
+ * Two `@commandParameter` properties on the same options class resolve to the same flag.
15
+ * A programming error in the command's options definition, not bad user input.
16
+ */
17
+ CliErrorCode["CommandParameterFlagConflict"] = "COMMAND_PARAMETER_FLAG_CONFLICT";
18
+ /**
19
+ * The user cancelled an interactive prompt with `Ctrl+C`. Carried by
20
+ * `PromptCancelledError` — a clean, user-initiated cancellation, not a failure.
21
+ */
22
+ CliErrorCode["PromptCancelled"] = "PROMPT_CANCELLED";
13
23
  })(CliErrorCode || (CliErrorCode = {}));
14
24
  //# sourceMappingURL=cli-error-code.enum.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"cli-error-code.enum.js","sourceRoot":"","sources":["../../../../src/errors/cli-error-code.enum.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,CAAN,IAAY,YAIX;AAJD,WAAY,YAAY;IACtB,qDAA8C,CAAA;IAC9C,iEAAoD,CAAA;IACpD,uEAAuD,CAAA;AACzD,CAAC,EAJW,YAAY,KAAZ,YAAY,QAIvB"}
1
+ {"version":3,"file":"cli-error-code.enum.js","sourceRoot":"","sources":["../../../../src/errors/cli-error-code.enum.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,CAAN,IAAY,YAgBX;AAhBD,WAAY,YAAY;IACtB,qDAA8C,CAAA;IAC9C,iEAAoD,CAAA;IACpD,uEAAuD,CAAA;IAEvD;;;OAGG;IACH,gFAAgE,CAAA;IAEhE;;;OAGG;IACH,oDAAoC,CAAA;AACtC,CAAC,EAhBW,YAAY,KAAZ,YAAY,QAgBvB"}
@@ -1,3 +1,4 @@
1
1
  export * from "./cli-error-code.enum";
2
2
  export * from "./command-not-found.error";
3
+ export * from "./prompt-cancelled.error";
3
4
  //# sourceMappingURL=errors.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../../src/errors/errors.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC"}
1
+ {"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../../src/errors/errors.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,0BAA0B,CAAC"}
@@ -0,0 +1,21 @@
1
+ import { PristineError, PristineErrorKind } from "@pristine-ts/common";
2
+ import { CliErrorCode } from "./cli-error-code.enum";
3
+ /**
4
+ * Thrown when the user cancels an interactive prompt with `Ctrl+C`. A clean, user-initiated
5
+ * cancellation — not a crash — so it carries `kind: UserError` (the `CliErrorReporter`
6
+ * renders the message verbatim instead of a stack dump) and exit code `130`, following the
7
+ * POSIX `128 + SIGINT(2)` convention so shell pipelines can detect the interrupt.
8
+ *
9
+ * Callers that treat cancellation as a normal branch (e.g. `BuildStalenessPrompt`) catch it
10
+ * via `instanceof`; everywhere else it propagates to the reporter for a tidy exit.
11
+ */
12
+ export class PromptCancelledError extends PristineError {
13
+ constructor() {
14
+ super("Prompt cancelled.", {
15
+ code: CliErrorCode.PromptCancelled,
16
+ exitCode: 130,
17
+ kind: PristineErrorKind.UserError,
18
+ });
19
+ }
20
+ }
21
+ //# sourceMappingURL=prompt-cancelled.error.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"prompt-cancelled.error.js","sourceRoot":"","sources":["../../../../src/errors/prompt-cancelled.error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,aAAa,EAAE,iBAAiB,EAAC,MAAM,qBAAqB,CAAC;AACrE,OAAO,EAAC,YAAY,EAAC,MAAM,uBAAuB,CAAC;AAEnD;;;;;;;;GAQG;AACH,MAAM,OAAO,oBAAqB,SAAQ,aAAa;IACrD;QACE,KAAK,CAAC,mBAAmB,EAAE;YACzB,IAAI,EAAE,YAAY,CAAC,eAAe;YAClC,QAAQ,EAAE,GAAG;YACb,IAAI,EAAE,iBAAiB,CAAC,SAAS;SAClC,CAAC,CAAC;IACL,CAAC;CACF"}
@@ -21,18 +21,27 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
21
21
  };
22
22
  import { inject, injectable, injectAll } from "tsyringe";
23
23
  import { CommandEventPayload } from "../event-payloads/command.event-payload";
24
- import { moduleScoped, ServiceDefinitionTagEnum, tag, UsageError, ValidationError, ExitCode } from "@pristine-ts/common";
25
- import { CliErrorCode } from "../errors/cli-error-code.enum";
24
+ import { CommandEventResponse } from "../types/command-event-response.type";
25
+ import { moduleScoped, ServiceDefinitionTagEnum, tag, ExitCode } from "@pristine-ts/common";
26
26
  import { CommandNotFoundError } from "../errors/command-not-found.error";
27
- import { Validator } from "@pristine-ts/class-validator";
28
27
  import { CliModuleKeyname } from "../cli.module.keyname";
29
- import { plainToInstance } from "class-transformer";
28
+ import { CommandArgumentResolver } from "../services/command-argument-resolver";
30
29
  let CliEventHandler = class CliEventHandler {
31
- constructor(logHandler, validator, commands) {
30
+ constructor(logHandler, commandArgumentResolver, commands) {
32
31
  this.logHandler = logHandler;
33
- this.validator = validator;
32
+ this.commandArgumentResolver = commandArgumentResolver;
34
33
  this.commands = commands;
35
34
  }
35
+ /**
36
+ * Resolves and runs the command, then **returns** its exit code wrapped in a
37
+ * `CommandEventResponse` — it does not call `process.exit`.
38
+ *
39
+ * Process lifecycle is the bin's job: `kernel.handle` resolves with this exit code,
40
+ * `Cli.bootstrap` returns it, and `bin.ts` does the actual `process.exit`. Returning
41
+ * (rather than exiting) is also what lets the interactive REPL dispatch commands
42
+ * through this very handler — `kernel.handle(argv, {keyname: Cli})` per typed line —
43
+ * without the process dying after the first command.
44
+ */
36
45
  handle(event) {
37
46
  return __awaiter(this, void 0, void 0, function* () {
38
47
  var _a;
@@ -40,76 +49,23 @@ let CliEventHandler = class CliEventHandler {
40
49
  if (command === undefined) {
41
50
  // Throws a UsageError (exit 64, `EX_USAGE`). The bin's `.catch` will route it
42
51
  // through `CliErrorReporter.report` which prints a clean one-line stderr and
43
- // exits with the right code — no `process.exit` in this method any longer.
52
+ // exits with the right code.
44
53
  throw new CommandNotFoundError(event.payload.name);
45
54
  }
46
55
  const args = yield this.resolveArgs(command, (_a = event.payload.arguments) !== null && _a !== void 0 ? _a : {});
47
56
  const exitCode = yield command.run(args);
48
57
  this.logExitStatus(event.payload.name, exitCode);
49
- process.exit(exitCode);
58
+ return new CommandEventResponse(event, exitCode);
50
59
  });
51
60
  }
52
61
  /**
53
- * Maps `rawArgs` (the parsed argv shape produced by `CommandEventMapper`) into a typed
54
- * instance of `command.optionsType`, then runs `class-validator` against the instance.
55
- *
56
- * For commands that opt out of typed options (`optionsType === null`), passes the raw
57
- * args through unchanged — the legacy escape hatch for commands that want to handle
58
- * argv parsing themselves.
59
- *
60
- * Throws `UsageError` for mapping failures and `ValidationError` for class-validator
61
- * failures. Both carry structured `details` so `CliErrorReporter` can render them as
62
- * readable stderr lines without this method touching the console directly.
62
+ * Maps + validates a command's raw arguments. Delegates to the shared
63
+ * `CommandArgumentResolver`. Since the REPL dispatches through this same handler, the
64
+ * one-shot CLI and the REPL resolve arguments through identical logic.
63
65
  */
64
66
  resolveArgs(command, rawArgs) {
65
67
  return __awaiter(this, void 0, void 0, function* () {
66
- if (command.optionsType === null) {
67
- return rawArgs;
68
- }
69
- let mapped;
70
- try {
71
- // class-transformer's plainToInstance is what produces a real instance of the
72
- // options class (with the prototype, decorator metadata, and class-validator hooks
73
- // intact). DataMapper.autoMap would return a plain object instead, which causes
74
- // class-validator to silently report no errors because it can't find decorator
75
- // metadata on a non-instance — exactly the bug this rewrite fixes.
76
- mapped = plainToInstance(command.optionsType, rawArgs);
77
- }
78
- catch (cause) {
79
- throw new UsageError(`Failed to map CLI arguments to '${command.optionsType.name}': ${cause.message}`, {
80
- code: CliErrorCode.ArgumentMappingFailed,
81
- cause: cause,
82
- details: { targetType: command.optionsType.name },
83
- });
84
- }
85
- const validationErrors = yield this.validator.validate(mapped);
86
- if (validationErrors.length === 0) {
87
- return mapped;
88
- }
89
- // Reshape the class-validator output into structured `details` the reporter can
90
- // render line-by-line. Keeps the throw single-pass and the reporter format-agnostic.
91
- const failures = {};
92
- for (const error of validationErrors) {
93
- const messages = [];
94
- for (const constraintKey in error.constraints) {
95
- // `@pristine-ts/class-validator` stores constraints as `{keyname, message}` objects
96
- // rather than the plain strings vanilla class-validator uses. Extract the message
97
- // when present, falling back to JSON for unknown shapes so we never print
98
- // `[object Object]`.
99
- const constraint = error.constraints[constraintKey];
100
- const message = typeof constraint === "string"
101
- ? constraint
102
- : (constraint && typeof constraint === "object" && typeof constraint.message === "string")
103
- ? constraint.message
104
- : JSON.stringify(constraint);
105
- messages.push(`[${constraintKey}] ${message}`);
106
- }
107
- failures[error.property] = messages;
108
- }
109
- throw new ValidationError("Argument validation failed", {
110
- code: CliErrorCode.ArgumentValidationFailed,
111
- details: failures,
112
- });
68
+ return this.commandArgumentResolver.resolve(command, rawArgs);
113
69
  });
114
70
  }
115
71
  supports(event) {
@@ -131,7 +87,7 @@ CliEventHandler = __decorate([
131
87
  injectable(),
132
88
  __param(0, inject("LogHandlerInterface")),
133
89
  __param(2, injectAll(ServiceDefinitionTagEnum.Command)),
134
- __metadata("design:paramtypes", [Object, Validator, Array])
90
+ __metadata("design:paramtypes", [Object, CommandArgumentResolver, Array])
135
91
  ], CliEventHandler);
136
92
  export { CliEventHandler };
137
93
  //# sourceMappingURL=cli.event-handler.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"cli.event-handler.js","sourceRoot":"","sources":["../../../../src/event-handlers/cli.event-handler.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"cli.event-handler.js","sourceRoot":"","sources":["../../../../src/event-handlers/cli.event-handler.ts"],"names":[],"mappings":"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"}
@@ -1,2 +1,3 @@
1
1
  export * from "./cli.event-handler";
2
+ export * from "./repl-start.event-handler";
2
3
  //# sourceMappingURL=event-handlers.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"event-handlers.js","sourceRoot":"","sources":["../../../../src/event-handlers/event-handlers.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC"}
1
+ {"version":3,"file":"event-handlers.js","sourceRoot":"","sources":["../../../../src/event-handlers/event-handlers.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,4BAA4B,CAAC"}