azirid-react 0.11.0 → 0.11.2

package/README.md

@@ -60,10 +60,10 @@ Requests go directly to the Azirid API. Requires CORS to be configured on the AP
 
 ```ts
 // app/api/auth/[...path]/route.ts
-export { GET, POST, PUT, PATCH, DELETE } from 'azirid-react/next'
+export { GET, POST, PUT, PATCH, DELETE } from 'azirid-react/next/handlers'
 ```
 
-That's it. The SDK handles proxy logic, cookie fixing, and header forwarding internally. Works with Next.js 14, 15, and 16+ automatically.
+That's it. The SDK handles proxy logic, cookie fixing, and header forwarding internally. Works with Next.js 14, 15, and 16+ automatically — including `output: 'standalone'` builds.
 
 ### 2. Set the API URL (optional)
 
@@ -266,6 +266,23 @@ function Navbar() {
 }
 ```
 
+> **`isLoading`** is `true` during session bootstrap (page load/refresh), login, and signup. Use it to show a loading state and prevent rendering authenticated UI before the session is ready. This ensures no API calls are made without a valid token.
+
+#### Auth Guard pattern (Next.js)
+
+```tsx
+import { useAzirid } from 'azirid-react'
+
+function AuthGuard({ children }: { children: React.ReactNode }) {
+  const { isAuthenticated, isLoading } = useAzirid()
+
+  if (isLoading) return <LoadingSpinner />
+  if (!isAuthenticated) return <RedirectToLogin />
+
+  return <>{children}</>
+}
+```
+
 ### `useLogin`
 
 ```tsx
@@ -376,7 +393,7 @@ import { useBootstrap } from 'azirid-react'
 const { bootstrap, isBootstrapping } = useBootstrap()
 ```
 
-> **Note:** The automatic bootstrap uses request deduplication — if React 18 Strict Mode (or any other scenario) triggers multiple bootstrap calls, only **one HTTP request** is made and all callers await the same promise. This prevents token rotation conflicts that would otherwise invalidate the session on page reload in development mode. Hooks like `usePayphoneCheckout` and `<PayphoneCallback>` wait for bootstrap to complete before making authenticated requests.
+> **Note:** The automatic bootstrap uses request deduplication — if React 18 Strict Mode (or any other scenario) triggers multiple bootstrap calls, only **one HTTP request** is made and all callers await the same promise. This prevents token rotation conflicts that would otherwise invalidate the session on page reload in development mode. During bootstrap, `isLoading` from `useAzirid()` is `true`, so components using the Auth Guard pattern will show a loading state until the session is restored. Hooks like `usePayphoneCheckout`, `useSession`, and `<PayphoneCallback>` also wait for bootstrap to complete before making authenticated requests.
 
 ### `useRefresh`
 
@@ -1373,17 +1390,17 @@ Create the file `app/api/auth/[...path]/route.ts` — one line is all you need:
 
 ```ts
 // app/api/auth/[...path]/route.ts
-export { GET, POST, PUT, PATCH, DELETE } from 'azirid-react/next'
+export { GET, POST, PUT, PATCH, DELETE } from 'azirid-react/next/handlers'
 ```
 
 That's it. The SDK handles all the proxy logic, cookie fixing, and header forwarding internally.
-It works with Next.js 14, 15, and 16+ automatically.
+It works with Next.js 14, 15, and 16+ automatically — including `output: 'standalone'` builds.
 
 ### Custom API URL or debug logging
 
 ```ts
 // app/api/auth/[...path]/route.ts
