@atlasauth/react 0.1.17 → 0.1.19

package/dist/sign-in.d.ts

@@ -0,0 +1,42 @@
+import { type ReactNode, type ButtonHTMLAttributes } from 'react';
+import { type OAuthPopupHandlers } from '@atlasauth/js';
+import { type FlowState } from './fapi';
+import { type FlowProps } from './flow';
+export declare function SignIn(props?: FlowProps): import("react").JSX.Element;
+/**
+ * §6 headless native sign-in, for a consumer that renders its OWN Google button
+ * (or Apple / Facebook Limited Login). Mint a nonce with `mintNonce(provider)`,
+ * hand it to the provider SDK, then pass the resulting id_token to
+ * `signInWithIdToken` — it posts to the native endpoint, exchanges the ticket
+ * for cookies and re-boots the app on completion, returning the flow state so
+ * the caller can react to `needs_second_factor` etc.
+ */
+export declare function useSignIn(): {
+    mintNonce: (provider: string) => Promise<string | null>;
+    signInWithIdToken: (input: {
+        provider: string;
+        idToken: string;
+        nonce?: string;
+    }) => Promise<FlowState>;
+    startOauth: (input: {
+        provider: string;
+        mode?: "popup" | "redirect";
+        redirectUrl?: string;
+        handlers?: OAuthPopupHandlers;
+    }) => Promise<void>;
+};
+/**
+ * §10.2 `<SocialSignInButton>` — a headless social/OIDC sign-in button primitive
+ * (a single provider). Lets a team keep their own login card and still get
+ * Atlas's managed popup (or redirect) flow for a provider. `mode` defaults to the `<AtlasProvider oauthMode>`
+ * value, else redirect. Lifecycle callbacks (`onOpen`/`onError`/`onBlockedFallback`)
+ * fire only in popup mode.
+ */
+export declare function SocialSignInButton({ provider, mode, children, onOpen, onError, onBlockedFallback, ...buttonProps }: {
+    provider: string;
+    mode?: 'popup' | 'redirect';
+    children?: ReactNode;
+    onOpen?: () => void;
+    onError?: (code: string) => void;
+    onBlockedFallback?: (authorizationUrl: string) => void;
+} & Omit<ButtonHTMLAttributes<HTMLButtonElement>, 'onError'>): import("react").JSX.Element;

package/dist/sign-in.js

