@junctionpanel/cli 0.1.16

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 (196) hide show
  1. package/LICENSE +671 -0
  2. package/bin/junction +2 -0
  3. package/bin/junction-daemon +5 -0
  4. package/dist/cli.d.ts +13 -0
  5. package/dist/cli.d.ts.map +1 -0
  6. package/dist/cli.js +211 -0
  7. package/dist/cli.js.map +1 -0
  8. package/dist/commands/agent/archive.d.ts +17 -0
  9. package/dist/commands/agent/archive.d.ts.map +1 -0
  10. package/dist/commands/agent/archive.js +92 -0
  11. package/dist/commands/agent/archive.js.map +1 -0
  12. package/dist/commands/agent/attach.d.ts +10 -0
  13. package/dist/commands/agent/attach.d.ts.map +1 -0
  14. package/dist/commands/agent/attach.js +153 -0
  15. package/dist/commands/agent/attach.js.map +1 -0
  16. package/dist/commands/agent/index.d.ts +3 -0
  17. package/dist/commands/agent/index.d.ts.map +1 -0
  18. package/dist/commands/agent/index.js +125 -0
  19. package/dist/commands/agent/index.js.map +1 -0
  20. package/dist/commands/agent/inspect.d.ts +14 -0
  21. package/dist/commands/agent/inspect.d.ts.map +1 -0
  22. package/dist/commands/agent/inspect.js +198 -0
  23. package/dist/commands/agent/inspect.js.map +1 -0
  24. package/dist/commands/agent/logs.d.ts +15 -0
  25. package/dist/commands/agent/logs.d.ts.map +1 -0
  26. package/dist/commands/agent/logs.js +163 -0
  27. package/dist/commands/agent/logs.js.map +1 -0
  28. package/dist/commands/agent/ls.d.ts +37 -0
  29. package/dist/commands/agent/ls.d.ts.map +1 -0
  30. package/dist/commands/agent/ls.js +185 -0
  31. package/dist/commands/agent/ls.js.map +1 -0
  32. package/dist/commands/agent/mode.d.ts +18 -0
  33. package/dist/commands/agent/mode.d.ts.map +1 -0
  34. package/dist/commands/agent/mode.js +100 -0
  35. package/dist/commands/agent/mode.js.map +1 -0
  36. package/dist/commands/agent/run.d.ts +40 -0
  37. package/dist/commands/agent/run.d.ts.map +1 -0
  38. package/dist/commands/agent/run.js +354 -0
  39. package/dist/commands/agent/run.js.map +1 -0
  40. package/dist/commands/agent/send.d.ts +16 -0
  41. package/dist/commands/agent/send.d.ts.map +1 -0
  42. package/dist/commands/agent/send.js +172 -0
  43. package/dist/commands/agent/send.js.map +1 -0
  44. package/dist/commands/agent/stop.d.ts +16 -0
  45. package/dist/commands/agent/stop.d.ts.map +1 -0
  46. package/dist/commands/agent/stop.js +105 -0
  47. package/dist/commands/agent/stop.js.map +1 -0
  48. package/dist/commands/agent/update.d.ts +18 -0
  49. package/dist/commands/agent/update.d.ts.map +1 -0
  50. package/dist/commands/agent/update.js +139 -0
  51. package/dist/commands/agent/update.js.map +1 -0
  52. package/dist/commands/agent/wait.d.ts +16 -0
  53. package/dist/commands/agent/wait.d.ts.map +1 -0
  54. package/dist/commands/agent/wait.js +194 -0
  55. package/dist/commands/agent/wait.js.map +1 -0
  56. package/dist/commands/daemon/index.d.ts +4 -0
  57. package/dist/commands/daemon/index.d.ts.map +1 -0
  58. package/dist/commands/daemon/index.js +50 -0
  59. package/dist/commands/daemon/index.js.map +1 -0
  60. package/dist/commands/daemon/local-daemon.d.ts +60 -0
  61. package/dist/commands/daemon/local-daemon.d.ts.map +1 -0
  62. package/dist/commands/daemon/local-daemon.js +501 -0
  63. package/dist/commands/daemon/local-daemon.js.map +1 -0
  64. package/dist/commands/daemon/package-context.d.ts +7 -0
  65. package/dist/commands/daemon/package-context.d.ts.map +1 -0
  66. package/dist/commands/daemon/package-context.js +41 -0
  67. package/dist/commands/daemon/package-context.js.map +1 -0
  68. package/dist/commands/daemon/pair.d.ts +3 -0
  69. package/dist/commands/daemon/pair.d.ts.map +1 -0
  70. package/dist/commands/daemon/pair.js +11 -0
  71. package/dist/commands/daemon/pair.js.map +1 -0
  72. package/dist/commands/daemon/restart.d.ts +12 -0
  73. package/dist/commands/daemon/restart.d.ts.map +1 -0
  74. package/dist/commands/daemon/restart.js +102 -0
  75. package/dist/commands/daemon/restart.js.map +1 -0
  76. package/dist/commands/daemon/runtime-toolchain.d.ts +24 -0
  77. package/dist/commands/daemon/runtime-toolchain.d.ts.map +1 -0
  78. package/dist/commands/daemon/runtime-toolchain.js +93 -0
  79. package/dist/commands/daemon/runtime-toolchain.js.map +1 -0
  80. package/dist/commands/daemon/start.d.ts +6 -0
  81. package/dist/commands/daemon/start.d.ts.map +1 -0
  82. package/dist/commands/daemon/start.js +48 -0
  83. package/dist/commands/daemon/start.js.map +1 -0
  84. package/dist/commands/daemon/status.d.ts +11 -0
  85. package/dist/commands/daemon/status.d.ts.map +1 -0
  86. package/dist/commands/daemon/status.js +389 -0
  87. package/dist/commands/daemon/status.js.map +1 -0
  88. package/dist/commands/daemon/stop.d.ts +12 -0
  89. package/dist/commands/daemon/stop.d.ts.map +1 -0
  90. package/dist/commands/daemon/stop.js +69 -0
  91. package/dist/commands/daemon/stop.js.map +1 -0
  92. package/dist/commands/daemon/update.d.ts +11 -0
  93. package/dist/commands/daemon/update.d.ts.map +1 -0
  94. package/dist/commands/daemon/update.js +88 -0
  95. package/dist/commands/daemon/update.js.map +1 -0
  96. package/dist/commands/onboard.d.ts +9 -0
  97. package/dist/commands/onboard.d.ts.map +1 -0
  98. package/dist/commands/onboard.js +299 -0
  99. package/dist/commands/onboard.js.map +1 -0
  100. package/dist/commands/permit/allow.d.ts +20 -0
  101. package/dist/commands/permit/allow.d.ts.map +1 -0
  102. package/dist/commands/permit/allow.js +134 -0
  103. package/dist/commands/permit/allow.js.map +1 -0
  104. package/dist/commands/permit/deny.d.ts +12 -0
  105. package/dist/commands/permit/deny.d.ts.map +1 -0
  106. package/dist/commands/permit/deny.js +106 -0
  107. package/dist/commands/permit/deny.js.map +1 -0
  108. package/dist/commands/permit/index.d.ts +3 -0
  109. package/dist/commands/permit/index.d.ts.map +1 -0
  110. package/dist/commands/permit/index.js +37 -0
  111. package/dist/commands/permit/index.js.map +1 -0
  112. package/dist/commands/permit/ls.d.ts +18 -0
  113. package/dist/commands/permit/ls.d.ts.map +1 -0
  114. package/dist/commands/permit/ls.js +66 -0
  115. package/dist/commands/permit/ls.js.map +1 -0
  116. package/dist/commands/provider/index.d.ts +3 -0
  117. package/dist/commands/provider/index.d.ts.map +1 -0
  118. package/dist/commands/provider/index.js +23 -0
  119. package/dist/commands/provider/index.js.map +1 -0
  120. package/dist/commands/provider/ls.d.ts +17 -0
  121. package/dist/commands/provider/ls.d.ts.map +1 -0
  122. package/dist/commands/provider/ls.js +51 -0
  123. package/dist/commands/provider/ls.js.map +1 -0
  124. package/dist/commands/provider/models.d.ts +20 -0
  125. package/dist/commands/provider/models.d.ts.map +1 -0
  126. package/dist/commands/provider/models.js +53 -0
  127. package/dist/commands/provider/models.js.map +1 -0
  128. package/dist/commands/worktree/archive.d.ts +16 -0
  129. package/dist/commands/worktree/archive.d.ts.map +1 -0
  130. package/dist/commands/worktree/archive.js +98 -0
  131. package/dist/commands/worktree/archive.js.map +1 -0
  132. package/dist/commands/worktree/index.d.ts +3 -0
  133. package/dist/commands/worktree/index.d.ts.map +1 -0
  134. package/dist/commands/worktree/index.js +22 -0
  135. package/dist/commands/worktree/index.js.map +1 -0
  136. package/dist/commands/worktree/ls.d.ts +19 -0
  137. package/dist/commands/worktree/ls.d.ts.map +1 -0
  138. package/dist/commands/worktree/ls.js +97 -0
  139. package/dist/commands/worktree/ls.js.map +1 -0
  140. package/dist/daemon-only-cli.d.ts +4 -0
  141. package/dist/daemon-only-cli.d.ts.map +1 -0
  142. package/dist/daemon-only-cli.js +5 -0
  143. package/dist/daemon-only-cli.js.map +1 -0
  144. package/dist/index.d.ts +2 -0
  145. package/dist/index.d.ts.map +1 -0
  146. package/dist/index.js +7 -0
  147. package/dist/index.js.map +1 -0
  148. package/dist/output/index.d.ts +45 -0
  149. package/dist/output/index.d.ts.map +1 -0
  150. package/dist/output/index.js +47 -0
  151. package/dist/output/index.js.map +1 -0
  152. package/dist/output/json.d.ts +11 -0
  153. package/dist/output/json.d.ts.map +1 -0
  154. package/dist/output/json.js +37 -0
  155. package/dist/output/json.js.map +1 -0
  156. package/dist/output/quiet.d.ts +9 -0
  157. package/dist/output/quiet.d.ts.map +1 -0
  158. package/dist/output/quiet.js +22 -0
  159. package/dist/output/quiet.js.map +1 -0
  160. package/dist/output/render.d.ts +15 -0
  161. package/dist/output/render.d.ts.map +1 -0
  162. package/dist/output/render.js +80 -0
  163. package/dist/output/render.js.map +1 -0
  164. package/dist/output/table.d.ts +13 -0
  165. package/dist/output/table.d.ts.map +1 -0
  166. package/dist/output/table.js +135 -0
  167. package/dist/output/table.js.map +1 -0
  168. package/dist/output/types.d.ts +71 -0
  169. package/dist/output/types.d.ts.map +1 -0
  170. package/dist/output/types.js +8 -0
  171. package/dist/output/types.js.map +1 -0
  172. package/dist/output/with-output.d.ts +37 -0
  173. package/dist/output/with-output.d.ts.map +1 -0
  174. package/dist/output/with-output.js +87 -0
  175. package/dist/output/with-output.js.map +1 -0
  176. package/dist/output/yaml.d.ts +11 -0
  177. package/dist/output/yaml.d.ts.map +1 -0
  178. package/dist/output/yaml.js +38 -0
  179. package/dist/output/yaml.js.map +1 -0
  180. package/dist/utils/client-id.d.ts +2 -0
  181. package/dist/utils/client-id.d.ts.map +1 -0
  182. package/dist/utils/client-id.js +37 -0
  183. package/dist/utils/client-id.js.map +1 -0
  184. package/dist/utils/client.d.ts +35 -0
  185. package/dist/utils/client.d.ts.map +1 -0
  186. package/dist/utils/client.js +113 -0
  187. package/dist/utils/client.js.map +1 -0
  188. package/dist/utils/errors.d.ts +5 -0
  189. package/dist/utils/errors.d.ts.map +1 -0
  190. package/dist/utils/errors.js +10 -0
  191. package/dist/utils/errors.js.map +1 -0
  192. package/dist/utils/timeline.d.ts +8 -0
  193. package/dist/utils/timeline.d.ts.map +1 -0
  194. package/dist/utils/timeline.js +9 -0
  195. package/dist/utils/timeline.js.map +1 -0
  196. package/package.json +66 -0