-import { createAziridRouteHandlers } from 'azirid-react/next'
+import { createAziridRouteHandlers } from 'azirid-react/next/handlers'
 
 export const { GET, POST, PUT, PATCH, DELETE } = createAziridRouteHandlers({
   apiUrl: 'https://my-custom-api.com',
@@ -1439,7 +1456,7 @@ module.exports = withAziridProxy()({
 
 ```ts
 // proxy.ts — only needed if you want route protection
-import { createAziridProxy } from 'azirid-react/next'
+import { createAziridProxy } from 'azirid-react/next/proxy'
 
 export const proxy = createAziridProxy({
   protectedRoutes: ['/dashboard', '/settings'],
@@ -1456,7 +1473,7 @@ export const config = {
 
 ```ts
 // middleware.ts — only needed if you want route protection
-import { createAziridMiddleware } from 'azirid-react/next'
+import { createAziridMiddleware } from 'azirid-react/next/proxy'
 
 export default createAziridMiddleware({
   protectedRoutes: ['/dashboard', '/settings'],

package/dist/index.cjs

@@ -127,7 +127,9 @@ var SUFFIXES = {
   passwordResetConfirm: "password/reset/confirm",
   referralMe: "referrals/me",
   referralStats: "referrals/stats",
-  userTenants: "tenants"
+  userTenants: "tenants",
+  branches: "branches",
+  paymentMethods: "payment-methods"
 };
 var BASE_PATHS = {
   /** Proxy mode (Next.js): requests go to the same origin via route handler */
@@ -911,7 +913,7 @@ function AziridProviderInner({
       user,
       accessToken,
       isAuthenticated: user !== null,
-      isLoading: loginMutation.isPending || signupMutation.isPending,
+      isLoading: isBootstrapping || loginMutation.isPending || signupMutation.isPending,
       error,
       login,
       signup,
@@ -3012,6 +3014,8 @@ var PP_CONTAINER_ID = "pp-paybtn-azirid";
 function usePayButton({
   intentId,
   planId,
+  branchId,
+  merchantAccountId,
   onSuccess,
   onError
 }) {
@@ -3076,12 +3080,14 @@ function usePayButton({
       doCheckout({
         intentId,
         planId,
+        branchId,
+        merchantAccountId,
         provider,
         successUrl: currentUrl,
         cancelUrl: currentUrl
       });
     },
-    [doCheckout, intentId, planId]
+    [doCheckout, intentId, planId, branchId, merchantAccountId]
   );
   const { mutate: confirmPayphone } = usePayphoneConfirm({
     onSuccess: (data) => {
@@ -3784,6 +3790,8 @@ function TransferModal2({ data, onClose, onProofSubmitted, labels }) {
 function PayButton({
   planId,
   intentId,
+  branchId,
+  merchantAccountId,
   successUrl,
   cancelUrl,
   className,
@@ -3809,6 +3817,8 @@ function PayButton({
   } = usePayButton({
     intentId,
     planId,
+    branchId,
+    merchantAccountId,
     onSuccess: (data) => {
       if (data.provider === "MANUAL_TRANSFER") {
         setShowTransferModal(true);
@@ -4189,11 +4199,13 @@ function useLogout(options) {
 }
 function useSession(options) {
   const client = useAccessClient();
+  const { isBootstrapping } = useAzirid();
   const query = reactQuery.useQuery({
     queryKey: ["azirid-access", "session"],
     queryFn: () => client.get(client.paths.me),
     retry: false,
-    enabled: options?.enabled ?? true,
+    // Wait for bootstrap to complete before fetching /me
+    enabled: (options?.enabled ?? true) && !isBootstrapping,
     refetchInterval: options?.refetchInterval,
     refetchOnWindowFocus: options?.refetchOnWindowFocus ?? false
   });
@@ -4627,6 +4639,21 @@ function useTransferPayment({
     error: currentError
   };
 }
+function useBranches() {
+  const client = useAccessClient();
+  return reactQuery.useQuery({
+    queryKey: ["azirid-access", "branches"],
+    queryFn: () => client.get(client.paths.branches)
+  });
+}
+function usePaymentMethods(branchId) {
+  const client = useAccessClient();
+  const path = branchId ? `${client.paths.paymentMethods}?branchId=${encodeURIComponent(branchId)}` : client.paths.paymentMethods;
+  return reactQuery.useQuery({
+    queryKey: ["azirid-access", "payment-methods", branchId ?? null],
+    queryFn: () => client.get(path)
+  });
+}
 function useTenants() {
   const client = useAccessClient();
   return reactQuery.useQuery({
@@ -4719,7 +4746,7 @@ function usePasswordToggle() {
 }
 
 // src/index.ts
-var SDK_VERSION = "0.11.0";
+var SDK_VERSION = "0.11.2";
 
 exports.AuthForm = AuthForm;
 exports.AziridProvider = AziridProvider;
@@ -4764,6 +4791,7 @@ exports.socialLoginSchema = socialLoginSchema;
 exports.useAccessClient = useAccessClient;
 exports.useAzirid = useAzirid;
 exports.useBootstrap = useBootstrap;
+exports.useBranches = useBranches;
 exports.useBranding = useBranding;
 exports.useChangePassword = useChangePassword;
 exports.useCheckout = useCheckout;
@@ -4777,6 +4805,7 @@ exports.usePasskeys = usePasskeys;
 exports.usePasswordReset = usePasswordReset;
 exports.usePasswordToggle = usePasswordToggle;
 exports.usePayButton = usePayButton;
+exports.usePaymentMethods = usePaymentMethods;
 exports.usePaymentProviders = usePaymentProviders;
 exports.usePayphoneCheckout = usePayphoneCheckout;
 exports.usePayphoneConfirm = usePayphoneConfirm;