@superwall/cli 1.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (85) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +201 -0
  3. package/dist/actions-MB-eBY64.js +140 -0
  4. package/dist/api-BF7-toqM.js +151 -0
  5. package/dist/api-output-B5hh0q4V.js +20 -0
  6. package/dist/app-K6j9Es7h.js +189 -0
  7. package/dist/asc-CArSwo5D.js +539 -0
  8. package/dist/asc-products-YQ6Oc6YO.js +93 -0
  9. package/dist/auth-CY2cO_NF.js +139 -0
  10. package/dist/auth.d.ts +30 -0
  11. package/dist/auth.js +4 -0
  12. package/dist/billing-DWyfEQ6l.js +80 -0
  13. package/dist/bind-hslFhcTR.js +213 -0
  14. package/dist/chunk-DQxbwPpZ.js +30 -0
  15. package/dist/command-Kwx4ekbo.js +283 -0
  16. package/dist/create-Bbi8BOO1.js +410 -0
  17. package/dist/dev-D0lQDCQI.js +397 -0
  18. package/dist/devtools-8EgLo86w.js +3638 -0
  19. package/dist/doctor-ByeRdMcl.js +88 -0
  20. package/dist/drivers-DVAZgone.js +413 -0
  21. package/dist/entry.d.ts +9 -0
  22. package/dist/entry.js +495 -0
  23. package/dist/existing-CcJrIIAU.js +88 -0
  24. package/dist/feedback-Z0Wk7VC5.js +73 -0
  25. package/dist/git-3OX9u3xE.js +433 -0
  26. package/dist/hosted-CHwaUqLd.js +32 -0
  27. package/dist/integrate-DqOAqK7J.js +863 -0
  28. package/dist/json-C3hPIMkI.js +7 -0
  29. package/dist/login-Dr8UN_Gx.js +290 -0
  30. package/dist/migrate-D92bJTg6.js +114 -0
  31. package/dist/org-B2gy9Pmu.js +40 -0
  32. package/dist/params-Bvq0iqQK.js +52 -0
  33. package/dist/pipeline-CHHIg6BU.js +1056 -0
  34. package/dist/print-skill-BnZAk7dV.js +74 -0
  35. package/dist/promote-CRe9170G.js +88 -0
  36. package/dist/publish-DsODvrOD.js +35 -0
  37. package/dist/push-BDkZUC0v.js +35 -0
  38. package/dist/query-DIllrSnk.js +53 -0
  39. package/dist/resource-CdP1MDla.js +483 -0
  40. package/dist/resources-CVrWwA1K.js +233 -0
  41. package/dist/run-cGGBUMs5.js +89 -0
  42. package/dist/scan-BQexuUPO.js +236 -0
  43. package/dist/skills-DhuUs28u.js +64 -0
  44. package/dist/skills-xrfXt9u0.js +205 -0
  45. package/dist/spawn-DSoTXy_j.js +69 -0
  46. package/dist/spinner-gOxIMz-V.js +18 -0
  47. package/dist/storekit-Ddvs4Ynw.js +29 -0
  48. package/dist/telemetry-CcfrtXdf.js +204 -0
  49. package/dist/token-DHRH8cxi.js +102 -0
  50. package/dist/ui-C4ncRJqd.js +27703 -0
  51. package/dist/update-BiVeR024.js +137 -0
  52. package/dist/upgrade-DYWspApv.js +72 -0
  53. package/package.json +87 -0
  54. package/prompts/actions/dashboard-setup.xml +10 -0
  55. package/prompts/actions/integrate.xml +5 -0
  56. package/prompts/actions/migrate.xml +11 -0
  57. package/prompts/actions/placements-implement.xml +20 -0
  58. package/prompts/actions/placements-review.xml +18 -0
  59. package/prompts/actions/review-fix.xml +18 -0
  60. package/prompts/actions/review.xml +18 -0
  61. package/prompts/commandments.xml +17 -0
  62. package/prompts/context.xml +9 -0
  63. package/skills/README.md +118 -0
  64. package/skills/superwall-dashboard/SKILL.md +81 -0
  65. package/skills/superwall-dashboard/references/setup.md +101 -0
  66. package/skills/superwall-integrate/SKILL.md +76 -0
  67. package/skills/superwall-integrate/references/expo.md +269 -0
  68. package/skills/superwall-integrate/references/flutter.md +285 -0
  69. package/skills/superwall-integrate/references/ios.md +314 -0
  70. package/skills/superwall-integrate/references/react-native.md +245 -0
  71. package/skills/superwall-migrate/SKILL.md +83 -0
  72. package/skills/superwall-migrate/references/adapty.md +229 -0
  73. package/skills/superwall-migrate/references/qonversion.md +227 -0
  74. package/skills/superwall-migrate/references/revenuecat.md +414 -0
  75. package/skills/superwall-placements/SKILL.md +73 -0
  76. package/skills/superwall-placements/references/expo.md +161 -0
  77. package/skills/superwall-placements/references/flutter.md +139 -0
  78. package/skills/superwall-placements/references/ios.md +165 -0
  79. package/skills/superwall-placements/references/react-native.md +145 -0
  80. package/skills/superwall-placements/references/strategy.md +221 -0
  81. package/skills/superwall-review/SKILL.md +75 -0
  82. package/skills/superwall-review/references/expo.md +100 -0
  83. package/skills/superwall-review/references/flutter.md +99 -0
  84. package/skills/superwall-review/references/ios.md +108 -0
  85. package/skills/superwall-review/references/react-native.md +100 -0
