@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,248 @@
1
+ #!/usr/bin/env node
2
+
3
+ const TOKEN = process.env.MIXPANEL_TOKEN
4
+ const API_KEY = process.env.MIXPANEL_API_KEY
5
+ const SECRET = process.env.MIXPANEL_SECRET
6
+ const INGESTION_URL = 'https://api.mixpanel.com'
7
+ const QUERY_URL = 'https://mixpanel.com/api/2.0'
8
+ const EXPORT_URL = 'https://data.mixpanel.com/api/2.0'
9
+
10
+ if (!TOKEN && !API_KEY) {
11
+ console.error(JSON.stringify({ error: 'MIXPANEL_TOKEN (for ingestion) or MIXPANEL_API_KEY + MIXPANEL_SECRET (for query/export) environment variables required' }))
12
+ process.exit(1)
13
+ }
14
+
15
+ async function ingestApi(method, path, body) {
16
+ const headers = { 'Content-Type': 'application/json' }
17
+ if (args['dry-run']) {
18
+ const maskedBody = body ? JSON.parse(JSON.stringify(body)) : undefined
19
+ if (Array.isArray(maskedBody)) maskedBody.forEach(item => {
20
+ if (item.properties && item.properties.token) item.properties.token = '***'
21
+ if (item.$token) item.$token = '***'
22
+ })
23
+ return { _dry_run: true, method, url: `${INGESTION_URL}${path}`, headers, body: maskedBody }
24
+ }
25
+ const res = await fetch(`${INGESTION_URL}${path}`, {
26
+ method,
27
+ headers,
28
+ body: body ? JSON.stringify(body) : undefined,
29
+ })
30
+ const text = await res.text()
31
+ try {
32
+ return JSON.parse(text)
33
+ } catch {
34
+ return { status: res.status, body: text }
35
+ }
36
+ }
37
+
38
+ async function queryApi(method, baseUrl, path, params) {
39
+ if (!API_KEY || !SECRET) {
40
+ return { error: 'MIXPANEL_API_KEY and MIXPANEL_SECRET required for query/export operations' }
41
+ }
42
+ const auth = Buffer.from(`${API_KEY}:${SECRET}`).toString('base64')
43
+ const url = params ? `${baseUrl}${path}?${params}` : `${baseUrl}${path}`
44
+ const headers = {
45
+ 'Authorization': `Basic ${auth}`,
46
+ 'Content-Type': 'application/json',
47
+ }
48
+ if (args['dry-run']) {
49
+ return { _dry_run: true, method, url, headers: { ...headers, Authorization: '***' } }
50
+ }
51
+ const res = await fetch(url, {
52
+ method,
53
+ headers,
54
+ })
55
+ const text = await res.text()
56
+ try {
57
+ return JSON.parse(text)
58
+ } catch {
59
+ return { status: res.status, body: text }
60
+ }
61
+ }
62
+
63
+ async function queryApiPost(path, body) {
64
+ if (!API_KEY || !SECRET) {
65
+ return { error: 'MIXPANEL_API_KEY and MIXPANEL_SECRET required for query/export operations' }
66
+ }
67
+ const auth = Buffer.from(`${API_KEY}:${SECRET}`).toString('base64')
68
+ const headers = {
69
+ 'Authorization': `Basic ${auth}`,
70
+ 'Content-Type': 'application/json',
71
+ }
72
+ if (args['dry-run']) {
73
+ return { _dry_run: true, method: 'POST', url: `${QUERY_URL}${path}`, headers: { ...headers, Authorization: '***' }, body: body || undefined }
74
+ }
75
+ const res = await fetch(`${QUERY_URL}${path}`, {
76
+ method: 'POST',
77
+ headers,
78
+ body: JSON.stringify(body),
79
+ })
80
+ const text = await res.text()
81
+ try {
82
+ return JSON.parse(text)
83
+ } catch {
84
+ return { status: res.status, body: text }
85
+ }
86
+ }
87
+
88
+ function parseArgs(args) {
89
+ const result = { _: [] }
90
+ for (let i = 0; i < args.length; i++) {
91
+ const arg = args[i]
92
+ if (arg.startsWith('--')) {
93
+ const key = arg.slice(2)
94
+ const next = args[i + 1]
95
+ if (next && !next.startsWith('--')) {
96
+ result[key] = next
97
+ i++
98
+ } else {
99
+ result[key] = true
100
+ }
101
+ } else {
102
+ result._.push(arg)
103
+ }
104
+ }
105
+ return result
106
+ }
107
+
108
+ const args = parseArgs(process.argv.slice(2))
109
+ const [cmd, sub, ...rest] = args._
110
+
111
+ async function main() {
112
+ let result
113
+
114
+ switch (cmd) {
115
+ case 'track':
116
+ switch (sub) {
117
+ case 'event': {
118
+ if (!TOKEN) { result = { error: 'MIXPANEL_TOKEN required for tracking' }; break }
119
+ if (!args['distinct-id']) { result = { error: '--distinct-id required' }; break }
120
+ if (!args.event) { result = { error: '--event required' }; break }
121
+ let properties
122
+ try { properties = args.properties ? JSON.parse(args.properties) : {} } catch { result = { error: 'Invalid JSON in --properties' }; break }
123
+ properties.token = TOKEN
124
+ properties.distinct_id = args['distinct-id']
125
+ result = await ingestApi('POST', '/track', [{
126
+ event: args.event,
127
+ properties,
128
+ }])
129
+ break
130
+ }
131
+ default:
132
+ result = { error: 'Unknown track subcommand. Use: event' }
133
+ }
134
+ break
135
+
136
+ case 'profiles':
137
+ switch (sub) {
138
+ case 'set': {
139
+ if (!TOKEN) { result = { error: 'MIXPANEL_TOKEN required for profiles' }; break }
140
+ if (!args['distinct-id']) { result = { error: '--distinct-id required' }; break }
141
+ let properties
142
+ try { properties = args.properties ? JSON.parse(args.properties) : {} } catch { result = { error: 'Invalid JSON in --properties' }; break }
143
+ result = await ingestApi('POST', '/engage', [{
144
+ $token: TOKEN,
145
+ $distinct_id: args['distinct-id'],
146
+ $set: properties,
147
+ }])
148
+ break
149
+ }
150
+ default:
151
+ result = { error: 'Unknown profiles subcommand. Use: set' }
152
+ }
153
+ break
154
+
155
+ case 'query':
156
+ switch (sub) {
157
+ case 'events': {
158
+ if (!args['project-id']) { result = { error: '--project-id required' }; break }
159
+ const body = {
160
+ project_id: parseInt(args['project-id']),
161
+ bookmark_id: null,
162
+ params: {
163
+ events: [{ event: args.event || 'all' }],
164
+ time_range: {
165
+ from_date: args['from-date'] || new Date(Date.now() - 30 * 86400000).toISOString().slice(0, 10),
166
+ to_date: args['to-date'] || new Date().toISOString().slice(0, 10),
167
+ },
168
+ },
169
+ }
170
+ result = await queryApiPost('/insights', body)
171
+ break
172
+ }
173
+ default:
174
+ result = { error: 'Unknown query subcommand. Use: events' }
175
+ }
176
+ break
177
+
178
+ case 'funnels':
179
+ switch (sub) {
180
+ case 'get': {
181
+ if (!args['funnel-id']) { result = { error: '--funnel-id required' }; break }
182
+ const params = new URLSearchParams()
183
+ params.set('funnel_id', args['funnel-id'])
184
+ if (args['from-date']) params.set('from_date', args['from-date'])
185
+ if (args['to-date']) params.set('to_date', args['to-date'])
186
+ result = await queryApi('GET', QUERY_URL, '/funnels', params)
187
+ break
188
+ }
189
+ default:
190
+ result = { error: 'Unknown funnels subcommand. Use: get' }
191
+ }
192
+ break
193
+
194
+ case 'retention':
195
+ switch (sub) {
196
+ case 'get': {
197
+ if (!args['from-date'] || !args['to-date']) { result = { error: '--from-date and --to-date required (YYYY-MM-DD)' }; break }
198
+ const params = new URLSearchParams()
199
+ params.set('from_date', args['from-date'])
200
+ params.set('to_date', args['to-date'])
201
+ params.set('retention_type', 'birth')
202
+ if (args['born-event']) params.set('born_event', args['born-event'])
203
+ result = await queryApi('GET', QUERY_URL, '/retention', params)
204
+ break
205
+ }
206
+ default:
207
+ result = { error: 'Unknown retention subcommand. Use: get' }
208
+ }
209
+ break
210
+
211
+ case 'export':
212
+ switch (sub) {
213
+ case 'events': {
214
+ if (!args['from-date']) { result = { error: '--from-date required' }; break }
215
+ if (!args['to-date']) { result = { error: '--to-date required' }; break }
216
+ const params = new URLSearchParams()
217
+ params.set('from_date', args['from-date'])
218
+ params.set('to_date', args['to-date'])
219
+ if (args.event) params.set('event', JSON.stringify([args.event]))
220
+ result = await queryApi('GET', EXPORT_URL, '/export', params)
221
+ break
222
+ }
223
+ default:
224
+ result = { error: 'Unknown export subcommand. Use: events' }
225
+ }
226
+ break
227
+
228
+ default:
229
+ result = {
230
+ error: 'Unknown command',
231
+ usage: {
232
+ track: 'track event --distinct-id <id> --event <name> [--properties <json>]',
233
+ profiles: 'profiles set --distinct-id <id> [--properties <json>]',
234
+ query: 'query events --project-id <id> [--event <name>] [--from-date <date>] [--to-date <date>]',
235
+ funnels: 'funnels get --funnel-id <id> [--from-date <date>] [--to-date <date>]',
236
+ retention: 'retention get [--from-date <date>] [--to-date <date>] [--born-event <event>]',
237
+ export: 'export events --from-date <date> --to-date <date>',
238
+ }
239
+ }
240
+ }
241
+
242
+ console.log(JSON.stringify(result, null, 2))
243
+ }
244
+
245
+ main().catch(err => {
246
+ console.error(JSON.stringify({ error: err.message }))
247
+ process.exit(1)
248
+ })
@@ -0,0 +1,241 @@
1
+ #!/usr/bin/env node
2
+
3
+ const REST_API_KEY = process.env.ONESIGNAL_REST_API_KEY
4
+ const APP_ID = process.env.ONESIGNAL_APP_ID
5
+ const BASE_URL = 'https://api.onesignal.com'
6
+
7
+ if (!REST_API_KEY) {
8
+ console.error(JSON.stringify({ error: 'ONESIGNAL_REST_API_KEY environment variable required' }))
9
+ process.exit(1)
10
+ }
11
+
12
+ if (!APP_ID) {
13
+ console.error(JSON.stringify({ error: 'ONESIGNAL_APP_ID environment variable required' }))
14
+ process.exit(1)
15
+ }
16
+
17
+ async function api(method, path, body) {
18
+ const headers = {
19
+ 'Authorization': `Basic ${REST_API_KEY}`,
20
+ 'Content-Type': 'application/json',
21
+ 'Accept': 'application/json',
22
+ }
23
+ if (args['dry-run']) {
24
+ return { _dry_run: true, method, url: `${BASE_URL}${path}`, headers: { ...headers, Authorization: '***' }, body: body || undefined }
25
+ }
26
+ const res = await fetch(`${BASE_URL}${path}`, {
27
+ method,
28
+ headers,
29
+ body: body ? JSON.stringify(body) : undefined,
30
+ })
31
+ const text = await res.text()
32
+ try {
33
+ return JSON.parse(text)
34
+ } catch {
35
+ return { status: res.status, body: text }
36
+ }
37
+ }
38
+
39
+ function parseArgs(args) {
40
+ const result = { _: [] }
41
+ for (let i = 0; i < args.length; i++) {
42
+ const arg = args[i]
43
+ if (arg.startsWith('--')) {
44
+ const key = arg.slice(2)
45
+ const next = args[i + 1]
46
+ if (next && !next.startsWith('--')) {
47
+ result[key] = next
48
+ i++
49
+ } else {
50
+ result[key] = true
51
+ }
52
+ } else {
53
+ result._.push(arg)
54
+ }
55
+ }
56
+ return result
57
+ }
58
+
59
+ const args = parseArgs(process.argv.slice(2))
60
+ const [cmd, sub, ...rest] = args._
61
+
62
+ async function main() {
63
+ let result
64
+ const limit = args.limit ? Number(args.limit) : 50
65
+ const offset = args.offset ? Number(args.offset) : 0
66
+
67
+ switch (cmd) {
68
+ case 'notifications':
69
+ switch (sub) {
70
+ case 'send': {
71
+ const message = args.message
72
+ if (!message) { result = { error: '--message required' }; break }
73
+ const payload = {
74
+ app_id: APP_ID,
75
+ contents: { en: message },
76
+ }
77
+ if (args.heading) payload.headings = { en: args.heading }
78
+ if (args.url) payload.url = args.url
79
+ if (args.data) {
80
+ try { payload.data = JSON.parse(args.data) } catch { payload.data = { value: args.data } }
81
+ }
82
+ if (args.segment) {
83
+ payload.included_segments = args.segment.split(',')
84
+ } else if (args.emails) {
85
+ payload.include_email_tokens = args.emails.split(',')
86
+ } else if (args['player-ids']) {
87
+ payload.include_player_ids = args['player-ids'].split(',')
88
+ } else if (args.aliases) {
89
+ try {
90
+ payload.include_aliases = JSON.parse(args.aliases)
91
+ } catch {
92
+ payload.include_aliases = { external_id: args.aliases.split(',') }
93
+ }
94
+ payload.target_channel = args.channel || 'push'
95
+ } else {
96
+ payload.included_segments = ['Subscribed Users']
97
+ }
98
+ if (args['send-after']) payload.send_after = args['send-after']
99
+ if (args.ttl) payload.ttl = Number(args.ttl)
100
+ result = await api('POST', '/api/v1/notifications', payload)
101
+ break
102
+ }
103
+ case 'list': {
104
+ result = await api('GET', `/api/v1/notifications?app_id=${APP_ID}&limit=${limit}&offset=${offset}`)
105
+ break
106
+ }
107
+ case 'get': {
108
+ const id = args.id
109
+ if (!id) { result = { error: '--id required' }; break }
110
+ result = await api('GET', `/api/v1/notifications/${id}?app_id=${APP_ID}`)
111
+ break
112
+ }
113
+ case 'cancel': {
114
+ const id = args.id
115
+ if (!id) { result = { error: '--id required' }; break }
116
+ result = await api('DELETE', `/api/v1/notifications/${id}?app_id=${APP_ID}`)
117
+ break
118
+ }
119
+ default:
120
+ result = { error: 'Unknown notifications subcommand. Use: send, list, get, cancel' }
121
+ }
122
+ break
123
+
124
+ case 'segments':
125
+ switch (sub) {
126
+ case 'list': {
127
+ result = await api('GET', `/api/v1/apps/${APP_ID}/segments?offset=${offset}&limit=${limit}`)
128
+ break
129
+ }
130
+ case 'create': {
131
+ const name = args.name
132
+ if (!name) { result = { error: '--name required' }; break }
133
+ let filters
134
+ try { filters = args.filters ? JSON.parse(args.filters) : [{ field: 'session_count', relation: '>', value: '0' }] } catch { result = { error: 'Invalid JSON in --filters' }; break }
135
+ result = await api('POST', `/api/v1/apps/${APP_ID}/segments`, { name, filters })
136
+ break
137
+ }
138
+ case 'delete': {
139
+ const id = args.id
140
+ if (!id) { result = { error: '--id required' }; break }
141
+ result = await api('DELETE', `/api/v1/apps/${APP_ID}/segments/${id}`)
142
+ break
143
+ }
144
+ default:
145
+ result = { error: 'Unknown segments subcommand. Use: list, create, delete' }
146
+ }
147
+ break
148
+
149
+ case 'users':
150
+ switch (sub) {
151
+ case 'get': {
152
+ const aliasLabel = args['alias-label'] || 'external_id'
153
+ const aliasId = args['alias-id']
154
+ if (!aliasId) { result = { error: '--alias-id required' }; break }
155
+ result = await api('GET', `/api/v1/apps/${APP_ID}/users/by/${aliasLabel}/${aliasId}`)
156
+ break
157
+ }
158
+ case 'create': {
159
+ const payload = {}
160
+ if (args['external-id']) {
161
+ payload.identity = { external_id: args['external-id'] }
162
+ }
163
+ if (args.email) {
164
+ payload.subscriptions = [{ type: 'Email', token: args.email }]
165
+ }
166
+ if (args.tags) {
167
+ try { payload.tags = JSON.parse(args.tags) } catch { result = { error: 'Invalid --tags JSON' }; break }
168
+ }
169
+ result = await api('POST', `/api/v1/apps/${APP_ID}/users`, payload)
170
+ break
171
+ }
172
+ case 'delete': {
173
+ const aliasLabel = args['alias-label'] || 'external_id'
174
+ const aliasId = args['alias-id']
175
+ if (!aliasId) { result = { error: '--alias-id required' }; break }
176
+ result = await api('DELETE', `/api/v1/apps/${APP_ID}/users/by/${aliasLabel}/${aliasId}`)
177
+ break
178
+ }
179
+ default:
180
+ result = { error: 'Unknown users subcommand. Use: get, create, delete' }
181
+ }
182
+ break
183
+
184
+ case 'templates':
185
+ switch (sub) {
186
+ case 'list': {
187
+ result = await api('GET', `/api/v1/templates?app_id=${APP_ID}&limit=${limit}&offset=${offset}`)
188
+ break
189
+ }
190
+ case 'get': {
191
+ const id = args.id
192
+ if (!id) { result = { error: '--id required' }; break }
193
+ result = await api('GET', `/api/v1/templates/${id}?app_id=${APP_ID}`)
194
+ break
195
+ }
196
+ case 'create': {
197
+ const name = args.name
198
+ if (!name) { result = { error: '--name required' }; break }
199
+ const payload = { app_id: APP_ID, name }
200
+ if (args.message) payload.contents = { en: args.message }
201
+ if (args.heading) payload.headings = { en: args.heading }
202
+ result = await api('POST', '/api/v1/templates', payload)
203
+ break
204
+ }
205
+ default:
206
+ result = { error: 'Unknown templates subcommand. Use: list, get, create' }
207
+ }
208
+ break
209
+
210
+ case 'app':
211
+ switch (sub) {
212
+ case 'get': {
213
+ result = await api('GET', `/api/v1/apps/${APP_ID}`)
214
+ break
215
+ }
216
+ default:
217
+ result = { error: 'Unknown app subcommand. Use: get' }
218
+ }
219
+ break
220
+
221
+ default:
222
+ result = {
223
+ error: 'Unknown command',
224
+ usage: {
225
+ notifications: 'notifications [send --message <msg> --segment <s> | list | get --id <id> | cancel --id <id>]',
226
+ segments: 'segments [list | create --name <n> --filters <json> | delete --id <id>]',
227
+ users: 'users [get --alias-id <id> | create --external-id <id> --email <e> | delete --alias-id <id>]',
228
+ templates: 'templates [list | get --id <id> | create --name <n> --message <msg>]',
229
+ app: 'app [get]',
230
+ options: '--limit <n> --offset <n>',
231
+ }
232
+ }
233
+ }
234
+
235
+ console.log(JSON.stringify(result, null, 2))
236
+ }
237
+
238
+ main().catch(err => {
239
+ console.error(JSON.stringify({ error: err.message }))
240
+ process.exit(1)
241
+ })