@superwall/cli 2.0.0 → 2.1.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 (142) hide show
  1. package/README.md +3 -2
  2. package/dist/{apple-CkKlHBZ9.js → apple-BHbX0jbn.js} +13 -13
  3. package/dist/auth.d.ts +1 -1
  4. package/dist/auth.js +3 -3
  5. package/dist/{billing-XCZU_T46.js → billing-4zhIBFRQ.js} +3 -3
  6. package/dist/{bind-drne__Ys.js → bind-CHLHmxgA.js} +4 -4
  7. package/dist/{build-Gpdq5QXP.js → build-5PQeSnNN.js} +6 -6
  8. package/dist/{client-DP6Rc0t_.js → client-BIvOmWPC.js} +7 -3
  9. package/dist/{create-BBrtgUgS.js → create-BSNIFsnN.js} +6 -6
  10. package/dist/{create-Cwc3SRWJ.js → create-VK-pNfN7.js} +23 -23
  11. package/dist/create-oj3zXvHZ.js +19 -0
  12. package/dist/{doctor-C9ldpPFC.js → doctor-9JS96QkX.js} +6 -6
  13. package/dist/{drivers-DNrx4LWA.js → drivers-BamBJ10Y.js} +3 -3
  14. package/dist/entry.js +20 -21
  15. package/dist/{environment-DF1qKlny.js → environment-eV7LEnSN.js} +15 -2
  16. package/dist/{existing-78LWSsqS.js → existing-C8dSYHGk.js} +2 -2
  17. package/dist/{held-Cy8Wl4D1.js → held-BMisHn8F.js} +6 -6
  18. package/dist/held-DeJW2gUk.js +16 -0
  19. package/dist/{integrate-DcJhpXy8.js → integrate-VWtTNPCr.js} +22 -22
  20. package/dist/login-2JHCG6c1.js +16 -0
  21. package/dist/{login-D0lh3_JI.js → login-BimbukE5.js} +5 -5
  22. package/dist/{login-B2TsCE2H.js → login-BmwG14LC.js} +1 -1
  23. package/dist/{lookup-D-nmmAbw.js → lookup-k9EeOiZr.js} +2 -2
  24. package/dist/{migrate-Cfec564E.js → migrate-C86h6jeF.js} +22 -22
  25. package/dist/{notification-url-YDbq6FMA.js → notification-url-BVaTgWZ5.js} +2 -2
  26. package/dist/{open-Ba2vBl1_.js → open-0tDCQOXC.js} +10 -10
  27. package/dist/{org-D0g_q3mv.js → org-DUwdrKPV.js} +2 -2
  28. package/dist/{paths-DxSLdpOI.js → paths-BCbjCLP5.js} +1 -1
  29. package/dist/{playbook-DIeb7hne.js → playbook-oov9yV0q.js} +10 -10
  30. package/dist/{promote-COD4fYdz.js → promote-DPGPamkE.js} +16 -16
  31. package/dist/push-Chp21y3a.js +22 -0
  32. package/dist/{push-CncywhkQ.js → push-Cz4lJ8Qd.js} +27 -14
  33. package/dist/{registry-DSrosOYs.js → registry-CTczUigi.js} +525 -179
  34. package/dist/{resources-Dqr01Dep.js → resources-B1qKDVXd.js} +18 -6
  35. package/dist/{run-C9qg_QlC.js → run-DTPsVmFw.js} +2 -2
  36. package/dist/scan-B1SkkUi7.js +4 -0
  37. package/dist/{scan-DLrsrFS9.js → scan-Bb48xZqB.js} +1 -1
  38. package/dist/{scope-V336uz8j.js → scope-B6UYGuwn.js} +4 -4
  39. package/dist/{selection-Rdw-ZUoG.js → selection-BbNk9r1q.js} +10 -4
  40. package/dist/server-CwrZ-I1r.js +22 -0
  41. package/dist/{server-D0tGG8C4.js → server-EYBMKAG1.js} +10 -8
  42. package/dist/{session-D_nEWKXT.js → session-Crg9X-FI.js} +41 -13
  43. package/dist/session-DItGa4z0.js +6 -0
  44. package/dist/{session-CFAmMhem.js → session-xG9E8J2N.js} +1 -1
  45. package/dist/skills/superwall-framework/SKILL.md +43 -7
  46. package/dist/skills/superwall-framework/references/cli.md +1 -0
  47. package/dist/skills/superwall-framework/references/examples.md +1 -0
  48. package/dist/skills/superwall-framework/references/layout.md +34 -1
  49. package/dist/skills/superwall-framework/references/migrate-from-editor.md +16 -3
  50. package/dist/{skills-BvFOa4y6.js → skills-BdMKE2uO.js} +5 -4
  51. package/dist/{skills-DMG4bpKk.js → skills-Dg3k6TRC.js} +8 -8
  52. package/dist/{spinner-CneRK5rk.js → spinner-Ba3XhlMb.js} +3 -3
  53. package/dist/{storage-s2Dnz-yl.js → storage-DIkYajce.js} +1 -1
  54. package/dist/{storekit-yY_kS2iR.js → storekit-C2UzIIMs.js} +3 -3
  55. package/dist/storekit-DHNxDDpA.js +16 -0
  56. package/dist/{telemetry-DtG92m5O.js → telemetry-CVP8O6Y3.js} +1 -1
  57. package/dist/{token-DzRh7dI1.js → token-IWv2httm.js} +1 -1
  58. package/dist/tools-skills/animate-onboarding/SKILL.md +467 -0
  59. package/dist/tools-skills/animate-onboarding/references/engine.md +494 -0
  60. package/dist/tools-skills/animate-onboarding/references/framework/Question.tsx +71 -0
  61. package/dist/tools-skills/animate-onboarding/references/framework/README.md +40 -0
  62. package/dist/tools-skills/animate-onboarding/references/framework/answers.ts +19 -0
  63. package/dist/tools-skills/animate-onboarding/references/framework/flow.ts +80 -0
  64. package/dist/tools-skills/animate-onboarding/references/framework/handoffs.ts +869 -0
  65. package/dist/tools-skills/animate-onboarding/references/framework/layout.tsx +113 -0
  66. package/dist/tools-skills/animate-onboarding/references/framework/motion.css +559 -0
  67. package/dist/tools-skills/animate-onboarding/references/framework/useStoryRouter.ts +48 -0
  68. package/dist/tools-skills/animate-onboarding/references/handoffs.md +375 -0
  69. package/dist/tools-skills/animate-onboarding/references/imageReady.ts +92 -0
  70. package/dist/tools-skills/animate-onboarding/references/morphFrame.ts +356 -0
  71. package/dist/tools-skills/animate-onboarding/references/performance.md +41 -0
  72. package/dist/tools-skills/animate-onboarding/references/web-runtime/README.md +17 -0
  73. package/dist/tools-skills/animate-onboarding/references/web-runtime/handoffs.ts +858 -0
  74. package/dist/tools-skills/animate-onboarding/references/web-runtime/story-motion.css +301 -0
  75. package/dist/tools-skills/mobile-design/SKILL.md +447 -0
  76. package/dist/tools-skills/mobile-design/references/responsive.md +162 -0
  77. package/dist/tools-skills/onboarding-questions/SKILL.md +231 -0
  78. package/dist/tools-skills/onboarding-questions/references/arpu-questions.md +139 -0
  79. package/dist/tools-skills/onboarding-questions/references/craft.md +142 -0
  80. package/dist/tools-skills/onboarding-questions/references/example-reflective.md +117 -0
  81. package/dist/tools-skills/superwall/SKILL.md +263 -0
  82. package/dist/tools-skills/superwall/references/api.md +303 -0
  83. package/dist/tools-skills/superwall/references/asa.md +166 -0
  84. package/dist/tools-skills/superwall/references/asc.md +95 -0
  85. package/dist/tools-skills/superwall/references/dashboard-links.md +57 -0
  86. package/dist/tools-skills/superwall/references/data-analytics.md +896 -0
  87. package/dist/tools-skills/superwall/references/docs.md +51 -0
  88. package/dist/tools-skills/superwall/references/sdk-integration.md +104 -0
  89. package/dist/tools-skills/superwall/references/sdk-source.md +18 -0
  90. package/dist/tools-skills/superwall/workflows/dashboard/playbook.md +76 -0
  91. package/dist/tools-skills/superwall/workflows/dashboard/setup.md +100 -0
  92. package/dist/tools-skills/superwall/workflows/integrate/android.md +292 -0
  93. package/dist/tools-skills/superwall/workflows/integrate/expo.md +272 -0
  94. package/dist/tools-skills/superwall/workflows/integrate/flutter.md +285 -0
  95. package/dist/tools-skills/superwall/workflows/integrate/ios.md +314 -0
  96. package/dist/tools-skills/superwall/workflows/integrate/playbook.md +83 -0
  97. package/dist/tools-skills/superwall/workflows/integrate/react-native.md +246 -0
  98. package/dist/tools-skills/superwall/workflows/migrate/adapty.md +229 -0
  99. package/dist/tools-skills/superwall/workflows/migrate/playbook.md +78 -0
  100. package/dist/tools-skills/superwall/workflows/migrate/qonversion.md +227 -0
  101. package/dist/tools-skills/superwall/workflows/migrate/revenuecat.md +414 -0
  102. package/dist/tools-skills/superwall/workflows/placements/android.md +175 -0
  103. package/dist/tools-skills/superwall/workflows/placements/expo.md +161 -0
  104. package/dist/tools-skills/superwall/workflows/placements/flutter.md +139 -0
  105. package/dist/tools-skills/superwall/workflows/placements/ios.md +165 -0
  106. package/dist/tools-skills/superwall/workflows/placements/playbook.md +69 -0
  107. package/dist/tools-skills/superwall/workflows/placements/react-native.md +145 -0
  108. package/dist/tools-skills/superwall/workflows/placements/strategy.md +222 -0
  109. package/dist/tools-skills/superwall/workflows/review/android.md +120 -0
  110. package/dist/tools-skills/superwall/workflows/review/expo.md +100 -0
  111. package/dist/tools-skills/superwall/workflows/review/flutter.md +99 -0
  112. package/dist/tools-skills/superwall/workflows/review/ios.md +108 -0
  113. package/dist/tools-skills/superwall/workflows/review/playbook.md +70 -0
  114. package/dist/tools-skills/superwall/workflows/review/react-native.md +100 -0
  115. package/dist/tools-skills/superwall-editor/SKILL.md +113 -0
  116. package/dist/tools-skills/superwall-editor/references/cli.md +135 -0
  117. package/dist/tools-skills/superwall-editor/references/design.md +51 -0
  118. package/dist/tools-skills/superwall-editor/references/native-elements.md +171 -0
  119. package/dist/tools-skills/superwall-editor/references/workflow.md +65 -0
  120. package/dist/tools-skills/superwall-editor/scripts/sw-editor.sh +662 -0
  121. package/dist/tools-skills/wwdc/SKILL.md +22 -0
  122. package/dist/tools-skills/wwdc/references/docs.md +52 -0
  123. package/dist/tools-skills/wwdc/scripts/wwdc.sh +266 -0
  124. package/dist/tools.d.ts +4 -2
  125. package/dist/tools.js +561 -161
  126. package/dist/{upgrade-Bt4Ouw1y.js → upgrade-1t3aQUxh.js} +1 -1
  127. package/dist/{upgrade-Cqy5orjb.js → upgrade-DLf0LJDh.js} +2 -2
  128. package/package.json +2 -2
  129. package/dist/create-Yvf2gStM.js +0 -19
  130. package/dist/held-Ddw1XSsr.js +0 -16
  131. package/dist/kinds-GFXB3sYu.js +0 -11
  132. package/dist/login-BoBe8Psl.js +0 -16
  133. package/dist/push-CtD4FZQV.js +0 -22
  134. package/dist/scan-Cv5uOwVY.js +0 -4
  135. package/dist/send-BxD9yf6F.js +0 -150
  136. package/dist/server-z1LH94R_.js +0 -22
  137. package/dist/session-1AV_Bs_d.js +0 -6
  138. package/dist/storekit-DafAnGkM.js +0 -16
  139. /package/dist/{devtools-ByZ6XYnn.js → devtools-pBl_vt03.js} +0 -0
  140. /package/dist/{reports-DdPq4blM.js → reports-D_qbl7_u.js} +0 -0
  141. /package/dist/{screenshot-file-0UETadF8.js → screenshot-file-tVBfUEIi.js} +0 -0
  142. /package/dist/{storage-DYvmIOHa.d.ts → storage-CerJ5KLP.d.ts} +0 -0
@@ -1,21 +1,21 @@
1
1
  import { a as stripAnsi, l as readJson, o as cache, r as formatJson, t as blocks } from "./output-Ggzq5_-t.js";
2
- import { a as CHANNEL, t as API_HOST } from "./environment-DF1qKlny.js";
3
- import { a as withQuery$1, t as ApiError } from "./client-DP6Rc0t_.js";
4
- import { C as listKeySources, S as listBundleIdSuggestions, T as replaceRevenueProvider, _ as checkServerNotifications, b as importAppKey, c as resolveAscOrgApi, d as runAscDocs, f as parseParams, h as REVENUE_INTEGRATIONS, i as savedKey, l as resolveAscTeam, m as KEY_LABEL, n as testModeWarning, p as KEY_KINDS, r as chooseKeyApp, t as upsertHeldKey, u as sendAscRequest, v as copyAppKey, w as removeAppKey, x as keyKind, y as findIntegrations } from "./held-Cy8Wl4D1.js";
5
- import { n as readDefaultApp, u as writeDefaultApp } from "./config-BO1Y87kV.js";
6
- import { a as defineCommand, d as readInput, i as defineCatalog, r as UsageError, t as apiCall } from "./spinner-CneRK5rk.js";
2
+ import { a as CHANNEL, g as TELEMETRY_KEY, h as TELEMETRY_HOST, t as API_HOST, v as VERSION, x as detectAgent } from "./environment-eV7LEnSN.js";
3
+ import { t as readSession } from "./storage-DIkYajce.js";
4
+ import { a as withQuery$1, t as ApiError } from "./client-BIvOmWPC.js";
5
+ import { C as listKeySources, S as listBundleIdSuggestions, T as replaceRevenueProvider, _ as checkServerNotifications, b as importAppKey, c as resolveAscOrgApi, d as runAscDocs, f as parseParams, h as REVENUE_INTEGRATIONS, i as savedKey, l as resolveAscTeam, m as KEY_LABEL, n as testModeWarning, p as KEY_KINDS, r as chooseKeyApp, t as upsertHeldKey, u as sendAscRequest, v as copyAppKey, w as removeAppKey, x as keyKind, y as findIntegrations } from "./held-BMisHn8F.js";
6
+ import { n as readDefaultApp, r as readOnboardedApp, t as readAnonymousId, u as writeDefaultApp } from "./config-BO1Y87kV.js";
7
+ import { a as defineCommand, d as readInput, i as defineCatalog, r as UsageError, t as apiCall } from "./spinner-Ba3XhlMb.js";
7
8
  import { n as fg, t as THEME } from "./theme-DUsCh-Vd.js";
8
- import { n as runWhoami } from "./session-CFAmMhem.js";
9
- import { A as listOrgGroups, E as isRecord, M as orgIdOf, O as parseJson, S as rowName, i as createEntitlement, k as textField, l as isAppScoped, m as listResource, n as createApplication, o as createProduct, p as listProjects, r as createCampaign, s as createProject, t as RESOURCES, v as platformLabel } from "./resources-Dqr01Dep.js";
10
- import { n as orgForNewProject } from "./org-D0g_q3mv.js";
11
- import { n as findApplication, r as findProject, t as appNotFound } from "./lookup-D-nmmAbw.js";
12
- import { a as pickScope, i as pickProject, n as chooseApp, r as pickOrganization, t as boundOrganization } from "./scope-V336uz8j.js";
9
+ import { n as runWhoami } from "./session-xG9E8J2N.js";
10
+ import { A as parseJson, M as listOrgGroups, O as isRecord, P as orgIdOf, i as createEntitlement, j as textField, l as isAppScoped, m as listResource, n as createApplication, o as createProduct, p as listProjects, r as createCampaign, s as createProject, t as RESOURCES, v as platformLabel, w as rowName } from "./resources-B1qKDVXd.js";
11
+ import { n as orgForNewProject } from "./org-DUwdrKPV.js";
12
+ import { n as findApplication, r as findProject, t as appNotFound } from "./lookup-k9EeOiZr.js";
13
+ import { a as pickScope, i as pickProject, n as chooseApp, r as pickOrganization, t as boundOrganization } from "./scope-B6UYGuwn.js";
13
14
  import { a as listAscConfigs, i as findAppNotificationUrl, o as removeAscConfig, t as ascProxy } from "./client-BZ1UbpXz.js";
14
15
  import { i as listUnimportedAscProducts, n as findAscAppId, r as listAscApps, t as ascTypeDisplay } from "./products-DH_fK9tY.js";
