@strimz/sdk-react 0.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.
- package/LICENSE +21 -0
- package/README.md +86 -0
- package/dist/index.cjs +302 -0
- package/dist/index.cjs.map +1 -0
- package/dist/index.d.cts +122 -0
- package/dist/index.d.ts +122 -0
- package/dist/index.js +274 -0
- package/dist/index.js.map +1 -0
- package/package.json +81 -0
- package/src/components/StrimzCheckoutEmbed.tsx +78 -0
- package/src/components/StrimzPayButton.tsx +139 -0
- package/src/hooks/useStrimzCheckout.ts +102 -0
- package/src/hooks/useStrimzClient.ts +9 -0
- package/src/hooks/useStrimzSession.ts +79 -0
- package/src/index.ts +37 -0
- package/src/provider.tsx +50 -0
package/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 Strimz
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
package/README.md
ADDED
|
@@ -0,0 +1,86 @@
|
|
|
1
|
+
# @strimz/sdk-react
|
|
2
|
+
|
|
3
|
+
React components and hooks for Strimz hosted checkout. Drop-in `<StrimzPayButton/>`, embeddable iframe, typed hooks. Works with React 18 and 19, Next.js App Router (`'use client'`), Remix, and Vite.
|
|
4
|
+
|
|
5
|
+
## Install
|
|
6
|
+
|
|
7
|
+
```sh
|
|
8
|
+
pnpm add @strimz/sdk-react
|
|
9
|
+
```
|
|
10
|
+
|
|
11
|
+
(`@strimz/sdk` and `react` ≥18 are peer dependencies.)
|
|
12
|
+
|
|
13
|
+
## Quick start
|
|
14
|
+
|
|
15
|
+
```tsx
|
|
16
|
+
'use client'
|
|
17
|
+
import { StrimzProvider, StrimzPayButton } from '@strimz/sdk-react'
|
|
18
|
+
|
|
19
|
+
export default function Layout({ children }: { children: React.ReactNode }) {
|
|
20
|
+
return (
|
|
21
|
+
<StrimzProvider publishableKey={process.env.NEXT_PUBLIC_STRIMZ_PUBLISHABLE_KEY!}>
|
|
22
|
+
{children}
|
|
23
|
+
</StrimzProvider>
|
|
24
|
+
)
|
|
25
|
+
}
|
|
26
|
+
|
|
27
|
+
export function PayPage({ sessionId }: { sessionId: string }) {
|
|
28
|
+
return (
|
|
29
|
+
<StrimzPayButton
|
|
30
|
+
sessionId={sessionId}
|
|
31
|
+
onSuccess={(txHash) => console.log('paid:', txHash)}
|
|
32
|
+
onCancel={() => console.log('cancelled')}
|
|
33
|
+
/>
|
|
34
|
+
)
|
|
35
|
+
}
|
|
36
|
+
```
|
|
37
|
+
|
|
38
|
+
The merchant's backend creates the session via `@strimz/sdk` and passes its `id` to the React component.
|
|
39
|
+
|
|
40
|
+
## API
|
|
41
|
+
|
|
42
|
+
### `<StrimzProvider/>`
|
|
43
|
+
|
|
44
|
+
Wraps any tree that uses Strimz components/hooks. Exposes a memoised `StrimzBrowserClient` and the hosted-checkout origin.
|
|
45
|
+
|
|
46
|
+
| Prop | Default | Notes |
|
|
47
|
+
| ---------------- | ---------------------------- | ----------------------------------- |
|
|
48
|
+
| `publishableKey` | required | `pk_test_...` or `pk_live_...` |
|
|
49
|
+
| `apiBaseUrl` | `https://api.strimz.io` | Override for staging |
|
|
50
|
+
| `checkoutOrigin` | `https://checkout.strimz.io` | Origin used to filter `postMessage` |
|
|
51
|
+
|
|
52
|
+
### `<StrimzPayButton/>`
|
|
53
|
+
|
|
54
|
+
| Prop | Default | Notes |
|
|
55
|
+
| -------------------- | ----------------- | ---------------------------------------------------------------- |
|
|
56
|
+
| `sessionId` | required | Returned by `strimz.paymentSessions.create(...)` on your backend |
|
|
57
|
+
| `mode` | `popup` | `popup` or `redirect` |
|
|
58
|
+
| `theme` | `auto` | `auto` / `light` / `dark` |
|
|
59
|
+
| `size` | `md` | `sm` / `md` / `lg` |
|
|
60
|
+
| `onSuccess(txHash?)` | none | Fired on `strimz:checkout:success` postMessage |
|
|
61
|
+
| `onCancel()` | none | Fired on `strimz:checkout:cancel` or popup close |
|
|
62
|
+
| `onError(error)` | none | Fired on `strimz:checkout:error` |
|
|
63
|
+
| `label` | `Pay with Strimz` | Override the button content |
|
|
64
|
+
|
|
65
|
+
### `<StrimzCheckoutEmbed/>`
|
|
66
|
+
|
|
67
|
+
Iframe-embedded checkout for merchants who want the flow inside their page rather than in a popup.
|
|
68
|
+
|
|
69
|
+
### Hooks
|
|
70
|
+
|
|
71
|
+
- `useStrimzClient()`. Returns the singleton `StrimzBrowserClient`.
|
|
72
|
+
- `useStrimzSession(sessionId, { pollIntervalMs })`. Polls a session until it reaches a terminal state.
|
|
73
|
+
- `useStrimzCheckout({ mode, onSuccess, onCancel, onError })`. Imperative checkout opener for custom UI.
|
|
74
|
+
|
|
75
|
+
## Security
|
|
76
|
+
|
|
77
|
+
- `postMessage` from the iframe / popup is filtered by `checkoutOrigin`. A page on a different origin cannot spoof success.
|
|
78
|
+
- The provider rejects secret keys (`sk_*`) at construction time so a misconfigured environment fails loud.
|
|
79
|
+
|
|
80
|
+
## SSR / RSC
|
|
81
|
+
|
|
82
|
+
Every export is marked `'use client'`. Import these from a Client Component in Next.js App Router. Server Components should only ever see the session id; never instantiate `StrimzBrowserClient` on the server.
|
|
83
|
+
|
|
84
|
+
## Bundle
|
|
85
|
+
|
|
86
|
+
Distributed as ESM + CJS. React is `external`, so the published bundle is small (~6kb gzipped before tree-shaking). All inline styles in `<StrimzPayButton/>` keep the dependency surface zero. No Tailwind, no shadcn, no CSS imports required.
|
package/dist/index.cjs
ADDED
|
@@ -0,0 +1,302 @@
|
|
|
1
|
+
'use strict';
|
|
2
|
+
|
|
3
|
+
var React2 = require('react');
|
|
4
|
+
var browser = require('@strimz/sdk/browser');
|
|
5
|
+
var jsxRuntime = require('react/jsx-runtime');
|
|
6
|
+
|
|
7
|
+
function _interopNamespace(e) {
|
|
8
|
+
if (e && e.__esModule) return e;
|
|
9
|
+
var n = Object.create(null);
|
|
10
|
+
if (e) {
|
|
11
|
+
Object.keys(e).forEach(function (k) {
|
|
12
|
+
if (k !== 'default') {
|
|
13
|
+
var d = Object.getOwnPropertyDescriptor(e, k);
|
|
14
|
+
Object.defineProperty(n, k, d.get ? d : {
|
|
15
|
+
enumerable: true,
|
|
16
|
+
get: function () { return e[k]; }
|
|
17
|
+
});
|
|
18
|
+
}
|
|
19
|
+
});
|
|
20
|
+
}
|
|
21
|
+
n.default = e;
|
|
22
|
+
return Object.freeze(n);
|
|
23
|
+
}
|
|
24
|
+
|
|
25
|
+
var React2__namespace = /*#__PURE__*/_interopNamespace(React2);
|
|
26
|
+
|
|
27
|
+
var StrimzContext = React2__namespace.createContext(null);
|
|
28
|
+
function StrimzProvider({
|
|
29
|
+
publishableKey,
|
|
30
|
+
apiBaseUrl,
|
|
31
|
+
checkoutOrigin = "https://checkout.strimz.io",
|
|
32
|
+
children
|
|
33
|
+
}) {
|
|
34
|
+
const value = React2__namespace.useMemo(
|
|
35
|
+
() => ({
|
|
36
|
+
client: new browser.StrimzBrowserClient({ publishableKey, baseUrl: apiBaseUrl }),
|
|
37
|
+
checkoutOrigin
|
|
38
|
+
}),
|
|
39
|
+
[publishableKey, apiBaseUrl, checkoutOrigin]
|
|
40
|
+
);
|
|
41
|
+
return /* @__PURE__ */ jsxRuntime.jsx(StrimzContext.Provider, { value, children });
|
|
42
|
+
}
|
|
43
|
+
function useStrimzContext() {
|
|
44
|
+
const ctx = React2__namespace.useContext(StrimzContext);
|
|
45
|
+
if (!ctx) {
|
|
46
|
+
throw new Error("useStrimzContext / Strimz components must be used inside a <StrimzProvider/>.");
|
|
47
|
+
}
|
|
48
|
+
return ctx;
|
|
49
|
+
}
|
|
50
|
+
|
|
51
|
+
// src/hooks/useStrimzClient.ts
|
|
52
|
+
function useStrimzClient() {
|
|
53
|
+
return useStrimzContext().client;
|
|
54
|
+
}
|
|
55
|
+
var TERMINAL_STATES = [
|
|
56
|
+
"confirmed",
|
|
57
|
+
"failed",
|
|
58
|
+
"expired",
|
|
59
|
+
"cancelled"
|
|
60
|
+
];
|
|
61
|
+
function useStrimzSession(sessionId, options = {}) {
|
|
62
|
+
const client = useStrimzClient();
|
|
63
|
+
const [session, setSession] = React2__namespace.useState(null);
|
|
64
|
+
const [loading, setLoading] = React2__namespace.useState(false);
|
|
65
|
+
const [error, setError] = React2__namespace.useState(null);
|
|
66
|
+
const cancelledRef = React2__namespace.useRef(false);
|
|
67
|
+
const fetchOnce = React2__namespace.useCallback(async () => {
|
|
68
|
+
if (!sessionId) return;
|
|
69
|
+
setLoading(true);
|
|
70
|
+
try {
|
|
71
|
+
const next = await client.checkout.session(sessionId);
|
|
72
|
+
if (!cancelledRef.current) {
|
|
73
|
+
setSession(next);
|
|
74
|
+
setError(null);
|
|
75
|
+
}
|
|
76
|
+
} catch (err) {
|
|
77
|
+
if (!cancelledRef.current) setError(err);
|
|
78
|
+
} finally {
|
|
79
|
+
if (!cancelledRef.current) setLoading(false);
|
|
80
|
+
}
|
|
81
|
+
}, [client, sessionId]);
|
|
82
|
+
React2__namespace.useEffect(() => {
|
|
83
|
+
cancelledRef.current = false;
|
|
84
|
+
if (!sessionId) return;
|
|
85
|
+
void fetchOnce();
|
|
86
|
+
const interval = options.pollIntervalMs ?? 3e3;
|
|
87
|
+
const timer = setInterval(() => {
|
|
88
|
+
if (session && TERMINAL_STATES.includes(session.status)) return;
|
|
89
|
+
void fetchOnce();
|
|
90
|
+
}, interval);
|
|
91
|
+
return () => {
|
|
92
|
+
cancelledRef.current = true;
|
|
93
|
+
clearInterval(timer);
|
|
94
|
+
};
|
|
95
|
+
}, [sessionId, fetchOnce, options.pollIntervalMs]);
|
|
96
|
+
return { session, loading, error, refresh: fetchOnce };
|
|
97
|
+
}
|
|
98
|
+
function useStrimzCheckout(options = {}) {
|
|
99
|
+
const { checkoutOrigin } = useStrimzContext();
|
|
100
|
+
const [status, setStatus] = React2__namespace.useState("idle");
|
|
101
|
+
const popupRef = React2__namespace.useRef(null);
|
|
102
|
+
const optsRef = React2__namespace.useRef(options);
|
|
103
|
+
optsRef.current = options;
|
|
104
|
+
const close = React2__namespace.useCallback(() => {
|
|
105
|
+
if (popupRef.current && !popupRef.current.closed) {
|
|
106
|
+
popupRef.current.close();
|
|
107
|
+
}
|
|
108
|
+
popupRef.current = null;
|
|
109
|
+
}, []);
|
|
110
|
+
React2__namespace.useEffect(() => {
|
|
111
|
+
function onMessage(ev) {
|
|
112
|
+
if (ev.origin !== checkoutOrigin) return;
|
|
113
|
+
const data = ev.data;
|
|
114
|
+
if (!data || typeof data.type !== "string" || !data.type.startsWith("strimz:checkout:"))
|
|
115
|
+
return;
|
|
116
|
+
switch (data.type) {
|
|
117
|
+
case "strimz:checkout:success":
|
|
118
|
+
setStatus("success");
|
|
119
|
+
optsRef.current.onSuccess?.(data.txHash);
|
|
120
|
+
close();
|
|
121
|
+
break;
|
|
122
|
+
case "strimz:checkout:cancel":
|
|
123
|
+
setStatus("cancelled");
|
|
124
|
+
optsRef.current.onCancel?.();
|
|
125
|
+
close();
|
|
126
|
+
break;
|
|
127
|
+
case "strimz:checkout:error":
|
|
128
|
+
setStatus("error");
|
|
129
|
+
optsRef.current.onError?.(new Error(data.message ?? "Checkout error"));
|
|
130
|
+
close();
|
|
131
|
+
break;
|
|
132
|
+
}
|
|
133
|
+
}
|
|
134
|
+
window.addEventListener("message", onMessage);
|
|
135
|
+
return () => window.removeEventListener("message", onMessage);
|
|
136
|
+
}, [checkoutOrigin, close]);
|
|
137
|
+
const open = React2__namespace.useCallback(
|
|
138
|
+
(sessionId) => {
|
|
139
|
+
const url = `${checkoutOrigin}/${encodeURIComponent(sessionId)}`;
|
|
140
|
+
const mode = optsRef.current.mode ?? "popup";
|
|
141
|
+
if (mode === "redirect") {
|
|
142
|
+
window.location.assign(url);
|
|
143
|
+
return;
|
|
144
|
+
}
|
|
145
|
+
const w = window.open(url, "strimz-checkout", "width=480,height=720");
|
|
146
|
+
popupRef.current = w;
|
|
147
|
+
setStatus("open");
|
|
148
|
+
const closeWatch = setInterval(() => {
|
|
149
|
+
if (!w || w.closed) {
|
|
150
|
+
clearInterval(closeWatch);
|
|
151
|
+
if (popupRef.current === w) {
|
|
152
|
+
setStatus((prev) => prev === "open" ? "cancelled" : prev);
|
|
153
|
+
popupRef.current = null;
|
|
154
|
+
if (status === "open") optsRef.current.onCancel?.();
|
|
155
|
+
}
|
|
156
|
+
}
|
|
157
|
+
}, 500);
|
|
158
|
+
},
|
|
159
|
+
[checkoutOrigin, status]
|
|
160
|
+
);
|
|
161
|
+
return { open, close, status };
|
|
162
|
+
}
|
|
163
|
+
var StrimzPayButton = React2__namespace.forwardRef(
|
|
164
|
+
function StrimzPayButton2({
|
|
165
|
+
sessionId,
|
|
166
|
+
mode = "popup",
|
|
167
|
+
theme = "auto",
|
|
168
|
+
size = "md",
|
|
169
|
+
onSuccess,
|
|
170
|
+
onCancel,
|
|
171
|
+
onError,
|
|
172
|
+
label,
|
|
173
|
+
onClick,
|
|
174
|
+
style,
|
|
175
|
+
...rest
|
|
176
|
+
}, ref) {
|
|
177
|
+
const checkout = useStrimzCheckout({ mode, onSuccess, onCancel, onError });
|
|
178
|
+
const handleClick = (ev) => {
|
|
179
|
+
onClick?.(ev);
|
|
180
|
+
if (ev.defaultPrevented || !sessionId) return;
|
|
181
|
+
checkout.open(sessionId);
|
|
182
|
+
};
|
|
183
|
+
return /* @__PURE__ */ jsxRuntime.jsx(
|
|
184
|
+
"button",
|
|
185
|
+
{
|
|
186
|
+
ref,
|
|
187
|
+
type: "button",
|
|
188
|
+
onClick: handleClick,
|
|
189
|
+
style: { ...buttonStyle({ theme, size }), ...style ?? {} },
|
|
190
|
+
"data-strimz-pay-button": true,
|
|
191
|
+
"data-status": checkout.status,
|
|
192
|
+
...rest,
|
|
193
|
+
children: label ?? defaultLabel
|
|
194
|
+
}
|
|
195
|
+
);
|
|
196
|
+
}
|
|
197
|
+
);
|
|
198
|
+
var defaultLabel = /* @__PURE__ */ jsxRuntime.jsxs("span", { style: { display: "inline-flex", alignItems: "center", gap: 8 }, children: [
|
|
199
|
+
/* @__PURE__ */ jsxRuntime.jsx(StrimzMark, { size: 16 }),
|
|
200
|
+
"Pay with Strimz"
|
|
201
|
+
] });
|
|
202
|
+
function StrimzMark({ size }) {
|
|
203
|
+
return /* @__PURE__ */ jsxRuntime.jsxs(
|
|
204
|
+
"svg",
|
|
205
|
+
{
|
|
206
|
+
width: size,
|
|
207
|
+
height: size,
|
|
208
|
+
viewBox: "0 0 16 16",
|
|
209
|
+
role: "img",
|
|
210
|
+
"aria-label": "Strimz",
|
|
211
|
+
xmlns: "http://www.w3.org/2000/svg",
|
|
212
|
+
children: [
|
|
213
|
+
/* @__PURE__ */ jsxRuntime.jsx("circle", { cx: "8", cy: "8", r: "8", fill: "#02C76A" }),
|
|
214
|
+
/* @__PURE__ */ jsxRuntime.jsx("path", { d: "M5 9h6M5 7h6", stroke: "white", strokeWidth: "1.6", strokeLinecap: "round" })
|
|
215
|
+
]
|
|
216
|
+
}
|
|
217
|
+
);
|
|
218
|
+
}
|
|
219
|
+
function buttonStyle({ theme, size }) {
|
|
220
|
+
const dimensions = sizeMap[size];
|
|
221
|
+
const palette = paletteFor(theme);
|
|
222
|
+
return {
|
|
223
|
+
appearance: "none",
|
|
224
|
+
border: "none",
|
|
225
|
+
cursor: "pointer",
|
|
226
|
+
fontFamily: 'ui-sans-serif, system-ui, -apple-system, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif',
|
|
227
|
+
fontWeight: 600,
|
|
228
|
+
background: palette.background,
|
|
229
|
+
color: palette.foreground,
|
|
230
|
+
borderRadius: 10,
|
|
231
|
+
paddingInline: dimensions.padX,
|
|
232
|
+
paddingBlock: dimensions.padY,
|
|
233
|
+
fontSize: dimensions.font,
|
|
234
|
+
lineHeight: 1.2,
|
|
235
|
+
transition: "background-color 120ms ease, transform 80ms ease",
|
|
236
|
+
boxShadow: "0 1px 2px rgba(0,0,0,0.06)"
|
|
237
|
+
};
|
|
238
|
+
}
|
|
239
|
+
var sizeMap = {
|
|
240
|
+
sm: { padX: 12, padY: 6, font: 13 },
|
|
241
|
+
md: { padX: 16, padY: 10, font: 15 },
|
|
242
|
+
lg: { padX: 20, padY: 14, font: 17 }
|
|
243
|
+
};
|
|
244
|
+
function paletteFor(theme) {
|
|
245
|
+
if (theme === "light") return { background: "#02C76A", foreground: "#FFFFFF" };
|
|
246
|
+
if (theme === "dark") return { background: "#02C76A", foreground: "#FFFFFF" };
|
|
247
|
+
return { background: "#02C76A", foreground: "#FFFFFF" };
|
|
248
|
+
}
|
|
249
|
+
function StrimzCheckoutEmbed({
|
|
250
|
+
sessionId,
|
|
251
|
+
onSuccess,
|
|
252
|
+
onCancel,
|
|
253
|
+
onError,
|
|
254
|
+
className,
|
|
255
|
+
style,
|
|
256
|
+
height = 600
|
|
257
|
+
}) {
|
|
258
|
+
const { checkoutOrigin } = useStrimzContext();
|
|
259
|
+
const handlersRef = React2__namespace.useRef({ onSuccess, onCancel, onError });
|
|
260
|
+
handlersRef.current = { onSuccess, onCancel, onError };
|
|
261
|
+
React2__namespace.useEffect(() => {
|
|
262
|
+
function onMessage(ev) {
|
|
263
|
+
if (ev.origin !== checkoutOrigin) return;
|
|
264
|
+
const data = ev.data;
|
|
265
|
+
if (!data || typeof data.type !== "string") return;
|
|
266
|
+
switch (data.type) {
|
|
267
|
+
case "strimz:checkout:success":
|
|
268
|
+
handlersRef.current.onSuccess?.(data.txHash);
|
|
269
|
+
break;
|
|
270
|
+
case "strimz:checkout:cancel":
|
|
271
|
+
handlersRef.current.onCancel?.();
|
|
272
|
+
break;
|
|
273
|
+
case "strimz:checkout:error":
|
|
274
|
+
handlersRef.current.onError?.(new Error(data.message ?? "Checkout error"));
|
|
275
|
+
break;
|
|
276
|
+
}
|
|
277
|
+
}
|
|
278
|
+
window.addEventListener("message", onMessage);
|
|
279
|
+
return () => window.removeEventListener("message", onMessage);
|
|
280
|
+
}, [checkoutOrigin]);
|
|
281
|
+
const src = `${checkoutOrigin}/${encodeURIComponent(sessionId)}?embed=1`;
|
|
282
|
+
return /* @__PURE__ */ jsxRuntime.jsx("div", { className, style: { width: "100%", ...style ?? {} }, children: /* @__PURE__ */ jsxRuntime.jsx(
|
|
283
|
+
"iframe",
|
|
284
|
+
{
|
|
285
|
+
src,
|
|
286
|
+
title: "Strimz checkout",
|
|
287
|
+
allow: "payment *; clipboard-write *",
|
|
288
|
+
style: { width: "100%", height, border: 0 },
|
|
289
|
+
"data-strimz-checkout-embed": true
|
|
290
|
+
}
|
|
291
|
+
) });
|
|
292
|
+
}
|
|
293
|
+
|
|
294
|
+
exports.StrimzCheckoutEmbed = StrimzCheckoutEmbed;
|
|
295
|
+
exports.StrimzPayButton = StrimzPayButton;
|
|
296
|
+
exports.StrimzProvider = StrimzProvider;
|
|
297
|
+
exports.useStrimzCheckout = useStrimzCheckout;
|
|
298
|
+
exports.useStrimzClient = useStrimzClient;
|
|
299
|
+
exports.useStrimzContext = useStrimzContext;
|
|
300
|
+
exports.useStrimzSession = useStrimzSession;
|
|
301
|
+
//# sourceMappingURL=index.cjs.map
|
|
302
|
+
//# sourceMappingURL=index.cjs.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"sources":["../src/provider.tsx","../src/hooks/useStrimzClient.ts","../src/hooks/useStrimzSession.ts","../src/hooks/useStrimzCheckout.ts","../src/components/StrimzPayButton.tsx","../src/components/StrimzCheckoutEmbed.tsx"],"names":["React","StrimzBrowserClient","jsx","React2","React3","React4","StrimzPayButton","jsxs","React5"],"mappings":"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","file":"index.cjs","sourcesContent":["'use client'\n\nimport * as React from 'react'\nimport { StrimzBrowserClient } from '@strimz/sdk/browser'\n\nexport interface StrimzContextValue {\n client: StrimzBrowserClient\n /** Public origin where Strimz hosts its checkout UI. */\n checkoutOrigin: string\n}\n\nconst StrimzContext = React.createContext<StrimzContextValue | null>(null)\n\nexport interface StrimzProviderProps {\n /** Publishable key, e.g. process.env.NEXT_PUBLIC_STRIMZ_PUBLISHABLE_KEY. */\n publishableKey: string\n /** Override the API base URL. */\n apiBaseUrl?: string\n /** Override the hosted-checkout origin. Defaults to https://checkout.strimz.io. */\n checkoutOrigin?: string\n children: React.ReactNode\n}\n\n/**\n * Wrap any tree that uses Strimz components or hooks.\n * Builds a memoised `StrimzBrowserClient` and a checkout origin.\n */\nexport function StrimzProvider({\n publishableKey,\n apiBaseUrl,\n checkoutOrigin = 'https://checkout.strimz.io',\n children,\n}: StrimzProviderProps) {\n const value = React.useMemo<StrimzContextValue>(\n () => ({\n client: new StrimzBrowserClient({ publishableKey, baseUrl: apiBaseUrl }),\n checkoutOrigin,\n }),\n [publishableKey, apiBaseUrl, checkoutOrigin],\n )\n return <StrimzContext.Provider value={value}>{children}</StrimzContext.Provider>\n}\n\nexport function useStrimzContext(): StrimzContextValue {\n const ctx = React.useContext(StrimzContext)\n if (!ctx) {\n throw new Error('useStrimzContext / Strimz components must be used inside a <StrimzProvider/>.')\n }\n return ctx\n}\n","'use client'\n\nimport type { StrimzBrowserClient } from '@strimz/sdk/browser'\nimport { useStrimzContext } from '../provider.js'\n\n/** Read the singleton browser client out of context. */\nexport function useStrimzClient(): StrimzBrowserClient {\n return useStrimzContext().client\n}\n","'use client'\n\nimport * as React from 'react'\nimport type { PaymentSession } from '@strimz/shared-types'\nimport { useStrimzClient } from './useStrimzClient.js'\n\nexport interface UseStrimzSessionResult {\n session: PaymentSession | null\n loading: boolean\n error: Error | null\n refresh: () => Promise<void>\n}\n\nexport interface UseStrimzSessionOptions {\n /** Poll interval in milliseconds while the session is in a non-terminal state. */\n pollIntervalMs?: number\n}\n\nconst TERMINAL_STATES: ReadonlyArray<PaymentSession['status']> = [\n 'confirmed',\n 'failed',\n 'expired',\n 'cancelled',\n]\n\n/**\n * Subscribe to a Strimz payment session. Polls until the session reaches\n * a terminal state, then stops.\n */\nexport function useStrimzSession(\n sessionId: string | null | undefined,\n options: UseStrimzSessionOptions = {},\n): UseStrimzSessionResult {\n const client = useStrimzClient()\n const [session, setSession] = React.useState<PaymentSession | null>(null)\n const [loading, setLoading] = React.useState<boolean>(false)\n const [error, setError] = React.useState<Error | null>(null)\n const cancelledRef = React.useRef(false)\n\n const fetchOnce = React.useCallback(async () => {\n if (!sessionId) return\n setLoading(true)\n try {\n // Browser checkout reads go through the public /v1/checkout/* namespace\n // — paymentSessions.retrieve required a secret key and is no longer on\n // the BrowserClient. See packages/sdk/src/resources/checkout.ts.\n const next = await client.checkout.session(sessionId)\n if (!cancelledRef.current) {\n setSession(next)\n setError(null)\n }\n } catch (err) {\n if (!cancelledRef.current) setError(err as Error)\n } finally {\n if (!cancelledRef.current) setLoading(false)\n }\n }, [client, sessionId])\n\n React.useEffect(() => {\n cancelledRef.current = false\n if (!sessionId) return\n\n void fetchOnce()\n const interval = options.pollIntervalMs ?? 3_000\n const timer = setInterval(() => {\n if (session && TERMINAL_STATES.includes(session.status)) return\n void fetchOnce()\n }, interval)\n\n return () => {\n cancelledRef.current = true\n clearInterval(timer)\n }\n // session is intentionally not in deps — interval reads the latest via closure\n // eslint-disable-next-line react-hooks/exhaustive-deps\n }, [sessionId, fetchOnce, options.pollIntervalMs])\n\n return { session, loading, error, refresh: fetchOnce }\n}\n","'use client'\n\nimport * as React from 'react'\nimport { useStrimzContext } from '../provider.js'\n\nexport type CheckoutMode = 'redirect' | 'popup'\n\nexport interface UseStrimzCheckoutOptions {\n /** How to open the hosted checkout. Default `popup`. */\n mode?: CheckoutMode\n /** Called when the checkout reports a successful payment. */\n onSuccess?: (txHash?: string) => void\n /** Called when the payer closes the checkout without completing. */\n onCancel?: () => void\n /** Called on any error reported by the checkout. */\n onError?: (error: Error) => void\n}\n\nexport interface UseStrimzCheckoutResult {\n open: (sessionId: string) => void\n close: () => void\n status: 'idle' | 'open' | 'success' | 'cancelled' | 'error'\n}\n\n/**\n * Imperative checkout opener. Lower-level than `<StrimzPayButton/>`.\n *\n * const checkout = useStrimzCheckout({ onSuccess: ... })\n * <button onClick={() => checkout.open(sessionId)}>Pay</button>\n */\nexport function useStrimzCheckout(options: UseStrimzCheckoutOptions = {}): UseStrimzCheckoutResult {\n const { checkoutOrigin } = useStrimzContext()\n const [status, setStatus] = React.useState<UseStrimzCheckoutResult['status']>('idle')\n const popupRef = React.useRef<Window | null>(null)\n const optsRef = React.useRef(options)\n optsRef.current = options\n\n const close = React.useCallback(() => {\n if (popupRef.current && !popupRef.current.closed) {\n popupRef.current.close()\n }\n popupRef.current = null\n }, [])\n\n React.useEffect(() => {\n function onMessage(ev: MessageEvent) {\n if (ev.origin !== checkoutOrigin) return\n const data = ev.data as { type?: string; txHash?: string; message?: string }\n if (!data || typeof data.type !== 'string' || !data.type.startsWith('strimz:checkout:'))\n return\n\n switch (data.type) {\n case 'strimz:checkout:success':\n setStatus('success')\n optsRef.current.onSuccess?.(data.txHash)\n close()\n break\n case 'strimz:checkout:cancel':\n setStatus('cancelled')\n optsRef.current.onCancel?.()\n close()\n break\n case 'strimz:checkout:error':\n setStatus('error')\n optsRef.current.onError?.(new Error(data.message ?? 'Checkout error'))\n close()\n break\n }\n }\n window.addEventListener('message', onMessage)\n return () => window.removeEventListener('message', onMessage)\n }, [checkoutOrigin, close])\n\n const open = React.useCallback(\n (sessionId: string) => {\n const url = `${checkoutOrigin}/${encodeURIComponent(sessionId)}`\n const mode = optsRef.current.mode ?? 'popup'\n if (mode === 'redirect') {\n window.location.assign(url)\n return\n }\n const w = window.open(url, 'strimz-checkout', 'width=480,height=720')\n popupRef.current = w\n setStatus('open')\n // Detect manual close.\n const closeWatch = setInterval(() => {\n if (!w || w.closed) {\n clearInterval(closeWatch)\n if (popupRef.current === w) {\n // Only treat as cancel if we haven't already transitioned out of `open`.\n setStatus((prev) => (prev === 'open' ? 'cancelled' : prev))\n popupRef.current = null\n if (status === 'open') optsRef.current.onCancel?.()\n }\n }\n }, 500)\n },\n [checkoutOrigin, status],\n )\n\n return { open, close, status }\n}\n","'use client'\n\nimport * as React from 'react'\nimport { useStrimzCheckout, type CheckoutMode } from '../hooks/useStrimzCheckout.js'\n\nexport type StrimzPayButtonTheme = 'auto' | 'light' | 'dark'\nexport type StrimzPayButtonSize = 'sm' | 'md' | 'lg'\n\nexport interface StrimzPayButtonProps extends Omit<\n React.ButtonHTMLAttributes<HTMLButtonElement>,\n 'onError'\n> {\n /** Strimz session id created via `@strimz/sdk` on your backend. */\n sessionId: string\n /** Hosted checkout open mode. Default `popup`. */\n mode?: CheckoutMode\n /** Visual theme. `auto` follows the user's `prefers-color-scheme`. */\n theme?: StrimzPayButtonTheme\n /** Button size token. Default `md`. */\n size?: StrimzPayButtonSize\n /** Called on a successful payment with the on-chain transaction hash. */\n onSuccess?: (txHash?: string) => void\n /** Called when the payer closes the checkout without completing. */\n onCancel?: () => void\n /** Called when the checkout reports an error. */\n onError?: (error: Error) => void\n /** Override the button label. Default \"Pay with Strimz\". */\n label?: React.ReactNode\n}\n\n/**\n * Drop-in pay button. Opens Strimz hosted checkout in a popup or redirect.\n *\n * <StrimzPayButton sessionId={sess.id} onSuccess={(tx) => router.push('/done')} />\n */\nexport const StrimzPayButton = React.forwardRef<HTMLButtonElement, StrimzPayButtonProps>(\n function StrimzPayButton(\n {\n sessionId,\n mode = 'popup',\n theme = 'auto',\n size = 'md',\n onSuccess,\n onCancel,\n onError,\n label,\n onClick,\n style,\n ...rest\n },\n ref,\n ) {\n const checkout = useStrimzCheckout({ mode, onSuccess, onCancel, onError })\n\n const handleClick = (ev: React.MouseEvent<HTMLButtonElement>) => {\n onClick?.(ev)\n if (ev.defaultPrevented || !sessionId) return\n checkout.open(sessionId)\n }\n\n return (\n <button\n ref={ref}\n type=\"button\"\n onClick={handleClick}\n style={{ ...buttonStyle({ theme, size }), ...(style ?? {}) }}\n data-strimz-pay-button\n data-status={checkout.status}\n {...rest}\n >\n {label ?? defaultLabel}\n </button>\n )\n },\n)\n\nconst defaultLabel = (\n <span style={{ display: 'inline-flex', alignItems: 'center', gap: 8 }}>\n <StrimzMark size={16} />\n Pay with Strimz\n </span>\n)\n\nfunction StrimzMark({ size }: { size: number }) {\n // Inline SVG keeps the bundle dependency-free.\n return (\n <svg\n width={size}\n height={size}\n viewBox=\"0 0 16 16\"\n role=\"img\"\n aria-label=\"Strimz\"\n xmlns=\"http://www.w3.org/2000/svg\"\n >\n <circle cx=\"8\" cy=\"8\" r=\"8\" fill=\"#02C76A\" />\n <path d=\"M5 9h6M5 7h6\" stroke=\"white\" strokeWidth=\"1.6\" strokeLinecap=\"round\" />\n </svg>\n )\n}\n\ninterface StyleParams {\n theme: StrimzPayButtonTheme\n size: StrimzPayButtonSize\n}\n\nfunction buttonStyle({ theme, size }: StyleParams): React.CSSProperties {\n const dimensions = sizeMap[size]\n const palette = paletteFor(theme)\n return {\n appearance: 'none',\n border: 'none',\n cursor: 'pointer',\n fontFamily:\n 'ui-sans-serif, system-ui, -apple-system, \"Segoe UI\", Roboto, \"Helvetica Neue\", Arial, sans-serif',\n fontWeight: 600,\n background: palette.background,\n color: palette.foreground,\n borderRadius: 10,\n paddingInline: dimensions.padX,\n paddingBlock: dimensions.padY,\n fontSize: dimensions.font,\n lineHeight: 1.2,\n transition: 'background-color 120ms ease, transform 80ms ease',\n boxShadow: '0 1px 2px rgba(0,0,0,0.06)',\n }\n}\n\nconst sizeMap: Record<StrimzPayButtonSize, { padX: number; padY: number; font: number }> = {\n sm: { padX: 12, padY: 6, font: 13 },\n md: { padX: 16, padY: 10, font: 15 },\n lg: { padX: 20, padY: 14, font: 17 },\n}\n\nfunction paletteFor(theme: StrimzPayButtonTheme): { background: string; foreground: string } {\n if (theme === 'light') return { background: '#02C76A', foreground: '#FFFFFF' }\n if (theme === 'dark') return { background: '#02C76A', foreground: '#FFFFFF' }\n // auto — same brand for both modes; the surrounding app's theme handles context\n return { background: '#02C76A', foreground: '#FFFFFF' }\n}\n","'use client'\n\nimport * as React from 'react'\nimport { useStrimzContext } from '../provider.js'\n\nexport interface StrimzCheckoutEmbedProps {\n /** Strimz session id created via `@strimz/sdk` on your backend. */\n sessionId: string\n /** Called on a successful payment with the on-chain transaction hash. */\n onSuccess?: (txHash?: string) => void\n /** Called when the payer cancels. */\n onCancel?: () => void\n /** Called when the checkout reports an error. */\n onError?: (error: Error) => void\n /** Optional className to size / style the iframe wrapper. */\n className?: string\n /** Optional inline style for the iframe wrapper. */\n style?: React.CSSProperties\n /** Iframe height. Default 600. */\n height?: number | string\n}\n\n/**\n * Embeds Strimz hosted checkout inside the merchant's page in an iframe.\n *\n * The iframe communicates back via `postMessage`. All messages are filtered\n * by the configured `checkoutOrigin` so a malicious page on a different\n * origin cannot spoof success.\n */\nexport function StrimzCheckoutEmbed({\n sessionId,\n onSuccess,\n onCancel,\n onError,\n className,\n style,\n height = 600,\n}: StrimzCheckoutEmbedProps) {\n const { checkoutOrigin } = useStrimzContext()\n const handlersRef = React.useRef({ onSuccess, onCancel, onError })\n handlersRef.current = { onSuccess, onCancel, onError }\n\n React.useEffect(() => {\n function onMessage(ev: MessageEvent) {\n if (ev.origin !== checkoutOrigin) return\n const data = ev.data as { type?: string; txHash?: string; message?: string }\n if (!data || typeof data.type !== 'string') return\n\n switch (data.type) {\n case 'strimz:checkout:success':\n handlersRef.current.onSuccess?.(data.txHash)\n break\n case 'strimz:checkout:cancel':\n handlersRef.current.onCancel?.()\n break\n case 'strimz:checkout:error':\n handlersRef.current.onError?.(new Error(data.message ?? 'Checkout error'))\n break\n }\n }\n window.addEventListener('message', onMessage)\n return () => window.removeEventListener('message', onMessage)\n }, [checkoutOrigin])\n\n const src = `${checkoutOrigin}/${encodeURIComponent(sessionId)}?embed=1`\n\n return (\n <div className={className} style={{ width: '100%', ...(style ?? {}) }}>\n <iframe\n src={src}\n title=\"Strimz checkout\"\n allow=\"payment *; clipboard-write *\"\n style={{ width: '100%', height, border: 0 }}\n data-strimz-checkout-embed\n />\n </div>\n )\n}\n"]}
|
package/dist/index.d.cts
ADDED
|
@@ -0,0 +1,122 @@
|
|
|
1
|
+
import * as react_jsx_runtime from 'react/jsx-runtime';
|
|
2
|
+
import * as React from 'react';
|
|
3
|
+
import { StrimzBrowserClient } from '@strimz/sdk/browser';
|
|
4
|
+
import { PaymentSession } from '@strimz/shared-types';
|
|
5
|
+
|
|
6
|
+
interface StrimzContextValue {
|
|
7
|
+
client: StrimzBrowserClient;
|
|
8
|
+
/** Public origin where Strimz hosts its checkout UI. */
|
|
9
|
+
checkoutOrigin: string;
|
|
10
|
+
}
|
|
11
|
+
interface StrimzProviderProps {
|
|
12
|
+
/** Publishable key, e.g. process.env.NEXT_PUBLIC_STRIMZ_PUBLISHABLE_KEY. */
|
|
13
|
+
publishableKey: string;
|
|
14
|
+
/** Override the API base URL. */
|
|
15
|
+
apiBaseUrl?: string;
|
|
16
|
+
/** Override the hosted-checkout origin. Defaults to https://checkout.strimz.io. */
|
|
17
|
+
checkoutOrigin?: string;
|
|
18
|
+
children: React.ReactNode;
|
|
19
|
+
}
|
|
20
|
+
/**
|
|
21
|
+
* Wrap any tree that uses Strimz components or hooks.
|
|
22
|
+
* Builds a memoised `StrimzBrowserClient` and a checkout origin.
|
|
23
|
+
*/
|
|
24
|
+
declare function StrimzProvider({ publishableKey, apiBaseUrl, checkoutOrigin, children, }: StrimzProviderProps): react_jsx_runtime.JSX.Element;
|
|
25
|
+
declare function useStrimzContext(): StrimzContextValue;
|
|
26
|
+
|
|
27
|
+
/** Read the singleton browser client out of context. */
|
|
28
|
+
declare function useStrimzClient(): StrimzBrowserClient;
|
|
29
|
+
|
|
30
|
+
interface UseStrimzSessionResult {
|
|
31
|
+
session: PaymentSession | null;
|
|
32
|
+
loading: boolean;
|
|
33
|
+
error: Error | null;
|
|
34
|
+
refresh: () => Promise<void>;
|
|
35
|
+
}
|
|
36
|
+
interface UseStrimzSessionOptions {
|
|
37
|
+
/** Poll interval in milliseconds while the session is in a non-terminal state. */
|
|
38
|
+
pollIntervalMs?: number;
|
|
39
|
+
}
|
|
40
|
+
/**
|
|
41
|
+
* Subscribe to a Strimz payment session. Polls until the session reaches
|
|
42
|
+
* a terminal state, then stops.
|
|
43
|
+
*/
|
|
44
|
+
declare function useStrimzSession(sessionId: string | null | undefined, options?: UseStrimzSessionOptions): UseStrimzSessionResult;
|
|
45
|
+
|
|
46
|
+
type CheckoutMode = 'redirect' | 'popup';
|
|
47
|
+
interface UseStrimzCheckoutOptions {
|
|
48
|
+
/** How to open the hosted checkout. Default `popup`. */
|
|
49
|
+
mode?: CheckoutMode;
|
|
50
|
+
/** Called when the checkout reports a successful payment. */
|
|
51
|
+
onSuccess?: (txHash?: string) => void;
|
|
52
|
+
/** Called when the payer closes the checkout without completing. */
|
|
53
|
+
onCancel?: () => void;
|
|
54
|
+
/** Called on any error reported by the checkout. */
|
|
55
|
+
onError?: (error: Error) => void;
|
|
56
|
+
}
|
|
57
|
+
interface UseStrimzCheckoutResult {
|
|
58
|
+
open: (sessionId: string) => void;
|
|
59
|
+
close: () => void;
|
|
60
|
+
status: 'idle' | 'open' | 'success' | 'cancelled' | 'error';
|
|
61
|
+
}
|
|
62
|
+
/**
|
|
63
|
+
* Imperative checkout opener. Lower-level than `<StrimzPayButton/>`.
|
|
64
|
+
*
|
|
65
|
+
* const checkout = useStrimzCheckout({ onSuccess: ... })
|
|
66
|
+
* <button onClick={() => checkout.open(sessionId)}>Pay</button>
|
|
67
|
+
*/
|
|
68
|
+
declare function useStrimzCheckout(options?: UseStrimzCheckoutOptions): UseStrimzCheckoutResult;
|
|
69
|
+
|
|
70
|
+
type StrimzPayButtonTheme = 'auto' | 'light' | 'dark';
|
|
71
|
+
type StrimzPayButtonSize = 'sm' | 'md' | 'lg';
|
|
72
|
+
interface StrimzPayButtonProps extends Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, 'onError'> {
|
|
73
|
+
/** Strimz session id created via `@strimz/sdk` on your backend. */
|
|
74
|
+
sessionId: string;
|
|
75
|
+
/** Hosted checkout open mode. Default `popup`. */
|
|
76
|
+
mode?: CheckoutMode;
|
|
77
|
+
/** Visual theme. `auto` follows the user's `prefers-color-scheme`. */
|
|
78
|
+
theme?: StrimzPayButtonTheme;
|
|
79
|
+
/** Button size token. Default `md`. */
|
|
80
|
+
size?: StrimzPayButtonSize;
|
|
81
|
+
/** Called on a successful payment with the on-chain transaction hash. */
|
|
82
|
+
onSuccess?: (txHash?: string) => void;
|
|
83
|
+
/** Called when the payer closes the checkout without completing. */
|
|
84
|
+
onCancel?: () => void;
|
|
85
|
+
/** Called when the checkout reports an error. */
|
|
86
|
+
onError?: (error: Error) => void;
|
|
87
|
+
/** Override the button label. Default "Pay with Strimz". */
|
|
88
|
+
label?: React.ReactNode;
|
|
89
|
+
}
|
|
90
|
+
/**
|
|
91
|
+
* Drop-in pay button. Opens Strimz hosted checkout in a popup or redirect.
|
|
92
|
+
*
|
|
93
|
+
* <StrimzPayButton sessionId={sess.id} onSuccess={(tx) => router.push('/done')} />
|
|
94
|
+
*/
|
|
95
|
+
declare const StrimzPayButton: React.ForwardRefExoticComponent<StrimzPayButtonProps & React.RefAttributes<HTMLButtonElement>>;
|
|
96
|
+
|
|
97
|
+
interface StrimzCheckoutEmbedProps {
|
|
98
|
+
/** Strimz session id created via `@strimz/sdk` on your backend. */
|
|
99
|
+
sessionId: string;
|
|
100
|
+
/** Called on a successful payment with the on-chain transaction hash. */
|
|
101
|
+
onSuccess?: (txHash?: string) => void;
|
|
102
|
+
/** Called when the payer cancels. */
|
|
103
|
+
onCancel?: () => void;
|
|
104
|
+
/** Called when the checkout reports an error. */
|
|
105
|
+
onError?: (error: Error) => void;
|
|
106
|
+
/** Optional className to size / style the iframe wrapper. */
|
|
107
|
+
className?: string;
|
|
108
|
+
/** Optional inline style for the iframe wrapper. */
|
|
109
|
+
style?: React.CSSProperties;
|
|
110
|
+
/** Iframe height. Default 600. */
|
|
111
|
+
height?: number | string;
|
|
112
|
+
}
|
|
113
|
+
/**
|
|
114
|
+
* Embeds Strimz hosted checkout inside the merchant's page in an iframe.
|
|
115
|
+
*
|
|
116
|
+
* The iframe communicates back via `postMessage`. All messages are filtered
|
|
117
|
+
* by the configured `checkoutOrigin` so a malicious page on a different
|
|
118
|
+
* origin cannot spoof success.
|
|
119
|
+
*/
|
|
120
|
+
declare function StrimzCheckoutEmbed({ sessionId, onSuccess, onCancel, onError, className, style, height, }: StrimzCheckoutEmbedProps): react_jsx_runtime.JSX.Element;
|
|
121
|
+
|
|
122
|
+
export { type CheckoutMode, StrimzCheckoutEmbed, type StrimzCheckoutEmbedProps, type StrimzContextValue, StrimzPayButton, type StrimzPayButtonProps, type StrimzPayButtonSize, type StrimzPayButtonTheme, StrimzProvider, type StrimzProviderProps, type UseStrimzCheckoutOptions, type UseStrimzCheckoutResult, type UseStrimzSessionOptions, type UseStrimzSessionResult, useStrimzCheckout, useStrimzClient, useStrimzContext, useStrimzSession };
|