@usethrottle/auth 0.1.0

package/dist/react/index.d.cts

@@ -0,0 +1,54 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ReactNode } from 'react';
+import { ThrottleAuthConfig, ThrottleAuth, AuthSnapshot, ThrottleAccount, ThrottleAuthError, Address, AddressInput, Customer, ProfilePatch, Page, Invoice, Order, PaymentMethod, Subscription } from '../index.cjs';
+export { AuthStatus, AuthStorage, DeviceSession, Session, createAccount, createThrottleAuth, localStorageAdapter, memoryStorage } from '../index.cjs';
+
+interface ThrottleAuthProviderProps extends Partial<ThrottleAuthConfig> {
+    publishableKey: string;
+    /** Inject a pre-built client. Tests use it; merchants sharing one client across roots may too. */
+    auth?: ThrottleAuth;
+    children: ReactNode;
+}
+interface ContextValue {
+    auth: ThrottleAuth;
+    account: ThrottleAccount;
+}
+declare function ThrottleAuthProvider(props: ThrottleAuthProviderProps): react_jsx_runtime.JSX.Element;
+declare function useAuthContext(): ContextValue;
+type UseAuthResult = AuthSnapshot & {
+    isLoading: boolean;
+    isAuthenticated: boolean;
+    auth: ThrottleAuth;
+    account: ThrottleAccount;
+};
+declare function useAuth(): UseAuthResult;
+
+interface Resource<T> {
+    data: T;
+    isLoading: boolean;
+    error: ThrottleAuthError | null;
+    refetch(): Promise<void>;
+}
+declare function useCustomer(): Resource<Customer | null> & {
+    update(patch: ProfilePatch): Promise<void>;
+};
+declare function useAddresses(): Resource<Address[]> & {
+    create(input: AddressInput): Promise<void>;
+    update(id: string, patch: Partial<AddressInput>): Promise<void>;
+    remove(id: string): Promise<void>;
+};
+declare function useSavedCards(): Resource<PaymentMethod[]> & {
+    setDefault(id: string): Promise<void>;
+    remove(id: string): Promise<void>;
+};
+declare function useOrders(page?: Page): Resource<Order[]>;
+declare function useInvoices(page?: Page): Resource<Invoice[]>;
+declare function useSubscriptions(page?: Page): Resource<Subscription[]> & {
+    cancel(id: string, opts?: {
+        atPeriodEnd?: boolean;
+    }): Promise<void>;
+    pause(id: string): Promise<void>;
+    resume(id: string): Promise<void>;
+};
+
+export { Address, AddressInput, AuthSnapshot, Customer, Invoice, Order, Page, PaymentMethod, ProfilePatch, type Resource, Subscription, ThrottleAccount, ThrottleAuth, ThrottleAuthConfig, ThrottleAuthError, ThrottleAuthProvider, type ThrottleAuthProviderProps, type UseAuthResult, useAddresses, useAuth, useAuthContext, useCustomer, useInvoices, useOrders, useSavedCards, useSubscriptions };

package/dist/react/index.d.ts