@@ -0,0 +1,91 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SignIn = SignIn;
+exports.useSignIn = useSignIn;
+exports.SocialSignInButton = SocialSignInButton;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const react_1 = require("react");
+const js_1 = require("@atlasauth/js");
+const AtlasProvider_1 = require("./AtlasProvider");
+const fapi_1 = require("./fapi");
+const flow_1 = require("./flow");
+function SignIn(props = {}) {
+    const { state, submit, client, finish } = (0, flow_1.useFlow)();
+    return ((0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: [(0, jsx_runtime_1.jsx)(flow_1.AttemptFlow, { attempt: state.attempt, busy: state.busy, errors: state.errors, titleKey: "signIn.title", hideTitle: props.hideTitle, onSubmit: submit }), !state.attempt ? ((0, jsx_runtime_1.jsx)(flow_1.SocialSignInButtons, { client: client, onComplete: finish, oneTap: props.googleOneTap, oauthMode: props.oauthMode })) : null] }));
+}
+/**
+ * §6 headless native sign-in, for a consumer that renders its OWN Google button
+ * (or Apple / Facebook Limited Login). Mint a nonce with `mintNonce(provider)`,
+ * hand it to the provider SDK, then pass the resulting id_token to
+ * `signInWithIdToken` — it posts to the native endpoint, exchanges the ticket
+ * for cookies and re-boots the app on completion, returning the flow state so
+ * the caller can react to `needs_second_factor` etc.
+ */
+function useSignIn() {
+    const { publishableKey, frontendApi, reload } = (0, AtlasProvider_1.useAtlas)();
+    const client = (0, react_1.useMemo)(() => new fapi_1.FapiClient({ publishableKey, baseUrl: frontendApi }), [frontendApi, publishableKey]);
+    const mintNonce = (0, react_1.useCallback)((provider) => (0, js_1.mintNativeNonce)(client, provider), [client]);
+    const signInWithIdToken = (0, react_1.useCallback)(async (input) => {
+        const next = await (0, js_1.nativeSignIn)(client, input);
+        if (next.attempt?.status === 'complete' && next.ticket) {
+            await client.post('/v1/client/tickets/exchange', {
+                attempt_id: next.attempt.id,
+                ticket: next.ticket,
+            });
+            await reload();
+        }
+        return next;
+    }, [client, reload]);
+    /**
+     * §oauth imperative — start a social/OIDC sign-in for your own button. In
+     * `"popup"` mode it opens a GSI-style popup, exchanges the one-time ticket on
+     * completion and re-boots signed-in (no navigation), falling back to a full
+     * redirect if the popup is blocked. In `"redirect"` mode it navigates.
+     */
+    const startOauth = (0, react_1.useCallback)(async (input) => {
+        if (typeof window === 'undefined')
+            return;
+        const redirectUrl = input.redirectUrl ?? window.location.href;
+        if (input.mode === 'popup') {
+            const out = await (0, js_1.startOauthPopup)(client, { provider: input.provider, redirectUrl }, input.handlers);
+            if (out.blocked && out.authorizationUrl) {
+                window.location.href = out.authorizationUrl;
+                return;
+            }
+            if (out.ticket) {
+                await client.post('/v1/client/tickets/exchange', {
+                    attempt_id: out.attemptId,
+                    ticket: out.ticket,
+                });
+                await reload();
+                return;
+            }
+            if (out.continuationUrl) {
+                window.location.href = out.continuationUrl;
+                return;
+            }
+            return;
+        }
+        const res = await (0, js_1.startOauthRedirect)(client, { provider: input.provider, redirectUrl });
+        if (res)
+            window.location.href = res.authorizationUrl;
+    }, [client, reload]);
+    return { mintNonce, signInWithIdToken, startOauth };
+}
+/**
+ * §10.2 `<SocialSignInButton>` — a headless social/OIDC sign-in button primitive
+ * (a single provider). Lets a team keep their own login card and still get
+ * Atlas's managed popup (or redirect) flow for a provider. `mode` defaults to the `<AtlasProvider oauthMode>`
+ * value, else redirect. Lifecycle callbacks (`onOpen`/`onError`/`onBlockedFallback`)
+ * fire only in popup mode.
+ */
+function SocialSignInButton({ provider, mode, children, onOpen, onError, onBlockedFallback, ...buttonProps }) {
+    const { startOauth } = useSignIn();
+    const { oauthMode } = (0, AtlasProvider_1.useAtlas)();
+    const effectiveMode = mode ?? oauthMode ?? 'redirect';
+    return ((0, jsx_runtime_1.jsx)("button", { type: "button", ...buttonProps, onClick: (e) => {
+            buttonProps.onClick?.(e);
+            void startOauth({ provider, mode: effectiveMode, handlers: { onOpen, onError, onBlockedFallback } });
+        }, children: children ?? `Continue with ${provider}` }));
+}
+//# sourceMappingURL=sign-in.js.map

package/dist/sign-in.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sign-in.js","sourceRoot":"","sources":["../src/sign-in.tsx"],"names":[],"mappings":"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"}

package/dist/sign-up.d.ts

@@ -0,0 +1,18 @@
+import { type FlowState } from './fapi';
+import { type FlowProps } from './flow';
+export declare function SignUp(props?: FlowProps): import("react").JSX.Element;
+/**
+ * §5.1 headless sign-up — the sign-up counterpart of {@link useSignIn}. Starts a
+ * sign-up attempt and returns the resulting flow (usually `needs_email_verification`;
+ * the shared `advance` then drives the code to completion), reloading the provider
+ * when a sign-up completes with a session ticket.
+ */
+export declare function useSignUp(): {
+    create: (input: {
+        email: string;
+        password: string;
+        fields?: Record<string, string>;
+        consent?: boolean;
+        captchaToken?: string;
+    }) => Promise<FlowState>;
+};

