@superwall/paywalls-react 0.1.1 → 0.1.3

package/.turbo/turbo-test.log

@@ -2,10 +2,11 @@ $ bun test
 bun test v1.3.11 (af24e281)
 
 src/index.test.ts:
-(pass) re-exports SDK_VERSION from @superwall/paywalls-js [0.86ms]
+(pass) re-exports SDK_VERSION from @superwall/paywalls-js [0.96ms]
 
 src/hooks.test.tsx:
-(pass) useSignal returns the current value and re-renders on change [87.55ms]
+[Superwall:transactions] entitlements GET failed NetworkDecodingError: entitlements JSON decode failed: JSON Parse error: Unexpected EOF
+[Superwall:transactions] entitlements GET failed NetworkDecodingError: entitlements JSON decode failed: JSON Parse error: Unexpected EOF
 244 |         }, !keepOpen)
 245 |           handleResponse();
 246 |         onEnd();
@@ -30,6 +31,9 @@ NetworkError: Failed to execute "fetch()" on "Window" with URL "https://paywalls
       at emitError (node:events:43:23)
       at <anonymous> (node:_http_client:253:22)
 
+[Superwall:transactions] entitlements GET failed NetworkDecodingError: entitlements JSON decode failed: JSON Parse error: Unexpected EOF
+[Superwall:transactions] entitlements GET failed NetworkDecodingError: entitlements JSON decode failed: JSON Parse error: Unexpected EOF
+(pass) useSignal returns the current value and re-renders on change [217.28ms]
 error: Was there a typo in the url or port?
   path: "https://paywalls.test/pw_default?platform=web&transport=web&debug=false",
  errno: 0,
@@ -48,8 +52,11 @@ NetworkError: Failed to execute "fetch()" on "Window" with URL "https://paywalls
       at emitError (node:events:43:23)
       at <anonymous> (node:_http_client:253:22)
 
-[Superwall:transactions] entitlements GET failed entitlements JSON decode failed: JSON Parse error: Unexpected EOF
-(pass) useUser exposes id/aliasId/effectiveId/isLoggedIn and updates on identify/signOut [40.45ms]
+[Superwall:transactions] entitlements GET failed NetworkDecodingError: entitlements JSON decode failed: JSON Parse error: Unexpected EOF
+[Superwall:transactions] entitlements GET failed NetworkDecodingError: entitlements JSON decode failed: JSON Parse error: Unexpected EOF
+[Superwall:transactions] entitlements GET failed NetworkDecodingError: entitlements JSON decode failed: JSON Parse error: Unexpected EOF
+[Superwall:transactions] entitlements GET failed NetworkDecodingError: entitlements JSON decode failed: JSON Parse error: Unexpected EOF
+(pass) useUser exposes id/aliasId/effectiveId/isLoggedIn and updates on identify/signOut [66.09ms]
 244 |         }, !keepOpen)
 245 |           handleResponse();
 246 |         onEnd();
@@ -74,8 +81,9 @@ NetworkError: Failed to execute "fetch()" on "Window" with URL "https://paywalls
       at emitError (node:events:43:23)
       at <anonymous> (node:_http_client:253:22)
 
-[Superwall:transactions] entitlements GET failed entitlements JSON decode failed: JSON Parse error: Unexpected EOF
-(pass) useUser.subscriptionStatus + entitlements update after setSubscriptionStatus [19.96ms]
+[Superwall:transactions] entitlements GET failed NetworkDecodingError: entitlements JSON decode failed: JSON Parse error: Unexpected EOF
+[Superwall:transactions] entitlements GET failed NetworkDecodingError: entitlements JSON decode failed: JSON Parse error: Unexpected EOF
+(pass) useUser.subscriptionStatus + entitlements update after setSubscriptionStatus [71.45ms]
 error: Was there a typo in the url or port?
   path: "https://paywalls.test/pw_default?platform=web&transport=web&debug=false",
  errno: 0,
@@ -94,8 +102,9 @@ NetworkError: Failed to execute "fetch()" on "Window" with URL "https://paywalls
       at emitError (node:events:43:23)
       at <anonymous> (node:_http_client:253:22)
 
-[Superwall:transactions] entitlements GET failed entitlements JSON decode failed: JSON Parse error: Unexpected EOF
-(pass) usePlacement reflects presented + dismissed state and routes handler callbacks [38.22ms]
+[Superwall:transactions] entitlements GET failed NetworkDecodingError: entitlements JSON decode failed: JSON Parse error: Unexpected EOF
+[Superwall:transactions] entitlements GET failed NetworkDecodingError: entitlements JSON decode failed: JSON Parse error: Unexpected EOF
+(pass) usePlacement reflects presented + dismissed state and routes handler callbacks [68.23ms]
 244 |         }, !keepOpen)
 245 |           handleResponse();
 246 |         onEnd();
@@ -120,8 +129,9 @@ NetworkError: Failed to execute "fetch()" on "Window" with URL "https://paywalls
       at emitError (node:events:43:23)
       at <anonymous> (node:_http_client:253:22)
 