15
16
  import { n as readResourceFlags, r as textOf, t as fieldName } from "./input-vi0bou04.js";
16
- import { a as runAscNotificationUrlSet, i as printServerNotifications, t as describeNotificationUrl } from "./notification-url-YDbq6FMA.js";
17
- import { t as platformForIntegration } from "./bind-drne__Ys.js";
18
- import { t as FEEDBACK_KINDS } from "./kinds-GFXB3sYu.js";
17
+ import { a as runAscNotificationUrlSet, i as printServerNotifications, t as describeNotificationUrl } from "./notification-url-BVaTgWZ5.js";
18
+ import { t as platformForIntegration } from "./bind-CHLHmxgA.js";
19
19
  import pc from "picocolors";
20
20
 
21
21
  //#region src/ui/help-layout.ts
@@ -101,7 +101,7 @@ const command = defineCommand({
101
101
  prompts: true,
102
102
  mcp: false,
103
103
  async run(ctx, input) {
104
- const { runLogin } = await import("./login-BoBe8Psl.js");
104
+ const { runLogin } = await import("./login-2JHCG6c1.js");
105
105
  return runLogin(ctx, input);
106
106
  }
107
107
  });
@@ -117,7 +117,7 @@ const command$1 = defineCommand({
117
117
  prompts: true,
118
118
  mcp: false,
119
119
  async run(ctx) {
120
- const { runLogout } = await import("./session-1AV_Bs_d.js");
120
+ const { runLogout } = await import("./session-DItGa4z0.js");
121
121
  return runLogout(ctx);
122
122
  }
123
123
  });
@@ -257,7 +257,9 @@ arrive twice. Count revenue the way the dashboard does:
257
257
  WHERE applicationId = {app:UInt64}
258
258
  AND (integration IN {revenue_integrations:Array(String)} OR source = 'sdk')
259
259
  AND NOT (coalesce(integration, '') = 'revenue_cat' AND store = 'STRIPE')
