@superwall/cli 1.5.0 → 1.6.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 (53) hide show
  1. package/README.md +2 -3
  2. package/dist/{actions-C0AzXRrF.js → actions-BdZ-7BJd.js} +2 -2
  3. package/dist/{api-BnM4rTKN.js → api-FjrCPu6r.js} +5 -5
  4. package/dist/{app-BJxaQo2S.js → app-YeJj35Ia.js} +7 -7
  5. package/dist/{asa-CLXU3JO4.js → asa-4nk7HHy8.js} +5 -5
  6. package/dist/{asc-CZowAIf_.js → asc-2TZOQuK1.js} +5 -5
  7. package/dist/{auth-CAEGguzH.js → auth-QUYfKdwk.js} +8 -8
  8. package/dist/auth.js +2 -2
  9. package/dist/{billing-DHTBwrRm.js → billing-BK7bpv1t.js} +1 -1
  10. package/dist/{bind-CZOevfSJ.js → bind-Ch4VR2EY.js} +1 -1
  11. package/dist/{command-Du-b_Jji.js → command-BJ_6850A.js} +4 -4
  12. package/dist/{create-Z_IbSC9n.js → create-vSQxQlEP.js} +18 -18
  13. package/dist/dev-B9qmPH1W.js +21 -0
  14. package/dist/{dev-0p2GTz3J.js → dev-DEss5dwo.js} +4 -4
  15. package/dist/{doctor-MHJadguy.js → doctor-BYTfekBr.js} +9 -9
  16. package/dist/{drivers-8y9Qd-qe.js → drivers-DGml3OlF.js} +2 -2
  17. package/dist/entry.js +27 -27
  18. package/dist/{existing-BBHtVCwp.js → existing-DgSo639M.js} +2 -2
  19. package/dist/{feedback-BK4fdySj.js → feedback-4LsBpZZx.js} +5 -5
  20. package/dist/{hosted-B_5T7emr.js → hosted-DqGp6oV2.js} +2 -2
  21. package/dist/{integrate-CEuN4ebb.js → integrate-Cl9eKHoF.js} +16 -16
  22. package/dist/{login-kiXaqdkC.js → login-DS3MPeW2.js} +3 -3
  23. package/dist/{migrate-C8Y3z2iF.js → migrate-WiTO71PE.js} +19 -19
  24. package/dist/{open-studio-BGXha018.js → open-studio-CbMUL5Va.js} +9 -10
  25. package/dist/{output-B0spXJAT.js → output-XKuoEEjP.js} +1 -1
  26. package/dist/{pipeline-G5bZKqrN.js → pipeline-J9-nENTS.js} +4 -5
  27. package/dist/{print-skill-CRpqzrBD.js → print-skill-BOGm5Szi.js} +6 -6
  28. package/dist/{promote-BtDlI6UX.js → promote-Ci085QxU.js} +13 -13
  29. package/dist/{publish-C94YHFK5.js → publish--TV-j8Zd.js} +13 -13
  30. package/dist/{push-DOTj3kLl.js → push-CpGetsJF.js} +13 -13
  31. package/dist/{query-COqz70_0.js → query-BZStoGLM.js} +5 -5
  32. package/dist/{resource-PBkSYrXp.js → resource-ClLHSXi6.js} +8 -8
  33. package/dist/{run-C7ou9t2X.js → run-CiaWn78U.js} +2 -2
  34. package/dist/{scan-Cp_UTTEw.js → scan-DEgX5HxV.js} +1 -1
  35. package/dist/skills/superwall/SKILL.md +70 -39
  36. package/dist/skills/superwall/references/api.md +14 -21
  37. package/dist/skills/superwall/references/asa.md +6 -0
  38. package/dist/skills/superwall/references/asc.md +7 -8
  39. package/dist/skills/superwall/references/data-analytics.md +7 -4
  40. package/dist/skills/superwall/references/docs.md +2 -2
  41. package/dist/skills/superwall/references/sdk-integration.md +3 -4
  42. package/dist/skills/superwall/workflows/dashboard/setup.md +23 -24
  43. package/dist/skills/superwall/workflows/integrate/expo.md +14 -11
  44. package/dist/skills/superwall/workflows/integrate/react-native.md +4 -3
  45. package/dist/skills/superwall-framework/SKILL.md +12 -4
  46. package/dist/{skills-m2D6qoYX.js → skills-DjPCmUMU.js} +6 -6
  47. package/dist/{skills-B6Sy3Tq0.js → skills-DsBAVRTE.js} +2 -2
  48. package/dist/{telemetry-y1JmBs4f.js → telemetry-EzV7cA7s.js} +1 -1
  49. package/dist/{token-uDs-2KqY.js → token-r5g876aI.js} +1 -1
  50. package/dist/{update-CLYT9c3k.js → update-Cz3Q3MFj.js} +2 -2
  51. package/dist/{upgrade-DLrdLVJk.js → upgrade-BA_4sdnh.js} +5 -5
  52. package/package.json +2 -2
  53. package/dist/dev-dB-b2xI3.js +0 -21