package/dist/sign-up.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SignUp = SignUp;
+exports.useSignUp = useSignUp;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const react_1 = require("react");
+const js_1 = require("@atlasauth/js");
+const AtlasProvider_1 = require("./AtlasProvider");
+const fapi_1 = require("./fapi");
+const flow_1 = require("./flow");
+function SignUp(props = {}) {
+    const { state, submit } = (0, flow_1.useFlow)();
+    return ((0, jsx_runtime_1.jsx)(flow_1.AttemptFlow, { attempt: state.attempt, busy: state.busy, errors: state.errors, titleKey: "signUp.title", hideTitle: props.hideTitle, onSubmit: submit }));
+}
+/**
+ * §5.1 headless sign-up — the sign-up counterpart of {@link useSignIn}. Starts a
+ * sign-up attempt and returns the resulting flow (usually `needs_email_verification`;
+ * the shared `advance` then drives the code to completion), reloading the provider
+ * when a sign-up completes with a session ticket.
+ */
+function useSignUp() {
+    const { publishableKey, frontendApi, reload } = (0, AtlasProvider_1.useAtlas)();
+    const client = (0, react_1.useMemo)(() => new fapi_1.FapiClient({ publishableKey, baseUrl: frontendApi }), [frontendApi, publishableKey]);
+    const create = (0, react_1.useCallback)(async (input) => {
+        const next = await (0, js_1.startSignUp)(client, input);
+        if (next.attempt?.status === 'complete' && next.ticket) {
+            await client.post('/v1/client/tickets/exchange', {
+                attempt_id: next.attempt.id,
+                ticket: next.ticket,
+            });
+            await reload();
+        }
+        return next;
+    }, [client, reload]);
+    return { create };
+}
+//# sourceMappingURL=sign-up.js.map

package/dist/sign-up.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sign-up.js","sourceRoot":"","sources":["../src/sign-up.tsx"],"names":[],"mappings":";;AAMA,wBAaC;AAQD,8BA2BC;;AAtDD,iCAA6C;AAC7C,sCAA4C;AAC5C,mDAA2C;AAC3C,iCAAoD;AACpD,iCAA8D;AAE9D,SAAgB,MAAM,CAAC,QAAmB,EAAE;IAC1C,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,IAAA,cAAO,GAAE,CAAC;IAEpC,OAAO,CACL,uBAAC,kBAAW,IACV,OAAO,EAAE,KAAK,CAAC,OAAO,EACtB,IAAI,EAAE,KAAK,CAAC,IAAI,EAChB,MAAM,EAAE,KAAK,CAAC,MAAM,EACpB,QAAQ,EAAC,cAAc,EACvB,SAAS,EAAE,KAAK,CAAC,SAAS,EAC1B,QAAQ,EAAE,MAAM,GAChB,CACH,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,SAAgB,SAAS;IACvB,MAAM,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,IAAA,wBAAQ,GAAE,CAAC;IAC3D,MAAM,MAAM,GAAG,IAAA,eAAO,EACpB,GAAG,EAAE,CAAC,IAAI,iBAAU,CAAC,EAAE,cAAc,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,EAC9D,CAAC,WAAW,EAAE,cAAc,CAAC,CAC9B,CAAC;IACF,MAAM,MAAM,GAAG,IAAA,mBAAW,EACxB,KAAK,EAAE,KAMN,EAAsB,EAAE;QACvB,MAAM,IAAI,GAAG,MAAM,IAAA,gBAAW,EAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QAC9C,IAAI,IAAI,CAAC,OAAO,EAAE,MAAM,KAAK,UAAU,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YACvD,MAAM,MAAM,CAAC,IAAI,CAAC,6BAA6B,EAAE;gBAC/C,UAAU,EAAG,IAAI,CAAC,OAA2B,CAAC,EAAE;gBAChD,MAAM,EAAE,IAAI,CAAC,MAAM;aACpB,CAAC,CAAC;YACH,MAAM,MAAM,EAAE,CAAC;QACjB,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC,EACD,CAAC,MAAM,EAAE,MAAM,CAAC,CACjB,CAAC;IACF,OAAO,EAAE,MAAM,EAAE,CAAC;AACpB,CAAC"}

package/dist/user-button.d.ts