260
- --param name=value adds any other parameter.`,
260
+ --param name=value adds any other parameter.
261
+
262
+ The backend forces SQL to readonly=1. Before executing SQL it may provision a ClickHouse user and role, persist credentials and reconcile access policies for the organization. SQL read-only mode does not prevent these setup changes.`,
261
263
  args: { sql: {
262
264
  describe: "SQL query (or pass it with --file / stdin)",
263
265
  mcp: "required"
@@ -283,7 +285,7 @@ arrive twice. Count revenue the way the dashboard does:
283
285
  auth: "required",
284
286
  json: true,
285
287
  prompts: false,
286
- mcp: "read",
288
+ mcp: "write",
287
289
  run(ctx, input) {
288
290
  return runQuery(ctx, input);
289
291
  }
@@ -616,6 +618,7 @@ const command$5 = defineCommand({
616
618
  const command$6 = defineCommand({
617
619
  name: "get",
618
620
  summary: "Make GET requests to the Superwall API",
621
+ details: "Executes an arbitrary Superwall GET endpoint. Most retrieve account data, but the analytics query endpoint can provision credentials and reconcile existing access policies before running read-only SQL.",
619
622
  args: { path: {
620
623
  describe: "API path, e.g. /v2/products",
621
624
  required: true
@@ -625,7 +628,7 @@ const command$6 = defineCommand({
625
628
  auth: "required",
626
629
  json: true,
627
630
  prompts: false,
628
- mcp: "read",
631
+ mcp: "write",
629
632
  run(ctx, { args, flags }) {
630
633
  return runApiRequest(ctx, ctx.api, {
631
634
  verb: "get",
@@ -640,6 +643,7 @@ const command$6 = defineCommand({
640
643
  const command$7 = defineCommand({
641
644
  name: "patch",
642
645
  summary: "Make PATCH requests to the Superwall API",
646
+ details: "Executes an arbitrary Superwall PATCH endpoint. Depending on the path, it overwrites account configuration or redirects webhook delivery to a caller-supplied HTTPS destination.",
643
647
  args: { path: {
644
648
  describe: "API path, e.g. /v2/products",
645
649
  required: true
@@ -649,7 +653,7 @@ const command$7 = defineCommand({
649
653
  auth: "required",
650
654
  json: true,
651
655
  prompts: false,
652
- mcp: "write",
656
+ mcp: "destructive",
653
657
  run(ctx, { args, flags }) {
654
658
  return runApiRequest(ctx, ctx.api, {
655
659
  verb: "patch",
@@ -664,6 +668,7 @@ const command$7 = defineCommand({
664
668
  const command$8 = defineCommand({
665
669
  name: "post",
666
670
  summary: "Make POST requests to the Superwall API",
671
+ details: "Executes an arbitrary Superwall POST endpoint. Depending on the path, it can archive, reset, publish, resend events or create a webhook to a caller-supplied HTTPS destination. Repeating a call may repeat its effects.",
667
672
  args: { path: {
668
673
  describe: "API path, e.g. /v2/products",
669
674
  required: true
@@ -673,7 +678,7 @@ const command$8 = defineCommand({
673
678
  auth: "required",
674
679
  json: true,
675
680
  prompts: false,
676
- mcp: "write",
681
+ mcp: "destructive",
677
682
  run(ctx, { args, flags }) {
678
683
  return runApiRequest(ctx, ctx.api, {
679
684
  verb: "post",
@@ -741,7 +746,7 @@ function renderOperationHelp(spec, operation) {
741
746
  });
742
747
  const common = [[cmd("--app <app>"), "A Superwall app of the organization whose App Store Connect key to use"], [cmd("--team <id>"), "Apple team id, when your organization has several"]];
743
748
  if (operation.effect !== "read") common.push([cmd("--dry-run"), "Print every request it would send; send no change"]);
744
- if (operation.effect === "destructive") common.push([cmd("-y, --yes"), "Go ahead without asking"]);
749
+ if (operation.confirm) common.push([cmd("-y, --yes"), "Go ahead without asking"]);
745
750
  common.push([cmd("--json"), "Machine-readable output"]);
746
751
  return renderPage({
747
752
  name: `${spec.name} ${operation.name}`,
@@ -1406,21 +1411,21 @@ function parseFlag(key, flag$1, raw) {
1406
1411
  }
1407
1412
  return parseChoice(key, flag$1, text);
1408
1413
  }
1409
- function parseArg(command$67, arg, word) {
1414
+ function parseArg(command$68, arg, word) {
1410
1415
  if (word === void 0 || !arg.choices) return word;
1411
1416
  const found = arg.choices.find((choice) => choice.toLowerCase() === word.toLowerCase());
1412
- if (!found) throw new UsageError(`${command$67} takes <${arg.name}> as one of: ${arg.choices.join(", ")} (not "${word}").`);
1417
+ if (!found) throw new UsageError(`${command$68} takes <${arg.name}> as one of: ${arg.choices.join(", ")} (not "${word}").`);
1413
1418
  return found;
1414
1419
  }
1415
- function parseInput(command$67, operation, words, raw) {
1420
+ function parseInput(command$68, operation, words, raw) {
1416
1421
  const specs = operation.flags ?? {};
1417
- for (const key of Object.keys(raw)) if (!(key in specs) && !(key in COMMON_FLAGS)) throw new UsageError(`${command$67} has no --${kebab(key)}. Run superwall ${command$67} --help for its flags.`);
1422
+ for (const key of Object.keys(raw)) if (!(key in specs) && !(key in COMMON_FLAGS)) throw new UsageError(`${command$68} has no --${kebab(key)}. Run superwall ${command$68} --help for its flags.`);
1418
1423
  const flags = Object.fromEntries(Object.entries(specs).map(([key, flag$1]) => [key, parseFlag(key, flag$1, raw[key])]));
1419
- for (const [key, flag$1] of Object.entries(specs)) if (flag$1.required && flags[key] === void 0) throw new UsageError(`${command$67} needs --${kebab(key)}.`);
1424
+ for (const [key, flag$1] of Object.entries(specs)) if (flag$1.required && flags[key] === void 0) throw new UsageError(`${command$68} needs --${kebab(key)}.`);
1420
1425
  const specArgs = operation.args ?? [];
1421
- if (words.length > specArgs.length) throw new UsageError(`${command$67} doesn't take "${words.slice(specArgs.length).join(" ")}".`);
1422
- const args = Object.fromEntries(specArgs.map((arg, index) => [arg.name, parseArg(command$67, arg, words[index])]));
1423
- for (const arg of specArgs) if (arg.required && args[arg.name] === void 0) throw new UsageError(`${command$67} needs <${arg.name}>.`);
1426
+ if (words.length > specArgs.length) throw new UsageError(`${command$68} doesn't take "${words.slice(specArgs.length).join(" ")}".`);
1427
+ const args = Object.fromEntries(specArgs.map((arg, index) => [arg.name, parseArg(command$68, arg, words[index])]));
1428
+ for (const arg of specArgs) if (arg.required && args[arg.name] === void 0) throw new UsageError(`${command$68} needs <${arg.name}>.`);
1424
1429
  return {
1425
1430
  args,
1426
1431
  flags,
@@ -1701,6 +1706,7 @@ const command$10 = defineAscResource({
1701
1706
  }, {
1702
1707
  name: "set",
1703
1708
  summary: "Sell it in these territories",
1709
+ details: "Replaces the set of available territories and can remove existing sale availability.",
1704
1710
  flags: {
1705
1711
  subscription: TARGET_FLAGS.subscription,
1706
1712
  iap: TARGET_FLAGS.iap,
@@ -1715,7 +1721,7 @@ const command$10 = defineAscResource({
1715
1721
  describe: "Also territories Apple adds later (default: with all)"
1716
1722
  }
1717
1723
  },
1718
- effect: "write",
1724
+ effect: "destructive",
1719
1725
  run: runAvailabilitySet
1720
1726
  }],
1721
1727
  examples: [["asc availability get --subscription <id>", "Where it is sold"], ["asc availability set --iap <id> --available-territories USA,CAN", "Sell it in two territories"]]
@@ -2039,6 +2045,7 @@ async function runBuildsGet(session, input) {
2039
2045
  async function runBuildsAttach(session, input) {
2040
2046
  const build = argOf(input, "id");
2041
2047
  const version = await resolveVersionId(session, input);
2048
+ await assertConfirmed(session, input.yes, `Attach build ${build} to version ${version}, replacing its current build`);
2042
2049
  await session.send("patch", `/v1/appStoreVersions/${version}/relationships/build`, { data: {
2043
2050
  type: "builds",
2044
2051
  id: build
@@ -2134,7 +2141,8 @@ const command$11 = defineAscResource({
2134
2141
  required: true
2135
2142
  }, VERSION_ARG],
2136
2143
  flags: VERSION_FLAGS,
2137
- effect: "write",
2144
+ confirm: true,
2145
+ effect: "destructive",
2138
2146
  run: runBuildsAttach
2139
2147
  },
2140
2148
  {
@@ -2145,6 +2153,7 @@ const command$11 = defineAscResource({
2145
2153
  describe: "The build's id",
2146
2154
  required: true
2147
2155
  }],
2156
+ confirm: true,
2148
2157
  effect: "destructive",
2149
2158
  run: runBuildsExpire
2150
2159
  }
@@ -2708,7 +2717,7 @@ async function resolveDeliveryState(session, path) {
2708
2717
  async function runScreenshotsUpload(session, input) {
2709
2718
  const { kind, id: id$1 } = resolveTarget(input, PRICED);
2710
2719
  const spec = SCREENSHOT[kind];
2711
- const { readScreenshotFile } = await import("./screenshot-file-0UETadF8.js");
2720
+ const { readScreenshotFile } = await import("./screenshot-file-tVBfUEIi.js");
2712
2721
  const file = readScreenshotFile(argOf(input, "file"));
2713
2722
  const existing = await selectScreenshot(session, kind, id$1);
2714
2723
  if (existing) await session.send("delete", `${spec.path}/${existing.id}`);
@@ -3012,6 +3021,7 @@ const command$15 = defineAscResource({
3012
3021
  {
3013
3022
  name: "update",
3014
3023
  summary: "Change an in-app purchase",
3024
+ details: "PATCH replaces existing IAP fields, including family-sharing configuration when accepted by Apple.",
3015
3025
  args: [{
3016
3026
  name: "id",
3017
3027
  describe: "The in-app purchase's id",
@@ -3033,7 +3043,7 @@ const command$15 = defineAscResource({
3033
3043
  describe: "A note for App Review"
3034
3044
  }
3035
3045
  },
3036
- effect: "write",
3046
+ effect: "destructive",
3037
3047
  run: runIapsUpdate
3038
3048
  },
3039
3049
  {
@@ -3044,6 +3054,7 @@ const command$15 = defineAscResource({
3044
3054
  describe: "The in-app purchase's id",
3045
3055
  required: true
3046
3056
  }],
3057
+ confirm: true,
3047
3058
  effect: "destructive",
3048
3059
  run: runIapsDelete
3049
3060
  }
@@ -3100,6 +3111,7 @@ of the product; changes go to its editable version, and an approved product gets
3100
3111
  {
3101
3112
  name: "update",
3102
3113
  summary: "Change the localization in --locale",
3114
+ details: "Overwrites the existing localization. Updating can also create a missing editable draft.",
3103
3115
  flags: {
3104
3116
  ...TARGET_FLAGS,
3105
3117
  locale: {
@@ -3124,7 +3136,7 @@ of the product; changes go to its editable version, and an approved product gets
3124
3136
  describe: "The app name shown with a group (groups only)"
3125
3137
  }
3126
3138
  },
3127
- effect: "write",
3139
+ effect: "destructive",
3128
3140
  run: runLocalizationsUpdate
3129
3141
  },
3130
3142
  {
@@ -3139,6 +3151,7 @@ of the product; changes go to its editable version, and an approved product gets
3139
3151
  required: true
3140
3152
  }
3141
3153
  },
3154
+ confirm: true,
3142
3155
  effect: "destructive",
3143
3156
  run: runLocalizationsDelete
3144
3157
  }
@@ -3280,6 +3293,7 @@ const command$17 = defineAscResource({
3280
3293
  {
3281
3294
  name: "update",
3282
3295
  summary: "Change the version's text in one locale",
3296
+ details: "PATCH overwrites existing App Store version localization text and URLs.",
3283
3297
  args: [VERSION_ARG],
3284
3298
  flags: {
3285
3299
  ...VERSION_FLAGS,
@@ -3291,7 +3305,7 @@ const command$17 = defineAscResource({
3291
3305
  },
3292
3306
  ...METADATA_FIELDS
3293
3307
  },
3294
- effect: "write",
3308
+ effect: "destructive",
3295
3309
  run: runMetadataUpdate
3296
3310
  },
3297
3311
  {
@@ -3415,7 +3429,7 @@ A purchase_key is for the app's bundle ID; an app with none gets --bundle-id sav
3415
3429
  prompts: true,
3416
3430
  mcp: false,
3417
3431
  async run(ctx, input) {
3418
- const { runAscKeysCreate } = await import("./create-Yvf2gStM.js");
3432
+ const { runAscKeysCreate } = await import("./create-oj3zXvHZ.js");
3419
3433
  return runAscKeysCreate(ctx, input);
3420
3434
  }
3421
3435
  });
@@ -3651,7 +3665,9 @@ const command$20 = defineCommand({
3651
3665
  details: `Without --from it tries every key your organization has and saves the first Apple
3652
3666
  confirms, both kinds when none is named; exit 1 when a kind is still missing. With --from
3653
3667
  it copies that app's key. Never saves an unconfirmed key unless a person passes
3654
- --allow-unconfirmed, and creates nothing at Apple.`,
3668
+ --allow-unconfirmed, and creates nothing at Apple.
3669
+
3670
+ With --from, replaces the target app's saved key.`,
3655
3671
  args: { kind: {
3656
3672
  describe: "api_key or purchase_key (both when left out; needed with --from)",
3657
3673
  choices: KEY_KINDS
@@ -3681,7 +3697,7 @@ it copies that app's key. Never saves an unconfirmed key unless a person passes
3681
3697
  auth: "required",
3682
3698
  json: true,
3683
3699
  prompts: true,
3684
- mcp: "write",
3700
+ mcp: "destructive",
3685
3701
  run(ctx, { args, flags }) {
3686
3702
  const kind = keyKind(args.kind);
3687
3703
  const app$1 = {
@@ -3800,7 +3816,7 @@ With --app it saves the key you hold on that app instead, as asc keys create --k
3800
3816
  prompts: true,
3801
3817
  mcp: false,
3802
3818
  async run(ctx, { args, flags }) {
3803
- const { upsertHeldKey: upsertHeldKey$1 } = await import("./held-Ddw1XSsr.js");
3819
+ const { upsertHeldKey: upsertHeldKey$1 } = await import("./held-DeJW2gUk.js");
3804
3820
  return upsertHeldKey$1(ctx, {
3805
3821
  action: "update",
3806
3822
  key: {
@@ -3858,7 +3874,9 @@ const command$25 = defineCommand({
3858
3874
  name: "asc notification-url set",
3859
3875
  summary: "Write this app's URL where Apple has none",
3860
3876
  details: `Never replaces another server's URL: a conflict is reported and left alone (exit 1).
3861
- It leaves the revenue provider alone unless --set-revenue-provider is passed.`,
3877
+ It leaves the revenue provider alone unless --set-revenue-provider is passed.
3878
+
3879
+ Passing --set-revenue-provider overwrites the app's existing revenue-provider selection.`,
3862
3880
  flags: {
3863
3881
  setRevenueProvider: {
3864
3882
  type: "boolean",
@@ -3879,7 +3897,7 @@ It leaves the revenue provider alone unless --set-revenue-provider is passed.`,
3879
3897
  auth: "required",
3880
3898
  json: true,
3881
3899
  prompts: true,
3882
- mcp: "write",
3900
+ mcp: "destructive",
3883
3901
  run(ctx, input) {
3884
3902
  return runAscNotificationUrlSet(ctx, input);
3885
3903
  }
@@ -4049,6 +4067,7 @@ priced in --territory and equalized.`,
4049
4067
  {
4050
4068
  name: "create",
4051
4069
  summary: "Create an introductory offer in every territory",
4070
+ details: "Creates introductory offers in the selected territories. New offers with overlapping dates overwrite existing introductory offers.",
4052
4071
  flags: {
4053
4072
  subscription: {
4054
4073
  type: "string",
@@ -4101,12 +4120,13 @@ priced in --territory and equalized.`,
4101
4120
  describe: "When it ends"
4102
4121
  }
4103
4122
  },
4104
- effect: "write",
4123
+ effect: "destructive",
4105
4124
  run: runOffersCreate
4106
4125
  },
4107
4126
  {
4108
4127
  name: "update",
4109
4128
  summary: "Change when one offer ends",
4129
+ details: "PATCH changes an existing introductory offer end date, potentially ending the offer earlier.",
4110
4130
  args: [{
4111
4131
  name: "id",
4112
4132
  describe: "The offer's id",
@@ -4118,7 +4138,7 @@ priced in --territory and equalized.`,
4118
4138
  describe: "When it ends",
4119
4139
  required: true
4120
4140
  } },
4121
- effect: "write",
4141
+ effect: "destructive",
4122
4142
  run: runOffersUpdate
4123
4143
  },
4124
4144
  {
@@ -4133,6 +4153,7 @@ priced in --territory and equalized.`,
4133
4153
  value: "id",
4134
4154
  describe: "Delete all of this subscription's offers"
4135
4155
  } },
4156
+ confirm: true,
4136
4157
  effect: "destructive",
4137
4158
  run: runOffersDelete
4138
4159
  }
@@ -4147,7 +4168,9 @@ const command$27 = defineCommand({
4147
4168
  summary: "Any App Store Connect PATCH request, its body checked against Apple's schema",
4148
4169
  details: `Each -d names an attribute or a relationship of the body; its type comes from Apple's
4149
4170
  schema and its id from the path. A body the schema would refuse is stopped before it is
4150
- sent (--force sends it as-is). superwall asc docs <path> patch lists the fields.`,
4171
+ sent (--force sends it as-is). superwall asc docs <path> patch lists the fields.
4172
+
4173
+ Executes an arbitrary App Store Connect PATCH through the signed proxy, with schema validation unless force is set. It can overwrite attributes, relationships and distribution settings.`,
4151
4174
  args: { path: {
4152
4175
  describe: "The App Store Connect path, e.g. /v1/apps",
4153
4176
  required: true
@@ -4176,7 +4199,7 @@ sent (--force sends it as-is). superwall asc docs <path> patch lists the fields.
4176
4199
  auth: "required",
4177
4200
  json: true,
4178
4201
  prompts: true,
4179
- mcp: "write",
4202
+ mcp: "destructive",
4180
4203
  async run(ctx, { args, flags }) {
4181
4204
  const response = await sendAscRequest(ctx, "patch", args.path, {
4182
4205
  data: flags.d,
@@ -4194,7 +4217,9 @@ const command$28 = defineCommand({
4194
4217
  summary: "Any App Store Connect POST request, its body checked against Apple's schema",
4195
4218
  details: `Each -d names an attribute or a relationship of the body; its type comes from Apple's
4196
4219
  schema. A body the schema would refuse is stopped before it is sent (--force sends it
4197
- as-is). superwall asc docs <path> post lists the fields.`,
4220
+ as-is). superwall asc docs <path> post lists the fields.
4221
+
4222
+ Executes an arbitrary App Store Connect POST through the signed proxy, with schema validation unless force is set. It can submit reviews, release versions or replace price schedules; repeating a call may repeat its effects.`,
4198
4223
  args: { path: {
4199
4224
  describe: "The App Store Connect path, e.g. /v1/apps",
4200
4225
  required: true
@@ -4223,7 +4248,7 @@ as-is). superwall asc docs <path> post lists the fields.`,
4223
4248
  auth: "required",
4224
4249
  json: true,
4225
4250
  prompts: true,
4226
- mcp: "write",
4251
+ mcp: "destructive",
4227
4252
  async run(ctx, { args, flags }) {
4228
4253
  const response = await sendAscRequest(ctx, "post", args.path, {
4229
4254
  data: flags.d,
@@ -4276,6 +4301,7 @@ an in-app purchase replaces its price schedule; Apple equalizes the other territ
4276
4301
  {
4277
4302
  name: "set",
4278
4303
  summary: "Price it in one territory and equalize every other",
4304
+ details: "Replaces an IAP price schedule or updates subscription prices across available territories. Existing-subscriber price preservation is optional.",
4279
4305
  flags: {
4280
4306
  subscription: TARGET_FLAGS.subscription,
4281
4307
  iap: TARGET_FLAGS.iap,
@@ -4300,7 +4326,7 @@ an in-app purchase replaces its price schedule; Apple equalizes the other territ
4300
4326
  describe: "Subscriptions: when the price takes effect (default now)"
4301
4327
  }
4302
4328
  },
4303
- effect: "write",
4329
+ effect: "destructive",
4304
4330
  run: runPricesSet
4305
4331
  }
4306
4332
  ],
@@ -4594,6 +4620,7 @@ release on before the version is released; pause, resume and complete steer it a
4594
4620
  {
4595
4621
  name: "submit",
4596
4622
  summary: "Submit a version for App Review, with in-app products alongside",
4623
+ details: "Adds the version and optional products to a review submission and sets submitted=true, changing the existing review workflow.",
4597
4624
  args: [VERSION_ARG],
4598
4625
  flags: {
4599
4626
  ...VERSION_FLAGS,
@@ -4613,7 +4640,7 @@ release on before the version is released; pause, resume and complete steer it a
4613
4640
  describe: "A subscription group to submit with it (repeatable)"
4614
4641
  }
4615
4642
  },
4616
- effect: "write",
4643
+ effect: "destructive",
4617
4644
  run: runReleaseSubmit
4618
4645
  },
4619
4646
  {
@@ -4621,12 +4648,14 @@ release on before the version is released; pause, resume and complete steer it a
4621
4648
  summary: "Release a version that is pending developer release",
4622
4649
  args: [VERSION_ARG],
4623
4650
  flags: VERSION_FLAGS,
4651
+ confirm: true,
4624
4652
  effect: "destructive",
4625
4653
  run: runReleaseRelease
4626
4654
  },
4627
4655
  {
4628
4656
  name: "phased",
4629
4657
  summary: "Start, pause, resume or complete the version's phased release",
4658
+ details: "Starts, pauses, resumes or completes phased distribution. Completing releases to all users; other actions replace rollout state, subject to Apple’s transition guards.",
4630
4659
  args: [{
4631
4660
  name: "action",
4632
4661
  describe: "What to do",
@@ -4634,7 +4663,7 @@ release on before the version is released; pause, resume and complete steer it a
4634
4663
  choices: PHASED_ACTIONS
4635
4664
  }, VERSION_ARG],
4636
4665
  flags: VERSION_FLAGS,
4637
- effect: "write",
4666
+ effect: "destructive",
4638
4667
  run: runReleasePhased
4639
4668
  },
4640
4669
  {
@@ -4683,7 +4712,9 @@ const command$33 = defineCommand({
4683
4712
  summary: "Submit subscriptions, groups and in-app purchases for App Review",
4684
4713
  details: `Adds the latest version of each to the app's open review submission, or a new one,
4685
4714
  then submits it. Apple reviews a first subscription or in-app purchase together with
4686
- an app version.`,
4715
+ an app version.
4716
+
4717
+ Starts Apple review for products/groups and submits the review submission. This is an outbound workflow transition, not only creation of a local draft.`,
4687
4718
  flags: {
4688
4719
  ascApp: {
4689
4720
  type: "string",
@@ -4724,7 +4755,7 @@ an app version.`,
4724
4755
  auth: "required",
4725
4756
  json: true,
4726
4757
  prompts: true,
4727
- mcp: "write",
4758
+ mcp: "destructive",
4728
4759
  run(ctx, { flags }) {
4729
4760
  return runAscSubmit(ctx, {
4730
4761
  ascApp: flags.ascApp,
@@ -4898,6 +4929,7 @@ const command$34 = defineAscResource({
4898
4929
  {
4899
4930
  name: "update",
4900
4931
  summary: "Rename a group",
4932
+ details: "PATCH replaces the existing group reference name.",
4901
4933
  args: [{
4902
4934
  name: "id",
4903
4935
  describe: "The subscription group's id",
@@ -4909,7 +4941,7 @@ const command$34 = defineAscResource({
4909
4941
  describe: "The group's new name in App Store Connect",
4910
4942
  required: true
4911
4943
  } },
4912
- effect: "write",
4944
+ effect: "destructive",
4913
4945
  run: runSubscriptionGroupsUpdate
4914
4946
  },
4915
4947
  {
@@ -4920,6 +4952,7 @@ const command$34 = defineAscResource({
4920
4952
  describe: "The subscription group's id",
4921
4953
  required: true
4922
4954
  }],
4955
+ confirm: true,
4923
4956
  effect: "destructive",
4924
4957
  run: runSubscriptionGroupsDelete
4925
4958
  }
@@ -5036,7 +5069,7 @@ Exit codes
5036
5069
  prompts: true,
5037
5070
  mcp: false,
5038
5071
  async run(ctx, input) {
5039
- const { runSetupApple } = await import("./apple-CkKlHBZ9.js");
5072
+ const { runSetupApple } = await import("./apple-BHbX0jbn.js");
5040
5073
  return runSetupApple(ctx, input);
5041
5074
  }
5042
5075
  });
@@ -5363,6 +5396,7 @@ state and what is still missing.`,
5363
5396
  {
5364
5397
  name: "update",
5365
5398
  summary: "Change a subscription",
5399
+ details: "PATCH replaces subscription attributes, including period, group level and family-sharing configuration when accepted by Apple.",
5366
5400
  args: [{
5367
5401
  name: "id",
5368
5402
  describe: "The subscription's id",
@@ -5395,7 +5429,7 @@ state and what is still missing.`,
5395
5429
  describe: "A note for App Review"
5396
5430
  }
5397
5431
  },
5398
- effect: "write",
5432
+ effect: "destructive",
5399
5433
  run: runSubscriptionsUpdate
5400
5434
  },
5401
5435
  {
@@ -5406,6 +5440,7 @@ state and what is still missing.`,
5406
5440
  describe: "The subscription's id",
5407
5441
  required: true
5408
5442
  }],
5443
+ confirm: true,
5409
5444
  effect: "destructive",
5410
5445
  run: runSubscriptionsDelete
5411
5446
  }
@@ -5505,6 +5540,7 @@ off iOS, --platform. --earliest-release-date (2026-11-01T08:00:00-07:00) goes wi
5505
5540
  {
5506
5541
  name: "update",
5507
5542
  summary: "Change a version",
5543
+ details: "PATCH overwrites version fields, release type and earliest release date; it can change automatic-release behavior.",
5508
5544
  args: [VERSION_ARG],
5509
5545
  flags: {
5510
5546
  ...VERSION_FLAGS,
@@ -5530,7 +5566,7 @@ off iOS, --platform. --earliest-release-date (2026-11-01T08:00:00-07:00) goes wi
5530
5566
  describe: "The copyright line"
5531
5567
  }
5532
5568
  },
5533
- effect: "write",
5569
+ effect: "destructive",
5534
5570
  run: runVersionsUpdate
5535
5571
  },
5536
5572
  {
@@ -5538,6 +5574,7 @@ off iOS, --platform. --earliest-release-date (2026-11-01T08:00:00-07:00) goes wi
5538
5574
  summary: "Delete a version while it is still editable",
5539
5575
  args: [VERSION_ARG],
5540
5576
  flags: VERSION_FLAGS,
5577
+ confirm: true,
5541
5578
  effect: "destructive",
5542
5579
  run: runVersionsDelete
5543
5580
  }
@@ -5627,31 +5664,32 @@ const LIST_QUERY = [
5627
5664
  "offset",
5628
5665
  "all"
5629
5666
  ];
5630
- const op = (group$1, action, method, path, summary, doc, rest = {}) => ({
5667
+ const op = (group$1, action, effect, method, path, summary, doc, rest = {}) => ({
5631
5668
  group: group$1,
5632
5669
  action,
5633
5670
  method,
5634
5671
  path,
5635
5672
  summary,
5636
5673
  doc,
5637
- ...rest
5674
+ ...rest,
5675
+ effect
5638
5676
  });
5639
5677
  const list$1 = (group$1, path, summary, doc, rest = {}) => {
5640
- return op(group$1, "list", "GET", path, summary, doc, {
5678
+ return op(group$1, "list", "read", "GET", path, summary, doc, {
5641
5679
  paged: "query",
5642
5680
  query: LIST_QUERY,
5643
5681
  ...rest
5644
5682
  });
5645
5683
  };
5646
5684
  const byId = (group$1, path, summary, doc, rest = {}) => {
5647
- return op(group$1, "get", "GET", path, summary, doc, {
5685
+ return op(group$1, "get", "read", "GET", path, summary, doc, {
5648
5686
  positional: "id",
5649
5687
  query: ["fields"],
5650
5688
  ...rest
5651
5689
  });
5652
5690
  };
5653
5691
  const find = (group$1, path, summary, doc, rest = {}) => {
5654
- return op(group$1, "find", "POST", path, summary, doc, {
5692
+ return op(group$1, "find", "read", "POST", path, summary, doc, {
5655
5693
  body: "selector",
5656
5694
  paged: "selector",
5657
5695
  query: SELECTOR_QUERY,
@@ -5662,45 +5700,51 @@ const ASA_OPERATIONS = [
5662
5700
  list$1("campaigns", "/campaigns", "List campaigns", "get-all-campaigns"),
5663
5701
  byId("campaigns", "/campaigns/{id}", "Get a campaign", "get-a-campaign"),
5664
5702
  find("campaigns", "/campaigns/find", "Find campaigns with a selector", "find-campaigns"),
5665
- op("campaigns", "create", "POST", "/campaigns", "Create a campaign", "create-a-campaign", {
5703
+ op("campaigns", "create", "destructive", "POST", "/campaigns", "Create a campaign", "create-a-campaign", {
5704
+ details: "Creates a campaign with a budget and caller-selected status. ENABLED permits advertising once Apple’s serving requirements are met; this is not restricted to paused drafts.",
5666
5705
  body: "object",
5667
5706
  flags: CAMPAIGN_FIELDS
5668
5707
  }),
5669
- op("campaigns", "update", "PUT", "/campaigns/{id}", "Update a campaign", "update-a-campaign", {
5708
+ op("campaigns", "update", "destructive", "PUT", "/campaigns/{id}", "Update a campaign", "update-a-campaign", {
5709
+ details: "Overwrites campaign status, countries and daily/lifetime budgets; can enable spending or pause delivery.",
5670
5710
  positional: "id",
5671
5711
  body: "object",
5672
5712
  envelope: "campaign",
5673
5713
  flags: CAMPAIGN_FIELDS
5674
5714
  }),
5675
- op("campaigns", "delete", "DELETE", "/campaigns/{id}", "Delete a campaign", "delete-a-campaign", { positional: "id" }),
5715
+ op("campaigns", "delete", "destructive", "DELETE", "/campaigns/{id}", "Delete a campaign", "delete-a-campaign", { positional: "id" }),
5676
5716
  list$1("adgroups", "/campaigns/{campaign}/adgroups", "List ad groups in a campaign", "get-all-ad-groups"),
5677
5717
  byId("adgroups", "/campaigns/{campaign}/adgroups/{id}", "Get an ad group", "get-an-ad-group"),
5678
5718
  find("adgroups", "/campaigns/{campaign}/adgroups/find", "Find ad groups in a campaign", "find-ad-groups"),
5679
5719
  find("adgroups", "/adgroups/find", "Find ad groups across the org", "find-ad-groups-(org-level)"),
5680
- op("adgroups", "create", "POST", "/campaigns/{campaign}/adgroups", "Create an ad group", "create-an-ad-group", {
5720
+ op("adgroups", "create", "destructive", "POST", "/campaigns/{campaign}/adgroups", "Create an ad group", "create-an-ad-group", {
5721
+ details: "Creates a bid-bearing ad group. An enabled group in an eligible live campaign can begin serving and spending immediately.",
5681
5722
  body: "object",
5682
5723
  flags: ADGROUP_FIELDS
5683
5724
  }),
5684
- op("adgroups", "update", "PUT", "/campaigns/{campaign}/adgroups/{id}", "Update an ad group", "update-an-ad-group", {
5725
+ op("adgroups", "update", "destructive", "PUT", "/campaigns/{campaign}/adgroups/{id}", "Update an ad group", "update-an-ad-group", {
5726
+ details: "Overwrites ad-group status, bids, CPA goal, dates and Search Match behavior.",
5685
5727
  positional: "id",
5686
5728
  body: "object",
5687
5729
  flags: ADGROUP_FIELDS
5688
5730
  }),
5689
- op("adgroups", "delete", "DELETE", "/campaigns/{campaign}/adgroups/{id}", "Delete an ad group", "delete-an-ad-group", { positional: "id" }),
5731
+ op("adgroups", "delete", "destructive", "DELETE", "/campaigns/{campaign}/adgroups/{id}", "Delete an ad group", "delete-an-ad-group", { positional: "id" }),
5690
5732
  list$1("keywords", "/campaigns/{campaign}/adgroups/{adgroup}/targetingkeywords", "List targeting keywords in an ad group", "get-all-targeting-keywords-in-an-ad-group"),
5691
5733
  byId("keywords", "/campaigns/{campaign}/adgroups/{adgroup}/targetingkeywords/{id}", "Get a targeting keyword", "get-a-targeting-keyword-in-an-ad-group"),
5692
5734
  find("keywords", "/campaigns/{campaign}/adgroups/targetingkeywords/find", "Find targeting keywords across a campaign", "find-targeting-keywords-in-a-campaign"),
5693
- op("keywords", "create", "POST", "/campaigns/{campaign}/adgroups/{adgroup}/targetingkeywords/bulk", "Create targeting keywords (bulk)", "create-targeting-keywords", {
5735
+ op("keywords", "create", "destructive", "POST", "/campaigns/{campaign}/adgroups/{adgroup}/targetingkeywords/bulk", "Create targeting keywords (bulk)", "create-targeting-keywords", {
5736
+ details: "Creates targeting keywords, which can be ACTIVE with bids in a live ad group and enable spending.",
5694
5737
  body: "array",
5695
5738
  flags: KEYWORD_FIELDS
5696
5739
  }),
5697
- op("keywords", "update", "PUT", "/campaigns/{campaign}/adgroups/{adgroup}/targetingkeywords/bulk", "Update targeting keywords (bulk)", "update-targeting-keywords", {
5740
+ op("keywords", "update", "destructive", "PUT", "/campaigns/{campaign}/adgroups/{adgroup}/targetingkeywords/bulk", "Update targeting keywords (bulk)", "update-targeting-keywords", {
5741
+ details: "Bulk-overwrites targeting keyword status, match type or bids.",
5698
5742
  positional: "id",
5699
5743
  body: "array",
5700
5744
  flags: KEYWORD_FIELDS
5701
5745
  }),
5702
- op("keywords", "delete", "DELETE", "/campaigns/{campaign}/adgroups/{adgroup}/targetingkeywords/{id}", "Delete a targeting keyword", "delete-a-targeting-keyword", { positional: "ids" }),
5703
- op("keywords", "delete", "POST", "/campaigns/{campaign}/adgroups/{adgroup}/targetingkeywords/delete/bulk", "Delete targeting keywords (bulk)", "delete-targeting-keywords", {
5746
+ op("keywords", "delete", "destructive", "DELETE", "/campaigns/{campaign}/adgroups/{adgroup}/targetingkeywords/{id}", "Delete a targeting keyword", "delete-a-targeting-keyword", { positional: "ids" }),
5747
+ op("keywords", "delete", "destructive", "POST", "/campaigns/{campaign}/adgroups/{adgroup}/targetingkeywords/delete/bulk", "Delete targeting keywords (bulk)", "delete-targeting-keywords", {
5704
5748
  positional: "ids",
5705
5749
  body: "ids"
5706
5750
  }),
@@ -5710,29 +5754,31 @@ const ASA_OPERATIONS = [
5710
5754
  byId("negative-keywords", "/campaigns/{campaign}/adgroups/{adgroup}/negativekeywords/{id}", "Get an ad group negative keyword", "get-an-ad-group-negative-keyword"),
5711
5755
  find("negative-keywords", "/campaigns/{campaign}/negativekeywords/find", "Find campaign negative keywords", "find-campaign-negative-keywords"),
5712
5756
  find("negative-keywords", "/campaigns/{campaign}/adgroups/negativekeywords/find", "Find ad group negative keywords across a campaign", "find-ad-group-negative-keywords", { level: "adgroup" }),
5713
- op("negative-keywords", "create", "POST", "/campaigns/{campaign}/negativekeywords/bulk", "Create campaign negative keywords (bulk)", "create-campaign-negative-keywords", {
5757
+ op("negative-keywords", "create", "write", "POST", "/campaigns/{campaign}/negativekeywords/bulk", "Create campaign negative keywords (bulk)", "create-campaign-negative-keywords", {
5714
5758
  body: "array",
5715
5759
  flags: NEGATIVE_FIELDS
5716
5760
  }),
5717
- op("negative-keywords", "create", "POST", "/campaigns/{campaign}/adgroups/{adgroup}/negativekeywords/bulk", "Create ad group negative keywords (bulk)", "create-ad-group-negative-keywords", {
5761
+ op("negative-keywords", "create", "write", "POST", "/campaigns/{campaign}/adgroups/{adgroup}/negativekeywords/bulk", "Create ad group negative keywords (bulk)", "create-ad-group-negative-keywords", {
5718
5762
  body: "array",
5719
5763
  flags: NEGATIVE_FIELDS
5720
5764
  }),
5721
- op("negative-keywords", "update", "PUT", "/campaigns/{campaign}/negativekeywords/bulk", "Update campaign negative keywords (bulk)", "update-campaign-negative-keywords", {
5765
+ op("negative-keywords", "update", "destructive", "PUT", "/campaigns/{campaign}/negativekeywords/bulk", "Update campaign negative keywords (bulk)", "update-campaign-negative-keywords", {
5766
+ details: "Bulk-overwrites negative keyword configuration and can change which traffic is excluded.",
5722
5767
  positional: "id",
5723
5768
  body: "array",
5724
5769
  flags: NEGATIVE_FIELDS
5725
5770
  }),
5726
- op("negative-keywords", "update", "PUT", "/campaigns/{campaign}/adgroups/{adgroup}/negativekeywords/bulk", "Update ad group negative keywords (bulk)", "update-ad-group-negative-keywords", {
5771
+ op("negative-keywords", "update", "destructive", "PUT", "/campaigns/{campaign}/adgroups/{adgroup}/negativekeywords/bulk", "Update ad group negative keywords (bulk)", "update-ad-group-negative-keywords", {
5772
+ details: "Bulk-overwrites negative keyword configuration and can change which traffic is excluded.",
5727
5773
  positional: "id",
5728
5774
  body: "array",
5729
5775
  flags: NEGATIVE_FIELDS
5730
5776
  }),
5731
- op("negative-keywords", "delete", "POST", "/campaigns/{campaign}/negativekeywords/delete/bulk", "Delete campaign negative keywords", "delete-campaign-negative-keywords", {
5777
+ op("negative-keywords", "delete", "destructive", "POST", "/campaigns/{campaign}/negativekeywords/delete/bulk", "Delete campaign negative keywords", "delete-campaign-negative-keywords", {
5732
5778
  positional: "ids",
5733
5779
  body: "ids"
5734
5780
  }),
5735
- op("negative-keywords", "delete", "POST", "/campaigns/{campaign}/adgroups/{adgroup}/negativekeywords/delete/bulk", "Delete ad group negative keywords", "delete-ad-group-negative-keywords", {
5781
+ op("negative-keywords", "delete", "destructive", "POST", "/campaigns/{campaign}/adgroups/{adgroup}/negativekeywords/delete/bulk", "Delete ad group negative keywords", "delete-ad-group-negative-keywords", {
5736
5782
  positional: "ids",
5737
5783
  body: "ids"
5738
5784
  }),
@@ -5740,20 +5786,22 @@ const ASA_OPERATIONS = [
5740
5786
  byId("ads", "/campaigns/{campaign}/adgroups/{adgroup}/ads/{id}", "Get an ad", "get-an-ad"),
5741
5787
  find("ads", "/campaigns/{campaign}/ads/find", "Find ads in a campaign", "find-ads"),
5742
5788
  find("ads", "/ads/find", "Find ads across the org", "find-ads-(org-level)"),
5743
- op("ads", "create", "POST", "/campaigns/{campaign}/adgroups/{adgroup}/ads", "Create an ad", "create-an-ad", {
5789
+ op("ads", "create", "destructive", "POST", "/campaigns/{campaign}/adgroups/{adgroup}/ads", "Create an ad", "create-an-ad", {
5790
+ details: "Creates an ad assigned to a creative. An ENABLED ad in an eligible live group can begin serving and spending immediately.",
5744
5791
  body: "object",
5745
5792
  flags: AD_FIELDS
5746
5793
  }),
5747
- op("ads", "update", "PUT", "/campaigns/{campaign}/adgroups/{adgroup}/ads/{id}", "Update an ad", "update-an-ad", {
5794
+ op("ads", "update", "destructive", "PUT", "/campaigns/{campaign}/adgroups/{adgroup}/ads/{id}", "Update an ad", "update-an-ad", {
5795
+ details: "Overwrites ad status/name; pausing or enabling changes delivery.",
5748
5796
  positional: "id",
5749
5797
  body: "object",
5750
5798
  flags: [NAME, STATUS]
5751
5799
  }),
5752
- op("ads", "delete", "DELETE", "/campaigns/{campaign}/adgroups/{adgroup}/ads/{id}", "Delete an ad", "delete-an-ad", { positional: "id" }),
5800
+ op("ads", "delete", "destructive", "DELETE", "/campaigns/{campaign}/adgroups/{adgroup}/ads/{id}", "Delete an ad", "delete-an-ad", { positional: "id" }),
5753
5801
  list$1("creatives", "/creatives", "List creatives", "get-all-creatives"),
5754
5802
  byId("creatives", "/creatives/{id}", "Get a creative", "get-a-creative", { query: ["fields", "include-deleted-assets"] }),
5755
5803
  find("creatives", "/creatives/find", "Find creatives with a selector", "find-creatives"),
5756
- op("creatives", "create", "POST", "/creatives", "Create a creative", "create-a-creative", {
5804
+ op("creatives", "create", "write", "POST", "/creatives", "Create a creative", "create-a-creative", {
5757
5805
  body: "object",
5758
5806
  flags: [
5759
5807
  ADAM_ID,
@@ -5771,7 +5819,7 @@ const ASA_OPERATIONS = [
5771
5819
  ]
5772
5820
  }),
5773
5821
  byId("product-pages", "/apps/{adamId}/product-pages/{id}", "Get a product page", "get-product-pages-by-identifier", { query: ["adam-id"] }),
5774
- op("product-pages", "locales", "GET", "/apps/{adamId}/product-pages/{id}/locale-details", "Get a product page's locales", "get-product-page-locales", {
5822
+ op("product-pages", "locales", "read", "GET", "/apps/{adamId}/product-pages/{id}/locale-details", "Get a product page's locales", "get-product-page-locales", {
5775
5823
  positional: "id",
5776
5824
  query: [
5777
5825
  "adam-id",
@@ -5780,45 +5828,46 @@ const ASA_OPERATIONS = [
5780
5828
  "expand"
5781
5829
  ]
5782
5830
  }),
5783
- op("product-pages", "countries", "GET", "/countries-or-regions", "List supported countries or regions", "get-supported-countries-or-regions", { query: ["countries"] }),
5784
- op("product-pages", "device-sizes", "GET", "/creativeappmappings/devices", "List app preview device sizes", "get-app-preview-device-sizes"),
5831
+ op("product-pages", "countries", "read", "GET", "/countries-or-regions", "List supported countries or regions", "get-supported-countries-or-regions", { query: ["countries"] }),
5832
+ op("product-pages", "device-sizes", "read", "GET", "/creativeappmappings/devices", "List app preview device sizes", "get-app-preview-device-sizes"),
5785
5833
  find("ad-rejections", "/product-page-reasons/find", "Find ad creative rejection reasons", "find-ad-creative-rejection-reasons"),
5786
5834
  byId("ad-rejections", "/product-page-reasons/{id}", "Get an ad creative rejection reason", "gets-a-product-page-reason"),
5787
5835
  find("ad-rejections", "/apps/{adamId}/assets/find", "Find an app's assets", "find-app-assets", {
5788
5836
  action: "assets",
5837
+ details: "Retrieves asset metadata with a selector using POST; does not modify assets or start a job.",
5789
5838
  query: [...SELECTOR_QUERY, "adam-id"]
5790
5839
  }),
5791
- op("reports", "campaigns", "POST", "/reports/campaigns", "Campaign-level report", "get-campaign-level-reports", {
5840
+ op("reports", "campaigns", "read", "POST", "/reports/campaigns", "Campaign-level report", "get-campaign-level-reports", {
5792
5841
  body: "report",
5793
5842
  flags: REPORT_FLAGS
5794
5843
  }),
5795
- op("reports", "adgroups", "POST", "/reports/campaigns/{campaign}/adgroups", "Ad group-level report", "get-ad-group-level-reports", {
5844
+ op("reports", "adgroups", "read", "POST", "/reports/campaigns/{campaign}/adgroups", "Ad group-level report", "get-ad-group-level-reports", {
5796
5845
  body: "report",
5797
5846
  flags: REPORT_FLAGS
5798
5847
  }),
5799
- op("reports", "keywords", "POST", "/reports/campaigns/{campaign}/keywords", "Keyword-level report", "get-keyword-level-reports", {
5848
+ op("reports", "keywords", "read", "POST", "/reports/campaigns/{campaign}/keywords", "Keyword-level report", "get-keyword-level-reports", {
5800
5849
  body: "report",
5801
5850
  flags: REPORT_FLAGS
5802
5851
  }),
5803
- op("reports", "keywords", "POST", "/reports/campaigns/{campaign}/adgroups/{adgroup}/keywords", "Keyword-level report within an ad group", "get-keyword-level-within-ad-group-reports", {
5852
+ op("reports", "keywords", "read", "POST", "/reports/campaigns/{campaign}/adgroups/{adgroup}/keywords", "Keyword-level report within an ad group", "get-keyword-level-within-ad-group-reports", {
5804
5853
  body: "report",
5805
5854
  flags: REPORT_FLAGS
5806
5855
  }),
5807
- op("reports", "searchterms", "POST", "/reports/campaigns/{campaign}/searchterms", "Search term-level report", "get-search-term-level-reports", {
5856
+ op("reports", "searchterms", "read", "POST", "/reports/campaigns/{campaign}/searchterms", "Search term-level report", "get-search-term-level-reports", {
5808
5857
  body: "report",
5809
5858
  flags: REPORT_FLAGS
5810
5859
  }),
5811
- op("reports", "searchterms", "POST", "/reports/campaigns/{campaign}/adgroups/{adgroup}/searchterms", "Search term-level report within an ad group", "get-search-term-level-within-ad-group-reports", {
5860
+ op("reports", "searchterms", "read", "POST", "/reports/campaigns/{campaign}/adgroups/{adgroup}/searchterms", "Search term-level report within an ad group", "get-search-term-level-within-ad-group-reports", {
5812
5861
  body: "report",
5813
5862
  flags: REPORT_FLAGS
5814
5863
  }),
5815
- op("reports", "ads", "POST", "/reports/campaigns/{campaign}/ads", "Ad-level report", "get-ad-level-reports", {
5864
+ op("reports", "ads", "read", "POST", "/reports/campaigns/{campaign}/ads", "Ad-level report", "get-ad-level-reports", {
5816
5865
  body: "report",
5817
5866
  flags: REPORT_FLAGS
5818
5867
  }),
5819
5868
  list$1("impression-share", "/custom-reports", "List impression share reports", "get-all-impression-share-reports"),
5820
5869
  byId("impression-share", "/custom-reports/{id}", "Get an impression share report", "get-a-single-impression-share-report"),
5821
- op("impression-share", "create", "POST", "/custom-reports", "Request an impression share report", "impression-share-report", {
5870
+ op("impression-share", "create", "write", "POST", "/custom-reports", "Request an impression share report", "impression-share-report", {
5822
5871
  body: "object",
5823
5872
  flags: [
5824
5873
  NAME,
@@ -5829,7 +5878,7 @@ const ASA_OPERATIONS = [
5829
5878
  flag("metrics", "metrics", "list", "Comma-separated metrics")
5830
5879
  ]
5831
5880
  }),
5832
- op("apps", "search", "GET", "/search/apps", "Search the App Store for apps", "search-for-ios-apps", {
5881
+ op("apps", "search", "read", "GET", "/search/apps", "Search the App Store for apps", "search-for-ios-apps", {
5833
5882
  positional: "query",
5834
5883
  paged: "query",
5835
5884
  query: [
@@ -5841,11 +5890,12 @@ const ASA_OPERATIONS = [
5841
5890
  }),
5842
5891
  find("apps", "/apps/{adamId}/eligibilities/find", "Find an app's eligibility records", "find-app-eligibility-records", {
5843
5892
  action: "eligibility",
5893
+ details: "Retrieves app eligibility records using POST; does not change eligibility or start a job.",
5844
5894
  positional: "adam-id"
5845
5895
  }),
5846
- op("apps", "get", "GET", "/apps/{adamId}", "Get app details", "get-app-details", { positional: "adam-id" }),
5847
- op("apps", "localized", "GET", "/apps/{adamId}/locale-details", "Get localized app details", "get-localized-app-details", { positional: "adam-id" }),
5848
- op("geo", "search", "GET", "/search/geo", "Search geolocations", "search-for-geolocations", {
5896
+ op("apps", "get", "read", "GET", "/apps/{adamId}", "Get app details", "get-app-details", { positional: "adam-id" }),
5897
+ op("apps", "localized", "read", "GET", "/apps/{adamId}/locale-details", "Get localized app details", "get-localized-app-details", { positional: "adam-id" }),
5898
+ op("geo", "search", "read", "GET", "/search/geo", "Search geolocations", "search-for-geolocations", {
5849
5899
  positional: "query",
5850
5900
  paged: "query",
5851
5901
  query: [
@@ -5856,20 +5906,25 @@ const ASA_OPERATIONS = [
5856
5906
  "all"
5857
5907
  ]
5858
5908
  }),
5859
- op("geo", "get", "POST", "/search/geo", "Look up geolocations by id", "get-a-list-of-geo-locations", {
5909
+ op("geo", "get", "read", "POST", "/search/geo", "Look up geolocations by id", "get-a-list-of-geo-locations", {
5910
+ details: "Retrieves geolocations by ID using POST; does not create locations or start a job.",
5860
5911
  positional: "ids",
5861
5912
  body: "geo",
5862
5913
  query: ["entity"]
5863
5914
  }),
5864
5915
  list$1("budget-orders", "/budgetorders", "List budget orders", "get-all-budget-orders"),
5865
5916
  byId("budget-orders", "/budgetorders/{id}", "Get a budget order", "get-a-budget-order"),
5866
- op("budget-orders", "create", "POST", "/budgetorders", "Create a budget order", "create-a-budget-order", { body: "object" }),
5867
- op("budget-orders", "update", "PUT", "/budgetorders/{id}", "Update a budget order", "update-a-budget-order", {
5917
+ op("budget-orders", "create", "destructive", "POST", "/budgetorders", "Create a budget order", "create-a-budget-order", {
5918
+ details: "Creates a financial budget order for the organization. Apple can return it ACTIVE; the request is not restricted to a draft allocation.",
5919
+ body: "object"
5920
+ }),
5921
+ op("budget-orders", "update", "destructive", "PUT", "/budgetorders/{id}", "Update a budget order", "update-a-budget-order", {
5922
+ details: "Overwrites a financial budget order using an unrestricted request body.",
5868
5923
  positional: "id",
5869
5924
  body: "object"
5870
5925
  }),
5871
- op("acls", "list", "GET", "/acls", "List the orgs this API user can access", "get-user-acl"),
5872
- op("me", "get", "GET", "/me", "Show the calling API user", "get-me-details")
5926
+ op("acls", "list", "read", "GET", "/acls", "List the orgs this API user can access", "get-user-acl"),
5927
+ op("me", "get", "read", "GET", "/me", "Show the calling API user", "get-me-details")
5873
5928
  ];
5874
5929
  const PLACEHOLDERS = [
5875
5930
  "campaign",
@@ -6069,7 +6124,7 @@ function renderAsaHelp(words) {
6069
6124
  usage: formatAsaUsage(op$1),
6070
6125
  summary: variants.map((variant) => variant.summary).join("; "),
6071
6126
  flags: formatAsaFlags(op$1, variants),
6072
- details: `Apple's schema for it: superwall asa docs ${group$1} ${action}`
6127
+ details: [...new Set(variants.map((variant) => variant.details).filter(Boolean)), `Apple's schema for it: superwall asa docs ${group$1} ${action}`].join("\n\n")
6073
6128
  });
6074
6129
  }
6075
6130
 
@@ -6866,17 +6921,17 @@ function toolOf$1(group$1, action) {
6866
6921
  description: "Ad group negative keywords instead of the campaign's"
6867
6922
  };
6868
6923
  }
6869
- const method = first?.method ?? "GET";
6924
+ const effect = variants.some((variant) => variant.effect === "destructive") ? "destructive" : variants.every((variant) => variant.effect === "read") ? "read" : "write";
6870
6925
  return {
6871
6926
  words: [group$1, action],
6872
6927
  summary: variants.map((variant) => variant.summary).join("; "),
6873
- details: `Apple's schema for it: the asa_docs tool with "${group$1} ${action}".`,
6928
+ details: [...new Set(variants.map((variant) => variant.details).filter(Boolean)), `Apple's schema for it: the asa_docs tool with "${group$1} ${action}".`].join("\n\n"),
6874
6929
  positionals,
6875
6930
  input: {
6876
6931
  properties,
6877
6932
  required: [...new Set(required)]
6878
6933
  },
6879
- effect: method === "DELETE" || action === "delete" ? "destructive" : method === "GET" || action === "find" || group$1 === "reports" ? "read" : "write"
6934
+ effect
6880
6935
  };
6881
6936
  }
6882
6937
  async function listAsaTools() {
@@ -7528,6 +7583,7 @@ const command$42 = defineCommand({
7528
7583
  const command$43 = defineCommand({
7529
7584
  name: "asa post",
7530
7585
  summary: "Any POST request to the Apple Search Ads API",
7586
+ details: "Executes an arbitrary Apple Ads POST. It can bulk-delete resources, activate advertising or create financial budget orders; repeating a call may repeat its effects.",
7531
7587
  args: { path: {
7532
7588
  describe: "Apple Search Ads API path, e.g. /campaigns (the /api/v5 prefix is added)",
7533
7589
  required: true
@@ -7556,7 +7612,7 @@ const command$43 = defineCommand({
7556
7612
  auth: "required",
7557
7613
  json: true,
7558
7614
  prompts: false,
7559
- mcp: "write",
7615
+ mcp: "destructive",
7560
7616
  async run(ctx, { args, flags }) {
7561
7617
  const res = await runAsaRequest(ctx, ctx.api, {
7562
7618
  verb: "post",
@@ -7574,6 +7630,7 @@ const command$43 = defineCommand({
7574
7630
  const command$44 = defineCommand({
7575
7631
  name: "asa put",
7576
7632
  summary: "Any PUT request to the Apple Search Ads API",
7633
+ details: "Executes an arbitrary Apple Ads PUT. It can overwrite bids, targeting, budgets and delivery status.",
7577
7634
  args: { path: {
7578
7635
  describe: "Apple Search Ads API path, e.g. /campaigns (the /api/v5 prefix is added)",
7579
7636
  required: true
@@ -7602,7 +7659,7 @@ const command$44 = defineCommand({
7602
7659
  auth: "required",
7603
7660
  json: true,
7604
7661
  prompts: false,
7605
- mcp: "write",
7662
+ mcp: "destructive",
7606
7663
  async run(ctx, { args, flags }) {
7607
7664
  const res = await runAsaRequest(ctx, ctx.api, {
7608
7665
  verb: "put",
@@ -7645,7 +7702,7 @@ const command$45 = defineCommand({
7645
7702
  mcp: false,
7646
7703
  channel: "next",
7647
7704
  async run(ctx, { args, flags }) {
7648
- const { runBuildPipeline } = await import("./build-Gpdq5QXP.js");
7705
+ const { runBuildPipeline } = await import("./build-5PQeSnNN.js");
7649
7706
  await runBuildPipeline({
7650
7707
  output: ctx.output,
7651
7708
  json: ctx.json
@@ -7707,7 +7764,7 @@ const command$46 = defineCommand({
7707
7764
  mcp: false,
7708
7765
  channel: "next",
7709
7766
  async run(ctx, { args, flags }) {
7710
- const { runCreate } = await import("./create-Cwc3SRWJ.js");
7767
+ const { runCreate } = await import("./create-VK-pNfN7.js");
7711
7768
  return runCreate(ctx, {
7712
7769
  dir: args.dir,
7713
7770
  ...flags
@@ -7751,7 +7808,7 @@ const command$47 = defineCommand({
7751
7808
  mcp: false,
7752
7809
  channel: "next",
7753
7810
  async run(ctx, { args, flags }) {
7754
- const { runStudio } = await import("./server-z1LH94R_.js");
7811
+ const { runStudio } = await import("./server-CwrZ-I1r.js");
7755
7812
  await runStudio({
7756
7813
  dirs: args.dir,
7757
7814
  port: flags.port,
@@ -7792,7 +7849,7 @@ const command$48 = defineCommand({
7792
7849
  mcp: false,
7793
7850
  channel: "next",
7794
7851
  async run(ctx, input) {
7795
- const { runPromote } = await import("./promote-COD4fYdz.js");
7852
+ const { runPromote } = await import("./promote-DPGPamkE.js");
7796
7853
  return runPromote(ctx, input);
7797
7854
  }
7798
7855
  });
@@ -7837,7 +7894,7 @@ const command$49 = defineCommand({
7837
7894
  mcp: false,
7838
7895
  channel: "next",
7839
7896
  async run(ctx, input) {
7840
- const { runPush } = await import("./push-CtD4FZQV.js");
7897
+ const { runPush } = await import("./push-Chp21y3a.js");
7841
7898
  return runPush(ctx, input, true);
7842
7899
  }
7843
7900
  });
@@ -7882,7 +7939,7 @@ const command$50 = defineCommand({
7882
7939
  mcp: false,
7883
7940
  channel: "next",
7884
7941
  async run(ctx, input) {
7885
- const { runPush } = await import("./push-CtD4FZQV.js");
7942
+ const { runPush } = await import("./push-Chp21y3a.js");
7886
7943
  return runPush(ctx, input, false);
7887
7944
  }
7888
7945
  });
@@ -7999,7 +8056,7 @@ function resourceHelp(resource) {
7999
8056
  })),
8000
8057
  {
8001
8058
  title: "Related",
8002
- lines: table((resource.related ?? []).map(([command$67, text]) => [`superwall ${command$67}`, pc.dim(text)]), ([left]) => left.length)
8059
+ lines: table((resource.related ?? []).map(([command$68, text]) => [`superwall ${command$68}`, pc.dim(text)]), ([left]) => left.length)
8003
8060
  },
8004
8061
  {
8005
8062
  title: "Examples",
@@ -8271,7 +8328,7 @@ async function createApp(context, api, nameArg, fields) {
8271
8328
  let name = nameArg;
8272
8329
  let platform = textOf(fields.platform);
8273
8330
  if (interactive && (!name || !platform)) {
8274
- const { scanProject } = await import("./scan-Cv5uOwVY.js");
8331
+ const { scanProject } = await import("./scan-B1SkkUi7.js");
8275
8332
  const detected = (await scanProject(context.installDir).catch(() => null))?.apps[0];
8276
8333
  if (detected && !name && !platform) {
8277
8334
  ui.info(`Detected \`${detected.framework.name}\`` + (detected.details ? ` · \`${detected.details}\`` : ""));
@@ -8510,7 +8567,7 @@ async function runResource(ctx, resource, action, value$1, value2, flags) {
8510
8567
  if (action === "create") return create(ctx, ctx.api, resource, value$1, value2, flags);
8511
8568
  if (action === "use" && resource === "apps") return useApp(ctx, ctx.api, value$1);
8512
8569
  if (action === "storekit" && resource === "products") {
8513
- const { writeStoreKit } = await import("./storekit-DafAnGkM.js");
8570
+ const { writeStoreKit } = await import("./storekit-DHNxDDpA.js");
8514
8571
  return writeStoreKit(ctx, ctx.api, flags.fields.out);
8515
8572
  }
8516
8573
  throw new Error(`Unknown action "${action}" for ${resource}.`);
@@ -8524,15 +8581,15 @@ async function runOperation(ctx, owner, resource, op$1, args, flags) {
8524
8581
  }
8525
8582
  const toFlag = (field) => `--${field.replace(/_/g, "-")}`;
8526
8583
  async function callOperation(context, owner, resource, op$1, ids, flags, merged = {}) {
8527
- const command$67 = `superwall ${owner === resource ? "" : `${owner.name} `}${resource.name} ${op$1.name}`;
8584
+ const command$68 = `superwall ${owner === resource ? "" : `${owner.name} `}${resource.name} ${op$1.name}`;
8528
8585
  const { method, path: template } = op$1;
8529
- if (!method || !template) throw new Error(`${command$67} has no API endpoint.`);
8586
+ if (!method || !template) throw new Error(`${command$68} has no API endpoint.`);
8530
8587
  const spec = await apiCall(context, "Loading the API reference", () => findSpec(op$1));
8531
8588
  const args = [...ids];
8532
8589
  const ctx = owner.appArg && args[0] && !context.target.app ? withApp(context, args.shift()) : context;
8533
8590
  const positional = positionalParams(op$1);
8534
- if (args.length < positional.length) throw new Error(`Usage: ${command$67} ${usageOf(owner, op$1)}\nRun \`${command$67} --help\` for its flags.`);
8535
- if (args.length > positional.length) throw new Error(`${command$67} takes ${positional.length || "no"} argument${positional.length === 1 ? "" : "s"}; got "${args.slice(positional.length).join(" ")}".`);
8591
+ if (args.length < positional.length) throw new Error(`Usage: ${command$68} ${usageOf(owner, op$1)}\nRun \`${command$68} --help\` for its flags.`);
8592
+ if (args.length > positional.length) throw new Error(`${command$68} takes ${positional.length || "no"} argument${positional.length === 1 ? "" : "s"}; got "${args.slice(positional.length).join(" ")}".`);
8536
8593
  const pathValues = /* @__PURE__ */ new Map();
8537
8594
  const query = {};
8538
8595
  const queryNames = new Set(spec?.params.filter((param) => param.in === "query").map((param) => param.name));
@@ -8552,7 +8609,7 @@ async function callOperation(context, owner, resource, op$1, ids, flags, merged
8552
8609
  if (queryParam) query[field] = coerce(raw, queryParam.type);
8553
8610
  else if (bodyField) body[field] = coerce(raw, bodyField.type);
8554
8611
  else if (!spec) (sendsBody ? body : query)[field] = raw;
8555
- else throw new Error(`${command$67} has no ${toFlag(field)}. \`${command$67} --help\` lists what it takes.`);
8612
+ else throw new Error(`${command$68} has no ${toFlag(field)}. \`${command$68} --help\` lists what it takes.`);
8556
8613
  }
8557
8614
  Object.assign(sendsBody ? body : query, parseParams(flags.data));
8558
8615
  await fillScope(ctx, op$1, spec, pathValues, query, body);
@@ -8561,11 +8618,11 @@ async function callOperation(context, owner, resource, op$1, ids, flags, merged
8561
8618
  });
8562
8619
  if (missing$1.length > 0) {
8563
8620
  const needs = missing$1.map((param) => `${toFlag(param.name)} <${param.type.replace(/"/g, "").replace(/ \| /g, "|")}>`);
8564
- throw new Error(`${command$67} needs ${needs.join(" and ")}.`);
8621
+ throw new Error(`${command$68} needs ${needs.join(" and ")}.`);
8565
8622
  }
8566
8623
  const url = withQuery(template.replace(/\{([^}]+)\}/g, (_, param) => {
8567
8624
  const value$1 = pathValues.get(param);
8568
- if (value$1 === void 0) throw new Error(`${command$67} needs ${param}.`);
8625
+ if (value$1 === void 0) throw new Error(`${command$68} needs ${param}.`);
8569
8626
  return encodeURIComponent(value$1);
8570
8627
  }), query);
8571
8628
  if (ctx.dryRun) return renderValue(ctx, {
@@ -8641,6 +8698,7 @@ function coerce(raw, type) {
8641
8698
  return text;
8642
8699
  }
8643
8700
  if (type === "null") return null;
8701
+ if (text === "null" && type.split("|").some((part) => part.trim() === "null")) return null;
8644
8702
  return typeof raw === "number" && !/\b(number|integer)\b/.test(type) ? text : raw;
8645
8703
  }
8646
8704
  function withQuery(path, params) {
@@ -8676,7 +8734,7 @@ async function dispatch(ctx, owner, words, flags) {
8676
8734
  const nested = rest[0] ? findNested(owner, rest[0]) : void 0;
8677
8735
  if (nested) rest = rest.slice(1);
8678
8736
  const resource = nested ?? owner;
8679
- const command$67 = nested ? `${owner.name} ${nested.name}` : owner.name;
8737
+ const command$68 = nested ? `${owner.name} ${nested.name}` : owner.name;
8680
8738
  if (rest[0] && /^(\d+|https?:\/\/.*)$/.test(rest[0]) && findOperation(resource, "get")) rest = ["get", ...rest];
8681
8739
  const [opName, ...args] = rest;
8682
8740
  if (!opName) {
@@ -8688,7 +8746,7 @@ async function dispatch(ctx, owner, words, flags) {
8688
8746
  if (!op$1) {
8689
8747
  const known = resource.operations.map((candidate) => candidate.name);
8690
8748
  const nestedNames = nested ? [] : (owner.nested ?? []).map((candidate) => candidate.name);
8691
- throw new UsageError(`${command$67} has no "${opName}". It takes: ${[...known, ...nestedNames].join(", ")}.\nRun superwall ${command$67} --help for what each does.`, command$67);
8749
+ throw new UsageError(`${command$68} has no "${opName}". It takes: ${[...known, ...nestedNames].join(", ")}.\nRun superwall ${command$68} --help for what each does.`, command$68);
8692
8750
  }
8693
8751
  await runOperation(ctx, owner, resource, op$1, args, flags);
8694
8752
  }
@@ -8806,8 +8864,6 @@ async function toolOf(owner, resource, op$1, flags) {
8806
8864
  if (!required.includes(name)) required.push(name);
8807
8865
  }
8808
8866
  for (const name of op$1.mcpOmit ?? []) delete properties[name];
8809
- const readOnly = op$1.method === "GET" || op$1.name === "list" || op$1.name === "get";
8810
- const effect = op$1.destructive ? "destructive" : readOnly ? "read" : "write";
8811
8867
  return {
8812
8868
  words,
8813
8869
  summary: op$1.summary,
@@ -8817,7 +8873,7 @@ async function toolOf(owner, resource, op$1, flags) {
8817
8873
  properties,
8818
8874
  required
8819
8875
  },
8820
- effect: op$1.mcp ?? effect
8876
+ effect: op$1.mcp ?? op$1.effect
8821
8877
  };
8822
8878
  }
8823
8879
  async function listResourceTools(owner, flags) {
@@ -8883,8 +8939,58 @@ function defineResource(resource) {
8883
8939
  }
8884
8940
 
8885
8941
  //#endregion
8886
- //#region src/commands/main/apps.ts
8942
+ //#region src/commands/main/annotations.ts
8887
8943
  const command$51 = defineResource({
8944
+ name: "annotations",
8945
+ summary: "Releases, campaigns and incidents marked on an app's charts",
8946
+ operations: [
8947
+ {
8948
+ name: "list",
8949
+ summary: "Annotations of an app",
8950
+ effect: "read",
8951
+ details: "With --from and --to, only those overlapping that window.",
8952
+ method: "GET",
8953
+ path: "/v2/applications/{application_id}/chart_annotations",
8954
+ list: true
8955
+ },
8956
+ {
8957
+ name: "get",
8958
+ summary: "One annotation",
8959
+ effect: "read",
8960
+ method: "GET",
8961
+ path: "/v2/applications/{application_id}/chart_annotations/{chart_annotation_id}"
8962
+ },
8963
+ {
8964
+ name: "create",
8965
+ summary: "Mark a moment or a span on every chart of an app",
8966
+ effect: "write",
8967
+ method: "POST",
8968
+ path: "/v2/applications/{application_id}/chart_annotations"
8969
+ },
8970
+ {
8971
+ name: "update",
8972
+ summary: "Change an annotation",
8973
+ effect: "destructive",
8974
+ details: "Overwrites only the fields supplied. --end-at null turns a span into a point; --description null removes the description.",
8975
+ method: "PATCH",
8976
+ path: "/v2/applications/{application_id}/chart_annotations/{chart_annotation_id}"
8977
+ },
8978
+ {
8979
+ name: "delete",
8980
+ summary: "Delete an annotation",
8981
+ effect: "destructive",
8982
+ details: "Removes it from every chart of the app. This can't be undone.",
8983
+ method: "DELETE",
8984
+ path: "/v2/applications/{application_id}/chart_annotations/{chart_annotation_id}",
8985
+ destructive: true
8986
+ }
8987
+ ],
8988
+ examples: [["annotations list --app <app>", "Everything marked on an app's charts"], ["annotations create --app <app> --label \"v4.2.0 released\" --start-at 2026-10-28T14:00:00Z", "Mark today's release"]]
8989
+ });
8990
+
8991
+ //#endregion
8992
+ //#region src/commands/main/apps.ts
8993
+ const command$52 = defineResource({
8888
8994
  name: "apps",
8889
8995
  summary: "Every app you can open",
8890
8996
  appArg: true,
@@ -8892,6 +8998,7 @@ const command$51 = defineResource({
8892
8998
  {
8893
8999
  name: "list",
8894
9000
  summary: "Every app, by organization and project",
9001
+ effect: "read",
8895
9002
  handler: "resource",
8896
9003
  usage: "",
8897
9004
  flags: [["--search <text>", "Only projects or apps whose id, name or bundle ID contains this"], ["--limit <n>", "At most this many projects"]]
@@ -8899,12 +9006,14 @@ const command$51 = defineResource({
8899
9006
  {
8900
9007
  name: "get",
8901
9008
  summary: "Everything about one app: bundle ID, Apple team, keys, URLs",
9009
+ effect: "read",
8902
9010
  handler: "apps.get",
8903
9011
  usage: "<app>"
8904
9012
  },
8905
9013
  {
8906
9014
  name: "create",
8907
9015
  summary: "Add an app to a project",
9016
+ effect: "write",
8908
9017
  handler: "resource",
8909
9018
  usage: "--name <name> --platform <platform>",
8910
9019
  flags: [
@@ -8917,6 +9026,7 @@ const command$51 = defineResource({
8917
9026
  {
8918
9027
  name: "update",
8919
9028
  summary: "Change its bundle ID, Apple team ID, URL scheme, support URL, ...",
9029
+ effect: "destructive",
8920
9030
  handler: "apps.update",
8921
9031
  method: "PATCH",
8922
9032
  path: "/v2/projects/{id}/applications/{application_id}/settings",
@@ -8934,11 +9044,14 @@ const command$51 = defineResource({
8934
9044
  run in test mode under it, it says how many and asks.
8935
9045
  --revenue-provider chooses which events the dashboard's revenue figures count. Events from
8936
9046
  both sources keep arriving and being stored; it says what changes and asks first.
8937
- Outside a terminal both need --yes.`
9047
+ Outside a terminal both need --yes.
9048
+
9049
+ Overwrites app settings, including routing, revenue provider and bundle ID. Changing the bundle ID can put deployed builds into test mode.`
8938
9050
  },
8939
9051
  {
8940
9052
  name: "use",
8941
9053
  summary: "Make it the app commands use when --app is left out",
9054
+ effect: "write",
8942
9055
  handler: "resource",
8943
9056
  usage: "<app>",
8944
9057
  mcp: false
@@ -8946,6 +9059,7 @@ Outside a terminal both need --yes.`
8946
9059
  {
8947
9060
  name: "statistics",
8948
9061
  summary: "Users, revenue and conversion, as the dashboard's overview shows them",
9062
+ effect: "read",
8949
9063
  method: "GET",
8950
9064
  path: "/v2/projects/{id}/applications/{application_id}/statistics",
8951
9065
  details: `The overview figures, computed as the dashboard computes them. Pass --environment and
@@ -8959,6 +9073,7 @@ For anything the overview doesn't show, run SQL with \`superwall query\`.`,
8959
9073
  {
8960
9074
  name: "transactions",
8961
9075
  summary: "Its most recent transactions, as the dashboard lists them",
9076
+ effect: "read",
8962
9077
  method: "GET",
8963
9078
  path: "/v2/projects/{id}/applications/{application_id}/recent-transactions",
8964
9079
  details: `The dashboard's recent-transactions list. Pass --environment, --from and --to.
@@ -8972,6 +9087,7 @@ To count, group or filter transactions, run SQL with \`superwall query\`.`,
8972
9087
  {
8973
9088
  name: "notices",
8974
9089
  summary: "What the dashboard warns about on its overview",
9090
+ effect: "read",
8975
9091
  method: "GET",
8976
9092
  path: "/v2/projects/{id}/applications/{application_id}/overview-notices",
8977
9093
  bind: {
@@ -9127,7 +9243,7 @@ function renderAccountTree(tree) {
9127
9243
 
9128
9244
  //#endregion
9129
9245
  //#region src/commands/main/bootstrap.ts
9130
- const command$52 = defineCommand({
9246
+ const command$53 = defineCommand({
9131
9247
  name: "bootstrap",
9132
9248
  summary: "Everything at once: projects, apps, campaigns, products",
9133
9249
  details: "The complete account tree: organizations, projects, apps, campaigns and their placements,\npaywalls, products and entitlements.",
@@ -9160,25 +9276,28 @@ const command$52 = defineCommand({
9160
9276
 
9161
9277
  //#endregion
9162
9278
  //#region src/commands/main/campaigns.ts
9163
- const command$53 = defineResource({
9279
+ const command$54 = defineResource({
9164
9280
  name: "campaigns",
9165
9281
  summary: "Who sees which paywall, and when",
9166
9282
  operations: [
9167
9283
  {
9168
9284
  name: "list",
9169
9285
  summary: "Campaigns of an app",
9286
+ effect: "read",
9170
9287
  handler: "resource",
9171
9288
  flags: LIST_FLAGS
9172
9289
  },
9173
9290
  {
9174
9291
  name: "get",
9175
9292
  summary: "One campaign with its audiences and placements",
9293
+ effect: "read",
9176
9294
  method: "GET",
9177
9295
  path: "/v2/campaigns/{id}"
9178
9296
  },
9179
9297
  {
9180
9298
  name: "create",
9181
9299
  summary: "Create a campaign that a placement triggers",
9300
+ effect: "write",
9182
9301
  handler: "resource",
9183
9302
  usage: "--description <text> --placement <placement>",
9184
9303
  flags: [["--description <text>", "What the campaign is for"], ["--placement <name>", "The event that triggers it"]]
@@ -9186,12 +9305,15 @@ const command$53 = defineResource({
9186
9305
  {
9187
9306
  name: "update",
9188
9307
  summary: "Change a campaign",
9308
+ details: "Overwrites supplied campaign fields, including description, notes and delivery mode.",
9309
+ effect: "destructive",
9189
9310
  method: "PATCH",
9190
9311
  path: "/v2/campaigns/{id}"
9191
9312
  },
9192
9313
  {
9193
9314
  name: "archive",
9194
9315
  summary: "Archive it",
9316
+ effect: "destructive",
9195
9317
  method: "POST",
9196
9318
  path: "/v2/campaigns/{id}/archive",
9197
9319
  destructive: true
@@ -9199,18 +9321,22 @@ const command$53 = defineResource({
9199
9321
  {
9200
9322
  name: "unarchive",
9201
9323
  summary: "Bring it back",
9324
+ effect: "write",
9202
9325
  method: "POST",
9203
9326
  path: "/v2/campaigns/{id}/unarchive"
9204
9327
  },
9205
9328
  {
9206
9329
  name: "prioritize",
9207
9330
  summary: "Put it first",
9331
+ details: "Enabling priority clears priority on other campaigns in the app before prioritizing this campaign.",
9332
+ effect: "destructive",
9208
9333
  method: "POST",
9209
9334
  path: "/v2/campaigns/{id}/prioritize"
9210
9335
  },
9211
9336
  {
9212
9337
  name: "counts",
9213
9338
  summary: "How many users each audience assigned",
9339
+ effect: "read",
9214
9340
  method: "GET",
9215
9341
  path: "/v2/campaigns/{id}/assignment-counts",
9216
9342
  details: "Exactly what the dashboard shows. For anything else about revenue, users or events, run SQL with `query`."
@@ -9224,18 +9350,23 @@ const command$53 = defineResource({
9224
9350
  {
9225
9351
  name: "create",
9226
9352
  summary: "Trigger it on an event",
9353
+ effect: "destructive",
9227
9354
  method: "POST",
9228
- path: "/v2/campaigns/{id}/placements"
9355
+ path: "/v2/campaigns/{id}/placements",
9356
+ destructive: true
9229
9357
  },
9230
9358
  {
9231
9359
  name: "update",
9232
9360
  summary: "Change a placement",
9361
+ details: "Changes event name, enabled state or delivery mode and refreshes live configuration. Can stop or redirect an existing trigger.",
9362
+ effect: "destructive",
9233
9363
  method: "PATCH",
9234
9364
  path: "/v2/campaigns/{id}/placements/{placement_id}"
9235
9365
  },
9236
9366
  {
9237
9367
  name: "delete",
9238
9368
  summary: "Stop triggering it on an event",
9369
+ effect: "destructive",
9239
9370
  method: "DELETE",
9240
9371
  path: "/v2/campaigns/{id}/placements/{placement_id}",
9241
9372
  destructive: true
@@ -9249,18 +9380,23 @@ const command$53 = defineResource({
9249
9380
  {
9250
9381
  name: "create",
9251
9382
  summary: "Add an audience",
9383
+ details: "Appends an audience after existing audiences. It is enabled unless disabled explicitly; existing audience precedence is preserved.",
9384
+ effect: "write",
9252
9385
  method: "POST",
9253
9386
  path: "/v2/campaigns/{id}/audiences"
9254
9387
  },
9255
9388
  {
9256
9389
  name: "update",
9257
9390
  summary: "Change its rules or name",
9391
+ effect: "destructive",
9258
9392
  method: "PATCH",
9259
- path: "/v2/campaigns/{id}/audiences/{audience_id}"
9393
+ path: "/v2/campaigns/{id}/audiences/{audience_id}",
9394
+ destructive: true
9260
9395
  },
9261
9396
  {
9262
9397
  name: "delete",
9263
9398
  summary: "Remove an audience",
9399
+ effect: "destructive",
9264
9400
  method: "DELETE",
9265
9401
  path: "/v2/campaigns/{id}/audiences/{audience_id}",
9266
9402
  destructive: true
@@ -9268,18 +9404,23 @@ const command$53 = defineResource({
9268
9404
  {
9269
9405
  name: "duplicate",
9270
9406
  summary: "Copy an audience",
9407
+ details: "Copies the audience and variants into a paused audience immediately after the source. Legacy or duplicate ranks can trigger a rewrite of existing audience ranks.",
9408
+ effect: "destructive",
9271
9409
  method: "POST",
9272
9410
  path: "/v2/campaigns/{id}/audiences/{audience_id}/duplicate"
9273
9411
  },
9274
9412
  {
9275
9413
  name: "reorder",
9276
9414
  summary: "Set the order audiences are matched in",
9415
+ details: "Replaces matching precedence for existing audiences; existing users may match a different audience.",
9416
+ effect: "destructive",
9277
9417
  method: "PUT",
9278
9418
  path: "/v2/campaigns/{id}/audiences/order"
9279
9419
  },
9280
9420
  {
9281
9421
  name: "reset",
9282
9422
  summary: "Forget who was assigned to it",
9423
+ effect: "destructive",
9283
9424
  method: "POST",
9284
9425
  path: "/v2/campaigns/{id}/audiences/{audience_id}/reset",
9285
9426
  destructive: true
@@ -9287,6 +9428,7 @@ const command$53 = defineResource({
9287
9428
  {
9288
9429
  name: "readout",
9289
9430
  summary: "How its variants are doing: conversion and revenue per variant",
9431
+ effect: "read",
9290
9432
  method: "GET",
9291
9433
  path: "/v2/campaigns/{id}/audiences/{audience_id}/readout",
9292
9434
  details: "Exactly what the dashboard shows. For anything else about revenue, users or events, run SQL with `query`."
@@ -9294,6 +9436,7 @@ const command$53 = defineResource({
9294
9436
  {
9295
9437
  name: "users",
9296
9438
  summary: "Users it matched",
9439
+ effect: "read",
9297
9440
  method: "GET",
9298
9441
  path: "/v2/campaigns/{id}/audiences/{audience_id}/users",
9299
9442
  list: true
@@ -9301,6 +9444,7 @@ const command$53 = defineResource({
9301
9444
  {
9302
9445
  name: "purchasers",
9303
9446
  summary: "Users who bought after seeing it",
9447
+ effect: "read",
9304
9448
  method: "GET",
9305
9449
  path: "/v2/campaigns/{id}/audiences/{audience_id}/purchasers",
9306
9450
  details: "Exactly what the dashboard shows. For anything else about revenue, users or events, run SQL with `query`.",
@@ -9315,18 +9459,23 @@ const command$53 = defineResource({
9315
9459
  {
9316
9460
  name: "create",
9317
9461
  summary: "Add a variant",
9462
+ details: "Adding the first treatment without a percentage gives it 100% and zeroes existing variant weights, including the holdout. This can change live traffic.",
9463
+ effect: "destructive",
9318
9464
  method: "POST",
9319
9465
  path: "/v2/campaigns/{id}/audiences/{audience_id}/variants"
9320
9466
  },
9321
9467
  {
9322
9468
  name: "update",
9323
9469
  summary: "Change its paywall",
9470
+ effect: "destructive",
9324
9471
  method: "PATCH",
9325
- path: "/v2/campaigns/{id}/audiences/{audience_id}/variants/{variant_id}"
9472
+ path: "/v2/campaigns/{id}/audiences/{audience_id}/variants/{variant_id}",
9473
+ destructive: true
9326
9474
  },
9327
9475
  {
9328
9476
  name: "delete",
9329
9477
  summary: "Remove a variant",
9478
+ effect: "destructive",
9330
9479
  method: "DELETE",
9331
9480
  path: "/v2/campaigns/{id}/audiences/{audience_id}/variants/{variant_id}",
9332
9481
  destructive: true
@@ -9334,6 +9483,8 @@ const command$53 = defineResource({
9334
9483
  {
9335
9484
  name: "weights",
9336
9485
  summary: "Set each variant's share of traffic",
9486
+ details: "Overwrites allocation percentages for existing variants and changes live traffic distribution.",
9487
+ effect: "destructive",
9337
9488
  method: "PUT",
9338
9489
  path: "/v2/campaigns/{id}/audiences/{audience_id}/weights"
9339
9490
  }
@@ -9350,25 +9501,28 @@ const command$53 = defineResource({
9350
9501
 
9351
9502
  //#endregion
9352
9503
  //#region src/commands/main/entitlements.ts
9353
- const command$54 = defineResource({
9504
+ const command$55 = defineResource({
9354
9505
  name: "entitlements",
9355
9506
  summary: "What a purchase unlocks",
9356
9507
  operations: [
9357
9508
  {
9358
9509
  name: "list",
9359
9510
  summary: "Entitlements of a project",
9511
+ effect: "read",
9360
9512
  handler: "resource",
9361
9513
  flags: LIST_FLAGS
9362
9514
  },
9363
9515
  {
9364
9516
  name: "get",
9365
9517
  summary: "One entitlement",
9518
+ effect: "read",
9366
9519
  method: "GET",
9367
9520
  path: "/v2/entitlements/{id}"
9368
9521
  },
9369
9522
  {
9370
9523
  name: "create",
9371
9524
  summary: "Create an entitlement",
9525
+ effect: "write",
9372
9526
  handler: "resource",
9373
9527
  usage: "--identifier <identifier>",
9374
9528
  flags: [["--identifier <id>", "What the SDK checks for, e.g. pro"]]
@@ -9376,12 +9530,15 @@ const command$54 = defineResource({
9376
9530
  {
9377
9531
  name: "update",
9378
9532
  summary: "Change an entitlement",
9533
+ details: "Can rename the SDK entitlement identifier and replace its product associations, in addition to overwriting text and metadata.",
9534
+ effect: "destructive",
9379
9535
  method: "PATCH",
9380
9536
  path: "/v2/entitlements/{id}"
9381
9537
  },
9382
9538
  {
9383
9539
  name: "delete",
9384
9540
  summary: "Delete an entitlement",
9541
+ effect: "destructive",
9385
9542
  method: "DELETE",
9386
9543
  path: "/v2/entitlements/{id}",
9387
9544
  destructive: true
@@ -9394,19 +9551,23 @@ const command$54 = defineResource({
9394
9551
  {
9395
9552
  name: "list",
9396
9553
  summary: "Grants of an entitlement",
9554
+ effect: "read",
9397
9555
  method: "GET",
9398
9556
  path: "/v2/entitlements/{id}/grants",
9399
9557
  list: true
9400
9558
  },
9401
9559
  {
9402
9560
  name: "create",
9403
- summary: "Grant it to a user",
9561
+ summary: "Grant an existing entitlement manually to a device, optionally linked to an app user ID",
9562
+ effect: "write",
9563
+ details: "Grants promotional access, optionally until an expiry time, without charging the user or creating a paid subscription. Returns an error when an active grant already exists.",
9404
9564
  method: "POST",
9405
9565
  path: "/v2/entitlements/{id}/grants"
9406
9566
  },
9407
9567
  {
9408
9568
  name: "delete",
9409
9569
  summary: "Take a grant back",
9570
+ effect: "destructive",
9410
9571
  method: "DELETE",
9411
9572
  path: "/v2/entitlements/{id}/grants/{grant_id}",
9412
9573
  destructive: true
@@ -9418,13 +9579,14 @@ const command$54 = defineResource({
9418
9579
 
9419
9580
  //#endregion
9420
9581
  //#region src/commands/main/events.ts
9421
- const command$55 = defineResource({
9582
+ const command$56 = defineResource({
9422
9583
  name: "events",
9423
9584
  summary: "Events sent to your webhooks",
9424
9585
  operations: [
9425
9586
  {
9426
9587
  name: "list",
9427
9588
  summary: "Recent events",
9589
+ effect: "read",
9428
9590
  method: "GET",
9429
9591
  path: "/v2/projects/{project_id}/events",
9430
9592
  list: true
@@ -9432,12 +9594,14 @@ const command$55 = defineResource({
9432
9594
  {
9433
9595
  name: "get",
9434
9596
  summary: "One event",
9597
+ effect: "read",
9435
9598
  method: "GET",
9436
9599
  path: "/v2/projects/{project_id}/events/{event_id}"
9437
9600
  },
9438
9601
  {
9439
9602
  name: "attempts",
9440
9603
  summary: "Its delivery attempts",
9604
+ effect: "read",
9441
9605
  method: "GET",
9442
9606
  path: "/v2/projects/{project_id}/events/{event_id}/attempts",
9443
9607
  list: true
@@ -9445,6 +9609,8 @@ const command$55 = defineResource({
9445
9609
  {
9446
9610
  name: "retry",
9447
9611
  summary: "Deliver it again",
9612
+ details: "Resends an event to its configured webhook destination. Delivery cannot be recalled and may duplicate downstream processing.",
9613
+ effect: "destructive",
9448
9614
  method: "POST",
9449
9615
  path: "/v2/projects/{project_id}/events/{event_id}/retry"
9450
9616
  }
@@ -9454,43 +9620,51 @@ const command$55 = defineResource({
9454
9620
 
9455
9621
  //#endregion
9456
9622
  //#region src/commands/main/paywalls.ts
9457
- const command$56 = defineResource({
9623
+ const command$57 = defineResource({
9458
9624
  name: "paywalls",
9459
9625
  summary: "Paywalls in the dashboard",
9460
9626
  operations: [
9461
9627
  {
9462
9628
  name: "list",
9463
9629
  summary: "Paywalls of an app",
9630
+ effect: "read",
9464
9631
  handler: "resource",
9465
9632
  flags: LIST_FLAGS
9466
9633
  },
9467
9634
  {
9468
9635
  name: "get",
9469
9636
  summary: "One paywall",
9637
+ effect: "read",
9470
9638
  method: "GET",
9471
9639
  path: "/v2/paywalls/{id}"
9472
9640
  },
9473
9641
  {
9474
9642
  name: "create",
9475
9643
  summary: "Create a paywall",
9644
+ effect: "write",
9476
9645
  method: "POST",
9477
9646
  path: "/v2/paywalls"
9478
9647
  },
9479
9648
  {
9480
9649
  name: "duplicate",
9481
9650
  summary: "Copy a paywall",
9651
+ effect: "write",
9482
9652
  method: "POST",
9483
9653
  path: "/v2/paywalls/{id}/duplicate"
9484
9654
  },
9485
9655
  {
9486
9656
  name: "publish",
9487
- summary: "Publish its draft",
9657
+ summary: "Publish the latest saved draft of a paywall",
9658
+ effect: "destructive",
9659
+ details: "Replaces its currently deployed version and refreshes app configuration. This can change the paywall shown to users by campaigns that use it.",
9488
9660
  method: "POST",
9489
- path: "/v2/paywalls/{id}/publish"
9661
+ path: "/v2/paywalls/{id}/publish",
9662
+ destructive: true
9490
9663
  },
9491
9664
  {
9492
9665
  name: "archive",
9493
9666
  summary: "Archive it",
9667
+ effect: "destructive",
9494
9668
  method: "POST",
9495
9669
  path: "/v2/paywalls/{id}/archive",
9496
9670
  destructive: true
@@ -9498,12 +9672,14 @@ const command$56 = defineResource({
9498
9672
  {
9499
9673
  name: "unarchive",
9500
9674
  summary: "Bring it back",
9675
+ effect: "write",
9501
9676
  method: "POST",
9502
9677
  path: "/v2/paywalls/{id}/unarchive"
9503
9678
  },
9504
9679
  {
9505
9680
  name: "versions",
9506
9681
  summary: "Versions pushed from code",
9682
+ effect: "read",
9507
9683
  method: "GET",
9508
9684
  path: "/v2/paywalls/{id}/versions",
9509
9685
  list: true
@@ -9514,25 +9690,28 @@ const command$56 = defineResource({
9514
9690
 
9515
9691
  //#endregion
9516
9692
  //#region src/commands/main/products.ts
9517
- const command$57 = defineResource({
9693
+ const command$58 = defineResource({
9518
9694
  name: "products",
9519
9695
  summary: "Products and their store prices",
9520
9696
  operations: [
9521
9697
  {
9522
9698
  name: "list",
9523
9699
  summary: "Products of a project",
9700
+ effect: "read",
9524
9701
  handler: "resource",
9525
9702
  flags: LIST_FLAGS
9526
9703
  },
9527
9704
  {
9528
9705
  name: "get",
9529
9706
  summary: "One product",
9707
+ effect: "read",
9530
9708
  method: "GET",
9531
9709
  path: "/v2/products/{id}"
9532
9710
  },
9533
9711
  {
9534
9712
  name: "create",
9535
9713
  summary: "Create a product",
9714
+ effect: "write",
9536
9715
  handler: "resource",
9537
9716
  usage: "--identifier <identifier>",
9538
9717
  flags: [
@@ -9549,12 +9728,15 @@ const command$57 = defineResource({
9549
9728
  {
9550
9729
  name: "update",
9551
9730
  summary: "Change a product",
9731
+ effect: "destructive",
9552
9732
  method: "PATCH",
9553
- path: "/v2/products/{id}"
9733
+ path: "/v2/products/{id}",
9734
+ destructive: true
9554
9735
  },
9555
9736
  {
9556
9737
  name: "delete",
9557
9738
  summary: "Delete a product",
9739
+ effect: "destructive",
9558
9740
  method: "DELETE",
9559
9741
  path: "/v2/products/{id}",
9560
9742
  destructive: true
@@ -9562,12 +9744,14 @@ const command$57 = defineResource({
9562
9744
  {
9563
9745
  name: "impact",
9564
9746
  summary: "What deleting it would break",
9747
+ effect: "read",
9565
9748
  method: "GET",
9566
9749
  path: "/v2/products/{id}/delete-impact"
9567
9750
  },
9568
9751
  {
9569
9752
  name: "storekit",
9570
9753
  summary: "Write a StoreKit configuration file for Xcode",
9754
+ effect: "write",
9571
9755
  handler: "resource",
9572
9756
  flags: [["--out <file>", "Where to write it"]],
9573
9757
  mcp: false
@@ -9578,13 +9762,14 @@ const command$57 = defineResource({
9578
9762
 
9579
9763
  //#endregion
9580
9764
  //#region src/commands/main/users.ts
9581
- const command$58 = defineResource({
9765
+ const command$59 = defineResource({
9582
9766
  name: "users",
9583
9767
  summary: "Your app's users: subscriptions, entitlements, attributes",
9584
9768
  operations: [
9585
9769
  {
9586
9770
  name: "get",
9587
9771
  summary: "Find a user by app user ID",
9772
+ effect: "read",
9588
9773
  method: "GET",
9589
9774
  path: "/v2/users/resolve",
9590
9775
  args: ["app_user_id"]
@@ -9592,6 +9777,7 @@ const command$58 = defineResource({
9592
9777
  {
9593
9778
  name: "subscriptions",
9594
9779
  summary: "Every subscription they have had, one row each",
9780
+ effect: "read",
9595
9781
  method: "GET",
9596
9782
  path: "/v3/users/{app_user_id}/subscriptions",
9597
9783
  details: "The full history. For a one-glance answer (are they paying, status, lifetime value), use summary."
@@ -9599,6 +9785,7 @@ const command$58 = defineResource({
9599
9785
  {
9600
9786
  name: "summary",
9601
9787
  summary: "One answer: are they paying, their status, spend, MRR and lifetime value",
9788
+ effect: "read",
9602
9789
  method: "GET",
9603
9790
  path: "/v2/users/{app_user_id}/subscription-summary",
9604
9791
  details: "For every subscription they have had, use subscriptions."
@@ -9606,30 +9793,36 @@ const command$58 = defineResource({
9606
9793
  {
9607
9794
  name: "entitlements",
9608
9795
  summary: "What they have access to now",
9796
+ effect: "read",
9609
9797
  method: "GET",
9610
9798
  path: "/v2/users/{app_user_id}/active-entitlements"
9611
9799
  },
9612
9800
  {
9613
9801
  name: "attributes",
9614
9802
  summary: "Attributes the SDK set on them",
9803
+ effect: "read",
9615
9804
  method: "GET",
9616
9805
  path: "/v3/users/{app_user_id}/attributes"
9617
9806
  },
9618
9807
  {
9619
9808
  name: "update",
9620
9809
  summary: "Set attributes on them",
9810
+ details: "Queues attribute updates that replace stored user attribute values and can change audience matching.",
9811
+ effect: "destructive",
9621
9812
  method: "POST",
9622
9813
  path: "/v3/users/{app_user_id}/attributes"
9623
9814
  },
9624
9815
  {
9625
9816
  name: "aliases",
9626
9817
  summary: "Their other IDs",
9818
+ effect: "read",
9627
9819
  method: "GET",
9628
9820
  path: "/v3/users/{app_user_id}/aliases"
9629
9821
  },
9630
9822
  {
9631
9823
  name: "events",
9632
9824
  summary: "What they did, newest first",
9825
+ effect: "read",
9633
9826
  method: "GET",
9634
9827
  path: "/v2/users/{app_user_id}/events",
9635
9828
  list: true
@@ -9640,13 +9833,14 @@ const command$58 = defineResource({
9640
9833
 
9641
9834
  //#endregion
9642
9835
  //#region src/commands/main/webhooks.ts
9643
- const command$59 = defineResource({
9836
+ const command$60 = defineResource({
9644
9837
  name: "webhooks",
9645
9838
  summary: "Endpoints that receive your events",
9646
9839
  operations: [
9647
9840
  {
9648
9841
  name: "list",
9649
9842
  summary: "Webhook endpoints of a project",
9843
+ effect: "read",
9650
9844
  method: "GET",
9651
9845
  path: "/v2/projects/{project_id}/webhook_endpoints",
9652
9846
  list: true
@@ -9654,24 +9848,32 @@ const command$59 = defineResource({
9654
9848
  {
9655
9849
  name: "get",
9656
9850
  summary: "One endpoint",
9851
+ effect: "read",
9657
9852
  method: "GET",
9658
9853
  path: "/v2/projects/{project_id}/webhook_endpoints/{endpoint_id}"
9659
9854
  },
9660
9855
  {
9661
9856
  name: "create",
9662
9857
  summary: "Add an endpoint",
9858
+ effect: "write",
9859
+ details: "Delivers subscribed events to the HTTPS URL you specify.",
9663
9860
  method: "POST",
9664
9861
  path: "/v2/projects/{project_id}/webhook_endpoints"
9665
9862
  },
9666
9863
  {
9667
9864
  name: "update",
9668
9865
  summary: "Change an endpoint",
9866
+ effect: "destructive",
9867
+ details: `Changes where or which subscribed events are delivered; the destination can be any HTTPS URL you specify.
9868
+
9869
+ Overwrites destination, filters, headers and disabled state; can stop or redirect existing event delivery.`,
9669
9870
  method: "PATCH",
9670
9871
  path: "/v2/projects/{project_id}/webhook_endpoints/{endpoint_id}"
9671
9872
  },
9672
9873
  {
9673
9874
  name: "delete",
9674
9875
  summary: "Remove an endpoint",
9876
+ effect: "destructive",
9675
9877
  method: "DELETE",
9676
9878
  path: "/v2/projects/{project_id}/webhook_endpoints/{endpoint_id}",
9677
9879
  destructive: true
@@ -9679,6 +9881,7 @@ const command$59 = defineResource({
9679
9881
  {
9680
9882
  name: "rotate-secret",
9681
9883
  summary: "Issue a new signing secret",
9884
+ effect: "destructive",
9682
9885
  method: "POST",
9683
9886
  path: "/v2/projects/{project_id}/webhook_endpoints/{endpoint_id}/rotate_secret",
9684
9887
  destructive: true
@@ -9686,6 +9889,7 @@ const command$59 = defineResource({
9686
9889
  {
9687
9890
  name: "attempts",
9688
9891
  summary: "Its delivery attempts",
9892
+ effect: "read",
9689
9893
  method: "GET",
9690
9894
  path: "/v2/projects/{project_id}/webhook_endpoints/{endpoint_id}/attempts",
9691
9895
  list: true
@@ -9693,6 +9897,7 @@ const command$59 = defineResource({
9693
9897
  {
9694
9898
  name: "stats",
9695
9899
  summary: "Its delivery statistics",
9900
+ effect: "read",
9696
9901
  method: "GET",
9697
9902
  path: "/v2/projects/{project_id}/webhook_endpoints/{endpoint_id}/stats"
9698
9903
  }
@@ -9702,7 +9907,7 @@ const command$59 = defineResource({
9702
9907
 
9703
9908
  //#endregion
9704
9909
  //#region src/commands/support/doctor.ts
9705
- const command$60 = defineCommand({
9910
+ const command$61 = defineCommand({
9706
9911
  name: "doctor",
9707
9912
  summary: "Check the health of your Superwall integration",
9708
9913
  flags: { installDir },
@@ -9712,16 +9917,158 @@ const command$60 = defineCommand({
9712
9917
  prompts: true,
9713
9918
  mcp: false,
9714
9919
  async run(ctx) {
9715
- const { runDoctor } = await import("./doctor-C9ldpPFC.js");
9920
+ const { runDoctor } = await import("./doctor-9JS96QkX.js");
9716
9921
  return runDoctor(ctx);
9717
9922
  }
9718
9923
  });
9719
9924
 
9925
+ //#endregion
9926
+ //#region src/core/support/feedback/kinds.ts
9927
+ const FEEDBACK_KINDS = [
9928
+ "bug",
9929
+ "docs",
9930
+ "idea",
9931
+ "praise",
9932
+ "other"
9933
+ ];
9934
+
9935
+ //#endregion
9936
+ //#region src/core/support/feedback/send.ts
9937
+ const proc = globalThis.process;
9938
+ const MAX_FILES = 5;
9939
+ const MAX_FILE_CHARS = 2e4;
9940
+ function parseContext(pairs) {
9941
+ const out = {};
9942
+ for (const pair of pairs) {
9943
+ const at = pair.indexOf("=");
9944
+ if (at < 1) throw new Error(`--context expects key=value, got "${pair}"`);
9945
+ out[pair.slice(0, at).trim()] = pair.slice(at + 1).trim();
9946
+ }
9947
+ return out;
9948
+ }
9949
+ function linkedApp(cwd = proc?.cwd() ?? "") {
9950
+ const app$1 = readOnboardedApp(cwd);
9951
+ return {
9952
+ projectId: app$1?.projectId,
9953
+ applicationId: app$1?.applicationId
9954
+ };
9955
+ }
9956
+ function readAttachments(paths) {
9957
+ if (paths.length > MAX_FILES) throw new Error(`Attach at most ${MAX_FILES} files.`);
9958
+ return paths.map((path) => {
9959
+ const raw = readInput(path);
9960
+ const truncated = raw.length > MAX_FILE_CHARS;
9961
+ return {
9962
+ name: path === "-" ? "stdin" : path.split(/[\\/]/).pop() ?? path,
9963
+ content: truncated ? raw.slice(-MAX_FILE_CHARS) : raw,
9964
+ truncated
9965
+ };
9966
+ });
9967
+ }
9968
+ function buildFeedbackEvent(feedback, via, distinctId, session, osRelease) {
9969
+ return {
9970
+ api_key: TELEMETRY_KEY(),
9971
+ event: "feedback submitted",
9972
+ distinct_id: distinctId,
9973
+ timestamp: (/* @__PURE__ */ new Date()).toISOString(),
9974
+ properties: {
9975
+ $process_person_profile: false,
9976
+ title: feedback.title ?? null,
9977
+ message: feedback.message,
9978
+ kind: feedback.kind,
9979
+ command: feedback.command ?? null,
9980
+ project_id: feedback.projectId ?? null,
9981
+ application_id: feedback.applicationId ?? null,
9982
+ organization_id: feedback.organizationId ?? null,
9983
+ context: feedback.context,
9984
+ attachments: feedback.attachments,
9985
+ via,
9986
+ agent: feedback.agent ?? null,
9987
+ cli_version: VERSION,
9988
+ platform: proc?.platform ?? "worker",
9989
+ os_release: osRelease ?? null,
9990
+ arch: proc?.arch ?? null,
9991
+ node_version: proc?.version ?? null,
9992
+ ci: proc?.env.CI === "true",
9993
+ email: session?.userEmail ?? null,
9994
+ org_name: session?.orgName ?? null,
9995
+ auth_method: session?.authMethod ?? null
9996
+ }
9997
+ };
9998
+ }
9999
+ async function submitFeedback(feedback, via) {
10000
+ const osRelease = proc ? await import("node:os").then((os) => os.release()).catch(() => void 0) : void 0;
10001
+ const payload = buildFeedbackEvent(feedback, via, readAnonymousId(), readSession(), osRelease);
10002
+ try {
10003
+ return (await fetch(`${TELEMETRY_HOST()}/capture/`, {
10004
+ method: "POST",
10005
+ headers: { "content-type": "application/json" },
10006
+ body: JSON.stringify(payload),
10007
+ signal: AbortSignal.timeout(8e3)
10008
+ })).ok;
10009
+ } catch {
10010
+ return false;
10011
+ }
10012
+ }
10013
+ const ORG_LOOKUP_MS = 3e3;
10014
+ async function organizationOfApp(api, applicationId) {
10015
+ if (!api || !applicationId) return void 0;
10016
+ const lookup = findApplication(api, applicationId).then((found) => found ? orgIdOf(found.project) : void 0).catch(() => void 0);
10017
+ const timeout = new Promise((resolve) => {
10018
+ setTimeout(() => resolve(void 0), ORG_LOOKUP_MS).unref?.();
10019
+ });
10020
+ return Promise.race([lookup, timeout]);
10021
+ }
10022
+ async function runFeedback(ctx, { args, flags }) {
10023
+ const { ui, json, interactive } = ctx;
10024
+ let message = args.message;
10025
+ if (!message && interactive) {
10026
+ ui.intro("Superwall feedback");
10027
+ const answer = await ui.text({
10028
+ message: "What's your feedback on Superwall?",
10029
+ placeholder: "What worked, what didn't, what's missing...",
10030
+ validate: (v) => v?.trim() ? void 0 : "Required"
10031
+ });
10032
+ if (answer === null) return void ui.warn("Cancelled.");
10033
+ message = answer.trim();
10034
+ }
10035
+ if (!message) throw new Error("Usage: superwall feedback \"<message>\" [--title ...] [--kind bug] [--file log.txt]");
10036
+ const kind = FEEDBACK_KINDS.find((candidate) => candidate === flags.kind);
10037
+ if (!kind) throw new Error(`--kind must be one of: ${FEEDBACK_KINDS.join(", ")}`);
10038
+ const agent = flags.agent ?? detectAgent();
10039
+ const attachments = readAttachments(flags.file.filter(Boolean));
10040
+ const context = parseContext(flags.context);
10041
+ const linked = linkedApp();
10042
+ const applicationId = flags.app ?? linked.applicationId;
10043
+ const via = agent || !interactive ? "agent" : "human";
10044
+ const spin = interactive ? ui.spinner() : null;
10045
+ spin?.start("Sending your feedback");
10046
+ const ok$1 = await submitFeedback({
10047
+ title: flags.title,
10048
+ message,
10049
+ kind,
10050
+ command: flags.command,
10051
+ agent,
10052
+ projectId: flags.project ?? linked.projectId,
10053
+ applicationId,
10054
+ organizationId: await organizationOfApp(ctx.api, applicationId),
10055
+ context,
10056
+ attachments
10057
+ }, via);
10058
+ spin?.stop(ok$1 ? "Sent" : "Failed to send");
10059
+ if (json) return ctx.output.data({ submitted: ok$1 });
10060
+ if (!ok$1) throw new Error("Couldn't send your feedback - check your connection and try again.");
10061
+ ui.success("Thank you! We've received your feedback and will read through it. Really appreciate you helping us make Superwall better.");
10062
+ }
10063
+
9720
10064
  //#endregion
9721
10065
  //#region src/commands/support/feedback.ts
9722
- const command$61 = defineCommand({
10066
+ const command$62 = defineCommand({
9723
10067
  name: "feedback",
9724
10068
  summary: "Report a bug or send feedback to the Superwall team",
10069
+ details: `Goes straight to the Superwall team. Pass the app it happened in so the team can find the account. Report anything you confirm doesn't work, as a reproducible report with every ID and version in context. Without a shell, paste the relevant part of a log into the message: a tool cannot attach files.
10070
+
10071
+ Sends the supplied message and context to the Superwall team as a persisted event. Sending cannot be undone; repeating the call can send duplicate feedback.`,
9725
10072
  args: { message: { describe: "What happened: what you ran, what you expected, what you got (asked when left out)" } },
9726
10073
  flags: {
9727
10074
  title: {
@@ -9758,6 +10105,7 @@ const command$61 = defineCommand({
9758
10105
  file: {
9759
10106
  type: "list",
9760
10107
  value: "path",
10108
+ mcp: false,
9761
10109
  describe: "Attach a log or snippet, repeatable, at most 5; - reads stdin; long files keep the last 20k characters"
9762
10110
  },
9763
10111
  agent: {
@@ -9770,16 +10118,13 @@ const command$61 = defineCommand({
9770
10118
  auth: "optional",
9771
10119
  json: true,
9772
10120
  prompts: true,
9773
- mcp: false,
9774
- async run(ctx, input) {
9775
- const { runFeedback } = await import("./send-BxD9yf6F.js");
9776
- return runFeedback(ctx, input);
9777
- }
10121
+ mcp: "destructive",
10122
+ run: (ctx, input) => runFeedback(ctx, input)
9778
10123
  });
9779
10124
 
9780
10125
  //#endregion
9781
10126
  //#region src/commands/support/skills.ts
9782
- const command$62 = defineCommand({
10127
+ const command$63 = defineCommand({
9783
10128
  name: "skills",
9784
10129
  summary: "Install or update the Superwall agent skills for your coding agents",
9785
10130
  flags: {
@@ -9808,14 +10153,14 @@ const command$62 = defineCommand({
9808
10153
  prompts: true,
9809
10154
  mcp: false,
9810
10155
  async run(ctx, input) {
9811
- const { runSkills } = await import("./skills-DMG4bpKk.js");
10156
+ const { runSkills } = await import("./skills-Dg3k6TRC.js");
9812
10157
  return runSkills(ctx, input);
9813
10158
  }
9814
10159
  });
9815
10160
 
9816
10161
  //#endregion
9817
10162
  //#region src/commands/support/upgrade.ts
9818
- const command$63 = defineCommand({
10163
+ const command$64 = defineCommand({
9819
10164
  name: "upgrade",
9820
10165
  summary: "Update the CLI to the latest version",
9821
10166
  examples: [["upgrade", "Install the latest version globally with npm"]],
@@ -9824,14 +10169,14 @@ const command$63 = defineCommand({
9824
10169
  prompts: true,
9825
10170
  mcp: false,
9826
10171
  async run(ctx) {
9827
- const { runUpgrade } = await import("./upgrade-Cqy5orjb.js");
10172
+ const { runUpgrade } = await import("./upgrade-DLf0LJDh.js");
9828
10173
  return runUpgrade(ctx);
9829
10174
  }
9830
10175
  });
9831
10176
 
9832
10177
  //#endregion
9833
10178
  //#region src/commands/workflows/integrate.ts
9834
- const command$64 = defineCommand({
10179
+ const command$65 = defineCommand({
9835
10180
  name: "integrate",
9836
10181
  summary: "Set up the SDK, placements, and dashboard in your app",
9837
10182
  flags: {
@@ -9863,8 +10208,8 @@ const command$64 = defineCommand({
9863
10208
  prompts: true,
9864
10209
  mcp: false,
9865
10210
  async run(ctx, { flags }) {
9866
- const { runIntegrate } = await import("./integrate-DcJhpXy8.js");
9867
- const { printPlaybook } = await import("./playbook-DIeb7hne.js");
10211
+ const { runIntegrate } = await import("./integrate-VWtTNPCr.js");
10212
+ const { printPlaybook } = await import("./playbook-oov9yV0q.js");
9868
10213
  if (flags.skill) return printPlaybook(ctx.installDir, "integrate");
9869
10214
  await runIntegrate({
9870
10215
  ...ctx,
@@ -9876,7 +10221,7 @@ const command$64 = defineCommand({
9876
10221
 
9877
10222
  //#endregion
9878
10223
  //#region src/commands/workflows/migrate.ts
9879
- const command$65 = defineCommand({
10224
+ const command$66 = defineCommand({
9880
10225
  name: "migrate",
9881
10226
  summary: "Migrate from RevenueCat / Adapty / Qonversion",
9882
10227
  summaryOn: { next: "Migrate from RevenueCat / Adapty / Qonversion, or rebuild a dashboard paywall or a native screen as code" },
@@ -9924,8 +10269,8 @@ const command$65 = defineCommand({
9924
10269
  prompts: true,
9925
10270
  mcp: false,
9926
10271
  async run(ctx, { args, flags }) {
9927
- const { runPaywallMigration, runProviderMigration, runScreenMigration } = await import("./migrate-Cfec564E.js");
9928
- const { printPlaybook } = await import("./playbook-DIeb7hne.js");
10272
+ const { runPaywallMigration, runProviderMigration, runScreenMigration } = await import("./migrate-C86h6jeF.js");
10273
+ const { printPlaybook } = await import("./playbook-oov9yV0q.js");
9929
10274
  if (flags.screen !== void 0) return runScreenMigration(ctx, {
9930
10275
  path: flags.screen,
9931
10276
  screenshot: flags.screenshot
@@ -9938,7 +10283,7 @@ const command$65 = defineCommand({
9938
10283
 
9939
10284
  //#endregion
9940
10285
  //#region src/commands/workflows/review.ts
9941
- const command$66 = defineCommand({
10286
+ const command$67 = defineCommand({
9942
10287
  name: "review",
9943
10288
  summary: "Review an existing Superwall setup end to end",
9944
10289
  flags: {
@@ -9959,8 +10304,8 @@ const command$66 = defineCommand({
9959
10304
  prompts: true,
9960
10305
  mcp: false,
9961
10306
  async run(ctx, { flags }) {
9962
- const { runReview } = await import("./integrate-DcJhpXy8.js");
9963
- const { printPlaybook } = await import("./playbook-DIeb7hne.js");
10307
+ const { runReview } = await import("./integrate-VWtTNPCr.js");
10308
+ const { printPlaybook } = await import("./playbook-oov9yV0q.js");
9964
10309
  if (flags.skill) return printPlaybook(ctx.installDir, flags.fix ? "review-fix" : "review");
9965
10310
  await runReview(ctx, flags.fix);
9966
10311
  }
@@ -9974,9 +10319,9 @@ const GROUPS = [
9974
10319
  title: "Workflows",
9975
10320
  notes: ["Each takes --skill to print the playbook instead of running."],
9976
10321
  commands: [
9977
- command$64,
9978
- command$66,
9979
- command$65
10322
+ command$65,
10323
+ command$67,
10324
+ command$66
9980
10325
  ]
9981
10326
  },
9982
10327
  {
@@ -9998,15 +10343,16 @@ const GROUPS = [
9998
10343
  title: "Commands",
9999
10344
  notes: ["superwall <command> --help lists its operations; <operation> --help, its flags."],
10000
10345
  commands: [
10001
- command$52,
10002
- command$51,
10003
- command$57,
10004
- command$54,
10005
10346
  command$53,
10006
- command$56,
10347
+ command$52,
10007
10348
  command$58,
10349
+ command$55,
10350
+ command$54,
10351
+ command$57,
10008
10352
  command$59,
10009
- command$55
10353
+ command$60,
10354
+ command$56,
10355
+ command$51
10010
10356
  ]
10011
10357
  },
10012
10358
  {
@@ -10207,10 +10553,10 @@ proxy uses. No command prints a private key, and none revokes a key at Apple.`
10207
10553
  id: "support",
10208
10554
  title: "Support & updates",
10209
10555
  commands: [
10210
- command$60,
10211
- command$62,
10556
+ command$61,
10212
10557
  command$63,
10213
- command$61
10558
+ command$64,
10559
+ command$62
10214
10560
  ]
10215
10561
  }
10216
10562
  ];
@@ -10220,7 +10566,7 @@ function visible(channel) {
10220
10566
  function listGroups() {
10221
10567
  return GROUPS.filter((group$1) => visible(group$1.channel)).map((group$1) => ({
10222
10568
  ...group$1,
10223
- commands: group$1.commands.filter((command$67) => visible(command$67.channel))
10569
+ commands: group$1.commands.filter((command$68) => visible(command$68.channel))
10224
10570
  }));
10225
10571
  }
10226
10572