@nordsym/apiclaw 1.3.7 → 1.3.8

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 (189) hide show
  1. package/README.md +420 -200
  2. package/convex/_generated/api.d.ts +4 -0
  3. package/convex/agents.ts +403 -0
  4. package/convex/directCall.ts +80 -0
  5. package/convex/earnProgress.ts +753 -0
  6. package/convex/logs.ts +17 -0
  7. package/convex/providerKeys.ts +82 -2
  8. package/convex/schema.ts +71 -2
  9. package/convex/workspaces.ts +84 -2
  10. package/dist/adapters/base.d.ts +112 -0
  11. package/dist/adapters/base.d.ts.map +1 -0
  12. package/dist/adapters/base.js +247 -0
  13. package/dist/adapters/base.js.map +1 -0
  14. package/dist/adapters/claude-desktop.d.ts +12 -0
  15. package/dist/adapters/claude-desktop.d.ts.map +1 -0
  16. package/dist/adapters/claude-desktop.js +36 -0
  17. package/dist/adapters/claude-desktop.js.map +1 -0
  18. package/dist/adapters/cline.d.ts +20 -0
  19. package/dist/adapters/cline.d.ts.map +1 -0
  20. package/dist/adapters/cline.js +77 -0
  21. package/dist/adapters/cline.js.map +1 -0
  22. package/dist/adapters/continue.d.ts +26 -0
  23. package/dist/adapters/continue.d.ts.map +1 -0
  24. package/dist/adapters/continue.js +68 -0
  25. package/dist/adapters/continue.js.map +1 -0
  26. package/dist/adapters/cursor.d.ts +12 -0
  27. package/dist/adapters/cursor.d.ts.map +1 -0
  28. package/dist/adapters/cursor.js +38 -0
  29. package/dist/adapters/cursor.js.map +1 -0
  30. package/dist/adapters/custom.d.ts +47 -0
  31. package/dist/adapters/custom.d.ts.map +1 -0
  32. package/dist/adapters/custom.js +146 -0
  33. package/dist/adapters/custom.js.map +1 -0
  34. package/dist/adapters/detect.d.ts +69 -0
  35. package/dist/adapters/detect.d.ts.map +1 -0
  36. package/dist/adapters/detect.js +158 -0
  37. package/dist/adapters/detect.js.map +1 -0
  38. package/dist/adapters/index.d.ts +21 -0
  39. package/dist/adapters/index.d.ts.map +1 -0
  40. package/dist/adapters/index.js +23 -0
  41. package/dist/adapters/index.js.map +1 -0
  42. package/dist/adapters/windsurf.d.ts +12 -0
  43. package/dist/adapters/windsurf.d.ts.map +1 -0
  44. package/dist/adapters/windsurf.js +39 -0
  45. package/dist/adapters/windsurf.js.map +1 -0
  46. package/dist/bin.d.ts +9 -0
  47. package/dist/bin.d.ts.map +1 -0
  48. package/dist/bin.js +19 -0
  49. package/dist/bin.js.map +1 -0
  50. package/dist/cli/commands/doctor.d.ts +34 -0
  51. package/dist/cli/commands/doctor.d.ts.map +1 -0
  52. package/dist/cli/commands/doctor.js +312 -0
  53. package/dist/cli/commands/doctor.js.map +1 -0
  54. package/dist/cli/commands/index.d.ts +9 -0
  55. package/dist/cli/commands/index.d.ts.map +1 -0
  56. package/dist/cli/commands/index.js +9 -0
  57. package/dist/cli/commands/index.js.map +1 -0
  58. package/dist/cli/commands/restore.d.ts +50 -0
  59. package/dist/cli/commands/restore.d.ts.map +1 -0
  60. package/dist/cli/commands/restore.js +260 -0
  61. package/dist/cli/commands/restore.js.map +1 -0
  62. package/dist/cli/commands/setup.d.ts +19 -0
  63. package/dist/cli/commands/setup.d.ts.map +1 -0
  64. package/dist/cli/commands/setup.js +206 -0
  65. package/dist/cli/commands/setup.js.map +1 -0
  66. package/dist/cli/commands/uninstall.d.ts +37 -0
  67. package/dist/cli/commands/uninstall.d.ts.map +1 -0
  68. package/dist/cli/commands/uninstall.js +189 -0
  69. package/dist/cli/commands/uninstall.js.map +1 -0
  70. package/dist/cli/index.d.ts +7 -0
  71. package/dist/cli/index.d.ts.map +1 -0
  72. package/dist/cli/index.js +97 -0
  73. package/dist/cli/index.js.map +1 -0
  74. package/dist/discovery.d.ts +6 -2
  75. package/dist/discovery.d.ts.map +1 -1
  76. package/dist/discovery.js +296 -2
  77. package/dist/discovery.js.map +1 -1
  78. package/dist/enterprise/env.d.ts +56 -0
  79. package/dist/enterprise/env.d.ts.map +1 -0
  80. package/dist/enterprise/env.js +124 -0
  81. package/dist/enterprise/env.js.map +1 -0
  82. package/dist/enterprise/index.d.ts +7 -0
  83. package/dist/enterprise/index.d.ts.map +1 -0
  84. package/dist/enterprise/index.js +7 -0
  85. package/dist/enterprise/index.js.map +1 -0
  86. package/dist/enterprise/script-generator.d.ts +32 -0
  87. package/dist/enterprise/script-generator.d.ts.map +1 -0
  88. package/dist/enterprise/script-generator.js +461 -0
  89. package/dist/enterprise/script-generator.js.map +1 -0
  90. package/dist/execute.d.ts +21 -0
  91. package/dist/execute.d.ts.map +1 -1
  92. package/dist/execute.js +231 -0
  93. package/dist/execute.js.map +1 -1
  94. package/dist/index.js +79 -7
  95. package/dist/index.js.map +1 -1
  96. package/dist/stripe.d.ts +1 -1
  97. package/dist/stripe.js +1 -1
  98. package/dist/stripe.js.map +1 -1
  99. package/dist/types.d.ts +29 -0
  100. package/dist/types.d.ts.map +1 -1
  101. package/dist/ui/colors.d.ts +111 -0
  102. package/dist/ui/colors.d.ts.map +1 -0
  103. package/dist/ui/colors.js +185 -0
  104. package/dist/ui/colors.js.map +1 -0
  105. package/dist/ui/errors.d.ts +69 -0
  106. package/dist/ui/errors.d.ts.map +1 -0
  107. package/dist/ui/errors.js +334 -0
  108. package/dist/ui/errors.js.map +1 -0
  109. package/dist/ui/index.d.ts +10 -0
  110. package/dist/ui/index.d.ts.map +1 -0
  111. package/dist/ui/index.js +14 -0
  112. package/dist/ui/index.js.map +1 -0
  113. package/dist/ui/prompts.d.ts +88 -0
  114. package/dist/ui/prompts.d.ts.map +1 -0
  115. package/dist/ui/prompts.js +295 -0
  116. package/dist/ui/prompts.js.map +1 -0
  117. package/dist/ui/spinner.d.ts +112 -0
  118. package/dist/ui/spinner.d.ts.map +1 -0
  119. package/dist/ui/spinner.js +229 -0
  120. package/dist/ui/spinner.js.map +1 -0
  121. package/dist/utils/backup.d.ts +48 -0
  122. package/dist/utils/backup.d.ts.map +1 -0
  123. package/dist/utils/backup.js +182 -0
  124. package/dist/utils/backup.js.map +1 -0
  125. package/dist/utils/config.d.ts +80 -0
  126. package/dist/utils/config.d.ts.map +1 -0
  127. package/dist/utils/config.js +221 -0
  128. package/dist/utils/config.js.map +1 -0
  129. package/dist/utils/os.d.ts +45 -0
  130. package/dist/utils/os.d.ts.map +1 -0
  131. package/dist/utils/os.js +106 -0
  132. package/dist/utils/os.js.map +1 -0
  133. package/dist/utils/paths.d.ts +38 -0
  134. package/dist/utils/paths.d.ts.map +1 -0
  135. package/dist/utils/paths.js +160 -0
  136. package/dist/utils/paths.js.map +1 -0
  137. package/docs/PRD-BILLING.md +226 -0
  138. package/docs/PRD-EARN-SYSTEM.md +261 -0
  139. package/docs/PRD-MCP-AUTO-SETUP.md +623 -0
  140. package/docs/enterprise-deployment.md +728 -0
  141. package/landing/next.config.mjs +14 -0
  142. package/landing/public/stats.json +4 -2
  143. package/landing/scripts/generate-stats.js +12 -0
  144. package/landing/src/app/api/workspace-auth/magic-link/route.ts +6 -3
  145. package/landing/src/app/auth/verify/page.tsx +11 -4
  146. package/landing/src/app/docs/page.tsx +1 -1
  147. package/landing/src/app/join/page.tsx +49 -0
  148. package/landing/src/app/login/page.tsx +7 -1
  149. package/landing/src/app/page.tsx +13 -28
  150. package/landing/src/app/providers/register/page.tsx +1 -1
  151. package/landing/src/app/workspace/page.tsx +483 -710
  152. package/landing/src/components/CheckoutButton.tsx +1 -1
  153. package/landing/src/components/EarnCreditsTab.tsx +842 -0
  154. package/landing/src/lib/stats.json +3 -1
  155. package/package.json +9 -2
  156. package/src/adapters/base.ts +363 -0
  157. package/src/adapters/claude-desktop.ts +41 -0
  158. package/src/adapters/cline.ts +88 -0
  159. package/src/adapters/continue.ts +91 -0
  160. package/src/adapters/cursor.ts +43 -0
  161. package/src/adapters/custom.ts +188 -0
  162. package/src/adapters/detect.ts +202 -0
  163. package/src/adapters/index.ts +47 -0
  164. package/src/adapters/windsurf.ts +44 -0
  165. package/src/bin.ts +19 -0
  166. package/src/cli/commands/doctor.ts +367 -0
  167. package/src/cli/commands/index.ts +9 -0
  168. package/src/cli/commands/restore.ts +333 -0
  169. package/src/cli/commands/setup.ts +276 -0
  170. package/src/cli/commands/uninstall.ts +240 -0
  171. package/src/cli/index.ts +107 -0
  172. package/src/discovery.ts +328 -3
  173. package/src/enterprise/env.ts +156 -0
  174. package/src/enterprise/index.ts +7 -0
  175. package/src/enterprise/script-generator.ts +481 -0
  176. package/src/execute.ts +256 -0
  177. package/src/index.ts +85 -7
  178. package/src/stripe.ts +1 -1
  179. package/src/types.ts +32 -0
  180. package/src/ui/colors.ts +219 -0
  181. package/src/ui/errors.ts +394 -0
  182. package/src/ui/index.ts +17 -0
  183. package/src/ui/prompts.ts +390 -0
  184. package/src/ui/spinner.ts +325 -0
  185. package/src/utils/backup.ts +224 -0
  186. package/src/utils/config.ts +315 -0
  187. package/src/utils/os.ts +124 -0
  188. package/src/utils/paths.ts +203 -0
  189. package/landing/tsconfig.tsbuildinfo +0 -1
