@hasna/skills 0.1.27 → 0.1.29

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 (488) hide show
  1. package/LICENSE +1 -10
  2. package/README.md +141 -39
  3. package/bin/index.js +30121 -27576
  4. package/bin/mcp.js +22073 -18556
  5. package/dist/cli/cli.test-utils.d.ts +15 -0
  6. package/dist/cli/commands/auth.d.ts +2 -0
  7. package/dist/cli/commands/install.d.ts +1 -1
  8. package/dist/cli/commands/runtime-mcp.d.ts +4 -0
  9. package/dist/index.d.ts +9 -4
  10. package/dist/index.js +11606 -598
  11. package/dist/lib/auth-store.d.ts +13 -0
  12. package/dist/lib/installer.d.ts +58 -55
  13. package/dist/lib/mcp-contracts.d.ts +86 -0
  14. package/dist/lib/project-state.d.ts +43 -0
  15. package/dist/lib/registry-data/business-marketing.d.ts +2 -0
  16. package/dist/lib/registry-data/communication.d.ts +2 -0
  17. package/dist/lib/registry-data/content-generation.d.ts +2 -0
  18. package/dist/lib/registry-data/data-analysis.d.ts +2 -0
  19. package/dist/lib/registry-data/design-branding.d.ts +2 -0
  20. package/dist/lib/registry-data/development-tools.d.ts +2 -0
  21. package/dist/lib/registry-data/education-learning.d.ts +2 -0
  22. package/dist/lib/registry-data/event-management.d.ts +2 -0
  23. package/dist/lib/registry-data/finance-compliance.d.ts +2 -0
  24. package/dist/lib/registry-data/health-wellness.d.ts +2 -0
  25. package/dist/lib/registry-data/index.d.ts +2 -0
  26. package/dist/lib/registry-data/media-processing.d.ts +2 -0
  27. package/dist/lib/registry-data/productivity-organization.d.ts +2 -0
  28. package/dist/lib/registry-data/project-management.d.ts +2 -0
  29. package/dist/lib/registry-data/research-writing.d.ts +2 -0
  30. package/dist/lib/registry-data/science-academic.d.ts +2 -0
  31. package/dist/lib/registry-data/travel-lifestyle.d.ts +2 -0
  32. package/dist/lib/registry-data/web-browser.d.ts +2 -0
  33. package/dist/lib/registry-types.d.ts +27 -0
  34. package/dist/lib/registry.d.ts +6 -18
  35. package/dist/lib/remote-registry.d.ts +3 -0
  36. package/dist/lib/run-state.d.ts +60 -0
  37. package/dist/lib/skill-aliases.d.ts +17 -0
  38. package/dist/lib/skillinfo.d.ts +5 -1
  39. package/dist/mcp/discovery-tools.d.ts +2 -0
  40. package/dist/mcp/helpers.d.ts +26 -0
  41. package/dist/mcp/http.d.ts +10 -0
  42. package/dist/mcp/index.d.ts +3 -2
  43. package/dist/mcp/operation-tools.d.ts +2 -0
  44. package/dist/mcp/resource-meta-tools.d.ts +2 -0
  45. package/dist/mcp/schedule-tools.d.ts +2 -0
  46. package/dist/mcp/server.d.ts +4 -0
  47. package/dist/types/api.d.ts +7 -4
  48. package/package.json +22 -11
  49. package/skills/_common/http-client.ts +1 -1
  50. package/skills/_common/index.ts +2 -3
  51. package/skills/_common/install.sh +5 -110
  52. package/skills/_common/installer.ts +31 -282
  53. package/skills/_common/skill-install.ts +14 -181
  54. package/skills/ad-creative-pack/SKILL.md +45 -0
  55. package/skills/ad-creative-pack/package.json +14 -0
  56. package/skills/advanced-math/package.json +3 -1
  57. package/skills/advanced-math/src/calculators.ts +118 -0
  58. package/skills/advanced-math/src/cli.ts +130 -0
  59. package/skills/advanced-math/src/conversion.ts +90 -0
  60. package/skills/advanced-math/src/finance.ts +75 -0
  61. package/skills/advanced-math/src/formatting.ts +95 -0
  62. package/skills/advanced-math/src/index.ts +24 -702
  63. package/skills/advanced-math/src/runtime.ts +49 -0
  64. package/skills/advanced-math/src/symbolic.ts +110 -0
  65. package/skills/advanced-math/src/types.ts +36 -0
  66. package/skills/analyze-data/SKILL.md +2 -2
  67. package/skills/analyze-data/src/analysis.ts +401 -0
  68. package/skills/analyze-data/src/cli.ts +66 -0
  69. package/skills/analyze-data/src/formatters.ts +235 -0
  70. package/skills/analyze-data/src/index.ts +6 -1027
  71. package/skills/analyze-data/src/logger.ts +36 -0
  72. package/skills/analyze-data/src/parsers.ts +57 -0
  73. package/skills/analyze-data/src/stats.ts +151 -0
  74. package/skills/analyze-data/src/types.ts +85 -0
  75. package/skills/api-docs-portal/SKILL.md +46 -0
  76. package/skills/api-docs-portal/package.json +9 -0
  77. package/skills/api-test-suite/src/index.ts +13 -0
  78. package/skills/apidocs/package.json +1 -1
  79. package/skills/apidocs/src/index.ts +3 -0
  80. package/skills/audio/package.json +2 -3
  81. package/skills/audio-cleanup-lab/SKILL.md +2 -2
  82. package/skills/audio-extract/CLAUDE.md +1 -1
  83. package/skills/audio-transcript-pack/SKILL.md +43 -0
  84. package/skills/audio-transcript-pack/package.json +10 -0
  85. package/skills/blog-article/CLAUDE.md +12 -0
  86. package/skills/blog-article/SKILL.md +45 -0
  87. package/skills/{create-blog-article → blog-article}/package.json +3 -3
  88. package/skills/brand-kit/SKILL.md +45 -0
  89. package/skills/brand-kit/package.json +14 -0
  90. package/skills/brand-photo-shoot/SKILL.md +28 -0
  91. package/skills/brand-photo-shoot/package.json +10 -0
  92. package/skills/brand-style-guide/SKILL.md +2 -2
  93. package/skills/brand-style-guide/src/index.ts +0 -0
  94. package/skills/budget-variance-analyzer/SKILL.md +2 -2
  95. package/skills/businessactivity/package.json +1 -1
  96. package/skills/businessactivity/src/index.ts +3 -0
  97. package/skills/calendar-events/src/ai-parser.ts +103 -0
  98. package/skills/calendar-events/src/api.ts +157 -0
  99. package/skills/calendar-events/src/auth.ts +22 -0
  100. package/skills/calendar-events/src/config.ts +6 -0
  101. package/skills/calendar-events/src/format.ts +96 -0
  102. package/skills/calendar-events/src/help.ts +54 -0
  103. package/skills/calendar-events/src/index.ts +21 -524
  104. package/skills/calendar-events/src/logger.ts +34 -0
  105. package/skills/calendar-events/src/types.ts +67 -0
  106. package/skills/compress-video/SKILL.md +2 -2
  107. package/skills/consolelog/exports/products-2025-12-14T13-50-53-041Z.csv +16 -0
  108. package/skills/consolelog/exports/products-2025-12-14T13-50-53-041Z.json +227 -0
  109. package/skills/consolelog/package.json +1 -1
  110. package/skills/consolelog/src/index.ts +3 -0
  111. package/skills/contract-review-report/SKILL.md +43 -0
  112. package/skills/contract-review-report/package.json +10 -0
  113. package/skills/convert/SKILL.md +2 -3
  114. package/skills/customer-feedback-report/SKILL.md +44 -0
  115. package/skills/customer-feedback-report/package.json +10 -0
  116. package/skills/dashboard-builder/package.json +3 -1
  117. package/skills/database-explorer/package.json +3 -1
  118. package/skills/deepresearch/README.md +4 -13
  119. package/skills/deploy/src/http-client.ts +1 -1
  120. package/skills/diff-viewer/package.json +4 -1
  121. package/skills/doc-generate/package.json +0 -1
  122. package/skills/doc-generate/src/ai.ts +50 -0
  123. package/skills/doc-generate/src/cli.ts +203 -0
  124. package/skills/doc-generate/src/dependencies.ts +44 -0
  125. package/skills/doc-generate/src/document-builder.ts +299 -0
  126. package/skills/doc-generate/src/index.ts +40 -764
  127. package/skills/doc-generate/src/markdown-parser.ts +125 -0
  128. package/skills/doc-generate/src/types.ts +68 -0
  129. package/skills/domainpurchase/SKILL.md +1 -1
  130. package/skills/domainpurchase/package.json +1 -1
  131. package/skills/domainpurchase/src/index.ts +3 -0
  132. package/skills/domainsearch/SKILL.md +1 -1
  133. package/skills/domainsearch/package.json +1 -1
  134. package/skills/domainsearch/src/index.ts +3 -0
  135. package/skills/email-sequence/SKILL.md +44 -0
  136. package/skills/email-sequence/package.json +14 -0
  137. package/skills/excel/CLAUDE.md +2 -2
  138. package/skills/experiment-power-calculator/package.json +3 -1
  139. package/skills/extract-invoice/src/cli.ts +97 -0
  140. package/skills/extract-invoice/src/extractor.ts +170 -0
  141. package/skills/extract-invoice/src/file-utils.ts +46 -0
  142. package/skills/extract-invoice/src/formatters.ts +144 -0
  143. package/skills/extract-invoice/src/index.ts +44 -629
  144. package/skills/extract-invoice/src/runtime.ts +46 -0
  145. package/skills/extract-invoice/src/types.ts +88 -0
  146. package/skills/folder-tree/package.json +3 -1
  147. package/skills/form-filler/package.json +3 -1
  148. package/skills/generate-api-client/package.json +3 -1
  149. package/skills/generate-api-client/src/generator.ts +47 -0
  150. package/skills/generate-api-client/src/index.ts +3 -777
  151. package/skills/generate-api-client/src/logger.ts +34 -0
  152. package/skills/generate-api-client/src/python-generator.ts +245 -0
  153. package/skills/generate-api-client/src/spec-loader.ts +48 -0
  154. package/skills/generate-api-client/src/type-mappers.ts +79 -0
  155. package/skills/generate-api-client/src/types.ts +76 -0
  156. package/skills/generate-api-client/src/typescript-generator.ts +247 -0
  157. package/skills/generate-book-cover/package.json +3 -1
  158. package/skills/generate-dockerfile/src/cli.ts +78 -0
  159. package/skills/generate-dockerfile/src/dockerfile-templates.ts +392 -0
  160. package/skills/generate-dockerfile/src/index.ts +12 -790
  161. package/skills/generate-dockerfile/src/logger.ts +30 -0
  162. package/skills/generate-dockerfile/src/project-detection.ts +68 -0
  163. package/skills/generate-dockerfile/src/support-files.ts +171 -0
  164. package/skills/generate-dockerfile/src/types.ts +29 -0
  165. package/skills/generate-documentation/src/ai.ts +131 -0
  166. package/skills/generate-documentation/src/cli.ts +71 -0
  167. package/skills/generate-documentation/src/code-parser.ts +300 -0
  168. package/skills/generate-documentation/src/file-processing.ts +182 -0
  169. package/skills/generate-documentation/src/index.ts +13 -753
  170. package/skills/generate-documentation/src/runtime.ts +35 -0
  171. package/skills/generate-documentation/src/types.ts +30 -0
  172. package/skills/generate-env/package.json +3 -1
  173. package/skills/generate-env/src/cli.ts +85 -0
  174. package/skills/generate-env/src/detection.ts +161 -0
  175. package/skills/generate-env/src/env-data.ts +66 -0
  176. package/skills/generate-env/src/generators.ts +240 -0
  177. package/skills/generate-env/src/index.ts +76 -676
  178. package/skills/generate-env/src/runtime.ts +30 -0
  179. package/skills/generate-env/src/types.ts +32 -0
  180. package/skills/generate-favicon/package.json +3 -1
  181. package/skills/generate-mock-data/package.json +3 -1
  182. package/skills/generate-mock-data/src/ai.ts +102 -0
  183. package/skills/generate-mock-data/src/formatters.ts +84 -0
  184. package/skills/generate-mock-data/src/generator.ts +377 -0
  185. package/skills/generate-mock-data/src/index.ts +15 -716
  186. package/skills/generate-mock-data/src/logger.ts +37 -0
  187. package/skills/generate-mock-data/src/presets.ts +110 -0
  188. package/skills/generate-mock-data/src/types.ts +21 -0
  189. package/skills/generate-pr-description/src/ai.ts +144 -0
  190. package/skills/generate-pr-description/src/cli.ts +80 -0
  191. package/skills/generate-pr-description/src/clipboard.ts +30 -0
  192. package/skills/generate-pr-description/src/formatters.ts +231 -0
  193. package/skills/generate-pr-description/src/git.ts +153 -0
  194. package/skills/generate-pr-description/src/index.ts +21 -714
  195. package/skills/generate-pr-description/src/types.ts +49 -0
  196. package/skills/generate-presentation/src/ai-clients.ts +61 -0
  197. package/skills/generate-presentation/src/cli.ts +126 -0
  198. package/skills/generate-presentation/src/index.ts +3 -751
  199. package/skills/generate-presentation/src/logger.ts +67 -0
  200. package/skills/generate-presentation/src/presentation-generator.ts +425 -0
  201. package/skills/generate-presentation/src/runtime.ts +6 -0
  202. package/skills/generate-presentation/src/security.ts +12 -0
  203. package/skills/generate-presentation/src/types.ts +28 -0
  204. package/skills/generate-qrcode/package.json +4 -1
  205. package/skills/generate-regex/package.json +3 -1
  206. package/skills/generate-resume/src/cli.ts +157 -0
  207. package/skills/generate-resume/src/index.ts +13 -917
  208. package/skills/generate-resume/src/parsers.ts +95 -0
  209. package/skills/generate-resume/src/renderers.ts +538 -0
  210. package/skills/generate-resume/src/security.ts +39 -0
  211. package/skills/generate-resume/src/types.ts +86 -0
  212. package/skills/generate-social-posts/src/ai.ts +88 -0
  213. package/skills/generate-social-posts/src/cli.ts +118 -0
  214. package/skills/generate-social-posts/src/exporters.ts +126 -0
  215. package/skills/generate-social-posts/src/generator.ts +130 -0
  216. package/skills/generate-social-posts/src/index.ts +19 -709
  217. package/skills/generate-social-posts/src/platforms.ts +39 -0
  218. package/skills/generate-social-posts/src/runtime.ts +34 -0
  219. package/skills/generate-social-posts/src/source.ts +116 -0
  220. package/skills/generate-social-posts/src/types.ts +58 -0
  221. package/skills/gif-maker/package.json +4 -1
  222. package/skills/github-manager/package.json +3 -1
  223. package/skills/gmail/CLAUDE.md +1 -1
  224. package/skills/highlight-reel-generator/src/index.ts +19 -0
  225. package/skills/hook/src/commands/create.ts +20 -845
  226. package/skills/hook/src/templates/root.ts +196 -0
  227. package/skills/hook/src/templates/source.ts +647 -0
  228. package/skills/http-server/package.json +3 -1
  229. package/skills/icon-pack/README.md +28 -0
  230. package/skills/icon-pack/SKILL.md +23 -0
  231. package/skills/icon-pack/package.json +29 -0
  232. package/skills/{audio → icon-pack}/tsconfig.json +10 -12
  233. package/skills/image/package.json +1 -2
  234. package/skills/implementation-agent/package.json +3 -1
  235. package/skills/implementation-agent/src/ai-generation.ts +225 -0
  236. package/skills/implementation-agent/src/index.ts +3 -960
  237. package/skills/implementation-agent/src/minimist.d.ts +15 -0
  238. package/skills/implementation-agent/src/templates.ts +686 -0
  239. package/skills/implementation-agent/src/types.ts +53 -0
  240. package/skills/implementation-plan/package.json +3 -1
  241. package/skills/implementation-todo/package.json +3 -1
  242. package/skills/invoice/package.json +1 -1
  243. package/skills/invoice/src/index.ts +3 -0
  244. package/skills/invoice-reconciliation/SKILL.md +42 -0
  245. package/skills/invoice-reconciliation/package.json +10 -0
  246. package/skills/landing-page-pack/SKILL.md +47 -0
  247. package/skills/landing-page-pack/package.json +14 -0
  248. package/skills/latex-table-generator/package.json +3 -1
  249. package/skills/logo-design/SKILL.md +25 -44
  250. package/skills/logo-design/package.json +3 -15
  251. package/skills/lorem-generator/package.json +3 -1
  252. package/skills/lorem-generator/src/index.ts +13 -0
  253. package/skills/managehook/package.json +1 -1
  254. package/skills/managehook/src/index.ts +3 -0
  255. package/skills/managemcp/package.json +1 -1
  256. package/skills/managemcp/src/index.ts +3 -0
  257. package/skills/manageskill/package.json +1 -1
  258. package/skills/manageskill/src/index.ts +3 -0
  259. package/skills/markdown-validator/package.json +3 -1
  260. package/skills/markdown-validator/src/index.ts +1 -4
  261. package/skills/market-research-report/SKILL.md +41 -0
  262. package/skills/market-research-report/package.json +10 -0
  263. package/skills/mcp-builder/package.json +4 -1
  264. package/skills/mcp-builder/src/ai-descriptions.ts +37 -0
  265. package/skills/mcp-builder/src/generators.ts +513 -0
  266. package/skills/mcp-builder/src/index.ts +7 -908
  267. package/skills/mcp-builder/src/minimist.d.ts +15 -0
  268. package/skills/mcp-builder/src/naming.ts +12 -0
  269. package/skills/mcp-builder/src/options.ts +170 -0
  270. package/skills/mcp-builder/src/templates.ts +149 -0
  271. package/skills/mcp-builder/src/types.ts +42 -0
  272. package/skills/meeting-pack/SKILL.md +43 -0
  273. package/skills/meeting-pack/package.json +10 -0
  274. package/skills/merge-pdfs/package.json +5 -1
  275. package/skills/migration-plan-pack/SKILL.md +45 -0
  276. package/skills/migration-plan-pack/package.json +10 -0
  277. package/skills/music/package.json +2 -3
  278. package/skills/music-album/SKILL.md +37 -0
  279. package/skills/music-album/package.json +10 -0
  280. package/skills/notion-manager/package.json +3 -1
  281. package/skills/npmpublish/CLAUDE.md +5 -8
  282. package/skills/npmpublish/README.md +5 -26
  283. package/skills/npmpublish/src/index.ts +9 -147
  284. package/skills/one-page-website/SKILL.md +46 -0
  285. package/skills/one-page-website/package.json +10 -0
  286. package/skills/one-page-website/tsconfig.json +8 -0
  287. package/skills/pdf-generate/src/cli.ts +162 -0
  288. package/skills/pdf-generate/src/html.ts +84 -0
  289. package/skills/pdf-generate/src/index.ts +11 -800
  290. package/skills/pdf-generate/src/markdown.ts +27 -0
  291. package/skills/pdf-generate/src/pdf-writer.ts +78 -0
  292. package/skills/pdf-generate/src/runtime.ts +34 -0
  293. package/skills/pdf-generate/src/security.ts +37 -0
  294. package/skills/pdf-generate/src/templates.ts +311 -0
  295. package/skills/pdf-generate/src/types.ts +28 -0
  296. package/skills/pdf-read/SKILL.md +10 -10
  297. package/skills/pdf-to-dataset/SKILL.md +45 -0
  298. package/skills/pdf-to-dataset/package.json +10 -0
  299. package/skills/pdf-to-markdown/SKILL.md +49 -0
  300. package/skills/pdf-to-markdown/package.json +10 -0
  301. package/skills/pdf-to-markdown/tsconfig.json +10 -0
  302. package/skills/performance-audit-report/SKILL.md +42 -0
  303. package/skills/performance-audit-report/package.json +10 -0
  304. package/skills/persona-based-adwriter/src/index.ts +19 -0
  305. package/skills/photo-album/SKILL.md +29 -0
  306. package/skills/photo-album/package.json +9 -0
  307. package/skills/photo-album/tsconfig.json +4 -0
  308. package/skills/pitch-deck/SKILL.md +43 -0
  309. package/skills/pitch-deck/package.json +9 -0
  310. package/skills/playlist-maker/SKILL.md +33 -0
  311. package/skills/playlist-maker/package.json +9 -0
  312. package/skills/playlist-maker/tsconfig.json +4 -0
  313. package/skills/product-mockup/SKILL.md +45 -0
  314. package/skills/product-mockup/package.json +3 -20
  315. package/skills/product-mockup/tsconfig.json +3 -5
  316. package/skills/project-retro-companion/src/index.ts +19 -0
  317. package/skills/proposal-pack/SKILL.md +45 -0
  318. package/skills/proposal-pack/package.json +10 -0
  319. package/skills/read-pdf/SKILL.md +5 -4
  320. package/skills/repo-onboarding-report/SKILL.md +42 -0
  321. package/skills/repo-onboarding-report/package.json +10 -0
  322. package/skills/sales-call-recapper/src/index.ts +20 -0
  323. package/skills/salescopy/package.json +1 -1
  324. package/skills/salescopy/src/index.ts +3 -0
  325. package/skills/scaffold-project/src/ai-detect.ts +136 -0
  326. package/skills/scaffold-project/src/file-generators.ts +292 -0
  327. package/skills/scaffold-project/src/index.ts +8 -991
  328. package/skills/scaffold-project/src/project-config.ts +338 -0
  329. package/skills/scaffold-project/src/templates.ts +173 -0
  330. package/skills/scaffold-project/src/types.ts +58 -0
  331. package/skills/scientific-figure-check/package.json +3 -1
  332. package/skills/sdk-generator/SKILL.md +45 -0
  333. package/skills/sdk-generator/package.json +10 -0
  334. package/skills/sdk-generator/tsconfig.json +8 -0
  335. package/skills/security-audit/src/index.ts +25 -6
  336. package/skills/security-audit-report/SKILL.md +40 -0
  337. package/skills/security-audit-report/package.json +10 -0
  338. package/skills/seo-content-pack/SKILL.md +44 -0
  339. package/skills/seo-content-pack/package.json +9 -0
  340. package/skills/short-video-pack/SKILL.md +30 -0
  341. package/skills/short-video-pack/package.json +10 -0
  342. package/skills/slack-assistant/package.json +3 -1
  343. package/skills/slide-deck-generator/SKILL.md +44 -0
  344. package/skills/slide-deck-generator/package.json +10 -0
  345. package/skills/sms/package.json +1 -1
  346. package/skills/sms/src/index.ts +15 -0
  347. package/skills/social-content-calendar/SKILL.md +45 -0
  348. package/skills/social-content-calendar/package.json +14 -0
  349. package/skills/split-pdf/package.json +4 -1
  350. package/skills/subtitle/package.json +2 -1
  351. package/skills/subtitle/src/index.ts +3 -0
  352. package/skills/terraform-generator/package.json +3 -1
  353. package/skills/test-suite-generator/SKILL.md +41 -0
  354. package/skills/test-suite-generator/package.json +10 -0
  355. package/skills/timesheet/package.json +1 -1
  356. package/skills/timesheet/src/index.ts +3 -0
  357. package/skills/transcript/SKILL.md +1 -8
  358. package/skills/validate-config/package.json +3 -1
  359. package/skills/video/package.json +6 -4
  360. package/skills/video-downloader/package.json +3 -1
  361. package/skills/video-highlight-pack/SKILL.md +44 -0
  362. package/skills/video-highlight-pack/package.json +10 -0
  363. package/skills/voiceover-jingle-pack/SKILL.md +28 -0
  364. package/skills/voiceover-jingle-pack/package.json +10 -0
  365. package/skills/watermark/package.json +6 -1
  366. package/skills/webcrawling/package.json +2 -1
  367. package/skills/write/SKILL.md +6 -6
  368. package/dist/server/serve.d.ts +0 -11
  369. package/skills/apidocs/.claude/settings.json +0 -5
  370. package/skills/audio/.env.example +0 -14
  371. package/skills/audio/QUICKSTART.md +0 -158
  372. package/skills/audio/README.md +0 -256
  373. package/skills/audio/src/index-local.ts +0 -206
  374. package/skills/audio/src/index.ts +0 -95
  375. package/skills/audio/src/providers/elevenlabs.ts +0 -115
  376. package/skills/audio/src/providers/google.ts +0 -116
  377. package/skills/audio/src/providers/minimax.ts +0 -83
  378. package/skills/audio/src/providers/openai.ts +0 -115
  379. package/skills/audio/src/types.ts +0 -79
  380. package/skills/audiobook-chapter-proofer/CLAUDE.md +0 -19
  381. package/skills/audiobook-chapter-proofer/package.json +0 -27
  382. package/skills/audiobook-chapter-proofer/src/index.ts +0 -285
  383. package/skills/browse/src/client.ts +0 -373
  384. package/skills/browse/src/index-local.ts +0 -430
  385. package/skills/browse/src/index.ts +0 -110
  386. package/skills/browse/src/sse-server.ts +0 -919
  387. package/skills/browse/src/types.ts +0 -104
  388. package/skills/consolelog/src/server/index.ts +0 -508
  389. package/skills/create-blog-article/CLAUDE.md +0 -19
  390. package/skills/create-blog-article/src/index.ts +0 -745
  391. package/skills/create-blog-article/tsconfig.json +0 -10
  392. package/skills/deepresearch/src/agents/query-generator.ts +0 -91
  393. package/skills/deepresearch/src/agents/synthesizer.ts +0 -111
  394. package/skills/deepresearch/src/index.ts +0 -224
  395. package/skills/deepresearch/src/research.ts +0 -166
  396. package/skills/deepresearch/src/services/anthropic.ts +0 -69
  397. package/skills/deepresearch/src/services/exa.ts +0 -108
  398. package/skills/deepresearch/src/services/firecrawl.ts +0 -88
  399. package/skills/deepresearch/src/services/openai.ts +0 -81
  400. package/skills/deepresearch/src/types.ts +0 -76
  401. package/skills/deepresearch/src/utils/file.ts +0 -111
  402. package/skills/deepresearch/src/utils/logger.ts +0 -84
  403. package/skills/domainpurchase/src/server/index.ts +0 -332
  404. package/skills/domainsearch/src/server/index.ts +0 -229
  405. package/skills/e2bswarm/README.md +0 -135
  406. package/skills/e2bswarm/SKILL.md +0 -118
  407. package/skills/e2bswarm/examples/tasks-example.json +0 -38
  408. package/skills/e2bswarm/package.json +0 -59
  409. package/skills/e2bswarm/src/commands/collect.ts +0 -135
  410. package/skills/e2bswarm/src/commands/install.ts +0 -164
  411. package/skills/e2bswarm/src/commands/kill.ts +0 -62
  412. package/skills/e2bswarm/src/commands/spawn.ts +0 -134
  413. package/skills/e2bswarm/src/commands/status.ts +0 -90
  414. package/skills/e2bswarm/src/commands/sync.ts +0 -208
  415. package/skills/e2bswarm/src/index.ts +0 -121
  416. package/skills/e2bswarm/src/lib/config.ts +0 -75
  417. package/skills/e2bswarm/src/lib/e2b.ts +0 -490
  418. package/skills/e2bswarm/src/lib/github.ts +0 -253
  419. package/skills/e2bswarm/src/lib/logger.ts +0 -41
  420. package/skills/e2bswarm/src/lib/paths.ts +0 -75
  421. package/skills/e2bswarm/src/lib/tasks.ts +0 -320
  422. package/skills/e2bswarm/src/types/index.ts +0 -107
  423. package/skills/e2bswarm/templates/codebox/e2b.Dockerfile +0 -38
  424. package/skills/e2bswarm/templates/codebox/e2b.toml +0 -3
  425. package/skills/e2bswarm/templates/setup.sh +0 -21
  426. package/skills/e2bswarm/tsconfig.json +0 -19
  427. package/skills/generate-book-cover/src/index.ts +0 -694
  428. package/skills/image/src/index-local.ts +0 -206
  429. package/skills/image/src/index.ts +0 -96
  430. package/skills/image/src/providers/google.ts +0 -79
  431. package/skills/image/src/providers/minimax.ts +0 -94
  432. package/skills/image/src/providers/openai.ts +0 -80
  433. package/skills/image/src/providers/xai.ts +0 -73
  434. package/skills/image/src/types.ts +0 -37
  435. package/skills/logo-design/CLAUDE.md +0 -30
  436. package/skills/logo-design/src/index.ts +0 -322
  437. package/skills/managehook/src/server/index.ts +0 -108
  438. package/skills/managemcp/src/server/index.ts +0 -108
  439. package/skills/manageskill/src/server/index.ts +0 -108
  440. package/skills/music/CLAUDE.md +0 -9
  441. package/skills/music/src/index.ts +0 -94
  442. package/skills/music/tsconfig.json +0 -10
  443. package/skills/pdf-read/src/index.ts +0 -320
  444. package/skills/product-mockup/CLAUDE.md +0 -19
  445. package/skills/product-mockup/src/index.ts +0 -290
  446. package/skills/read-pdf/src/index.ts +0 -388
  447. package/skills/remove-background/src/index.ts +0 -405
  448. package/skills/sound-effects/SKILL.md +0 -34
  449. package/skills/sound-effects/package.json +0 -21
  450. package/skills/sound-effects/src/index.ts +0 -172
  451. package/skills/sound-effects/tsconfig.json +0 -8
  452. package/skills/transcript/src/chunker.ts +0 -215
  453. package/skills/transcript/src/formatter.ts +0 -134
  454. package/skills/transcript/src/index-local.ts +0 -226
  455. package/skills/transcript/src/index.ts +0 -110
  456. package/skills/transcript/src/providers/elevenlabs.ts +0 -133
  457. package/skills/transcript/src/providers/gemini.ts +0 -192
  458. package/skills/transcript/src/providers/index.ts +0 -54
  459. package/skills/transcript/src/providers/openai.ts +0 -203
  460. package/skills/transcript/src/types.ts +0 -106
  461. package/skills/video/.env.example +0 -14
  462. package/skills/video/EXAMPLES.md +0 -266
  463. package/skills/video/LICENSE +0 -192
  464. package/skills/video/README.md +0 -174
  465. package/skills/video/src/cli.ts +0 -155
  466. package/skills/video/src/index-local.ts +0 -148
  467. package/skills/video/src/index.ts +0 -96
  468. package/skills/video/src/providers/google-veo.ts +0 -126
  469. package/skills/video/src/providers/index.ts +0 -22
  470. package/skills/video/src/providers/minimax.ts +0 -100
  471. package/skills/video/src/providers/openai-sora.ts +0 -164
  472. package/skills/video/src/providers/runway.ts +0 -159
  473. package/skills/video/src/types.ts +0 -35
  474. package/skills/video/tsconfig.json +0 -22
  475. package/skills/voiceover-casting-assistant/CLAUDE.md +0 -19
  476. package/skills/voiceover-casting-assistant/package.json +0 -27
  477. package/skills/voiceover-casting-assistant/src/index.ts +0 -255
  478. package/skills/voiceover-casting-assistant/tsconfig.json +0 -10
  479. package/skills/webcrawling/src/commands/config.ts +0 -34
  480. package/skills/webcrawling/src/commands/crawl.ts +0 -33
  481. package/skills/webcrawling/src/commands/scrape.ts +0 -32
  482. package/skills/webcrawling/src/commands/sessions.ts +0 -42
  483. package/skills/webcrawling/src/lib/crawler.ts +0 -174
  484. package/skills/webcrawling/src/lib/storage.ts +0 -130
  485. package/skills/webcrawling/src/types/index.ts +0 -45
  486. package/skills/webcrawling/src/utils/logger.ts +0 -30
  487. package/skills/webcrawling/src/utils/paths.ts +0 -28
  488. /package/skills/{audiobook-chapter-proofer → blog-article}/tsconfig.json +0 -0