@@ -0,0 +1,54 @@
+import { type ReactNode } from 'react';
+/**
+ * §L3 prebuilt-component EXTENSION API (Clerk `<UserButton.MenuItems>` /
+ * `<UserButton.Action>` / `<UserButton.Link>`).
+ *
+ * These are *descriptor* components: they render nothing on their own. A parent
+ * (`<UserButton>`) walks its children, matches these by identity, and turns each
+ * into a real menu entry it controls — so custom items sit inside the prebuilt
+ * dropdown's markup/appearance rather than being bolted on outside it. This is
+ * the same static-subcomponent pattern Clerk uses (`UserButton.Action`, etc.).
+ */
+export interface MenuActionProps {
+    /** The row's text. */
+    label: ReactNode;
+    /** Optional leading icon/element. */
+    labelIcon?: ReactNode;
+    /** Invoked when the row is chosen. */
+    onClick?: () => void;
+}
+export interface MenuLinkProps {
+    label: ReactNode;
+    labelIcon?: ReactNode;
+    /** Where the row navigates. */
+    href: string;
+}
+/** A container for custom `<UserButton.Action>` / `<UserButton.Link>` rows. Renders nothing itself. */
+declare function UserButtonMenuItems(_props: {
+    children?: ReactNode;
+}): null;
+/** A custom action row inside `<UserButton.MenuItems>`. Renders nothing itself. */
+declare function UserButtonAction(_props: MenuActionProps): null;
+/** A custom link row inside `<UserButton.MenuItems>`. Renders nothing itself. */
+declare function UserButtonLink(_props: MenuLinkProps): null;
+/**
+ * The signed-in user's avatar + dropdown. Pass `<UserButton.MenuItems>` children
+ * to add custom `<UserButton.Action>` / `<UserButton.Link>` rows above sign-out.
+ */
+export declare function UserButton({ children }?: {
+    children?: ReactNode;
+}): import("react").JSX.Element | null;
+export declare namespace UserButton {
+    var MenuItems: typeof UserButtonMenuItems;
+    var Action: typeof UserButtonAction;
+    var Link: typeof UserButtonLink;
+}
+/**
+ * The signed-in user's avatar (image, or initials fallback) — the standalone
+ * renderer `<UserButton>` uses internally, exported for reuse (Clerk `<UserAvatar>`).
+ */
+export declare function UserAvatar({ size, className }: {
+    size?: number;
+    className?: string;
+}): import("react").JSX.Element | null;
+export {};

package/dist/user-button.js

