@miranda0808/maya-codex 0.1.0

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 (270) hide show
  1. package/README.md +30 -0
  2. package/bin/maya-codex.js +36 -0
  3. package/package.json +19 -0
  4. package/payload/.agents/skills/ab-test-setup/SKILL.md +266 -0
  5. package/payload/.agents/skills/ab-test-setup/evals/evals.json +105 -0
  6. package/payload/.agents/skills/ab-test-setup/references/sample-size-guide.md +263 -0
  7. package/payload/.agents/skills/ab-test-setup/references/test-templates.md +277 -0
  8. package/payload/.agents/skills/ad-creative/SKILL.md +362 -0
  9. package/payload/.agents/skills/ad-creative/evals/evals.json +90 -0
  10. package/payload/.agents/skills/ad-creative/references/generative-tools.md +637 -0
  11. package/payload/.agents/skills/ad-creative/references/platform-specs.md +213 -0
  12. package/payload/.agents/skills/ai-seo/SKILL.md +398 -0
  13. package/payload/.agents/skills/ai-seo/evals/evals.json +90 -0
  14. package/payload/.agents/skills/ai-seo/references/content-patterns.md +285 -0
  15. package/payload/.agents/skills/ai-seo/references/platform-ranking-factors.md +152 -0
  16. package/payload/.agents/skills/analytics-tracking/SKILL.md +309 -0
  17. package/payload/.agents/skills/analytics-tracking/evals/evals.json +90 -0
  18. package/payload/.agents/skills/analytics-tracking/references/event-library.md +260 -0
  19. package/payload/.agents/skills/analytics-tracking/references/ga4-implementation.md +300 -0
  20. package/payload/.agents/skills/analytics-tracking/references/gtm-implementation.md +390 -0
  21. package/payload/.agents/skills/churn-prevention/SKILL.md +424 -0
  22. package/payload/.agents/skills/churn-prevention/evals/evals.json +93 -0
  23. package/payload/.agents/skills/churn-prevention/references/cancel-flow-patterns.md +316 -0
  24. package/payload/.agents/skills/churn-prevention/references/dunning-playbook.md +408 -0
  25. package/payload/.agents/skills/cold-email/SKILL.md +158 -0
  26. package/payload/.agents/skills/cold-email/evals/evals.json +94 -0
  27. package/payload/.agents/skills/cold-email/references/benchmarks.md +83 -0
  28. package/payload/.agents/skills/cold-email/references/follow-up-sequences.md +81 -0
  29. package/payload/.agents/skills/cold-email/references/frameworks.md +90 -0
  30. package/payload/.agents/skills/cold-email/references/personalization.md +79 -0
  31. package/payload/.agents/skills/cold-email/references/subject-lines.md +53 -0
  32. package/payload/.agents/skills/competitor-alternatives/SKILL.md +256 -0
  33. package/payload/.agents/skills/competitor-alternatives/evals/evals.json +93 -0
  34. package/payload/.agents/skills/competitor-alternatives/references/content-architecture.md +271 -0
  35. package/payload/.agents/skills/competitor-alternatives/references/templates.md +223 -0
  36. package/payload/.agents/skills/content-strategy/SKILL.md +359 -0
  37. package/payload/.agents/skills/content-strategy/evals/evals.json +90 -0
  38. package/payload/.agents/skills/copy-editing/SKILL.md +447 -0
  39. package/payload/.agents/skills/copy-editing/evals/evals.json +89 -0
  40. package/payload/.agents/skills/copy-editing/references/plain-english-alternatives.md +394 -0
  41. package/payload/.agents/skills/copywriting/SKILL.md +252 -0
  42. package/payload/.agents/skills/copywriting/evals/evals.json +111 -0
  43. package/payload/.agents/skills/copywriting/references/copy-frameworks.md +344 -0
  44. package/payload/.agents/skills/copywriting/references/natural-transitions.md +272 -0
  45. package/payload/.agents/skills/email-sequence/SKILL.md +309 -0
  46. package/payload/.agents/skills/email-sequence/evals/evals.json +93 -0
  47. package/payload/.agents/skills/email-sequence/references/copy-guidelines.md +113 -0
  48. package/payload/.agents/skills/email-sequence/references/email-types.md +515 -0
  49. package/payload/.agents/skills/email-sequence/references/sequence-templates.md +168 -0
  50. package/payload/.agents/skills/form-cro/SKILL.md +429 -0
  51. package/payload/.agents/skills/form-cro/evals/evals.json +90 -0
  52. package/payload/.agents/skills/free-tool-strategy/SKILL.md +178 -0
  53. package/payload/.agents/skills/free-tool-strategy/evals/evals.json +90 -0
  54. package/payload/.agents/skills/free-tool-strategy/references/tool-types.md +217 -0
  55. package/payload/.agents/skills/launch-strategy/SKILL.md +353 -0
  56. package/payload/.agents/skills/launch-strategy/evals/evals.json +91 -0
  57. package/payload/.agents/skills/marketing-ideas/SKILL.md +167 -0
  58. package/payload/.agents/skills/marketing-ideas/evals/evals.json +90 -0
  59. package/payload/.agents/skills/marketing-ideas/references/ideas-by-category.md +366 -0
  60. package/payload/.agents/skills/marketing-psychology/SKILL.md +455 -0
  61. package/payload/.agents/skills/marketing-psychology/evals/evals.json +88 -0
  62. package/payload/.agents/skills/onboarding-cro/SKILL.md +220 -0
  63. package/payload/.agents/skills/onboarding-cro/evals/evals.json +92 -0
  64. package/payload/.agents/skills/onboarding-cro/references/experiments.md +258 -0
  65. package/payload/.agents/skills/page-cro/SKILL.md +182 -0
  66. package/payload/.agents/skills/page-cro/evals/evals.json +111 -0
  67. package/payload/.agents/skills/page-cro/references/experiments.md +248 -0
  68. package/payload/.agents/skills/paid-ads/SKILL.md +315 -0
  69. package/payload/.agents/skills/paid-ads/evals/evals.json +90 -0
  70. package/payload/.agents/skills/paid-ads/references/ad-copy-templates.md +207 -0
  71. package/payload/.agents/skills/paid-ads/references/audience-targeting.md +243 -0
  72. package/payload/.agents/skills/paid-ads/references/platform-setup-checklists.md +277 -0
  73. package/payload/.agents/skills/paywall-upgrade-cro/SKILL.md +227 -0
  74. package/payload/.agents/skills/paywall-upgrade-cro/evals/evals.json +93 -0
  75. package/payload/.agents/skills/paywall-upgrade-cro/references/experiments.md +164 -0
  76. package/payload/.agents/skills/popup-cro/SKILL.md +453 -0
  77. package/payload/.agents/skills/popup-cro/evals/evals.json +94 -0
  78. package/payload/.agents/skills/pricing-strategy/SKILL.md +231 -0
  79. package/payload/.agents/skills/pricing-strategy/evals/evals.json +90 -0
  80. package/payload/.agents/skills/pricing-strategy/references/research-methods.md +152 -0
  81. package/payload/.agents/skills/pricing-strategy/references/tier-structure.md +232 -0
  82. package/payload/.agents/skills/product-marketing-context/SKILL.md +27 -0
  83. package/payload/.agents/skills/product-marketing-context/evals/evals.json +40 -0
  84. package/payload/.agents/skills/programmatic-seo/SKILL.md +238 -0
  85. package/payload/.agents/skills/programmatic-seo/evals/evals.json +94 -0
  86. package/payload/.agents/skills/programmatic-seo/references/playbooks.md +308 -0
  87. package/payload/.agents/skills/referral-program/SKILL.md +255 -0
  88. package/payload/.agents/skills/referral-program/evals/evals.json +89 -0
  89. package/payload/.agents/skills/referral-program/references/affiliate-programs.md +164 -0
  90. package/payload/.agents/skills/referral-program/references/program-examples.md +143 -0
  91. package/payload/.agents/skills/revops/SKILL.md +343 -0
  92. package/payload/.agents/skills/revops/evals/evals.json +91 -0
  93. package/payload/.agents/skills/revops/references/automation-playbooks.md +290 -0
  94. package/payload/.agents/skills/revops/references/lifecycle-definitions.md +278 -0
  95. package/payload/.agents/skills/revops/references/routing-rules.md +203 -0
  96. package/payload/.agents/skills/revops/references/scoring-models.md +247 -0
  97. package/payload/.agents/skills/sales-enablement/SKILL.md +349 -0
  98. package/payload/.agents/skills/sales-enablement/evals/evals.json +91 -0
  99. package/payload/.agents/skills/sales-enablement/references/deck-frameworks.md +263 -0
  100. package/payload/.agents/skills/sales-enablement/references/demo-scripts.md +355 -0
  101. package/payload/.agents/skills/sales-enablement/references/objection-library.md +270 -0
  102. package/payload/.agents/skills/sales-enablement/references/one-pager-templates.md +208 -0
  103. package/payload/.agents/skills/schema-markup/SKILL.md +179 -0
  104. package/payload/.agents/skills/schema-markup/evals/evals.json +87 -0
  105. package/payload/.agents/skills/schema-markup/references/schema-examples.md +398 -0
  106. package/payload/.agents/skills/seo-audit/SKILL.md +412 -0
  107. package/payload/.agents/skills/seo-audit/evals/evals.json +136 -0
  108. package/payload/.agents/skills/seo-audit/references/ai-writing-detection.md +200 -0
  109. package/payload/.agents/skills/signup-flow-cro/SKILL.md +359 -0
  110. package/payload/.agents/skills/signup-flow-cro/evals/evals.json +88 -0
  111. package/payload/.agents/skills/site-architecture/SKILL.md +357 -0
  112. package/payload/.agents/skills/site-architecture/evals/evals.json +88 -0
  113. package/payload/.agents/skills/site-architecture/references/mermaid-templates.md +216 -0
  114. package/payload/.agents/skills/site-architecture/references/navigation-patterns.md +305 -0
  115. package/payload/.agents/skills/site-architecture/references/site-type-templates.md +293 -0
  116. package/payload/.agents/skills/social-content/SKILL.md +278 -0
  117. package/payload/.agents/skills/social-content/evals/evals.json +92 -0
  118. package/payload/.agents/skills/social-content/references/platforms.md +170 -0
  119. package/payload/.agents/skills/social-content/references/post-templates.md +177 -0
  120. package/payload/.agents/skills/social-content/references/reverse-engineering.md +195 -0
  121. package/payload/.maya/executor.md +79 -0
  122. package/payload/.maya/meta-api-agent.md +48 -0
  123. package/payload/.maya/modes/consult.md +63 -0
  124. package/payload/.maya/modes/task.md +97 -0
  125. package/payload/.maya/planner.md +69 -0
  126. package/payload/.maya/researcher.md +51 -0
  127. package/payload/.maya/templates/plan.md +77 -0
  128. package/payload/.maya/templates/state.md +87 -0
  129. package/payload/.maya/templates/task-packet.md +75 -0
  130. package/payload/MAYA-CATALOG.md +115 -0
  131. package/payload/MAYA-DEPENDENCIES.md +58 -0
  132. package/payload/MAYA.md +151 -0
  133. package/payload/campaigns/README.md +14 -0
  134. package/payload/commands/maya-consult.md +28 -0
  135. package/payload/commands/maya-task.md +38 -0
  136. package/payload/commands/product.md +55 -0
  137. package/payload/research/README.md +14 -0
  138. package/payload/templates/README.md +15 -0
  139. package/payload/templates/plan.md +77 -0
  140. package/payload/templates/state.md +87 -0
  141. package/payload/templates/task-packet.md +75 -0
  142. package/payload/tools/REGISTRY.md +368 -0
  143. package/payload/tools/clis/README.md +187 -0
  144. package/payload/tools/clis/activecampaign.js +435 -0
  145. package/payload/tools/clis/adobe-analytics.js +161 -0
  146. package/payload/tools/clis/ahrefs.js +192 -0
  147. package/payload/tools/clis/amplitude.js +182 -0
  148. package/payload/tools/clis/apollo.js +142 -0
  149. package/payload/tools/clis/beehiiv.js +245 -0
  150. package/payload/tools/clis/brevo.js +368 -0
  151. package/payload/tools/clis/buffer.js +260 -0
  152. package/payload/tools/clis/calendly.js +253 -0
  153. package/payload/tools/clis/clearbit.js +163 -0
  154. package/payload/tools/clis/customer-io.js +205 -0
  155. package/payload/tools/clis/dataforseo.js +257 -0
  156. package/payload/tools/clis/demio.js +149 -0
  157. package/payload/tools/clis/dub.js +158 -0
  158. package/payload/tools/clis/g2.js +186 -0
  159. package/payload/tools/clis/ga4.js +194 -0
  160. package/payload/tools/clis/google-ads.js +189 -0
  161. package/payload/tools/clis/google-search-console.js +166 -0
  162. package/payload/tools/clis/hotjar.js +167 -0
  163. package/payload/tools/clis/hunter.js +249 -0
  164. package/payload/tools/clis/instantly.js +270 -0
  165. package/payload/tools/clis/intercom.js +399 -0
  166. package/payload/tools/clis/keywords-everywhere.js +185 -0
  167. package/payload/tools/clis/kit.js +232 -0
  168. package/payload/tools/clis/klaviyo.js +348 -0
  169. package/payload/tools/clis/lemlist.js +221 -0
  170. package/payload/tools/clis/linkedin-ads.js +185 -0
  171. package/payload/tools/clis/livestorm.js +292 -0
  172. package/payload/tools/clis/mailchimp.js +220 -0
  173. package/payload/tools/clis/mention-me.js +161 -0
  174. package/payload/tools/clis/meta-ads.js +181 -0
  175. package/payload/tools/clis/mixpanel.js +248 -0
  176. package/payload/tools/clis/onesignal.js +241 -0
  177. package/payload/tools/clis/optimizely.js +233 -0
  178. package/payload/tools/clis/paddle.js +385 -0
  179. package/payload/tools/clis/partnerstack.js +382 -0
  180. package/payload/tools/clis/plausible.js +249 -0
  181. package/payload/tools/clis/postmark.js +375 -0
  182. package/payload/tools/clis/resend.js +370 -0
  183. package/payload/tools/clis/rewardful.js +160 -0
  184. package/payload/tools/clis/savvycal.js +223 -0
  185. package/payload/tools/clis/segment.js +192 -0
  186. package/payload/tools/clis/semrush.js +207 -0
  187. package/payload/tools/clis/sendgrid.js +211 -0
  188. package/payload/tools/clis/snov.js +237 -0
  189. package/payload/tools/clis/tiktok-ads.js +190 -0
  190. package/payload/tools/clis/tolt.js +153 -0
  191. package/payload/tools/clis/trustpilot.js +276 -0
  192. package/payload/tools/clis/typeform.js +269 -0
  193. package/payload/tools/clis/wistia.js +256 -0
  194. package/payload/tools/clis/zapier.js +160 -0
  195. package/payload/tools/integrations/activecampaign.md +337 -0
  196. package/payload/tools/integrations/adobe-analytics.md +156 -0
  197. package/payload/tools/integrations/ahrefs.md +142 -0
  198. package/payload/tools/integrations/amplitude.md +135 -0
  199. package/payload/tools/integrations/apollo.md +148 -0
  200. package/payload/tools/integrations/beehiiv.md +157 -0
  201. package/payload/tools/integrations/brevo.md +268 -0
  202. package/payload/tools/integrations/buffer.md +138 -0
  203. package/payload/tools/integrations/calendly.md +161 -0
  204. package/payload/tools/integrations/clearbit.md +142 -0
  205. package/payload/tools/integrations/customer-io.md +187 -0
  206. package/payload/tools/integrations/dataforseo.md +165 -0
  207. package/payload/tools/integrations/demio.md +182 -0
  208. package/payload/tools/integrations/dub-co.md +160 -0
  209. package/payload/tools/integrations/g2.md +179 -0
  210. package/payload/tools/integrations/ga4.md +126 -0
  211. package/payload/tools/integrations/google-ads.md +159 -0
  212. package/payload/tools/integrations/google-search-console.md +147 -0
  213. package/payload/tools/integrations/hotjar.md +147 -0
  214. package/payload/tools/integrations/hubspot.md +178 -0
  215. package/payload/tools/integrations/hunter.md +90 -0
  216. package/payload/tools/integrations/instantly.md +104 -0
  217. package/payload/tools/integrations/intercom.md +292 -0
  218. package/payload/tools/integrations/keywords-everywhere.md +207 -0
  219. package/payload/tools/integrations/kit.md +167 -0
  220. package/payload/tools/integrations/klaviyo.md +228 -0
  221. package/payload/tools/integrations/lemlist.md +110 -0
  222. package/payload/tools/integrations/linkedin-ads.md +164 -0
  223. package/payload/tools/integrations/livestorm.md +313 -0
  224. package/payload/tools/integrations/mailchimp.md +150 -0
  225. package/payload/tools/integrations/mention-me.md +160 -0
  226. package/payload/tools/integrations/meta-ads.md +147 -0
  227. package/payload/tools/integrations/mixpanel.md +137 -0
  228. package/payload/tools/integrations/onesignal.md +229 -0
  229. package/payload/tools/integrations/optimizely.md +171 -0
  230. package/payload/tools/integrations/paddle.md +212 -0
  231. package/payload/tools/integrations/partnerstack.md +222 -0
  232. package/payload/tools/integrations/plausible.md +177 -0
  233. package/payload/tools/integrations/posthog.md +151 -0
  234. package/payload/tools/integrations/postmark.md +234 -0
  235. package/payload/tools/integrations/resend.md +168 -0
  236. package/payload/tools/integrations/rewardful.md +147 -0
  237. package/payload/tools/integrations/salesforce.md +150 -0
  238. package/payload/tools/integrations/savvycal.md +181 -0
  239. package/payload/tools/integrations/segment.md +159 -0
  240. package/payload/tools/integrations/semrush.md +121 -0
  241. package/payload/tools/integrations/sendgrid.md +161 -0
  242. package/payload/tools/integrations/shopify.md +176 -0
  243. package/payload/tools/integrations/snov.md +94 -0
  244. package/payload/tools/integrations/stripe.md +148 -0
  245. package/payload/tools/integrations/tiktok-ads.md +161 -0
  246. package/payload/tools/integrations/tolt.md +144 -0
  247. package/payload/tools/integrations/trustpilot.md +191 -0
  248. package/payload/tools/integrations/typeform.md +190 -0
  249. package/payload/tools/integrations/webflow.md +198 -0
  250. package/payload/tools/integrations/wistia.md +164 -0
  251. package/payload/tools/integrations/wordpress.md +175 -0
  252. package/payload/tools/integrations/zapier.md +150 -0
  253. package/payload/tools/meta/README.md +55 -0
  254. package/payload/tools/meta/meta-cache-schema.md +65 -0
  255. package/payload/tools/meta/meta-fetch.ps1 +324 -0
  256. package/payload/tools/meta/meta-fetch.test.ps1 +38 -0
  257. package/vendor/shared-installer/manifests/claude-files.json +13 -0
  258. package/vendor/shared-installer/manifests/codex-files.json +13 -0
  259. package/vendor/shared-installer/manifests/common-files.json +13 -0
  260. package/vendor/shared-installer/package.json +15 -0
  261. package/vendor/shared-installer/src/bootstrap.js +12 -0
  262. package/vendor/shared-installer/src/cli-options.js +53 -0
  263. package/vendor/shared-installer/src/fs.js +105 -0
  264. package/vendor/shared-installer/src/index.js +44 -0
  265. package/vendor/shared-installer/src/install.js +157 -0
  266. package/vendor/shared-installer/src/manifest.js +52 -0
  267. package/vendor/shared-installer/templates/claude/.claude/skills/.gitkeep +1 -0
  268. package/vendor/shared-installer/templates/claude/CLAUDE.md +27 -0
  269. package/vendor/shared-installer/templates/codex/.agent/skills/.gitkeep +1 -0
  270. package/vendor/shared-installer/templates/codex/AGENTS.md +27 -0
