azirid-react 0.6.0 → 0.7.0

package/README.md

@@ -670,6 +670,89 @@ export default function PayphoneCallbackPage() {
 
 ---
 
+## Multi-tenant
+
+Every authenticated user always has an active `tenantId` and `tenantRole` in the JWT. On signup, if no `tenantId` is provided, a personal tenant is automatically created and the user becomes `OWNER`.
+
+### Tenant switching via `useAzirid()`
+
+```tsx
+import { useAzirid } from 'azirid-react'
+
+function TenantSwitcher({ tenantId }: { tenantId: string }) {
+  const { user, switchTenant } = useAzirid()
+
+  return (
+    <div>
+      <p>Active tenant: {user?.tenantId} ({user?.tenantRole})</p>
+      <button onClick={() => switchTenant(tenantId)}>Switch</button>
+    </div>
+  )
+}
+```
+
+`switchTenant(tenantId)` calls the refresh endpoint with the new `tenantId`, updates the access token in memory, and invalidates all queries — no re-login required.
+
+### `useTenants`
+
+List all tenants the authenticated user belongs to.
+
+```tsx
+import { useTenants } from 'azirid-react'
+
+function TenantList() {
+  const { data: tenants, isLoading } = useTenants()
+
+  if (isLoading) return <Spinner />
+
+  return (
+    <ul>
+      {tenants?.map((t) => (
+        <li key={t.tenantId}>
+          {t.name} — {t.role}
+        </li>
+      ))}
+    </ul>
+  )
+}
+```
+
+### `useTenantMembers`
+
+List all members of a specific tenant. The authenticated user must be a member.
+
+```tsx
+import { useTenantMembers } from 'azirid-react'
+
+function MemberList({ tenantId }: { tenantId: string }) {
+  const { data: members } = useTenantMembers(tenantId)
+
+  return (
+    <ul>
+      {members?.map((m) => (
+        <li key={m.id}>
+          {m.user.email} — {m.role}
+        </li>
+      ))}
+    </ul>
+  )
+}
+```
+
+### `useSwitchTenant`
+
+Headless hook for tenant switching (same as `switchTenant` from `useAzirid()`, but usable outside the main context hook).
+
+```tsx
+import { useSwitchTenant } from 'azirid-react'
+
+const { switchTenant } = useSwitchTenant()
+
+await switchTenant('tenant-id-here')
+```
+
+---
+
 ## Referrals
 
 All referral hooks require `<AziridProvider>` in the tree and an authenticated user.
@@ -1255,7 +1338,7 @@ import type {
 
 | Type | Description |
 | --- | --- |
-| `AuthUser` | Authenticated user object (`id`, `email`, `firstName`, `emailVerified`, `mfaEnabled`, `appId`, `tenantId`, ...) |
+| `AuthUser` | Authenticated user object (`id`, `email`, `tenantId`, `tenantRole`, `appId`, ...) — `tenantId` and `tenantRole` are always present |
 | `AuthSuccessResponse` | Login/signup response (`accessToken`, `user`) |
 | `AuthState` | Full auth state (`user`, `accessToken`, `isAuthenticated`, `isLoading`, `error`) |
 | `SignupData` | Signup payload (`email`, `password`, `acceptedTosVersion?`, `referralCode?`, ...) |
@@ -1264,6 +1347,14 @@ import type {
 | `AziridProviderProps` | All provider props (see table above) |
 | `AziridContextValue` | Context value returned by `useAzirid()` |
 
+### Tenant Types
+
+| Type | Description |
+| --- | --- |
+| `TenantWithRole` | Tenant membership (`tenantId`, `name`, `slug`, `role: 'OWNER' \| 'MEMBER'`, `joinedAt`) |
+| `TenantMemberInfo` | Tenant member (`id`, `role`, `joinedAt`, `user: { id, email, firstName, lastName }`) |
+| `CreateTenantData` | Create tenant payload (`name`, `description?`) |
+
 ### Billing Types
 
 | Type | Description |

package/dist/index.cjs

@@ -97,7 +97,8 @@ var SUFFIXES = {
   transferProofs: "billing/transfer-proofs",
   payphoneConfirm: "billing/payphone/confirm",
   referralMe: "referrals/me",
-  referralStats: "referrals/stats"
+  referralStats: "referrals/stats",
+  userTenants: "tenants"
 };
 var BASE_PATHS = {
   /** Proxy mode (Next.js): requests go to the same origin via route handler */
@@ -161,7 +162,7 @@ function createAccessClient(config, appContext) {
     return match ? decodeURIComponent(match[1]) : null;
   }
   const sessionPaths = [paths.refresh, paths.bootstrap, paths.logout];
-  async function refreshTokensInternal() {
+  async function refreshTokensInternal(opts) {
     const reqHeaders = {
       "Content-Type": "application/json",
       ...config.headers
@@ -175,6 +176,9 @@ function createAccessClient(config, appContext) {
     if (refreshToken) {
       bodyPayload["rt"] = refreshToken;
     }
+    if (opts?.tenantId) {
+      bodyPayload["tenantId"] = opts.tenantId;
+    }
     const res = await fetch(`${baseUrl}${paths.refresh}`, {
       method: "POST",
       headers: reqHeaders,
@@ -195,7 +199,11 @@ function createAccessClient(config, appContext) {
     if (rt) setRefreshToken(rt);
     if (xc) setCsrfToken(xc);
   }
-  function refreshTokens() {
+  function refreshTokens(opts) {
+    if (opts?.tenantId) {
+      return refreshTokensInternal(opts).finally(() => {
+      });
+    }
     if (refreshPromise) return refreshPromise;
     refreshPromise = refreshTokensInternal().finally(() => {
       refreshPromise = null;
@@ -303,7 +311,7 @@ function createAccessClient(config, appContext) {
     getRefreshToken,
     setCsrfToken,
     getCsrfToken,
-    refreshSession: refreshTokens
+    refreshSession: (opts) => refreshTokens(opts)
   };
 }
 
@@ -726,6 +734,14 @@ function AziridProviderInner({
       throw err;
     }
   }, [client, queryClient, props, updateAccessToken, clearSession]);
+  const switchTenantFn = react.useCallback(
+    async (tenantId) => {
+      await client.refreshSession({ tenantId });
+      updateAccessToken(client.getAccessToken());
+      await queryClient.invalidateQueries({ queryKey: ["azirid-access"] });
+    },
+    [client, queryClient, updateAccessToken]
+  );
   const login = react.useCallback(
     (data) => loginMutation.mutate(data),
     [loginMutation]
@@ -748,6 +764,7 @@ function AziridProviderInner({
       logout,
       clearError,
       refresh: refreshFn,
+      switchTenant: switchTenantFn,
       setUser: setUserFn,
       isLoginPending: loginMutation.isPending,
       isSignupPending: signupMutation.isPending,
@@ -765,6 +782,7 @@ function AziridProviderInner({
       logout,
       clearError,
       refreshFn,
+      switchTenantFn,
       setUserFn,
       loginMutation,
       signupMutation,
@@ -2548,7 +2566,7 @@ function TransferModal2({
   const bankDetails = data.bankDetails;
   const plan = data.plan;
   const intent = data.intent;
-  const displayAmount = plan ? formatAmount2(plan.amount, plan.currency) : intent ? formatAmount2(intent.amount * 100, intent.currency) : "";
+  const displayAmount = plan ? formatAmount2(plan.amount, plan.currency) : intent ? formatAmount2(intent.amount, intent.currency) : "";
   return /* @__PURE__ */ jsxRuntime.jsx("div", { style: modalStyles.overlay, onClick: onClose, children: /* @__PURE__ */ jsxRuntime.jsxs("div", { style: modalStyles.card, onClick: (e) => e.stopPropagation(), children: [
     /* @__PURE__ */ jsxRuntime.jsx("h2", { style: modalStyles.title, children: labels?.bankTransfer ?? "Bank Transfer" }),
     displayAmount && /* @__PURE__ */ jsxRuntime.jsxs(
@@ -3214,6 +3232,31 @@ function useTransferProofs() {
     queryFn: () => client.get(client.paths.transferProofs)
   });
 }
+function useTenants() {
+  const client = useAccessClient();
+  return reactQuery.useQuery({
+    queryKey: ["azirid-access", "tenants"],
+    queryFn: () => client.get(client.paths.userTenants),
+    enabled: !!client.getAccessToken()
+  });
+}
+function useTenantMembers(tenantId) {
+  const client = useAccessClient();
+  return reactQuery.useQuery({
+    queryKey: ["azirid-access", "tenants", tenantId, "members"],
+    queryFn: () => client.get(`${client.paths.userTenants}/${tenantId}/members`),
+    enabled: !!client.getAccessToken() && !!tenantId
+  });
+}
+function useSwitchTenant() {
+  const client = useAccessClient();
+  const queryClient = reactQuery.useQueryClient();
+  const switchTenant = async (tenantId) => {
+    await client.refreshSession({ tenantId });
+    await queryClient.invalidateQueries({ queryKey: ["azirid-access"] });
+  };
+  return { switchTenant };
+}
 function zodToFieldErrors(zodError) {
   return zodError.issues.map((issue) => ({
     field: issue.path.join("."),
@@ -3270,7 +3313,7 @@ function usePasswordToggle() {
 }
 
 // src/index.ts
-var SDK_VERSION = "0.6.0";
+var SDK_VERSION = "0.7.0";
 
 exports.AziridProvider = AziridProvider;
 exports.BASE_PATHS = BASE_PATHS;
@@ -3328,6 +3371,9 @@ exports.useSignup = useSignup;
 exports.useSocialLogin = useSocialLogin;
 exports.useSubmitTransferProof = useSubmitTransferProof;
 exports.useSubscription = useSubscription;
+exports.useSwitchTenant = useSwitchTenant;
+exports.useTenantMembers = useTenantMembers;
+exports.useTenants = useTenants;
 exports.useTransferProofs = useTransferProofs;
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map