splithub 0.3.0 → 0.4.1

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 (135) hide show
  1. package/dist/alerts-Q46GJETJ.js +28 -0
  2. package/dist/analytics-BVBZVSCN.js +22 -0
  3. package/dist/{chunk-4YXB73AZ.js → chunk-4OQEIP33.js} +28 -3
  4. package/dist/chunk-4OQEIP33.js.map +1 -0
  5. package/dist/{chunk-4PUFNQ5F.js → chunk-6GP534WA.js} +6 -6
  6. package/dist/{chunk-QKOATM5G.js → chunk-6MWK7QV4.js} +12 -11
  7. package/dist/chunk-6MWK7QV4.js.map +1 -0
  8. package/dist/{chunk-TIL2VQX4.js → chunk-6T652N3X.js} +2 -2
  9. package/dist/chunk-7DFMYJTC.js +347 -0
  10. package/dist/chunk-7DFMYJTC.js.map +1 -0
  11. package/dist/chunk-CAFWOX3S.js +49 -0
  12. package/dist/chunk-CAFWOX3S.js.map +1 -0
  13. package/dist/chunk-FDSNZRQQ.js +125 -0
  14. package/dist/chunk-FDSNZRQQ.js.map +1 -0
  15. package/dist/{chunk-EQCMCULO.js → chunk-GIYKIJKW.js} +25 -8
  16. package/dist/chunk-GIYKIJKW.js.map +1 -0
  17. package/dist/{chunk-A3FYDTIP.js → chunk-HFIBLDUA.js} +2 -2
  18. package/dist/{chunk-J5ZUSS43.js → chunk-ILEPMQNT.js} +55 -2
  19. package/dist/chunk-ILEPMQNT.js.map +1 -0
  20. package/dist/chunk-J3DANPLP.js +250 -0
  21. package/dist/chunk-J3DANPLP.js.map +1 -0
  22. package/dist/{chunk-NHRWXNB5.js → chunk-KV7D6SB7.js} +8 -8
  23. package/dist/{chunk-NHRWXNB5.js.map → chunk-KV7D6SB7.js.map} +1 -1
  24. package/dist/chunk-MSYL3XZF.js +243 -0
  25. package/dist/chunk-MSYL3XZF.js.map +1 -0
  26. package/dist/{chunk-4LE4SCWY.js → chunk-MUDDASN6.js} +2 -2
  27. package/dist/{chunk-U3QRNSLM.js → chunk-NFZZSF4M.js} +3 -3
  28. package/dist/{chunk-WTUZFXXJ.js → chunk-NYWJZKOO.js} +8 -8
  29. package/dist/{chunk-WTUZFXXJ.js.map → chunk-NYWJZKOO.js.map} +1 -1
  30. package/dist/chunk-OXVLWFSD.js +822 -0
  31. package/dist/chunk-OXVLWFSD.js.map +1 -0
  32. package/dist/{chunk-VSMWYVJ2.js → chunk-QCFQFDEB.js} +35 -13
  33. package/dist/chunk-QCFQFDEB.js.map +1 -0
  34. package/dist/{chunk-PMER7I7F.js → chunk-RMWW4YMN.js} +4 -4
  35. package/dist/{chunk-PMER7I7F.js.map → chunk-RMWW4YMN.js.map} +1 -1
  36. package/dist/chunk-SHKXD2C6.js +199 -0
  37. package/dist/chunk-SHKXD2C6.js.map +1 -0
  38. package/dist/chunk-SUUNAQAC.js +270 -0
  39. package/dist/chunk-SUUNAQAC.js.map +1 -0
  40. package/dist/{chunk-JBPVGBLN.js → chunk-U7Z5VYNX.js} +24 -19
  41. package/dist/chunk-U7Z5VYNX.js.map +1 -0
  42. package/dist/{chunk-BNZFC2DQ.js → chunk-VVJ4WRAB.js} +31 -18
  43. package/dist/chunk-VVJ4WRAB.js.map +1 -0
  44. package/dist/{chunk-C3ZJEZDE.js → chunk-VY342F4X.js} +44 -17
  45. package/dist/chunk-VY342F4X.js.map +1 -0
  46. package/dist/chunk-WMZLKY6J.js +237 -0
  47. package/dist/chunk-WMZLKY6J.js.map +1 -0
  48. package/dist/{chunk-PP3RLIJP.js → chunk-ZISCJRR5.js} +4 -3
  49. package/dist/chunk-ZISCJRR5.js.map +1 -0
  50. package/dist/{ci-KFSOM2AF.js → ci-4SY2X2CU.js} +4 -4
  51. package/dist/connect-BVXKCJNO.js +225 -0
  52. package/dist/connect-BVXKCJNO.js.map +1 -0
  53. package/dist/create-IBVKGS3D.js +18 -0
  54. package/dist/dev-YNKPWJHX.js +11 -0
  55. package/dist/doctor-BKS7TUAT.js +14 -0
  56. package/dist/domains-CR34APOD.js +10 -0
  57. package/dist/experiment-reports-LL2TFQQN.js +49 -0
  58. package/dist/{holdout-OYKY6UIE.js → holdout-JJEP6673.js} +7 -6
  59. package/dist/holdout-JJEP6673.js.map +1 -0
  60. package/dist/index.js +128 -37
  61. package/dist/index.js.map +1 -1
  62. package/dist/init-HRCQ5WAA.js +15 -0
  63. package/dist/lifecycle-3GUIJ74P.js +12 -0
  64. package/dist/links-BQZLMGZJ.js +18 -0
  65. package/dist/{login-AETAL2DO.js → login-OT77MNKL.js} +4 -4
  66. package/dist/login-OT77MNKL.js.map +1 -0
  67. package/dist/menu-7EZD5NDF.js +726 -0
  68. package/dist/menu-7EZD5NDF.js.map +1 -0
  69. package/dist/notes-BASGWNNX.js +18 -0
  70. package/dist/notes-BASGWNNX.js.map +1 -0
  71. package/dist/{plan-Q2EZSSAO.js → plan-44334RQS.js} +7 -7
  72. package/dist/plan-44334RQS.js.map +1 -0
  73. package/dist/push-L2IRGUDM.js +16 -0
  74. package/dist/push-L2IRGUDM.js.map +1 -0
  75. package/dist/{refs-VPQ7WIRJ.js → refs-5DTSKMXU.js} +5 -5
  76. package/dist/{remove-IPLTQIFK.js → remove-PVVTBBWX.js} +10 -9
  77. package/dist/remove-PVVTBBWX.js.map +1 -0
  78. package/dist/{report-TOWSAQYM.js → report-JVMKVZTS.js} +6 -6
  79. package/dist/results-KC24ZZTX.js +20 -0
  80. package/dist/results-KC24ZZTX.js.map +1 -0
  81. package/dist/{review-HMBIZ6V2.js → review-GIYBPVP3.js} +3 -3
  82. package/dist/{ship-LKSCUDAE.js → ship-UP6DLCJN.js} +10 -9
  83. package/dist/ship-UP6DLCJN.js.map +1 -0
  84. package/dist/skills-J6X6DULX.js +18 -0
  85. package/dist/skills-J6X6DULX.js.map +1 -0
  86. package/dist/status-SK5PPBPL.js +17 -0
  87. package/dist/status-SK5PPBPL.js.map +1 -0
  88. package/dist/{update-R4L7ZP5G.js → update-XF7HWJ3A.js} +3 -3
  89. package/package.json +3 -3
  90. package/dist/chunk-4YXB73AZ.js.map +0 -1
  91. package/dist/chunk-BNZFC2DQ.js.map +0 -1
  92. package/dist/chunk-C3ZJEZDE.js.map +0 -1
  93. package/dist/chunk-EQCMCULO.js.map +0 -1
  94. package/dist/chunk-HK267YK2.js +0 -571
  95. package/dist/chunk-HK267YK2.js.map +0 -1
  96. package/dist/chunk-J5ZUSS43.js.map +0 -1
  97. package/dist/chunk-JBPVGBLN.js.map +0 -1
  98. package/dist/chunk-PP3RLIJP.js.map +0 -1
  99. package/dist/chunk-QKOATM5G.js.map +0 -1
  100. package/dist/chunk-VSMWYVJ2.js.map +0 -1
  101. package/dist/create-POZWP6JT.js +0 -18
  102. package/dist/dev-3SPMTW3T.js +0 -11
  103. package/dist/doctor-OHZEXUGO.js +0 -14
  104. package/dist/holdout-OYKY6UIE.js.map +0 -1
  105. package/dist/init-4PNOZUIZ.js +0 -15
  106. package/dist/lifecycle-3QVRQRHM.js +0 -12
  107. package/dist/menu-PBZVBCGA.js +0 -163
  108. package/dist/menu-PBZVBCGA.js.map +0 -1
  109. package/dist/plan-Q2EZSSAO.js.map +0 -1
  110. package/dist/push-7EELDSKG.js +0 -16
  111. package/dist/remove-IPLTQIFK.js.map +0 -1
  112. package/dist/results-SMBCREVI.js +0 -17
  113. package/dist/ship-LKSCUDAE.js.map +0 -1
  114. package/dist/skills-5ZAMIVP3.js +0 -18
  115. package/dist/status-7LDIKVX7.js +0 -12
  116. /package/dist/{ci-KFSOM2AF.js.map → alerts-Q46GJETJ.js.map} +0 -0
  117. /package/dist/{create-POZWP6JT.js.map → analytics-BVBZVSCN.js.map} +0 -0
  118. /package/dist/{chunk-4PUFNQ5F.js.map → chunk-6GP534WA.js.map} +0 -0
  119. /package/dist/{chunk-TIL2VQX4.js.map → chunk-6T652N3X.js.map} +0 -0
  120. /package/dist/{chunk-A3FYDTIP.js.map → chunk-HFIBLDUA.js.map} +0 -0
  121. /package/dist/{chunk-4LE4SCWY.js.map → chunk-MUDDASN6.js.map} +0 -0
  122. /package/dist/{chunk-U3QRNSLM.js.map → chunk-NFZZSF4M.js.map} +0 -0
  123. /package/dist/{dev-3SPMTW3T.js.map → ci-4SY2X2CU.js.map} +0 -0
  124. /package/dist/{doctor-OHZEXUGO.js.map → create-IBVKGS3D.js.map} +0 -0
  125. /package/dist/{init-4PNOZUIZ.js.map → dev-YNKPWJHX.js.map} +0 -0
  126. /package/dist/{lifecycle-3QVRQRHM.js.map → doctor-BKS7TUAT.js.map} +0 -0
  127. /package/dist/{login-AETAL2DO.js.map → domains-CR34APOD.js.map} +0 -0
  128. /package/dist/{push-7EELDSKG.js.map → experiment-reports-LL2TFQQN.js.map} +0 -0
  129. /package/dist/{results-SMBCREVI.js.map → init-HRCQ5WAA.js.map} +0 -0
  130. /package/dist/{skills-5ZAMIVP3.js.map → lifecycle-3GUIJ74P.js.map} +0 -0
  131. /package/dist/{status-7LDIKVX7.js.map → links-BQZLMGZJ.js.map} +0 -0
  132. /package/dist/{refs-VPQ7WIRJ.js.map → refs-5DTSKMXU.js.map} +0 -0
  133. /package/dist/{report-TOWSAQYM.js.map → report-JVMKVZTS.js.map} +0 -0
  134. /package/dist/{review-HMBIZ6V2.js.map → review-GIYBPVP3.js.map} +0 -0
  135. /package/dist/{update-R4L7ZP5G.js.map → update-XF7HWJ3A.js.map} +0 -0
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/commands/links.ts"],"sourcesContent":["// splithub links — short links on SplitHub Cloud: one short URL, one or more destinations split\n// by weight (split visitors between landing pages without code), clicks counted per destination.\n//\n// splithub links every link with its clicks\n// splithub links <id|slug> clicks of one link: last 30 days, destinations, countries, devices, referrers\n// splithub links create <url> [<url> ...] [--slug spring] [--name \"Spring sale\"] [--weights 70,30]\n// splithub links edit <id|slug> [--name ...] [--slug ...] [--description ...]\n// splithub links pause|resume|delete <id|slug>\n//\n// Targeting a destination by country, device or a flow is done in the dashboard.\n\nimport { request, requireCloudToken, type Target } from '../api';\nimport { fail, printJson } from '../errors';\nimport { bar, c, statusColor, table } from '../ui';\nimport { cloudOnly, n, str } from './analytics-reports';\nimport type { Flags } from './init';\n\nexport interface Link {\n linkId: string;\n name: string;\n shortCode: string;\n shortUrl: string;\n status: string;\n destinations: Array<{\n id: string;\n url: string;\n weight: number;\n label?: string;\n countries?: string[];\n devices?: string[];\n }>;\n clickLimit: number;\n totalClicks: number;\n description: string | null;\n createdAt: string;\n}\n\ninterface LinkStats {\n link: Link;\n totalClicks: number;\n uniqueVisitors: number;\n byDay: Array<{ day: string; clicks: number; visitors: number }>;\n byDestination: Array<{ destinationId: string; clicks: number }>;\n byCountry: Array<{ country: string; clicks: number }>;\n byDevice: Array<{ device: string; clicks: number }>;\n byReferrer: Array<{ referrer: string; clicks: number }>;\n}\n\nconst SLUG = /^[a-zA-Z0-9_-]{3,32}$/;\nconst enc = encodeURIComponent;\n\n/** A link by its id or its slug (short code). */\nexport async function findLink(t: Target, want: string): Promise<Link> {\n const { links } = await request<{ links: Link[] }>(t, '/links');\n const link = links.find((l) => l.linkId === want) ?? links.find((l) => l.shortCode === want) ?? links.find((l) => l.shortCode.toLowerCase() === want.toLowerCase());\n if (!link) fail('NOT_FOUND', `There's no short link \"${want}\".`, 'See them with npx splithub links.');\n return link;\n}\n\n/** `https://example.com/a/b?x` → `example.com/a/b`: a default name for a new link. */\nexport function nameFromUrl(url: string): string {\n try {\n const u = new URL(url);\n return `${u.host}${u.pathname === '/' ? '' : u.pathname}`.slice(0, 80);\n } catch {\n return url.slice(0, 80);\n }\n}\n\n/** Destinations from typed URLs and `--weights 70,30` (equal weights by default). */\nexport function destinationsFrom(urls: string[], weights?: string): Link['destinations'] {\n if (urls.length === 0) fail('USAGE', 'Where should it go? npx splithub links create https://example.com/spring [--slug spring]');\n for (const u of urls) {\n let ok = false;\n try {\n ok = /^https?:$/.test(new URL(u).protocol);\n } catch {\n ok = false;\n }\n if (!ok) fail('INVALID_FLAG', `\"${u}\" is not a full http(s) URL, like https://example.com/page.`);\n }\n const w = weights ? weights.split(',').map((x) => Number(x.trim())) : urls.map(() => 1);\n if (w.length !== urls.length || w.some((x) => !Number.isFinite(x) || x < 0) || w.every((x) => x === 0)) fail('INVALID_FLAG', `--weights ${weights}: one number per URL, like --weights 70,30.`);\n return urls.map((url, i) => ({ id: `d${i + 1}`, url, weight: w[i]! }));\n}\n\nexport async function links(args: string[], flags: Flags): Promise<void> {\n const t = cloudOnly(flags, 'Short links', false);\n if (!t.token) requireCloudToken(flags);\n const [action, ...rest] = args;\n if (!action || action === 'list') return listLinks(t, flags);\n if (action === 'create' || action === 'add') {\n const destinations = destinationsFrom(rest, str(flags.weights));\n const slug = str(flags.slug);\n if (slug && !SLUG.test(slug)) fail('INVALID_FLAG', `--slug ${slug}: 3 to 32 letters, digits, - or _.`);\n const body = {\n name: str(flags.name) ?? nameFromUrl(destinations[0]!.url),\n destinations,\n ...(slug ? { shortCode: slug } : {}),\n ...(str(flags.description) ? { description: str(flags.description) } : {}),\n };\n const out = await request<{ link: Link }>(t, '/links', {\n method: 'POST',\n body: JSON.stringify(body),\n });\n if (flags.json) return printJson(out);\n console.log(`${c.green('✔')} ${c.bold(out.link.shortUrl)} → ${destinations.length === 1 ? destinations[0]!.url : `${destinations.length} destinations, split by weight`}`);\n console.log(c.dim(`Clicks: npx splithub links ${out.link.shortCode}`));\n return;\n }\n if (['edit', 'pause', 'resume', 'delete', 'remove'].includes(action)) {\n const want = rest[0];\n if (!want) fail('USAGE', `Which link? npx splithub links ${action} <id|slug>`);\n const link = await findLink(t, want);\n if (action === 'delete' || action === 'remove') {\n await request(t, `/links/${enc(link.linkId)}`, { method: 'DELETE' });\n if (flags.json) return printJson({ ok: true, linkId: link.linkId, shortCode: link.shortCode });\n console.log(`${c.green('✔')} ${link.shortUrl} deleted ${c.dim('(it stops redirecting now)')}`);\n return;\n }\n let body: Record<string, unknown>;\n if (action === 'edit') {\n const slug = str(flags.slug);\n if (slug && !SLUG.test(slug)) fail('INVALID_FLAG', `--slug ${slug}: 3 to 32 letters, digits, - or _.`);\n body = {\n ...(str(flags.name) ? { name: str(flags.name) } : {}),\n ...(slug ? { shortCode: slug } : {}),\n ...(flags.description !== undefined ? { description: str(flags.description) ?? null } : {}),\n };\n if (Object.keys(body).length === 0) fail('USAGE', 'Nothing to change: --name, --slug or --description.');\n } else body = { status: action === 'pause' ? 'paused' : 'active' };\n const out = await request<{ link: Link }>(t, `/links/${enc(link.linkId)}`, {\n method: 'PATCH',\n body: JSON.stringify(body),\n });\n if (flags.json) return printJson(out);\n if (action === 'edit') console.log(`${c.green('✔')} ${out.link.shortUrl} saved`);\n else console.log(`${c.green('✔')} ${out.link.shortUrl} ${action === 'pause' ? 'paused: visitors see \"Link is paused\"' : 'redirects again'}`);\n return;\n }\n return stats(t, action, flags);\n}\n\nasync function listLinks(t: Target, flags: Flags): Promise<void> {\n const data = await request<{ links: Link[] }>(t, '/links');\n if (flags.json) return printJson(data);\n if (data.links.length === 0) return void console.log(c.dim('No short links yet. Make one: npx splithub links create https://example.com/spring --slug spring'));\n const max = Math.max(1, ...data.links.map((l) => l.totalClicks));\n console.log(\n table(\n ['LINK', 'NAME', 'STATUS', 'CLICKS', '', 'GOES TO'],\n data.links.map((l) => [\n c.bold(l.shortUrl),\n l.name,\n l.status === 'active' ? c.green('active') : statusColor(l.status),\n n(l.totalClicks),\n bar(l.totalClicks, max, 12),\n l.destinations.length === 1 ? l.destinations[0]!.url : `${l.destinations.length} destinations`,\n ])\n )\n );\n}\n\nasync function stats(t: Target, want: string, flags: Flags): Promise<void> {\n const link = await findLink(t, want);\n const data = await request<LinkStats>(t, `/links/${enc(link.linkId)}/stats`);\n if (flags.json) return printJson(data);\n console.log(`${c.bold(link.shortUrl)} ${c.dim(`· ${link.name} · ${link.status}`)}\\n`);\n console.log(`${c.bold(n(data.totalClicks))} clicks from ${c.bold(n(data.uniqueVisitors))} visitors ${c.dim('(all time)')}`);\n if (data.byDestination.length > 1 || link.destinations.length > 1) {\n const total = Math.max(\n 1,\n data.byDestination.reduce((s, d) => s + d.clicks, 0)\n );\n console.log(`\\n${c.bold('Destinations')}`);\n console.log(\n table(\n ['GOES TO', 'WEIGHT', 'CLICKS', 'SHARE'],\n link.destinations.map((d) => {\n const clicks = data.byDestination.find((x) => x.destinationId === d.id)?.clicks ?? 0;\n return [d.label ? `${d.label} ${c.dim(d.url)}` : d.url, String(d.weight), n(clicks), `${((clicks / total) * 100).toFixed(1)}%`];\n })\n )\n );\n }\n if (data.byDay.length) {\n const max = Math.max(1, ...data.byDay.map((d) => d.clicks));\n console.log(`\\n${c.bold('Last 30 days')}`);\n console.log(\n table(\n ['DAY', 'CLICKS', '', 'VISITORS'],\n data.byDay.slice(-14).map((d) => [d.day, n(d.clicks), bar(d.clicks, max, 16), n(d.visitors)])\n )\n );\n }\n const top = (title: string, head: string, rows: Array<{ value: string; clicks: number }>) => {\n if (!rows.length) return;\n console.log(`\\n${c.bold(title)}`);\n console.log(\n table(\n [head, 'CLICKS'],\n rows.slice(0, 8).map((r) => [r.value, n(r.clicks)])\n )\n );\n };\n top(\n 'Countries',\n 'COUNTRY',\n data.byCountry.map((r) => ({ value: r.country, clicks: r.clicks }))\n );\n top(\n 'Devices',\n 'DEVICE',\n data.byDevice.map((r) => ({ value: r.device, clicks: r.clicks }))\n );\n top(\n 'Referrers',\n 'REFERRER',\n data.byReferrer.map((r) => ({\n value: r.referrer === '(direct)' ? c.dim('direct') : r.referrer,\n clicks: r.clicks,\n }))\n );\n}\n"],"mappings":"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","names":["links"]}
@@ -0,0 +1,270 @@
1
+ #!/usr/bin/env node
2
+ import {
3
+ cloudOnly,
4
+ n,
5
+ str
6
+ } from "./chunk-J3DANPLP.js";
7
+ import {
8
+ request,
9
+ requireCloudToken
10
+ } from "./chunk-4OQEIP33.js";
11
+ import {
12
+ CliError,
13
+ c,
14
+ fail,
15
+ printJson,
16
+ table
17
+ } from "./chunk-ZISCJRR5.js";
18
+
19
+ // src/commands/alerts.ts
20
+ var ALERT_CONDITIONS = ["srm", "winner", "loser", "exposures", "conversions", "duration", "no_events", "quota", "usage", "traffic_drop", "traffic_spike", "goal_silent", "event_count"];
21
+ var ACCOUNT = ["quota", "usage"];
22
+ var PROPERTY = ["traffic_drop", "traffic_spike", "goal_silent", "event_count"];
23
+ var enc = encodeURIComponent;
24
+ function parseCount(v) {
25
+ if (typeof v !== "string" || !v.trim()) return Number.NaN;
26
+ const m = /^(\d+(?:\.\d+)?)\s*([km]?)$/i.exec(v.trim().replace(/[,_\s](?=\d)/g, ""));
27
+ if (!m) return Number.NaN;
28
+ return Math.round(Number(m[1]) * (m[2]?.toLowerCase() === "k" ? 1e3 : m[2]?.toLowerCase() === "m" ? 1e6 : 1));
29
+ }
30
+ function describeRule(r) {
31
+ const p = r.params;
32
+ switch (r.condition) {
33
+ case "srm":
34
+ return "The split breaks (SRM)";
35
+ case "winner":
36
+ return "A clear winner";
37
+ case "loser":
38
+ return `A variant ${p.lift ?? 0}%+ worse than control`;
39
+ case "exposures":
40
+ return `${n(p.visitors ?? 0)} visitors reached`;
41
+ case "conversions":
42
+ return `${n(p.conversions ?? 0)} conversions reached`;
43
+ case "duration":
44
+ return `Running for ${p.days ?? 0} days`;
45
+ case "no_events":
46
+ return `No visitors for ${p.hours ?? 24}h`;
47
+ case "quota":
48
+ return `${p.percent ?? 80}% of the monthly allowance used`;
49
+ case "usage":
50
+ return `Every ${n(p.every ?? 0)} events used`;
51
+ case "traffic_drop":
52
+ return `Visitors down ${p.percent ?? 50}%+ vs a week before`;
53
+ case "traffic_spike":
54
+ return `Visitors up ${p.percent ?? 50}%+ vs a week before`;
55
+ case "goal_silent":
56
+ return `No ${p.goal ?? "goal"} for ${p.hours ?? 24}h`;
57
+ case "event_count":
58
+ return `${p.event ?? "Any event"} ${p.repeat ? "every" : "reaches"} ${n(p.count ?? 0)}`;
59
+ default:
60
+ return r.condition;
61
+ }
62
+ }
63
+ function ruleTarget(r) {
64
+ if (ACCOUNT.includes(r.condition)) return "this project";
65
+ if (PROPERTY.includes(r.condition)) return `property ${r.params.property ?? "?"}`;
66
+ return r.experiment ? `experiment ${r.experiment}` : "every running experiment";
67
+ }
68
+ function ruleProgress(r) {
69
+ const pr = r.params.progress;
70
+ if (!pr) return "";
71
+ if (r.condition === "usage" && r.params.every) return `${n(pr.total)} used this month, next at ${n((pr.fired + 1) * r.params.every)}`;
72
+ if (r.condition === "event_count" && r.params.count) {
73
+ if (!r.params.repeat && pr.fired > 0) return `${n(pr.total)} counted, done`;
74
+ return `${n(pr.total)} of ${n((pr.fired + 1) * r.params.count)}`;
75
+ }
76
+ return "";
77
+ }
78
+ function count(flags, flag, why) {
79
+ const v = parseCount(flags[flag]);
80
+ if (!Number.isFinite(v) || v <= 0) fail("USAGE", `--${flag} N: ${why}.`);
81
+ return v;
82
+ }
83
+ var optional = (flags, flag) => {
84
+ if (flags[flag] === void 0) return void 0;
85
+ const v = parseCount(flags[flag]);
86
+ if (!Number.isFinite(v) || v < 0) fail("INVALID_FLAG", `--${flag} ${String(flags[flag])}: a number.`);
87
+ return v;
88
+ };
89
+ function ruleBody(condition, flags) {
90
+ if (!ALERT_CONDITIONS.includes(condition)) fail("USAGE", `Which condition? One of ${ALERT_CONDITIONS.join(", ")}.`, "Example: npx splithub alerts add usage --every 1000");
91
+ const params = {};
92
+ const property = str(flags.property);
93
+ const needProperty = () => {
94
+ if (!property) fail("USAGE", `--property <id>: which analytics property to watch.`);
95
+ params.property = property;
96
+ };
97
+ switch (condition) {
98
+ case "winner":
99
+ case "loser":
100
+ if (optional(flags, "min-visitors") !== void 0) params.minVisitors = optional(flags, "min-visitors");
101
+ if (condition === "loser") params.lift = optional(flags, "lift") ?? 10;
102
+ break;
103
+ case "exposures":
104
+ params.visitors = count(flags, "visitors", "alert once the experiment reaches this many visitors");
105
+ break;
106
+ case "conversions":
107
+ params.conversions = count(flags, "conversions", "alert once the experiment reaches this many conversions");
108
+ break;
109
+ case "duration":
110
+ params.days = count(flags, "days", "alert once the experiment has run this many days");
111
+ break;
112
+ case "no_events":
113
+ case "goal_silent":
114
+ params.hours = optional(flags, "hours") ?? 24;
115
+ if (condition === "goal_silent") {
116
+ needProperty();
117
+ const goal = str(flags.goal);
118
+ if (!goal) fail("USAGE", "--goal <key>: the goal that should keep converting.");
119
+ params.goal = goal;
120
+ }
121
+ break;
122
+ case "quota":
123
+ params.percent = optional(flags, "percent") ?? 80;
124
+ break;
125
+ case "usage":
126
+ params.every = count(flags, "every", "alert each time this many more events are used this month (100 or more)");
127
+ if (params.every < 100) fail("INVALID_FLAG", "--every: 100 or more.");
128
+ break;
129
+ case "traffic_drop":
130
+ case "traffic_spike":
131
+ needProperty();
132
+ params.percent = optional(flags, "percent") ?? 50;
133
+ break;
134
+ case "event_count":
135
+ needProperty();
136
+ if (str(flags.event)) params.event = str(flags.event);
137
+ params.count = count(flags, "count", "alert when the event reaches this many");
138
+ params.repeat = Boolean(flags.repeat);
139
+ break;
140
+ case "srm":
141
+ break;
142
+ }
143
+ const experiment = str(flags.experiment);
144
+ if (experiment && (ACCOUNT.includes(condition) || PROPERTY.includes(condition))) fail("USAGE", `${condition} is not about one experiment: drop --experiment.`);
145
+ const doing = {
146
+ pause: Boolean(flags.pause),
147
+ finish: Boolean(flags.finish),
148
+ dropLoser: Boolean(flags["drop-loser"])
149
+ };
150
+ if ((doing.pause || doing.finish || doing.dropLoser) && (ACCOUNT.includes(condition) || PROPERTY.includes(condition))) fail("USAGE", "This rule can only send a message: drop --pause / --finish / --drop-loser.");
151
+ if (doing.dropLoser && condition !== "loser" && condition !== "winner") fail("USAGE", "--drop-loser goes with winner or loser.");
152
+ const cooldown = optional(flags, "cooldown");
153
+ return {
154
+ condition,
155
+ params,
156
+ actions: { notify: true, ...doing },
157
+ ...str(flags.name) ? { name: str(flags.name) } : {},
158
+ ...experiment ? { experiment } : {},
159
+ ...cooldown ? { cooldownHours: cooldown } : {},
160
+ enabled: !flags.disabled
161
+ };
162
+ }
163
+ async function load(t) {
164
+ return request(t, "/alerts");
165
+ }
166
+ function pickRule(rules, want) {
167
+ const w = want.toLowerCase();
168
+ const rule = rules.find((r) => r.id === want) ?? rules.find((r) => w.length >= 4 && r.id.startsWith(w)) ?? rules.find((r) => r.name.toLowerCase() === w);
169
+ if (!rule) fail("NOT_FOUND", `There's no alert rule "${want}".`, "See them with npx splithub alerts.");
170
+ return rule;
171
+ }
172
+ async function addRule(t, body) {
173
+ try {
174
+ return {
175
+ ...await request(t, "/alerts/rules", {
176
+ method: "POST",
177
+ body: JSON.stringify(body)
178
+ }),
179
+ savedOff: false
180
+ };
181
+ } catch (error) {
182
+ if (error instanceof CliError && error.code === "PRO_REQUIRED" && body.enabled !== false) {
183
+ return {
184
+ ...await request(t, "/alerts/rules", {
185
+ method: "POST",
186
+ body: JSON.stringify({ ...body, enabled: false })
187
+ }),
188
+ savedOff: true
189
+ };
190
+ }
191
+ throw error;
192
+ }
193
+ }
194
+ async function alerts(args, flags) {
195
+ const t = cloudOnly(flags, "Alerts", false);
196
+ if (!t.token) requireCloudToken(flags);
197
+ const [action, arg] = args;
198
+ if (!action || action === "list") return list(t, flags);
199
+ if (action === "add" || action === "create") {
200
+ if (!arg) fail("USAGE", `Which condition? npx splithub alerts add <condition>: ${ALERT_CONDITIONS.join(", ")}.`, "Example: npx splithub alerts add usage --every 1000");
201
+ const out2 = await addRule(t, ruleBody(arg, flags));
202
+ if (flags.json) return printJson(out2);
203
+ console.log(`${c.green("\u2714")} ${c.bold(out2.rule.name)} ${c.dim(`(${ruleTarget(out2.rule)})`)}`);
204
+ if (out2.savedOff) console.log(c.yellow("! Saved, switched off: alert rules run on Pro. Upgrade in the dashboard (Billing), then npx splithub alerts enable " + out2.rule.id.slice(0, 8)));
205
+ return;
206
+ }
207
+ if (!["enable", "disable", "delete", "remove", "test"].includes(action)) fail("USAGE", `Unknown "alerts ${action}". Use alerts, alerts add <condition>, alerts enable|disable|delete|test <id>.`);
208
+ if (!arg) fail("USAGE", `Which rule? npx splithub alerts ${action} <id> (ids are in npx splithub alerts).`);
209
+ const rule = pickRule((await load(t)).rules, arg);
210
+ const path = `/alerts/rules/${enc(rule.id)}`;
211
+ if (action === "test") {
212
+ const out2 = await request(t, `${path}/test`, { method: "POST", body: "{}" });
213
+ if (flags.json) return printJson({ rule: rule.id, ...out2 });
214
+ if (out2.matches.length === 0) return void console.log(c.dim(`${rule.name}: nothing matches right now, so it would stay quiet.`));
215
+ console.log(`${c.bold(rule.name)} would fire now:`);
216
+ for (const m of out2.matches) console.log(` ${m.experiment ? c.dim(`${m.experiment}: `) : ""}${m.message}`);
217
+ return;
218
+ }
219
+ if (action === "delete" || action === "remove") {
220
+ await request(t, path, { method: "DELETE" });
221
+ if (flags.json) return printJson({ ok: true, id: rule.id });
222
+ console.log(`${c.green("\u2714")} ${rule.name} deleted`);
223
+ return;
224
+ }
225
+ const out = await request(t, path, {
226
+ method: "PATCH",
227
+ body: JSON.stringify({ enabled: action === "enable" })
228
+ });
229
+ if (flags.json) return printJson(out);
230
+ console.log(`${c.green("\u2714")} ${rule.name} ${action === "enable" ? "is on" : "is off"}`);
231
+ }
232
+ async function list(t, flags) {
233
+ const data = await load(t);
234
+ if (flags.json)
235
+ return printJson({
236
+ plan: data.plan,
237
+ rules: data.rules,
238
+ channels: data.channels,
239
+ history: data.history
240
+ });
241
+ if (data.rules.length === 0) console.log(c.dim("No alert rules yet. Add one: npx splithub alerts add usage --every 1000"));
242
+ else {
243
+ console.log(
244
+ table(
245
+ ["RULE", "WHEN", "FOR", "PROGRESS", "STATUS", "ID"],
246
+ data.rules.map((r) => [c.bold(r.name), describeRule(r), ruleTarget(r), ruleProgress(r) || c.dim("\u2013"), r.enabled ? c.green("on") : c.dim("off"), c.dim(r.id.slice(0, 8))])
247
+ )
248
+ );
249
+ }
250
+ if (data.plan !== "pro" && data.rules.length) console.log(c.dim("\nAlert rules run on Pro: they fire once the project is on Pro (dashboard, Billing)."));
251
+ if (data.channels.length === 0) console.log(c.dim("Where alerts go (email, Slack, Discord, webhook) is set in the dashboard, under Alerts."));
252
+ if (data.history.length) {
253
+ console.log(`
254
+ ${c.bold("Recent alerts")}`);
255
+ for (const h of data.history.slice(0, 5)) console.log(`${c.dim(h.createdAt.slice(0, 16).replace("T", " "))} ${h.message}`);
256
+ }
257
+ }
258
+
259
+ export {
260
+ ALERT_CONDITIONS,
261
+ parseCount,
262
+ describeRule,
263
+ ruleTarget,
264
+ ruleProgress,
265
+ ruleBody,
266
+ pickRule,
267
+ addRule,
268
+ alerts
269
+ };
270
+ //# sourceMappingURL=chunk-SUUNAQAC.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/commands/alerts.ts"],"sourcesContent":["// splithub alerts — alert rules on SplitHub Cloud (they run on Pro): a message on the project's\n// channels (email, Slack, Discord, webhook) when something happens, and for experiments optionally\n// pause / finish / drop the losing variant.\n//\n// splithub alerts rules (what, for what, progress, on/off) and recent alerts\n// splithub alerts add <condition> [flags] e.g. alerts add usage --every 1000, alerts add winner --experiment hero\n// splithub alerts enable|disable|delete|test <id> id, the start of it, or the rule's name\n//\n// Conditions and their flags:\n// experiments srm | winner [--min-visitors] | loser --lift 10 [--min-visitors] | exposures --visitors N\n// | conversions --conversions N | duration --days N | no_events [--hours 24] (--experiment <key>, else every running one)\n// account quota [--percent 80] | usage --every 1000\n// analytics traffic_drop|traffic_spike --property <id> [--percent 50] | goal_silent --property <id> --goal <key> [--hours 24]\n// | event_count --property <id> [--event <name>] --count N [--repeat]\n// any rule --name \"...\" --cooldown <hours> --disabled; experiment rules also --pause --finish --drop-loser\n\nimport { request, requireCloudToken, type Target } from '../api';\nimport { CliError, fail, printJson } from '../errors';\nimport { c, table } from '../ui';\nimport { cloudOnly, n, str } from './analytics-reports';\nimport type { Flags } from './init';\n\nexport const ALERT_CONDITIONS = ['srm', 'winner', 'loser', 'exposures', 'conversions', 'duration', 'no_events', 'quota', 'usage', 'traffic_drop', 'traffic_spike', 'goal_silent', 'event_count'] as const;\nexport type AlertCondition = (typeof ALERT_CONDITIONS)[number];\nconst ACCOUNT: readonly string[] = ['quota', 'usage'];\nconst PROPERTY: readonly string[] = ['traffic_drop', 'traffic_spike', 'goal_silent', 'event_count'];\n\nexport interface AlertParams {\n minVisitors?: number;\n lift?: number;\n visitors?: number;\n conversions?: number;\n days?: number;\n hours?: number;\n percent?: number;\n property?: string;\n goal?: string;\n every?: number;\n event?: string;\n count?: number;\n repeat?: boolean;\n progress?: { total: number; fired: number; month?: string };\n}\n\nexport interface AlertRule {\n id: string;\n experiment: string | null;\n name: string;\n condition: AlertCondition;\n params: AlertParams;\n actions: { channels: string[]; pause: boolean; finish: boolean; dropLoser: boolean };\n enabled: boolean;\n cooldownHours: number;\n lastFiredAt: string | null;\n}\n\ninterface AlertsData {\n plan: string;\n rules: AlertRule[];\n channels: Array<{ id: string; type: string; name: string }>;\n history: Array<{\n id: string;\n experiment: string | null;\n kind: string;\n message: string;\n createdAt: string;\n ruleId: string | null;\n }>;\n}\n\nconst enc = encodeURIComponent;\n\n/** `1000`, `1,000`, `10k`, `1.5m` → a number; NaN otherwise. */\nexport function parseCount(v: unknown): number {\n if (typeof v !== 'string' || !v.trim()) return Number.NaN;\n const m = /^(\\d+(?:\\.\\d+)?)\\s*([km]?)$/i.exec(v.trim().replace(/[,_\\s](?=\\d)/g, ''));\n if (!m) return Number.NaN;\n return Math.round(Number(m[1]) * (m[2]?.toLowerCase() === 'k' ? 1_000 : m[2]?.toLowerCase() === 'm' ? 1_000_000 : 1));\n}\n\n/** What the rule watches, in one plain line. */\nexport function describeRule(r: Pick<AlertRule, 'condition' | 'params'>): string {\n const p = r.params;\n switch (r.condition) {\n case 'srm':\n return 'The split breaks (SRM)';\n case 'winner':\n return 'A clear winner';\n case 'loser':\n return `A variant ${p.lift ?? 0}%+ worse than control`;\n case 'exposures':\n return `${n(p.visitors ?? 0)} visitors reached`;\n case 'conversions':\n return `${n(p.conversions ?? 0)} conversions reached`;\n case 'duration':\n return `Running for ${p.days ?? 0} days`;\n case 'no_events':\n return `No visitors for ${p.hours ?? 24}h`;\n case 'quota':\n return `${p.percent ?? 80}% of the monthly allowance used`;\n case 'usage':\n return `Every ${n(p.every ?? 0)} events used`;\n case 'traffic_drop':\n return `Visitors down ${p.percent ?? 50}%+ vs a week before`;\n case 'traffic_spike':\n return `Visitors up ${p.percent ?? 50}%+ vs a week before`;\n case 'goal_silent':\n return `No ${p.goal ?? 'goal'} for ${p.hours ?? 24}h`;\n case 'event_count':\n return `${p.event ?? 'Any event'} ${p.repeat ? 'every' : 'reaches'} ${n(p.count ?? 0)}`;\n default:\n return r.condition;\n }\n}\n\n/** What the rule applies to. */\nexport function ruleTarget(r: Pick<AlertRule, 'condition' | 'params' | 'experiment'>): string {\n if (ACCOUNT.includes(r.condition)) return 'this project';\n if (PROPERTY.includes(r.condition)) return `property ${r.params.property ?? '?'}`;\n return r.experiment ? `experiment ${r.experiment}` : 'every running experiment';\n}\n\n/** Milestone rules: how far the count got. */\nexport function ruleProgress(r: Pick<AlertRule, 'condition' | 'params'>): string {\n const pr = r.params.progress;\n if (!pr) return '';\n if (r.condition === 'usage' && r.params.every) return `${n(pr.total)} used this month, next at ${n((pr.fired + 1) * r.params.every)}`;\n if (r.condition === 'event_count' && r.params.count) {\n if (!r.params.repeat && pr.fired > 0) return `${n(pr.total)} counted, done`;\n return `${n(pr.total)} of ${n((pr.fired + 1) * r.params.count)}`;\n }\n return '';\n}\n\nfunction count(flags: Flags, flag: string, why: string): number {\n const v = parseCount(flags[flag]);\n if (!Number.isFinite(v) || v <= 0) fail('USAGE', `--${flag} N: ${why}.`);\n return v;\n}\nconst optional = (flags: Flags, flag: string): number | undefined => {\n if (flags[flag] === undefined) return undefined;\n const v = parseCount(flags[flag]);\n if (!Number.isFinite(v) || v < 0) fail('INVALID_FLAG', `--${flag} ${String(flags[flag])}: a number.`);\n return v;\n};\n\n/** POST body of a new rule from the typed condition and flags. */\nexport function ruleBody(condition: string, flags: Flags): Record<string, unknown> {\n if (!(ALERT_CONDITIONS as readonly string[]).includes(condition)) fail('USAGE', `Which condition? One of ${ALERT_CONDITIONS.join(', ')}.`, 'Example: npx splithub alerts add usage --every 1000');\n const params: AlertParams = {};\n const property = str(flags.property);\n const needProperty = () => {\n if (!property) fail('USAGE', `--property <id>: which analytics property to watch.`);\n params.property = property;\n };\n switch (condition as AlertCondition) {\n case 'winner':\n case 'loser':\n if (optional(flags, 'min-visitors') !== undefined) params.minVisitors = optional(flags, 'min-visitors');\n if (condition === 'loser') params.lift = optional(flags, 'lift') ?? 10;\n break;\n case 'exposures':\n params.visitors = count(flags, 'visitors', 'alert once the experiment reaches this many visitors');\n break;\n case 'conversions':\n params.conversions = count(flags, 'conversions', 'alert once the experiment reaches this many conversions');\n break;\n case 'duration':\n params.days = count(flags, 'days', 'alert once the experiment has run this many days');\n break;\n case 'no_events':\n case 'goal_silent':\n params.hours = optional(flags, 'hours') ?? 24;\n if (condition === 'goal_silent') {\n needProperty();\n const goal = str(flags.goal);\n if (!goal) fail('USAGE', '--goal <key>: the goal that should keep converting.');\n params.goal = goal;\n }\n break;\n case 'quota':\n params.percent = optional(flags, 'percent') ?? 80;\n break;\n case 'usage':\n params.every = count(flags, 'every', 'alert each time this many more events are used this month (100 or more)');\n if (params.every < 100) fail('INVALID_FLAG', '--every: 100 or more.');\n break;\n case 'traffic_drop':\n case 'traffic_spike':\n needProperty();\n params.percent = optional(flags, 'percent') ?? 50;\n break;\n case 'event_count':\n needProperty();\n if (str(flags.event)) params.event = str(flags.event);\n params.count = count(flags, 'count', 'alert when the event reaches this many');\n params.repeat = Boolean(flags.repeat);\n break;\n case 'srm':\n break;\n }\n const experiment = str(flags.experiment);\n if (experiment && (ACCOUNT.includes(condition) || PROPERTY.includes(condition))) fail('USAGE', `${condition} is not about one experiment: drop --experiment.`);\n const doing = {\n pause: Boolean(flags.pause),\n finish: Boolean(flags.finish),\n dropLoser: Boolean(flags['drop-loser']),\n };\n if ((doing.pause || doing.finish || doing.dropLoser) && (ACCOUNT.includes(condition) || PROPERTY.includes(condition))) fail('USAGE', 'This rule can only send a message: drop --pause / --finish / --drop-loser.');\n if (doing.dropLoser && condition !== 'loser' && condition !== 'winner') fail('USAGE', '--drop-loser goes with winner or loser.');\n const cooldown = optional(flags, 'cooldown');\n return {\n condition,\n params,\n actions: { notify: true, ...doing },\n ...(str(flags.name) ? { name: str(flags.name) } : {}),\n ...(experiment ? { experiment } : {}),\n ...(cooldown ? { cooldownHours: cooldown } : {}),\n enabled: !flags.disabled,\n };\n}\n\nasync function load(t: Target): Promise<AlertsData> {\n return request<AlertsData>(t, '/alerts');\n}\n\n/** A rule by id, the start of its id, or its name. */\nexport function pickRule(rules: AlertRule[], want: string): AlertRule {\n const w = want.toLowerCase();\n const rule = rules.find((r) => r.id === want) ?? rules.find((r) => w.length >= 4 && r.id.startsWith(w)) ?? rules.find((r) => r.name.toLowerCase() === w);\n if (!rule) fail('NOT_FOUND', `There's no alert rule \"${want}\".`, 'See them with npx splithub alerts.');\n return rule;\n}\n\nexport async function addRule(t: Target, body: Record<string, unknown>): Promise<{ rule: AlertRule; savedOff: boolean }> {\n try {\n return {\n ...(await request<{ rule: AlertRule }>(t, '/alerts/rules', {\n method: 'POST',\n body: JSON.stringify(body),\n })),\n savedOff: false,\n };\n } catch (error) {\n // Free plan: keep the rule, switched off, so upgrading is the only step left.\n if (error instanceof CliError && error.code === 'PRO_REQUIRED' && body.enabled !== false) {\n return {\n ...(await request<{ rule: AlertRule }>(t, '/alerts/rules', {\n method: 'POST',\n body: JSON.stringify({ ...body, enabled: false }),\n })),\n savedOff: true,\n };\n }\n throw error;\n }\n}\n\nexport async function alerts(args: string[], flags: Flags): Promise<void> {\n const t = cloudOnly(flags, 'Alerts', false);\n if (!t.token) requireCloudToken(flags);\n const [action, arg] = args;\n if (!action || action === 'list') return list(t, flags);\n if (action === 'add' || action === 'create') {\n if (!arg) fail('USAGE', `Which condition? npx splithub alerts add <condition>: ${ALERT_CONDITIONS.join(', ')}.`, 'Example: npx splithub alerts add usage --every 1000');\n const out = await addRule(t, ruleBody(arg, flags));\n if (flags.json) return printJson(out);\n console.log(`${c.green('✔')} ${c.bold(out.rule.name)} ${c.dim(`(${ruleTarget(out.rule)})`)}`);\n if (out.savedOff) console.log(c.yellow('! Saved, switched off: alert rules run on Pro. Upgrade in the dashboard (Billing), then npx splithub alerts enable ' + out.rule.id.slice(0, 8)));\n return;\n }\n if (!['enable', 'disable', 'delete', 'remove', 'test'].includes(action)) fail('USAGE', `Unknown \"alerts ${action}\". Use alerts, alerts add <condition>, alerts enable|disable|delete|test <id>.`);\n if (!arg) fail('USAGE', `Which rule? npx splithub alerts ${action} <id> (ids are in npx splithub alerts).`);\n const rule = pickRule((await load(t)).rules, arg);\n const path = `/alerts/rules/${enc(rule.id)}`;\n if (action === 'test') {\n const out = await request<{ matches: Array<{ experiment: string | null; message: string }> }>(t, `${path}/test`, { method: 'POST', body: '{}' });\n if (flags.json) return printJson({ rule: rule.id, ...out });\n if (out.matches.length === 0) return void console.log(c.dim(`${rule.name}: nothing matches right now, so it would stay quiet.`));\n console.log(`${c.bold(rule.name)} would fire now:`);\n for (const m of out.matches) console.log(` ${m.experiment ? c.dim(`${m.experiment}: `) : ''}${m.message}`);\n return;\n }\n if (action === 'delete' || action === 'remove') {\n await request(t, path, { method: 'DELETE' });\n if (flags.json) return printJson({ ok: true, id: rule.id });\n console.log(`${c.green('✔')} ${rule.name} deleted`);\n return;\n }\n const out = await request<{ rule: AlertRule }>(t, path, {\n method: 'PATCH',\n body: JSON.stringify({ enabled: action === 'enable' }),\n });\n if (flags.json) return printJson(out);\n console.log(`${c.green('✔')} ${rule.name} ${action === 'enable' ? 'is on' : 'is off'}`);\n}\n\nasync function list(t: Target, flags: Flags): Promise<void> {\n const data = await load(t);\n if (flags.json)\n return printJson({\n plan: data.plan,\n rules: data.rules,\n channels: data.channels,\n history: data.history,\n });\n if (data.rules.length === 0) console.log(c.dim('No alert rules yet. Add one: npx splithub alerts add usage --every 1000'));\n else {\n console.log(\n table(\n ['RULE', 'WHEN', 'FOR', 'PROGRESS', 'STATUS', 'ID'],\n data.rules.map((r) => [c.bold(r.name), describeRule(r), ruleTarget(r), ruleProgress(r) || c.dim('–'), r.enabled ? c.green('on') : c.dim('off'), c.dim(r.id.slice(0, 8))])\n )\n );\n }\n if (data.plan !== 'pro' && data.rules.length) console.log(c.dim('\\nAlert rules run on Pro: they fire once the project is on Pro (dashboard, Billing).'));\n if (data.channels.length === 0) console.log(c.dim('Where alerts go (email, Slack, Discord, webhook) is set in the dashboard, under Alerts.'));\n if (data.history.length) {\n console.log(`\\n${c.bold('Recent alerts')}`);\n for (const h of data.history.slice(0, 5)) console.log(`${c.dim(h.createdAt.slice(0, 16).replace('T', ' '))} ${h.message}`);\n }\n}\n"],"mappings":"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","names":["out"]}
@@ -5,21 +5,21 @@ import {
5
5
  loadConfig,
6
6
  readSource,
7
7
  writeConfigChecked
8
- } from "./chunk-J5ZUSS43.js";
8
+ } from "./chunk-ILEPMQNT.js";
9
+ import {
10
+ detectProject,
11
+ requireConfig
12
+ } from "./chunk-MUDDASN6.js";
9
13
  import {
10
14
  apiError,
11
15
  cloudTarget,
12
16
  requireCloudToken
13
- } from "./chunk-4YXB73AZ.js";
14
- import {
15
- detectProject,
16
- requireConfig
17
- } from "./chunk-4LE4SCWY.js";
17
+ } from "./chunk-4OQEIP33.js";
18
18
  import {
19
19
  c,
20
20
  fail,
21
21
  printJson
22
- } from "./chunk-PP3RLIJP.js";
22
+ } from "./chunk-ZISCJRR5.js";
23
23
 
