@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.
- package/README.md +2 -3
- package/dist/{actions-C0AzXRrF.js → actions-BdZ-7BJd.js} +2 -2
- package/dist/{api-BnM4rTKN.js → api-FjrCPu6r.js} +5 -5
- package/dist/{app-BJxaQo2S.js → app-YeJj35Ia.js} +7 -7
- package/dist/{asa-CLXU3JO4.js → asa-4nk7HHy8.js} +5 -5
- package/dist/{asc-CZowAIf_.js → asc-2TZOQuK1.js} +5 -5
- package/dist/{auth-CAEGguzH.js → auth-QUYfKdwk.js} +8 -8
- package/dist/auth.js +2 -2
- package/dist/{billing-DHTBwrRm.js → billing-BK7bpv1t.js} +1 -1
- package/dist/{bind-CZOevfSJ.js → bind-Ch4VR2EY.js} +1 -1
- package/dist/{command-Du-b_Jji.js → command-BJ_6850A.js} +4 -4
- package/dist/{create-Z_IbSC9n.js → create-vSQxQlEP.js} +18 -18
- package/dist/dev-B9qmPH1W.js +21 -0
- package/dist/{dev-0p2GTz3J.js → dev-DEss5dwo.js} +4 -4
- package/dist/{doctor-MHJadguy.js → doctor-BYTfekBr.js} +9 -9
- package/dist/{drivers-8y9Qd-qe.js → drivers-DGml3OlF.js} +2 -2
- package/dist/entry.js +27 -27
- package/dist/{existing-BBHtVCwp.js → existing-DgSo639M.js} +2 -2
- package/dist/{feedback-BK4fdySj.js → feedback-4LsBpZZx.js} +5 -5
- package/dist/{hosted-B_5T7emr.js → hosted-DqGp6oV2.js} +2 -2
- package/dist/{integrate-CEuN4ebb.js → integrate-Cl9eKHoF.js} +16 -16
- package/dist/{login-kiXaqdkC.js → login-DS3MPeW2.js} +3 -3
- package/dist/{migrate-C8Y3z2iF.js → migrate-WiTO71PE.js} +19 -19
- package/dist/{open-studio-BGXha018.js → open-studio-CbMUL5Va.js} +9 -10
- package/dist/{output-B0spXJAT.js → output-XKuoEEjP.js} +1 -1
- package/dist/{pipeline-G5bZKqrN.js → pipeline-J9-nENTS.js} +4 -5
- package/dist/{print-skill-CRpqzrBD.js → print-skill-BOGm5Szi.js} +6 -6
- package/dist/{promote-BtDlI6UX.js → promote-Ci085QxU.js} +13 -13
- package/dist/{publish-C94YHFK5.js → publish--TV-j8Zd.js} +13 -13
- package/dist/{push-DOTj3kLl.js → push-CpGetsJF.js} +13 -13
- package/dist/{query-COqz70_0.js → query-BZStoGLM.js} +5 -5
- package/dist/{resource-PBkSYrXp.js → resource-ClLHSXi6.js} +8 -8
- package/dist/{run-C7ou9t2X.js → run-CiaWn78U.js} +2 -2
- package/dist/{scan-Cp_UTTEw.js → scan-DEgX5HxV.js} +1 -1
- package/dist/skills/superwall/SKILL.md +70 -39
- package/dist/skills/superwall/references/api.md +14 -21
- package/dist/skills/superwall/references/asa.md +6 -0
- package/dist/skills/superwall/references/asc.md +7 -8
- package/dist/skills/superwall/references/data-analytics.md +7 -4
- package/dist/skills/superwall/references/docs.md +2 -2
- package/dist/skills/superwall/references/sdk-integration.md +3 -4
- package/dist/skills/superwall/workflows/dashboard/setup.md +23 -24
- package/dist/skills/superwall/workflows/integrate/expo.md +14 -11
- package/dist/skills/superwall/workflows/integrate/react-native.md +4 -3
- package/dist/skills/superwall-framework/SKILL.md +12 -4
- package/dist/{skills-m2D6qoYX.js → skills-DjPCmUMU.js} +6 -6
- package/dist/{skills-B6Sy3Tq0.js → skills-DsBAVRTE.js} +2 -2
- package/dist/{telemetry-y1JmBs4f.js → telemetry-EzV7cA7s.js} +1 -1
- package/dist/{token-uDs-2KqY.js → token-r5g876aI.js} +1 -1
- package/dist/{update-CLYT9c3k.js → update-Cz3Q3MFj.js} +2 -2
- package/dist/{upgrade-DLrdLVJk.js → upgrade-BA_4sdnh.js} +5 -5
- package/package.json +2 -2
- 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.
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
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
|
-
|
|
81
|
-
# or: pnpm
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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:
|
|
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:
|
|
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** →
|
|
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** →
|
|
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@
|
|
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:
|
|
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@
|
|
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
|
|
40
|
-
|
|
41
|
-
|
|
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-
|
|
2
|
-
import "./telemetry-
|
|
3
|
-
import "./update-
|
|
4
|
-
import "./token-
|
|
5
|
-
import { t as defineCommand } from "./command-
|
|
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-
|
|
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-
|
|
2
|
-
import { h as setSkillsSync, i as track, u as getSkillsSync } from "./telemetry-
|
|
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-
|
|
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-
|
|
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-
|
|
2
|
-
import { d as getUpdateCheck, g as setUpdateCheck } from "./telemetry-
|
|
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-
|
|
2
|
-
import { g as setUpdateCheck } from "./telemetry-
|
|
3
|
-
import { r as isNewerVersion, t as fetchLatestVersion } from "./update-
|
|
4
|
-
import "./token-
|
|
5
|
-
import { t as defineCommand } from "./command-
|
|
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.
|
|
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.
|
|
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",
|
package/dist/dev-dB-b2xI3.js
DELETED
|
@@ -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 };
|