@capxul/sdk-react 0.1.0-alpha.9 → 0.2.0-alpha.3

package/dist/index.cjs

@@ -12,6 +12,22 @@ var viem = require('viem');
 var accounts = require('viem/accounts');
 
 // src/provider.tsx
+var AuthServiceContext = react.createContext(null);
+function AuthServiceProvider({
+  authService,
+  children
+}) {
+  return /* @__PURE__ */ jsxRuntime.jsx(AuthServiceContext.Provider, { value: authService, children });
+}
+function useAuthService() {
+  const authService = react.useContext(AuthServiceContext);
+  if (!authService) {
+    throw new Error(
+      "useAuthService() was called outside a <CapxulProvider>. Wrap your app in <CapxulProvider config={...}> before rendering hooks from @capxul/sdk-react."
+    );
+  }
+  return authService;
+}
 var CapxulClientContext = react.createContext(null);
 function CapxulClientProvider({
   client,
@@ -81,10 +97,16 @@ var Errors = {
     `Shield API error (${status}): ${detail}`,
     { details: { provider: "shield", status } }
   ),
-  providerError: (provider, operation, cause) => new CapxulError(
-    "PROVIDER_ERROR",
-    `${provider} ${operation} failed: ${cause instanceof Error ? cause.message : String(cause)}`,
-    { cause, details: { provider, operation } }
+  providerError: (provider, operation, cause) => (
+    // Public `message` is redacted to a fixed shape so provider-side
+    // exception text never leaks to the client. The original `cause`
+    // is preserved on `Error.cause` for server-side debugging via
+    // observability sinks (Sentry, console traces).
+    new CapxulError(
+      "PROVIDER_ERROR",
+      `Provider error: ${provider} ${operation}`,
+      { cause, details: { provider, operation } }
+    )
   ),
   invalidInput: (field, reason) => new CapxulError(
     "INVALID_INPUT",
@@ -149,7 +171,7 @@ function roleKeyFromLabel(label) {
 }
 roleKeyFromLabel("OWNER");
 roleKeyFromLabel("FINANCE_MANAGER");
-roleKeyFromLabel("TEAM_LEAD");
+roleKeyFromLabel("PAYMENTS_OPERATOR");
 
 // src/config.ts
 function createCapxulConfig(input) {
@@ -288,7 +310,7 @@ function CapxulProvider({
     []
   );
   const effectiveClient = queryClient ?? defaultClient;
-  return /* @__PURE__ */ jsxRuntime.jsx(reactQuery.QueryClientProvider, { client: effectiveClient, children: /* @__PURE__ */ jsxRuntime.jsx(CapxulTransportProvider, { transport: wiring.transport, children: /* @__PURE__ */ jsxRuntime.jsx(CapxulClientProvider, { client: wiring.client, children }) }) });
+  return /* @__PURE__ */ jsxRuntime.jsx(reactQuery.QueryClientProvider, { client: effectiveClient, children: /* @__PURE__ */ jsxRuntime.jsx(CapxulTransportProvider, { transport: wiring.transport, children: /* @__PURE__ */ jsxRuntime.jsx(CapxulClientProvider, { client: wiring.client, children: /* @__PURE__ */ jsxRuntime.jsx(AuthServiceProvider, { authService: wiring.authService, children }) }) }) });
 }
 function buildWiring(config, sessionStore) {
   const validated = createCapxulConfig(config);
@@ -297,7 +319,7 @@ function buildWiring(config, sessionStore) {
   const sdkConfig = {
     _transport: transport,
     publishableKey: validated.mode === "publishable-key" ? validated.publishableKey : void 0,
-    data: dataClient ?? void 0,
+    _data: dataClient ?? void 0,
     auth: validated.mode === "build-time-urls" || validated.mode === "publishable-key" ? {
       // The auth client builds the BetterAuth root URL from this
       // value. Convex's `.cloud` URL is the wrong host (BetterAuth
@@ -307,29 +329,16 @@ function buildWiring(config, sessionStore) {
       // `core/auth.ts`'s `createTransportProvider` short-circuits
       // to the externally-injected `_transport` cache slot.
       baseUrl: transport.authBaseUrl,
-      sessionStore,
-      createDataClient: async (_session) => {
-        dataClient.refreshAuth();
-        return dataClient;
-      }
+      sessionStore
     } : void 0
   };
   const client = sdk.createCapxulClient(sdkConfig);
-  if (dataClient) {
-    const originalSignOut = client.auth.signOut;
-    Object.assign(client.auth, {
-      signOut: async () => {
-        const result = await originalSignOut();
-        dataClient.refreshAuth();
-        sdkConfig.data = dataClient;
-        return result;
-      }
-    });
-  }
+  const authService = new sdk.AuthService(sdkConfig);
   return {
     client,
     transport,
-    dataClient
+    dataClient,
+    authService
   };
 }
 function createMemorySessionStore() {
@@ -438,11 +447,59 @@ function useAccount(accountId) {
     [capxul, accountId]
   );
 }
-function useOrganization(_organizationId) {
-  return notImplementedQuery("useOrganization");
+function useOrganization(organizationId) {
+  const capxul = useCapxul();
+  return reactQuery.useQuery({
+    queryKey: [capxul.id, "capxul", "organizations", organizationId],
+    queryFn: () => capxul.organizations.retrieve(organizationId).then(([error, data]) => {
+      if (error) {
+        throw error;
+      }
+      return data;
+    }).catch((cause) => {
+      if (cause instanceof sdk.CapxulError) {
+        throw cause;
+      }
+      throw new sdk.CapxulError({
+        code: "UNKNOWN",
+        message: "SDK read failed before returning a CapxulResult.",
+        cause
+      });
+    }),
+    staleTime: 3e4
+  });
 }
-function useMember(_args) {
-  return notImplementedQuery("useMember");
+function useMember(args) {
+  const capxul = useCapxul();
+  return reactQuery.useQuery({
+    queryKey: [
+      capxul.id,
+      "capxul",
+      "organizations",
+      args.organizationId,
+      "members",
+      args.memberId
+    ],
+    queryFn: () => capxul.organizations.members.retrieve({
+      organizationId: args.organizationId,
+      memberId: args.memberId
+    }).then(([error, data]) => {
+      if (error) {
+        throw error;
+      }
+      return data;
+    }).catch((cause) => {
+      if (cause instanceof sdk.CapxulError) {
+        throw cause;
+      }
+      throw new sdk.CapxulError({
+        code: "UNKNOWN",
+        message: "SDK read failed before returning a CapxulResult.",
+        cause
+      });
+    }),
+    staleTime: 3e4
+  });
 }
 function useSafe(safeId) {
   const capxul = useCapxul();
@@ -451,8 +508,33 @@ function useSafe(safeId) {
     [capxul, safeId]
   );
 }
-function useTreasury(_organizationId) {
-  return notImplementedQuery("useTreasury");
+function useTreasury(organizationId) {
+  const capxul = useCapxul();
+  return reactQuery.useQuery({
+    queryKey: [
+      capxul.id,
+      "capxul",
+      "organizations",
+      organizationId,
+      "treasury"
+    ],
+    queryFn: () => capxul.organizations.treasury.retrieve(organizationId).then(([error, data]) => {
+      if (error) {
+        throw error;
+      }
+      return data;
+    }).catch((cause) => {
+      if (cause instanceof sdk.CapxulError) {
+        throw cause;
+      }
+      throw new sdk.CapxulError({
+        code: "UNKNOWN",
+        message: "SDK read failed before returning a CapxulResult.",
+        cause
+      });
+    }),
+    staleTime: 3e4
+  });
 }
 function useApiKey(_args) {
   return notImplementedQuery("useApiKey");
@@ -460,9 +542,6 @@ function useApiKey(_args) {
 function useKycProfile(_accountId) {
   return notImplementedQuery("useKycProfile");
 }
-function useKybProfile(_organizationId) {
-  return notImplementedQuery("useKybProfile");
-}
 function useExternalAccount(args) {
   const capxul = useCapxul();
   return useSdkQuery(
@@ -473,8 +552,12 @@ function useExternalAccount(args) {
     [capxul, args.ownerKind, args.ownerId, args.externalAccountId]
   );
 }
-function useSubAccount(_subAccountId) {
-  return notImplementedQuery("useSubAccount");
+function useSubAccount(subAccountId) {
+  const capxul = useCapxul();
+  return useSdkQuery(
+    () => capxul.subAccounts.retrieve(subAccountId),
+    [capxul, subAccountId]
+  );
 }
 function useVirtualAccount(_virtualAccountId) {
   return notImplementedQuery("useVirtualAccount");
@@ -482,8 +565,27 @@ function useVirtualAccount(_virtualAccountId) {
 function useVirtualCard(_virtualCardId) {
   return notImplementedQuery("useVirtualCard");
 }
-function usePayment(_paymentId) {
-  return notImplementedQuery("usePayment");
+function usePayment(paymentId) {
+  const capxul = useCapxul();
+  return reactQuery.useQuery({
+    queryKey: [capxul.id, "capxul", "payments", paymentId],
+    queryFn: () => capxul.payments.retrieve(paymentId).then(([error, data]) => {
+      if (error) {
+        throw error;
+      }
+      return data;
+    }).catch((cause) => {
+      if (cause instanceof sdk.CapxulError) {
+        throw cause;
+      }
+      throw new sdk.CapxulError({
+        code: "UNKNOWN",
+        message: "SDK read failed before returning a CapxulResult.",
+        cause
+      });
+    }),
+    staleTime: 3e4
+  });
 }
 function useTransfer(_transferId) {
   return notImplementedQuery("useTransfer");
@@ -495,25 +597,32 @@ function useTokenTransfer(args) {
     [capxul, args.txHash, args.logIndex, args.chainId]
   );
 }
-function useBalanceLedgerEntry(_args) {
-  return notImplementedQuery("useBalanceLedgerEntry");
+function useBalanceLedgerEntry(args) {
+  const capxul = useCapxul();
+  return useSdkQuery(
+    () => args.ownerKind === "account" ? capxul.accounts.balanceLedger.retrieve(args.entryId) : capxul.organizations.balanceLedger.retrieve({
+      organizationId: args.ownerId,
+      entryId: args.entryId
+    }),
+    [capxul, args.ownerKind, args.ownerId, args.entryId]
+  );
 }
 function useDocument(_documentId) {
   return notImplementedQuery("useDocument");
 }
 function useWithdrawal(withdrawalId) {
   const capxul = useCapxul();
-  return useSdkQuery(() => capxul.withdrawals.retrieve(withdrawalId), [
-    capxul,
-    withdrawalId
-  ]);
+  return useSdkQuery(
+    () => capxul.withdrawals.retrieve(withdrawalId),
+    [capxul, withdrawalId]
+  );
 }
 function useOperation(operationId) {
   const capxul = useCapxul();
-  return useSdkQuery(() => capxul.operations.retrieve(operationId), [
-    capxul,
-    operationId
-  ]);
+  return useSdkQuery(
+    () => capxul.operations.retrieve(operationId),
+    [capxul, operationId]
+  );
 }
 function useWebhookEndpoint(_endpointId) {
   return notImplementedQuery("useWebhookEndpoint");
@@ -521,13 +630,57 @@ function useWebhookEndpoint(_endpointId) {
 function useWebhookEvent(_eventId) {
   return notImplementedQuery("useWebhookEvent");
 }
-
-// src/hooks/list.ts
-function useOrganizations() {
-  return notImplementedQuery("useOrganizations");
+function useOrganizations(filters) {
+  const capxul = useCapxul();
+  return reactQuery.useQuery({
+    queryKey: [capxul.id, "capxul", "organizations", "list", filters],
+    queryFn: () => capxul.organizations.list(filters).then(([error, data]) => {
+      if (error) {
+        throw error;
+      }
+      return data;
+    }).catch((cause) => {
+      if (cause instanceof sdk.CapxulError) {
+        throw cause;
+      }
+      throw new sdk.CapxulError({
+        code: "UNKNOWN",
+        message: "SDK read failed before returning a CapxulResult.",
+        cause
+      });
+    }),
+    staleTime: 3e4
+  });
 }
-function useMembers(_organizationId) {
-  return notImplementedQuery("useMembers");
+function useMembers(organizationId, filters) {
+  const capxul = useCapxul();
+  return reactQuery.useQuery({
+    queryKey: [
+      capxul.id,
+      "capxul",
+      "organizations",
+      organizationId,
+      "members",
+      "list",
+      filters?.status
+    ],
+    queryFn: () => capxul.organizations.members.list({ organizationId, status: filters?.status }).then(([error, data]) => {
+      if (error) {
+        throw error;
+      }
+      return data;
+    }).catch((cause) => {
+      if (cause instanceof sdk.CapxulError) {
+        throw cause;
+      }
+      throw new sdk.CapxulError({
+        code: "UNKNOWN",
+        message: "SDK read failed before returning a CapxulResult.",
+        cause
+      });
+    }),
+    staleTime: 3e4
+  });
 }
 function useExternalAccounts(args) {
   const capxul = useCapxul();
@@ -538,8 +691,14 @@ function useExternalAccounts(args) {
     [capxul, args.ownerKind, args.ownerId]
   );
 }
-function useSubAccounts(_args) {
-  return notImplementedQuery("useSubAccounts");
+function useSubAccounts(args) {
+  const capxul = useCapxul();
+  return useSdkQuery(
+    () => args.ownerKind === "account" ? capxul.accounts.subAccounts.list({ accountId: args.ownerId }) : capxul.organizations.subAccounts.list({
+      organizationId: args.ownerId
+    }),
+    [capxul, args.ownerKind, args.ownerId]
+  );
 }
 function useVirtualAccounts(_filters) {
   return notImplementedQuery("useVirtualAccounts");
@@ -547,8 +706,27 @@ function useVirtualAccounts(_filters) {
 function useVirtualCards(_filters) {
   return notImplementedQuery("useVirtualCards");
 }
-function usePayments(_filters) {
-  return notImplementedQuery("usePayments");
+function usePayments(filters) {
+  const capxul = useCapxul();
+  return reactQuery.useQuery({
+    queryKey: [capxul.id, "capxul", "payments", "list", filters],
+    queryFn: () => capxul.payments.list(filters).then(([error, data]) => {
+      if (error) {
+        throw error;
+      }
+      return data;
+    }).catch((cause) => {
+      if (cause instanceof sdk.CapxulError) {
+        throw cause;
+      }
+      throw new sdk.CapxulError({
+        code: "UNKNOWN",
+        message: "SDK read failed before returning a CapxulResult.",
+        cause
+      });
+    }),
+    staleTime: 3e4
+  });
 }
 function useOrgPayments(_args) {
   return notImplementedQuery("useOrgPayments");
@@ -566,8 +744,34 @@ function useTokenTransfers(filters) {
     [capxul, filters?.limit, filters?.cursor, filters?.direction]
   );
 }
-function useBalanceLedger(_args) {
-  return notImplementedQuery("useBalanceLedger");
+function useBalanceLedger(args) {
+  const capxul = useCapxul();
+  return useSdkQuery(
+    () => args.ownerKind === "account" ? capxul.accounts.balanceLedger.list({
+      accountId: args.ownerId,
+      limit: args.limit,
+      cursor: args.cursor
+    }) : capxul.organizations.balanceLedger.list({
+      organizationId: args.ownerId,
+      limit: args.limit,
+      cursor: args.cursor
+    }),
+    [capxul, args.ownerKind, args.ownerId, args.limit, args.cursor]
+  );
+}
+function useAccountBalanceLedger(accountId, filters) {
+  const capxul = useCapxul();
+  return useSdkQuery(
+    () => capxul.accounts.balanceLedger.list({ accountId, ...filters }),
+    [capxul, accountId, filters?.limit, filters?.cursor]
+  );
+}
+function useOrgBalanceLedger(args) {
+  const capxul = useCapxul();
+  return useSdkQuery(
+    () => capxul.organizations.balanceLedger.list(args),
+    [capxul, args.organizationId, args.limit, args.cursor]
+  );
 }
 function useDocuments(_filters) {
   return notImplementedQuery("useDocuments");
@@ -595,6 +799,182 @@ function useApiKeys(_organizationId) {
 function useWebhookEndpoints() {
   return notImplementedQuery("useWebhookEndpoints");
 }
+function useInviteMember() {
+  const capxul = useCapxul();
+  return reactQuery.useMutation({
+    mutationFn: async (args) => {
+      const [error, data] = await capxul.organizations.members.invite(args);
+      if (error) throw error;
+      return data;
+    }
+  });
+}
+function useAcceptInvitation() {
+  const capxul = useCapxul();
+  return reactQuery.useMutation({
+    mutationFn: async (args) => {
+      const [error, data] = await capxul.organizations.members.accept(args);
+      if (error) throw error;
+      return data;
+    }
+  });
+}
+function useUpdateMemberRole() {
+  const capxul = useCapxul();
+  return reactQuery.useMutation({
+    mutationFn: async (args) => {
+      const [error, data] = await capxul.organizations.members.updateRole(args);
+      if (error) throw error;
+      return data;
+    }
+  });
+}
+function useRevokeMember() {
+  const capxul = useCapxul();
+  return reactQuery.useMutation({
+    mutationFn: async (args) => {
+      const [error, data] = await capxul.organizations.members.revoke(args);
+      if (error) throw error;
+      return data;
+    }
+  });
+}
+function useRemoveMember() {
+  const capxul = useCapxul();
+  return reactQuery.useMutation({
+    mutationFn: async (args) => {
+      const [error, data] = await capxul.organizations.members.remove(args);
+      if (error) throw error;
+      return data;
+    }
+  });
+}
+function useResendInvitation() {
+  const capxul = useCapxul();
+  return reactQuery.useMutation({
+    mutationFn: async (args) => {
+      const [error, data] = await capxul.organizations.members.resend(args);
+      if (error) throw error;
+      return data;
+    }
+  });
+}
+function useAuth(options) {
+  const authService = useAuthService();
+  const signerProvisioner = useMemoizedSignerProvisioner();
+  const injectedSigner = options?.signer;
+  const [state, setState] = react.useState("idle");
+  const [user, setUser] = react.useState(null);
+  const [error, setError] = react.useState(null);
+  const signIn = react.useCallback(
+    async (email) => {
+      setState("sendingOtp");
+      setError(null);
+      try {
+        await authService.sendOtp(email);
+        setState("awaitingOtp");
+      } catch (err) {
+        const wrapped = err instanceof Error ? err : new Error(String(err));
+        setError(wrapped);
+        setState("error");
+        throw wrapped;
+      }
+    },
+    [authService]
+  );
+  const verifyOtp = react.useCallback(
+    async (email, otp) => {
+      setState("awaitingOtp");
+      setError(null);
+      try {
+        const result = await authService.verifyOtp(email, otp);
+        if (result.kind === "existing_member") {
+          const nextUser2 = {
+            account: result.account,
+            username: result.username,
+            safe: result.safe,
+            session: result.session
+          };
+          setUser(nextUser2);
+          setState("authenticated");
+          return result.session;
+        }
+        setState("bootstrapping");
+        const signer = injectedSigner ?? signerProvisioner.provision().signer;
+        const username = result.username ?? generateUsernameFromEmail(result.email);
+        const bootstrapResult = await authService.completeBootstrap(
+          {
+            bootstrapToken: result.bootstrapToken,
+            username
+          },
+          signer
+        );
+        const nextUser = {
+          account: bootstrapResult.account,
+          username: bootstrapResult.username,
+          safe: bootstrapResult.safe,
+          session: bootstrapResult.session
+        };
+        setUser(nextUser);
+        setState("authenticated");
+        return bootstrapResult.session;
+      } catch (err) {
+        const wrapped = err instanceof Error ? err : new Error(String(err));
+        setError(wrapped);
+        setState("error");
+        throw wrapped;
+      }
+    },
+    [authService, signerProvisioner, injectedSigner]
+  );
+  const signOut = react.useCallback(async () => {
+    setError(null);
+    try {
+      await authService.signOut();
+      setUser(null);
+      setState("idle");
+    } catch (err) {
+      const wrapped = err instanceof Error ? err : new Error(String(err));
+      setError(wrapped);
+      setState("error");
+      throw wrapped;
+    }
+  }, [authService]);
+  return react.useMemo(
+    () => ({
+      state,
+      user,
+      error,
+      signIn,
+      verifyOtp,
+      signOut
+    }),
+    [state, user, error, signIn, verifyOtp, signOut]
+  );
+}
+function useMemoizedSignerProvisioner() {
+  const [provisioner] = react.useState(() => new sdk.SignerProvisioner());
+  return provisioner;
+}
+function generateUsernameFromEmail(email) {
+  const local = email.split("@")[0]?.toLowerCase() ?? "user";
+  let sanitized = local.replace(/[^a-z0-9_-]/g, "_");
+  if (/^[0-9]/.test(sanitized)) {
+    sanitized = "u" + sanitized;
+  }
+  if (sanitized.length < 3) {
+    sanitized = sanitized + "_".repeat(3 - sanitized.length);
+  }
+  if (sanitized.length > 30) {
+    sanitized = sanitized.slice(0, 30);
+  }
+  try {
+    return sdk.toUsername(sanitized);
+  } catch {
+    const fallback = `user_${Date.now() % 1e6}`;
+    return sdk.toUsername(fallback);
+  }
+}
 function useAuthFlow() {
   const client = useCapxul();
   const machine = react.useMemo(() => client.flows.auth(), [client]);
@@ -660,10 +1040,6 @@ function localPrivateKeyConnector(options) {
       "must be a 0x-prefixed 32-byte (64 hex chars) string."
     );
   }
-  const safeAddress = validateAndNormalizeEvmAddress(
-    "safeAddress",
-    options.safeAddress
-  );
   const id = options.id ?? "local-private-key";
   return {
     id,
@@ -675,13 +1051,7 @@ function localPrivateKeyConnector(options) {
       return {
         connectorId: id,
         connectorKind: "local-private-key",
-        signerAddress: account.address,
-        safeAddress,
-        signerProvider: {
-          kind: "local-private-key",
-          signerAddress: account.address,
-          safeAddress
-        }
+        signerAddress: account.address
       };
     }
   };
@@ -721,9 +1091,12 @@ exports.CapxulTransportProvider = CapxulTransportProvider;
 exports.createCapxulConfig = createCapxulConfig;
 exports.injectedConnector = injectedConnector;
 exports.localPrivateKeyConnector = localPrivateKeyConnector;
+exports.useAcceptInvitation = useAcceptInvitation;
 exports.useAccount = useAccount;
+exports.useAccountBalanceLedger = useAccountBalanceLedger;
 exports.useApiKey = useApiKey;
 exports.useApiKeys = useApiKeys;
+exports.useAuth = useAuth;
 exports.useAuthBootstrapFlow = useAuthBootstrapFlow;
 exports.useAuthFlow = useAuthFlow;
 exports.useBalanceLedger = useBalanceLedger;
@@ -734,13 +1107,14 @@ exports.useDocument = useDocument;
 exports.useDocuments = useDocuments;
 exports.useExternalAccount = useExternalAccount;
 exports.useExternalAccounts = useExternalAccounts;
-exports.useKybProfile = useKybProfile;
+exports.useInviteMember = useInviteMember;
 exports.useKycProfile = useKycProfile;
 exports.useMe = useMe;
 exports.useMember = useMember;
 exports.useMembers = useMembers;
 exports.useOnboardingFlow = useOnboardingFlow;
 exports.useOperation = useOperation;
+exports.useOrgBalanceLedger = useOrgBalanceLedger;
 exports.useOrgDocuments = useOrgDocuments;
 exports.useOrgPayments = useOrgPayments;
 exports.useOrgTransfers = useOrgTransfers;
@@ -750,6 +1124,9 @@ exports.useOrganizations = useOrganizations;
 exports.usePayment = usePayment;
 exports.usePayments = usePayments;
 exports.useProvisioningFlow = useProvisioningFlow;
+exports.useRemoveMember = useRemoveMember;
+exports.useResendInvitation = useResendInvitation;
+exports.useRevokeMember = useRevokeMember;
 exports.useSafe = useSafe;
 exports.useSubAccount = useSubAccount;
 exports.useSubAccounts = useSubAccounts;
@@ -758,6 +1135,7 @@ exports.useTokenTransfers = useTokenTransfers;
 exports.useTransfer = useTransfer;
 exports.useTransfers = useTransfers;
 exports.useTreasury = useTreasury;
+exports.useUpdateMemberRole = useUpdateMemberRole;
 exports.useVirtualAccount = useVirtualAccount;
 exports.useVirtualAccounts = useVirtualAccounts;
 exports.useVirtualCard = useVirtualCard;