@@ -5,782 +5,10 @@
5
5
  */
6
6
 
7
7
  import { parseArgs } from "util";
8
- import { mkdirSync, writeFileSync, appendFileSync, existsSync, readFileSync } from "fs";
9
- import { join, basename, extname, dirname } from "path";
10
- import { randomUUID } from "crypto";
11
- import * as yaml from "yaml";
8
+ import { join } from "path";
9
+ import { generateApiClient } from "./generator";
10
+ import { LOGS_DIR, SESSION_ID, SESSION_TIMESTAMP, log } from "./logger";
12
11
 
13
- // Types
14
- interface GenerateOptions {
15
- specPath: string;
16
- language: "typescript" | "javascript" | "python";
17
- client: "fetch" | "axios" | "ky" | "requests";
18
- output?: string;
19
- auth: "bearer" | "apikey" | "oauth2" | "basic" | "none";
20
- style: "modular" | "class" | "functional";
21
- async: boolean;
22
- sync: boolean;
23
- baseUrl?: string;
24
- name?: string;
25
- typesOnly: boolean;
26
- }
27
-
28
- interface OpenAPISpec {
29
- openapi?: string;
30
- swagger?: string;
31
- info: {
32
- title: string;
33
- version: string;
34
- description?: string;
35
- };
36
- servers?: Array<{ url: string }>;
37
- paths: Record<string, Record<string, PathItem>>;
38
- components?: {
39
- schemas?: Record<string, SchemaObject>;
40
- securitySchemes?: Record<string, SecurityScheme>;
41
- };
42
- }
43
-
44
- interface PathItem {
45
- summary?: string;
46
- description?: string;
47
- parameters?: Parameter[];
48
- requestBody?: RequestBody;
49
- responses?: Record<string, Response>;
50
- security?: Array<Record<string, string[]>>;
51
- }
52
-
53
- interface Parameter {
54
- name: string;
55
- in: "path" | "query" | "header" | "cookie";
56
- required?: boolean;
57
- schema?: SchemaObject;
58
- description?: string;
59
- }
60
-
61
- interface RequestBody {
62
- required?: boolean;
63
- content?: Record<string, { schema?: SchemaObject }>;
64
- }
65
-
66
- interface Response {
67
- description?: string;
68
- content?: Record<string, { schema?: SchemaObject }>;
69
- }
70
-
71
- interface SchemaObject {
72
- type?: string;
73
- properties?: Record<string, SchemaObject>;
74
- items?: SchemaObject;
75
- required?: string[];
76
- enum?: Array<string | number>;
77
- $ref?: string;
78
- description?: string;
79
- nullable?: boolean;
80
- format?: string;
81
- }
82
-
83
- interface SecurityScheme {
84
- type: string;
85
- scheme?: string;
86
- bearerFormat?: string;
87
- in?: string;
88
- name?: string;
89
- }
90
-
91
- // Constants
92
- const SKILL_NAME = "generate-api-client";
93
- const SESSION_ID = randomUUID().slice(0, 8);
94
-
95
- // Use SKILLS_OUTPUT_DIR from CLI if available, otherwise fall back to cwd
96
- const SKILLS_OUTPUT_DIR = process.env.SKILLS_OUTPUT_DIR || join(process.cwd(), ".skills");
97
- const EXPORTS_DIR = join(SKILLS_OUTPUT_DIR, "exports", SKILL_NAME);
98
- const LOGS_DIR = join(SKILLS_OUTPUT_DIR, "logs", SKILL_NAME);
99
-
100
- // Ensure directories exist
101
- function ensureDir(dir: string) {
102
- if (!existsSync(dir)) {
103
- mkdirSync(dir, { recursive: true });
104
- }
105
- }
106
-
107
- // Session timestamp for log filename
108
- const SESSION_TIMESTAMP = new Date().toISOString().replace(/[:.]/g, "_").replace(/-/g, "_").slice(0, 19).toLowerCase();
109
-
110
- // Logger
111
- function log(message: string, level: "info" | "error" | "success" | "warn" = "info") {
112
- const timestamp = new Date().toISOString();
113
- const logFile = join(LOGS_DIR, `log_${SESSION_TIMESTAMP}_${SESSION_ID}.log`);
114
-
115
- ensureDir(LOGS_DIR);
116
-
117
- const logEntry = `[${timestamp}] [${level.toUpperCase()}] ${message}\n`;
118
- appendFileSync(logFile, logEntry);
119
-
120
- const prefix = level === "error" ? "āŒ" : level === "success" ? "āœ…" : level === "warn" ? "āš ļø" : "ā„¹ļø";
121
- console.log(`${prefix} ${message}`);
122
- }
123
-
124
- // Load OpenAPI spec from URL or file
125
- async function loadSpec(specPath: string): Promise<OpenAPISpec> {
126
- log(`Loading OpenAPI spec from: ${specPath}`);
127
-
128
- let content: string;
129
-
130
- if (specPath.startsWith("http://") || specPath.startsWith("https://")) {
131
- log("Fetching spec from URL...");
132
- const response = await fetch(specPath);
133
- if (!response.ok) {
134
- throw new Error(`Failed to fetch spec: ${response.statusText}`);
135
- }
136
- content = await response.text();
137
- } else {
138
- log("Reading spec from local file...");
139
- if (!existsSync(specPath)) {
140
- throw new Error(`Spec file not found: ${specPath}`);
141
- }
142
- content = readFileSync(specPath, "utf-8");
143
- }
144
-
145
- const ext = extname(specPath).toLowerCase();
146
- let spec: OpenAPISpec;
147
-
148
- if (ext === ".yaml" || ext === ".yml" || content.trim().startsWith("openapi:") || content.trim().startsWith("swagger:")) {
149
- log("Parsing YAML spec...");
150
- spec = yaml.parse(content);
151
- } else {
152
- log("Parsing JSON spec...");
153
- spec = JSON.parse(content);
154
- }
155
-
156
- // Validate spec
157
- if (!spec.openapi && !spec.swagger) {
158
- throw new Error("Invalid OpenAPI/Swagger specification: missing version field");
159
- }
160
-
161
- if (!spec.info?.title) {
162
- throw new Error("Invalid OpenAPI/Swagger specification: missing info.title");
163
- }
164
-
165
- log(`Loaded spec: ${spec.info.title} v${spec.info.version}`, "success");
166
- return spec;
167
- }
168
-
169
- // Convert OpenAPI type to TypeScript type
170
- function openApiTypeToTS(schema: SchemaObject | undefined, refs: Record<string, SchemaObject> = {}): string {
171
- if (!schema) return "any";
172
-
173
- if (schema.$ref) {
174
- const refName = schema.$ref.split("/").pop() || "any";
175
- return refName;
176
- }
177
-
178
- if (schema.enum) {
179
- return schema.enum.map(v => typeof v === "string" ? `"${v}"` : v).join(" | ");
180
- }
181
-
182
- const baseType = (() => {
183
- switch (schema.type) {
184
- case "string":
185
- if (schema.format === "date-time") return "Date | string";
186
- if (schema.format === "date") return "Date | string";
187
- return "string";
188
- case "number":
189
- case "integer":
190
- return "number";
191
- case "boolean":
192
- return "boolean";
193
- case "array":
194
- return `Array<${openApiTypeToTS(schema.items, refs)}>`;
195
- case "object":
196
- if (!schema.properties) return "Record<string, any>";
197
- const props = Object.entries(schema.properties).map(([key, prop]) => {
198
- const optional = !schema.required?.includes(key) ? "?" : "";
199
- return ` ${key}${optional}: ${openApiTypeToTS(prop, refs)};`;
200
- }).join("\n");
201
- return `{\n${props}\n}`;
202
- default:
203
- return "any";
204
- }
205
- })();
206
-
207
- return schema.nullable ? `${baseType} | null` : baseType;
208
- }
209
-
210
- // Convert OpenAPI type to Python type
211
- function openApiTypeToPython(schema: SchemaObject | undefined): string {
212
- if (!schema) return "Any";
213
-
214
- if (schema.$ref) {
215
- const refName = schema.$ref.split("/").pop() || "Any";
216
- return refName;
217
- }
218
-
219
- if (schema.enum) {
220
- return "Literal[" + schema.enum.map(v => typeof v === "string" ? `"${v}"` : v).join(", ") + "]";
221
- }
222
-
223
- const baseType = (() => {
224
- switch (schema.type) {
225
- case "string":
226
- if (schema.format === "date-time") return "datetime";
227
- if (schema.format === "date") return "date";
228
- return "str";
229
- case "number":
230
- return "float";
231
- case "integer":
232
- return "int";
233
- case "boolean":
234
- return "bool";
235
- case "array":
236
- return `List[${openApiTypeToPython(schema.items)}]`;
237
- case "object":
238
- if (!schema.properties) return "Dict[str, Any]";
239
- return "dict"; // For complex objects, we'll generate Pydantic models separately
240
- default:
241
- return "Any";
242
- }
243
- })();
244
-
245
- return schema.nullable ? `Optional[${baseType}]` : baseType;
246
- }
247
-
248
- // Generate TypeScript types
249
- function generateTypeScriptTypes(spec: OpenAPISpec): string {
250
- let output = "// Generated types from OpenAPI specification\n\n";
251
-
252
- if (!spec.components?.schemas) {
253
- return output + "export type EmptyTypes = Record<string, never>;\n";
254
- }
255
-
256
- // Generate interfaces for each schema
257
- for (const [name, schema] of Object.entries(spec.components.schemas)) {
258
- if (schema.description) {
259
- output += `/**\n * ${schema.description}\n */\n`;
260
- }
261
- output += `export interface ${name} ${openApiTypeToTS(schema, spec.components.schemas)}\n\n`;
262
- }
263
-
264
- return output;
265
- }
266
-
267
- // Generate TypeScript fetch client
268
- function generateTypeScriptFetchClient(spec: OpenAPISpec, options: GenerateOptions): Record<string, string> {
269
- const files: Record<string, string> = {};
270
- const clientName = options.name || spec.info.title.replace(/[^a-zA-Z0-9]/g, "") + "Client";
271
- const baseUrl = options.baseUrl || spec.servers?.[0]?.url || "";
272
-
273
- // Generate types file
274
- files["types.ts"] = generateTypeScriptTypes(spec);
275
-
276
- // Generate config file
277
- let configContent = `// API Client Configuration\n\n`;
278
- configContent += `export interface ApiConfig {\n`;
279
- configContent += ` baseURL?: string;\n`;
280
- configContent += ` timeout?: number;\n`;
281
- configContent += ` headers?: Record<string, string>;\n`;
282
-
283
- if (options.auth !== "none") {
284
- configContent += ` auth?: {\n`;
285
- configContent += ` type: "${options.auth}";\n`;
286
- if (options.auth === "bearer") {
287
- configContent += ` token: string;\n`;
288
- } else if (options.auth === "apikey") {
289
- configContent += ` key: string;\n`;
290
- configContent += ` header?: string;\n`;
291
- }
292
- configContent += ` };\n`;
293
- }
294
-
295
- configContent += `}\n\n`;
296
- configContent += `export const defaultConfig: ApiConfig = {\n`;
297
- configContent += ` baseURL: "${baseUrl}",\n`;
298
- configContent += ` timeout: 30000,\n`;
299
- configContent += ` headers: {\n`;
300
- configContent += ` "Content-Type": "application/json",\n`;
301
- configContent += ` },\n`;
302
- configContent += `};\n`;
303
-
304
- files["config.ts"] = configContent;
305
-
306
- // Generate main client file based on style
307
- if (options.style === "class") {
308
- let clientContent = `// ${clientName}\n`;
309
- clientContent += `import type { ApiConfig } from "./config";\n`;
310
- clientContent += `import { defaultConfig } from "./config";\n\n`;
311
-
312
- clientContent += `export class ${clientName} {\n`;
313
- clientContent += ` private config: ApiConfig;\n\n`;
314
- clientContent += ` constructor(config: Partial<ApiConfig> = {}) {\n`;
315
- clientContent += ` this.config = { ...defaultConfig, ...config };\n`;
316
- clientContent += ` }\n\n`;
317
-
318
- clientContent += ` private async request<T>(path: string, options: RequestInit = {}): Promise<T> {\n`;
319
- clientContent += ` const url = \`\${this.config.baseURL}\${path}\`;\n`;
320
- clientContent += ` const headers = { ...this.config.headers, ...options.headers };\n\n`;
321
-
322
- if (options.auth === "bearer") {
323
- clientContent += ` if (this.config.auth?.type === "bearer") {\n`;
324
- clientContent += ` headers["Authorization"] = \`Bearer \${this.config.auth.token}\`;\n`;
325
- clientContent += ` }\n\n`;
326
- }
327
-
328
- clientContent += ` const response = await fetch(url, { ...options, headers });\n\n`;
329
- clientContent += ` if (!response.ok) {\n`;
330
- clientContent += ` throw new Error(\`API Error: \${response.status} \${response.statusText}\`);\n`;
331
- clientContent += ` }\n\n`;
332
- clientContent += ` return response.json();\n`;
333
- clientContent += ` }\n\n`;
334
-
335
- // Generate methods for each endpoint
336
- for (const [path, methods] of Object.entries(spec.paths)) {
337
- for (const [method, operation] of Object.entries(methods)) {
338
- if (!["get", "post", "put", "patch", "delete"].includes(method)) continue;
339
-
340
- const methodName = operation.summary?.replace(/[^a-zA-Z0-9]/g, "") ||
341
- `${method}${path.split("/").pop()?.replace(/[^a-zA-Z0-9]/g, "")}`;
342
- const lowerMethodName = methodName.charAt(0).toLowerCase() + methodName.slice(1);
343
-
344
- clientContent += ` /**\n`;
345
- clientContent += ` * ${operation.description || operation.summary || `${method.toUpperCase()} ${path}`}\n`;
346
- clientContent += ` */\n`;
347
- clientContent += ` async ${lowerMethodName}(`;
348
-
349
- // Add parameters
350
- const pathParams = operation.parameters?.filter(p => p.in === "path") || [];
351
- const queryParams = operation.parameters?.filter(p => p.in === "query") || [];
352
- const hasBody = operation.requestBody && method !== "get";
353
-
354
- if (pathParams.length > 0 || queryParams.length > 0 || hasBody) {
355
- clientContent += `params: {\n`;
356
- pathParams.forEach(p => {
357
- clientContent += ` ${p.name}${p.required ? "" : "?"}: ${openApiTypeToTS(p.schema)};\n`;
358
- });
359
- queryParams.forEach(p => {
360
- clientContent += ` ${p.name}${p.required ? "" : "?"}: ${openApiTypeToTS(p.schema)};\n`;
361
- });
362
- if (hasBody) {
363
- clientContent += ` body?: any;\n`;
364
- }
365
- clientContent += ` }`;
366
- }
367
-
368
- clientContent += `): Promise<any> {\n`;
369
-
370
- // Build URL with path params
371
- clientContent += ` let path = "${path}";\n`;
372
- pathParams.forEach(p => {
373
- clientContent += ` path = path.replace("{${p.name}}", String(params.${p.name}));\n`;
374
- });
375
-
376
- // Add query params
377
- if (queryParams.length > 0) {
378
- clientContent += ` const queryParams = new URLSearchParams();\n`;
379
- queryParams.forEach(p => {
380
- clientContent += ` if (params.${p.name} !== undefined) queryParams.append("${p.name}", String(params.${p.name}));\n`;
381
- });
382
- clientContent += ` if (queryParams.toString()) path += \`?\${queryParams.toString()}\`;\n`;
383
- }
384
-
385
- // Make request
386
- clientContent += ` return this.request(path, {\n`;
387
- clientContent += ` method: "${method.toUpperCase()}",\n`;
388
- if (hasBody) {
389
- clientContent += ` body: JSON.stringify(params.body),\n`;
390
- }
391
- clientContent += ` });\n`;
392
- clientContent += ` }\n\n`;
393
- }
394
- }
395
-
396
- clientContent += `}\n`;
397
- files["client.ts"] = clientContent;
398
-
399
- } else if (options.style === "modular") {
400
- // Generate modular exports
401
- let indexContent = `// ${clientName} - Modular API\n`;
402
- indexContent += `import type { ApiConfig } from "./config";\n`;
403
- indexContent += `import { defaultConfig } from "./config";\n\n`;
404
-
405
- indexContent += `let config: ApiConfig = defaultConfig;\n\n`;
406
- indexContent += `export function configure(newConfig: Partial<ApiConfig>) {\n`;
407
- indexContent += ` config = { ...config, ...newConfig };\n`;
408
- indexContent += `}\n\n`;
409
-
410
- indexContent += `async function request<T>(path: string, options: RequestInit = {}): Promise<T> {\n`;
411
- indexContent += ` const url = \`\${config.baseURL}\${path}\`;\n`;
412
- indexContent += ` const headers = { ...config.headers, ...options.headers };\n\n`;
413
-
414
- if (options.auth === "bearer") {
415
- indexContent += ` if (config.auth?.type === "bearer") {\n`;
416
- indexContent += ` headers["Authorization"] = \`Bearer \${config.auth.token}\`;\n`;
417
- indexContent += ` }\n\n`;
418
- }
419
-
420
- indexContent += ` const response = await fetch(url, { ...options, headers });\n\n`;
421
- indexContent += ` if (!response.ok) {\n`;
422
- indexContent += ` throw new Error(\`API Error: \${response.status} \${response.statusText}\`);\n`;
423
- indexContent += ` }\n\n`;
424
- indexContent += ` return response.json();\n`;
425
- indexContent += `}\n\n`;
426
-
427
- // Generate function exports
428
- for (const [path, methods] of Object.entries(spec.paths)) {
429
- for (const [method, operation] of Object.entries(methods)) {
430
- if (!["get", "post", "put", "patch", "delete"].includes(method)) continue;
431
-
432
- const methodName = operation.summary?.replace(/[^a-zA-Z0-9]/g, "") ||
433
- `${method}${path.split("/").pop()?.replace(/[^a-zA-Z0-9]/g, "")}`;
434
- const lowerMethodName = methodName.charAt(0).toLowerCase() + methodName.slice(1);
435
-
436
- indexContent += `/**\n * ${operation.description || operation.summary || `${method.toUpperCase()} ${path}`}\n */\n`;
437
- indexContent += `export async function ${lowerMethodName}(`;
438
-
439
- const pathParams = operation.parameters?.filter(p => p.in === "path") || [];
440
- const queryParams = operation.parameters?.filter(p => p.in === "query") || [];
441
- const hasBody = operation.requestBody && method !== "get";
442
-
443
- if (pathParams.length > 0 || queryParams.length > 0 || hasBody) {
444
- indexContent += `params: { `;
445
- pathParams.forEach(p => {
446
- indexContent += `${p.name}${p.required ? "" : "?"}: ${openApiTypeToTS(p.schema)}; `;
447
- });
448
- queryParams.forEach(p => {
449
- indexContent += `${p.name}${p.required ? "" : "?"}: ${openApiTypeToTS(p.schema)}; `;
450
- });
451
- if (hasBody) {
452
- indexContent += `body?: any; `;
453
- }
454
- indexContent += `}`;
455
- }
456
-
457
- indexContent += `): Promise<any> {\n`;
458
- indexContent += ` let path = "${path}";\n`;
459
-
460
- pathParams.forEach(p => {
461
- indexContent += ` path = path.replace("{${p.name}}", String(params.${p.name}));\n`;
462
- });
463
-
464
- if (queryParams.length > 0) {
465
- indexContent += ` const queryParams = new URLSearchParams();\n`;
466
- queryParams.forEach(p => {
467
- indexContent += ` if (params.${p.name} !== undefined) queryParams.append("${p.name}", String(params.${p.name}));\n`;
468
- });
469
- indexContent += ` if (queryParams.toString()) path += \`?\${queryParams.toString()}\`;\n`;
470
- }
471
-
472
- indexContent += ` return request(path, { method: "${method.toUpperCase()}"`;
473
- if (hasBody) {
474
- indexContent += `, body: JSON.stringify(params.body)`;
475
- }
476
- indexContent += ` });\n`;
477
- indexContent += `}\n\n`;
478
- }
479
- }
480
-
481
- files["index.ts"] = indexContent;
482
- }
483
-
484
- // Generate README
485
- let readme = `# ${spec.info.title} API Client\n\n`;
486
- readme += `${spec.info.description || "Generated API client"}\n\n`;
487
- readme += `## Installation\n\n\`\`\`bash\nnpm install\n\`\`\`\n\n`;
488
- readme += `## Usage\n\n`;
489
-
490
- if (options.style === "class") {
491
- readme += `\`\`\`typescript\nimport { ${clientName} } from "./client";\n\n`;
492
- readme += `const client = new ${clientName}({\n`;
493
- readme += ` baseURL: "${baseUrl}",\n`;
494
- if (options.auth === "bearer") {
495
- readme += ` auth: { type: "bearer", token: "your-token" },\n`;
496
- }
497
- readme += `});\n\n`;
498
- readme += `// Use the client\nconst data = await client.someMethod();\n\`\`\`\n`;
499
- } else {
500
- readme += `\`\`\`typescript\nimport { configure } from "./index";\n\n`;
501
- readme += `configure({\n`;
502
- readme += ` baseURL: "${baseUrl}",\n`;
503
- if (options.auth === "bearer") {
504
- readme += ` auth: { type: "bearer", token: "your-token" },\n`;
505
- }
506
- readme += `});\n\`\`\`\n`;
507
- }
508
-
509
- files["README.md"] = readme;
510
-
511
- return files;
512
- }
513
-
514
- // Generate Python client
515
- function generatePythonClient(spec: OpenAPISpec, options: GenerateOptions): Record<string, string> {
516
- const files: Record<string, string> = {};
517
- const clientName = options.name || spec.info.title.replace(/[^a-zA-Z0-9]/g, "");
518
- const className = clientName.charAt(0).toUpperCase() + clientName.slice(1) + "Client";
519
- const baseUrl = options.baseUrl || spec.servers?.[0]?.url || "";
520
-
521
- // Generate __init__.py
522
- files["__init__.py"] = `"""${spec.info.title} API Client"""\n\nfrom .client import ${className}\n\n__all__ = ["${className}"]\n`;
523
-
524
- // Generate models.py with Pydantic
525
- let modelsContent = `"""Pydantic models for ${spec.info.title}"""\n\n`;
526
- modelsContent += `from typing import Any, Optional, List, Dict\n`;
527
- modelsContent += `from datetime import datetime, date\n`;
528
- modelsContent += `from pydantic import BaseModel\n\n`;
529
-
530
- if (spec.components?.schemas) {
531
- for (const [name, schema] of Object.entries(spec.components.schemas)) {
532
- if (schema.description) {
533
- modelsContent += `class ${name}(BaseModel):\n`;
534
- modelsContent += ` """${schema.description}"""\n`;
535
- } else {
536
- modelsContent += `class ${name}(BaseModel):\n`;
537
- }
538
-
539
- if (schema.properties) {
540
- for (const [propName, propSchema] of Object.entries(schema.properties)) {
541
- const required = schema.required?.includes(propName);
542
- const pyType = openApiTypeToPython(propSchema);
543
- modelsContent += ` ${propName}: ${required ? pyType : `Optional[${pyType}]`}${required ? "" : " = None"}\n`;
544
- }
545
- } else {
546
- modelsContent += ` pass\n`;
547
- }
548
- modelsContent += `\n`;
549
- }
550
- }
551
-
552
- files["models.py"] = modelsContent;
553
-
554
- // Generate client.py
555
- let clientContent = `"""${spec.info.title} API Client"""\n\n`;
556
- clientContent += `from typing import Any, Optional, Dict\n`;
557
- clientContent += `import requests\n`;
558
- if (options.async) {
559
- clientContent += `import aiohttp\n`;
560
- }
561
- clientContent += `\n`;
562
-
563
- clientContent += `class ${className}:\n`;
564
- clientContent += ` """API client for ${spec.info.title}"""\n\n`;
565
- clientContent += ` def __init__(self, base_url: str = "${baseUrl}", `;
566
-
567
- if (options.auth === "bearer") {
568
- clientContent += `token: Optional[str] = None, `;
569
- } else if (options.auth === "apikey") {
570
- clientContent += `api_key: Optional[str] = None, `;
571
- }
572
-
573
- clientContent += `timeout: int = 30):\n`;
574
- clientContent += ` self.base_url = base_url\n`;
575
- clientContent += ` self.timeout = timeout\n`;
576
-
577
- if (options.auth === "bearer") {
578
- clientContent += ` self.token = token\n`;
579
- } else if (options.auth === "apikey") {
580
- clientContent += ` self.api_key = api_key\n`;
581
- }
582
-
583
- clientContent += ` self.session = requests.Session()\n`;
584
- clientContent += ` self._setup_headers()\n\n`;
585
-
586
- clientContent += ` def _setup_headers(self) -> None:\n`;
587
- clientContent += ` """Setup default headers"""\n`;
588
- clientContent += ` self.session.headers.update({"Content-Type": "application/json"})\n`;
589
-
590
- if (options.auth === "bearer") {
591
- clientContent += ` if self.token:\n`;
592
- clientContent += ` self.session.headers.update({"Authorization": f"Bearer {self.token}"})\n`;
593
- }
594
-
595
- clientContent += `\n`;
596
-
597
- // Add sync request method
598
- if (options.sync) {
599
- clientContent += ` def _request(self, method: str, path: str, **kwargs) -> Any:\n`;
600
- clientContent += ` """Make HTTP request"""\n`;
601
- clientContent += ` url = f"{self.base_url}{path}"\n`;
602
- clientContent += ` response = self.session.request(method, url, timeout=self.timeout, **kwargs)\n`;
603
- clientContent += ` response.raise_for_status()\n`;
604
- clientContent += ` return response.json()\n\n`;
605
- }
606
-
607
- // Add async request method
608
- if (options.async) {
609
- clientContent += ` async def _request_async(self, method: str, path: str, **kwargs) -> Any:\n`;
610
- clientContent += ` """Make async HTTP request"""\n`;
611
- clientContent += ` url = f"{self.base_url}{path}"\n`;
612
- clientContent += ` async with aiohttp.ClientSession() as session:\n`;
613
- clientContent += ` async with session.request(method, url, timeout=self.timeout, **kwargs) as response:\n`;
614
- clientContent += ` response.raise_for_status()\n`;
615
- clientContent += ` return await response.json()\n\n`;
616
- }
617
-
618
- // Generate methods for endpoints
619
- for (const [path, methods] of Object.entries(spec.paths)) {
620
- for (const [method, operation] of Object.entries(methods)) {
621
- if (!["get", "post", "put", "patch", "delete"].includes(method)) continue;
622
-
623
- const methodName = operation.summary?.replace(/[^a-zA-Z0-9]/g, "").toLowerCase() ||
624
- `${method}_${path.split("/").pop()?.replace(/[^a-zA-Z0-9]/g, "").toLowerCase()}`;
625
-
626
- const pathParams = operation.parameters?.filter(p => p.in === "path") || [];
627
- const queryParams = operation.parameters?.filter(p => p.in === "query") || [];
628
- const hasBody = operation.requestBody && method !== "get";
629
-
630
- // Sync version
631
- if (options.sync) {
632
- clientContent += ` def ${methodName}(self`;
633
-
634
- pathParams.forEach(p => {
635
- clientContent += `, ${p.name}: ${openApiTypeToPython(p.schema)}`;
636
- });
637
-
638
- queryParams.forEach(p => {
639
- const pyType = openApiTypeToPython(p.schema);
640
- clientContent += `, ${p.name}: ${p.required ? pyType : `Optional[${pyType}]`}${p.required ? "" : " = None"}`;
641
- });
642
-
643
- if (hasBody) {
644
- clientContent += `, data: Optional[Dict[str, Any]] = None`;
645
- }
646
-
647
- clientContent += `) -> Any:\n`;
648
- clientContent += ` """${operation.description || operation.summary || `${method.toUpperCase()} ${path}`}"""\n`;
649
- clientContent += ` path = "${path}"\n`;
650
-
651
- pathParams.forEach(p => {
652
- clientContent += ` path = path.replace("{${p.name}}", str(${p.name}))\n`;
653
- });
654
-
655
- if (queryParams.length > 0) {
656
- clientContent += ` params = {}\n`;
657
- queryParams.forEach(p => {
658
- clientContent += ` if ${p.name} is not None:\n`;
659
- clientContent += ` params["${p.name}"] = ${p.name}\n`;
660
- });
661
- clientContent += ` return self._request("${method.toUpperCase()}", path, params=params`;
662
- } else {
663
- clientContent += ` return self._request("${method.toUpperCase()}", path`;
664
- }
665
-
666
- if (hasBody) {
667
- clientContent += `, json=data`;
668
- }
669
-
670
- clientContent += `)\n\n`;
671
- }
672
-
673
- // Async version
674
- if (options.async) {
675
- clientContent += ` async def ${methodName}_async(self`;
676
-
677
- pathParams.forEach(p => {
678
- clientContent += `, ${p.name}: ${openApiTypeToPython(p.schema)}`;
679
- });
680
-
681
- queryParams.forEach(p => {
682
- const pyType = openApiTypeToPython(p.schema);
683
- clientContent += `, ${p.name}: ${p.required ? pyType : `Optional[${pyType}]`}${p.required ? "" : " = None"}`;
684
- });
685
-
686
- if (hasBody) {
687
- clientContent += `, data: Optional[Dict[str, Any]] = None`;
688
- }
689
-
690
- clientContent += `) -> Any:\n`;
691
- clientContent += ` """${operation.description || operation.summary || `${method.toUpperCase()} ${path}`} (async)"""\n`;
692
- clientContent += ` path = "${path}"\n`;
693
-
694
- pathParams.forEach(p => {
695
- clientContent += ` path = path.replace("{${p.name}}", str(${p.name}))\n`;
696
- });
697
-
698
- if (queryParams.length > 0) {
699
- clientContent += ` params = {}\n`;
700
- queryParams.forEach(p => {
701
- clientContent += ` if ${p.name} is not None:\n`;
702
- clientContent += ` params["${p.name}"] = ${p.name}\n`;
703
- });
704
- clientContent += ` return await self._request_async("${method.toUpperCase()}", path, params=params`;
705
- } else {
706
- clientContent += ` return await self._request_async("${method.toUpperCase()}", path`;
707
- }
708
-
709
- if (hasBody) {
710
- clientContent += `, json=data`;
711
- }
712
-
713
- clientContent += `)\n\n`;
714
- }
715
- }
716
- }
717
-
718
- files["client.py"] = clientContent;
719
-
720
- // Generate README
721
- let readme = `# ${spec.info.title} API Client\n\n`;
722
- readme += `${spec.info.description || "Generated Python API client"}\n\n`;
723
- readme += `## Installation\n\n\`\`\`bash\npip install requests pydantic\n\`\`\`\n\n`;
724
- if (options.async) {
725
- readme += `For async support:\n\`\`\`bash\npip install aiohttp\n\`\`\`\n\n`;
726
- }
727
- readme += `## Usage\n\n\`\`\`python\nfrom ${clientName} import ${className}\n\n`;
728
- readme += `client = ${className}(base_url="${baseUrl}"`;
729
- if (options.auth === "bearer") {
730
- readme += `, token="your-token"`;
731
- }
732
- readme += `)\n\n`;
733
- readme += `# Use the client\ndata = client.some_method()\n\`\`\`\n`;
734
-
735
- files["README.md"] = readme;
736
-
737
- return files;
738
- }
739
-
740
- // Generate API client
741
- async function generateApiClient(options: GenerateOptions): Promise<string> {
742
- log(`Generating ${options.language} API client...`);
743
-
744
- // Load spec
745
- const spec = await loadSpec(options.specPath);
746
-
747
- // Generate files based on language
748
- let files: Record<string, string>;
749
-
750
- if (options.language === "typescript" || options.language === "javascript") {
751
- if (options.typesOnly) {
752
- files = { "types.ts": generateTypeScriptTypes(spec) };
753
- } else {
754
- files = generateTypeScriptFetchClient(spec, options);
755
- }
756
- } else if (options.language === "python") {
757
- files = generatePythonClient(spec, options);
758
- } else {
759
- throw new Error(`Unsupported language: ${options.language}`);
760
- }
761
-
762
- // Determine output directory
763
- const timestamp = new Date().toISOString().replace(/[:.]/g, "_").replace(/-/g, "_").slice(0, 19).toLowerCase();
764
- const apiName = spec.info.title.replace(/[^a-zA-Z0-9]/g, "_").toLowerCase();
765
- const defaultOutput = join(EXPORTS_DIR, `export_${timestamp}_${apiName}`);
766
- const outputDir = options.output || defaultOutput;
767
-
768
- // Write files
769
- log(`Writing files to: ${outputDir}`);
770
- ensureDir(outputDir);
771
-
772
- for (const [filename, content] of Object.entries(files)) {
773
- const filePath = join(outputDir, filename);
774
- ensureDir(dirname(filePath));
775
- writeFileSync(filePath, content, "utf-8");
776
- log(`Created: ${filename}`);
777
- }
778
-
779
- log(`Generated ${Object.keys(files).length} files`, "success");
780
- return outputDir;
781
- }
782
-
783
- // Main function
784
12
  async function main() {
785
13
  const { values, positionals } = parseArgs({
786
14
  args: Bun.argv.slice(2),
@@ -800,7 +28,6 @@ async function main() {
800
28
  allowPositionals: true,
801
29
  });
802
30
 
803
- // Show help
804
31
  if (values.help || positionals.length === 0) {
805
32
  console.log(`
806
33
  Generate API Client - Generate typed API clients from OpenAPI/Swagger specs
@@ -856,7 +83,6 @@ Examples:
856
83
  console.log(`\n✨ API client generated successfully!`);
857
84
  console.log(` šŸ“ Output: ${outputDir}`);
858
85
  console.log(` šŸ“‹ Log: ${join(LOGS_DIR, `log_${SESSION_TIMESTAMP}_${SESSION_ID}.log`)}`);
859
-
860
86
  } catch (error) {
861
87
  log(`Error: ${error instanceof Error ? error.message : "Unknown error"}`, "error");
862
88
  process.exit(1);