24
24
  // src/commands/push.ts
25
25
  import { relative } from "path";
@@ -70,9 +70,11 @@ async function adoptCloudExperiments(file, cloudOnly) {
70
70
  }
71
71
  return written;
72
72
  }
73
- function configDiff(local, cloud) {
73
+ function configDiff(local, cloud, prune = false) {
74
74
  const added = local.filter((e) => !cloud.some((x) => x.key === e.key)).map((e) => e.key);
75
- const removed = cloud.filter((x) => x.origin !== "dashboard" && !local.some((e) => e.key === x.key)).map((x) => x.key);
75
+ const missing = cloud.filter((x) => x.origin !== "dashboard" && !local.some((e) => e.key === x.key)).map((x) => x.key);
76
+ const removed = prune ? missing : [];
77
+ const kept = prune ? [] : missing;
76
78
  const changed = [];
77
79
  for (const e of local) {
78
80
  const x = cloud.find((y) => y.key === e.key);
@@ -85,16 +87,16 @@ function configDiff(local, cloud) {
85
87
  if ((x.traffic ?? 1) !== (e.traffic ?? 1)) fields.push("traffic");
86
88
  if (fields.length) changed.push({ experiment: e.key, fields });
87
89
  }
88
- return { added, removed, changed };
90
+ return { added, removed, kept, changed };
89
91
  }
90
92
  var keyList = (v) => typeof v === "string" ? v.split(",").map((k) => k.trim()).filter(Boolean) : [];
91
93
  function keyConflict(conflicts) {
92
- const why = conflicts.map((k) => k.reason === "dashboard" ? `${k.key} (a different test made in the dashboard)` : `${k.key} (an earlier test, ${(k.exposures ?? 0).toLocaleString("en-US")} visitors)`);
94
+ const why = conflicts.map((k) => k.reason === "dashboard" ? `${k.key} (a different experiment made in the dashboard)` : `${k.key} (an earlier experiment, ${(k.exposures ?? 0).toLocaleString("en-US")} visitors)`);
93
95
  const keys = conflicts.map((k) => k.key).join(",");
94
96
  fail(
95
97
  "KEY_CONFLICT",
96
- `These keys already belong to another test in the cloud: ${why.join("; ")}. Nothing was pushed.`,
97
- `New test: rename its key, or run npx splithub push --replace ${keys} (the old numbers are cleared). Same test: npx splithub push --same ${keys}.`
98
+ `These keys already belong to another experiment in the cloud: ${why.join("; ")}. Nothing was pushed.`,
99
+ `New experiment: rename its key, or run npx splithub push --replace ${keys} (the old numbers are cleared). Same experiment: npx splithub push --same ${keys}.`
98
100
  );
99
101
  }
100
102
  async function cloudFetch(url, init) {
@@ -115,11 +117,11 @@ async function push(flags) {
115
117
  const res = await cloudFetch(`${target.url}/config`, {
116
118
  method: "PUT",
117
119
  headers: { authorization: `Bearer ${target.token}`, "content-type": "application/json" },
118
- body: JSON.stringify({ config, replace: keyList(flags.replace), same: keyList(flags.same) })
120
+ body: JSON.stringify({ config, replace: keyList(flags.replace), same: keyList(flags.same), prune: Boolean(flags.prune) })
119
121
  });
120
122
  const body = await res.json().catch(() => ({}));
121
123
  if (res.status === 409 && body.code === "key_conflict" && body.conflicts?.length) keyConflict(body.conflicts);
122
- if (res.status === 409 && body.code === "key_deleted") fail("KEY_DELETED", `${body.error ?? "A deleted test used one of these keys"}. Nothing was pushed.`, "Give the test a new key in splithub.config.ts and push again.");
124
+ if (res.status === 409 && body.code === "key_deleted") fail("KEY_DELETED", `${body.error ?? "A deleted experiment used one of these keys"}. Nothing was pushed.`, "Give the experiment a new key in splithub.config.ts and push again.");
123
125
  if (!res.ok) throw apiError(res.status, body, `${target.url}/config responded ${res.status}`);
124
126
  let keyWritten = false;
125
127
  if (body.publicKey && !config.storage.key) {
@@ -137,6 +139,7 @@ async function push(flags) {
137
139
  return;
138
140
  }
139
141
  console.log(`${c.green("\u2714")} pushed ${c.bold(String(body.project))} v${body.version} \xB7 ${body.experiments} experiment(s) \u2192 ${target.url}`);
142
+ if (body.kept?.length) console.log(c.yellow(`! kept in the cloud, not in ${out.configFile}: ${body.kept.join(", ")}. They go on as they are; npx splithub push --prune removes them.`));
140
143
  if (adopted.length) console.log(`${c.green("\u2714")} written into ${out.configFile} from the dashboard: ${adopted.join(", ")} (wire them in code if they are value/component experiments)`);
141
144
  if (body.publicKey) {
142
145
  console.log(keyWritten ? `${c.green("\u2714")} public key written to ${out.configFile}` : `${c.dim("public key:")} ${body.publicKey}`);
@@ -152,9 +155,10 @@ async function dryRun(flags, config) {
152
155
  if (target.token) {
153
156
  const res = await cloudFetch(`${target.url}/config`, { headers: { authorization: `Bearer ${target.token}` } });
154
157
  const body = await res.json().catch(() => ({}));
155
- if (res.status === 404 || res.status === 409) diff = configDiff(config.experiments, []);
158
+ const prune = Boolean(flags.prune);
159
+ if (res.status === 404 || res.status === 409) diff = configDiff(config.experiments, [], prune);
156
160
  else if (!res.ok) throw apiError(res.status, body, `${target.url}/config responded ${res.status}`);
157
- else diff = configDiff(config.experiments, body.config?.experiments ?? []);
161
+ else diff = configDiff(config.experiments, body.config?.experiments ?? [], prune);
158
162
  cloud = "compared";
159
163
  }
160
164
  }
@@ -165,11 +169,12 @@ async function dryRun(flags, config) {
165
169
  }
166
170
  console.log(`${c.green("\u2714")} config loads \xB7 ${experiments.length} experiment(s) \xB7 ${config.storage.mode} mode`);
167
171
  if (!diff) console.log(c.dim(cloud === "self mode" ? "Self mode: nothing to push." : "Not connected, so nothing to compare. Run npx splithub login."));
168
- else if (!diff.added.length && !diff.removed.length && !diff.changed.length) console.log(c.dim("The cloud already has this config."));
172
+ else if (!diff.added.length && !diff.removed.length && !diff.kept.length && !diff.changed.length) console.log(c.dim("The cloud already has this config."));
169
173
  else {
170
174
  for (const k of diff.added) console.log(`${c.green("+")} ${k}`);
171
175
  for (const k of diff.removed) console.log(`${c.red("-")} ${k}`);
172
176
  for (const ch of diff.changed) console.log(`${c.yellow("~")} ${ch.experiment} ${c.dim(`(${ch.fields.join(", ")})`)}`);
177
+ for (const k of diff.kept) console.log(c.dim(`= ${k} (in the cloud only: kept; --prune removes it)`));
173
178
  }
174
179
  }
175
180
  async function pull(flags) {
@@ -195,4 +200,4 @@ export {
195
200
  push,
196
201
  pull
197
202
  };
198
- //# sourceMappingURL=chunk-JBPVGBLN.js.map
203
+ //# sourceMappingURL=chunk-U7Z5VYNX.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/commands/push.ts"],"sourcesContent":["import type { SplitHubConfig } from '@splithub/core';\nimport { relative } from 'node:path';\nimport { apiError, cloudTarget, requireCloudToken } from '../api';\nimport { hasExperiment, insertExperiment, loadConfig, readSource, writeConfigChecked } from '../config-file';\nimport { fail, printJson } from '../errors';\nimport { detectProject, requireConfig } from '../project';\nimport { c } from '../ui';\nimport type { Flags } from './init';\n\nexport interface CloudExperiment {\n key: string;\n kind: 'component' | 'value' | 'redirect' | 'mvt';\n status: 'draft' | 'running' | 'paused' | 'finished';\n goal: string | null;\n match: string | null;\n name?: string;\n description: string | null;\n variants: Array<{ key: string; weight: number; value?: unknown; to?: string; levels?: Record<string, string> }>;\n /** Multivariate: the factors whose combinations the variants are. */\n factors?: Array<{ key: string; levels: string[] }>;\n flow?: unknown;\n traffic?: number;\n maxExposures?: number | null;\n minDays?: number | null;\n goodSample?: number | null;\n schedule?: { startAt?: string | null; endAt?: string | null } | null;\n}\n\ninterface PushResponse {\n ok: boolean;\n project: string;\n version: number;\n pushedAt: string;\n publicKey: string;\n experiments: number;\n /** Experiments created in the dashboard that the local file does not have yet. */\n cloudOnly?: CloudExperiment[];\n /** Experiments from an earlier push that the file lacks, left in the cloud as they are; `--prune` removes them. */\n kept?: string[];\n}\n\n/** Write dashboard-created experiments into the local config file. Returns the keys written. */\n/** Factor → level → value, read back from the combinations the cloud generated. */\nfunction factorsOf(e: CloudExperiment): Record<string, Record<string, string>> {\n const out: Record<string, Record<string, string>> = {};\n for (const f of e.factors ?? []) {\n out[f.key] = {};\n for (const level of f.levels) {\n const combo = e.variants.find((v) => v.levels?.[f.key] === level);\n const value = (combo?.value as Record<string, unknown> | undefined)?.[f.key];\n out[f.key]![level] = typeof value === 'string' ? value : value === undefined ? level : JSON.stringify(value);\n }\n }\n return out;\n}\n\nasync function adoptCloudExperiments(file: string, cloudOnly: CloudExperiment[] | undefined): Promise<string[]> {\n if (!cloudOnly || cloudOnly.length === 0) return [];\n const original = readSource(file);\n let source = original;\n const written: string[] = [];\n for (const e of cloudOnly) {\n if (hasExperiment(source, e.key)) continue;\n const total = e.variants.reduce((s, v) => s + v.weight, 0) || 1;\n source = insertExperiment(source, {\n key: e.key,\n kind: e.kind,\n status: e.status,\n goal: e.goal ?? undefined,\n match: e.match ?? undefined,\n name: e.name,\n description: e.description ?? undefined,\n flow: e.flow ?? undefined,\n traffic: e.traffic,\n maxExposures: e.maxExposures ?? undefined,\n minDays: e.minDays ?? undefined,\n goodSample: e.goodSample ?? undefined,\n schedule: e.schedule ?? undefined,\n variants: e.variants.map((v) => ({ key: v.key, weight: Math.round((v.weight / total) * 100), value: typeof v.value === 'string' ? v.value : v.value === undefined ? undefined : JSON.stringify(v.value), to: v.to })),\n ...(e.kind === 'mvt' && e.factors ? { factors: factorsOf(e) } : {}),\n });\n written.push(e.key);\n }\n if (written.length) {\n await writeConfigChecked(file, original, source, (config) => {\n const missing = written.filter((k) => !config.experiments.some((x) => x.key === k));\n return missing.length ? `${missing.join(', ')} did not load back` : null;\n });\n }\n return written;\n}\n\ntype LocalExperiment = SplitHubConfig['experiments'][number];\n\nexport interface ConfigDiff {\n added: string[];\n removed: string[];\n /** In the cloud only; a push without `--prune` leaves them. */\n kept: string[];\n changed: Array<{ experiment: string; fields: string[] }>;\n}\n\n/** What a push would change in the cloud, by experiment key. */\nexport function configDiff(local: LocalExperiment[], cloud: Array<CloudExperiment & { origin?: string }>, prune = false): ConfigDiff {\n const added = local.filter((e) => !cloud.some((x) => x.key === e.key)).map((e) => e.key);\n const missing = cloud.filter((x) => x.origin !== 'dashboard' && !local.some((e) => e.key === x.key)).map((x) => x.key);\n const removed = prune ? missing : [];\n const kept = prune ? [] : missing;\n const changed: ConfigDiff['changed'] = [];\n for (const e of local) {\n const x = cloud.find((y) => y.key === e.key);\n if (!x) continue;\n const fields: string[] = [];\n if (x.status !== e.status) fields.push('status');\n if ((x.goal ?? null) !== (e.goal ?? null)) fields.push('goal');\n if (x.kind !== e.kind) fields.push('kind');\n if (x.variants.map((v) => `${v.key}:${v.weight}`).join() !== e.variants.map((v) => `${v.key}:${v.weight}`).join()) fields.push('variants');\n if ((x.traffic ?? 1) !== (e.traffic ?? 1)) fields.push('traffic');\n if (fields.length) changed.push({ experiment: e.key, fields });\n }\n return { added, removed, kept, changed };\n}\n\ninterface KeyConflict {\n key: string;\n reason: 'dashboard' | 'old_data';\n exposures?: number;\n}\n\nconst keyList = (v: Flags[string]): string[] => (typeof v === 'string' ? v.split(',').map((k) => k.trim()).filter(Boolean) : []);\n\n/** The cloud already has another test under a pushed key: say which, and the two ways on. */\nfunction keyConflict(conflicts: KeyConflict[]): never {\n const why = conflicts.map((k) => (k.reason === 'dashboard' ? `${k.key} (a different experiment made in the dashboard)` : `${k.key} (an earlier experiment, ${(k.exposures ?? 0).toLocaleString('en-US')} visitors)`));\n const keys = conflicts.map((k) => k.key).join(',');\n fail(\n 'KEY_CONFLICT',\n `These keys already belong to another experiment in the cloud: ${why.join('; ')}. Nothing was pushed.`,\n `New experiment: rename its key, or run npx splithub push --replace ${keys} (the old numbers are cleared). Same experiment: npx splithub push --same ${keys}.`\n );\n}\n\nasync function cloudFetch(url: string, init: RequestInit): Promise<Response> {\n try {\n return await fetch(url, init);\n } catch (error) {\n fail('UNREACHABLE', `Can't reach ${url}: ${error instanceof Error ? error.message : String(error)}.`, 'Check your connection, or --api / SPLITHUB_API.');\n }\n}\n\n/**\n * `splithub push`: upload the normalized splithub.config.ts to SplitHub Cloud.\n * Needs a project API key (sk_...) via --token or SPLITHUB_API_KEY. The first\n * push returns the public key (pk_...) which is written into the config's\n * `storage.key` when it is still empty. `--dry-run` only checks and compares.\n * Experiments the cloud has from an earlier push that the file lacks are kept\n * unless `--prune`.\n */\nexport async function push(flags: Flags): Promise<void> {\n const project = requireConfig();\n const config = await loadConfig(project.configFile);\n if (flags['dry-run']) return dryRun(flags, config);\n if (config.storage.mode !== 'cloud') {\n fail('NOT_CLOUD', `This project stores events itself (storage.mode is \"${config.storage.mode}\"), so there's nothing to push.`, \"Set storage: { mode: 'cloud' } in splithub.config.ts to use SplitHub Cloud.\");\n }\n const target = requireCloudToken(flags);\n\n const res = await cloudFetch(`${target.url}/config`, {\n method: 'PUT',\n headers: { authorization: `Bearer ${target.token}`, 'content-type': 'application/json' },\n body: JSON.stringify({ config, replace: keyList(flags.replace), same: keyList(flags.same), prune: Boolean(flags.prune) }),\n });\n const body = (await res.json().catch(() => ({}))) as Partial<PushResponse> & { error?: string; code?: string; conflicts?: KeyConflict[] };\n if (res.status === 409 && body.code === 'key_conflict' && body.conflicts?.length) keyConflict(body.conflicts);\n if (res.status === 409 && body.code === 'key_deleted') fail('KEY_DELETED', `${body.error ?? 'A deleted experiment used one of these keys'}. Nothing was pushed.`, 'Give the experiment a new key in splithub.config.ts and push again.');\n if (!res.ok) throw apiError(res.status, body, `${target.url}/config responded ${res.status}`);\n\n // Write the public key into the config when it is missing.\n let keyWritten = false;\n if (body.publicKey && !config.storage.key) {\n const source = readSource(project.configFile);\n const updated = source.replace(/(mode\\s*:\\s*['\"]cloud['\"]\\s*)(,?)(\\s*\\})/, (_m, a: string, _comma: string, b: string) => `${a}, key: '${body.publicKey}'${b}`);\n if (updated !== source) {\n await writeConfigChecked(project.configFile, source, updated, (loaded) => (loaded.storage.mode === 'cloud' && loaded.storage.key === body.publicKey ? null : 'storage.key did not load back'));\n keyWritten = true;\n }\n }\n\n const adopted = await adoptCloudExperiments(project.configFile, body.cloudOnly);\n const out = { ...body, configFile: relative(project.root, project.configFile), keyWritten, adopted };\n if (flags.json) {\n printJson(out);\n return;\n }\n console.log(`${c.green('✔')} pushed ${c.bold(String(body.project))} v${body.version} · ${body.experiments} experiment(s) → ${target.url}`);\n if (body.kept?.length) console.log(c.yellow(`! kept in the cloud, not in ${out.configFile}: ${body.kept.join(', ')}. They go on as they are; npx splithub push --prune removes them.`));\n if (adopted.length) console.log(`${c.green('✔')} written into ${out.configFile} from the dashboard: ${adopted.join(', ')} (wire them in code if they are value/component experiments)`);\n if (body.publicKey) {\n console.log(keyWritten ? `${c.green('✔')} public key written to ${out.configFile}` : `${c.dim('public key:')} ${body.publicKey}`);\n if (!keyWritten && !config.storage.key) console.log(c.yellow(`Add it to splithub.config.ts: storage: { mode: 'cloud', key: '${body.publicKey}' }`));\n }\n}\n\n/** `push --dry-run`: the config loads; when connected, what a push would change. Writes nothing. */\nasync function dryRun(flags: Flags, config: SplitHubConfig): Promise<void> {\n const experiments = config.experiments.map((e) => ({ experiment: e.key, kind: e.kind, status: e.status, goal: e.goal ?? null }));\n let diff: ConfigDiff | null = null;\n let cloud: 'compared' | 'not connected' | 'self mode' = config.storage.mode === 'cloud' ? 'not connected' : 'self mode';\n if (config.storage.mode === 'cloud') {\n const target = cloudTarget(flags);\n if (target.token) {\n const res = await cloudFetch(`${target.url}/config`, { headers: { authorization: `Bearer ${target.token}` } });\n const body = (await res.json().catch(() => ({}))) as { config?: { experiments?: CloudExperiment[] } };\n const prune = Boolean(flags.prune);\n if (res.status === 404 || res.status === 409) diff = configDiff(config.experiments, [], prune);\n else if (!res.ok) throw apiError(res.status, body, `${target.url}/config responded ${res.status}`);\n else diff = configDiff(config.experiments, body.config?.experiments ?? [], prune);\n cloud = 'compared';\n }\n }\n const out = { ok: true, dryRun: true, mode: config.storage.mode, project: config.project, experiments, cloud, diff };\n if (flags.json) {\n printJson(out);\n return;\n }\n console.log(`${c.green('✔')} config loads · ${experiments.length} experiment(s) · ${config.storage.mode} mode`);\n if (!diff) console.log(c.dim(cloud === 'self mode' ? 'Self mode: nothing to push.' : 'Not connected, so nothing to compare. Run npx splithub login.'));\n else if (!diff.added.length && !diff.removed.length && !diff.kept.length && !diff.changed.length) console.log(c.dim('The cloud already has this config.'));\n else {\n for (const k of diff.added) console.log(`${c.green('+')} ${k}`);\n for (const k of diff.removed) console.log(`${c.red('-')} ${k}`);\n for (const ch of diff.changed) console.log(`${c.yellow('~')} ${ch.experiment} ${c.dim(`(${ch.fields.join(', ')})`)}`);\n for (const k of diff.kept) console.log(c.dim(`= ${k} (in the cloud only: kept; --prune removes it)`));\n }\n}\n\n/** `splithub pull`: print the config stored in the cloud (for inspection or recovery). */\nexport async function pull(flags: Flags): Promise<void> {\n const target = requireCloudToken(flags);\n const res = await cloudFetch(`${target.url}/config`, { headers: { authorization: `Bearer ${target.token}` } });\n const body = (await res.json().catch(() => ({}))) as { error?: string; config?: { experiments?: Array<CloudExperiment & { origin?: string }> }; version?: number; pushedAt?: string; publicKey?: string };\n if (!res.ok) throw apiError(res.status, body, `${target.url}/config responded ${res.status}`);\n const project = detectProject();\n const dashboardOnes = (body.config?.experiments ?? []).filter((e) => e.origin === 'dashboard');\n const adopted = project.configFile ? await adoptCloudExperiments(project.configFile, dashboardOnes) : [];\n if (flags.json) {\n printJson({ ...body, adopted });\n return;\n }\n console.log(`${c.bold('cloud config')} v${body.version} ${c.dim(`pushed ${body.pushedAt}`)} · public key ${body.publicKey}`);\n if (adopted.length) console.log(`${c.green('✔')} written into ${relative(project.root, project.configFile ?? '')}: ${adopted.join(', ')}`);\n else if (dashboardOnes.length) console.log(c.dim(`dashboard experiments already present locally: ${dashboardOnes.map((e) => e.key).join(', ')}`));\n else console.log(c.dim('no dashboard-created experiments to pull'));\n}\n"],"mappings":"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","names":[]}