-[Superwall:transactions] entitlements GET failed entitlements JSON decode failed: JSON Parse error: Unexpected EOF
-(pass) usePlacement: ACTIVE subscription → register returns skipped(userSubscribed) [21.88ms]
+[Superwall:transactions] entitlements GET failed NetworkDecodingError: entitlements JSON decode failed: JSON Parse error: Unexpected EOF
+[Superwall:transactions] entitlements GET failed NetworkDecodingError: entitlements JSON decode failed: JSON Parse error: Unexpected EOF
+(pass) usePlacement: ACTIVE subscription → register returns skipped(userSubscribed) [43.31ms]
 error: Was there a typo in the url or port?
   path: "https://paywalls.test/pw_default?platform=web&transport=web&debug=false",
  errno: 0,
@@ -140,8 +150,9 @@ NetworkError: Failed to execute "fetch()" on "Window" with URL "https://paywalls
       at emitError (node:events:43:23)
       at <anonymous> (node:_http_client:253:22)
 
-[Superwall:transactions] entitlements GET failed entitlements JSON decode failed: JSON Parse error: Unexpected EOF
-(pass) useSuperwallEvent attaches a typed listener and auto-detaches on unmount [17.06ms]
+[Superwall:transactions] entitlements GET failed NetworkDecodingError: entitlements JSON decode failed: JSON Parse error: Unexpected EOF
+[Superwall:transactions] entitlements GET failed NetworkDecodingError: entitlements JSON decode failed: JSON Parse error: Unexpected EOF
+(pass) useSuperwallEvent attaches a typed listener and auto-detaches on unmount [37.92ms]
 244 |         }, !keepOpen)
 245 |           handleResponse();
 246 |         onEnd();
@@ -166,8 +177,9 @@ NetworkError: Failed to execute "fetch()" on "Window" with URL "https://paywalls
       at emitError (node:events:43:23)
       at <anonymous> (node:_http_client:253:22)
 
-[Superwall:transactions] entitlements GET failed entitlements JSON decode failed: JSON Parse error: Unexpected EOF
-(pass) useDelegate installs a delegate for the lifetime of the component [22.59ms]
+[Superwall:transactions] entitlements GET failed NetworkDecodingError: entitlements JSON decode failed: JSON Parse error: Unexpected EOF
+[Superwall:transactions] entitlements GET failed NetworkDecodingError: entitlements JSON decode failed: JSON Parse error: Unexpected EOF
+(pass) useDelegate installs a delegate for the lifetime of the component [41.24ms]
 error: Was there a typo in the url or port?
   path: "https://paywalls.test/pw_default?platform=web&transport=web&debug=false",
  errno: 0,
@@ -186,8 +198,9 @@ NetworkError: Failed to execute "fetch()" on "Window" with URL "https://paywalls
       at emitError (node:events:43:23)
       at <anonymous> (node:_http_client:253:22)
 
-[Superwall:transactions] entitlements GET failed entitlements JSON decode failed: JSON Parse error: Unexpected EOF
-(pass) useSignal: unstable signal identity per render doesn't trigger infinite re-render [16.51ms]
+[Superwall:transactions] entitlements GET failed NetworkDecodingError: entitlements JSON decode failed: JSON Parse error: Unexpected EOF
+[Superwall:transactions] entitlements GET failed NetworkDecodingError: entitlements JSON decode failed: JSON Parse error: Unexpected EOF
+(pass) useSignal: unstable signal identity per render doesn't trigger infinite re-render [38.58ms]
 244 |         }, !keepOpen)
 245 |           handleResponse();
 246 |         onEnd();
@@ -212,20 +225,25 @@ NetworkError: Failed to execute "fetch()" on "Window" with URL "https://paywalls
       at emitError (node:events:43:23)
       at <anonymous> (node:_http_client:253:22)
 
-[Superwall:transactions] entitlements GET failed entitlements JSON decode failed: JSON Parse error: Unexpected EOF
-(pass) useDelegate: unmounting one of two stacked hooks leaves the other installed [43.03ms]
+[Superwall:transactions] entitlements GET failed NetworkDecodingError: entitlements JSON decode failed: JSON Parse error: Unexpected EOF
+[Superwall:transactions] entitlements GET failed NetworkDecodingError: entitlements JSON decode failed: JSON Parse error: Unexpected EOF
+(pass) useDelegate: unmounting one of two stacked hooks leaves the other installed [43.98ms]
 
 src/provider.test.tsx:
-[Superwall:transactions] entitlements GET failed entitlements JSON decode failed: JSON Parse error: Unexpected EOF
-(pass) SuperwallProvider provides a Superwall instance via context [8.13ms]
-(pass) useSuperwall outside <SuperwallProvider> throws a clear error [1.58ms]
-[Superwall:transactions] entitlements GET failed entitlements JSON decode failed: JSON Parse error: Unexpected EOF
-(pass) registry reuses the instance across re-mounts with the same apiKey (HMR) [25.73ms]
-[Superwall:transactions] entitlements GET failed entitlements JSON decode failed: JSON Parse error: Unexpected EOF
-[Superwall:transactions] entitlements GET failed entitlements JSON decode failed: JSON Parse error: Unexpected EOF
-(pass) different apiKeys produce different instances [14.89ms]
+[Superwall:transactions] entitlements GET failed NetworkDecodingError: entitlements JSON decode failed: JSON Parse error: Unexpected EOF
+[Superwall:transactions] entitlements GET failed NetworkDecodingError: entitlements JSON decode failed: JSON Parse error: Unexpected EOF
+(pass) SuperwallProvider provides a Superwall instance via context [22.84ms]
+(pass) useSuperwall outside <SuperwallProvider> throws a clear error [16.59ms]
+[Superwall:transactions] entitlements GET failed NetworkDecodingError: entitlements JSON decode failed: JSON Parse error: Unexpected EOF
+[Superwall:transactions] entitlements GET failed NetworkDecodingError: entitlements JSON decode failed: JSON Parse error: Unexpected EOF
+(pass) registry reuses the instance across re-mounts with the same apiKey (HMR) [34.67ms]
+[Superwall:transactions] entitlements GET failed NetworkDecodingError: entitlements JSON decode failed: JSON Parse error: Unexpected EOF
+[Superwall:transactions] entitlements GET failed NetworkDecodingError: entitlements JSON decode failed: JSON Parse error: Unexpected EOF
+[Superwall:transactions] entitlements GET failed NetworkDecodingError: entitlements JSON decode failed: JSON Parse error: Unexpected EOF
+[Superwall:transactions] entitlements GET failed NetworkDecodingError: entitlements JSON decode failed: JSON Parse error: Unexpected EOF
+(pass) different apiKeys produce different instances [23.18ms]
 
  14 pass
  0 fail
  40 expect() calls
-Ran 14 tests across 3 files. [711.00ms]
+Ran 14 tests across 3 files. [972.00ms]

package/README.md

@@ -0,0 +1,79 @@
+# @superwall/paywalls-react
+
+React 19 bindings for the Superwall web SDK — a provider + hooks over
+[`@superwall/paywalls-js`](https://www.npmjs.com/package/@superwall/paywalls-js).
+
+```sh
+bun add @superwall/paywalls-react   # or npm / pnpm / yarn
+```
+
+## Quick start
+
+Wrap your app once:
+
+```tsx
+import { SuperwallProvider } from "@superwall/paywalls-react";
+
+export function Root() {
+  return (
+    <SuperwallProvider apiKey="pk_your_public_key">
+      <App />
+    </SuperwallProvider>
+  );
+}
+```
+
+`SuperwallProvider` takes the same config as `createSuperwall`
+(`apiKey`, `storage`, `delegate`, `identity`, `options`).
+
+## Placements
+
+```tsx
+import { usePlacement } from "@superwall/paywalls-react";
+
+function GoPro() {
+  const { register, state } = usePlacement({
+    onPresent: (info) => {},
+    onDismiss: (info, result) => {},
+    onSkip: (reason) => {},
+  });
+
+  return (
+    <button onClick={() => register({ placement: "campaign_trigger" })}>
+      Go Pro {state.type === "presented" && "(open)"}
+    </button>
+  );
+}
+```
+
+## Subscription status & user
+
+```tsx
+import { useUser } from "@superwall/paywalls-react";
+
+function Status() {
+  const { id, isLoggedIn, subscriptionStatus, entitlements, identify, signOut } =
+    useUser();
+
+  if (subscriptionStatus.status === "ACTIVE") return <Pro />;
+  return <button onClick={() => identify("app_user_123")}>Log in</button>;
+}
+```
+
+## Hooks
+
+| Hook | What it gives you |
+|------|-------------------|
+| `useSuperwall()` | the raw `Superwall` instance |
+| `usePlacement(handler?)` | `{ register, state }` |
+| `useUser()` | reactive identity + subscription + `identify`/`signOut`/`setAttributes` |
+| `useSignal(signal)` | subscribe to any SDK `Readable<T>` |
+| `useSuperwallEvent(name, fn)` | typed event listener, auto-cleanup |
+| `useDelegate(delegate)` | install [delegate callbacks](https://www.npmjs.com/package/@superwall/paywalls-js#delegate-methods) for the component's lifetime |
+
+All of `@superwall/paywalls-js` is re-exported, so you don't need to depend on
+both packages directly.
+
+## License
+
+MIT

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@superwall/paywalls-react",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "type": "module",
   "license": "MIT",
   "exports": {
@@ -17,10 +17,10 @@
   },
   "peerDependencies": {
     "react": "^19.0.0",
-    "@superwall/paywalls-js": "0.0.0"
+    "@superwall/paywalls-js": "^0.1.3"
   },
   "dependencies": {
-    "@superwall/paywalls-js": "0.0.0"
+    "@superwall/paywalls-js": "^0.1.3"
   },
   "devDependencies": {
     "@happy-dom/global-registrator": "^20.0.0",