@@ -35,30 +35,29 @@ resolve it on device.
35
35
 
36
36
  ### Import from App Store Connect
37
37
 
38
- There is **no** `products import` subcommand. Two ways to import:
39
-
40
- 1. **Orchestrated (hands-off):** run `superwall integrate` - the CLI
41
- walks App Store Connect and imports products interactively.
42
- 2. **Agent-driven (you do it):** connect the key once, enumerate via the signed ASC proxy, then
43
- create each product:
44
-
45
- ```bash
46
- # one-time: upload the ASC API key to Superwall's vault (nothing stored locally)
47
- superwall asc keys set --key-id <KEY_ID> --issuer <ISSUER_ID> --key-file ./AuthKey_<KEY_ID>.p8 --json
48
- superwall asc keys list --json # confirm connected; note the team id
49
-
50
- # enumerate real products for the app (by bundle id or ASC app id)
51
- superwall asc subscriptions com.app.bundle --json # renewing subs
52
- superwall asc iaps com.app.bundle --json # one-time / non-renewing
53
- superwall asc products com.app.bundle --json # everything
54
- superwall asc apps --json # list ASC apps if unsure of the id
55
-
56
- # create each returned productId, granting your entitlement
57
- superwall products create com.app.pro.yearly --entitlement pro --project <id> --json
58
- ```
59
-
60
- Products imported this way carry only the identifier (and reference name); Xcode/StoreKit and
61
- the stores remain the source of truth for pricing.
38
+ There is **no** `products import` subcommand. `superwall integrate --skill`
39
+ prints the full setup instructions without spawning another agent. To import
40
+ products yourself, use credentials the user has already connected privately,
41
+ enumerate via the signed ASC proxy, then create products in the approved scope.
42
+ If credentials are missing, have the user consult `superwall asc keys set --help`
43
+ at their own terminal and complete setup themselves. Do not request, inspect,
44
+ or upload their private key.
45
+
46
+ ```bash
47
+ superwall asc keys list --json # confirm connected; note the team id
48
+
49
+ # enumerate real products for the app (by bundle id or ASC app id)
50
+ superwall asc subscriptions com.app.bundle --json # renewing subs
51
+ superwall asc iaps com.app.bundle --json # one-time / non-renewing
52
+ superwall asc products com.app.bundle --json # everything
53
+ superwall asc apps --json # list ASC apps if unsure of the id
54
+
55
+ # create each returned productId, granting your entitlement
56
+ superwall products create com.app.pro.yearly --entitlement pro --project <id> --json
57
+ ```
58
+
59
+ Products imported this way carry only the identifier (and reference name); Xcode/StoreKit and
60
+ the stores remain the source of truth for pricing.
62
61
 
63
62
  ### Generate a local `.storekit` file (for Xcode testing without sandbox)
64
63
 
@@ -70,21 +70,23 @@ For a full migration off another SDK, use the **superwall-migrate** skill.
70
70
  ## Step 1 - Install
71
71
 
72
72
  Detect the package manager from the lockfile. Use `expo install` so versions match
73
- the Expo SDK.
73
+ the Expo SDK. Run from the app root after installing its lockfile dependencies;
74
+ the commands below use the project's installed Expo CLI. Do not download another
75
+ Expo CLI version when the local binary is missing: restore the project dependencies.
74
76
 
75
77
  ```bash
76
78
  curl -sL https://superwall.com/docs/expo/quickstart/install.md
77
79
  ```
78
80
 
79
81
  ```bash
80
- npx expo install expo-superwall
81
- # or: pnpm dlx expo install expo-superwall / yarn dlx expo install expo-superwall / bunx expo install expo-superwall
82
+ ./node_modules/.bin/expo install expo-superwall
83
+ # or: pnpm exec expo install expo-superwall / yarn expo install expo-superwall
82
84
  ```
83
85
 
84
86
  Also install and configure `expo-build-properties` to guarantee native minimums:
85
87
 
86
88
  ```bash
87
- npx expo install expo-build-properties
89
+ ./node_modules/.bin/expo install expo-build-properties
88
90
  ```
89
91
 
90
92
  Merge into the **existing** `plugins` array in `app.json` / `app.config.js` (don't
@@ -108,14 +110,14 @@ create a second one):
108
110
  `expo-superwall` is a native module, so produce a **native build**:
109
111
 
110
112
  ```bash
111
- npx expo run:ios # or: npx expo run:android
113
+ ./node_modules/.bin/expo run:ios # or: ./node_modules/.bin/expo run:android
112
114
  ```
113
115
 
114
116
  For an **existing** project whose `ios/`/`android/` predate the install, regenerate
115
117
  them (back up custom native code first):
116
118
 
117
119
  ```bash
118
- npx expo prebuild --clean
120
+ ./node_modules/.bin/expo prebuild --clean
119
121
  ```
120
122
 
121
123
  ## Step 2 - Configure
@@ -210,7 +212,7 @@ export class MyPurchaseController extends PurchaseController {
210
212
 
211
213
  ## Step 5 & 6 - Verify
212
214
 
213
- 1. **Build a dev client** and run it: `npx expo run:ios` / `npx expo run:android`
215
+ 1. **Build a dev client** and run it: `./node_modules/.bin/expo run:ios` / `run:android`
214
216
  (NOT Expo Go). Must compile with the native module linked.
215
217
  2. Watch Metro/Xcode/Android logs on launch for Superwall SDK startup.
216
218
  > **Important:** Superwall does **not** refetch config on hot reload - fully
@@ -246,15 +248,16 @@ The Expo SDK exposes these through the **`useUser`** hook and event hooks.
246
248
  ## Pitfalls
247
249
 
248
250
  - **"Cannot find native module 'SuperwallExpo'" / paywalls don't load** → you're on
249
- Expo Go. Build a dev client: `npx expo run:ios` / `run:android`, or
251
+ Expo Go. Build a dev client: `./node_modules/.bin/expo run:ios` / `run:android`, or
250
252
  `eas build --profile development --platform ios`.
251
- - **Existing app, native folders out of date** → `npx expo prebuild --clean` (back
253
+ - **Existing app, native folders out of date** → `./node_modules/.bin/expo prebuild --clean` (back
252
254
  up custom native code first).
253
255
  - **EAS build missing the module** → fresh dev build:
254
256
  `eas build --profile development --platform ios`.
255
- - **Stale caches after install** → `npx expo start --clear`, reinstall
257
+ - **Stale caches after install** → `./node_modules/.bin/expo start --clear`, reinstall
256
258
  `node_modules`, `pod install --repo-update` in `ios/`.
257
- - **Wrong Expo SDK** → `npx expo-doctor`; needs Expo SDK 53+.
259
+ - **Wrong Expo SDK** → `npx -y expo-doctor@1.20.4`; needs Expo SDK 53+.
260
+ Check the pinned doctor's Node `engines` requirement before running it.
258
261
  - **Changes not taking effect** → hot reload doesn't re-configure Superwall; fully
259
262
  restart.
260
263
 
@@ -75,7 +75,7 @@ consume `expo-superwall` without full Expo):
75
75
 
76
76
  ```bash
77
77
  curl -sL https://superwall.com/docs/expo/guides/using-expo-sdk-in-bare-react-native.md
78
- npx install-expo-modules@latest
78
+ npx -y install-expo-modules@0.16.0
79
79
  ```
80
80
 
81
81
  Install the SDK with the project's package manager (detect from lockfile):
@@ -202,7 +202,8 @@ setSubscriptionStatus({ status: "ACTIVE", entitlements: [{ id: "pro" }] })`.
202
202
 
203
203
  ## Verify (both paths)
204
204
 
205
- 1. **Native rebuild** & run: `npx react-native run-ios` / `run-android`. Path A must
205
+ 1. **Native rebuild** & run: `./node_modules/.bin/react-native run-ios` / `run-android`.
206
+ Run from the app root after installing its lockfile dependencies. Path A must
206
207
  relink the native module - rebuild, don't just reload JS.
207
208
  2. Watch native logs on launch for Superwall SDK startup.
208
209
  3. iOS purchase testing: StoreKit testing in Xcode.
@@ -231,7 +232,7 @@ Path A uses the `useUser` hook; Path B uses static `Superwall` methods.
231
232
  native rebuild (not just Metro reload).
232
233
  - **Reached for the wrong SDK** → prefer Path A (`expo-superwall`); the standalone
233
234
  `@superwall/react-native-superwall` is deprecated.
234
- - **Path A native module missing** → `npx install-expo-modules@latest` must succeed
235
+ - **Path A native module missing** → `npx -y install-expo-modules@0.16.0` must succeed
235
236
  before `pod install`; rebuild afterward.
236
237
  - **Configuring on every render** → Path B: wrap `configure` in `useEffect(..., [])`.
237
238
  - **Secret key** → key must start with `pk_`.
@@ -36,9 +36,9 @@ Entry points: `superwall` (SuperwallProvider — mounted for you),
36
36
 
37
37
  The framework is a private beta on the `next` channel. The CLI has
38
38
  `create`/`dev`/`push`/`promote`/`publish` and the rebuild forms of `migrate`
39
- only while `SUPERWALL_CHANNEL=next` is set; `superwall create` writes it into
40
- the project's `superwall/.env`, which the CLI loads for every later command.
41
- `Unknown command: create` means the variable is missing: export it and retry.
39
+ only while `SUPERWALL_CHANNEL=next` is set in the environment.
40
+ `Unknown command: create` means the variable is missing from your
41
+ environment: ask the user to set it globally (shell rc) and relaunch.
42
42
 
43
43
  ## Local references — the agent playbooks
44
44
 
@@ -157,7 +157,15 @@ Docs beyond the framework (dashboard, SDKs, web checkout setup):
157
157
  Store products differ per store, so a shared slot takes one id per
158
158
  platform — `annual: { ios: "…", android: "…" }` — while
159
159
  `purchase("annual")` stays the same call; the slot must name every
160
- platform the paywall ships to.
160
+ platform the paywall ships to. UI one platform must never show
161
+ (restore, sign-out, an App Store exit offer) branches on
162
+ `useDevice().hostPlatform` — `"ios" | "android" | "web" | undefined`,
163
+ normalized and known from the first render — never on the raw
164
+ `platform` string; show neither variant while it is `undefined`. A
165
+ `"web"` paywall runs inside the Web SDK on the merchant's page, which
166
+ hosts it as the web paywall app hosts editor paywalls: the SDK prices
167
+ the Stripe products, reports the events and finishes the checkout, so
168
+ `register()` resolves `purchased`, with no redemption step.
161
169
  11. **Shipping includes the dashboard.** A push that fails on missing
162
170
  products is not a blocker to report — create them with
163
171
  `superwall products create` ([references/cli.md](references/cli.md)).
@@ -1,10 +1,10 @@
1
- import "./output-B0spXJAT.js";
2
- import "./telemetry-y1JmBs4f.js";
3
- import "./update-CLYT9c3k.js";
4
- import "./token-uDs-2KqY.js";
5
- import { t as defineCommand } from "./command-Du-b_Jji.js";
1
+ import "./output-XKuoEEjP.js";
2
+ import "./telemetry-EzV7cA7s.js";
3
+ import "./update-Cz3Q3MFj.js";
4
+ import "./token-r5g876aI.js";
5
+ import { t as defineCommand } from "./command-BJ_6850A.js";
6
6
  import { n as ui } from "./ui-4gLyfrgl.js";
7
- import { a as skillsOutOfDate, o as syncSkills, r as fetchPublicSkills, t as SKILLS_INSTALL_SOURCE } from "./skills-B6Sy3Tq0.js";
7
+ import { a as skillsOutOfDate, o as syncSkills, r as fetchPublicSkills, t as SKILLS_INSTALL_SOURCE } from "./skills-DsBAVRTE.js";
8
8
  import "./spawn-DSoTXy_j.js";
9
9
  import { t as withSpinner } from "./spinner-DFctF_Jw.js";
10
10
 
@@ -1,5 +1,5 @@
1
- import { a as AGENT_SKILLS_DIR, l as CHANNEL, u as CHANNELS, y as VERSION } from "./output-B0spXJAT.js";
2
- import { h as setSkillsSync, i as track, u as getSkillsSync } from "./telemetry-y1JmBs4f.js";
1
+ import { a as AGENT_SKILLS_DIR, l as CHANNEL, u as CHANNELS, y as VERSION } from "./output-XKuoEEjP.js";
2
+ import { h as setSkillsSync, i as track, u as getSkillsSync } from "./telemetry-EzV7cA7s.js";
3
3
  import { n as ui } from "./ui-4gLyfrgl.js";
4
4
  import { r as spawnStream } from "./spawn-DSoTXy_j.js";
5
5
  import { dirname, join } from "node:path";
@@ -1,4 +1,4 @@
1
- import { _ as TELEMETRY_HOST, g as SUPERWALL_HOME, r as formatJson, v as TELEMETRY_KEY, x as isNonInteractive, y as VERSION } from "./output-B0spXJAT.js";
1
+ import { _ as TELEMETRY_HOST, g as SUPERWALL_HOME, r as formatJson, v as TELEMETRY_KEY, x as isNonInteractive, y as VERSION } from "./output-XKuoEEjP.js";
2
2
  import { join } from "node:path";
3
3
  import { homedir } from "node:os";
4
4
  import { randomUUID } from "node:crypto";
@@ -1,4 +1,4 @@
1
- import { g as SUPERWALL_HOME, r as formatJson } from "./output-B0spXJAT.js";
1
+ import { g as SUPERWALL_HOME, r as formatJson } from "./output-XKuoEEjP.js";
2
2
  import { join } from "node:path";
3
3
  import { homedir } from "node:os";
4
4
  import { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from "node:fs";
@@ -1,5 +1,5 @@
1
- import { y as VERSION } from "./output-B0spXJAT.js";
2
- import { d as getUpdateCheck, g as setUpdateCheck } from "./telemetry-y1JmBs4f.js";
1
+ import { y as VERSION } from "./output-XKuoEEjP.js";
2
+ import { d as getUpdateCheck, g as setUpdateCheck } from "./telemetry-EzV7cA7s.js";
3
3
  import pc from "picocolors";
4
4
 
5
5
  //#region src/core/update.ts
@@ -1,8 +1,8 @@
1
- import { y as VERSION } from "./output-B0spXJAT.js";
2
- import { g as setUpdateCheck } from "./telemetry-y1JmBs4f.js";
3
- import { r as isNewerVersion, t as fetchLatestVersion } from "./update-CLYT9c3k.js";
4
- import "./token-uDs-2KqY.js";
5
- import { t as defineCommand } from "./command-Du-b_Jji.js";
1
+ import { y as VERSION } from "./output-XKuoEEjP.js";
2
+ import { g as setUpdateCheck } from "./telemetry-EzV7cA7s.js";
3
+ import { r as isNewerVersion, t as fetchLatestVersion } from "./update-Cz3Q3MFj.js";
4
+ import "./token-r5g876aI.js";
5
+ import { t as defineCommand } from "./command-BJ_6850A.js";
6
6
  import "./ui-4gLyfrgl.js";
7
7
  import { r as spawnStream } from "./spawn-DSoTXy_j.js";
8
8
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@superwall/cli",
3
- "version": "1.5.0",
3
+ "version": "1.6.1",
4
4
  "description": "The official CLI for managing Superwall from your terminal or coding agent.",
5
5
  "keywords": [
6
6
  "agent",
@@ -59,7 +59,7 @@
59
59
  },
60
60
  "dependencies": {
61
61
  "@anthropic-ai/claude-agent-sdk": "0.3.201",
62
- "@superwall/studio": "1.5.0",
62
+ "@superwall/studio": "1.6.1",
63
63
  "ansi-escapes": "^7.3.0",
64
64
  "fast-glob": "^3.3.3",
65
65
  "ink": "^5.2.1",
@@ -1,21 +0,0 @@
1
- import "./output-B0spXJAT.js";
2
- import "./telemetry-y1JmBs4f.js";
3
- import "./update-CLYT9c3k.js";
4
- import "./token-uDs-2KqY.js";
5
- import "./command-Du-b_Jji.js";
6
- import "./ui-4gLyfrgl.js";
7
- import "./skills-B6Sy3Tq0.js";
8
- import "./spawn-DSoTXy_j.js";
9
- import "./login-kiXaqdkC.js";
10
- import "./scan-Cp_UTTEw.js";
11
- import "./hosted-B_5T7emr.js";
12
- import "./spinner-DFctF_Jw.js";
13
- import "./resources-Bf9O1JNM.js";
14
- import "./org-CV8c849b.js";
15
- import "./bind-CZOevfSJ.js";
16
- import "./pipeline-G5bZKqrN.js";
17
- import "./actions-C0AzXRrF.js";
18
- import "./app-BJxaQo2S.js";
19
- import { t as runDev } from "./dev-0p2GTz3J.js";
20
-
21
- export { runDev };