@@ -0,0 +1,233 @@
1
+ #!/usr/bin/env node
2
+
3
+ const API_KEY = process.env.OPTIMIZELY_API_KEY
4
+ const BASE_URL = 'https://api.optimizely.com/v2'
5
+
6
+ if (!API_KEY) {
7
+ console.error(JSON.stringify({ error: 'OPTIMIZELY_API_KEY environment variable required' }))
8
+ process.exit(1)
9
+ }
10
+
11
+ async function api(method, path, body) {
12
+ if (args['dry-run']) {
13
+ return { _dry_run: true, method, url: `${BASE_URL}${path}`, headers: { Authorization: '***', 'Content-Type': 'application/json', 'Accept': 'application/json' }, body: body || undefined }
14
+ }
15
+ const res = await fetch(`${BASE_URL}${path}`, {
16
+ method,
17
+ headers: {
18
+ 'Authorization': `Bearer ${API_KEY}`,
19
+ 'Content-Type': 'application/json',
20
+ 'Accept': 'application/json',
21
+ },
22
+ body: body ? JSON.stringify(body) : undefined,
23
+ })
24
+ const text = await res.text()
25
+ try {
26
+ return JSON.parse(text)
27
+ } catch {
28
+ return { status: res.status, body: text }
29
+ }
30
+ }
31
+
32
+ function parseArgs(args) {
33
+ const result = { _: [] }
34
+ for (let i = 0; i < args.length; i++) {
35
+ const arg = args[i]
36
+ if (arg.startsWith('--')) {
37
+ const key = arg.slice(2)
38
+ const next = args[i + 1]
39
+ if (next && !next.startsWith('--')) {
40
+ result[key] = next
41
+ i++
42
+ } else {
43
+ result[key] = true
44
+ }
45
+ } else {
46
+ result._.push(arg)
47
+ }
48
+ }
49
+ return result
50
+ }
51
+
52
+ const args = parseArgs(process.argv.slice(2))
53
+ const [cmd, sub, ...rest] = args._
54
+
55
+ async function main() {
56
+ let result
57
+ const projectId = args['project-id']
58
+ const page = args.page ? Number(args.page) : 1
59
+ const perPage = args['per-page'] ? Number(args['per-page']) : 25
60
+
61
+ switch (cmd) {
62
+ case 'projects':
63
+ switch (sub) {
64
+ case 'list':
65
+ result = await api('GET', `/projects?page=${page}&per_page=${perPage}`)
66
+ break
67
+ case 'get': {
68
+ const id = args.id
69
+ if (!id) { result = { error: '--id required' }; break }
70
+ result = await api('GET', `/projects/${id}`)
71
+ break
72
+ }
73
+ case 'create': {
74
+ const name = args.name
75
+ if (!name) { result = { error: '--name required' }; break }
76
+ const body = { name }
77
+ if (args.platform) body.platform = args.platform
78
+ result = await api('POST', '/projects', body)
79
+ break
80
+ }
81
+ default:
82
+ result = { error: 'Unknown projects subcommand. Use: list, get, create' }
83
+ }
84
+ break
85
+
86
+ case 'experiments':
87
+ switch (sub) {
88
+ case 'list': {
89
+ if (!projectId) { result = { error: '--project-id required' }; break }
90
+ const params = new URLSearchParams({ project_id: projectId, page: String(page), per_page: String(perPage) })
91
+ if (args.status) params.set('status', args.status)
92
+ result = await api('GET', `/experiments?${params.toString()}`)
93
+ break
94
+ }
95
+ case 'get': {
96
+ const id = args.id
97
+ if (!id) { result = { error: '--id required' }; break }
98
+ result = await api('GET', `/experiments/${id}`)
99
+ break
100
+ }
101
+ case 'create': {
102
+ if (!projectId) { result = { error: '--project-id required' }; break }
103
+ const name = args.name
104
+ if (!name) { result = { error: '--name required' }; break }
105
+ const body = {
106
+ project_id: Number(projectId),
107
+ name,
108
+ type: args.type || 'a/b',
109
+ status: 'not_started',
110
+ }
111
+ if (args['traffic-allocation']) body.traffic_allocation = Number(args['traffic-allocation'])
112
+ result = await api('POST', '/experiments', body)
113
+ break
114
+ }
115
+ case 'update': {
116
+ const id = args.id
117
+ if (!id) { result = { error: '--id required' }; break }
118
+ const body = {}
119
+ if (args.name) body.name = args.name
120
+ if (args.status) body.status = args.status
121
+ if (args['traffic-allocation']) body.traffic_allocation = Number(args['traffic-allocation'])
122
+ result = await api('PATCH', `/experiments/${id}`, body)
123
+ break
124
+ }
125
+ case 'results': {
126
+ const id = args.id
127
+ if (!id) { result = { error: '--id required' }; break }
128
+ const params = new URLSearchParams()
129
+ if (args['start-time']) params.set('start_time', args['start-time'])
130
+ if (args['end-time']) params.set('end_time', args['end-time'])
131
+ const qs = params.toString()
132
+ result = await api('GET', `/experiments/${id}/results${qs ? '?' + qs : ''}`)
133
+ break
134
+ }
135
+ case 'archive': {
136
+ const id = args.id
137
+ if (!id) { result = { error: '--id required' }; break }
138
+ result = await api('PATCH', `/experiments/${id}`, { status: 'archived' })
139
+ break
140
+ }
141
+ default:
142
+ result = { error: 'Unknown experiments subcommand. Use: list, get, create, update, results, archive' }
143
+ }
144
+ break
145
+
146
+ case 'campaigns':
147
+ switch (sub) {
148
+ case 'list': {
149
+ if (!projectId) { result = { error: '--project-id required' }; break }
150
+ result = await api('GET', `/campaigns?project_id=${projectId}&page=${page}&per_page=${perPage}`)
151
+ break
152
+ }
153
+ case 'get': {
154
+ const id = args.id
155
+ if (!id) { result = { error: '--id required' }; break }
156
+ result = await api('GET', `/campaigns/${id}`)
157
+ break
158
+ }
159
+ case 'results': {
160
+ const id = args.id
161
+ if (!id) { result = { error: '--id required' }; break }
162
+ result = await api('GET', `/campaigns/${id}/results`)
163
+ break
164
+ }
165
+ default:
166
+ result = { error: 'Unknown campaigns subcommand. Use: list, get, results' }
167
+ }
168
+ break
169
+
170
+ case 'audiences':
171
+ switch (sub) {
172
+ case 'list': {
173
+ if (!projectId) { result = { error: '--project-id required' }; break }
174
+ result = await api('GET', `/audiences?project_id=${projectId}&page=${page}&per_page=${perPage}`)
175
+ break
176
+ }
177
+ case 'get': {
178
+ const id = args.id
179
+ if (!id) { result = { error: '--id required' }; break }
180
+ result = await api('GET', `/audiences/${id}`)
181
+ break
182
+ }
183
+ default:
184
+ result = { error: 'Unknown audiences subcommand. Use: list, get' }
185
+ }
186
+ break
187
+
188
+ case 'events':
189
+ switch (sub) {
190
+ case 'list': {
191
+ if (!projectId) { result = { error: '--project-id required' }; break }
192
+ result = await api('GET', `/events?project_id=${projectId}&page=${page}&per_page=${perPage}`)
193
+ break
194
+ }
195
+ default:
196
+ result = { error: 'Unknown events subcommand. Use: list' }
197
+ }
198
+ break
199
+
200
+ case 'pages':
201
+ switch (sub) {
202
+ case 'list': {
203
+ if (!projectId) { result = { error: '--project-id required' }; break }
204
+ result = await api('GET', `/pages?project_id=${projectId}&page=${page}&per_page=${perPage}`)
205
+ break
206
+ }
207
+ default:
208
+ result = { error: 'Unknown pages subcommand. Use: list' }
209
+ }
210
+ break
211
+
212
+ default:
213
+ result = {
214
+ error: 'Unknown command',
215
+ usage: {
216
+ projects: 'projects [list | get --id <id> | create --name <name>]',
217
+ experiments: 'experiments [list --project-id <id> | get --id <id> | create --project-id <id> --name <name> | update --id <id> --status <status> | results --id <id> | archive --id <id>]',
218
+ campaigns: 'campaigns [list --project-id <id> | get --id <id> | results --id <id>]',
219
+ audiences: 'audiences [list --project-id <id> | get --id <id>]',
220
+ events: 'events list --project-id <id>',
221
+ pages: 'pages list --project-id <id>',
222
+ options: '--page <n> --per-page <n> --status <not_started|running|paused|archived>',
223
+ }
224
+ }
225
+ }
226
+
227
+ console.log(JSON.stringify(result, null, 2))
228
+ }
229
+
230
+ main().catch(err => {
231
+ console.error(JSON.stringify({ error: err.message }))
232
+ process.exit(1)
233
+ })
@@ -0,0 +1,385 @@
1
+ #!/usr/bin/env node
2
+
3
+ const API_KEY = process.env.PADDLE_API_KEY
4
+ const BASE_URL = process.env.PADDLE_SANDBOX === 'true'
5
+ ? 'https://sandbox-api.paddle.com'
6
+ : 'https://api.paddle.com'
7
+
8
+ if (!API_KEY) {
9
+ console.error(JSON.stringify({ error: 'PADDLE_API_KEY environment variable required' }))
10
+ process.exit(1)
11
+ }
12
+
13
+ async function api(method, path, body) {
14
+ if (args['dry-run']) {
15
+ return { _dry_run: true, method, url: `${BASE_URL}${path}`, headers: { Authorization: '***', 'Content-Type': 'application/json', 'Accept': 'application/json' }, body: body || undefined }
16
+ }
17
+ const res = await fetch(`${BASE_URL}${path}`, {
18
+ method,
19
+ headers: {
20
+ 'Authorization': `Bearer ${API_KEY}`,
21
+ 'Content-Type': 'application/json',
22
+ 'Accept': 'application/json',
23
+ },
24
+ body: body ? JSON.stringify(body) : undefined,
25
+ })
26
+ const text = await res.text()
27
+ try {
28
+ return JSON.parse(text)
29
+ } catch {
30
+ return { status: res.status, body: text }
31
+ }
32
+ }
33
+
34
+ function parseArgs(args) {
35
+ const result = { _: [] }
36
+ for (let i = 0; i < args.length; i++) {
37
+ const arg = args[i]
38
+ if (arg.startsWith('--')) {
39
+ const key = arg.slice(2)
40
+ const next = args[i + 1]
41
+ if (next && !next.startsWith('--')) {
42
+ result[key] = next
43
+ i++
44
+ } else {
45
+ result[key] = true
46
+ }
47
+ } else {
48
+ result._.push(arg)
49
+ }
50
+ }
51
+ return result
52
+ }
53
+
54
+ const args = parseArgs(process.argv.slice(2))
55
+ const [cmd, sub, ...rest] = args._
56
+
57
+ function buildQuery() {
58
+ const params = new URLSearchParams()
59
+ if (args.status) params.set('status', args.status)
60
+ if (args.after) params.set('after', args.after)
61
+ if (args['per-page']) params.set('per_page', args['per-page'])
62
+ if (args['order-by']) params.set('order_by', args['order-by'])
63
+ return params.toString() ? `?${params.toString()}` : ''
64
+ }
65
+
66
+ async function main() {
67
+ let result
68
+
69
+ switch (cmd) {
70
+ case 'products':
71
+ switch (sub) {
72
+ case 'list':
73
+ result = await api('GET', `/products${buildQuery()}`)
74
+ break
75
+ case 'get': {
76
+ const id = args.id
77
+ if (!id) { result = { error: '--id required' }; break }
78
+ result = await api('GET', `/products/${id}`)
79
+ break
80
+ }
81
+ case 'create': {
82
+ const name = args.name
83
+ const taxCategory = args['tax-category']
84
+ if (!name) { result = { error: '--name required' }; break }
85
+ if (!taxCategory) { result = { error: '--tax-category required (e.g. standard, digital-goods, saas)' }; break }
86
+ const body = { name, tax_category: taxCategory }
87
+ if (args.description) body.description = args.description
88
+ if (args['image-url']) body.image_url = args['image-url']
89
+ result = await api('POST', '/products', body)
90
+ break
91
+ }
92
+ case 'update': {
93
+ const id = args.id
94
+ if (!id) { result = { error: '--id required' }; break }
95
+ const body = {}
96
+ if (args.name) body.name = args.name
97
+ if (args.description) body.description = args.description
98
+ if (args.status) body.status = args.status
99
+ if (args['tax-category']) body.tax_category = args['tax-category']
100
+ result = await api('PATCH', `/products/${id}`, body)
101
+ break
102
+ }
103
+ default:
104
+ result = { error: 'Unknown products subcommand. Use: list, get, create, update' }
105
+ }
106
+ break
107
+
108
+ case 'prices':
109
+ switch (sub) {
110
+ case 'list':
111
+ result = await api('GET', `/prices${buildQuery()}`)
112
+ break
113
+ case 'get': {
114
+ const id = args.id
115
+ if (!id) { result = { error: '--id required' }; break }
116
+ result = await api('GET', `/prices/${id}`)
117
+ break
118
+ }
119
+ case 'create': {
120
+ const productId = args['product-id']
121
+ const amount = args.amount
122
+ const currency = args.currency || 'USD'
123
+ if (!productId) { result = { error: '--product-id required' }; break }
124
+ if (!amount) { result = { error: '--amount required (in lowest denomination, e.g. cents)' }; break }
125
+ const body = {
126
+ product_id: productId,
127
+ description: args.description || 'Price',
128
+ unit_price: { amount, currency_code: currency },
129
+ }
130
+ if (args.interval && args.frequency) {
131
+ body.billing_cycle = {
132
+ interval: args.interval,
133
+ frequency: Number(args.frequency),
134
+ }
135
+ }
136
+ result = await api('POST', '/prices', body)
137
+ break
138
+ }
139
+ case 'update': {
140
+ const id = args.id
141
+ if (!id) { result = { error: '--id required' }; break }
142
+ const body = {}
143
+ if (args.description) body.description = args.description
144
+ if (args.amount && args.currency) {
145
+ body.unit_price = { amount: args.amount, currency_code: args.currency }
146
+ }
147
+ if (args.status) body.status = args.status
148
+ result = await api('PATCH', `/prices/${id}`, body)
149
+ break
150
+ }
151
+ default:
152
+ result = { error: 'Unknown prices subcommand. Use: list, get, create, update' }
153
+ }
154
+ break
155
+
156
+ case 'customers':
157
+ switch (sub) {
158
+ case 'list':
159
+ result = await api('GET', `/customers${buildQuery()}`)
160
+ break
161
+ case 'get': {
162
+ const id = args.id
163
+ if (!id) { result = { error: '--id required' }; break }
164
+ result = await api('GET', `/customers/${id}`)
165
+ break
166
+ }
167
+ case 'create': {
168
+ const email = args.email
169
+ if (!email) { result = { error: '--email required' }; break }
170
+ const body = { email }
171
+ if (args.name) body.name = args.name
172
+ result = await api('POST', '/customers', body)
173
+ break
174
+ }
175
+ case 'update': {
176
+ const id = args.id
177
+ if (!id) { result = { error: '--id required' }; break }
178
+ const body = {}
179
+ if (args.name) body.name = args.name
180
+ if (args.email) body.email = args.email
181
+ if (args.status) body.status = args.status
182
+ result = await api('PATCH', `/customers/${id}`, body)
183
+ break
184
+ }
185
+ default:
186
+ result = { error: 'Unknown customers subcommand. Use: list, get, create, update' }
187
+ }
188
+ break
189
+
190
+ case 'subscriptions':
191
+ switch (sub) {
192
+ case 'list':
193
+ result = await api('GET', `/subscriptions${buildQuery()}`)
194
+ break
195
+ case 'get': {
196
+ const id = args.id
197
+ if (!id) { result = { error: '--id required' }; break }
198
+ result = await api('GET', `/subscriptions/${id}`)
199
+ break
200
+ }
201
+ case 'update': {
202
+ const id = args.id
203
+ if (!id) { result = { error: '--id required' }; break }
204
+ const body = {}
205
+ if (args['proration-billing-mode']) body.proration_billing_mode = args['proration-billing-mode']
206
+ if (args['scheduled-change']) {
207
+ try { body.scheduled_change = JSON.parse(args['scheduled-change']) } catch { result = { error: 'Invalid JSON in --scheduled-change' }; break }
208
+ }
209
+ result = await api('PATCH', `/subscriptions/${id}`, body)
210
+ break
211
+ }
212
+ case 'cancel': {
213
+ const id = args.id
214
+ if (!id) { result = { error: '--id required' }; break }
215
+ const body = { effective_from: args['effective-from'] || 'next_billing_period' }
216
+ result = await api('POST', `/subscriptions/${id}/cancel`, body)
217
+ break
218
+ }
219
+ case 'pause': {
220
+ const id = args.id
221
+ if (!id) { result = { error: '--id required' }; break }
222
+ const body = {}
223
+ if (args['resume-at']) body.resume_at = args['resume-at']
224
+ result = await api('POST', `/subscriptions/${id}/pause`, body)
225
+ break
226
+ }
227
+ case 'resume': {
228
+ const id = args.id
229
+ if (!id) { result = { error: '--id required' }; break }
230
+ const body = { effective_from: args['effective-from'] || 'immediately' }
231
+ result = await api('POST', `/subscriptions/${id}/resume`, body)
232
+ break
233
+ }
234
+ default:
235
+ result = { error: 'Unknown subscriptions subcommand. Use: list, get, update, cancel, pause, resume' }
236
+ }
237
+ break
238
+
239
+ case 'transactions':
240
+ switch (sub) {
241
+ case 'list':
242
+ result = await api('GET', `/transactions${buildQuery()}`)
243
+ break
244
+ case 'get': {
245
+ const id = args.id
246
+ if (!id) { result = { error: '--id required' }; break }
247
+ result = await api('GET', `/transactions/${id}`)
248
+ break
249
+ }
250
+ case 'create': {
251
+ const items = args.items
252
+ if (!items) { result = { error: '--items required (JSON array of {price_id, quantity})' }; break }
253
+ let parsedItems
254
+ try { parsedItems = JSON.parse(items) } catch { result = { error: 'Invalid JSON in --items' }; break }
255
+ const body = { items: parsedItems }
256
+ if (args['customer-id']) body.customer_id = args['customer-id']
257
+ result = await api('POST', '/transactions', body)
258
+ break
259
+ }
260
+ default:
261
+ result = { error: 'Unknown transactions subcommand. Use: list, get, create' }
262
+ }
263
+ break
264
+
265
+ case 'discounts':
266
+ switch (sub) {
267
+ case 'list':
268
+ result = await api('GET', `/discounts${buildQuery()}`)
269
+ break
270
+ case 'get': {
271
+ const id = args.id
272
+ if (!id) { result = { error: '--id required' }; break }
273
+ result = await api('GET', `/discounts/${id}`)
274
+ break
275
+ }
276
+ case 'create': {
277
+ const amount = args.amount
278
+ const type = args.type
279
+ if (!amount) { result = { error: '--amount required' }; break }
280
+ if (!type) { result = { error: '--type required (flat, flat_per_seat, percentage)' }; break }
281
+ const body = {
282
+ amount,
283
+ type,
284
+ description: args.description || 'Discount',
285
+ }
286
+ if (args.code) body.code = args.code
287
+ if (args['max-uses']) body.maximum_recurring_intervals = Number(args['max-uses'])
288
+ if (args['currency-code']) body.currency_code = args['currency-code']
289
+ result = await api('POST', '/discounts', body)
290
+ break
291
+ }
292
+ default:
293
+ result = { error: 'Unknown discounts subcommand. Use: list, get, create' }
294
+ }
295
+ break
296
+
297
+ case 'adjustments':
298
+ switch (sub) {
299
+ case 'list':
300
+ result = await api('GET', `/adjustments${buildQuery()}`)
301
+ break
302
+ case 'create': {
303
+ const transactionId = args['transaction-id']
304
+ const action = args.action
305
+ const items = args.items
306
+ const reason = args.reason
307
+ if (!transactionId) { result = { error: '--transaction-id required' }; break }
308
+ if (!action) { result = { error: '--action required (refund, credit, chargeback)' }; break }
309
+ if (!reason) { result = { error: '--reason required' }; break }
310
+ if (!items) { result = { error: '--items required (JSON array of {item_id, type, amount})' }; break }
311
+ let parsedItems
312
+ try { parsedItems = JSON.parse(items) } catch { result = { error: 'Invalid JSON in --items' }; break }
313
+ result = await api('POST', '/adjustments', {
314
+ transaction_id: transactionId,
315
+ action,
316
+ reason,
317
+ items: parsedItems,
318
+ })
319
+ break
320
+ }
321
+ default:
322
+ result = { error: 'Unknown adjustments subcommand. Use: list, create' }
323
+ }
324
+ break
325
+
326
+ case 'events':
327
+ switch (sub) {
328
+ case 'list':
329
+ result = await api('GET', `/events${buildQuery()}`)
330
+ break
331
+ case 'types':
332
+ result = await api('GET', '/event-types')
333
+ break
334
+ default:
335
+ result = { error: 'Unknown events subcommand. Use: list, types' }
336
+ }
337
+ break
338
+
339
+ case 'notifications':
340
+ switch (sub) {
341
+ case 'list':
342
+ result = await api('GET', `/notifications${buildQuery()}`)
343
+ break
344
+ case 'get': {
345
+ const id = args.id
346
+ if (!id) { result = { error: '--id required' }; break }
347
+ result = await api('GET', `/notifications/${id}`)
348
+ break
349
+ }
350
+ case 'replay': {
351
+ const id = args.id
352
+ if (!id) { result = { error: '--id required' }; break }
353
+ result = await api('POST', `/notifications/${id}/replay`)
354
+ break
355
+ }
356
+ default:
357
+ result = { error: 'Unknown notifications subcommand. Use: list, get, replay' }
358
+ }
359
+ break
360
+
361
+ default:
362
+ result = {
363
+ error: 'Unknown command',
364
+ usage: {
365
+ products: 'products [list | get --id <id> | create --name <n> --tax-category <cat> | update --id <id>]',
366
+ prices: 'prices [list | get --id <id> | create --product-id <id> --amount <amt> [--currency USD] [--interval month --frequency 1] | update --id <id>]',
367
+ customers: 'customers [list | get --id <id> | create --email <email> [--name <name>] | update --id <id>]',
368
+ subscriptions: 'subscriptions [list | get --id <id> | update --id <id> | cancel --id <id> [--effective-from next_billing_period] | pause --id <id> | resume --id <id>]',
369
+ transactions: 'transactions [list | get --id <id> | create --items <json>]',
370
+ discounts: 'discounts [list | get --id <id> | create --amount <amt> --type <type> [--code <code>]]',
371
+ adjustments: 'adjustments [list | create --transaction-id <id> --action <action> --reason <reason> --items <json>]',
372
+ events: 'events [list | types]',
373
+ notifications: 'notifications [list | get --id <id> | replay --id <id>]',
374
+ env: 'Set PADDLE_SANDBOX=true for sandbox environment',
375
+ }
376
+ }
377
+ }
378
+
379
+ console.log(JSON.stringify(result, null, 2))
380
+ }
381
+
382
+ main().catch(err => {
383
+ console.error(JSON.stringify({ error: err.message }))
384
+ process.exit(1)
385
+ })