@@ -0,0 +1,54 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ReactNode } from 'react';
+import { ThrottleAuthConfig, ThrottleAuth, AuthSnapshot, ThrottleAccount, ThrottleAuthError, Address, AddressInput, Customer, ProfilePatch, Page, Invoice, Order, PaymentMethod, Subscription } from '../index.js';
+export { AuthStatus, AuthStorage, DeviceSession, Session, createAccount, createThrottleAuth, localStorageAdapter, memoryStorage } from '../index.js';
+
+interface ThrottleAuthProviderProps extends Partial<ThrottleAuthConfig> {
+    publishableKey: string;
+    /** Inject a pre-built client. Tests use it; merchants sharing one client across roots may too. */
+    auth?: ThrottleAuth;
+    children: ReactNode;
+}
+interface ContextValue {
+    auth: ThrottleAuth;
+    account: ThrottleAccount;
+}
+declare function ThrottleAuthProvider(props: ThrottleAuthProviderProps): react_jsx_runtime.JSX.Element;
+declare function useAuthContext(): ContextValue;
+type UseAuthResult = AuthSnapshot & {
+    isLoading: boolean;
+    isAuthenticated: boolean;
+    auth: ThrottleAuth;
+    account: ThrottleAccount;
+};
+declare function useAuth(): UseAuthResult;
+
+interface Resource<T> {
+    data: T;
+    isLoading: boolean;
+    error: ThrottleAuthError | null;
+    refetch(): Promise<void>;
+}
+declare function useCustomer(): Resource<Customer | null> & {
+    update(patch: ProfilePatch): Promise<void>;
+};
+declare function useAddresses(): Resource<Address[]> & {
+    create(input: AddressInput): Promise<void>;
+    update(id: string, patch: Partial<AddressInput>): Promise<void>;
+    remove(id: string): Promise<void>;
+};
+declare function useSavedCards(): Resource<PaymentMethod[]> & {
+    setDefault(id: string): Promise<void>;
+    remove(id: string): Promise<void>;
+};
+declare function useOrders(page?: Page): Resource<Order[]>;
+declare function useInvoices(page?: Page): Resource<Invoice[]>;
+declare function useSubscriptions(page?: Page): Resource<Subscription[]> & {
+    cancel(id: string, opts?: {
+        atPeriodEnd?: boolean;
+    }): Promise<void>;
+    pause(id: string): Promise<void>;
+    resume(id: string): Promise<void>;
+};
+
+export { Address, AddressInput, AuthSnapshot, Customer, Invoice, Order, Page, PaymentMethod, ProfilePatch, type Resource, Subscription, ThrottleAccount, ThrottleAuth, ThrottleAuthConfig, ThrottleAuthError, ThrottleAuthProvider, type ThrottleAuthProviderProps, type UseAuthResult, useAddresses, useAuth, useAuthContext, useCustomer, useInvoices, useOrders, useSavedCards, useSubscriptions };

package/dist/react/index.js

@@ -0,0 +1,145 @@
+import "../chunk-ZMNCURDE.js";
+import {
+  ThrottleAuthProvider,
+  useAuth,
+  useAuthContext
+} from "../chunk-YHIGTY64.js";
+import {
+  ThrottleAuthError,
+  createAccount,
+  createThrottleAuth,
+  localStorageAdapter,
+  memoryStorage
+} from "../chunk-NQU7HM23.js";
+
+// src/react/hooks.ts
+import { useCallback, useEffect, useRef, useState } from "react";
+function asError(err) {
+  if (err instanceof ThrottleAuthError) return err;
+  const anyErr = err;
+  return new ThrottleAuthError({
+    code: anyErr?.code ?? "request_failed",
+    message: anyErr?.message ?? String(err),
+    statusCode: anyErr?.statusCode ?? 0
+  });
+}
+function useResource(empty, load, deps) {
+  const { status, emailVerified } = useAuth();
+  const [data, setData] = useState(empty);
+  const [isLoading, setIsLoading] = useState(status === "loading");
+  const [error, setError] = useState(null);
+  const gen = useRef(0);
+  const alive = useRef(true);
+  useEffect(() => {
+    alive.current = true;
+    return () => {
+      alive.current = false;
+      gen.current++;
+    };
+  }, []);
+  const refetch = useCallback(async () => {
+    const mine = ++gen.current;
+    setIsLoading(true);
+    try {
+      const next = await load();
+      if (!alive.current || gen.current !== mine) return;
+      setData(next);
+      setError(null);
+    } catch (err) {
+      if (!alive.current || gen.current !== mine) return;
+      setError(asError(err));
+    } finally {
+      if (alive.current && gen.current === mine) setIsLoading(false);
+    }
+  }, deps);
+  useEffect(() => {
+    if (status !== "authenticated") {
+      gen.current++;
+      setData(empty);
+      setError(null);
+      setIsLoading(status === "loading");
+      return;
+    }
+    void refetch();
+  }, [status, emailVerified, refetch]);
+  return { data, isLoading, error, refetch };
+}
+function useCustomer() {
+  const { account } = useAuth();
+  const res = useResource(null, () => account.getProfile(), [account]);
+  const update = useCallback(async (patch) => {
+    await account.updateProfile(patch);
+    await res.refetch();
+  }, [account, res]);
+  return { ...res, update };
+}
+function useAddresses() {
+  const { account } = useAuth();
+  const res = useResource([], () => account.listAddresses(), [account]);
+  const after = async (p) => {
+    await p;
+    await res.refetch();
+  };
+  return {
+    ...res,
+    create: (input) => after(account.createAddress(input)),
+    update: (id, patch) => after(account.updateAddress(id, patch)),
+    remove: (id) => after(account.deleteAddress(id))
+  };
+}
+function useSavedCards() {
+  const { account } = useAuth();
+  const res = useResource([], () => account.listPaymentMethods(), [account]);
+  const after = async (p) => {
+    await p;
+    await res.refetch();
+  };
+  return {
+    ...res,
+    setDefault: (id) => after(account.setDefaultPaymentMethod(id)),
+    remove: (id) => after(account.deletePaymentMethod(id))
+  };
+}
+function useOrders(page) {
+  const { account } = useAuth();
+  return useResource([], () => account.listOrders(page), [account, page?.cursor, page?.limit]);
+}
+function useInvoices(page) {
+  const { account } = useAuth();
+  return useResource([], () => account.listInvoices(page), [account, page?.cursor, page?.limit]);
+}
+function useSubscriptions(page) {
+  const { account } = useAuth();
+  const res = useResource(
+    [],
+    () => account.listSubscriptions(page),
+    [account, page?.cursor, page?.limit]
+  );
+  const after = async (p) => {
+    await p;
+    await res.refetch();
+  };
+  return {
+    ...res,
+    cancel: (id, opts) => after(account.cancelSubscription(id, opts)),
+    pause: (id) => after(account.pauseSubscription(id)),
+    resume: (id) => after(account.resumeSubscription(id))
+  };
+}
+export {
+  ThrottleAuthError,
+  ThrottleAuthProvider,
+  createAccount,
+  createThrottleAuth,
+  localStorageAdapter,
+  memoryStorage,
+  useAddresses,
+  useAuth,
+  useAuthContext,
+  useCustomer,
+  useInvoices,
+  useOrders,
+  useSavedCards,
+  useSubscriptions
+};
+//# sourceMappingURL=index.js.map