@@ -0,0 +1,75 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UserButton = UserButton;
+exports.UserAvatar = UserAvatar;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const react_1 = require("react");
+const hooks_1 = require("./hooks");
+const components_shared_1 = require("./components-shared");
+/** A container for custom `<UserButton.Action>` / `<UserButton.Link>` rows. Renders nothing itself. */
+function UserButtonMenuItems(_props) {
+    return null;
+}
+/** A custom action row inside `<UserButton.MenuItems>`. Renders nothing itself. */
+function UserButtonAction(_props) {
+    return null;
+}
+/** A custom link row inside `<UserButton.MenuItems>`. Renders nothing itself. */
+function UserButtonLink(_props) {
+    return null;
+}
+function collectMenuEntries(children) {
+    return (0, components_shared_1.collectByType)(children, (el) => {
+        if (el.type === UserButtonAction)
+            return { kind: 'action', props: el.props };
+        if (el.type === UserButtonLink)
+            return { kind: 'link', props: el.props };
+        return undefined;
+    });
+}
+/**
+ * The signed-in user's avatar + dropdown. Pass `<UserButton.MenuItems>` children
+ * to add custom `<UserButton.Action>` / `<UserButton.Link>` rows above sign-out.
+ */
+function UserButton({ children } = {}) {
+    const { user } = (0, hooks_1.useUser)();
+    const { signOut } = (0, hooks_1.useAuth)();
+    const { session } = (0, hooks_1.useSession)();
+    const { sessions, setActive } = (0, hooks_1.useSessionList)();
+    const t = (0, components_shared_1.useText)();
+    const [open, setOpen] = (0, react_1.useState)(false);
+    const avatarClass = (0, components_shared_1.useClass)('avatar', 'atlas-avatar');
+    const menuClass = (0, components_shared_1.useClass)('menu', 'atlas-menu');
+    const itemClass = (0, components_shared_1.useClass)('menuItem', 'atlas-menu-item');
+    const custom = (0, react_1.useMemo)(() => collectMenuEntries(children), [children]);
+    if (!user)
+        return null;
+    const label = [user.first_name, user.last_name].filter(Boolean).join(' ') || user.username || '';
+    const nameOf = (u) => [u.first_name, u.last_name].filter(Boolean).join(' ') || u.username || '';
+    // §L1 the OTHER accounts signed in on this browser (switchable in one click).
+    const others = sessions.filter((s) => s.id !== session?.id);
+    return ((0, jsx_runtime_1.jsxs)("div", { className: "atlas-user-button", children: [(0, jsx_runtime_1.jsx)("button", { className: avatarClass, onClick: () => setOpen((o) => !o), "aria-expanded": open, children: user.image_url ? (0, jsx_runtime_1.jsx)("img", { alt: "", src: user.image_url }) : (0, jsx_runtime_1.jsx)("span", { children: label.slice(0, 1) }) }), open ? ((0, jsx_runtime_1.jsxs)("div", { className: menuClass, role: "menu", children: [(0, jsx_runtime_1.jsx)("span", { className: itemClass, children: label }), others.map((s) => ((0, jsx_runtime_1.jsxs)("button", { className: itemClass, role: "menuitem", "data-atlas": "switch-session", onClick: () => {
+                            setOpen(false);
+                            void setActive({ session: s.id });
+                        }, children: [s.user.image_url ? ((0, jsx_runtime_1.jsx)("img", { alt: "", src: s.user.image_url, width: 16, height: 16 })) : null, t('userButton.switchTo'), " ", nameOf(s.user)] }, s.id))), custom.map((entry, i) => entry.kind === 'action' ? ((0, jsx_runtime_1.jsxs)("button", { className: itemClass, role: "menuitem", onClick: () => {
+                            setOpen(false);
+                            entry.props.onClick?.();
+                        }, children: [entry.props.labelIcon, entry.props.label] }, i)) : ((0, jsx_runtime_1.jsxs)("a", { className: itemClass, role: "menuitem", href: entry.props.href, children: [entry.props.labelIcon, entry.props.label] }, i))), (0, jsx_runtime_1.jsx)("button", { className: itemClass, role: "menuitem", onClick: () => void signOut(), children: t('userButton.signOut') })] })) : null] }));
+}
+UserButton.MenuItems = UserButtonMenuItems;
+UserButton.Action = UserButtonAction;
+UserButton.Link = UserButtonLink;
+/**
+ * The signed-in user's avatar (image, or initials fallback) — the standalone
+ * renderer `<UserButton>` uses internally, exported for reuse (Clerk `<UserAvatar>`).
+ */
+function UserAvatar({ size = 32, className }) {
+    const { user } = (0, hooks_1.useUser)();
+    const avatarClass = (0, components_shared_1.useClass)('avatar', 'atlas-avatar');
+    if (!user)
+        return null;
+    const label = [user.first_name, user.last_name].filter(Boolean).join(' ') || user.username || '';
+    const style = { width: size, height: size };
+    return ((0, jsx_runtime_1.jsx)("span", { className: className ?? avatarClass, style: style, "data-atlas": "user-avatar", children: user.image_url ? (0, jsx_runtime_1.jsx)("img", { alt: "", src: user.image_url, width: size, height: size }) : (0, jsx_runtime_1.jsx)("span", { children: label.slice(0, 1).toUpperCase() }) }));
+}
+//# sourceMappingURL=user-button.js.map

package/dist/user-button.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-button.js","sourceRoot":"","sources":["../src/user-button.tsx"],"names":[],"mappings":"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"}

package/dist/waitlist.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Clerk-parity `useWaitlist()`. Headless join: `join(email)` posts the address to
+ * the waitlist endpoint and hands back the raw {@link FapiClient} response, so a
+ * caller rendering its own form decides what to show on success vs. failure.
+ */
+export declare function useWaitlist(): {
+    join: (email: string) => Promise<import("@atlasauth/js").FapiResponse<unknown>>;
+};
+/**
+ * Clerk-parity `<Waitlist>`. An email-and-submit card (styled like `<SignUp>`)
+ * that calls {@link useWaitlist}. A 200 swaps the form for a success message; any
+ * other response surfaces the server's message as a field error, so a bad or
+ * duplicate address is reported in place rather than silently swallowed.
+ */
+export declare function Waitlist(): import("react").JSX.Element;