package/dist/index.js ADDED
@@ -0,0 +1,7 @@
1
+ import { createCli } from './cli.js';
2
+ const program = createCli();
3
+ if (process.argv.length <= 2) {
4
+ process.argv.push('onboard');
5
+ }
6
+ program.parse();
7
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AAEpC,MAAM,OAAO,GAAG,SAAS,EAAE,CAAA;AAC3B,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;IAC7B,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;AAC9B,CAAC;AACD,OAAO,CAAC,KAAK,EAAE,CAAA"}
@@ -0,0 +1,45 @@
1
+ /**
2
+ * Output abstraction layer for the Junction CLI.
3
+ *
4
+ * This module provides structured output rendering with support for multiple formats:
5
+ * - table: Human-readable aligned tables (default)
6
+ * - json: Machine-readable JSON
7
+ * - yaml: Machine-readable YAML
8
+ * - quiet: Minimal output (IDs only)
9
+ *
10
+ * @example
11
+ * ```typescript
12
+ * import { withOutput, render, type ListResult, type OutputSchema } from './output/index.js'
13
+ *
14
+ * // Define your data type
15
+ * interface Agent { id: string; title: string; status: string }
16
+ *
17
+ * // Define how to render it
18
+ * const schema: OutputSchema<Agent> = {
19
+ * idField: 'id',
20
+ * columns: [
21
+ * { header: 'ID', field: 'id' },
22
+ * { header: 'TITLE', field: 'title' },
23
+ * { header: 'STATUS', field: 'status', color: (v) => v === 'running' ? 'green' : undefined },
24
+ * ],
25
+ * }
26
+ *
27
+ * // Return structured data from commands
28
+ * const result: ListResult<Agent> = {
29
+ * type: 'list',
30
+ * data: agents,
31
+ * schema,
32
+ * }
33
+ *
34
+ * // Render with options
35
+ * const output = render(result, { format: 'json' })
36
+ * ```
37
+ */
38
+ export type { OutputFormat, OutputOptions, ColumnDef, OutputSchema, CommandResult, SingleResult, ListResult, AnyCommandResult, CommandError, } from './types.js';
39
+ export { renderTable, renderTableHeader, renderTableRow } from './table.js';
40
+ export { renderJson, renderJsonLine } from './json.js';
41
+ export { renderYaml, renderYamlDoc } from './yaml.js';
42
+ export { renderQuiet } from './quiet.js';
43
+ export { render, renderError, toCommandError, defaultOutputOptions } from './render.js';
44
+ export { withOutput, createOutputOptions, type CommandOptions } from './with-output.js';
45
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/output/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAGH,YAAY,EACV,YAAY,EACZ,aAAa,EACb,SAAS,EACT,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,UAAU,EACV,gBAAgB,EAChB,YAAY,GACb,MAAM,YAAY,CAAA;AAGnB,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAC3E,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AACtD,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAGxC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAGvF,OAAO,EAAE,UAAU,EAAE,mBAAmB,EAAE,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAA"}
@@ -0,0 +1,47 @@
1
+ /**
2
+ * Output abstraction layer for the Junction CLI.
3
+ *
4
+ * This module provides structured output rendering with support for multiple formats:
5
+ * - table: Human-readable aligned tables (default)
6
+ * - json: Machine-readable JSON
7
+ * - yaml: Machine-readable YAML
8
+ * - quiet: Minimal output (IDs only)
9
+ *
10
+ * @example
11
+ * ```typescript
12
+ * import { withOutput, render, type ListResult, type OutputSchema } from './output/index.js'
13
+ *
14
+ * // Define your data type
15
+ * interface Agent { id: string; title: string; status: string }
16
+ *
17
+ * // Define how to render it
18
+ * const schema: OutputSchema<Agent> = {
19
+ * idField: 'id',
20
+ * columns: [
21
+ * { header: 'ID', field: 'id' },
22
+ * { header: 'TITLE', field: 'title' },
23
+ * { header: 'STATUS', field: 'status', color: (v) => v === 'running' ? 'green' : undefined },
24
+ * ],
25
+ * }
26
+ *
27
+ * // Return structured data from commands
28
+ * const result: ListResult<Agent> = {
29
+ * type: 'list',
30
+ * data: agents,
31
+ * schema,
32
+ * }
33
+ *
34
+ * // Render with options
35
+ * const output = render(result, { format: 'json' })
36
+ * ```
37
+ */
38
+ // Renderers
39
+ export { renderTable, renderTableHeader, renderTableRow } from './table.js';
40
+ export { renderJson, renderJsonLine } from './json.js';
41
+ export { renderYaml, renderYamlDoc } from './yaml.js';
42
+ export { renderQuiet } from './quiet.js';
43
+ // Main render function
44
+ export { render, renderError, toCommandError, defaultOutputOptions } from './render.js';
45
+ // Command wrapper
46
+ export { withOutput, createOutputOptions } from './with-output.js';
47
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/output/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAeH,YAAY;AACZ,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAC3E,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AACtD,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAExC,uBAAuB;AACvB,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAEvF,kBAAkB;AAClB,OAAO,EAAE,UAAU,EAAE,mBAAmB,EAAuB,MAAM,kBAAkB,CAAA"}
@@ -0,0 +1,11 @@
1
+ /**
2
+ * JSON renderer for CLI output.
3
+ *
4
+ * Renders structured data as formatted JSON for machine consumption.
5
+ */
6
+ import type { AnyCommandResult, OutputOptions } from './types.js';
7
+ /** Render command result as JSON */
8
+ export declare function renderJson<T>(result: AnyCommandResult<T>, _options: OutputOptions): string;
9
+ /** Render a single item as JSON line (for NDJSON streaming) */
10
+ export declare function renderJsonLine<T>(item: T, serialize?: (data: T) => unknown): string;
11
+ //# sourceMappingURL=json.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"json.d.ts","sourceRoot":"","sources":["../../src/output/json.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAEjE,oCAAoC;AACpC,wBAAgB,UAAU,CAAC,CAAC,EAC1B,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAAC,EAC3B,QAAQ,EAAE,aAAa,GACtB,MAAM,CAyBR;AAED,+DAA+D;AAC/D,wBAAgB,cAAc,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,GAAG,MAAM,CAGnF"}
@@ -0,0 +1,37 @@
1
+ /**
2
+ * JSON renderer for CLI output.
3
+ *
4
+ * Renders structured data as formatted JSON for machine consumption.
5
+ */
6
+ /** Render command result as JSON */
7
+ export function renderJson(result, _options) {
8
+ const { schema } = result;
9
+ // Apply custom serializer if provided
10
+ if (schema.serialize) {
11
+ if (result.type === 'list') {
12
+ // If all items serialize to the same object, return just one
13
+ // This handles the case where a list of key-value rows should serialize
14
+ // to a single structured object
15
+ const serialized = result.data.map((item) => schema.serialize(item));
16
+ if (serialized.length > 0) {
17
+ const first = JSON.stringify(serialized[0]);
18
+ const allSame = serialized.every((s) => JSON.stringify(s) === first);
19
+ if (allSame) {
20
+ return JSON.stringify(serialized[0], null, 2);
21
+ }
22
+ }
23
+ return JSON.stringify(serialized, null, 2);
24
+ }
25
+ else {
26
+ const serialized = schema.serialize(result.data);
27
+ return JSON.stringify(serialized, null, 2);
28
+ }
29
+ }
30
+ return JSON.stringify(result.data, null, 2);
31
+ }
32
+ /** Render a single item as JSON line (for NDJSON streaming) */
33
+ export function renderJsonLine(item, serialize) {
34
+ const output = serialize ? serialize(item) : item;
35
+ return JSON.stringify(output);
36
+ }
37
+ //# sourceMappingURL=json.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"json.js","sourceRoot":"","sources":["../../src/output/json.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,oCAAoC;AACpC,MAAM,UAAU,UAAU,CACxB,MAA2B,EAC3B,QAAuB;IAEvB,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAAA;IAEzB,sCAAsC;IACtC,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;QACrB,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YAC3B,6DAA6D;YAC7D,wEAAwE;YACxE,gCAAgC;YAChC,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,SAAU,CAAC,IAAI,CAAC,CAAC,CAAA;YACrE,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC1B,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAA;gBAC3C,MAAM,OAAO,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,CAAA;gBACpE,IAAI,OAAO,EAAE,CAAC;oBACZ,OAAO,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAA;gBAC/C,CAAC;YACH,CAAC;YACD,OAAO,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,CAAA;QAC5C,CAAC;aAAM,CAAC;YACN,MAAM,UAAU,GAAG,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;YAChD,OAAO,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,CAAA;QAC5C,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAA;AAC7C,CAAC;AAED,+DAA+D;AAC/D,MAAM,UAAU,cAAc,CAAI,IAAO,EAAE,SAAgC;IACzE,MAAM,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;IACjD,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAA;AAC/B,CAAC"}
@@ -0,0 +1,9 @@
1
+ /**
2
+ * Quiet renderer for CLI output.
3
+ *
4
+ * Outputs only ID fields, one per line. Useful for scripting and pipelines.
5
+ */
6
+ import type { AnyCommandResult, OutputOptions } from './types.js';
7
+ /** Render command result in quiet mode (IDs only) */
8
+ export declare function renderQuiet<T>(result: AnyCommandResult<T>, _options: OutputOptions): string;
9
+ //# sourceMappingURL=quiet.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"quiet.d.ts","sourceRoot":"","sources":["../../src/output/quiet.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAUjE,qDAAqD;AACrD,wBAAgB,WAAW,CAAC,CAAC,EAC3B,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAAC,EAC3B,QAAQ,EAAE,aAAa,GACtB,MAAM,CAMR"}
@@ -0,0 +1,22 @@
1
+ /**
2
+ * Quiet renderer for CLI output.
3
+ *
4
+ * Outputs only ID fields, one per line. Useful for scripting and pipelines.
5
+ */
6
+ /** Extract ID from item using schema definition */
7
+ function getId(item, idField) {
8
+ if (typeof idField === 'function') {
9
+ return idField(item);
10
+ }
11
+ return String(item[idField]);
12
+ }
13
+ /** Render command result in quiet mode (IDs only) */
14
+ export function renderQuiet(result, _options) {
15
+ if (result.type === 'single') {
16
+ return getId(result.data, result.schema.idField);
17
+ }
18
+ else {
19
+ return result.data.map((item) => getId(item, result.schema.idField)).join('\n');
20
+ }
21
+ }
22
+ //# sourceMappingURL=quiet.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"quiet.js","sourceRoot":"","sources":["../../src/output/quiet.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,mDAAmD;AACnD,SAAS,KAAK,CAAI,IAAO,EAAE,OAAwC;IACjE,IAAI,OAAO,OAAO,KAAK,UAAU,EAAE,CAAC;QAClC,OAAO,OAAO,CAAC,IAAI,CAAC,CAAA;IACtB,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAA;AAC9B,CAAC;AAED,qDAAqD;AACrD,MAAM,UAAU,WAAW,CACzB,MAA2B,EAC3B,QAAuB;IAEvB,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC7B,OAAO,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;IAClD,CAAC;SAAM,CAAC;QACN,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACjF,CAAC;AACH,CAAC"}
@@ -0,0 +1,15 @@
1
+ /**
2
+ * Main render dispatcher for CLI output.
3
+ *
4
+ * Selects the appropriate renderer based on output options.
5
+ */
6
+ import type { AnyCommandResult, CommandError, OutputOptions } from './types.js';
7
+ /** Default output options */
8
+ export declare const defaultOutputOptions: OutputOptions;
9
+ /** Render command result to string based on output options */
10
+ export declare function render<T>(result: AnyCommandResult<T>, options?: Partial<OutputOptions>): string;
11
+ /** Convert an unknown error to a CommandError */
12
+ export declare function toCommandError(error: unknown): CommandError;
13
+ /** Render an error to string based on output options */
14
+ export declare function renderError(error: CommandError, options?: Partial<OutputOptions>): string;
15
+ //# sourceMappingURL=render.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../src/output/render.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAM/E,6BAA6B;AAC7B,eAAO,MAAM,oBAAoB,EAAE,aAKlC,CAAA;AAED,8DAA8D;AAC9D,wBAAgB,MAAM,CAAC,CAAC,EACtB,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAAC,EAC3B,OAAO,GAAE,OAAO,CAAC,aAAa,CAAM,GACnC,MAAM,CAkBR;AAED,iDAAiD;AACjD,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,YAAY,CAiB3D;AAcD,wDAAwD;AACxD,wBAAgB,WAAW,CACzB,KAAK,EAAE,YAAY,EACnB,OAAO,GAAE,OAAO,CAAC,aAAa,CAAM,GACnC,MAAM,CAoBR"}
@@ -0,0 +1,80 @@
1
+ /**
2
+ * Main render dispatcher for CLI output.
3
+ *
4
+ * Selects the appropriate renderer based on output options.
5
+ */
6
+ import chalk from 'chalk';
7
+ import YAML from 'yaml';
8
+ import { renderTable } from './table.js';
9
+ import { renderJson } from './json.js';
10
+ import { renderYaml } from './yaml.js';
11
+ import { renderQuiet } from './quiet.js';
12
+ /** Default output options */
13
+ export const defaultOutputOptions = {
14
+ format: 'table',
15
+ quiet: false,
16
+ noHeaders: false,
17
+ noColor: false,
18
+ };
19
+ /** Render command result to string based on output options */
20
+ export function render(result, options = {}) {
21
+ const opts = { ...defaultOutputOptions, ...options };
22
+ // Quiet mode takes precedence
23
+ if (opts.quiet) {
24
+ return renderQuiet(result, opts);
25
+ }
26
+ // Dispatch to format-specific renderer
27
+ switch (opts.format) {
28
+ case 'json':
29
+ return renderJson(result, opts);
30
+ case 'yaml':
31
+ return renderYaml(result, opts);
32
+ case 'table':
33
+ default:
34
+ return renderTable(result, opts);
35
+ }
36
+ }
37
+ /** Convert an unknown error to a CommandError */
38
+ export function toCommandError(error) {
39
+ if (isCommandError(error)) {
40
+ return error;
41
+ }
42
+ if (error instanceof Error) {
43
+ return {
44
+ code: 'UNKNOWN_ERROR',
45
+ message: error.message,
46
+ details: error.stack,
47
+ };
48
+ }
49
+ return {
50
+ code: 'UNKNOWN_ERROR',
51
+ message: String(error),
52
+ };
53
+ }
54
+ /** Type guard for CommandError */
55
+ function isCommandError(error) {
56
+ return (typeof error === 'object' &&
57
+ error !== null &&
58
+ 'code' in error &&
59
+ 'message' in error &&
60
+ typeof error.code === 'string' &&
61
+ typeof error.message === 'string');
62
+ }
63
+ /** Render an error to string based on output options */
64
+ export function renderError(error, options = {}) {
65
+ const opts = { ...defaultOutputOptions, ...options };
66
+ if (opts.format === 'json') {
67
+ return JSON.stringify({ error }, null, 2);
68
+ }
69
+ if (opts.format === 'yaml') {
70
+ return YAML.stringify({ error });
71
+ }
72
+ // Table/default format: human-readable error
73
+ const prefix = opts.noColor ? 'Error: ' : chalk.red('Error: ');
74
+ const message = error.message;
75
+ if (error.details && typeof error.details === 'string') {
76
+ return `${prefix}${message}\n${error.details}`;
77
+ }
78
+ return `${prefix}${message}`;
79
+ }
80
+ //# sourceMappingURL=render.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"render.js","sourceRoot":"","sources":["../../src/output/render.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,13 @@
1
+ /**
2
+ * Table renderer for CLI output.
3
+ *
4
+ * Renders structured data as aligned ASCII tables with optional color support.
5
+ */
6
+ import type { AnyCommandResult, OutputOptions, OutputSchema } from './types.js';
7
+ /** Render a list result as a table */
8
+ export declare function renderTable<T>(result: AnyCommandResult<T>, options: OutputOptions): string;
9
+ /** Render just a table header (for streaming) */
10
+ export declare function renderTableHeader<T>(schema: OutputSchema<T>, options: OutputOptions, widths?: number[]): string;
11
+ /** Render just a table row (for streaming) */
12
+ export declare function renderTableRow<T>(item: T, schema: OutputSchema<T>, options: OutputOptions, widths?: number[]): string;
13
+ //# sourceMappingURL=table.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"table.d.ts","sourceRoot":"","sources":["../../src/output/table.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EACV,gBAAgB,EAEhB,aAAa,EACb,YAAY,EACb,MAAM,YAAY,CAAA;AAmInB,sCAAsC;AACtC,wBAAgB,WAAW,CAAC,CAAC,EAC3B,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAAC,EAC3B,OAAO,EAAE,aAAa,GACrB,MAAM,CAyBR;AAED,iDAAiD;AACjD,wBAAgB,iBAAiB,CAAC,CAAC,EACjC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,EACvB,OAAO,EAAE,aAAa,EACtB,MAAM,CAAC,EAAE,MAAM,EAAE,GAChB,MAAM,CAIR;AAED,8CAA8C;AAC9C,wBAAgB,cAAc,CAAC,CAAC,EAC9B,IAAI,EAAE,CAAC,EACP,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,EACvB,OAAO,EAAE,aAAa,EACtB,MAAM,CAAC,EAAE,MAAM,EAAE,GAChB,MAAM,CAIR"}
@@ -0,0 +1,135 @@
1
+ /**
2
+ * Table renderer for CLI output.
3
+ *
4
+ * Renders structured data as aligned ASCII tables with optional color support.
5
+ */
6
+ import chalk from 'chalk';
7
+ // ANSI escape code regex for stripping colors when measuring width
8
+ const ANSI_REGEX =
9
+ // eslint-disable-next-line no-control-regex
10
+ /[\u001b\u009b][[()#;?]*(?:[0-9]{1,4}(?:;[0-9]{0,4})*)?[0-9A-ORZcf-nqry=><]/g;
11
+ /** Strip ANSI escape codes from a string */
12
+ function stripAnsi(str) {
13
+ return str.replace(ANSI_REGEX, '');
14
+ }
15
+ /** Get visible string length (excluding ANSI codes) */
16
+ function visibleLength(str) {
17
+ return stripAnsi(str).length;
18
+ }
19
+ /** Pad a cell to the specified width with alignment */
20
+ function padCell(cell, width, align) {
21
+ const visible = visibleLength(cell);
22
+ const padding = Math.max(0, width - visible);
23
+ switch (align) {
24
+ case 'right':
25
+ return ' '.repeat(padding) + cell;
26
+ case 'center': {
27
+ const left = Math.floor(padding / 2);
28
+ const right = padding - left;
29
+ return ' '.repeat(left) + cell + ' '.repeat(right);
30
+ }
31
+ case 'left':
32
+ default:
33
+ return cell + ' '.repeat(padding);
34
+ }
35
+ }
36
+ /** Apply a chalk color to a string */
37
+ function applyColor(str, colorName) {
38
+ // Map color names to chalk methods
39
+ const colorMap = {
40
+ red: chalk.red,
41
+ green: chalk.green,
42
+ blue: chalk.blue,
43
+ yellow: chalk.yellow,
44
+ cyan: chalk.cyan,
45
+ magenta: chalk.magenta,
46
+ white: chalk.white,
47
+ gray: chalk.gray,
48
+ grey: chalk.grey,
49
+ dim: chalk.dim,
50
+ bold: chalk.bold,
51
+ };
52
+ const colorFn = colorMap[colorName];
53
+ return colorFn ? colorFn(str) : str;
54
+ }
55
+ /** Extract value from item using field definition */
56
+ function getValue(item, field) {
57
+ return typeof field === 'function' ? field(item) : item[field];
58
+ }
59
+ /** Render a single table row */
60
+ function renderRow(item, columns, widths, options) {
61
+ return columns
62
+ .map((col, colIndex) => {
63
+ const value = getValue(item, col.field);
64
+ let cell = String(value ?? '');
65
+ const width = widths[colIndex];
66
+ // Apply color if enabled
67
+ if (col.color && !options.noColor) {
68
+ const colorName = col.color(value, item);
69
+ if (colorName) {
70
+ cell = applyColor(cell, colorName);
71
+ }
72
+ }
73
+ return padCell(cell, width ?? 0, col.align ?? 'left');
74
+ })
75
+ .join(' ');
76
+ }
77
+ /** Render header row */
78
+ function renderHeader(columns, widths, options) {
79
+ const headerRow = columns
80
+ .map((col, i) => padCell(col.header, widths[i] ?? 0, col.align ?? 'left'))
81
+ .join(' ');
82
+ return options.noColor ? headerRow : chalk.bold(headerRow);
83
+ }
84
+ /** Calculate column widths based on content and hints */
85
+ function calculateWidths(data, columns, includeHeaders) {
86
+ return columns.map((col) => {
87
+ // Start with header width if including headers
88
+ let maxWidth = includeHeaders ? col.header.length : 0;
89
+ // Check all data values
90
+ for (const item of data) {
91
+ const value = getValue(item, col.field);
92
+ const str = String(value ?? '');
93
+ maxWidth = Math.max(maxWidth, visibleLength(str));
94
+ }
95
+ // Apply width hint if specified (minimum width)
96
+ if (col.width) {
97
+ maxWidth = Math.max(maxWidth, col.width);
98
+ }
99
+ return maxWidth;
100
+ });
101
+ }
102
+ /** Render a list result as a table */
103
+ export function renderTable(result, options) {
104
+ const { schema } = result;
105
+ const data = result.type === 'list' ? result.data : [result.data];
106
+ if (data.length === 0) {
107
+ return '';
108
+ }
109
+ const columns = schema.columns;
110
+ const includeHeaders = !options.noHeaders;
111
+ const widths = calculateWidths(data, columns, includeHeaders);
112
+ const lines = [];
113
+ // Add header row
114
+ if (includeHeaders) {
115
+ lines.push(renderHeader(columns, widths, options));
116
+ }
117
+ // Add data rows
118
+ for (const item of data) {
119
+ lines.push(renderRow(item, columns, widths, options));
120
+ }
121
+ return lines.join('\n');
122
+ }
123
+ /** Render just a table header (for streaming) */
124
+ export function renderTableHeader(schema, options, widths) {
125
+ const columns = schema.columns;
126
+ const actualWidths = widths ?? columns.map((col) => col.width ?? col.header.length);
127
+ return renderHeader(columns, actualWidths, options);
128
+ }
129
+ /** Render just a table row (for streaming) */
130
+ export function renderTableRow(item, schema, options, widths) {
131
+ const columns = schema.columns;
132
+ const actualWidths = widths ?? columns.map((col) => col.width ?? col.header.length);
133
+ return renderRow(item, columns, actualWidths, options);
134
+ }
135
+ //# sourceMappingURL=table.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"table.js","sourceRoot":"","sources":["../../src/output/table.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,71 @@
1
+ /**
2
+ * Output format types for the Junction CLI.
3
+ *
4
+ * This module defines the structured data types used by the output abstraction layer.
5
+ * Commands return CommandResult<T> which contains both data and rendering metadata.
6
+ */
7
+ /** Supported output formats */
8
+ export type OutputFormat = 'table' | 'json' | 'yaml';
9
+ /** Options controlling output rendering */
10
+ export interface OutputOptions {
11
+ /** Output format (table, json, yaml) */
12
+ format: OutputFormat;
13
+ /** Minimal output - IDs only */
14
+ quiet: boolean;
15
+ /** Omit table headers */
16
+ noHeaders: boolean;
17
+ /** Disable color output */
18
+ noColor: boolean;
19
+ }
20
+ /** Column definition for table output */
21
+ export interface ColumnDef<T> {
22
+ /** Header text for the column */
23
+ header: string;
24
+ /** Field key or accessor function */
25
+ field: keyof T | ((item: T) => unknown);
26
+ /** Optional width hint (characters) */
27
+ width?: number;
28
+ /** Optional alignment */
29
+ align?: 'left' | 'right' | 'center';
30
+ /** Optional color function - returns chalk color name */
31
+ color?: (value: unknown, item: T) => string | undefined;
32
+ }
33
+ /** Schema describing how to render command output */
34
+ export interface OutputSchema<T> {
35
+ /** Field to use for quiet mode (--quiet outputs just this) */
36
+ idField: keyof T | ((item: T) => string);
37
+ /** Column definitions for table output */
38
+ columns: ColumnDef<T>[];
39
+ /** Optional: transform data before JSON/YAML output */
40
+ serialize?: (data: T) => unknown;
41
+ }
42
+ /** Result type for commands returning a single item */
43
+ export interface SingleResult<T> {
44
+ type: 'single';
45
+ /** The structured data to render */
46
+ data: T;
47
+ /** Schema describing how to render this data (for item type T) */
48
+ schema: OutputSchema<T>;
49
+ }
50
+ /** Result type for commands returning a list */
51
+ export interface ListResult<T> {
52
+ type: 'list';
53
+ /** The structured data to render */
54
+ data: T[];
55
+ /** Schema describing how to render this data (for item type T) */
56
+ schema: OutputSchema<T>;
57
+ }
58
+ /** Union type for all command results */
59
+ export type AnyCommandResult<T> = SingleResult<T> | ListResult<T>;
60
+ /** Base interface for command results (deprecated, use SingleResult or ListResult) */
61
+ export type CommandResult<T> = SingleResult<T> | ListResult<T>;
62
+ /** Structured error for command failures */
63
+ export interface CommandError {
64
+ /** Machine-readable error code */
65
+ code: string;
66
+ /** Human-readable message */
67
+ message: string;
68
+ /** Additional context */
69
+ details?: unknown;
70
+ }
71
+ //# sourceMappingURL=types.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/output/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,+BAA+B;AAC/B,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAAA;AAEpD,2CAA2C;AAC3C,MAAM,WAAW,aAAa;IAC5B,wCAAwC;IACxC,MAAM,EAAE,YAAY,CAAA;IACpB,gCAAgC;IAChC,KAAK,EAAE,OAAO,CAAA;IACd,yBAAyB;IACzB,SAAS,EAAE,OAAO,CAAA;IAClB,2BAA2B;IAC3B,OAAO,EAAE,OAAO,CAAA;CACjB;AAED,yCAAyC;AACzC,MAAM,WAAW,SAAS,CAAC,CAAC;IAC1B,iCAAiC;IACjC,MAAM,EAAE,MAAM,CAAA;IACd,qCAAqC;IACrC,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,CAAA;IACvC,uCAAuC;IACvC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,yBAAyB;IACzB,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAA;IACnC,yDAAyD;IACzD,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,KAAK,MAAM,GAAG,SAAS,CAAA;CACxD;AAED,qDAAqD;AACrD,MAAM,WAAW,YAAY,CAAC,CAAC;IAC7B,8DAA8D;IAC9D,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,CAAC,CAAA;IACxC,0CAA0C;IAC1C,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,CAAA;IACvB,uDAAuD;IACvD,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,CAAA;CACjC;AAED,uDAAuD;AACvD,MAAM,WAAW,YAAY,CAAC,CAAC;IAC7B,IAAI,EAAE,QAAQ,CAAA;IACd,oCAAoC;IACpC,IAAI,EAAE,CAAC,CAAA;IACP,kEAAkE;IAClE,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,CAAA;CACxB;AAED,gDAAgD;AAChD,MAAM,WAAW,UAAU,CAAC,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,oCAAoC;IACpC,IAAI,EAAE,CAAC,EAAE,CAAA;IACT,kEAAkE;IAClE,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,CAAA;CACxB;AAED,yCAAyC;AACzC,MAAM,MAAM,gBAAgB,CAAC,CAAC,IAAI,YAAY,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CAAA;AAEjE,sFAAsF;AACtF,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI,YAAY,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CAAA;AAE9D,4CAA4C;AAC5C,MAAM,WAAW,YAAY;IAC3B,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAA;IACZ,6BAA6B;IAC7B,OAAO,EAAE,MAAM,CAAA;IACf,yBAAyB;IACzB,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB"}
@@ -0,0 +1,8 @@
1
+ /**
2
+ * Output format types for the Junction CLI.
3
+ *
4
+ * This module defines the structured data types used by the output abstraction layer.
5
+ * Commands return CommandResult<T> which contains both data and rendering metadata.
6
+ */
7
+ export {};
8
+ //# sourceMappingURL=types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/output/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}
@@ -0,0 +1,37 @@
1
+ /**
2
+ * Command wrapper for automatic output rendering.
3
+ *
4
+ * Wraps command handlers to automatically render results and handle errors.
5
+ */
6
+ import type { Command } from 'commander';
7
+ import type { AnyCommandResult, OutputOptions } from './types.js';
8
+ /** Options that include output settings from global options */
9
+ export interface CommandOptions extends Partial<OutputOptions> {
10
+ [key: string]: unknown;
11
+ }
12
+ /**
13
+ * Wrap a command handler to automatically render output.
14
+ *
15
+ * The wrapped handler should return a CommandResult. The wrapper will:
16
+ * 1. Call the handler
17
+ * 2. Render the result using the appropriate format
18
+ * 3. Write to stdout
19
+ * 4. Handle errors by rendering to stderr and exiting with code 1
20
+ *
21
+ * @example
22
+ * ```typescript
23
+ * program
24
+ * .command('list')
25
+ * .action(withOutput(async (options) => {
26
+ * const data = await fetchData()
27
+ * return { type: 'list', data, schema }
28
+ * }))
29
+ * ```
30
+ */
31
+ export declare function withOutput<T, Args extends unknown[]>(handler: (...args: [...Args, CommandOptions, Command]) => Promise<AnyCommandResult<T>>): (...args: [...Args, CommandOptions, Command]) => Promise<void>;
32
+ /**
33
+ * Helper to create output options from partial input.
34
+ * Useful for testing or manual rendering.
35
+ */
36
+ export declare function createOutputOptions(partial?: Partial<OutputOptions>): OutputOptions;
37
+ //# sourceMappingURL=with-output.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"with-output.d.ts","sourceRoot":"","sources":["../../src/output/with-output.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACxC,OAAO,KAAK,EAAE,gBAAgB,EAAgB,aAAa,EAAE,MAAM,YAAY,CAAA;AAG/E,+DAA+D;AAC/D,MAAM,WAAW,cAAe,SAAQ,OAAO,CAAC,aAAa,CAAC;IAC5D,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB;AAwCD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,IAAI,SAAS,OAAO,EAAE,EAClD,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,cAAc,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,GACrF,CAAC,GAAG,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,cAAc,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAsBhE;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,GAAE,OAAO,CAAC,aAAa,CAAM,GACnC,aAAa,CAEf"}