@@ -0,0 +1,100 @@
1
+ # Review Superwall - React Native
2
+
3
+ You are reviewing a bare React Native app. First distinguish the recommended
4
+ `expo-superwall` provider path from the legacy
5
+ `@superwall/react-native-superwall` singleton path; do not mix their APIs.
6
+
7
+ ## Checklist
8
+
9
+ - [ ] package/native linking and deployment targets
10
+ - [ ] one provider or one early singleton configuration with platform keys
11
+ - [ ] purchase controller, restore flow, and subscription-status ownership
12
+ - [ ] identity/logout and user attributes
13
+ - [ ] platform linking and `handleDeepLink`
14
+ - [ ] conditional Web Checkout redemption readiness
15
+ - [ ] placements, callbacks, campaigns, and standard placements
16
+ - [ ] dashboard/store products, entitlements, paywalls, and campaigns
17
+ - [ ] event forwarding and native build verification
18
+
19
+ ## Docs access
20
+
21
+ ```bash
22
+ curl -sL https://superwall.com/docs/react-native/llms.txt
23
+ curl -sL https://superwall.com/docs/react-native/sdk-reference/configure.md
24
+ curl -sL https://superwall.com/docs/react-native/sdk-reference/handleDeepLink.md
25
+ curl -sL https://superwall.com/docs/react-native/sdk-reference/register.md
26
+ curl -sL https://superwall.com/docs/expo/quickstart/configure.md
27
+ curl -sL https://superwall.com/docs/expo/guides/advanced-configuration.md
28
+ curl -sL https://superwall.com/docs/expo/guides/handling-deep-links.md
29
+ curl -sL https://superwall.com/docs/expo/guides/web-checkout.md
30
+ ```
31
+
32
+ ## 1. SDK and configuration
33
+
34
+ Inspect `package.json`, lockfiles, iOS pods/project settings, Android Gradle, and
35
+ app entry points. Provider path: one root `SuperwallProvider` with per-platform
36
+ keys, no duplicate singleton `configure`. Legacy path: one
37
+ `Superwall.configure({ apiKey, ... })` in a root effect that does not rerun.
38
+ Public keys should match platform and existing config conventions.
39
+
40
+ ## 2. Purchases, restores, and subscription state
41
+
42
+ Infer the chosen path:
43
+
44
+ - **Default:** no custom controller is correct; Superwall owns purchases,
45
+ restores, and subscription status.
46
+ - **RevenueCat/custom:** the controller must implement the current App Store and
47
+ Google Play purchase methods plus restore, and synchronize Superwall status as
48
+ its entitlement source changes.
49
+
50
+ Reading status through `useUser` or the legacy singleton is documented and not a
51
+ defect. Report only broken ownership, conflicting sources, permanently unknown
52
+ status, missing controller branches, or behavior inconsistent with the intended
53
+ architecture. Compare product/entitlement IDs through authenticated CLI/store
54
+ checks; blocked checks go in **Not verified**.
55
+
56
+ ## 3. Identity and attributes
57
+
58
+ Trace real auth flows. Provider path uses `useUser` identity/sign-out methods;
59
+ legacy path uses `Superwall.shared.identify(...)` and `reset()`. Confirm login and
60
+ logout both update Superwall, and inspect attributes for targeting value and
61
+ sensitive data. Anonymous-only apps do not need fabricated identity work.
62
+
63
+ ## 4. Deep links and Web Checkout
64
+
65
+ Inspect React Navigation/linking config plus iOS and Android native URL handling.
66
+ Cover cold start and foreground delivery. Provider-style apps follow the current
67
+ Expo module `handleDeepLink` docs; legacy apps use the singleton
68
+ `handleDeepLink`. The goal is the standard `deepLink_open` placement and its URL
69
+ parameters - not an app-maintained URL-to-placement table.
70
+
71
+ Web Checkout is conditional. If used, verify return URLs and redemption behavior
72
+ for the detected purchase path. Default purchasing needs no custom entitlement
73
+ merge; custom/RevenueCat paths follow their dedicated redemption docs. Otherwise
74
+ list readiness only as an optional opportunity.
75
+
76
+ ## 5. Placements and lifecycle
77
+
78
+ Find provider `usePlacement`/`registerPlacement` and legacy
79
+ `Superwall.shared.register`, including wrappers and analytics bridges. Analytics
80
+ and fire-and-forget registrations are valid. Require a feature callback only when
81
+ that action is meant to be remotely gateable. Check event/effect placement,
82
+ awaiting of async calls, exact names for active presenting campaigns, and useful
83
+ parameters. Unrouted analytics/future placements are fine.
84
+
85
+ Prefer standard `app_launch`, `session_start`, and `deepLink_open` over truly
86
+ duplicative custom lifecycle placements. Do not propose cosmetic renames of
87
+ stable keys. Analytics delegate/hooks are optional unless the app relies on them.
88
+
89
+ ## 6. Dashboard and verification
90
+
91
+ Run the read-only CLI checks from `SKILL.md`. Verify app/platform keys, products,
92
+ entitlements, paywall products, campaigns, and placements expected to present
93
+ now form a usable chain. Cite IDs where available. In fix mode, run the existing
94
+ TypeScript and native build/test paths.
95
+
96
+ ## Fix-mode boundaries
97
+
98
+ Fix clear wiring bugs and code/doc mismatches. Never mix provider and legacy APIs,
99
+ switch purchase providers, enable Web Checkout, rename stable placements, change
100
+ prices, or invent campaign strategy without an explicit user decision.