package/dist/react/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/react/hooks.ts"],"sourcesContent":["import { useCallback, useEffect, useRef, useState } from 'react';\nimport { ThrottleAuthError } from '../errors';\nimport type { Address, AddressInput, Customer, Invoice, Order, PaymentMethod, ProfilePatch, Subscription } from '../types';\nimport type { Page } from '../account';\nimport { useAuth } from './context';\n\nexport interface Resource<T> {\n  data: T;\n  isLoading: boolean;\n  error: ThrottleAuthError | null;\n  refetch(): Promise<void>;\n}\n\nfunction asError(err: unknown): ThrottleAuthError {\n  if (err instanceof ThrottleAuthError) return err;\n  const anyErr = err as any;\n  return new ThrottleAuthError({\n    code: anyErr?.code ?? 'request_failed',\n    message: anyErr?.message ?? String(err),\n    statusCode: anyErr?.statusCode ?? 0,\n  });\n}\n\n/**\n * One fetch-on-auth-change primitive behind every resource hook. `emailVerified`\n * is a dependency on purpose: verifying lifts the claim cutoff, and lists that\n * were legitimately empty a moment ago are not empty any more.\n */\nfunction useResource<T>(empty: T, load: () => Promise<T>, deps: unknown[]): Resource<T> {\n  const { status, emailVerified } = useAuth();\n  const [data, setData] = useState<T>(empty);\n  const [isLoading, setIsLoading] = useState(status === 'loading');\n  const [error, setError] = useState<ThrottleAuthError | null>(null);\n  const gen = useRef(0);\n  const alive = useRef(true);\n\n  useEffect(() => {\n    // Set on mount, not only cleared on unmount: React StrictMode mounts,\n    // unmounts and remounts in development, and a ref that is only ever set\n    // to false would silently discard every response for the rest of the\n    // component's life.\n    alive.current = true;\n    return () => { alive.current = false; gen.current++; };\n  }, []);\n\n  const refetch = useCallback(async () => {\n    const mine = ++gen.current;\n    setIsLoading(true);\n    try {\n      const next = await load();\n      if (!alive.current || gen.current !== mine) return;\n      setData(next);\n      setError(null);\n    } catch (err) {\n      if (!alive.current || gen.current !== mine) return;\n      setError(asError(err));\n    } finally {\n      if (alive.current && gen.current === mine) setIsLoading(false);\n    }\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, deps);\n\n  useEffect(() => {\n    if (status !== 'authenticated') {\n      gen.current++;               // abandon anything in flight\n      setData(empty);\n      setError(null);\n      setIsLoading(status === 'loading');\n      return;\n    }\n    void refetch();\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [status, emailVerified, refetch]);\n\n  return { data, isLoading, error, refetch };\n}\n\nexport function useCustomer(): Resource<Customer | null> & { update(patch: ProfilePatch): Promise<void> } {\n  const { account } = useAuth();\n  const res = useResource<Customer | null>(null, () => account.getProfile(), [account]);\n  const update = useCallback(async (patch: ProfilePatch) => {\n    await account.updateProfile(patch);\n    await res.refetch();\n  }, [account, res]);\n  return { ...res, update };\n}\n\nexport function useAddresses(): Resource<Address[]> & {\n  create(input: AddressInput): Promise<void>;\n  update(id: string, patch: Partial<AddressInput>): Promise<void>;\n  remove(id: string): Promise<void>;\n} {\n  const { account } = useAuth();\n  const res = useResource<Address[]>([], () => account.listAddresses(), [account]);\n  const after = async (p: Promise<unknown>) => { await p; await res.refetch(); };\n  return {\n    ...res,\n    create: (input) => after(account.createAddress(input)),\n    update: (id, patch) => after(account.updateAddress(id, patch)),\n    remove: (id) => after(account.deleteAddress(id)),\n  };\n}\n\nexport function useSavedCards(): Resource<PaymentMethod[]> & {\n  setDefault(id: string): Promise<void>;\n  remove(id: string): Promise<void>;\n} {\n  const { account } = useAuth();\n  const res = useResource<PaymentMethod[]>([], () => account.listPaymentMethods(), [account]);\n  const after = async (p: Promise<unknown>) => { await p; await res.refetch(); };\n  return {\n    ...res,\n    setDefault: (id) => after(account.setDefaultPaymentMethod(id)),\n    remove: (id) => after(account.deletePaymentMethod(id)),\n  };\n}\n\nexport function useOrders(page?: Page): Resource<Order[]> {\n  const { account } = useAuth();\n  return useResource<Order[]>([], () => account.listOrders(page), [account, page?.cursor, page?.limit]);\n}\n\nexport function useInvoices(page?: Page): Resource<Invoice[]> {\n  const { account } = useAuth();\n  return useResource<Invoice[]>([], () => account.listInvoices(page), [account, page?.cursor, page?.limit]);\n}\n\nexport function useSubscriptions(page?: Page): Resource<Subscription[]> & {\n  cancel(id: string, opts?: { atPeriodEnd?: boolean }): Promise<void>;\n  pause(id: string): Promise<void>;\n  resume(id: string): Promise<void>;\n} {\n  const { account } = useAuth();\n  const res = useResource<Subscription[]>([], () => account.listSubscriptions(page),\n    [account, page?.cursor, page?.limit]);\n  const after = async (p: Promise<unknown>) => { await p; await res.refetch(); };\n  return {\n    ...res,\n    cancel: (id, opts) => after(account.cancelSubscription(id, opts)),\n    pause: (id) => after(account.pauseSubscription(id)),\n    resume: (id) => after(account.resumeSubscription(id)),\n  };\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@usethrottle/auth",
+  "version": "0.1.0",
+  "description": "Buyer authentication for Throttle storefronts — headless core, React hooks, and drop-in forms.",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": ["dist", "README.md", "CLAUDE.md"],
+  "exports": {
+    ".": { "types": "./dist/index.d.ts", "import": "./dist/index.js", "require": "./dist/index.cjs" },
+    "./react": { "types": "./dist/react/index.d.ts", "import": "./dist/react/index.js", "require": "./dist/react/index.cjs" },
+    "./forms": { "types": "./dist/react/forms/index.d.ts", "import": "./dist/react/forms/index.js", "require": "./dist/react/forms/index.cjs" }
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
+  },
+  "peerDependencies": { "react": ">=18", "react-dom": ">=18" },
+  "peerDependenciesMeta": { "react": { "optional": true }, "react-dom": { "optional": true } },
+  "devDependencies": {
+    "@testing-library/react": "^16.1.0",
+    "@types/react": "^19.1.0",
+    "@vitejs/plugin-react": "^4.3.4",
+    "jsdom": "^25.0.1",
+    "react": "^19.1.0",
+    "react-dom": "^19.1.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.7.0",
+    "vitest": "^2.1.9"
+  },
+  "publishConfig": { "access": "public" },
+  "engines": { "node": ">=20" }
+}