@supertokens/rownd-react 0.1.0-beta.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) Rownd, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,308 @@
+#### README's for [Next](https://github.com/rownd/react/tree/main/packages/next) and [Remix](https://github.com/rownd/react/tree/main/packages/remix).
+
+# React
+
+## Installation
+
+Simply run `npm install @rownd/react` or `yarn add @rownd/react`.
+
+## Usage
+
+### React
+
+The library provides a React provider and hook for the Rownd browser API.
+
+In your app's main entrypoint, add the Rownd provider, likely before other providers:
+
+```jsx
+import React from 'react',
+import ReactDOM from 'react-dom';
+import { RowndProvider } from '@rownd/react';
+import App from './App';
+
+ReactDOM.render(
+  <RowndProvider
+    appKey="<your app key>"
+  >
+    <App />
+  </RowndProvider>,
+  document.getElementById('root')
+);
+```
+
+{% hint style="warning" %}
+The Rownd React SDK automatically injects the Rownd Hub snippet into your React application, so you should _not_ manually include the Hub snippet in your HTML page. Doing so will produce unexpected results.
+{% endhint %}
+
+### RowndProvider props
+
+- `appKey` (required): This is the key generated by the [Rownd dashboard](https://app.rownd.io).
+- `postLoginRedirect` (optional): Where the browser should redirect the user after a successful sign-in. If not supplied, the user will remain on the same page.
+- `rootOrigin` (optional): If you're using Rownd across multiple domains (e.g., `rownd.io` and `app.rownd.io`), set this to the "root" _origin_ (e.g., https://rownd.io).
+
+### Provider props
+
+* `appKey` (required): This is the key generated by the [Rownd dashboard](https://app.rownd.io).
+* `postLoginRedirect` (optional): Where the browser should redirect the user after a successful sign-in. If not supplied, the user will remain on the same page.
+* `rootOrigin` (optional): If you're using Rownd across multiple domains (e.g., `rownd.io` and `app.rownd.io`), set this to the "root" _origin_ (e.g., https://rownd.io).
+
+Later on within your app's components, you can use the Rownd hook to access the Rownd browser API:
+
+```jsx
+import React from 'react';
+import { useRownd } from '@rownd/react';
+
+export default function MyProtectedComponent(props) {
+  const { is_authenticated, user, requestSignIn, is_initializing } = useRownd();
+
+  useEffect(() => {
+    if (!is_authenticated && !is_initializing) {
+      requestSignIn();
+    }
+  }, [is_authenticated, is_initializing]);
+
+  return (
+    <div>
+      {is_authenticated ? (
+        <div>
+          <h1>Welcome {user.data.first_name}</h1>
+          <h2>Email:{user.data.email}</h2>
+          <button onClick={() => getAccessToken()}>Get access token</button>
+        </div>
+      ) : (
+        <div>
+          <h1>Please sign in to continue</h1>
+        </div>
+      )}
+    </div>
+  );
+}
+```
+
+### Usage with redux, etc
+
+Often, sending and receiving data from your server will rely on the Rownd access token as a means of authenticating the user within your back-end (see our [Node.js SDK](node.js.md) as an example of this). Many React apps leverage Redux or similar technologies to manage an app's global state.
+
+The key here is to call Rownd's `getAccessToken({ waitForToken: true })` method when calling your own authenticated APIs. For example, if you're using [axios](https://npmjs.com/package/axios), you'd likely set up an interceptor that looks something like this:
+
+```javascript
+// api-client.js
+
+import axios from 'axios';
+
+let getAccessToken;
+
+axios.interceptors.request.use(async (config) => {
+  if (!getAccessToken) {
+    return config;
+  }
+
+  if (config.skipAuth || !config.url.startsWith('/api')) {
+    return config;
+  }
+
+  const accessToken = await getAccessToken({ waitForToken: true });
+
+  config.headers.common.Authorization = `Bearer ${accessToken}`;
+  return config;
+});
+
+export function setAccessTokenHelper(fn) {
+  getAccessToken = fn;
+}
+
+export default axios;
+```
+
+Here's another example, this time using [ky](https://npmjs.com/package/ky):
+
+```javascript
+// api-client.js
+
+import ky from 'ky';
+
+let getAccessToken;
+
+ky.extend({
+  hooks: {
+    beforeRequest: [
+      // Auto-refresh tokens
+      async (request) => {
+        if (!getAccessToken) {
+          return;
+        }
+
+        if (request.skipAuth || !request.url.startsWith('/api')) {
+          return;
+        }
+
+        const accessToken = await getAccessToken({ waitForToken: true });
+
+        request.headers.set(
+          'Authorization',
+          `Bearer ${tokenResp.access_token}`
+        );
+      },
+    ],
+  },
+});
+
+function setAccessTokenHelper(fn) {
+  getAccessToken = fn;
+}
+
+export { api, setAccessTokenHelper };
+```
+
+In both of the cases above, our async actions would use these instances of axios or ky to make requests back to the server, but before any of those fire, we need to set the access token helper from our React app like this:
+
+```javascript
+// AppWrapper.jsx
+
+import { useRownd } from '@rownd/react';
+import { setAccessTokenHelper } from './api-client';
+import App from './app';
+
+export default function MyReactAppWrapper() {
+  const { getAccessToken } = useRownd();
+
+  useEffect(() => {
+    setAccessTokenHelper(getAccessToken);
+  }, [getAccessToken]);
+
+  return <App />;
+}
+```
+
+That's one way to solve this problem. Another might be to wrap the redux provider in your own component and simply pass the `getAccessToken` function down into the store during initialization. If you come up with a better mousetrap here, let us know!
+
+## API reference
+
+Most API methods are made available via the Rownd Provider and its associated `useRownd` React hook. Unless otherwise noted, we're assuming that you're using hooks.
+
+#### requestSignIn()
+
+Trigger the Rownd sign in dialog
+
+```javascript
+const { requestSignIn } = useRownd();
+
+requestSignIn({
+  auto_sign_in: false, // optional
+  identifier: 'me@company.com' || '+19105551212', // optional
+});
+```
+
+- `auto_sign_in: boolean` - when `true`, automatically trigger a sign-in attempt _if_ `identifier` is included or an email address or phone number has already been set in the user data.
+- `identifier: string` - an email address or phone number (in E164 format) to which a verification message may be sent. If the Rownd app is configured to allow unverified users, then sign-in will complete without verification if the user has not signed in previously.
+
+#### signOut()
+
+Sign out the user and clear their profile, returning them to a completely unauthenticated state.
+
+```javascript
+const { signOut } = useRownd();
+signOut();
+```
+
+#### **getAccessToken()**
+
+Retrieves the active, valid access token for the current user.&#x20;
+
+```javascript
+const { getAccessToken } = useRownd();
+
+let accessToken = await getAccessToken({
+  waitForToken: false,
+});
+```
+
+- `waitForToken: boolean` - when `true`, if no access token is present or if it's expired, the promise will not resolve until a valid token is available. While unlikely, this could result in waiting forever.
+
+**is_initializing**
+
+`is_initializing` will be `true` until the Hub has fully loaded, recalled its state, and resolved the current user's authentication status. This usually takes only a few milliseconds, but if you make decisions that depend on the `is_authenticated` flag while `is_initializing` is still `true`, your code/logic may not work as you expect.
+
+```javascript
+const { is_initializing } = useRownd();
+
+if (is_initializing) {
+  // return loading state or null
+}
+```
+
+#### is_authenticated
+
+Indicates whether the current user is signed in or not.
+
+```javascript
+const { is_authenticated } = useRownd();
+
+return (
+  <>
+    {is_authenticated && <ProtectedRoute />}
+    {!is_authenticated && <PublicRoute />}
+  </>
+);
+```
+
+#### access_token
+
+Represents the current access token for the user.
+
+```javascript
+const { access_token } = useRownd();
+
+useEffect(() => {
+    axios({
+        method: 'post',
+        url: '/api/sessions'
+        headers: {
+            authorization: `Bearer ${access_token}`
+        }
+    }).then(console.log);
+}, [access_token]);
+```
+
+#### user
+
+Represents information about the current user, specifically their profile information. In the example below, we use the existing data to display the current value of `first_name` in a form field, update a local copy of that data as the user changes it, and then save the changes to Rownd once the user submits the form.
+
+```javascript
+const { user } = useRownd();
+
+const [profile, setProfile] = useState(user.data);
+
+return (
+  <form onSubmit={() => user.set(profile)}>
+    <label htmlFor="first_name">
+      <input
+        id="first_name"
+        type="text"
+        value={profile?.first_name}
+        onInput={(evt) =>
+          setProfile({ ...profile, first_name: evt.target.value })
+        }
+      />
+    </label>
+    <button type="submit">Save</button>
+  </form>
+);
+```
+
+**Merge data into the user profile**
+
+```javascript
+const { user } = useRownd();
+user.set({
+  first_name: 'Alice',
+  last_name: 'Ranier',
+});
+```
+
+Set a specific field in the user profile
+
+```javascript
+const { user } = useRownd();
+user.setValue('first_name', 'Alice');
+```

package/dist/components/RequireSignIn.d.ts

@@ -0,0 +1,11 @@
+import { default as React } from 'react';
+import { SignInProps } from '../context/types';
+
+interface RequireSignInProps {
+    children: any;
+    initializing?: React.ReactNode;
+    signInProps?: SignInProps;
+    disabled?: boolean;
+}
+declare const RequireSignIn: React.FC<RequireSignInProps>;
+export default RequireSignIn;

package/dist/components/RequireSignIn.js

@@ -0,0 +1,18 @@
+import e, { useEffect as a } from "react";
+import { useRownd as c } from "../context/RowndContext.js";
+import "../context/InternalProvider.js";
+const g = ({
+  children: o,
+  initializing: r,
+  signInProps: n,
+  disabled: u
+}) => {
+  const { is_authenticated: i, is_initializing: t, requestSignIn: m } = c();
+  return a(() => {
+    !i && !t && !u && m({ prevent_closing: !0, ...n });
+  }, [i, t, m, n, u]), t && r ? /* @__PURE__ */ e.createElement(e.Fragment, null, r) : /* @__PURE__ */ e.createElement(e.Fragment, null, o);
+};
+export {
+  g as default
+};
+//# sourceMappingURL=RequireSignIn.js.map

package/dist/components/RequireSignIn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RequireSignIn.js","sources":["../../src/components/RequireSignIn.tsx"],"sourcesContent":["import React, { useEffect } from 'react';\nimport { useRownd } from '../context';\nimport { SignInProps } from '../context/types';\n\ninterface RequireSignInProps {\n  children: any;\n  initializing?: React.ReactNode;\n  signInProps?: SignInProps;\n  disabled?: boolean;\n}\n\nconst RequireSignIn: React.FC<RequireSignInProps> = ({\n  children,\n  initializing,\n  signInProps,\n  disabled\n}) => {\n  const { is_authenticated, is_initializing, requestSignIn } = useRownd();\n\n  useEffect(() => {\n    if (!is_authenticated && !is_initializing && !disabled) {\n      requestSignIn({ prevent_closing: true, ...signInProps });\n    }\n  }, [is_authenticated, is_initializing, requestSignIn, signInProps, disabled]);\n\n  if (is_initializing && initializing) {\n    return <>{initializing}</>;\n  }\n\n  return <>{children}</>;\n};\n\nexport default RequireSignIn;\n"],"names":["RequireSignIn","children","initializing","signInProps","disabled","is_authenticated","is_initializing","requestSignIn","useRownd","useEffect"],"mappings":";;;AAWA,MAAMA,IAA8C,CAAC;AAAA,EACnD,UAAAC;AAAA,EACA,cAAAC;AAAA,EACA,aAAAC;AAAA,EACA,UAAAC;AACF,MAAM;AACJ,QAAM,EAAE,kBAAAC,GAAkB,iBAAAC,GAAiB,eAAAC,EAAA,IAAkBC,EAAA;AAQ7D,SANAC,EAAU,MAAM;AACd,IAAI,CAACJ,KAAoB,CAACC,KAAmB,CAACF,KAC5CG,EAAc,EAAE,iBAAiB,IAAM,GAAGJ,GAAa;AAAA,EAE3D,GAAG,CAACE,GAAkBC,GAAiBC,GAAeJ,GAAaC,CAAQ,CAAC,GAExEE,KAAmBJ,sDACXA,CAAa,sDAGfD,CAAS;AACrB;"}

package/dist/components/SignedIn.d.ts

@@ -0,0 +1,7 @@
+import { default as React } from 'react';
+
+interface SignedInProps {
+    children: React.ReactNode;
+}
+declare const SignedIn: React.FC<SignedInProps>;
+export default SignedIn;

package/dist/components/SignedIn.js

@@ -0,0 +1,11 @@
+import t from "react";
+import { useRownd as r } from "../context/RowndContext.js";
+import "../context/InternalProvider.js";
+const m = ({ children: e }) => {
+  const { is_authenticated: n } = r();
+  return n ? /* @__PURE__ */ t.createElement(t.Fragment, null, e) : null;
+};
+export {
+  m as default
+};
+//# sourceMappingURL=SignedIn.js.map

package/dist/components/SignedIn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SignedIn.js","sources":["../../src/components/SignedIn.tsx"],"sourcesContent":["import React from 'react';\nimport { useRownd } from '../context';\n\ninterface SignedInProps {\n  children: React.ReactNode;\n}\n\nconst SignedIn: React.FC<SignedInProps> = ({ children }) => {\n  const { is_authenticated } = useRownd();\n\n  if (!is_authenticated) {\n    return null;\n  }\n  return <>{children}</>;\n};\n\nexport default SignedIn;\n"],"names":["SignedIn","children","is_authenticated","useRownd"],"mappings":";;;AAOA,MAAMA,IAAoC,CAAC,EAAE,UAAAC,QAAe;AAC1D,QAAM,EAAE,kBAAAC,EAAA,IAAqBC,EAAA;AAE7B,SAAKD,sDAGKD,CAAS,IAFV;AAGX;"}

package/dist/components/SignedOut.d.ts

@@ -0,0 +1,7 @@
+import { default as React } from 'react';
+
+interface SignedOutProps {
+    children: React.ReactNode;
+}
+declare const SignedOut: React.FC<SignedOutProps>;
+export default SignedOut;

package/dist/components/SignedOut.js

@@ -0,0 +1,11 @@
+import t from "react";
+import { useRownd as n } from "../context/RowndContext.js";
+import "../context/InternalProvider.js";
+const i = ({ children: e }) => {
+  const { is_authenticated: r } = n();
+  return r ? null : /* @__PURE__ */ t.createElement(t.Fragment, null, e);
+};
+export {
+  i as default
+};
+//# sourceMappingURL=SignedOut.js.map

package/dist/components/SignedOut.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SignedOut.js","sources":["../../src/components/SignedOut.tsx"],"sourcesContent":["import React from 'react';\nimport { useRownd } from '../context';\n\ninterface SignedOutProps {\n  children: React.ReactNode;\n}\n\nconst SignedOut: React.FC<SignedOutProps> = ({ children }) => {\n  const { is_authenticated } = useRownd();\n\n  if (is_authenticated) {\n    return null;\n  }\n  return <>{children}</>;\n};\n\nexport default SignedOut;\n"],"names":["SignedOut","children","is_authenticated","useRownd"],"mappings":";;;AAOA,MAAMA,IAAsC,CAAC,EAAE,UAAAC,QAAe;AAC5D,QAAM,EAAE,kBAAAC,EAAA,IAAqBC,EAAA;AAE7B,SAAID,IACK,yDAECD,CAAS;AACrB;"}

package/dist/context/HubScriptInjector/HubScriptInjector.d.ts

@@ -0,0 +1,17 @@
+import { HubListenerProps, SuperTokensConfig } from '../RowndContext';
+
+declare global {
+    interface Window {
+        _rphConfig: any;
+    }
+}
+export type HubScriptInjectorProps = {
+    appKey: string;
+    stateListener: ({ state, api }: HubListenerProps) => void;
+    apiUrl?: string;
+    supertokens: SuperTokensConfig;
+    hubUrlOverride?: string;
+    locationHash?: string;
+    apiVersion?: string;
+};
+export default function HubScriptInjector({ appKey, apiUrl, supertokens, hubUrlOverride, stateListener, apiVersion, ...rest }: HubScriptInjectorProps): null;

package/dist/context/HubScriptInjector/HubScriptInjector.js

@@ -0,0 +1,34 @@
+import { useEffect as _ } from "react";
+function t(s, o) {
+  o && (window == null || window._rphConfig.push([s, o]));
+}
+const m = "2026-01-21";
+var h;
+const f = typeof window < "u" ? (h = window == null ? void 0 : window.location) == null ? void 0 : h.hash : void 0;
+function y({
+  appKey: s,
+  apiUrl: o,
+  supertokens: p,
+  hubUrlOverride: a,
+  stateListener: l,
+  apiVersion: u = m,
+  ...c
+}) {
+  return _(() => {
+    if (!window)
+      return;
+    const w = window._rphConfig = window._rphConfig || [], d = window.localStorage.getItem("rph_base_url_override") || a || "https://hub.rownd.io";
+    w.push(["setBaseUrl", d]), t("setAppKey", s), t("setStateListener", l), t("setLocationHash", f), t("setApiVersion", u), t("setSupertokens", p), t("setLegacyRowndApiUrl", o);
+    const n = document, r = n.createElement("script"), i = n.createElement("script"), e = n.getElementsByTagName("script")[0];
+    r.noModule = !0, r.async = !0, r.src = d + "/static/scripts/rph.js", i.type = "module", i.async = !0, i.src = d + "/static/scripts/rph.mjs", e != null && e.parentNode ? (e.parentNode.insertBefore(r, e), e.parentNode.insertBefore(i, e)) : (n.body.appendChild(r), n.body.appendChild(i)), window.localStorage.getItem("rph_log_level") === "debug" && console.debug("[debug] rest:", c), c && (Object.entries(c).forEach(([g, b]) => {
+      t(
+        `set${g.charAt(0).toUpperCase() + g.substring(1)}`,
+        b
+      );
+    }), window.localStorage.getItem("rph_log_level") === "debug" && console.debug("[debug] hubConfig:", window._rphConfig));
+  }, [s, o, p, l, f, a, u, c]), null;
+}
+export {
+  y as default
+};
+//# sourceMappingURL=HubScriptInjector.js.map

package/dist/context/HubScriptInjector/HubScriptInjector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HubScriptInjector.js","sources":["../../../src/context/HubScriptInjector/HubScriptInjector.tsx"],"sourcesContent":["import { useEffect } from 'react';\nimport { HubListenerProps, SuperTokensConfig } from '../RowndContext';\n\ndeclare global {\n  interface Window {\n    _rphConfig: any;\n  }\n}\n\nfunction setConfigValue(key: string, value: any) {\n  if (!value) {\n    return;\n  }\n\n  window?._rphConfig.push([key, value]);\n}\n\n/**\n * Default API version for new SDK releases.\n * This controls which Hub features are enabled by default.\n */\nconst DEFAULT_API_VERSION = '2026-01-21';\n\nexport type HubScriptInjectorProps = {\n  appKey: string;\n  stateListener: ({ state, api }: HubListenerProps) => void;\n  apiUrl?: string;\n  supertokens: SuperTokensConfig;\n  hubUrlOverride?: string;\n  locationHash?: string;\n  apiVersion?: string;\n};\n\n// Grab the URL hash ASAP in case it contains an `rph_init` param\nconst locationHash =\n  typeof window !== 'undefined' ? window?.location?.hash : void 0;\n\nexport default function HubScriptInjector({\n  appKey,\n  apiUrl,\n  supertokens,\n  hubUrlOverride,\n  stateListener,\n  apiVersion = DEFAULT_API_VERSION,\n  ...rest\n}: HubScriptInjectorProps) {\n\n  useEffect(() => {\n    if (!window) {\n      return; // compat with server-side rendering\n    }\n\n    const _rphConfig = (window._rphConfig = window._rphConfig || []);\n    const baseUrl =\n      window.localStorage.getItem('rph_base_url_override') ||\n      hubUrlOverride ||\n      'https://hub.rownd.io';\n    _rphConfig.push(['setBaseUrl', baseUrl]);\n\n    setConfigValue('setAppKey', appKey);\n    setConfigValue('setStateListener', stateListener);\n    setConfigValue('setLocationHash', locationHash);\n    setConfigValue('setApiVersion', apiVersion);\n    setConfigValue('setSupertokens', supertokens);\n    setConfigValue('setLegacyRowndApiUrl', apiUrl);\n\n    const d = document,\n      g = d.createElement('script'),\n      m = d.createElement('script'),\n      s = d.getElementsByTagName('script')[0];\n    g.noModule = true;\n    g.async = true;\n    g.src = baseUrl + '/static/scripts/rph.js';\n    m.type = 'module';\n    m.async = true;\n    m.src = baseUrl + '/static/scripts/rph.mjs';\n\n    if (s?.parentNode) {\n      s.parentNode.insertBefore(g, s);\n      s.parentNode.insertBefore(m, s);\n    } else {\n      d.body.appendChild(g);\n      d.body.appendChild(m);\n    }\n\n    if (window.localStorage.getItem('rph_log_level') === 'debug') {\n      console.debug('[debug] rest:', rest);\n    }\n\n    if (rest) {\n      Object.entries(rest).forEach(([key, value]) => {\n        setConfigValue(\n          `set${key.charAt(0).toUpperCase() + key.substring(1)}`,\n          value\n        );\n      });\n\n      if (window.localStorage.getItem('rph_log_level') === 'debug') {\n        console.debug('[debug] hubConfig:', window._rphConfig);\n      }\n    }\n  }, [appKey, apiUrl, supertokens, stateListener, locationHash, hubUrlOverride, apiVersion, rest]);\n\n  return null;\n}\n"],"names":["setConfigValue","key","value","DEFAULT_API_VERSION","locationHash","_a","HubScriptInjector","appKey","apiUrl","supertokens","hubUrlOverride","stateListener","apiVersion","rest","useEffect","_rphConfig","baseUrl","d","g","m","s"],"mappings":";AASA,SAASA,EAAeC,GAAaC,GAAY;AAC/C,EAAKA,MAIL,yBAAQ,WAAW,KAAK,CAACD,GAAKC,CAAK;AACrC;AAMA,MAAMC,IAAsB;;AAa5B,MAAMC,IACJ,OAAO,SAAW,OAAcC,IAAA,iCAAQ,aAAR,gBAAAA,EAAkB,OAAO;AAE3D,SAAwBC,EAAkB;AAAA,EACxC,QAAAC;AAAA,EACA,QAAAC;AAAA,EACA,aAAAC;AAAA,EACA,gBAAAC;AAAA,EACA,eAAAC;AAAA,EACA,YAAAC,IAAaT;AAAA,EACb,GAAGU;AACL,GAA2B;AAEzB,SAAAC,EAAU,MAAM;AACd,QAAI,CAAC;AACH;AAGF,UAAMC,IAAc,OAAO,aAAa,OAAO,cAAc,CAAA,GACvDC,IACJ,OAAO,aAAa,QAAQ,uBAAuB,KACnDN,KACA;AACF,IAAAK,EAAW,KAAK,CAAC,cAAcC,CAAO,CAAC,GAEvChB,EAAe,aAAaO,CAAM,GAClCP,EAAe,oBAAoBW,CAAa,GAChDX,EAAe,mBAAmBI,CAAY,GAC9CJ,EAAe,iBAAiBY,CAAU,GAC1CZ,EAAe,kBAAkBS,CAAW,GAC5CT,EAAe,wBAAwBQ,CAAM;AAE7C,UAAMS,IAAI,UACRC,IAAID,EAAE,cAAc,QAAQ,GAC5BE,IAAIF,EAAE,cAAc,QAAQ,GAC5BG,IAAIH,EAAE,qBAAqB,QAAQ,EAAE,CAAC;AACxC,IAAAC,EAAE,WAAW,IACbA,EAAE,QAAQ,IACVA,EAAE,MAAMF,IAAU,0BAClBG,EAAE,OAAO,UACTA,EAAE,QAAQ,IACVA,EAAE,MAAMH,IAAU,2BAEdI,KAAA,QAAAA,EAAG,cACLA,EAAE,WAAW,aAAaF,GAAGE,CAAC,GAC9BA,EAAE,WAAW,aAAaD,GAAGC,CAAC,MAE9BH,EAAE,KAAK,YAAYC,CAAC,GACpBD,EAAE,KAAK,YAAYE,CAAC,IAGlB,OAAO,aAAa,QAAQ,eAAe,MAAM,WACnD,QAAQ,MAAM,iBAAiBN,CAAI,GAGjCA,MACF,OAAO,QAAQA,CAAI,EAAE,QAAQ,CAAC,CAACZ,GAAKC,CAAK,MAAM;AAC7C,MAAAF;AAAA,QACE,MAAMC,EAAI,OAAO,CAAC,EAAE,gBAAgBA,EAAI,UAAU,CAAC,CAAC;AAAA,QACpDC;AAAA,MAAA;AAAA,IAEJ,CAAC,GAEG,OAAO,aAAa,QAAQ,eAAe,MAAM,WACnD,QAAQ,MAAM,sBAAsB,OAAO,UAAU;AAAA,EAG3D,GAAG,CAACK,GAAQC,GAAQC,GAAaE,GAAeP,GAAcM,GAAgBE,GAAYC,CAAI,CAAC,GAExF;AACT;"}

package/dist/context/HubScriptInjector/InternalProviderHubScriptInjector.d.ts

@@ -0,0 +1,3 @@
+import { default as React } from 'react';
+
+export default function InternalProviderHubScriptInjector(): React.JSX.Element;

package/dist/context/HubScriptInjector/InternalProviderHubScriptInjector.js

@@ -0,0 +1,19 @@
+import o from "react";
+import { useInternalRownd as i } from "../InternalProvider.js";
+import a from "./HubScriptInjector.js";
+function u() {
+  const { appKey: r, hubUrlOverride: e, stateListener: t, ...n } = i();
+  return /* @__PURE__ */ o.createElement(
+    a,
+    {
+      appKey: r,
+      hubUrlOverride: e,
+      stateListener: t,
+      ...n
+    }
+  );
+}
+export {
+  u as default
+};
+//# sourceMappingURL=InternalProviderHubScriptInjector.js.map

package/dist/context/HubScriptInjector/InternalProviderHubScriptInjector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"InternalProviderHubScriptInjector.js","sources":["../../../src/context/HubScriptInjector/InternalProviderHubScriptInjector.tsx"],"sourcesContent":["import React from 'react';\nimport { useInternalRownd } from '../InternalProvider';\nimport HubScriptInjector from './HubScriptInjector';\n\nexport default function InternalProviderHubScriptInjector() {\n  const { appKey, hubUrlOverride, stateListener, ...rest } = useInternalRownd();\n\n  return (\n    <HubScriptInjector\n      appKey={appKey}\n      hubUrlOverride={hubUrlOverride}\n      stateListener={stateListener}\n      {...rest}\n    />\n  );\n}\n"],"names":["InternalProviderHubScriptInjector","appKey","hubUrlOverride","stateListener","rest","useInternalRownd","React","HubScriptInjector"],"mappings":";;;AAIA,SAAwBA,IAAoC;AAC1D,QAAM,EAAE,QAAAC,GAAQ,gBAAAC,GAAgB,eAAAC,GAAe,GAAGC,EAAA,IAASC,EAAA;AAE3D,SACE,gBAAAC,EAAA;AAAA,IAACC;AAAA,IAAA;AAAA,MACC,QAAAN;AAAA,MACA,gBAAAC;AAAA,MACA,eAAAC;AAAA,MACC,GAAGC;AAAA,IAAA;AAAA,EAAA;AAGV;"}

package/dist/context/InternalProvider.d.ts

@@ -0,0 +1,9 @@
+import { default as React } from 'react';
+import { HubScriptInjectorProps } from './HubScriptInjector/HubScriptInjector';
+
+type InternalRowndProvider = HubScriptInjectorProps & {
+    children: React.ReactNode;
+};
+export declare const InternalRowndProvider: ({ children, ...rest }: InternalRowndProvider) => React.JSX.Element;
+export declare function useInternalRownd(): HubScriptInjectorProps;
+export {};

package/dist/context/InternalProvider.js

@@ -0,0 +1,13 @@
+import r, { createContext as o, useContext as d } from "react";
+const n = o(void 0), i = ({ children: e, ...t }) => /* @__PURE__ */ r.createElement(n.Provider, { value: t }, e);
+function u() {
+  const e = d(n);
+  if (e === void 0)
+    throw new Error("useInternalRownd must be used within a InternalRowndProvider");
+  return e;
+}
+export {
+  i as InternalRowndProvider,
+  u as useInternalRownd
+};
+//# sourceMappingURL=InternalProvider.js.map

package/dist/context/InternalProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"InternalProvider.js","sources":["../../src/context/InternalProvider.tsx"],"sourcesContent":["import React, { useContext, createContext } from 'react';\nimport { HubScriptInjectorProps } from './HubScriptInjector/HubScriptInjector';\n\nconst InternalRowndContext = createContext<HubScriptInjectorProps | undefined>(undefined);\n\ntype InternalRowndProvider = HubScriptInjectorProps & { children: React.ReactNode }\n\nexport const InternalRowndProvider = ({ children, ...rest }: InternalRowndProvider) => {\n  return (\n    <InternalRowndContext.Provider value={rest}>      \n      {children}\n    </InternalRowndContext.Provider>\n  );\n}\n\nexport function useInternalRownd(): HubScriptInjectorProps {\n  const context = useContext(InternalRowndContext);\n\n  if (context === undefined) {\n    throw new Error('useInternalRownd must be used within a InternalRowndProvider');\n  }\n\n  return context;\n}\n"],"names":["InternalRowndContext","createContext","InternalRowndProvider","children","rest","useInternalRownd","context","useContext"],"mappings":";AAGA,MAAMA,IAAuBC,EAAkD,MAAS,GAI3EC,IAAwB,CAAC,EAAE,UAAAC,GAAU,GAAGC,wCAEhDJ,EAAqB,UAArB,EAA8B,OAAOI,KACnCD,CACH;AAIG,SAASE,IAA2C;AACzD,QAAMC,IAAUC,EAAWP,CAAoB;AAE/C,MAAIM,MAAY;AACd,UAAM,IAAI,MAAM,8DAA8D;AAGhF,SAAOA;AACT;"}

package/dist/context/ReactRowndProvider.d.ts

@@ -0,0 +1,4 @@
+import { default as React } from 'react';
+import { RowndProviderProps } from './RowndContext';
+
+export declare const ReactRowndProvider: React.FC<RowndProviderProps>;

package/dist/context/ReactRowndProvider.js

@@ -0,0 +1,43 @@
+import e, { useCallback as u, useEffect as h } from "react";
+import { RowndContext as p } from "./RowndContext.js";
+import v from "./HubScriptInjector/InternalProviderHubScriptInjector.js";
+import E from "../hooks/useHub.js";
+import { InternalRowndProvider as L } from "./InternalProvider.js";
+import { addOnAuthenticatedListener as R, getOnAuthenticatedListeners as S, unsubscribeOnAuthenticatedListener as A } from "../utils/listeners.js";
+const g = ({
+  children: c,
+  ...d
+}) => {
+  const { setInitialHubState: b, hubListenerCb: i } = E(), m = u(
+    (t) => {
+      const n = R(t);
+      return () => {
+        A(n);
+      };
+    },
+    []
+  ), [r, l] = e.useState({
+    ...b(),
+    onAuthenticated: m
+  }), { user: a, is_authenticated: s, is_initializing: o } = r;
+  h(() => {
+    !s || o || !a.data.user_id || S().forEach(
+      ({ callback: t }) => t(r.user.data)
+    );
+  }, [s, o, a.data.user_id]);
+  const f = u(({ state: t, api: n }) => {
+    i({ state: t, api: n, callback: l });
+  }, [i]);
+  return /* @__PURE__ */ e.createElement(
+    L,
+    {
+      stateListener: f,
+      ...d
+    },
+    /* @__PURE__ */ e.createElement(p.Provider, { value: r }, /* @__PURE__ */ e.createElement(v, null), c)
+  );
+};
+export {
+  g as ReactRowndProvider
+};
+//# sourceMappingURL=ReactRowndProvider.js.map

package/dist/context/ReactRowndProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReactRowndProvider.js","sources":["../../src/context/ReactRowndProvider.tsx"],"sourcesContent":["import React, { useCallback, useEffect } from 'react';\nimport { HubListenerProps, RowndContext, RowndProviderProps } from './RowndContext';\nimport InternalProviderHubScriptInjector from './HubScriptInjector/InternalProviderHubScriptInjector';\nimport useHub from '../hooks/useHub';\nimport { TRowndContext, UserDataContext } from './types';\nimport { InternalRowndProvider } from './InternalProvider';\nimport {\n  addOnAuthenticatedListener,\n  getOnAuthenticatedListeners,\n  unsubscribeOnAuthenticatedListener,\n} from '../utils/listeners';\n\nexport const ReactRowndProvider: React.FC<RowndProviderProps> = ({\n  children,\n  ...props\n}) => {\n  const { setInitialHubState, hubListenerCb } = useHub();\n\n  const onAuthenticated: (\n    callback: (userData: UserDataContext) => void\n  ) => () => void = useCallback(\n    (callback: (userData: UserDataContext) => void) => {\n      const id = addOnAuthenticatedListener(callback);\n\n      const unsubscribe = () => {\n        unsubscribeOnAuthenticatedListener(id);\n      };\n\n      return unsubscribe;\n    },\n    []\n  );\n\n  const [hubState, setHubState] = React.useState<TRowndContext>({\n    ...setInitialHubState(),\n    onAuthenticated,\n  });\n\n  const { user, is_authenticated, is_initializing } = hubState;\n  useEffect(() => {\n    if (!is_authenticated || is_initializing || !user.data.user_id) {\n      return;\n    }\n\n    getOnAuthenticatedListeners().forEach(({ callback }) =>\n      callback(hubState.user.data)\n    );\n  }, [is_authenticated, is_initializing, user.data.user_id]);\n\n  const stateListener = useCallback(({ state, api }: HubListenerProps) => {\n    hubListenerCb({ state, api, callback: setHubState })\n  }, [hubListenerCb]);\n\n  return (\n    <InternalRowndProvider\n      stateListener={stateListener}\n      {...props}\n    >\n      <RowndContext.Provider value={hubState}>\n        <InternalProviderHubScriptInjector />\n        {children}\n      </RowndContext.Provider>\n    </InternalRowndProvider>\n  );\n};\n"],"names":["ReactRowndProvider","children","props","setInitialHubState","hubListenerCb","useHub","onAuthenticated","useCallback","callback","id","addOnAuthenticatedListener","unsubscribeOnAuthenticatedListener","hubState","setHubState","React","user","is_authenticated","is_initializing","useEffect","getOnAuthenticatedListeners","stateListener","state","api","InternalRowndProvider","RowndContext","InternalProviderHubScriptInjector"],"mappings":";;;;;;AAYO,MAAMA,IAAmD,CAAC;AAAA,EAC/D,UAAAC;AAAA,EACA,GAAGC;AACL,MAAM;AACJ,QAAM,EAAE,oBAAAC,GAAoB,eAAAC,EAAA,IAAkBC,EAAA,GAExCC,IAEYC;AAAA,IAChB,CAACC,MAAkD;AACjD,YAAMC,IAAKC,EAA2BF,CAAQ;AAM9C,aAJoB,MAAM;AACxB,QAAAG,EAAmCF,CAAE;AAAA,MACvC;AAAA,IAGF;AAAA,IACA,CAAA;AAAA,EAAC,GAGG,CAACG,GAAUC,CAAW,IAAIC,EAAM,SAAwB;AAAA,IAC5D,GAAGX,EAAA;AAAA,IACH,iBAAAG;AAAA,EAAA,CACD,GAEK,EAAE,MAAAS,GAAM,kBAAAC,GAAkB,iBAAAC,EAAA,IAAoBL;AACpD,EAAAM,EAAU,MAAM;AACd,IAAI,CAACF,KAAoBC,KAAmB,CAACF,EAAK,KAAK,WAIvDI,EAAA,EAA8B;AAAA,MAAQ,CAAC,EAAE,UAAAX,EAAA,MACvCA,EAASI,EAAS,KAAK,IAAI;AAAA,IAAA;AAAA,EAE/B,GAAG,CAACI,GAAkBC,GAAiBF,EAAK,KAAK,OAAO,CAAC;AAEzD,QAAMK,IAAgBb,EAAY,CAAC,EAAE,OAAAc,GAAO,KAAAC,QAA4B;AACtE,IAAAlB,EAAc,EAAE,OAAAiB,GAAO,KAAAC,GAAK,UAAUT,GAAa;AAAA,EACrD,GAAG,CAACT,CAAa,CAAC;AAElB,SACE,gBAAAU,EAAA;AAAA,IAACS;AAAA,IAAA;AAAA,MACC,eAAAH;AAAA,MACC,GAAGlB;AAAA,IAAA;AAAA,IAEJ,gBAAAY,EAAA,cAACU,EAAa,UAAb,EAAsB,OAAOZ,EAAA,GAC5B,gBAAAE,EAAA,cAACW,GAAA,IAAkC,GAClCxB,CACH;AAAA,EAAA;AAGN;"}

package/dist/context/RowndContext.d.ts

@@ -0,0 +1,33 @@
+import { default as React } from 'react';
+import { TRowndContext } from './types';
+
+export declare const RowndContext: React.Context<TRowndContext | undefined>;
+export type HubListenerProps = {
+    state: any;
+    api: any;
+};
+export type SuperTokensConfig = {
+    appInfo: {
+        appName?: string;
+        apiDomain: string;
+        apiBasePath?: string;
+    };
+};
+export type RowndProviderProps = {
+    appKey: string;
+    apiUrl?: string;
+    supertokens: SuperTokensConfig;
+    rootOrigin?: string;
+    hubUrlOverride?: string;
+    postRegistrationUrl?: string;
+    postSignOutRedirect?: string;
+    /**
+     * API version date string (e.g., '2026-01-21') that controls which Hub features are enabled.
+     * Defaults to the current SDK version date for new features.
+     * Set to an earlier date to opt-out of newer behaviors.
+     */
+    apiVersion?: string;
+    children: React.ReactNode;
+};
+declare function useRownd(): TRowndContext;
+export { useRownd };

package/dist/context/RowndContext.js

@@ -0,0 +1,13 @@
+import { createContext as t, useContext as e } from "react";
+const n = t(void 0);
+function d() {
+  const o = e(n);
+  if (o === void 0)
+    throw new Error("useRownd must be used within a RowndProvider");
+  return o;
+}
+export {
+  n as RowndContext,
+  d as useRownd
+};
+//# sourceMappingURL=RowndContext.js.map

package/dist/context/RowndContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RowndContext.js","sources":["../../src/context/RowndContext.tsx"],"sourcesContent":["import React, { useContext, createContext } from 'react';\nimport { TRowndContext } from './types';\n\nexport const RowndContext = createContext<TRowndContext | undefined>(undefined);\n\nexport type HubListenerProps = {\n  state: any;\n  api: any;\n};\n\nexport type SuperTokensConfig = {\n  appInfo: {\n    appName?: string;\n    apiDomain: string;\n    apiBasePath?: string;\n  };\n};\n\nexport type RowndProviderProps = {\n  appKey: string;\n  apiUrl?: string;\n  supertokens: SuperTokensConfig;\n  rootOrigin?: string;\n  hubUrlOverride?: string;\n  postRegistrationUrl?: string;\n  postSignOutRedirect?: string;\n  /**\n   * API version date string (e.g., '2026-01-21') that controls which Hub features are enabled.\n   * Defaults to the current SDK version date for new features.\n   * Set to an earlier date to opt-out of newer behaviors.\n   */\n  apiVersion?: string;\n  children: React.ReactNode;\n};\n\nfunction useRownd(): TRowndContext {\n  const context = useContext(RowndContext);\n\n  if (context === undefined) {\n    throw new Error('useRownd must be used within a RowndProvider');\n  }\n\n  return context;\n}\n\nexport { useRownd };\n"],"names":["RowndContext","createContext","useRownd","context","useContext"],"mappings":";AAGO,MAAMA,IAAeC,EAAyC,MAAS;AAgC9E,SAASC,IAA0B;AACjC,QAAMC,IAAUC,EAAWJ,CAAY;AAEvC,MAAIG,MAAY;AACd,UAAM,IAAI,MAAM,8CAA8C;AAGhE,SAAOA;AACT;"}