package/dist/waitlist.js

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useWaitlist = useWaitlist;
+exports.Waitlist = Waitlist;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const react_1 = require("react");
+const components_shared_1 = require("./components-shared");
+/**
+ * Clerk-parity `useWaitlist()`. Headless join: `join(email)` posts the address to
+ * the waitlist endpoint and hands back the raw {@link FapiClient} response, so a
+ * caller rendering its own form decides what to show on success vs. failure.
+ */
+function useWaitlist() {
+    const client = (0, components_shared_1.useMeClient)();
+    const join = (0, react_1.useCallback)((email) => client.post('/v1/client/waitlist', { email_address: email }), [client]);
+    return { join };
+}
+/**
+ * Clerk-parity `<Waitlist>`. An email-and-submit card (styled like `<SignUp>`)
+ * that calls {@link useWaitlist}. A 200 swaps the form for a success message; any
+ * other response surfaces the server's message as a field error, so a bad or
+ * duplicate address is reported in place rather than silently swallowed.
+ */
+function Waitlist() {
+    const { join } = useWaitlist();
+    const t = (0, components_shared_1.useText)();
+    const cardClass = (0, components_shared_1.useClass)('card', 'atlas-card');
+    const titleClass = (0, components_shared_1.useClass)('headerTitle', 'atlas-title');
+    const inputClass = (0, components_shared_1.useClass)('formFieldInput', 'atlas-input');
+    const buttonClass = (0, components_shared_1.useClass)('formButtonPrimary', 'atlas-button');
+    const errorClass = (0, components_shared_1.useClass)('formFieldError', 'atlas-error');
+    const [email, setEmail] = (0, react_1.useState)('');
+    const [busy, setBusy] = (0, react_1.useState)(false);
+    const [joined, setJoined] = (0, react_1.useState)(false);
+    const [error, setError] = (0, react_1.useState)(null);
+    const submit = async () => {
+        setBusy(true);
+        setError(null);
+        const res = await join(email);
+        setBusy(false);
+        if (res.ok) {
+            setJoined(true);
+            return;
+        }
+        setError(res.errors[0]?.message ?? t('error.generic'));
+    };
+    return ((0, jsx_runtime_1.jsxs)("form", { className: cardClass, "data-atlas": "waitlist", onSubmit: (event) => {
+            event.preventDefault();
+            void submit();
+        }, children: [(0, jsx_runtime_1.jsx)("h1", { className: titleClass, children: t('waitlist.title') }), joined ? ((0, jsx_runtime_1.jsx)("p", { "data-atlas": "waitlist-success", children: t('waitlist.success') })) : ((0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: [(0, jsx_runtime_1.jsxs)("label", { className: "atlas-field", children: [(0, jsx_runtime_1.jsx)("span", { children: t('waitlist.emailLabel') }), (0, jsx_runtime_1.jsx)("input", { className: inputClass, type: "email", value: email, onChange: (event) => setEmail(event.target.value) }), error ? ((0, jsx_runtime_1.jsx)("span", { className: errorClass, role: "alert", children: error })) : null] }), (0, jsx_runtime_1.jsx)("button", { className: buttonClass, type: "submit", disabled: busy, children: t('waitlist.submit') })] }))] }));
+}
+//# sourceMappingURL=waitlist.js.map

package/dist/waitlist.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"waitlist.js","sourceRoot":"","sources":["../src/waitlist.tsx"],"names":[],"mappings":"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"}

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "@atlasauth/react",
-  "version": "0.1.17",
+  "version": "0.1.19",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "dependencies": {
-    "@atlasauth/js": "0.1.4",
+    "@atlasauth/js": "0.1.5",
     "@atlasauth/authz": "0.1.1"
   },
   "peerDependencies": {
@@ -21,7 +21,8 @@
   },
   "files": [
     "dist",
-    "README.md"
+    "README.md",
+    "CHANGELOG.md"
   ],
   "scripts": {
     "build": "tsc -p tsconfig.build.json",