@@ -0,0 +1,295 @@
1
+ /**
2
+ * APIClaw MCP Auto-Setup - Interactive Prompts
3
+ *
4
+ * Inquirer-based prompts for the --wizard mode.
5
+ * Provides a guided, interactive setup experience.
6
+ */
7
+ import inquirer from 'inquirer';
8
+ import { colors, icons, header, box, codeBlock, added, bulletList } from './colors.js';
9
+ /**
10
+ * Display welcome banner
11
+ */
12
+ export function showWelcome() {
13
+ console.log(header('APIClaw MCP Auto-Setup'));
14
+ console.log(colors.secondary('Configure APIClaw as an MCP server across your AI coding assistants.\n'));
15
+ }
16
+ /**
17
+ * Prompt for client selection
18
+ */
19
+ export async function selectClients(clients) {
20
+ console.log(colors.info(`${icons.search} Detected MCP clients:\n`));
21
+ // Show detection results
22
+ for (const client of clients) {
23
+ if (client.detected) {
24
+ const status = client.alreadyConfigured
25
+ ? colors.warning(`(already configured)`)
26
+ : colors.success('(detected)');
27
+ console.log(` ${icons.success} ${colors.highlight(client.name)} ${status}`);
28
+ console.log(colors.muted(` ${client.configPath}`));
29
+ }
30
+ else {
31
+ console.log(` ${icons.pending} ${colors.muted(client.name)} ${colors.muted('(not found)')}`);
32
+ }
33
+ }
34
+ console.log();
35
+ const detectedClients = clients.filter(c => c.detected);
36
+ if (detectedClients.length === 0) {
37
+ console.log(colors.warning('No MCP clients detected on this system.'));
38
+ console.log(colors.secondary('\nYou can still configure a custom path.\n'));
39
+ }
40
+ const choices = clients.map(client => ({
41
+ name: `${client.name}${client.detected ? '' : ' (not detected)'}${client.alreadyConfigured ? ' ⚠️ already configured' : ''}`,
42
+ value: client.id,
43
+ checked: client.detected && !client.alreadyConfigured,
44
+ disabled: !client.detected && client.id !== 'custom' ? 'Not installed' : false,
45
+ }));
46
+ // Add custom option
47
+ choices.push({
48
+ name: 'Custom config path...',
49
+ value: 'custom',
50
+ checked: false,
51
+ disabled: false,
52
+ });
53
+ const { selected } = await inquirer.prompt([
54
+ {
55
+ type: 'checkbox',
56
+ name: 'selected',
57
+ message: 'Which clients do you want to configure?',
58
+ choices,
59
+ validate: (answer) => {
60
+ if (answer.length === 0) {
61
+ return 'Please select at least one client.';
62
+ }
63
+ return true;
64
+ },
65
+ },
66
+ ]);
67
+ return selected;
68
+ }
69
+ /**
70
+ * Prompt for custom config path
71
+ */
72
+ export async function promptCustomPath() {
73
+ const { customPath } = await inquirer.prompt([
74
+ {
75
+ type: 'input',
76
+ name: 'customPath',
77
+ message: 'Enter the path to your MCP config file:',
78
+ validate: (input) => {
79
+ if (!input.trim()) {
80
+ return 'Please enter a valid path.';
81
+ }
82
+ if (!input.endsWith('.json')) {
83
+ return 'Config file should be a .json file.';
84
+ }
85
+ return true;
86
+ },
87
+ },
88
+ ]);
89
+ return customPath;
90
+ }
91
+ /**
92
+ * Prompt for workspace ID
93
+ */
94
+ export async function promptWorkspace() {
95
+ const { hasWorkspace } = await inquirer.prompt([
96
+ {
97
+ type: 'confirm',
98
+ name: 'hasWorkspace',
99
+ message: 'Do you have an APIClaw workspace ID to link?',
100
+ default: false,
101
+ },
102
+ ]);
103
+ if (!hasWorkspace) {
104
+ return undefined;
105
+ }
106
+ const { workspace } = await inquirer.prompt([
107
+ {
108
+ type: 'input',
109
+ name: 'workspace',
110
+ message: 'Enter your workspace ID:',
111
+ validate: (input) => {
112
+ if (!input.trim()) {
113
+ return 'Please enter a workspace ID.';
114
+ }
115
+ if (!input.startsWith('ws_')) {
116
+ return 'Workspace ID should start with "ws_"';
117
+ }
118
+ return true;
119
+ },
120
+ },
121
+ ]);
122
+ return workspace;
123
+ }
124
+ /**
125
+ * Show preview of changes and confirm
126
+ */
127
+ export async function confirmChanges(changes, options = {}) {
128
+ console.log(header('Review Changes'));
129
+ for (const change of changes) {
130
+ const actionLabel = {
131
+ create: colors.success('CREATE'),
132
+ update: colors.warning('UPDATE'),
133
+ skip: colors.muted('SKIP'),
134
+ }[change.action];
135
+ console.log(`${actionLabel} ${colors.highlight(change.clientName)}`);
136
+ console.log(colors.muted(` ${change.configPath}\n`));
137
+ if (change.diff) {
138
+ console.log(codeBlock(change.diff));
139
+ console.log();
140
+ }
141
+ }
142
+ if (options.dryRun) {
143
+ console.log(box(colors.info('Dry-run mode: No changes will be made.'), { borderColor: colors.info }));
144
+ console.log();
145
+ return true;
146
+ }
147
+ const { confirmed } = await inquirer.prompt([
148
+ {
149
+ type: 'confirm',
150
+ name: 'confirmed',
151
+ message: 'Apply these changes?',
152
+ default: true,
153
+ },
154
+ ]);
155
+ return confirmed;
156
+ }
157
+ /**
158
+ * Prompt for force overwrite
159
+ */
160
+ export async function confirmForce(clientName) {
161
+ const { force } = await inquirer.prompt([
162
+ {
163
+ type: 'confirm',
164
+ name: 'force',
165
+ message: `${clientName} already has APIClaw configured. Overwrite?`,
166
+ default: false,
167
+ },
168
+ ]);
169
+ return force;
170
+ }
171
+ /**
172
+ * Show success message with next steps
173
+ */
174
+ export function showSuccess(configuredClients) {
175
+ console.log();
176
+ console.log(box(`${icons.check} APIClaw configured successfully!\n\n` +
177
+ `Configured: ${configuredClients.join(', ')}`, { title: 'Success', borderColor: colors.success }));
178
+ console.log(colors.secondary('\nNext steps:'));
179
+ console.log(bulletList([
180
+ `Restart ${configuredClients.join(' / ')}`,
181
+ 'Ask your agent: "List available APIs"',
182
+ ], 2));
183
+ console.log(colors.secondary('\nNeed help?'));
184
+ console.log(` ${colors.link('https://docs.apiclaw.com/setup')}\n`);
185
+ }
186
+ /**
187
+ * Show dry-run summary
188
+ */
189
+ export function showDryRunSummary(changes) {
190
+ console.log();
191
+ console.log(box(`${icons.info} Dry-run complete\n\n` +
192
+ `Would configure: ${changes.filter(c => c.action !== 'skip').length} client(s)\n` +
193
+ `Would skip: ${changes.filter(c => c.action === 'skip').length} client(s)`, { title: 'Dry Run', borderColor: colors.info }));
194
+ console.log(colors.secondary('\nTo apply changes, run:'));
195
+ console.log(colors.action(' npx @nordsym/apiclaw setup\n'));
196
+ }
197
+ /**
198
+ * Run the full interactive wizard
199
+ */
200
+ export async function runWizard(clients, options = {}) {
201
+ showWelcome();
202
+ // Select clients
203
+ const selectedClients = await selectClients(clients);
204
+ // Handle custom path if selected
205
+ const finalClients = [...selectedClients];
206
+ if (selectedClients.includes('custom')) {
207
+ const customPath = await promptCustomPath();
208
+ // Remove 'custom' placeholder and add actual path
209
+ const idx = finalClients.indexOf('custom');
210
+ finalClients[idx] = `custom:${customPath}`;
211
+ }
212
+ // Optionally link workspace
213
+ const workspace = await promptWorkspace();
214
+ // Build preview changes
215
+ const changes = finalClients.map(clientId => {
216
+ const isCustom = clientId.startsWith('custom:');
217
+ const client = isCustom
218
+ ? { id: 'custom', name: 'Custom', configPath: clientId.replace('custom:', ''), alreadyConfigured: false }
219
+ : clients.find(c => c.id === clientId);
220
+ return {
221
+ clientId: client.id,
222
+ clientName: client.name,
223
+ configPath: client.configPath,
224
+ action: client.alreadyConfigured ? 'skip' : 'update',
225
+ diff: generateDiff(workspace),
226
+ };
227
+ });
228
+ // Confirm changes
229
+ const confirmed = await confirmChanges(changes, { dryRun: options.dryRun });
230
+ return {
231
+ selectedClients: finalClients,
232
+ workspace,
233
+ confirmed,
234
+ dryRun: options.dryRun || false,
235
+ };
236
+ }
237
+ /**
238
+ * Generate diff preview for config change
239
+ */
240
+ function generateDiff(workspace) {
241
+ const lines = [
242
+ added('"apiclaw": {'),
243
+ added(' "command": "npx",'),
244
+ added(' "args": ["-y", "@nordsym/apiclaw"]'),
245
+ ];
246
+ if (workspace) {
247
+ lines.splice(2, 0, added(` "env": { "APICLAW_WORKSPACE": "${workspace}" },`));
248
+ }
249
+ lines.push(added('}'));
250
+ return lines.join('\n');
251
+ }
252
+ /**
253
+ * Prompt for restore backup selection
254
+ */
255
+ export async function selectBackup(backups) {
256
+ if (backups.length === 0) {
257
+ console.log(colors.warning('No backups found.'));
258
+ return null;
259
+ }
260
+ const choices = backups.map(b => ({
261
+ name: `${b.client} - ${b.date.toLocaleString()} (${b.path})`,
262
+ value: b.path,
263
+ }));
264
+ choices.push({
265
+ name: 'Cancel',
266
+ value: '',
267
+ });
268
+ const { backup } = await inquirer.prompt([
269
+ {
270
+ type: 'list',
271
+ name: 'backup',
272
+ message: 'Select a backup to restore:',
273
+ choices,
274
+ },
275
+ ]);
276
+ return backup || null;
277
+ }
278
+ /**
279
+ * Confirm uninstall
280
+ */
281
+ export async function confirmUninstall(clients) {
282
+ console.log(colors.warning('\n⚠️ This will remove APIClaw from:\n'));
283
+ console.log(bulletList(clients, 2));
284
+ console.log();
285
+ const { confirmed } = await inquirer.prompt([
286
+ {
287
+ type: 'confirm',
288
+ name: 'confirmed',
289
+ message: 'Are you sure you want to uninstall APIClaw?',
290
+ default: false,
291
+ },
292
+ ]);
293
+ return confirmed;
294
+ }
295
+ //# sourceMappingURL=prompts.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"prompts.js","sourceRoot":"","sources":["../../src/ui/prompts.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,112 @@
1
+ /**
2
+ * APIClaw MCP Auto-Setup - Spinner Utilities
3
+ *
4
+ * Ora-based spinner wrapper with consistent styling and state management.
5
+ * Provides a fluent API for progress indication during CLI operations.
6
+ */
7
+ import { Ora, Options as OraOptions } from 'ora';
8
+ export interface SpinnerOptions {
9
+ /** Spinner text */
10
+ text?: string;
11
+ /** Prefix text before spinner */
12
+ prefix?: string;
13
+ /** Suffix text after spinner */
14
+ suffix?: string;
15
+ /** Whether to show spinner in CI environments */
16
+ showInCI?: boolean;
17
+ /** Custom spinner frames */
18
+ spinner?: OraOptions['spinner'];
19
+ }
20
+ export interface TaskSpinner {
21
+ /** Start the spinner with optional text */
22
+ start(text?: string): TaskSpinner;
23
+ /** Update spinner text */
24
+ text(text: string): TaskSpinner;
25
+ /** Mark as successful with optional message */
26
+ succeed(text?: string): TaskSpinner;
27
+ /** Mark as failed with optional message */
28
+ fail(text?: string): TaskSpinner;
29
+ /** Mark as warning with optional message */
30
+ warn(text?: string): TaskSpinner;
31
+ /** Show info message without stopping */
32
+ info(text?: string): TaskSpinner;
33
+ /** Stop spinner without status */
34
+ stop(): TaskSpinner;
35
+ /** Stop and clear spinner */
36
+ clear(): TaskSpinner;
37
+ /** Check if spinner is currently spinning */
38
+ isSpinning(): boolean;
39
+ /** Access underlying ora instance */
40
+ readonly ora: Ora;
41
+ }
42
+ /**
43
+ * Create a task spinner with APIClaw styling
44
+ */
45
+ export declare function createSpinner(options?: SpinnerOptions): TaskSpinner;
46
+ /**
47
+ * Convenience function for common spinner patterns
48
+ */
49
+ export declare const spinner: {
50
+ /**
51
+ * Create and start a spinner in one call
52
+ */
53
+ start(text: string): TaskSpinner;
54
+ /**
55
+ * Run an async task with spinner, auto-succeed/fail
56
+ */
57
+ task<T>(text: string, fn: (spinner: TaskSpinner) => Promise<T>, options?: {
58
+ successText?: string | ((result: T) => string);
59
+ failText?: string | ((error: Error) => string);
60
+ }): Promise<T>;
61
+ /**
62
+ * Run multiple tasks in sequence with spinners
63
+ */
64
+ sequence<T>(tasks: Array<{
65
+ text: string;
66
+ task: () => Promise<T>;
67
+ successText?: string;
68
+ failText?: string;
69
+ }>): Promise<T[]>;
70
+ };
71
+ /**
72
+ * Progress tracker for multi-step operations
73
+ */
74
+ export declare class ProgressTracker {
75
+ private current;
76
+ private readonly total;
77
+ private readonly items;
78
+ private readonly taskSpinner;
79
+ constructor(items: string[]);
80
+ /**
81
+ * Start tracking progress
82
+ */
83
+ start(): void;
84
+ /**
85
+ * Move to next item
86
+ */
87
+ next(): void;
88
+ /**
89
+ * Mark current item as done and move to next
90
+ */
91
+ done(message?: string): void;
92
+ /**
93
+ * Mark as complete
94
+ */
95
+ complete(message: string): void;
96
+ /**
97
+ * Mark as failed
98
+ */
99
+ fail(message: string): void;
100
+ private updateText;
101
+ private formatProgress;
102
+ }
103
+ /**
104
+ * Silent spinner for non-interactive/CI environments
105
+ * Logs plain text instead of animated spinners
106
+ */
107
+ export declare function createSilentSpinner(options?: SpinnerOptions): TaskSpinner;
108
+ /**
109
+ * Get appropriate spinner based on environment
110
+ */
111
+ export declare function getSpinner(options?: SpinnerOptions): TaskSpinner;
112
+ //# sourceMappingURL=spinner.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"spinner.d.ts","sourceRoot":"","sources":["../../src/ui/spinner.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,229 @@
1
+ /**
2
+ * APIClaw MCP Auto-Setup - Spinner Utilities
3
+ *
4
+ * Ora-based spinner wrapper with consistent styling and state management.
5
+ * Provides a fluent API for progress indication during CLI operations.
6
+ */
7
+ import ora from 'ora';
8
+ import { colors, icons } from './colors.js';
9
+ /**
10
+ * Create a task spinner with APIClaw styling
11
+ */
12
+ export function createSpinner(options = {}) {
13
+ const { text = '', prefix = '', suffix = '', showInCI = false, spinner = 'dots', } = options;
14
+ const oraInstance = ora({
15
+ text,
16
+ prefixText: prefix,
17
+ suffixText: suffix,
18
+ spinner,
19
+ // Disable spinner in CI by default for cleaner logs
20
+ isEnabled: showInCI || !process.env.CI,
21
+ });
22
+ const wrapper = {
23
+ start(newText) {
24
+ if (newText)
25
+ oraInstance.text = newText;
26
+ oraInstance.start();
27
+ return wrapper;
28
+ },
29
+ text(newText) {
30
+ oraInstance.text = newText;
31
+ return wrapper;
32
+ },
33
+ succeed(newText) {
34
+ oraInstance.succeed(newText);
35
+ return wrapper;
36
+ },
37
+ fail(newText) {
38
+ oraInstance.fail(newText);
39
+ return wrapper;
40
+ },
41
+ warn(newText) {
42
+ oraInstance.warn(newText);
43
+ return wrapper;
44
+ },
45
+ info(newText) {
46
+ oraInstance.info(newText);
47
+ return wrapper;
48
+ },
49
+ stop() {
50
+ oraInstance.stop();
51
+ return wrapper;
52
+ },
53
+ clear() {
54
+ oraInstance.stopAndPersist({ symbol: '' });
55
+ return wrapper;
56
+ },
57
+ isSpinning() {
58
+ return oraInstance.isSpinning;
59
+ },
60
+ get ora() {
61
+ return oraInstance;
62
+ },
63
+ };
64
+ return wrapper;
65
+ }
66
+ /**
67
+ * Convenience function for common spinner patterns
68
+ */
69
+ export const spinner = {
70
+ /**
71
+ * Create and start a spinner in one call
72
+ */
73
+ start(text) {
74
+ return createSpinner({ text }).start();
75
+ },
76
+ /**
77
+ * Run an async task with spinner, auto-succeed/fail
78
+ */
79
+ async task(text, fn, options = {}) {
80
+ const s = createSpinner({ text }).start();
81
+ try {
82
+ const result = await fn(s);
83
+ const successMsg = typeof options.successText === 'function'
84
+ ? options.successText(result)
85
+ : options.successText || text;
86
+ s.succeed(successMsg);
87
+ return result;
88
+ }
89
+ catch (error) {
90
+ const failMsg = typeof options.failText === 'function'
91
+ ? options.failText(error)
92
+ : options.failText || `${text} - Failed`;
93
+ s.fail(failMsg);
94
+ throw error;
95
+ }
96
+ },
97
+ /**
98
+ * Run multiple tasks in sequence with spinners
99
+ */
100
+ async sequence(tasks) {
101
+ const results = [];
102
+ for (const { text, task, successText, failText } of tasks) {
103
+ const result = await this.task(text, task, { successText, failText });
104
+ results.push(result);
105
+ }
106
+ return results;
107
+ },
108
+ };
109
+ /**
110
+ * Progress tracker for multi-step operations
111
+ */
112
+ export class ProgressTracker {
113
+ current = 0;
114
+ total;
115
+ items;
116
+ taskSpinner;
117
+ constructor(items) {
118
+ this.items = items;
119
+ this.total = items.length;
120
+ this.taskSpinner = createSpinner();
121
+ }
122
+ /**
123
+ * Start tracking progress
124
+ */
125
+ start() {
126
+ this.current = 0;
127
+ this.updateText();
128
+ this.taskSpinner.start();
129
+ }
130
+ /**
131
+ * Move to next item
132
+ */
133
+ next() {
134
+ this.current++;
135
+ this.updateText();
136
+ }
137
+ /**
138
+ * Mark current item as done and move to next
139
+ */
140
+ done(message) {
141
+ this.taskSpinner.succeed(message || this.items[this.current - 1]);
142
+ if (this.current < this.total) {
143
+ this.taskSpinner.start(this.formatProgress());
144
+ }
145
+ }
146
+ /**
147
+ * Mark as complete
148
+ */
149
+ complete(message) {
150
+ this.taskSpinner.succeed(message);
151
+ }
152
+ /**
153
+ * Mark as failed
154
+ */
155
+ fail(message) {
156
+ this.taskSpinner.fail(message);
157
+ }
158
+ updateText() {
159
+ this.taskSpinner.text(this.formatProgress());
160
+ }
161
+ formatProgress() {
162
+ const item = this.items[this.current] || 'Processing...';
163
+ return `[${this.current + 1}/${this.total}] ${item}`;
164
+ }
165
+ }
166
+ /**
167
+ * Silent spinner for non-interactive/CI environments
168
+ * Logs plain text instead of animated spinners
169
+ */
170
+ export function createSilentSpinner(options = {}) {
171
+ const log = (symbol, text) => {
172
+ if (text) {
173
+ console.log(`${symbol} ${text}`);
174
+ }
175
+ };
176
+ let currentText = options.text || '';
177
+ const wrapper = {
178
+ start(text) {
179
+ currentText = text || currentText;
180
+ log(colors.muted('○'), currentText);
181
+ return wrapper;
182
+ },
183
+ text(text) {
184
+ currentText = text;
185
+ return wrapper;
186
+ },
187
+ succeed(text) {
188
+ log(icons.success, text || currentText);
189
+ return wrapper;
190
+ },
191
+ fail(text) {
192
+ log(icons.error, text || currentText);
193
+ return wrapper;
194
+ },
195
+ warn(text) {
196
+ log(icons.warning, text || currentText);
197
+ return wrapper;
198
+ },
199
+ info(text) {
200
+ log(icons.info, text || currentText);
201
+ return wrapper;
202
+ },
203
+ stop() {
204
+ return wrapper;
205
+ },
206
+ clear() {
207
+ return wrapper;
208
+ },
209
+ isSpinning() {
210
+ return false;
211
+ },
212
+ get ora() {
213
+ // Return a mock for compatibility
214
+ return {};
215
+ },
216
+ };
217
+ return wrapper;
218
+ }
219
+ /**
220
+ * Get appropriate spinner based on environment
221
+ */
222
+ export function getSpinner(options = {}) {
223
+ // Use silent spinner in CI or when stdout is not a TTY
224
+ if (process.env.CI || !process.stdout.isTTY) {
225
+ return createSilentSpinner(options);
226
+ }
227
+ return createSpinner(options);
228
+ }
229
+ //# sourceMappingURL=spinner.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"spinner.js","sourceRoot":"","sources":["../../src/ui/spinner.ts"],"names":[],"mappings":"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"}