@capxul/sdk-react 1.0.0-alpha.9 → 1.2.0

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../src/internal/capxul-bootstrap-context.tsx","../src/internal/capxul-client-context.tsx","../src/provider.tsx","../../errors/src/errors.ts","../../errors/src/convex-error-decoding.ts","../src/internal/require-bootstrapped-client.ts","../src/internal/reactivity-keys.ts","../src/internal/unwrap-capxul-result.ts","../src/hooks/use-capxul-session.ts","../src/hooks/use-capxul-profile.ts","../src/internal/is-vitest-runtime.ts","../src/internal/invalidate-auth-boundary.ts","../src/hooks/use-capxul-account-lifecycle.ts","../src/hooks/use-capxul-account-balance.ts","../src/hooks/use-capxul-account-fund.ts","../src/hooks/use-capxul-sign-in.ts","../src/hooks/use-capxul-verify-otp.ts","../src/hooks/use-capxul-sign-out.ts","../src/hooks/use-capxul-sub-accounts.ts","../src/hooks/use-capxul-orgs.ts","../src/hooks/use-capxul-org.ts","../src/hooks/use-capxul-org-members.ts","../src/hooks/use-capxul-org-roles.ts","../src/hooks/use-capxul-org-deploy-roles.ts","../src/hooks/use-capxul-org-treasury.ts","../src/hooks/use-capxul-create-org.ts","../src/hooks/use-capxul-complete-personal-onboarding.ts","../src/hooks/use-capxul-complete-organization-onboarding.ts","../src/hooks/use-capxul-invite-member.ts","../src/hooks/use-capxul-remove-member.ts","../src/hooks/use-capxul-assign-role.ts","../src/hooks/use-capxul-switch-acting-entity.ts"],"sourcesContent":["\"use client\";\n\n// Bootstrap-state context (SDK publish readiness · sdk-provider-owned-bootstrap).\n//\n// `<CapxulProvider>` runs the async client bootstrap and publishes its status\n// here. Consumers read it via `useCapxul()` for an opt-in splash / error / retry\n// surface. Data hooks do NOT need it — they sit in `isPending` until the client\n// resolves (see `useCapxulClientOrNull`).\n\nimport * as React from \"react\";\nimport { createContext, useContext, type ReactNode } from \"react\";\n\nimport type { CapxulError } from \"@capxul/errors\";\n\nexport type CapxulBootstrapStatus = \"bootstrapping\" | \"ready\" | \"error\";\n\nexport interface CapxulBootstrapState {\n  readonly status: CapxulBootstrapStatus;\n  readonly error: CapxulError | null;\n  readonly retry: () => void;\n}\n\nconst CapxulBootstrapContext = createContext<CapxulBootstrapState | null>(null);\n\nexport interface CapxulBootstrapProviderProps {\n  readonly value: CapxulBootstrapState;\n  readonly children: ReactNode;\n}\n\nexport function CapxulBootstrapProvider({ value, children }: CapxulBootstrapProviderProps) {\n  return (\n    <CapxulBootstrapContext.Provider value={value}>{children}</CapxulBootstrapContext.Provider>\n  );\n}\n\nexport function useCapxul(): CapxulBootstrapState {\n  const state = useContext(CapxulBootstrapContext);\n  if (state === null) {\n    throw new Error(\"useCapxul must be used within <CapxulProvider>\");\n  }\n  return state;\n}\n","\"use client\";\n\nimport * as React from \"react\";\nimport { createContext, useContext, type ReactNode } from \"react\";\n\nimport type { CapxulClient } from \"@capxul/sdk\";\n\nconst MISSING_CAPXUL_CLIENT_PROVIDER = Symbol(\"MISSING_CAPXUL_CLIENT_PROVIDER\");\n\nconst CapxulClientContext = createContext<\n  CapxulClient | null | typeof MISSING_CAPXUL_CLIENT_PROVIDER\n>(MISSING_CAPXUL_CLIENT_PROVIDER);\n\nexport interface CapxulClientProviderProps {\n  readonly client: CapxulClient | null;\n  readonly children: ReactNode;\n}\n\nexport function CapxulClientProvider({ client, children }: CapxulClientProviderProps) {\n  return <CapxulClientContext.Provider value={client}>{children}</CapxulClientContext.Provider>;\n}\n\nexport function useCapxulClient(): CapxulClient {\n  const client = useCapxulClientOrNull();\n  if (client === null) {\n    throw new Error(\"useCapxulClient called before <CapxulProvider> bootstrap resolved\");\n  }\n  return client;\n}\n\n/**\n * Returns the client, or `null` while `<CapxulProvider>` is still bootstrapping.\n * Data hooks use this so they can sit in `isPending` (disabled query) until the\n * client resolves, rather than throwing during bootstrap.\n */\nexport function useCapxulClientOrNull(): CapxulClient | null {\n  const client = useContext(CapxulClientContext);\n  if (client === MISSING_CAPXUL_CLIENT_PROVIDER) {\n    throw new Error(\"useCapxulClient must be used within <CapxulProvider>\");\n  }\n  return client;\n}\n","\"use client\";\n\n// CapxulProvider — owns the client lifecycle (sdk-provider-owned-bootstrap.md).\n//\n// Two modes:\n//   - `publishableKey` (browser/app): the provider runs the async bootstrap via\n//     `createCapxulClient`, owns the TanStack QueryClient, exposes status via\n//     `useCapxul()`, and closes the client on unmount / re-bootstrap.\n//   - `client` (Node/server consumers that bootstrap before React, plus test\n//     harnesses): a pre-built client is supplied; the provider is `ready`\n//     immediately and leaves that client's lifecycle to the caller.\n//\n// `signer` threads into the deploy lane via `createCapxulClient` when supplied.\n// Browser apps with `requirement: \"deployed\"` omit it — the SDK auto-wires Openfort.\n\nimport * as React from \"react\";\nimport { useCallback, useEffect, useMemo, useRef, useState } from \"react\";\nimport type { ReactNode } from \"react\";\nimport { QueryClient, QueryClientProvider } from \"@tanstack/react-query\";\n\nimport type { CapxulError } from \"@capxul/errors\";\nimport type { AccountRequirement, CapxulClient, CapxulSigner } from \"@capxul/sdk\";\nimport { createCapxulClient } from \"@capxul/sdk\";\n\nimport {\n  CapxulBootstrapProvider,\n  type CapxulBootstrapState,\n} from \"./internal/capxul-bootstrap-context\";\nimport { CapxulClientProvider } from \"./internal/capxul-client-context\";\n\nvoid React;\n\ntype CapxulProviderSharedProps = {\n  /** Bring your own QueryClient; otherwise the provider creates one. */\n  readonly queryClient?: QueryClient;\n  readonly children: ReactNode;\n};\n\n/** Browser / app path — the provider bootstraps the client from a publishable key. */\ntype CapxulProviderPublishableKeyProps = CapxulProviderSharedProps & {\n  readonly publishableKey: string;\n  readonly client?: never;\n  /** Init-time account readiness target. Default `\"none\"`. */\n  readonly requirement?: AccountRequirement;\n  /**\n   * Optional consumer-held signer for the deploy lane. Omitted in browser apps\n   * with `requirement: \"deployed\"` — the SDK wires Openfort from bootstrap.\n   */\n  readonly signer?: CapxulSigner;\n};\n\n/**\n * Node / server / test path — a pre-built client is supplied; lifecycle stays\n * with the caller. Mutually exclusive with `publishableKey`.\n */\ntype CapxulProviderInjectedClientProps = CapxulProviderSharedProps & {\n  readonly client: CapxulClient;\n  readonly publishableKey?: never;\n  readonly requirement?: never;\n  readonly signer?: never;\n};\n\nexport type CapxulProviderProps =\n  | CapxulProviderPublishableKeyProps\n  | CapxulProviderInjectedClientProps;\n\nfunction makeDefaultQueryClient(): QueryClient {\n  return new QueryClient({\n    defaultOptions: {\n      queries: { retry: 2, staleTime: 30_000 },\n      mutations: { retry: 0 },\n    },\n  });\n}\n\nfunction isCapxulQueryKey(queryKey: readonly unknown[]): boolean {\n  return queryKey[0] === \"capxul\";\n}\n\nfunction clearClientScopedQueries(queryClient: QueryClient, ownsQueryClient: boolean): void {\n  if (ownsQueryClient) {\n    queryClient.clear();\n    return;\n  }\n  queryClient.removeQueries({ predicate: (query) => isCapxulQueryKey(query.queryKey) });\n}\n\nexport function CapxulProvider(props: CapxulProviderProps) {\n  const {\n    publishableKey,\n    client: injectedClient,\n    requirement,\n    signer,\n    queryClient,\n    children,\n  } = props;\n\n  // The QueryClient is pinned at mount: a later `queryClient` prop swap is\n  // ignored (consumers should not swap it mid-tree) — pass your own once, or\n  // let the provider create one.\n  const [resolvedQueryClient] = useState(() => queryClient ?? makeDefaultQueryClient());\n  const [ownsQueryClient] = useState(() => queryClient === undefined);\n\n  const [client, setClient] = useState<CapxulClient | null>(injectedClient ?? null);\n  const previousClientRef = useRef<CapxulClient | null>(injectedClient ?? null);\n  const [status, setStatus] = useState<CapxulBootstrapState[\"status\"]>(\n    injectedClient === undefined ? \"bootstrapping\" : \"ready\",\n  );\n  const [error, setError] = useState<CapxulError | null>(null);\n  const [attempt, setAttempt] = useState(0);\n\n  const retry = useCallback(() => {\n    setAttempt((n) => n + 1);\n  }, []);\n\n  // Bootstrap path: the provider owns the client it creates and closes it on\n  // unmount / re-bootstrap. The `cancelled` guard closes a client that resolves\n  // after the effect tears down (StrictMode double-invoke, retry, unmount).\n  useEffect(() => {\n    if (publishableKey === undefined) return;\n    let cancelled = false;\n    let created: CapxulClient | null = null;\n    setStatus(\"bootstrapping\");\n    setError(null);\n    setClient(null);\n    void (async () => {\n      const result = await createCapxulClient({\n        publishableKey,\n        ...(requirement === undefined ? {} : { requirement }),\n        ...(signer === undefined ? {} : { signer }),\n      });\n      if (cancelled) {\n        if (result.ok) await result.value._internal.close?.();\n        return;\n      }\n      if (result.ok) {\n        created = result.value;\n        setClient(result.value);\n        setStatus(\"ready\");\n      } else {\n        setError(result.error);\n        setStatus(\"error\");\n      }\n    })();\n    return () => {\n      cancelled = true;\n      void created?._internal.close?.();\n    };\n  }, [publishableKey, requirement, signer, attempt]);\n\n  // Injected-client path: track prop identity; lifecycle stays with the caller.\n  useEffect(() => {\n    if (injectedClient === undefined) return;\n    setClient(injectedClient);\n    setStatus(\"ready\");\n    setError(null);\n  }, [injectedClient]);\n\n  useEffect(() => {\n    const previous = previousClientRef.current;\n    if (previous !== null && previous !== client) {\n      clearClientScopedQueries(resolvedQueryClient, ownsQueryClient);\n    }\n    previousClientRef.current = client;\n  }, [client, ownsQueryClient, resolvedQueryClient]);\n\n  const bootstrapState = useMemo<CapxulBootstrapState>(\n    () => ({ status, error, retry }),\n    [status, error, retry],\n  );\n\n  // Validate AFTER the hooks so a publishableKey↔client prop transition never\n  // changes the hook count (rules of hooks); the throw aborts render cleanly.\n  if ((publishableKey === undefined) === (injectedClient === undefined)) {\n    throw new Error(\"CapxulProvider requires exactly one of `publishableKey` or `client`\");\n  }\n\n  return (\n    <QueryClientProvider client={resolvedQueryClient}>\n      <CapxulBootstrapProvider value={bootstrapState}>\n        <CapxulClientProvider client={client}>{children}</CapxulClientProvider>\n      </CapxulBootstrapProvider>\n    </QueryClientProvider>\n  );\n}\n","// The canonical error-code catalog as a runtime constant. `CapxulErrorCode`\n// is derived from it so the type and any runtime check that needs to\n// enumerate codes (e.g. the convex-error codec's `KNOWN_CODES`) share a\n// single source of truth — a TypeScript union alone can't be introspected\n// at runtime, which previously forced a hand-maintained duplicate.\nexport const CAPXUL_ERROR_CODES = [\n  \"NOT_AUTHENTICATED\",\n  \"EMAIL_DELIVERY_FAILED\",\n  \"PROFILE_NOT_FOUND\",\n  \"SMART_ACCOUNT_MISSING\",\n  \"PLAYER_NOT_FOUND\",\n  \"ACCOUNT_NOT_FOUND\",\n  \"PROVIDER_ERROR\",\n  \"INVALID_INPUT\",\n  \"ENV_MISSING\",\n  \"NOT_IMPLEMENTED\",\n  \"VERIFICATION_REQUIRED\",\n  \"INSUFFICIENT_BALANCE\",\n  \"INVALID_RECIPIENT\",\n  \"ROLE_PERMISSION_DENIED\",\n  \"TRANSACTION_FAILED\",\n  \"RATE_LIMITED\",\n  \"NETWORK_ERROR\",\n  \"UNKNOWN\",\n  \"OTP_EXPIRED\",\n  \"SIGNER_REJECTED\",\n  \"CANCELLED\",\n  \"WRONG_STATE\",\n] as const;\n\nexport type CapxulErrorCode = (typeof CAPXUL_ERROR_CODES)[number];\n\n/**\n * Why an auth/provider call failed — a flat CAUSE enum. The *where* (which\n * OpenFort operation) stays in the separate `operation` detail field; this\n * names the root cause so a single `$exception` can be triaged without\n * parsing the message. Five members, no free strings:\n *\n * - `auth-origin-mismatch`: OTP cookies live on `localhost:PORT` but OpenFort\n *   hits the Convex host → no session reaches the provider.\n * - `stale-openfort-cache`: an old `userId` in scoped storage makes the SDK\n *   skip re-auth → 401 on `v2/accounts`.\n * - `app-env-allowlist`: missing `VITE_CAPXUL_CONVEX_SITE_URL` / the origin is\n *   not allowlisted → 401.\n * - `no-secure-context`: sandboxed/headless browser with no Web Crypto, so\n *   `getAddress`/`configure` can never produce an address. Previously vanished\n *   into `unknown`; the signer's secure-context probe now names it.\n * - `unknown`: catch-all when no cause could be determined.\n */\nexport type FailureMode =\n  | \"auth-origin-mismatch\"\n  | \"stale-openfort-cache\"\n  | \"app-env-allowlist\"\n  | \"no-secure-context\"\n  | \"unknown\";\n\nexport type CapxulErrorDetails = Record<string, unknown>;\n\nexport type SignerSource = \"openfort-embedded\" | \"injected-eip1193\" | \"local-private-key\";\n\nexport type VerificationRequiredDetails =\n  | { readonly requiredTier: number }\n  | { readonly rail: string; readonly currentKind: string };\n\nexport type SerializedCapxulError = {\n  readonly code: CapxulErrorCode;\n  readonly message: string;\n  readonly details?: CapxulErrorDetails;\n  readonly correlationId?: string;\n  readonly layer?: string;\n};\n\nexport type CapxulErrorOptions = {\n  readonly cause?: unknown;\n  readonly details?: CapxulErrorDetails;\n  readonly correlationId?: string;\n  readonly layer?: string;\n};\n\nexport class CapxulError extends Error {\n  readonly code: CapxulErrorCode;\n  readonly details?: CapxulErrorDetails;\n  readonly correlationId?: string;\n  readonly layer?: string;\n\n  constructor(code: CapxulErrorCode, message: string, options: CapxulErrorOptions = {}) {\n    super(message, \"cause\" in options ? { cause: options.cause } : undefined);\n    this.name = \"CapxulError\";\n    this.code = code;\n    if (options.details !== undefined) {\n      this.details = options.details;\n    }\n    if (options.correlationId !== undefined) {\n      this.correlationId = options.correlationId;\n    }\n    if (options.layer !== undefined) {\n      this.layer = options.layer;\n    }\n  }\n}\n\nexport function isCapxulError(value: unknown): value is CapxulError {\n  return value instanceof CapxulError;\n}\n\nexport function serializeCapxulError(error: CapxulError): SerializedCapxulError {\n  return compactSerialized({\n    code: error.code,\n    message: error.message,\n    details: error.details,\n    correlationId: error.correlationId,\n    layer: error.layer,\n  });\n}\n\nexport function deserializeCapxulError(serialized: SerializedCapxulError): CapxulError {\n  return new CapxulError(\n    serialized.code,\n    serialized.message,\n    compactErrorOptions({\n      details: serialized.details,\n      correlationId: serialized.correlationId,\n      layer: serialized.layer,\n    }),\n  );\n}\n\nfunction compactSerialized(serialized: {\n  readonly code: CapxulErrorCode;\n  readonly message: string;\n  readonly details: CapxulErrorDetails | undefined;\n  readonly correlationId: string | undefined;\n  readonly layer: string | undefined;\n}): SerializedCapxulError {\n  const result: {\n    code: CapxulErrorCode;\n    message: string;\n    details?: CapxulErrorDetails;\n    correlationId?: string;\n    layer?: string;\n  } = {\n    code: serialized.code,\n    message: serialized.message,\n  };\n\n  if (serialized.details !== undefined) {\n    result.details = serialized.details;\n  }\n  if (serialized.correlationId !== undefined) {\n    result.correlationId = serialized.correlationId;\n  }\n  if (serialized.layer !== undefined) {\n    result.layer = serialized.layer;\n  }\n\n  return result;\n}\n\nfunction compactErrorOptions(options: {\n  readonly cause?: unknown;\n  readonly details: CapxulErrorDetails | undefined;\n  readonly correlationId: string | undefined;\n  readonly layer: string | undefined;\n}): CapxulErrorOptions {\n  const result: {\n    cause?: unknown;\n    details?: CapxulErrorDetails;\n    correlationId?: string;\n    layer?: string;\n  } = {};\n\n  if (\"cause\" in options) {\n    result.cause = options.cause;\n  }\n  if (options.details !== undefined) {\n    result.details = options.details;\n  }\n  if (options.correlationId !== undefined) {\n    result.correlationId = options.correlationId;\n  }\n  if (options.layer !== undefined) {\n    result.layer = options.layer;\n  }\n\n  return result;\n}\n\nexport const Errors = {\n  notAuthenticated: (message?: string, opts?: { readonly failure_mode?: FailureMode }) =>\n    new CapxulError(\n      \"NOT_AUTHENTICATED\",\n      message ?? \"Not authenticated\",\n      opts?.failure_mode ? { details: { failure_mode: opts.failure_mode } } : undefined,\n    ),\n  emailDeliveryFailed: (detail: string) =>\n    new CapxulError(\"EMAIL_DELIVERY_FAILED\", \"Failed to send email\", {\n      details: { detail },\n    }),\n\n  profileNotFound: (authUserId: string) =>\n    new CapxulError(\"PROFILE_NOT_FOUND\", `Profile not found for user ${authUserId}`, {\n      details: { authUserId },\n    }),\n\n  smartAccountMissing: (authUserId: string) =>\n    new CapxulError(\"SMART_ACCOUNT_MISSING\", \"Smart account not provisioned\", {\n      details: { authUserId },\n    }),\n\n  playerNotFound: (playerId?: string) =>\n    new CapxulError(\n      \"PLAYER_NOT_FOUND\",\n      playerId ? `Openfort player ${playerId} not found` : \"Openfort player not found\",\n      playerId === undefined ? undefined : { details: { playerId } },\n    ),\n\n  accountNotFound: (accountId?: string) =>\n    new CapxulError(\n      \"ACCOUNT_NOT_FOUND\",\n      accountId ? `Openfort account ${accountId} not found` : \"Openfort account not found\",\n      accountId === undefined ? undefined : { details: { accountId } },\n    ),\n\n  providerError: (\n    provider: string,\n    operation: string,\n    cause: unknown,\n    opts?: { readonly failure_mode?: FailureMode },\n  ) => {\n    const details: Record<string, unknown> = { provider, operation };\n    if (opts?.failure_mode) {\n      details.failure_mode = opts.failure_mode;\n    }\n    return new CapxulError(\"PROVIDER_ERROR\", `Provider error: ${provider} ${operation}`, {\n      cause,\n      details,\n    });\n  },\n\n  invalidInput: (field: string, reason: string) =>\n    new CapxulError(\"INVALID_INPUT\", `Invalid ${field}: ${reason}`, {\n      details: { field, reason },\n    }),\n\n  envMissing: (name: string) =>\n    new CapxulError(\"ENV_MISSING\", `Environment variable ${name} not configured`, {\n      details: { name },\n    }),\n\n  notImplemented: (domain: string, method: string) =>\n    new CapxulError(\n      \"NOT_IMPLEMENTED\",\n      `${domain}.${method} is not yet implemented. This feature is planned for a future release.`,\n      { details: { domain, method } },\n    ),\n\n  /**\n   * Sibling factory to {@link Errors.providerError} for the per-state timeout\n   * path in flows (initially ProvisioningFlow's mint_openfort / deploy_safe /\n   * register_indexer `after:` timers). Same `PROVIDER_ERROR` code as\n   * `providerError`, plus a `details.reason: \"timeout\"` discriminator so\n   * downstream observers can distinguish failure modes without parsing the\n   * message string. The redacted message names the timeout budget; the\n   * native `cause` carries the same information for `reportError` fidelity.\n   */\n  providerTimeout: (provider: string, operation: string, timeoutMs: number) =>\n    new CapxulError(\n      \"PROVIDER_ERROR\",\n      `Provider error: ${provider} ${operation} (timeout exceeded ${timeoutMs}ms)`,\n      {\n        details: { provider, operation, reason: \"timeout\" },\n        cause: new Error(`timeout: ${operation} exceeded ${timeoutMs}ms`),\n      },\n    ),\n\n  verificationRequired: (details: VerificationRequiredDetails) => {\n    const message =\n      \"rail\" in details\n        ? `Verification is required before ${details.rail} can use ${details.currentKind}.`\n        : `Verification tier ${details.requiredTier} is required.`;\n\n    return new CapxulError(\"VERIFICATION_REQUIRED\", message, {\n      details,\n    });\n  },\n\n  insufficientBalance: (asset: string, available: string, required: string) =>\n    new CapxulError(\"INSUFFICIENT_BALANCE\", `Insufficient ${asset} balance`, {\n      details: { asset, available, required },\n    }),\n\n  invalidRecipient: (reason: string) =>\n    new CapxulError(\"INVALID_RECIPIENT\", `Invalid recipient: ${reason}`, {\n      details: { reason },\n    }),\n\n  /**\n   * The org Zodiac Roles modifier REFUSED the spend on-chain (G4 · #547): the\n   * member's role condition (per-tx cap, per-day allowance, allowed recipient,\n   * or membership) was violated, so `execTransactionWithRole` reverted. This is\n   * a PERMISSION denial — explicitly NOT an `INSUFFICIENT_BALANCE` (the treasury\n   * held the funds; the role's authority is what bound). `reason` discriminates\n   * the violated condition (`over_cap` / `daily_cap` / `not_member` /\n   * `disallowed_recipient` / `condition_violation`); leak-safe — no on-chain\n   * identifiers ever enter the details.\n   */\n  rolePermissionDenied: (details: {\n    readonly reason:\n      | \"over_cap\"\n      | \"daily_cap\"\n      | \"not_member\"\n      | \"disallowed_recipient\"\n      | \"condition_violation\";\n    readonly operation?: string;\n  }) =>\n    new CapxulError(\n      \"ROLE_PERMISSION_DENIED\",\n      `Org role denied this spend on-chain (${details.reason}).`,\n      {\n        details:\n          details.operation === undefined\n            ? { reason: details.reason }\n            : { reason: details.reason, operation: details.operation },\n      },\n    ),\n\n  /**\n   * A transaction (or sponsored UserOp) failed. `details.reason` discriminates\n   * the failure mode for callers that must distinguish a CONFIRMED on-chain\n   * revert (`\"onchain_revert\"` — the op executed and reverted, e.g. a Zodiac\n   * Roles condition violation) from an inconclusive infra failure. A confirmed\n   * revert is the ONLY mode the org spend port may map to a roles denial.\n   */\n  transactionFailed: (operation: string, cause?: unknown, extra?: { readonly reason?: string }) =>\n    new CapxulError(\"TRANSACTION_FAILED\", `Transaction failed: ${operation}`, {\n      cause,\n      details: extra?.reason === undefined ? { operation } : { operation, reason: extra.reason },\n    }),\n\n  rateLimited: (details?: { readonly retryAfterMs?: number; readonly resource?: string }) =>\n    new CapxulError(\n      \"RATE_LIMITED\",\n      \"Rate limit exceeded\",\n      details === undefined ? undefined : { details: { ...details } },\n    ),\n\n  networkError: (operation: string, cause?: unknown) =>\n    new CapxulError(\"NETWORK_ERROR\", `Network error during ${operation}`, {\n      cause,\n      details: { operation },\n    }),\n\n  unknown: (cause?: unknown) => new CapxulError(\"UNKNOWN\", \"Unknown error\", { cause }),\n\n  otpExpired: (details?: { readonly email?: string; readonly expiredAt?: number }) =>\n    new CapxulError(\n      \"OTP_EXPIRED\",\n      \"Verification code has expired. Request a new one.\",\n      details === undefined ? undefined : { details: { ...details } },\n    ),\n\n  signerRejected: (details: {\n    readonly source: SignerSource;\n    readonly reason?: string;\n    readonly cause?: unknown;\n  }) =>\n    new CapxulError(\"SIGNER_REJECTED\", \"Signer rejected the request.\", {\n      cause: details.cause,\n      details:\n        details.reason === undefined\n          ? { source: details.source }\n          : { source: details.source, reason: details.reason },\n    }),\n\n  cancelled: (details?: { readonly operation?: string; readonly reason?: string }) =>\n    new CapxulError(\n      \"CANCELLED\",\n      \"Operation was cancelled.\",\n      details === undefined ? undefined : { details: { ...details } },\n    ),\n\n  /**\n   * Method called from a flow state where its precondition fails (TA16). The\n   * SDK's method API short-circuits with this error before driving the\n   * internal state machine. `currentState` is the Effect-machine snapshot\n   * tag (stringified — substrate is `@effect/experimental/Machine` per\n   * `docs/canon/decisions/state-machine-substrate.md`); `validStates`\n   * enumerates the states the method accepts.\n   */\n  wrongState: (details: {\n    readonly method: string;\n    readonly currentState: string;\n    readonly validStates: readonly string[];\n  }) =>\n    new CapxulError(\n      \"WRONG_STATE\",\n      `${details.method} called from state '${details.currentState}'; valid states: ${details.validStates.join(\", \")}`,\n      { details: { ...details, validStates: [...details.validStates] } },\n    ),\n} as const;\n","// Shared `decodeConvexError` helper (TA5) — used by both the SDK's\n// `ConvexCallAdapter.mapToCapxulError` AND the backend `credentials/http.ts`\n// `bootstrapClient` handler. Single source of truth for cross-Convex-boundary\n// error decoding rules.\n//\n// Recognizes the `ConvexError(SerializedCapxulError)` object-shape produced by\n// `withErrorBoundary` (Probe B finding, 2026-05-19):\n//\n//   { name: \"ConvexError\", data: { code, message, details?, correlationId?, layer? } }\n//\n// AND the defensive string-shape branch for older Convex versions where\n// `data` is a JSON-serialized string. Pass-through for raw `CapxulError`\n// instances (which arrive directly when the throw happened in the same\n// V8 isolate as the catch). Returns null when the value is not a\n// recognizable shape — the caller falls back to NETWORK_ERROR + reportError.\n\nimport {\n  CAPXUL_ERROR_CODES,\n  CapxulError,\n  type CapxulErrorCode,\n  type SerializedCapxulError,\n  deserializeCapxulError,\n} from \"./errors.ts\";\n\n// Derived from the canonical catalog in errors.ts — single source of truth,\n// so a new code added to `CAPXUL_ERROR_CODES` is recognized here automatically.\nconst KNOWN_CODES: ReadonlySet<CapxulErrorCode> = new Set(CAPXUL_ERROR_CODES);\n\nfunction isCapxulCode(value: unknown): value is CapxulErrorCode {\n  return typeof value === \"string\" && KNOWN_CODES.has(value as CapxulErrorCode);\n}\n\nfunction reconstruct(serialized: Record<string, unknown>): CapxulError | null {\n  if (!isCapxulCode(serialized.code)) return null;\n  const payload: SerializedCapxulError = {\n    code: serialized.code,\n    message: typeof serialized.message === \"string\" ? serialized.message : String(serialized.code),\n    ...(typeof serialized.details === \"object\" &&\n    serialized.details !== null &&\n    !Array.isArray(serialized.details)\n      ? { details: serialized.details as Record<string, unknown> }\n      : {}),\n    ...(typeof serialized.correlationId === \"string\"\n      ? { correlationId: serialized.correlationId }\n      : {}),\n    ...(typeof serialized.layer === \"string\" ? { layer: serialized.layer } : {}),\n  };\n  return deserializeCapxulError(payload);\n}\n\nexport function decodeConvexError(err: unknown): CapxulError | null {\n  if (err === null || err === undefined) return null;\n\n  // Pass-through: same isolate, real CapxulError instance.\n  if (err instanceof CapxulError) return err;\n\n  if (typeof err !== \"object\") return null;\n\n  // The canonical shape produced by `withErrorBoundary` then crossed by\n  // Convex's `ctx.runQuery` / `ConvexHttpClient`: a `ConvexError` whose\n  // `data` is the `SerializedCapxulError` object literal.\n  const record = err as Record<string, unknown>;\n  if (!(\"data\" in record)) return null;\n  const data = record.data;\n\n  if (typeof data === \"object\" && data !== null) {\n    return reconstruct(data as Record<string, unknown>);\n  }\n\n  // Defensive depth — some Convex versions JSON-stringify the data at\n  // the runtime boundary. Probe B confirmed @convex-dev/better-auth 0.10.13\n  // + convex 1.39.x do NOT do this, but the cheap parse keeps forward\n  // compatibility.\n  if (typeof data === \"string\") {\n    try {\n      const parsed = JSON.parse(data) as unknown;\n      if (typeof parsed === \"object\" && parsed !== null) {\n        return reconstruct(parsed as Record<string, unknown>);\n      }\n    } catch {\n      // Fall through.\n    }\n  }\n\n  return null;\n}\n","import { Errors } from \"@capxul/errors\";\nimport type { CapxulClient } from \"@capxul/sdk\";\n\n/**\n * Narrow the bootstrap-nullable client to a ready client inside a query /\n * mutation function (sdk-provider-owned-bootstrap.md). Data hooks gate their\n * queries on `enabled: client !== null`, so this only ever throws for a mutation\n * triggered while `<CapxulProvider>` is still bootstrapping.\n */\nexport function requireBootstrappedClient(\n  client: CapxulClient | null,\n  method: string,\n): CapxulClient {\n  if (client === null) {\n    throw Errors.wrongState({ method, currentState: \"bootstrapping\", validStates: [\"ready\"] });\n  }\n  return client;\n}\n","// Typed query-key catalog (epic #258 · TanStack reactive surface).\n//\n// Auth-boundary mutations (`verifyOtp`, `signOut`) invalidate all three\n// keys on success. `signIn` does not — OTP sent leaves session null.\n\nimport type { AccountId, OrgId } from \"@capxul/types\";\n\nexport const capxulKeys = {\n  session: [\"capxul\", \"session\"] as const,\n  profile: [\"capxul\", \"profile\"] as const,\n  account: [\"capxul\", \"account\"] as const,\n  accountLifecycle: [\"capxul\", \"accountLifecycle\"] as const,\n  provisioning: [\"capxul\", \"provisioning\"] as const,\n  binding: [\"capxul\", \"binding\"] as const,\n  accountBalance: [\"capxul\", \"accountBalance\"] as const,\n  subAccounts: (accountId: AccountId | undefined) =>\n    [\"capxul\", \"subAccounts\", accountId ?? \"pending\"] as const,\n  // Organization domain (canon §C3, D13 — entity-scoped, keyed by OrgId).\n  orgs: [\"capxul\", \"orgs\"] as const,\n  org: (orgId: OrgId | undefined) => [\"capxul\", \"org\", orgId ?? \"pending\"] as const,\n  orgMembers: (orgId: OrgId | undefined) =>\n    [\"capxul\", \"org\", orgId ?? \"pending\", \"members\"] as const,\n  orgRoles: (orgId: OrgId | undefined) => [\"capxul\", \"org\", orgId ?? \"pending\", \"roles\"] as const,\n  orgTreasury: (orgId: OrgId | undefined) =>\n    [\"capxul\", \"org\", orgId ?? \"pending\", \"treasury\"] as const,\n} satisfies Record<string, readonly unknown[] | ((...args: never[]) => readonly unknown[])>;\n","import { captureExceptionSync } from \"@capxul/sdk\";\nimport type { TelemetryPort } from \"@capxul/sdk\";\nimport type { CapxulResult } from \"@capxul/sdk\";\n\n/**\n * Unwrap a `CapxulResult` for TanStack query/mutation functions —\n * throws into error paths, optionally reporting the error to telemetry first.\n *\n * When `telemetry` is provided and the result is `{ ok: false }`,\n * `captureExceptionSync` is called (fire-and-forget) before the throw. `operation`\n * tags the telemetry event so query reads and mutation writes stay\n * distinguishable in error tracking (defaults to `\"query\"`).\n */\nexport function unwrapCapxulResult<T>(\n  result: CapxulResult<T>,\n  telemetry?: TelemetryPort,\n  operation: \"query\" | \"mutation\" = \"query\",\n): T {\n  if (result.ok) {\n    return result.value;\n  }\n  if (telemetry) {\n    try {\n      captureExceptionSync(telemetry, result.error, {\n        layer: \"react-query\",\n        operation,\n      });\n    } catch {\n      // Telemetry failure never prevents the throw\n    }\n  }\n  throw result.error;\n}\n","\"use client\";\n\nimport { useQuery, type UseQueryResult } from \"@tanstack/react-query\";\n\nimport type { CapxulError } from \"@capxul/errors\";\nimport type { Session } from \"@capxul/sdk\";\n\nimport { useCapxulClientOrNull } from \"../internal/capxul-client-context\";\nimport { requireBootstrappedClient } from \"../internal/require-bootstrapped-client\";\nimport { capxulKeys } from \"../internal/reactivity-keys\";\nimport { unwrapCapxulResult } from \"../internal/unwrap-capxul-result\";\n\nexport type UseCapxulSessionReturn = UseQueryResult<Session | null, CapxulError>;\n\nexport function useCapxulSession(): UseCapxulSessionReturn {\n  const client = useCapxulClientOrNull();\n  return useQuery({\n    queryKey: capxulKeys.session,\n    queryFn: async () =>\n      unwrapCapxulResult(\n        await requireBootstrappedClient(client, \"auth.getSession\").auth.getSession(),\n        client!._internal.telemetry,\n      ),\n    enabled: client !== null,\n  });\n}\n","\"use client\";\n\nimport { useQuery, type UseQueryResult } from \"@tanstack/react-query\";\n\nimport type { CapxulError } from \"@capxul/errors\";\nimport type { Profile } from \"@capxul/sdk\";\n\nimport { useCapxulClientOrNull } from \"../internal/capxul-client-context\";\nimport { requireBootstrappedClient } from \"../internal/require-bootstrapped-client\";\nimport { capxulKeys } from \"../internal/reactivity-keys\";\nimport { unwrapCapxulResult } from \"../internal/unwrap-capxul-result\";\n\nexport type UseCapxulProfileReturn = UseQueryResult<Profile | null, CapxulError>;\n\nexport function useCapxulProfile(): UseCapxulProfileReturn {\n  const client = useCapxulClientOrNull();\n  return useQuery({\n    queryKey: capxulKeys.profile,\n    queryFn: async () =>\n      unwrapCapxulResult(\n        await requireBootstrappedClient(client, \"identity.loadCurrent\").identity.loadCurrent(),\n        client!._internal.telemetry,\n      ),\n    enabled: client !== null,\n  });\n}\n","/** True under Vitest — disables hook polling intervals that fight fake timers. */\nexport function isVitestRuntime(): boolean {\n  return typeof process !== \"undefined\" && process.env[\"VITEST\"] === \"true\";\n}\n","import type { QueryClient } from \"@tanstack/react-query\";\n\nimport { capxulKeys } from \"./reactivity-keys\";\n\n/** Background refetch after verifyOtp — avoids hard reset cancel errors in UI. */\nexport async function invalidateAuthBoundary(queryClient: QueryClient): Promise<void> {\n  await Promise.all([\n    queryClient.invalidateQueries({ queryKey: capxulKeys.session }),\n    queryClient.invalidateQueries({ queryKey: capxulKeys.profile }),\n    queryClient.invalidateQueries({ queryKey: capxulKeys.accountLifecycle }),\n    queryClient.invalidateQueries({ queryKey: capxulKeys.accountBalance }),\n  ]);\n}\n\n/** Hard reset after signOut — drop cached authenticated rows immediately. */\nexport async function resetAuthBoundary(queryClient: QueryClient): Promise<void> {\n  await queryClient.cancelQueries({ queryKey: capxulKeys.accountBalance });\n  await Promise.all([\n    queryClient.resetQueries({ queryKey: capxulKeys.session }),\n    queryClient.resetQueries({ queryKey: capxulKeys.profile }),\n    queryClient.resetQueries({ queryKey: capxulKeys.accountLifecycle }),\n    queryClient.resetQueries({ queryKey: capxulKeys.accountBalance }),\n  ]);\n}\n","\"use client\";\n\nimport {\n  useMutation,\n  useQuery,\n  useQueryClient,\n  type UseMutationResult,\n} from \"@tanstack/react-query\";\n\nimport type { CapxulError } from \"@capxul/errors\";\nimport { isSettingUpLifecycle, type AccountLifecycle } from \"@capxul/sdk\";\n\nimport { useCapxulClientOrNull } from \"../internal/capxul-client-context\";\nimport { isVitestRuntime } from \"../internal/is-vitest-runtime\";\nimport { invalidateAuthBoundary } from \"../internal/invalidate-auth-boundary\";\nimport { capxulKeys } from \"../internal/reactivity-keys\";\nimport { requireBootstrappedClient } from \"../internal/require-bootstrapped-client\";\nimport { unwrapCapxulResult } from \"../internal/unwrap-capxul-result\";\n\nconst LOADING_LIFECYCLE: AccountLifecycle = { status: \"loading\" };\n\nexport interface UseCapxulAccountLifecycleReturn {\n  readonly lifecycle: AccountLifecycle;\n  readonly isSettingUp: boolean;\n  readonly error: CapxulError | null;\n  readonly isLoading: boolean;\n  readonly isFetching: boolean;\n  readonly isError: boolean;\n  readonly retry: UseMutationResult<AccountLifecycle, CapxulError, void>[\"mutateAsync\"];\n  readonly isRetrying: boolean;\n}\n\nexport function useCapxulAccountLifecycle(): UseCapxulAccountLifecycleReturn {\n  const client = useCapxulClientOrNull();\n  const queryClient = useQueryClient();\n\n  const query = useQuery<AccountLifecycle, CapxulError>({\n    queryKey: capxulKeys.accountLifecycle,\n    queryFn: async () => {\n      const bootstrappedClient = requireBootstrappedClient(client, \"account.getLifecycle\");\n      return unwrapCapxulResult(\n        await bootstrappedClient.account.getLifecycle(),\n        bootstrappedClient._internal.telemetry,\n      );\n    },\n    enabled: client !== null,\n    refetchInterval: (q) => {\n      if (isVitestRuntime()) return false;\n      const data = q.state.data;\n      if (data === undefined) return false;\n      // Keep polling through `loading` — the first fetch can race verifyOtp/session\n      // hydration; without this the hook sticks on loading forever.\n      if (data.status === \"loading\" || isSettingUpLifecycle(data)) return 2_000;\n      return false;\n    },\n  });\n\n  const retryMutation = useMutation<AccountLifecycle, CapxulError, void>({\n    mutationFn: async () => {\n      const bootstrappedClient = requireBootstrappedClient(client, \"account.retrySetup\");\n      return unwrapCapxulResult(\n        await bootstrappedClient.account.retrySetup(),\n        bootstrappedClient._internal.telemetry,\n        \"mutation\",\n      );\n    },\n    onSuccess: async () => {\n      await invalidateAuthBoundary(queryClient);\n    },\n  });\n\n  const lifecycle = query.data ?? LOADING_LIFECYCLE;\n  const failedError = lifecycle.status === \"failed\" ? lifecycle.error : null;\n  const queryError = query.isError ? query.error : null;\n\n  return {\n    lifecycle:\n      queryError !== null && lifecycle.status === \"loading\"\n        ? {\n            status: \"failed\",\n            at: \"connecting\",\n            error: queryError,\n          }\n        : lifecycle,\n    isSettingUp: isSettingUpLifecycle(lifecycle),\n    error: failedError ?? queryError,\n    isLoading: query.isLoading,\n    isFetching: query.isFetching,\n    isError: query.isError,\n    retry: retryMutation.mutateAsync,\n    isRetrying: retryMutation.isPending,\n  };\n}\n","\"use client\";\n\nimport { useQuery, type UseQueryResult } from \"@tanstack/react-query\";\n\nimport type { CapxulError } from \"@capxul/errors\";\nimport type { Account } from \"@capxul/sdk\";\n\nimport { useCapxulClientOrNull } from \"../internal/capxul-client-context\";\nimport { requireBootstrappedClient } from \"../internal/require-bootstrapped-client\";\nimport { capxulKeys } from \"../internal/reactivity-keys\";\nimport { unwrapCapxulResult } from \"../internal/unwrap-capxul-result\";\n\nexport type UseCapxulAccountBalanceReturn = UseQueryResult<Account, CapxulError>;\n\nexport type UseCapxulAccountBalanceOptions = {\n  /** When false, skips the Convex readBalance action until the account ladder is ready. */\n  readonly enabled?: boolean;\n};\n\nexport function useCapxulAccountBalance(\n  options?: UseCapxulAccountBalanceOptions,\n): UseCapxulAccountBalanceReturn {\n  const client = useCapxulClientOrNull();\n  return useQuery({\n    queryKey: capxulKeys.accountBalance,\n    queryFn: async () => {\n      const bootstrappedClient = requireBootstrappedClient(client, \"accounts.read\");\n      return unwrapCapxulResult(\n        await bootstrappedClient.accounts.read(),\n        bootstrappedClient._internal.telemetry,\n      );\n    },\n    enabled: client !== null && (options?.enabled ?? true),\n  });\n}\n","\"use client\";\n\nimport { useMutation, useQueryClient, type UseMutationResult } from \"@tanstack/react-query\";\n\nimport type { CapxulError } from \"@capxul/errors\";\nimport type { Money } from \"@capxul/types\";\n\nimport { useCapxulClientOrNull } from \"../internal/capxul-client-context\";\nimport { requireBootstrappedClient } from \"../internal/require-bootstrapped-client\";\nimport { capxulKeys } from \"../internal/reactivity-keys\";\nimport { unwrapCapxulResult } from \"../internal/unwrap-capxul-result\";\n\nexport type UseCapxulAccountFundReturn = UseMutationResult<\n  { readonly txHash: string },\n  CapxulError,\n  Money\n>;\n\nexport function useCapxulAccountFund(): UseCapxulAccountFundReturn {\n  const client = useCapxulClientOrNull();\n  const queryClient = useQueryClient();\n  return useMutation({\n    mutationFn: async (amount: Money) => {\n      const bootstrappedClient = requireBootstrappedClient(client, \"_internal.accounts.fund\");\n      return unwrapCapxulResult(\n        await bootstrappedClient._internal.accounts.fund(amount),\n        bootstrappedClient._internal.telemetry,\n        \"mutation\",\n      );\n    },\n    onSuccess: async () => {\n      await queryClient.invalidateQueries({ queryKey: capxulKeys.accountBalance });\n    },\n  });\n}\n","\"use client\";\n\nimport { useMutation, type UseMutationResult } from \"@tanstack/react-query\";\n\nimport type { CapxulError } from \"@capxul/errors\";\n\nimport { useCapxulClientOrNull } from \"../internal/capxul-client-context\";\nimport { requireBootstrappedClient } from \"../internal/require-bootstrapped-client\";\nimport { unwrapCapxulResult } from \"../internal/unwrap-capxul-result\";\n\nexport interface SignInInput {\n  readonly email: string;\n}\n\nexport interface SignInSuccess {\n  readonly sessionId: string;\n  readonly expiresAt: number;\n}\n\nexport type UseCapxulSignInReturn = UseMutationResult<SignInSuccess, CapxulError, SignInInput>;\n\nexport function useCapxulSignIn(): UseCapxulSignInReturn {\n  const client = useCapxulClientOrNull();\n  return useMutation({\n    mutationFn: async (input: SignInInput) => {\n      const bootstrappedClient = requireBootstrappedClient(client, \"auth.signIn\");\n      return unwrapCapxulResult(\n        await bootstrappedClient.auth.signIn(input),\n        bootstrappedClient._internal.telemetry,\n        \"mutation\",\n      );\n    },\n  });\n}\n","\"use client\";\n\nimport { useMutation, useQueryClient, type UseMutationResult } from \"@tanstack/react-query\";\n\nimport type { CapxulError } from \"@capxul/errors\";\nimport type { Session } from \"@capxul/sdk\";\n\nimport { useCapxulClientOrNull } from \"../internal/capxul-client-context\";\nimport { requireBootstrappedClient } from \"../internal/require-bootstrapped-client\";\nimport { invalidateAuthBoundary } from \"../internal/invalidate-auth-boundary\";\nimport { unwrapCapxulResult } from \"../internal/unwrap-capxul-result\";\n\nexport interface VerifyOtpInput {\n  readonly email: string;\n  readonly code: string;\n}\n\nexport type UseCapxulVerifyOtpReturn = UseMutationResult<Session, CapxulError, VerifyOtpInput>;\n\nexport function useCapxulVerifyOtp(): UseCapxulVerifyOtpReturn {\n  const client = useCapxulClientOrNull();\n  const queryClient = useQueryClient();\n  return useMutation({\n    mutationFn: async (input: VerifyOtpInput) => {\n      const bootstrappedClient = requireBootstrappedClient(client, \"auth.verifyOtp\");\n      return unwrapCapxulResult(\n        await bootstrappedClient.auth.verifyOtp(input),\n        bootstrappedClient._internal.telemetry,\n        \"mutation\",\n      );\n    },\n    onSuccess: async () => {\n      await invalidateAuthBoundary(queryClient);\n    },\n  });\n}\n","\"use client\";\n\nimport { useMutation, useQueryClient, type UseMutationResult } from \"@tanstack/react-query\";\n\nimport type { CapxulError } from \"@capxul/errors\";\n\nimport { useCapxulClientOrNull } from \"../internal/capxul-client-context\";\nimport { requireBootstrappedClient } from \"../internal/require-bootstrapped-client\";\nimport { resetAuthBoundary } from \"../internal/invalidate-auth-boundary\";\nimport { capxulKeys } from \"../internal/reactivity-keys\";\nimport { unwrapCapxulResult } from \"../internal/unwrap-capxul-result\";\n\nexport type UseCapxulSignOutReturn = UseMutationResult<void, CapxulError, void>;\n\nexport function useCapxulSignOut(): UseCapxulSignOutReturn {\n  const client = useCapxulClientOrNull();\n  const queryClient = useQueryClient();\n  return useMutation({\n    onMutate: async () => {\n      await queryClient.cancelQueries({ queryKey: capxulKeys.accountBalance });\n    },\n    mutationFn: async () => {\n      const bootstrappedClient = requireBootstrappedClient(client, \"auth.signOut\");\n      return unwrapCapxulResult(\n        await bootstrappedClient.auth.signOut(),\n        bootstrappedClient._internal.telemetry,\n        \"mutation\",\n      );\n    },\n    onSuccess: () => resetAuthBoundary(queryClient),\n  });\n}\n","\"use client\";\n\nimport {\n  useMutation,\n  useQuery,\n  useQueryClient,\n  type UseMutationResult,\n  type UseQueryResult,\n} from \"@tanstack/react-query\";\n\nimport { Errors, type CapxulError } from \"@capxul/errors\";\nimport type { AccountId, SubAccount, SubAccountId } from \"@capxul/types\";\nimport type { TransferInput, TransferResult } from \"@capxul/sdk\";\n\nimport { useCapxulClientOrNull } from \"../internal/capxul-client-context\";\nimport { requireBootstrappedClient } from \"../internal/require-bootstrapped-client\";\nimport { capxulKeys } from \"../internal/reactivity-keys\";\nimport { unwrapCapxulResult } from \"../internal/unwrap-capxul-result\";\n\nexport type UseCapxulSubAccountsListOptions = {\n  readonly enabled?: boolean;\n};\n\nexport type UseCapxulSubAccountsListReturn = UseQueryResult<readonly SubAccount[], CapxulError>;\n\nexport function useCapxulSubAccountsList(\n  accountId: AccountId | undefined,\n  options?: UseCapxulSubAccountsListOptions,\n): UseCapxulSubAccountsListReturn {\n  const client = useCapxulClientOrNull();\n  return useQuery({\n    queryKey: capxulKeys.subAccounts(accountId),\n    queryFn: async () => {\n      if (accountId === undefined) {\n        throw Errors.invalidInput(\"accountId\", \"required for subAccounts.list\");\n      }\n      const bootstrappedClient = requireBootstrappedClient(client, \"subAccounts.list\");\n      return unwrapCapxulResult(\n        await bootstrappedClient.subAccounts.list(accountId),\n        bootstrappedClient._internal.telemetry,\n      );\n    },\n    enabled: client !== null && (options?.enabled ?? true) && accountId !== undefined,\n  });\n}\n\nexport type UseCapxulSubAccountCreateReturn = UseMutationResult<\n  SubAccount,\n  CapxulError,\n  { readonly accountId: AccountId; readonly name: string }\n>;\n\nexport function useCapxulSubAccountCreate(): UseCapxulSubAccountCreateReturn {\n  const client = useCapxulClientOrNull();\n  const queryClient = useQueryClient();\n  return useMutation({\n    mutationFn: async (input) => {\n      const bootstrappedClient = requireBootstrappedClient(client, \"subAccounts.create\");\n      return unwrapCapxulResult(\n        await bootstrappedClient.subAccounts.create(input.accountId, { name: input.name }),\n        bootstrappedClient._internal.telemetry,\n        \"mutation\",\n      );\n    },\n    onSuccess: async (_value, variables) => {\n      await queryClient.invalidateQueries({\n        queryKey: capxulKeys.subAccounts(variables.accountId),\n      });\n      await queryClient.invalidateQueries({ queryKey: capxulKeys.accountBalance });\n    },\n  });\n}\n\nexport type UseCapxulSubAccountRenameReturn = UseMutationResult<\n  SubAccount,\n  CapxulError,\n  { readonly accountId: AccountId; readonly subAccountId: SubAccountId; readonly name: string }\n>;\n\nexport function useCapxulSubAccountRename(): UseCapxulSubAccountRenameReturn {\n  const client = useCapxulClientOrNull();\n  const queryClient = useQueryClient();\n  return useMutation({\n    mutationFn: async (input) => {\n      const bootstrappedClient = requireBootstrappedClient(client, \"subAccounts.rename\");\n      return unwrapCapxulResult(\n        await bootstrappedClient.subAccounts.rename(input.subAccountId, input.name),\n        bootstrappedClient._internal.telemetry,\n        \"mutation\",\n      );\n    },\n    onSuccess: async (_value, variables) => {\n      await queryClient.invalidateQueries({\n        queryKey: capxulKeys.subAccounts(variables.accountId),\n      });\n      await queryClient.invalidateQueries({ queryKey: capxulKeys.accountBalance });\n    },\n  });\n}\n\nexport type UseCapxulSubAccountDeleteReturn = UseMutationResult<\n  void,\n  CapxulError,\n  { readonly accountId: AccountId; readonly subAccountId: SubAccountId }\n>;\n\nexport function useCapxulSubAccountDelete(): UseCapxulSubAccountDeleteReturn {\n  const client = useCapxulClientOrNull();\n  const queryClient = useQueryClient();\n  return useMutation({\n    mutationFn: async (input) => {\n      const bootstrappedClient = requireBootstrappedClient(client, \"subAccounts.delete\");\n      return unwrapCapxulResult(\n        await bootstrappedClient.subAccounts.delete(input.subAccountId),\n        bootstrappedClient._internal.telemetry,\n        \"mutation\",\n      );\n    },\n    onSuccess: async (_value, variables) => {\n      await queryClient.invalidateQueries({\n        queryKey: capxulKeys.subAccounts(variables.accountId),\n      });\n      await queryClient.invalidateQueries({ queryKey: capxulKeys.accountBalance });\n    },\n  });\n}\n\n/**\n * Move money between two of the SAME Account's balances (canon §5/§12). The\n * consumer-facing labels are \"Add money\" (main → sub) and \"Move money out\"\n * (sub → main), both calling `transfer`. `accountId` is carried only to\n * invalidate the right cache keys; the SDK input itself is `{ from, to, amount }`.\n */\nexport type UseCapxulTransferReturn = UseMutationResult<\n  TransferResult,\n  CapxulError,\n  { readonly accountId: AccountId } & TransferInput\n>;\n\nexport function useCapxulTransfer(): UseCapxulTransferReturn {\n  const client = useCapxulClientOrNull();\n  const queryClient = useQueryClient();\n  return useMutation({\n    mutationFn: async ({ from, to, amount }) => {\n      const bootstrappedClient = requireBootstrappedClient(client, \"subAccounts.transfer\");\n      return unwrapCapxulResult(\n        await bootstrappedClient.subAccounts.transfer({ from, to, amount }),\n        bootstrappedClient._internal.telemetry,\n        \"mutation\",\n      );\n    },\n    onSuccess: async (_value, variables) => {\n      await queryClient.invalidateQueries({\n        queryKey: capxulKeys.subAccounts(variables.accountId),\n      });\n      await queryClient.invalidateQueries({ queryKey: capxulKeys.accountBalance });\n    },\n  });\n}\n","\"use client\";\n\nimport { useQuery, type UseQueryResult } from \"@tanstack/react-query\";\n\nimport type { CapxulError } from \"@capxul/errors\";\nimport type { OrgView } from \"@capxul/sdk\";\n\nimport { useCapxulClientOrNull } from \"../internal/capxul-client-context\";\nimport { requireBootstrappedClient } from \"../internal/require-bootstrapped-client\";\nimport { capxulKeys } from \"../internal/reactivity-keys\";\nimport { unwrapCapxulResult } from \"../internal/unwrap-capxul-result\";\n\n/**\n * List the Orgs you belong to (canon §C1 \"Org list\" / §C3). Binds directly to\n * the locked `capxul.orgs()` SDK method.\n */\nexport type UseCapxulOrgsReturn = UseQueryResult<readonly OrgView[], CapxulError>;\n\nexport type UseCapxulOrgsOptions = {\n  /**\n   * Gate the query on auth readiness. `client.orgs()` is a session-scoped\n   * authenticated read; firing it before the session token settles surfaces a\n   * spurious `NOT_AUTHENTICATED`. Consumers pass `enabled: <auth-ready>` (e.g.\n   * \"the Organization surface is active\") — mirrors `useCapxulSubAccountsList`.\n   * Defaults to `true` to preserve the bare `useCapxulOrgs()` call shape.\n   */\n  readonly enabled?: boolean;\n};\n\nexport function useCapxulOrgs(options?: UseCapxulOrgsOptions): UseCapxulOrgsReturn {\n  const client = useCapxulClientOrNull();\n  return useQuery({\n    queryKey: capxulKeys.orgs,\n    queryFn: async () => {\n      const bootstrappedClient = requireBootstrappedClient(client, \"orgs\");\n      return unwrapCapxulResult(\n        await bootstrappedClient.orgs(),\n        bootstrappedClient._internal.telemetry,\n      );\n    },\n    enabled: client !== null && (options?.enabled ?? true),\n  });\n}\n","\"use client\";\n\nimport { useQuery, type UseQueryResult } from \"@tanstack/react-query\";\n\nimport { Errors, type CapxulError } from \"@capxul/errors\";\nimport type { OrgId, OrgView } from \"@capxul/sdk\";\n\nimport { useCapxulClient } from \"../internal/capxul-client-context\";\nimport { capxulKeys } from \"../internal/reactivity-keys\";\nimport { unwrapCapxulResult } from \"../internal/unwrap-capxul-result\";\n\nexport type UseCapxulOrgOptions = {\n  readonly enabled?: boolean;\n};\n\n/**\n * A single Org you belong to, resolved from `capxul.orgs()` and narrowed to the\n * requested `orgId` (canon §C3). Returns `null` when the Org is not in your list.\n * Gated by `orgId !== undefined`. RED until S1.\n */\nexport type UseCapxulOrgReturn = UseQueryResult<OrgView | null, CapxulError>;\n\nexport function useCapxulOrg(\n  orgId: OrgId | undefined,\n  options?: UseCapxulOrgOptions,\n): UseCapxulOrgReturn {\n  const client = useCapxulClient();\n  return useQuery({\n    queryKey: capxulKeys.org(orgId),\n    queryFn: async () => {\n      if (orgId === undefined) {\n        throw Errors.invalidInput(\"orgId\", \"required for useCapxulOrg\");\n      }\n      const orgs = unwrapCapxulResult(await client.orgs(), client!._internal.telemetry);\n      return orgs.find((org) => org.id === orgId) ?? null;\n    },\n    enabled: (options?.enabled ?? true) && orgId !== undefined,\n  });\n}\n","\"use client\";\n\nimport { useQuery, type UseQueryResult } from \"@tanstack/react-query\";\n\nimport { Errors, type CapxulError } from \"@capxul/errors\";\nimport type { MemberView, OrgId } from \"@capxul/sdk\";\n\nimport { useCapxulClient } from \"../internal/capxul-client-context\";\nimport { capxulKeys } from \"../internal/reactivity-keys\";\nimport { unwrapCapxulResult } from \"../internal/unwrap-capxul-result\";\n\nexport type UseCapxulOrgMembersOptions = {\n  readonly enabled?: boolean;\n};\n\n/**\n * The members of an Org (canon §C1 \"Members\" / §C3, D8/D9). Binds directly to\n * the entity-scoped `capxul.org(orgId).members()` (D13). Gated by\n * `orgId !== undefined`. RED until S3.\n */\nexport type UseCapxulOrgMembersReturn = UseQueryResult<readonly MemberView[], CapxulError>;\n\nexport function useCapxulOrgMembers(\n  orgId: OrgId | undefined,\n  options?: UseCapxulOrgMembersOptions,\n): UseCapxulOrgMembersReturn {\n  const client = useCapxulClient();\n  return useQuery({\n    queryKey: capxulKeys.orgMembers(orgId),\n    queryFn: async () => {\n      if (orgId === undefined) {\n        throw Errors.invalidInput(\"orgId\", \"required for useCapxulOrgMembers\");\n      }\n      return unwrapCapxulResult(await client.org(orgId).members(), client!._internal.telemetry);\n    },\n    enabled: (options?.enabled ?? true) && orgId !== undefined,\n  });\n}\n","\"use client\";\n\nimport { useQuery, type UseQueryResult } from \"@tanstack/react-query\";\n\nimport { Errors, type CapxulError } from \"@capxul/errors\";\nimport type { OrgId, RoleView } from \"@capxul/sdk\";\n\nimport { useCapxulClient } from \"../internal/capxul-client-context\";\nimport { capxulKeys } from \"../internal/reactivity-keys\";\nimport { unwrapCapxulResult } from \"../internal/unwrap-capxul-result\";\n\nexport type UseCapxulOrgRolesOptions = {\n  readonly enabled?: boolean;\n};\n\n/**\n * The roles seeded on an Org (canon §C1 \"Roles\" / §C3, D4/D6). Binds directly\n * to the entity-scoped `capxul.org(orgId).roles()` (D13). Gated by\n * `orgId !== undefined`. RED until S2.\n */\nexport type UseCapxulOrgRolesReturn = UseQueryResult<readonly RoleView[], CapxulError>;\n\nexport function useCapxulOrgRoles(\n  orgId: OrgId | undefined,\n  options?: UseCapxulOrgRolesOptions,\n): UseCapxulOrgRolesReturn {\n  const client = useCapxulClient();\n  return useQuery({\n    queryKey: capxulKeys.orgRoles(orgId),\n    queryFn: async () => {\n      if (orgId === undefined) {\n        throw Errors.invalidInput(\"orgId\", \"required for useCapxulOrgRoles\");\n      }\n      return unwrapCapxulResult(await client.org(orgId).roles(), client!._internal.telemetry);\n    },\n    enabled: (options?.enabled ?? true) && orgId !== undefined,\n  });\n}\n","\"use client\";\n\nimport { useMutation, useQueryClient, type UseMutationResult } from \"@tanstack/react-query\";\n\nimport type { CapxulError } from \"@capxul/errors\";\nimport type { OrgId, RoleView } from \"@capxul/sdk\";\n\nimport { useCapxulClient } from \"../internal/capxul-client-context\";\nimport { capxulKeys } from \"../internal/reactivity-keys\";\nimport { unwrapCapxulResult } from \"../internal/unwrap-capxul-result\";\n\nexport type UseCapxulOrgDeployRolesReturn = UseMutationResult<\n  readonly RoleView[],\n  CapxulError,\n  OrgId\n>;\n\nexport function useCapxulOrgDeployRoles(): UseCapxulOrgDeployRolesReturn {\n  const client = useCapxulClient();\n  const queryClient = useQueryClient();\n  return useMutation({\n    mutationFn: async (orgId: OrgId) => {\n      return unwrapCapxulResult(\n        await client.org(orgId).deployRoles(),\n        client._internal.telemetry,\n        \"mutation\",\n      );\n    },\n    onSuccess: async (_roles, orgId) => {\n      await queryClient.invalidateQueries({ queryKey: capxulKeys.orgRoles(orgId) });\n      await queryClient.invalidateQueries({ queryKey: capxulKeys.org(orgId) });\n      await queryClient.invalidateQueries({ queryKey: capxulKeys.orgs });\n    },\n  });\n}\n","\"use client\";\n\nimport { useQuery, type UseQueryResult } from \"@tanstack/react-query\";\n\nimport { Errors, type CapxulError } from \"@capxul/errors\";\nimport type { OrgId } from \"@capxul/sdk\";\nimport type { Account } from \"@capxul/types\";\n\nimport { useCapxulClient } from \"../internal/capxul-client-context\";\nimport { capxulKeys } from \"../internal/reactivity-keys\";\nimport { unwrapCapxulResult } from \"../internal/unwrap-capxul-result\";\n\nexport type UseCapxulOrgTreasuryOptions = {\n  readonly enabled?: boolean;\n};\n\n/**\n * The Org treasury — the real M2 `Account` over the Org Safe (canon §C3, D3).\n * NEVER `AccountStatus` (the deploy-readiness ladder, no balance). Binds\n * directly to the entity-scoped `capxul.org(orgId).treasury()` (D13). Gated by\n * `orgId !== undefined`. RED until S1.\n */\nexport type UseCapxulOrgTreasuryReturn = UseQueryResult<Account, CapxulError>;\n\nexport function useCapxulOrgTreasury(\n  orgId: OrgId | undefined,\n  options?: UseCapxulOrgTreasuryOptions,\n): UseCapxulOrgTreasuryReturn {\n  const client = useCapxulClient();\n  return useQuery({\n    queryKey: capxulKeys.orgTreasury(orgId),\n    queryFn: async () => {\n      if (orgId === undefined) {\n        throw Errors.invalidInput(\"orgId\", \"required for useCapxulOrgTreasury\");\n      }\n      return unwrapCapxulResult(await client.org(orgId).treasury(), client!._internal.telemetry);\n    },\n    enabled: (options?.enabled ?? true) && orgId !== undefined,\n  });\n}\n","\"use client\";\n\nimport { useMutation, useQueryClient, type UseMutationResult } from \"@tanstack/react-query\";\n\nimport type { CapxulError } from \"@capxul/errors\";\nimport type { CreateOrgInput, OrgView } from \"@capxul/sdk\";\n\nimport { useCapxulClient } from \"../internal/capxul-client-context\";\nimport { capxulKeys } from \"../internal/reactivity-keys\";\nimport { unwrapCapxulResult } from \"../internal/unwrap-capxul-result\";\n\n/**\n * Create an Org (canon §C2 J1 / §C3, S1). Binds directly to the locked\n * `capxul.createOrg(input)` SDK method. On success, invalidates the org list.\n * RED until S1 — `mutate` rejects with `Errors.notImplemented(\"org\",\"createOrg\")`.\n */\nexport type UseCapxulCreateOrgReturn = UseMutationResult<OrgView, CapxulError, CreateOrgInput>;\n\nexport function useCapxulCreateOrg(): UseCapxulCreateOrgReturn {\n  const client = useCapxulClient();\n  const queryClient = useQueryClient();\n  return useMutation({\n    mutationFn: async (input: CreateOrgInput) =>\n      unwrapCapxulResult(await client.createOrg(input), client._internal.telemetry, \"mutation\"),\n    onSuccess: async () => {\n      await queryClient.invalidateQueries({ queryKey: capxulKeys.orgs });\n    },\n  });\n}\n","\"use client\";\n\nimport { useMutation, useQueryClient, type UseMutationResult } from \"@tanstack/react-query\";\n\nimport type { CapxulError } from \"@capxul/errors\";\nimport type {\n  CompletePersonalOnboardingInput,\n  CompletePersonalOnboardingResult,\n} from \"@capxul/sdk\";\n\nimport { useCapxulClient } from \"../internal/capxul-client-context\";\nimport { capxulKeys } from \"../internal/reactivity-keys\";\nimport { unwrapCapxulResult } from \"../internal/unwrap-capxul-result\";\n\n/**\n * Complete personal onboarding (D-ONBOARD · #669). Binds to\n * `capxul.onboarding.completePersonal(input)`: persist the user's first identity\n * profile + trigger provisioning, then return the leak-safe `{ lifecycle }`. A\n * mutation, NOT an effect — call `mutateAsync` from a submit handler and route\n * on `lifecycle.status` (see `docs/onboarding.md`). On success it invalidates the\n * identity + account-lifecycle queries so the dashboard/provisioning screen\n * reactively reflects the new state. No effect hooks — a handler + a query.\n */\nexport type UseCapxulCompletePersonalOnboardingReturn = UseMutationResult<\n  CompletePersonalOnboardingResult,\n  CapxulError,\n  CompletePersonalOnboardingInput\n>;\n\nexport function useCapxulCompletePersonalOnboarding(): UseCapxulCompletePersonalOnboardingReturn {\n  const client = useCapxulClient();\n  const queryClient = useQueryClient();\n  return useMutation({\n    mutationFn: async (input: CompletePersonalOnboardingInput) =>\n      unwrapCapxulResult(\n        await client.onboarding.completePersonal(input),\n        client._internal.telemetry,\n        \"mutation\",\n      ),\n    onSuccess: async () => {\n      await Promise.all([\n        queryClient.invalidateQueries({ queryKey: capxulKeys.profile }),\n        queryClient.invalidateQueries({ queryKey: capxulKeys.accountLifecycle }),\n      ]);\n    },\n  });\n}\n","\"use client\";\n\nimport { useMutation, useQueryClient, type UseMutationResult } from \"@tanstack/react-query\";\n\nimport type { CapxulError } from \"@capxul/errors\";\nimport type {\n  CompleteOrganizationOnboardingInput,\n  CompleteOrganizationOnboardingResult,\n} from \"@capxul/sdk\";\n\nimport { useCapxulClient } from \"../internal/capxul-client-context\";\nimport { capxulKeys } from \"../internal/reactivity-keys\";\nimport { unwrapCapxulResult } from \"../internal/unwrap-capxul-result\";\n\n/**\n * Complete organization onboarding (D-ONBOARD · #669). Binds to\n * `capxul.onboarding.completeOrganization(input)`: persist the founder's identity\n * profile, create the Org (reusing `createOrg`), trigger provisioning, and return\n * `{ org, lifecycle }`. Scope every later org call via `capxul.org(org.id).*`. A\n * mutation, NOT an effect. On success it invalidates the identity, account-\n * lifecycle, and org-list queries. No effect hooks — a handler + a query.\n */\nexport type UseCapxulCompleteOrganizationOnboardingReturn = UseMutationResult<\n  CompleteOrganizationOnboardingResult,\n  CapxulError,\n  CompleteOrganizationOnboardingInput\n>;\n\nexport function useCapxulCompleteOrganizationOnboarding(): UseCapxulCompleteOrganizationOnboardingReturn {\n  const client = useCapxulClient();\n  const queryClient = useQueryClient();\n  return useMutation({\n    mutationFn: async (input: CompleteOrganizationOnboardingInput) =>\n      unwrapCapxulResult(\n        await client.onboarding.completeOrganization(input),\n        client._internal.telemetry,\n        \"mutation\",\n      ),\n    onSuccess: async () => {\n      await Promise.all([\n        queryClient.invalidateQueries({ queryKey: capxulKeys.profile }),\n        queryClient.invalidateQueries({ queryKey: capxulKeys.accountLifecycle }),\n        queryClient.invalidateQueries({ queryKey: capxulKeys.orgs }),\n      ]);\n    },\n  });\n}\n","\"use client\";\n\nimport { useMutation, useQueryClient, type UseMutationResult } from \"@tanstack/react-query\";\n\nimport { Errors, type CapxulError } from \"@capxul/errors\";\nimport type { InviteMemberInput, MemberView, OrgId } from \"@capxul/sdk\";\n\nimport { useCapxulClient } from \"../internal/capxul-client-context\";\nimport { capxulKeys } from \"../internal/reactivity-keys\";\nimport { unwrapCapxulResult } from \"../internal/unwrap-capxul-result\";\n\n/**\n * Invite a member to an Org by email (canon §C2 J2 virality loop / §C3, S3, D8).\n * Entity-scoped via the closed-over `orgId` (D13). Binds directly to\n * `capxul.org(orgId).invite(input)`. On success, invalidates the member list.\n * RED until S3 — `mutate` rejects with `Errors.notImplemented(\"org\",\"invite\")`.\n */\nexport type UseCapxulInviteMemberReturn = UseMutationResult<\n  MemberView,\n  CapxulError,\n  InviteMemberInput\n>;\n\nexport function useCapxulInviteMember(orgId: OrgId | undefined): UseCapxulInviteMemberReturn {\n  const client = useCapxulClient();\n  const queryClient = useQueryClient();\n  return useMutation({\n    mutationFn: async (input: InviteMemberInput) => {\n      if (orgId === undefined) {\n        throw Errors.invalidInput(\"orgId\", \"required for useCapxulInviteMember\");\n      }\n      return unwrapCapxulResult(\n        await client.org(orgId).invite(input),\n        client._internal.telemetry,\n        \"mutation\",\n      );\n    },\n    onSuccess: async () => {\n      if (orgId === undefined) return;\n      await queryClient.invalidateQueries({ queryKey: capxulKeys.orgMembers(orgId) });\n    },\n  });\n}\n","\"use client\";\n\nimport { useMutation, useQueryClient, type UseMutationResult } from \"@tanstack/react-query\";\n\nimport { Errors, type CapxulError } from \"@capxul/errors\";\nimport type { OrgId, RemoveMemberInput } from \"@capxul/sdk\";\n\nimport { useCapxulClient } from \"../internal/capxul-client-context\";\nimport { capxulKeys } from \"../internal/reactivity-keys\";\nimport { unwrapCapxulResult } from \"../internal/unwrap-capxul-result\";\n\n/**\n * Remove a member from an Org (canon §C2 J2 / §C3, S3, D7/D8) — drives the\n * on-chain REVOKE + Convex mirror. Keyed on the member's personal Safe address\n * (D7). Entity-scoped via the closed-over `orgId` (D13). Binds directly to\n * `capxul.org(orgId).removeMember(input)`. On success, invalidates the member\n * list. RED until S3 — `mutate` rejects with\n * `Errors.notImplemented(\"org\",\"removeMember\")`.\n */\nexport type UseCapxulRemoveMemberReturn = UseMutationResult<void, CapxulError, RemoveMemberInput>;\n\nexport function useCapxulRemoveMember(orgId: OrgId | undefined): UseCapxulRemoveMemberReturn {\n  const client = useCapxulClient();\n  const queryClient = useQueryClient();\n  return useMutation({\n    mutationFn: async (input: RemoveMemberInput) => {\n      if (orgId === undefined) {\n        throw Errors.invalidInput(\"orgId\", \"required for useCapxulRemoveMember\");\n      }\n      return unwrapCapxulResult(\n        await client.org(orgId).removeMember(input),\n        client._internal.telemetry,\n        \"mutation\",\n      );\n    },\n    onSuccess: async () => {\n      if (orgId === undefined) return;\n      await queryClient.invalidateQueries({ queryKey: capxulKeys.orgMembers(orgId) });\n    },\n  });\n}\n","\"use client\";\n\nimport { useMutation, useQueryClient, type UseMutationResult } from \"@tanstack/react-query\";\n\nimport { Errors, type CapxulError } from \"@capxul/errors\";\nimport type { AssignRoleInput, MemberView, OrgId } from \"@capxul/sdk\";\n\nimport { useCapxulClient } from \"../internal/capxul-client-context\";\nimport { capxulKeys } from \"../internal/reactivity-keys\";\nimport { unwrapCapxulResult } from \"../internal/unwrap-capxul-result\";\n\n/**\n * Assign a role to a member (canon §C2 J2 / §C3, S3, D7/D9) — drives the\n * on-chain GRANT + Convex mirror. Keyed on the member's personal Safe address\n * (D7); the `role` label maps deterministically to the on-chain `roleKey` (D9).\n * Entity-scoped via the closed-over `orgId` (D13). Binds directly to\n * `capxul.org(orgId).assignRole(input)`. On success, invalidates the member\n * list. RED until S3 — `mutate` rejects with\n * `Errors.notImplemented(\"org\",\"assignRole\")`.\n */\nexport type UseCapxulAssignRoleReturn = UseMutationResult<MemberView, CapxulError, AssignRoleInput>;\n\nexport function useCapxulAssignRole(orgId: OrgId | undefined): UseCapxulAssignRoleReturn {\n  const client = useCapxulClient();\n  const queryClient = useQueryClient();\n  return useMutation({\n    mutationFn: async (input: AssignRoleInput) => {\n      if (orgId === undefined) {\n        throw Errors.invalidInput(\"orgId\", \"required for useCapxulAssignRole\");\n      }\n      return unwrapCapxulResult(\n        await client.org(orgId).assignRole(input),\n        client._internal.telemetry,\n        \"mutation\",\n      );\n    },\n    onSuccess: async () => {\n      if (orgId === undefined) return;\n      await queryClient.invalidateQueries({ queryKey: capxulKeys.orgMembers(orgId) });\n    },\n  });\n}\n","\"use client\";\n\nimport { useMutation, type UseMutationResult } from \"@tanstack/react-query\";\n\nimport type { OrgId } from \"@capxul/sdk\";\n\nexport type SwitchActingEntityInput = {\n  readonly orgId?: OrgId;\n};\n\n/**\n * Switch the acting entity (personal Account ↔ Organization).\n *\n * Per canon D13 the acting entity is NOT shared mutable SDK state — scoping is\n * explicit per `capxul.org(orgId)` call — so this mutation carries no SDK side\n * effect. It exists as the stable mutation seam the headless\n * `CapxulEntitySwitcher` drives; the actual context switch is the consumer's\n * own local state, applied through the component's `onSwitchPersonal` /\n * `onSwitchOrg` callbacks.\n *\n * The legacy `org_entity_switched` telemetry emission was removed when master's\n * unified telemetry pipeline (#402) dropped that event from the Layer 0 spine.\n */\nexport type UseCapxulSwitchActingEntityReturn = UseMutationResult<\n  void,\n  Error,\n  SwitchActingEntityInput | undefined\n>;\n\nexport function useCapxulSwitchActingEntity(): UseCapxulSwitchActingEntityReturn {\n  return useMutation({\n    mutationFn: async (_input?: SwitchActingEntityInput) => undefined,\n  });\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../../errors/src/errors.ts","../../errors/src/convex-error-decoding.ts","../src/internal/require-bootstrapped-client.ts","../src/internal/unwrap-capxul-result.ts","../src/hooks/use-capxul-profile.ts","../src/hooks/use-capxul-account-balance.ts","../src/hooks/use-capxul-account-fund.ts","../src/hooks/use-capxul-sub-accounts.ts","../src/internal/invalidate-money-state.ts","../src/internal/reject-unresolved-actor.ts","../src/hooks/use-capxul-money.ts","../src/hooks/use-capxul-orgs.ts","../src/hooks/use-capxul-org-members.ts","../src/hooks/use-capxul-org-roles.ts","../src/hooks/use-capxul-org-deploy-roles.ts","../src/hooks/use-capxul-org-treasury.ts","../src/hooks/use-capxul-create-org.ts","../src/hooks/use-capxul-invite-member.ts","../src/hooks/use-capxul-remove-member.ts","../src/hooks/use-capxul-assign-role.ts","../src/headless/journey/journey-state.ts","../src/internal/use-debounced-value.ts","../src/headless/onboarding/use-capxul-username-availability.ts","../src/headless/media/use-capxul-image-upload.ts"],"sourcesContent":["// The canonical error-code catalog as a runtime constant. `CapxulErrorCode`\n// is derived from it so the type and any runtime check that needs to\n// enumerate codes (e.g. the convex-error codec's `KNOWN_CODES`) share a\n// single source of truth — a TypeScript union alone can't be introspected\n// at runtime, which previously forced a hand-maintained duplicate.\nexport const CAPXUL_ERROR_CODES = [\n  \"NOT_AUTHENTICATED\",\n  \"EMAIL_DELIVERY_FAILED\",\n  \"PROFILE_NOT_FOUND\",\n  \"SMART_ACCOUNT_MISSING\",\n  \"PLAYER_NOT_FOUND\",\n  \"ACCOUNT_NOT_FOUND\",\n  \"PROVIDER_ERROR\",\n  \"INVALID_INPUT\",\n  \"ENV_MISSING\",\n  \"NOT_IMPLEMENTED\",\n  \"VERIFICATION_REQUIRED\",\n  \"INSUFFICIENT_BALANCE\",\n  \"INVALID_RECIPIENT\",\n  \"ROLE_PERMISSION_DENIED\",\n  \"TRANSACTION_FAILED\",\n  \"RATE_LIMITED\",\n  \"NETWORK_ERROR\",\n  \"UNKNOWN\",\n  \"OTP_EXPIRED\",\n  \"SIGNER_REJECTED\",\n  \"CANCELLED\",\n  \"WRONG_STATE\",\n  \"STALE_EPOCH\",\n  \"SUPERSEDED\",\n  \"WORK_DIED\",\n  \"ACTOR_STOPPED\",\n] as const;\n\nexport type CapxulErrorCode = (typeof CAPXUL_ERROR_CODES)[number];\n\n/**\n * The error codes that represent an expected product outcome rather than a\n * defect. The SDK and backend observation boundaries both classify failures\n * against this set to route expected outcomes to their own PostHog event\n * stream; keeping the single copy here (adjacent to `CAPXUL_ERROR_CODES`, so a\n * code rename forces this set to move with it) stops the two sides of the wire\n * from drifting and silently splitting one outcome across two streams.\n */\nexport const EXPECTED_OPERATION_OUTCOMES: ReadonlySet<CapxulErrorCode> = new Set([\n  \"INVALID_INPUT\",\n  \"NOT_AUTHENTICATED\",\n  // A user with no Safe yet — the normal post-OTP / pre-provision state. Reading\n  // the account, current user, or balance in that window is an expected outcome,\n  // not a defect, so both observation boundaries route it to their\n  // `*_expected_outcome` stream instead of an unexpected `$exception` (#1031).\n  \"SMART_ACCOUNT_MISSING\",\n  \"CANCELLED\",\n  \"SIGNER_REJECTED\",\n  \"VERIFICATION_REQUIRED\",\n  \"INSUFFICIENT_BALANCE\",\n  \"INVALID_RECIPIENT\",\n  \"ROLE_PERMISSION_DENIED\",\n  \"RATE_LIMITED\",\n  \"OTP_EXPIRED\",\n  \"WRONG_STATE\",\n  \"STALE_EPOCH\",\n  \"SUPERSEDED\",\n  \"ACTOR_STOPPED\",\n]);\n\n/**\n * Why an auth/provider call failed — a flat CAUSE enum. The *where* (which\n * OpenFort operation) stays in the separate `operation` detail field; this\n * names the root cause so a single `$exception` can be triaged without\n * parsing the message. Five members, no free strings:\n *\n * - `auth-origin-mismatch`: OTP cookies live on `localhost:PORT` but OpenFort\n *   hits the Convex host → no session reaches the provider.\n * - `stale-openfort-cache`: an old `userId` in scoped storage makes the SDK\n *   skip re-auth → 401 on `v2/accounts`.\n * - `app-env-allowlist`: the selected app/deployment origin is not allowlisted\n *   → 401.\n * - `no-secure-context`: sandboxed/headless browser with no Web Crypto, so\n *   `getAddress`/`configure` can never produce an address. Previously vanished\n *   into `unknown`; the signer's secure-context probe now names it.\n * - `unknown`: catch-all when no cause could be determined.\n */\nexport type FailureMode =\n  | \"auth-origin-mismatch\"\n  | \"stale-openfort-cache\"\n  | \"app-env-allowlist\"\n  | \"no-secure-context\"\n  | \"unknown\";\n\n/**\n * The one failure representation carried by domain state, actor work, and\n * public error projection. Keeping it beside the canonical error catalog\n * prevents a machine or shell from inventing a second code vocabulary.\n */\nexport interface Failure {\n  readonly code: CapxulErrorCode;\n  readonly message: string;\n  readonly mode?: FailureMode;\n}\n\nexport type CapxulErrorDetails = Record<string, unknown>;\n\nexport type SignerSource = \"openfort-embedded\" | \"injected-eip1193\" | \"local-private-key\";\n\nexport type VerificationRequiredDetails =\n  | { readonly requiredTier: number }\n  | { readonly rail: string; readonly currentKind: string };\n\nexport type SerializedCapxulError = {\n  readonly code: CapxulErrorCode;\n  readonly message: string;\n  readonly details?: CapxulErrorDetails;\n  readonly correlationId?: string;\n  readonly layer?: string;\n};\n\nexport type CapxulErrorOptions = {\n  readonly cause?: unknown;\n  readonly details?: CapxulErrorDetails;\n  readonly correlationId?: string;\n  readonly layer?: string;\n};\n\nexport class CapxulError extends Error {\n  readonly code: CapxulErrorCode;\n  readonly details?: CapxulErrorDetails;\n  readonly correlationId?: string;\n  readonly layer?: string;\n\n  constructor(code: CapxulErrorCode, message: string, options: CapxulErrorOptions = {}) {\n    super(message, \"cause\" in options ? { cause: options.cause } : undefined);\n    this.name = \"CapxulError\";\n    this.code = code;\n    if (options.details !== undefined) {\n      this.details = options.details;\n    }\n    if (options.correlationId !== undefined) {\n      this.correlationId = options.correlationId;\n    }\n    if (options.layer !== undefined) {\n      this.layer = options.layer;\n    }\n  }\n}\n\nexport function isCapxulError(value: unknown): value is CapxulError {\n  return value instanceof CapxulError;\n}\n\nexport function serializeCapxulError(error: CapxulError): SerializedCapxulError {\n  return compactSerialized({\n    code: error.code,\n    message: error.message,\n    details: error.details,\n    correlationId: error.correlationId,\n    layer: error.layer,\n  });\n}\n\nexport function deserializeCapxulError(serialized: SerializedCapxulError): CapxulError {\n  return new CapxulError(\n    serialized.code,\n    serialized.message,\n    compactErrorOptions({\n      details: serialized.details,\n      correlationId: serialized.correlationId,\n      layer: serialized.layer,\n    }),\n  );\n}\n\nfunction compactSerialized(serialized: {\n  readonly code: CapxulErrorCode;\n  readonly message: string;\n  readonly details: CapxulErrorDetails | undefined;\n  readonly correlationId: string | undefined;\n  readonly layer: string | undefined;\n}): SerializedCapxulError {\n  const result: {\n    code: CapxulErrorCode;\n    message: string;\n    details?: CapxulErrorDetails;\n    correlationId?: string;\n    layer?: string;\n  } = {\n    code: serialized.code,\n    message: serialized.message,\n  };\n\n  if (serialized.details !== undefined) {\n    result.details = serialized.details;\n  }\n  if (serialized.correlationId !== undefined) {\n    result.correlationId = serialized.correlationId;\n  }\n  if (serialized.layer !== undefined) {\n    result.layer = serialized.layer;\n  }\n\n  return result;\n}\n\nfunction compactErrorOptions(options: {\n  readonly cause?: unknown;\n  readonly details: CapxulErrorDetails | undefined;\n  readonly correlationId: string | undefined;\n  readonly layer: string | undefined;\n}): CapxulErrorOptions {\n  const result: {\n    cause?: unknown;\n    details?: CapxulErrorDetails;\n    correlationId?: string;\n    layer?: string;\n  } = {};\n\n  if (\"cause\" in options) {\n    result.cause = options.cause;\n  }\n  if (options.details !== undefined) {\n    result.details = options.details;\n  }\n  if (options.correlationId !== undefined) {\n    result.correlationId = options.correlationId;\n  }\n  if (options.layer !== undefined) {\n    result.layer = options.layer;\n  }\n\n  return result;\n}\n\nexport const Errors = {\n  notAuthenticated: (message?: string, opts?: { readonly failure_mode?: FailureMode }) =>\n    new CapxulError(\n      \"NOT_AUTHENTICATED\",\n      message ?? \"Not authenticated\",\n      opts?.failure_mode ? { details: { failure_mode: opts.failure_mode } } : undefined,\n    ),\n  emailDeliveryFailed: (detail: string) =>\n    new CapxulError(\"EMAIL_DELIVERY_FAILED\", \"Failed to send email\", {\n      details: { detail },\n    }),\n\n  profileNotFound: (authUserId: string) =>\n    new CapxulError(\"PROFILE_NOT_FOUND\", `Profile not found for user ${authUserId}`, {\n      details: { authUserId },\n    }),\n\n  smartAccountMissing: (authUserId: string) =>\n    new CapxulError(\"SMART_ACCOUNT_MISSING\", \"Smart account not provisioned\", {\n      details: { authUserId },\n    }),\n\n  playerNotFound: (playerId?: string) =>\n    new CapxulError(\n      \"PLAYER_NOT_FOUND\",\n      playerId ? `Openfort player ${playerId} not found` : \"Openfort player not found\",\n      playerId === undefined ? undefined : { details: { playerId } },\n    ),\n\n  accountNotFound: (accountId?: string) =>\n    new CapxulError(\n      \"ACCOUNT_NOT_FOUND\",\n      accountId ? `Openfort account ${accountId} not found` : \"Openfort account not found\",\n      accountId === undefined ? undefined : { details: { accountId } },\n    ),\n\n  providerError: (\n    provider: string,\n    operation: string,\n    cause: unknown,\n    opts?: { readonly failure_mode?: FailureMode },\n  ) => {\n    const details: Record<string, unknown> = { provider, operation };\n    if (opts?.failure_mode) {\n      details.failure_mode = opts.failure_mode;\n    }\n    return new CapxulError(\"PROVIDER_ERROR\", `Provider error: ${provider} ${operation}`, {\n      cause,\n      details,\n    });\n  },\n\n  invalidInput: (field: string, reason: string) =>\n    new CapxulError(\"INVALID_INPUT\", `Invalid ${field}: ${reason}`, {\n      details: { field, reason },\n    }),\n\n  envMissing: (name: string) =>\n    new CapxulError(\"ENV_MISSING\", `Environment variable ${name} not configured`, {\n      details: { name },\n    }),\n\n  notImplemented: (domain: string, method: string) =>\n    new CapxulError(\n      \"NOT_IMPLEMENTED\",\n      `${domain}.${method} is not yet implemented. This feature is planned for a future release.`,\n      { details: { domain, method } },\n    ),\n\n  /**\n   * Sibling factory to {@link Errors.providerError} for the per-state timeout\n   * path in flows. Same `PROVIDER_ERROR` code as\n   * `providerError`, plus a `details.reason: \"timeout\"` discriminator so\n   * downstream observers can distinguish failure modes without parsing the\n   * message string. The redacted message names the timeout budget; the\n   * native `cause` carries the same information for `reportError` fidelity.\n   */\n  providerTimeout: (provider: string, operation: string, timeoutMs: number) =>\n    new CapxulError(\n      \"PROVIDER_ERROR\",\n      `Provider error: ${provider} ${operation} (timeout exceeded ${timeoutMs}ms)`,\n      {\n        details: { provider, operation, reason: \"timeout\" },\n        cause: new Error(`timeout: ${operation} exceeded ${timeoutMs}ms`),\n      },\n    ),\n\n  verificationRequired: (details: VerificationRequiredDetails) => {\n    const message =\n      \"rail\" in details\n        ? `Verification is required before ${details.rail} can use ${details.currentKind}.`\n        : `Verification tier ${details.requiredTier} is required.`;\n\n    return new CapxulError(\"VERIFICATION_REQUIRED\", message, {\n      details,\n    });\n  },\n\n  insufficientBalance: (asset: string, available: string, required: string) =>\n    new CapxulError(\"INSUFFICIENT_BALANCE\", `Insufficient ${asset} balance`, {\n      details: { asset, available, required },\n    }),\n\n  invalidRecipient: (reason: string) =>\n    new CapxulError(\"INVALID_RECIPIENT\", `Invalid recipient: ${reason}`, {\n      details: { reason },\n    }),\n\n  /**\n   * The org Zodiac Roles modifier REFUSED the spend on-chain (G4 · #547): the\n   * member's role condition (per-tx cap, per-day allowance, allowed recipient,\n   * or membership) was violated, so `execTransactionWithRole` reverted. This is\n   * a PERMISSION denial — explicitly NOT an `INSUFFICIENT_BALANCE` (the treasury\n   * held the funds; the role's authority is what bound). `reason` discriminates\n   * the violated condition (`over_cap` / `daily_cap` / `not_member` /\n   * `disallowed_recipient` / `condition_violation`); leak-safe — no on-chain\n   * identifiers ever enter the details.\n   */\n  rolePermissionDenied: (details: {\n    readonly reason:\n      | \"over_cap\"\n      | \"daily_cap\"\n      | \"not_member\"\n      | \"disallowed_recipient\"\n      | \"condition_violation\";\n    readonly operation?: string;\n  }) =>\n    new CapxulError(\n      \"ROLE_PERMISSION_DENIED\",\n      `Org role denied this spend on-chain (${details.reason}).`,\n      {\n        details:\n          details.operation === undefined\n            ? { reason: details.reason }\n            : { reason: details.reason, operation: details.operation },\n      },\n    ),\n\n  /**\n   * A transaction (or sponsored UserOp) failed. `details.reason` discriminates\n   * the failure mode for callers that must distinguish a CONFIRMED on-chain\n   * revert (`\"onchain_revert\"` — the op executed and reverted, e.g. a Zodiac\n   * Roles condition violation) from an inconclusive infra failure. A confirmed\n   * revert is the ONLY mode the org spend port may map to a roles denial.\n   */\n  transactionFailed: (operation: string, cause?: unknown, extra?: { readonly reason?: string }) =>\n    new CapxulError(\"TRANSACTION_FAILED\", `Transaction failed: ${operation}`, {\n      cause,\n      details: extra?.reason === undefined ? { operation } : { operation, reason: extra.reason },\n    }),\n\n  rateLimited: (details?: { readonly retryAfterMs?: number; readonly resource?: string }) =>\n    new CapxulError(\n      \"RATE_LIMITED\",\n      \"Rate limit exceeded\",\n      details === undefined ? undefined : { details: { ...details } },\n    ),\n\n  networkError: (operation: string, cause?: unknown) =>\n    new CapxulError(\"NETWORK_ERROR\", `Network error during ${operation}`, {\n      cause,\n      details: { operation },\n    }),\n\n  unknown: (cause?: unknown) => new CapxulError(\"UNKNOWN\", \"Unknown error\", { cause }),\n\n  otpExpired: (details?: { readonly email?: string; readonly expiredAt?: number }) =>\n    new CapxulError(\n      \"OTP_EXPIRED\",\n      \"Verification code has expired. Request a new one.\",\n      details === undefined ? undefined : { details: { ...details } },\n    ),\n\n  signerRejected: (details: {\n    readonly source: SignerSource;\n    readonly reason?: string;\n    readonly cause?: unknown;\n  }) =>\n    new CapxulError(\"SIGNER_REJECTED\", \"Signer rejected the request.\", {\n      cause: details.cause,\n      details:\n        details.reason === undefined\n          ? { source: details.source }\n          : { source: details.source, reason: details.reason },\n    }),\n\n  cancelled: (details?: { readonly operation?: string; readonly reason?: string }) =>\n    new CapxulError(\n      \"CANCELLED\",\n      \"Operation was cancelled.\",\n      details === undefined ? undefined : { details: { ...details } },\n    ),\n\n  /**\n   * Method called from a flow state where its precondition fails (TA16). The\n   * SDK's method API short-circuits with this error before driving the\n   * internal state machine. `currentState` is the Effect-machine snapshot\n   * tag (stringified from the SDK's actor-shell snapshot; see\n   * `packages/errors/CONTEXT.md`); `validStates`\n   * enumerates the states the method accepts.\n   */\n  wrongState: (details: {\n    readonly method: string;\n    readonly currentState: string;\n    readonly validStates: readonly string[];\n  }) =>\n    new CapxulError(\n      \"WRONG_STATE\",\n      `${details.method} called from state '${details.currentState}'; valid states: ${details.validStates.join(\", \")}`,\n      { details: { ...details, validStates: [...details.validStates] } },\n    ),\n} as const;\n","// Shared `decodeConvexError` helper (TA5) — used by both the SDK's\n// `ConvexCallAdapter.mapToCapxulError` AND the backend `credentials/http.ts`\n// `bootstrapClient` handler. Single source of truth for cross-Convex-boundary\n// error decoding rules.\n//\n// Recognizes the `ConvexError(SerializedCapxulError)` object-shape produced by\n// `withErrorBoundary` (Probe B finding, 2026-05-19):\n//\n//   { name: \"ConvexError\", data: { code, message, details?, correlationId?, layer? } }\n//\n// AND the defensive string-shape branch for older Convex versions where\n// `data` is a JSON-serialized string. Pass-through for raw `CapxulError`\n// instances (which arrive directly when the throw happened in the same\n// V8 isolate as the catch). Returns null when the value is not a\n// recognizable shape — the caller falls back to NETWORK_ERROR + reportError.\n\nimport {\n  CAPXUL_ERROR_CODES,\n  CapxulError,\n  type CapxulErrorCode,\n  type SerializedCapxulError,\n  deserializeCapxulError,\n} from \"./errors.ts\";\n\n// Derived from the canonical catalog in errors.ts — single source of truth,\n// so a new code added to `CAPXUL_ERROR_CODES` is recognized here automatically.\nconst KNOWN_CODES: ReadonlySet<CapxulErrorCode> = new Set(CAPXUL_ERROR_CODES);\n\nfunction isCapxulCode(value: unknown): value is CapxulErrorCode {\n  return typeof value === \"string\" && KNOWN_CODES.has(value as CapxulErrorCode);\n}\n\nfunction reconstruct(serialized: Record<string, unknown>): CapxulError | null {\n  if (!isCapxulCode(serialized.code)) return null;\n  const payload: SerializedCapxulError = {\n    code: serialized.code,\n    message: typeof serialized.message === \"string\" ? serialized.message : String(serialized.code),\n    ...(typeof serialized.details === \"object\" &&\n    serialized.details !== null &&\n    !Array.isArray(serialized.details)\n      ? { details: serialized.details as Record<string, unknown> }\n      : {}),\n    ...(typeof serialized.correlationId === \"string\"\n      ? { correlationId: serialized.correlationId }\n      : {}),\n    ...(typeof serialized.layer === \"string\" ? { layer: serialized.layer } : {}),\n  };\n  return deserializeCapxulError(payload);\n}\n\nexport function decodeConvexError(err: unknown): CapxulError | null {\n  if (err === null || err === undefined) return null;\n\n  // Pass-through: same isolate, real CapxulError instance.\n  if (err instanceof CapxulError) return err;\n\n  if (typeof err !== \"object\") return null;\n\n  // The canonical shape produced by `withErrorBoundary` then crossed by\n  // Convex's `ctx.runQuery` / `ConvexHttpClient`: a `ConvexError` whose\n  // `data` is the `SerializedCapxulError` object literal.\n  const record = err as Record<string, unknown>;\n  if (!(\"data\" in record)) return null;\n  const data = record.data;\n\n  if (typeof data === \"object\" && data !== null) {\n    return reconstruct(data as Record<string, unknown>);\n  }\n\n  // Defensive depth — some Convex versions JSON-stringify the data at\n  // the runtime boundary. Probe B confirmed @convex-dev/better-auth 0.10.13\n  // + convex 1.39.x do NOT do this, but the cheap parse keeps forward\n  // compatibility.\n  if (typeof data === \"string\") {\n    try {\n      const parsed = JSON.parse(data) as unknown;\n      if (typeof parsed === \"object\" && parsed !== null) {\n        return reconstruct(parsed as Record<string, unknown>);\n      }\n    } catch {\n      // Fall through.\n    }\n  }\n\n  return null;\n}\n","import { Errors } from \"@capxul/errors\";\nimport type { CapxulClient } from \"@capxul/sdk\";\n\n/**\n * Narrow the bootstrap-nullable client to a ready client inside a query /\n * mutation function (sdk-provider-owned-bootstrap.md). Data hooks gate their\n * queries on `enabled: client !== null`, so this only ever throws for a mutation\n * triggered while `<CapxulProvider>` is still bootstrapping.\n */\nexport function requireBootstrappedClient(\n  client: CapxulClient | null,\n  method: string,\n): CapxulClient {\n  if (client === null) {\n    throw Errors.wrongState({ method, currentState: \"bootstrapping\", validStates: [\"ready\"] });\n  }\n  return client;\n}\n","import type { TelemetryPort } from \"@capxul/sdk\";\nimport type { CapxulResult } from \"@capxul/sdk\";\n\n/**\n * Unwrap a `CapxulResult` for TanStack query/mutation functions and throw into\n * React Query's error path.\n *\n * Failure observation belongs to the core SDK method boundary. The legacy\n * telemetry/operation arguments remain temporarily source-compatible with the\n * existing hook call sites, but are deliberately ignored so React cannot\n * report the same logical failure a second time.\n */\nexport function unwrapCapxulResult<T>(\n  result: CapxulResult<T>,\n  _legacyTelemetry?: TelemetryPort,\n  _legacyOperation: \"query\" | \"mutation\" = \"query\",\n): T {\n  if (result.ok) {\n    return result.value;\n  }\n  throw result.error;\n}\n","\"use client\";\n\nimport { useQuery, type UseQueryResult } from \"@tanstack/react-query\";\n\nimport type { CapxulError, Profile } from \"@capxul/sdk\";\n\nimport { useCapxulClientOrNull } from \"../internal/capxul-client-context\";\nimport { requireBootstrappedClient } from \"../internal/require-bootstrapped-client\";\nimport { capxulKeys } from \"../internal/reactivity-keys\";\nimport { unwrapCapxulResult } from \"../internal/unwrap-capxul-result\";\nimport { useCapxulIdentityOrNull } from \"../identity\";\n\nexport type UseCapxulProfileReturn = UseQueryResult<Profile | null, CapxulError>;\n\nexport function useCapxulProfile(): UseCapxulProfileReturn {\n  const client = useCapxulClientOrNull();\n  const identity = useCapxulIdentityOrNull();\n  return useQuery({\n    queryKey: capxulKeys.profile,\n    queryFn: async () =>\n      unwrapCapxulResult(\n        await requireBootstrappedClient(client, \"identity.loadCurrent\").identity.loadCurrent(),\n        client!._internal.telemetry,\n      ),\n    // loadCurrent answers null while the auth session snapshot is still\n    // restoring — indistinguishable from \"no profile\". Fetching before the\n    // session is restored caches that null for the whole page lifetime.\n    enabled: client !== null && identity?.phase === \"authenticated\",\n  });\n}\n","\"use client\";\n\nimport { useQuery, type UseQueryResult } from \"@tanstack/react-query\";\n\nimport type { Account, CapxulError } from \"@capxul/sdk\";\n\nimport { useCapxulClientOrNull } from \"../internal/capxul-client-context\";\nimport { requireBootstrappedClient } from \"../internal/require-bootstrapped-client\";\nimport { capxulKeys } from \"../internal/reactivity-keys\";\nimport { unwrapCapxulResult } from \"../internal/unwrap-capxul-result\";\n\nexport type UseCapxulAccountBalanceReturn = UseQueryResult<Account, CapxulError>;\n\nexport type UseCapxulAccountBalanceOptions = {\n  /** When false, skips the Convex readBalance action until the account ladder is ready. */\n  readonly enabled?: boolean;\n};\n\nexport function useCapxulAccountBalance(\n  options?: UseCapxulAccountBalanceOptions,\n): UseCapxulAccountBalanceReturn {\n  const client = useCapxulClientOrNull();\n  return useQuery({\n    queryKey: capxulKeys.accountBalance,\n    queryFn: async () => {\n      const bootstrappedClient = requireBootstrappedClient(client, \"accounts.read\");\n      return unwrapCapxulResult(\n        await bootstrappedClient.accounts.read(),\n        bootstrappedClient._internal.telemetry,\n      );\n    },\n    enabled: client !== null && (options?.enabled ?? true),\n  });\n}\n","\"use client\";\n\nimport { useMutation, useQueryClient, type UseMutationResult } from \"@tanstack/react-query\";\n\nimport { useCapxulClientOrNull } from \"../internal/capxul-client-context\";\nimport { requireBootstrappedClient } from \"../internal/require-bootstrapped-client\";\nimport { capxulKeys } from \"../internal/reactivity-keys\";\nimport { unwrapCapxulResult } from \"../internal/unwrap-capxul-result\";\nimport type { CapxulError, Money } from \"@capxul/sdk\";\n\nexport type UseCapxulAccountFundReturn = UseMutationResult<\n  { readonly txHash: string },\n  CapxulError,\n  Money\n>;\n\nexport function useCapxulAccountFund(): UseCapxulAccountFundReturn {\n  const client = useCapxulClientOrNull();\n  const queryClient = useQueryClient();\n  return useMutation({\n    mutationFn: async (amount: Money) => {\n      const bootstrappedClient = requireBootstrappedClient(client, \"_internal.accounts.fund\");\n      return unwrapCapxulResult(\n        await bootstrappedClient._internal.accounts.fund(amount),\n        bootstrappedClient._internal.telemetry,\n        \"mutation\",\n      );\n    },\n    onSuccess: async () => {\n      await queryClient.invalidateQueries({ queryKey: capxulKeys.accountBalance });\n    },\n  });\n}\n","\"use client\";\n\nimport {\n  useMutation,\n  useQuery,\n  useQueryClient,\n  type UseMutationResult,\n  type UseQueryResult,\n} from \"@tanstack/react-query\";\n\nimport { Errors } from \"@capxul/errors\";\nimport type {\n  AccountId,\n  CapxulError,\n  SubAccount,\n  SubAccountId,\n  TransferInput,\n  TransferResult,\n} from \"@capxul/sdk\";\n\nimport { useCapxulClientOrNull } from \"../internal/capxul-client-context\";\nimport { requireBootstrappedClient } from \"../internal/require-bootstrapped-client\";\nimport { capxulKeys } from \"../internal/reactivity-keys\";\nimport { unwrapCapxulResult } from \"../internal/unwrap-capxul-result\";\n\nexport type UseCapxulSubAccountsListOptions = {\n  readonly enabled?: boolean;\n};\n\nexport type UseCapxulSubAccountsListReturn = UseQueryResult<readonly SubAccount[], CapxulError>;\n\nexport function useCapxulSubAccountsList(\n  accountId: AccountId | undefined,\n  options?: UseCapxulSubAccountsListOptions,\n): UseCapxulSubAccountsListReturn {\n  const client = useCapxulClientOrNull();\n  return useQuery({\n    queryKey: capxulKeys.subAccounts(accountId),\n    queryFn: async () => {\n      if (accountId === undefined) {\n        throw Errors.invalidInput(\"accountId\", \"required for subAccounts.list\");\n      }\n      const bootstrappedClient = requireBootstrappedClient(client, \"subAccounts.list\");\n      return unwrapCapxulResult(\n        await bootstrappedClient.subAccounts.list(accountId),\n        bootstrappedClient._internal.telemetry,\n      );\n    },\n    enabled: client !== null && (options?.enabled ?? true) && accountId !== undefined,\n  });\n}\n\nexport type UseCapxulSubAccountCreateReturn = UseMutationResult<\n  SubAccount,\n  CapxulError,\n  { readonly accountId: AccountId; readonly name: string }\n>;\n\nexport function useCapxulSubAccountCreate(): UseCapxulSubAccountCreateReturn {\n  const client = useCapxulClientOrNull();\n  const queryClient = useQueryClient();\n  return useMutation({\n    mutationFn: async (input) => {\n      const bootstrappedClient = requireBootstrappedClient(client, \"subAccounts.create\");\n      return unwrapCapxulResult(\n        await bootstrappedClient.subAccounts.create(input.accountId, { name: input.name }),\n        bootstrappedClient._internal.telemetry,\n        \"mutation\",\n      );\n    },\n    onSuccess: async (_value, variables) => {\n      await queryClient.invalidateQueries({\n        queryKey: capxulKeys.subAccounts(variables.accountId),\n      });\n      await queryClient.invalidateQueries({ queryKey: capxulKeys.accountBalance });\n    },\n  });\n}\n\nexport type UseCapxulSubAccountRenameReturn = UseMutationResult<\n  SubAccount,\n  CapxulError,\n  { readonly accountId: AccountId; readonly subAccountId: SubAccountId; readonly name: string }\n>;\n\nexport function useCapxulSubAccountRename(): UseCapxulSubAccountRenameReturn {\n  const client = useCapxulClientOrNull();\n  const queryClient = useQueryClient();\n  return useMutation({\n    mutationFn: async (input) => {\n      const bootstrappedClient = requireBootstrappedClient(client, \"subAccounts.rename\");\n      return unwrapCapxulResult(\n        await bootstrappedClient.subAccounts.rename(input.subAccountId, input.name),\n        bootstrappedClient._internal.telemetry,\n        \"mutation\",\n      );\n    },\n    onSuccess: async (_value, variables) => {\n      await queryClient.invalidateQueries({\n        queryKey: capxulKeys.subAccounts(variables.accountId),\n      });\n      await queryClient.invalidateQueries({ queryKey: capxulKeys.accountBalance });\n    },\n  });\n}\n\nexport type UseCapxulSubAccountDeleteReturn = UseMutationResult<\n  void,\n  CapxulError,\n  { readonly accountId: AccountId; readonly subAccountId: SubAccountId }\n>;\n\nexport function useCapxulSubAccountDelete(): UseCapxulSubAccountDeleteReturn {\n  const client = useCapxulClientOrNull();\n  const queryClient = useQueryClient();\n  return useMutation({\n    mutationFn: async (input) => {\n      const bootstrappedClient = requireBootstrappedClient(client, \"subAccounts.delete\");\n      return unwrapCapxulResult(\n        await bootstrappedClient.subAccounts.delete(input.subAccountId),\n        bootstrappedClient._internal.telemetry,\n        \"mutation\",\n      );\n    },\n    onSuccess: async (_value, variables) => {\n      await queryClient.invalidateQueries({\n        queryKey: capxulKeys.subAccounts(variables.accountId),\n      });\n      await queryClient.invalidateQueries({ queryKey: capxulKeys.accountBalance });\n    },\n  });\n}\n\n/**\n * Move money between two of the SAME Account's balances (canon §5/§12). The\n * consumer-facing labels are \"Add money\" (main → sub) and \"Move money out\"\n * (sub → main), both calling `transfer`. `accountId` is carried only to\n * invalidate the right cache keys; the SDK input itself is `{ from, to, amount }`.\n */\nexport type UseCapxulTransferReturn = UseMutationResult<\n  TransferResult,\n  CapxulError,\n  { readonly accountId: AccountId } & TransferInput\n>;\n\nexport function useCapxulTransfer(): UseCapxulTransferReturn {\n  const client = useCapxulClientOrNull();\n  const queryClient = useQueryClient();\n  return useMutation({\n    mutationFn: async ({ from, to, amount }) => {\n      const bootstrappedClient = requireBootstrappedClient(client, \"subAccounts.transfer\");\n      return unwrapCapxulResult(\n        await bootstrappedClient.subAccounts.transfer({ from, to, amount }),\n        bootstrappedClient._internal.telemetry,\n        \"mutation\",\n      );\n    },\n    onSuccess: async (_value, variables) => {\n      await queryClient.invalidateQueries({\n        queryKey: capxulKeys.subAccounts(variables.accountId),\n      });\n      await queryClient.invalidateQueries({ queryKey: capxulKeys.accountBalance });\n    },\n  });\n}\n","import type { QueryClient } from \"@tanstack/react-query\";\n\nimport type { ActorReference, OrgId, Payment } from \"@capxul/sdk\";\n\nimport { capxulKeys } from \"./reactivity-keys\";\n\n/**\n * Actor scope a money mutation settled under.\n *\n * #1145 (DEMOLITION §D5): the insights, address-book and org-`account`\n * invalidations this used to fan out to named queries that no hook creates any\n * more — the actor-scope family and `useCapxulOrganizationAccount` are deleted.\n * Invalidating a key nothing reads is a no-op that reads as coverage.\n */\ntype MoneyActorScope =\n  | { readonly kind: \"account\" }\n  | { readonly kind: \"org\"; readonly orgId: string }\n  | ActorReference;\n\nexport function isPayment(value: unknown): value is Payment {\n  if (typeof value !== \"object\" || value === null) return false;\n  const record = value as Record<string, unknown>;\n  return (\n    typeof record.id === \"string\" &&\n    typeof record.status === \"string\" &&\n    typeof record.paymentType === \"string\" &&\n    typeof record.amount === \"object\" &&\n    record.amount !== null\n  );\n}\n\nexport function paymentsFromValue(value: unknown): readonly Payment[] {\n  if (Array.isArray(value)) return value.filter(isPayment);\n  if (isPayment(value)) return [value];\n  if (typeof value !== \"object\" || value === null) return [];\n  const payments = (value as Record<string, unknown>).payments;\n  return Array.isArray(payments) ? payments.filter(isPayment) : [];\n}\n\nexport async function invalidateMoneyState(\n  queryClient: QueryClient,\n  input: {\n    readonly actor: MoneyActorScope;\n    readonly payment?: Payment;\n  },\n): Promise<void> {\n  const invalidations = [queryClient.invalidateQueries({ queryKey: capxulKeys.payments })];\n\n  if (input.payment !== undefined) {\n    invalidations.push(\n      queryClient.invalidateQueries({ queryKey: capxulKeys.payment(input.payment.id) }),\n    );\n  }\n\n  if (input.actor.kind === \"account\" || input.actor.kind === \"personal\") {\n    invalidations.push(queryClient.invalidateQueries({ queryKey: capxulKeys.accountBalance }));\n  } else {\n    const orgId = (\n      input.actor.kind === \"org\" ? input.actor.orgId : input.actor.organizationId\n    ) as OrgId;\n    invalidations.push(queryClient.invalidateQueries({ queryKey: capxulKeys.orgTreasury(orgId) }));\n  }\n\n  await Promise.all(invalidations);\n}\n","import { Errors } from \"@capxul/errors\";\n\n/**\n * Guard for mutation hooks whose variables carry an optional `actor` field\n * (`useCapxulPay`, `useCapxulPayout`, `useCapxulAddDestination`,\n * `useCapxulRemoveDestination`). Mirrors `requireActorScope` on the query path:\n * an EXPLICITLY-passed `actor: undefined` (the `capxulOrgScope(notYetLoadedOrgId)`\n * footgun) must fail loudly rather than silently fall back to the personal\n * scope. Omitting the `actor` key entirely keeps the personal-scope default.\n *\n * Throws `CapxulError` code `INVALID_INPUT` with `details.field === \"actor\"`;\n * called inside an async mutationFn it surfaces as `mutation.error: CapxulError`.\n */\nexport function rejectUnresolvedActor(variables: object, operation: string): void {\n  if (\n    Object.hasOwn(variables, \"actor\") &&\n    (variables as { readonly actor?: unknown }).actor === undefined\n  ) {\n    throw Errors.invalidInput(\n      \"actor\",\n      `explicitly provided but undefined for ${operation} — actor scope not yet resolved; omit actor for the personal scope`,\n    );\n  }\n}\n","\"use client\";\n\nimport {\n  useMutation,\n  useQuery,\n  useQueryClient,\n  type UseMutationResult,\n  type UseQueryResult,\n} from \"@tanstack/react-query\";\n\nimport { Errors } from \"@capxul/errors\";\nimport type {\n  Payment,\n  PaymentsPayInput,\n  PaymentsPayoutInput,\n  PaymentsWithdrawInput,\n} from \"@capxul/sdk\";\nimport type { CapxulError } from \"@capxul/sdk\";\n\nimport { useCapxulClientOrNull } from \"../internal/capxul-client-context\";\nimport { invalidateMoneyState } from \"../internal/invalidate-money-state\";\nimport { rejectUnresolvedActor } from \"../internal/reject-unresolved-actor\";\nimport { requireBootstrappedClient } from \"../internal/require-bootstrapped-client\";\nimport { capxulKeys } from \"../internal/reactivity-keys\";\nimport { unwrapCapxulResult } from \"../internal/unwrap-capxul-result\";\n\nexport type UseCapxulPayReturn = UseMutationResult<Payment, CapxulError, PaymentsPayInput>;\nexport function useCapxulPay(): UseCapxulPayReturn {\n  const client = useCapxulClientOrNull();\n  const queryClient = useQueryClient();\n  return useMutation({\n    mutationFn: async (input) => {\n      rejectUnresolvedActor(input, \"payments.pay\");\n      const bootstrappedClient = requireBootstrappedClient(client, \"payments.pay\");\n      return unwrapCapxulResult(\n        await bootstrappedClient.payments.pay(input),\n        bootstrappedClient._internal.telemetry,\n        \"mutation\",\n      );\n    },\n    onSuccess: async (payment) => {\n      await invalidateMoneyState(queryClient, { actor: { kind: \"personal\" }, payment });\n    },\n  });\n}\n\nexport type UseCapxulPayoutReturn = UseMutationResult<Payment, CapxulError, PaymentsPayoutInput>;\nexport function useCapxulPayout(): UseCapxulPayoutReturn {\n  const client = useCapxulClientOrNull();\n  const queryClient = useQueryClient();\n  return useMutation({\n    mutationFn: async (input) => {\n      rejectUnresolvedActor(input, \"payments.payout\");\n      const bootstrappedClient = requireBootstrappedClient(client, \"payments.payout\");\n      return unwrapCapxulResult(\n        await bootstrappedClient.payments.payout(input),\n        bootstrappedClient._internal.telemetry,\n        \"mutation\",\n      );\n    },\n    onSuccess: async (payment, variables) => {\n      const actor = variables.actor ?? { kind: \"personal\" as const };\n      await invalidateMoneyState(queryClient, { actor, payment });\n    },\n  });\n}\n\nexport type UseCapxulWithdrawReturn = UseMutationResult<\n  Payment,\n  CapxulError,\n  PaymentsWithdrawInput\n>;\nexport function useCapxulWithdraw(): UseCapxulWithdrawReturn {\n  const client = useCapxulClientOrNull();\n  const queryClient = useQueryClient();\n  return useMutation({\n    mutationFn: async (input) => {\n      const bootstrappedClient = requireBootstrappedClient(client, \"payments.withdraw\");\n      return unwrapCapxulResult(\n        await bootstrappedClient.payments.withdraw(input),\n        bootstrappedClient._internal.telemetry,\n        \"mutation\",\n      );\n    },\n    onSuccess: async (payment) => {\n      await invalidateMoneyState(queryClient, { actor: { kind: \"personal\" }, payment });\n    },\n  });\n}\n\nexport type UseCapxulPaymentsReturn = UseQueryResult<readonly Payment[], CapxulError>;\nexport function useCapxulPayments(options?: {\n  readonly enabled?: boolean;\n}): UseCapxulPaymentsReturn {\n  const client = useCapxulClientOrNull();\n  return useQuery({\n    queryKey: capxulKeys.payments,\n    queryFn: async () => {\n      const bootstrappedClient = requireBootstrappedClient(client, \"payments.list\");\n      return unwrapCapxulResult(\n        await bootstrappedClient.payments.list(),\n        bootstrappedClient._internal.telemetry,\n      );\n    },\n    enabled: client !== null && (options?.enabled ?? true),\n  });\n}\n\nexport type UseCapxulPaymentReturn = UseQueryResult<Payment | null, CapxulError>;\nexport function useCapxulPayment(\n  paymentId: string | undefined,\n  options?: { readonly enabled?: boolean },\n): UseCapxulPaymentReturn {\n  const client = useCapxulClientOrNull();\n  return useQuery({\n    queryKey: capxulKeys.payment(paymentId),\n    queryFn: async () => {\n      if (paymentId === undefined)\n        throw Errors.invalidInput(\"paymentId\", \"required for payments.get\");\n      const bootstrappedClient = requireBootstrappedClient(client, \"payments.get\");\n      return unwrapCapxulResult(\n        await bootstrappedClient.payments.get(paymentId),\n        bootstrappedClient._internal.telemetry,\n      );\n    },\n    enabled: client !== null && paymentId !== undefined && (options?.enabled ?? true),\n  });\n}\n","\"use client\";\n\nimport { useQuery, type UseQueryResult } from \"@tanstack/react-query\";\n\nimport type { CapxulError, OrgView } from \"@capxul/sdk\";\n\nimport { useCapxulClientOrNull } from \"../internal/capxul-client-context\";\nimport { requireBootstrappedClient } from \"../internal/require-bootstrapped-client\";\nimport { capxulKeys } from \"../internal/reactivity-keys\";\nimport { unwrapCapxulResult } from \"../internal/unwrap-capxul-result\";\n\n/**\n * List the Orgs you belong to (canon §C1 \"Org list\" / §C3). Binds directly to\n * the locked `capxul.orgs()` SDK method.\n */\nexport type UseCapxulOrgsReturn = UseQueryResult<readonly OrgView[], CapxulError>;\n\nexport type UseCapxulOrgsOptions = {\n  /**\n   * Gate the query on auth readiness. `client.orgs()` is a session-scoped\n   * authenticated read; firing it before the session token settles surfaces a\n   * spurious `NOT_AUTHENTICATED`. Consumers pass `enabled: <auth-ready>` (e.g.\n   * \"the Organization surface is active\") — mirrors `useCapxulSubAccountsList`.\n   * Defaults to `true` to preserve the bare `useCapxulOrgs()` call shape.\n   */\n  readonly enabled?: boolean;\n};\n\nexport function useCapxulOrgs(options?: UseCapxulOrgsOptions): UseCapxulOrgsReturn {\n  const client = useCapxulClientOrNull();\n  return useQuery({\n    queryKey: capxulKeys.orgs,\n    queryFn: async () => {\n      const bootstrappedClient = requireBootstrappedClient(client, \"orgs\");\n      return unwrapCapxulResult(\n        await bootstrappedClient.orgs(),\n        bootstrappedClient._internal.telemetry,\n      );\n    },\n    enabled: client !== null && (options?.enabled ?? true),\n  });\n}\n","\"use client\";\n\nimport { useQuery, type UseQueryResult } from \"@tanstack/react-query\";\n\nimport { Errors } from \"@capxul/errors\";\nimport type { CapxulError, MemberView, OrgId } from \"@capxul/sdk\";\n\nimport { useCapxulClientOrNull } from \"../internal/capxul-client-context\";\nimport { capxulKeys } from \"../internal/reactivity-keys\";\nimport { requireBootstrappedClient } from \"../internal/require-bootstrapped-client\";\nimport { unwrapCapxulResult } from \"../internal/unwrap-capxul-result\";\n\nexport type UseCapxulOrgMembersOptions = {\n  readonly enabled?: boolean;\n};\n\n/**\n * The members of an Org (canon §C1 \"Members\" / §C3, D8/D9). Binds directly to\n * the entity-scoped `capxul.org(orgId).members()` (D13). Gated by\n * `orgId !== undefined`; callers may additionally gate on canonical identity\n * readiness through `options.enabled`.\n */\nexport type UseCapxulOrgMembersReturn = UseQueryResult<readonly MemberView[], CapxulError>;\n\nexport function useCapxulOrgMembers(\n  orgId: OrgId | undefined,\n  options?: UseCapxulOrgMembersOptions,\n): UseCapxulOrgMembersReturn {\n  const client = useCapxulClientOrNull();\n  const enabled = options?.enabled ?? true;\n  return useQuery({\n    queryKey: capxulKeys.orgMembers(orgId),\n    queryFn: async () => {\n      if (orgId === undefined) {\n        throw Errors.invalidInput(\"orgId\", \"required for useCapxulOrgMembers\");\n      }\n      const bootstrappedClient = requireBootstrappedClient(client, \"org.members\");\n      return unwrapCapxulResult(\n        await bootstrappedClient.org(orgId).members(),\n        bootstrappedClient._internal.telemetry,\n      );\n    },\n    enabled: client !== null && enabled && orgId !== undefined,\n  });\n}\n","\"use client\";\n\nimport { useQuery, type UseQueryResult } from \"@tanstack/react-query\";\n\nimport { Errors } from \"@capxul/errors\";\nimport type { CapxulError, OrgId, RoleView } from \"@capxul/sdk\";\n\nimport { useCapxulClientOrNull } from \"../internal/capxul-client-context\";\nimport { capxulKeys } from \"../internal/reactivity-keys\";\nimport { requireBootstrappedClient } from \"../internal/require-bootstrapped-client\";\nimport { unwrapCapxulResult } from \"../internal/unwrap-capxul-result\";\n\nexport type UseCapxulOrgRolesOptions = {\n  readonly enabled?: boolean;\n};\n\n/**\n * The roles seeded on an Org (canon §C1 \"Roles\" / §C3, D4/D6). Binds directly\n * to the entity-scoped `capxul.org(orgId).roles()` (D13). Gated by\n * `orgId !== undefined`. RED until S2.\n */\nexport type UseCapxulOrgRolesReturn = UseQueryResult<readonly RoleView[], CapxulError>;\n\nexport function useCapxulOrgRoles(\n  orgId: OrgId | undefined,\n  options?: UseCapxulOrgRolesOptions,\n): UseCapxulOrgRolesReturn {\n  const client = useCapxulClientOrNull();\n  const enabled = options?.enabled ?? true;\n  return useQuery({\n    queryKey: capxulKeys.orgRoles(orgId),\n    queryFn: async () => {\n      if (orgId === undefined) {\n        throw Errors.invalidInput(\"orgId\", \"required for useCapxulOrgRoles\");\n      }\n      const bootstrappedClient = requireBootstrappedClient(client, \"org.roles\");\n      return unwrapCapxulResult(\n        await bootstrappedClient.org(orgId).roles(),\n        bootstrappedClient._internal.telemetry,\n      );\n    },\n    enabled: client !== null && enabled && orgId !== undefined,\n  });\n}\n","\"use client\";\n\nimport { useMutation, useQueryClient, type UseMutationResult } from \"@tanstack/react-query\";\n\nimport type { CapxulError, OrgId, RoleView } from \"@capxul/sdk\";\n\nimport { useCapxulClientOrNull } from \"../internal/capxul-client-context\";\nimport { capxulKeys } from \"../internal/reactivity-keys\";\nimport { requireBootstrappedClient } from \"../internal/require-bootstrapped-client\";\nimport { unwrapCapxulResult } from \"../internal/unwrap-capxul-result\";\n\nexport type UseCapxulOrgDeployRolesReturn = UseMutationResult<\n  readonly RoleView[],\n  CapxulError,\n  OrgId\n>;\n\nexport function useCapxulOrgDeployRoles(): UseCapxulOrgDeployRolesReturn {\n  const client = useCapxulClientOrNull();\n  const queryClient = useQueryClient();\n  return useMutation({\n    mutationFn: async (orgId: OrgId) => {\n      const bootstrappedClient = requireBootstrappedClient(client, \"org.deployRoles\");\n      return unwrapCapxulResult(\n        await bootstrappedClient.org(orgId).deployRoles(),\n        bootstrappedClient._internal.telemetry,\n        \"mutation\",\n      );\n    },\n    onSuccess: async (_roles, orgId) => {\n      await queryClient.invalidateQueries({ queryKey: capxulKeys.orgRoles(orgId) });\n      await queryClient.invalidateQueries({ queryKey: capxulKeys.org(orgId) });\n      await queryClient.invalidateQueries({ queryKey: capxulKeys.orgs });\n    },\n  });\n}\n","\"use client\";\n\nimport { useQuery, type UseQueryResult } from \"@tanstack/react-query\";\n\nimport { Errors } from \"@capxul/errors\";\nimport type { Account, CapxulError, OrgId } from \"@capxul/sdk\";\n\nimport { useCapxulClientOrNull } from \"../internal/capxul-client-context\";\nimport { capxulKeys } from \"../internal/reactivity-keys\";\nimport { requireBootstrappedClient } from \"../internal/require-bootstrapped-client\";\nimport { unwrapCapxulResult } from \"../internal/unwrap-capxul-result\";\n\nexport type UseCapxulOrgTreasuryOptions = {\n  readonly enabled?: boolean;\n};\n\n/**\n * The Org treasury — the real M2 `Account` over the Org Safe (canon §C3, D3).\n * NEVER `AccountStatus` (the deploy-readiness ladder, no balance). Binds\n * directly to the entity-scoped `capxul.org(orgId).treasury()` (D13). Gated by\n * `orgId !== undefined`. RED until S1.\n */\nexport type UseCapxulOrgTreasuryReturn = UseQueryResult<Account, CapxulError>;\n\nexport function useCapxulOrgTreasury(\n  orgId: OrgId | undefined,\n  options?: UseCapxulOrgTreasuryOptions,\n): UseCapxulOrgTreasuryReturn {\n  const client = useCapxulClientOrNull();\n  const enabled = options?.enabled ?? true;\n  return useQuery({\n    queryKey: capxulKeys.orgTreasury(orgId),\n    queryFn: async () => {\n      if (orgId === undefined) {\n        throw Errors.invalidInput(\"orgId\", \"required for useCapxulOrgTreasury\");\n      }\n      const bootstrappedClient = requireBootstrappedClient(client, \"org.treasury\");\n      return unwrapCapxulResult(\n        await bootstrappedClient.org(orgId).treasury(),\n        bootstrappedClient._internal.telemetry,\n      );\n    },\n    enabled: client !== null && enabled && orgId !== undefined,\n  });\n}\n","\"use client\";\n\nimport { useMutation, useQueryClient, type UseMutationResult } from \"@tanstack/react-query\";\n\nimport type { CapxulError, CreateOrgInput, OrgView } from \"@capxul/sdk\";\n\nimport { useCapxulClientOrNull } from \"../internal/capxul-client-context\";\nimport { capxulKeys } from \"../internal/reactivity-keys\";\nimport { requireBootstrappedClient } from \"../internal/require-bootstrapped-client\";\nimport { unwrapCapxulResult } from \"../internal/unwrap-capxul-result\";\n\n/**\n * Create an Org (canon §C2 J1 / §C3, S1). Binds directly to the locked\n * `capxul.createOrg(input)` SDK method. On success, invalidates the org list.\n * RED until S1 — `mutate` rejects with `Errors.notImplemented(\"org\",\"createOrg\")`.\n */\nexport type UseCapxulCreateOrgReturn = UseMutationResult<OrgView, CapxulError, CreateOrgInput>;\n\nexport function useCapxulCreateOrg(): UseCapxulCreateOrgReturn {\n  const client = useCapxulClientOrNull();\n  const queryClient = useQueryClient();\n  return useMutation({\n    mutationFn: async (input: CreateOrgInput) => {\n      const bootstrappedClient = requireBootstrappedClient(client, \"createOrg\");\n      return unwrapCapxulResult(\n        await bootstrappedClient.createOrg(input),\n        bootstrappedClient._internal.telemetry,\n        \"mutation\",\n      );\n    },\n    onSuccess: async () => {\n      await queryClient.invalidateQueries({ queryKey: capxulKeys.orgs });\n    },\n  });\n}\n","\"use client\";\n\nimport { useMutation, useQueryClient, type UseMutationResult } from \"@tanstack/react-query\";\n\nimport { Errors } from \"@capxul/errors\";\nimport type { CapxulError, InviteMemberInput, MemberView, OrgId } from \"@capxul/sdk\";\n\nimport { useCapxulClientOrNull } from \"../internal/capxul-client-context\";\nimport { capxulKeys } from \"../internal/reactivity-keys\";\nimport { requireBootstrappedClient } from \"../internal/require-bootstrapped-client\";\nimport { unwrapCapxulResult } from \"../internal/unwrap-capxul-result\";\n\n/**\n * Invite a member to an Org by email (canon §C2 J2 virality loop / §C3, S3, D8).\n * Entity-scoped via the closed-over `orgId` (D13). Binds directly to\n * `capxul.org(orgId).invite(input)`. On success, invalidates the member list.\n * RED until S3 — `mutate` rejects with `Errors.notImplemented(\"org\",\"invite\")`.\n */\nexport type UseCapxulInviteMemberReturn = UseMutationResult<\n  MemberView,\n  CapxulError,\n  InviteMemberInput\n>;\n\nexport function useCapxulInviteMember(orgId: OrgId | undefined): UseCapxulInviteMemberReturn {\n  const client = useCapxulClientOrNull();\n  const queryClient = useQueryClient();\n  return useMutation({\n    mutationFn: async (input: InviteMemberInput) => {\n      if (orgId === undefined) {\n        throw Errors.invalidInput(\"orgId\", \"required for useCapxulInviteMember\");\n      }\n      const bootstrappedClient = requireBootstrappedClient(client, \"org.invite\");\n      return unwrapCapxulResult(\n        await bootstrappedClient.org(orgId).invite(input),\n        bootstrappedClient._internal.telemetry,\n        \"mutation\",\n      );\n    },\n    onSuccess: async () => {\n      if (orgId === undefined) return;\n      await queryClient.invalidateQueries({ queryKey: capxulKeys.orgMembers(orgId) });\n    },\n  });\n}\n","\"use client\";\n\nimport { useMutation, useQueryClient, type UseMutationResult } from \"@tanstack/react-query\";\n\nimport { Errors } from \"@capxul/errors\";\nimport type { CapxulError, OrgId, RemoveMemberInput } from \"@capxul/sdk\";\n\nimport { useCapxulClientOrNull } from \"../internal/capxul-client-context\";\nimport { capxulKeys } from \"../internal/reactivity-keys\";\nimport { requireBootstrappedClient } from \"../internal/require-bootstrapped-client\";\nimport { unwrapCapxulResult } from \"../internal/unwrap-capxul-result\";\n\n/**\n * Remove a member from an Org (canon §C2 J2 / §C3, S3, D7/D8) — drives the\n * on-chain REVOKE + Convex mirror. Keyed on the member's personal Safe address\n * (D7). Entity-scoped via the closed-over `orgId` (D13). Binds directly to\n * `capxul.org(orgId).removeMember(input)`. On success, invalidates the member\n * list. RED until S3 — `mutate` rejects with\n * `Errors.notImplemented(\"org\",\"removeMember\")`.\n */\nexport type UseCapxulRemoveMemberReturn = UseMutationResult<void, CapxulError, RemoveMemberInput>;\n\nexport function useCapxulRemoveMember(orgId: OrgId | undefined): UseCapxulRemoveMemberReturn {\n  const client = useCapxulClientOrNull();\n  const queryClient = useQueryClient();\n  return useMutation({\n    mutationFn: async (input: RemoveMemberInput) => {\n      if (orgId === undefined) {\n        throw Errors.invalidInput(\"orgId\", \"required for useCapxulRemoveMember\");\n      }\n      const bootstrappedClient = requireBootstrappedClient(client, \"org.removeMember\");\n      return unwrapCapxulResult(\n        await bootstrappedClient.org(orgId).removeMember(input),\n        bootstrappedClient._internal.telemetry,\n        \"mutation\",\n      );\n    },\n    onSuccess: async () => {\n      if (orgId === undefined) return;\n      await queryClient.invalidateQueries({ queryKey: capxulKeys.orgMembers(orgId) });\n    },\n  });\n}\n","\"use client\";\n\nimport { useMutation, useQueryClient, type UseMutationResult } from \"@tanstack/react-query\";\n\nimport { Errors } from \"@capxul/errors\";\nimport type { AssignRoleInput, CapxulError, MemberView, OrgId } from \"@capxul/sdk\";\n\nimport { useCapxulClientOrNull } from \"../internal/capxul-client-context\";\nimport { capxulKeys } from \"../internal/reactivity-keys\";\nimport { requireBootstrappedClient } from \"../internal/require-bootstrapped-client\";\nimport { unwrapCapxulResult } from \"../internal/unwrap-capxul-result\";\n\n/**\n * Assign a role to a member (canon §C2 J2 / §C3, S3, D7/D9) — drives the\n * on-chain GRANT + Convex mirror. Keyed on the member's personal Safe address\n * (D7); the `role` label maps deterministically to the on-chain `roleKey` (D9).\n * Entity-scoped via the closed-over `orgId` (D13). Binds directly to\n * `capxul.org(orgId).assignRole(input)`. On success, invalidates the member\n * list. RED until S3 — `mutate` rejects with\n * `Errors.notImplemented(\"org\",\"assignRole\")`.\n */\nexport type UseCapxulAssignRoleReturn = UseMutationResult<MemberView, CapxulError, AssignRoleInput>;\n\nexport function useCapxulAssignRole(orgId: OrgId | undefined): UseCapxulAssignRoleReturn {\n  const client = useCapxulClientOrNull();\n  const queryClient = useQueryClient();\n  return useMutation({\n    mutationFn: async (input: AssignRoleInput) => {\n      if (orgId === undefined) {\n        throw Errors.invalidInput(\"orgId\", \"required for useCapxulAssignRole\");\n      }\n      const bootstrappedClient = requireBootstrappedClient(client, \"org.assignRole\");\n      return unwrapCapxulResult(\n        await bootstrappedClient.org(orgId).assignRole(input),\n        bootstrappedClient._internal.telemetry,\n        \"mutation\",\n      );\n    },\n    onSuccess: async () => {\n      if (orgId === undefined) return;\n      await queryClient.invalidateQueries({ queryKey: capxulKeys.orgMembers(orgId) });\n    },\n  });\n}\n","// #1066: the durable onboarding journey record — the proven #844 Reference\n// implementation promoted into the SDK headless layer. Behavior map §3:\n// versioned, sessionStorage-backed, owner-scoped; reload resumes, sign-out\n// clears. This module owns journey DATA and transitions only — mapping a step\n// to a route is the consuming app's projection (apps disagree on paths, never\n// on steps).\nexport type OnboardingIntent = \"personal\" | \"organization\";\nexport type OnboardingStep = \"profile\" | \"organization\" | \"provisioning\";\n\nexport type PayoutDraftChain = \"evm\" | \"solana\" | \"starknet\";\n\nexport type PayoutDraftEntry = {\n  readonly chain: PayoutDraftChain;\n  readonly address: string;\n};\n\nexport type ProfileDraft = {\n  readonly displayName: string;\n  readonly country: string;\n  readonly withdrawalAddress: string;\n  // #1062 / #1063: collected at the profile step, persisted at submit.\n  readonly username?: string;\n  readonly payoutAddresses?: readonly PayoutDraftEntry[];\n};\n\nexport type OrganizationDraft = {\n  readonly name: string;\n  readonly handle: string;\n  readonly country: string;\n  // #1064\n  readonly bio?: string;\n  readonly size?: string;\n};\n\nexport type OnboardingOrigin =\n  | { readonly kind: \"personal\" }\n  | { readonly kind: \"organization\"; readonly organizationId: string }\n  | { readonly kind: \"proof\"; readonly organizationId?: string };\n\nexport type OnboardingJourney = {\n  readonly version: 1;\n  readonly ownerId: string;\n  readonly journeyId: string;\n  readonly intent: OnboardingIntent;\n  readonly entryPoint: \"signup\" | \"dashboard\";\n  readonly origin?: OnboardingOrigin;\n  readonly step: OnboardingStep;\n  readonly profile?: ProfileDraft;\n  readonly organization?: OrganizationDraft;\n  readonly stableHandle?: string;\n  readonly organizationId?: string;\n};\n\n/**\n * The app-facing projection input: where a resumed journey stands. Consumers\n * map this to their own routes.\n */\nexport type OnboardingJourneyPosition = {\n  readonly intent: OnboardingIntent;\n  readonly step: OnboardingStep;\n  readonly organizationId?: string;\n  readonly proof: boolean;\n};\n\nconst JOURNEY_KEY = \"capxul.onboarding.journey.v1\";\nconst VALIDATED_OWNER_KEY = \"capxul.onboarding.validated-owner.v1\";\nconst JOURNEY_VERSION = 1;\nconst MAX_DRAFT_TEXT_LENGTH = 200;\nconst MAX_ID_LENGTH = 160;\nconst MAX_STORED_JOURNEY_LENGTH = 8_192;\nconst MAX_PAYOUT_DRAFT_ENTRIES = 10;\n\n/**\n * The owner whose stored journey may currently be attributed to observations.\n * Persisted in sessionStorage rather than module memory so `currentOnboarding-\n * JourneyId` is a pure function of durable state — attribution is the same\n * regardless of the order of renders, reloads, or telemetry emits. Established\n * only when an authenticated owner is (journey start, or an owner-matched load)\n * and cleared at every auth boundary or on discard.\n */\nfunction markOnboardingOwnerValidated(ownerId: string): void {\n  try {\n    sessionStorage.setItem(VALIDATED_OWNER_KEY, ownerId);\n  } catch {\n    // Browser recovery context is useful but never authoritative domain state.\n  }\n}\n\nfunction clearValidatedOnboardingOwner(): void {\n  try {\n    sessionStorage.removeItem(VALIDATED_OWNER_KEY);\n  } catch {\n    // Domain completion remains durable even if browser cleanup is unavailable.\n  }\n}\n\nfunction validatedOnboardingOwner(): string | null {\n  try {\n    return sessionStorage.getItem(VALIDATED_OWNER_KEY);\n  } catch {\n    return null;\n  }\n}\n\nexport function startOnboardingJourney(input: {\n  readonly intent: OnboardingIntent;\n  readonly ownerId: string;\n  readonly entryPoint: \"signup\" | \"dashboard\";\n  readonly origin?: OnboardingOrigin;\n  readonly step?: OnboardingStep;\n}): OnboardingJourney {\n  const journey: OnboardingJourney = {\n    version: JOURNEY_VERSION,\n    ownerId: input.ownerId,\n    journeyId: `journey_${createRandomId()}`,\n    intent: input.intent,\n    entryPoint: input.entryPoint,\n    step: input.step ?? \"profile\",\n    ...(input.origin === undefined ? {} : { origin: input.origin }),\n  };\n  markOnboardingOwnerValidated(journey.ownerId);\n  saveOnboardingJourney(journey);\n  return journey;\n}\n\nexport function loadOnboardingJourney(expectedOwnerId?: string): OnboardingJourney | null {\n  try {\n    const raw = sessionStorage.getItem(JOURNEY_KEY);\n    if (raw === null) return null;\n    if (raw.length > MAX_STORED_JOURNEY_LENGTH) return discardInvalidJourney();\n    const value: unknown = JSON.parse(raw);\n    if (!isValidJourney(value)) return discardInvalidJourney();\n    if (expectedOwnerId !== undefined && value.ownerId !== expectedOwnerId) {\n      return discardInvalidJourney();\n    }\n    if (expectedOwnerId !== undefined) markOnboardingOwnerValidated(expectedOwnerId);\n    return value;\n  } catch {\n    return discardInvalidJourney();\n  }\n}\n\nexport function saveOnboardingJourney(journey: OnboardingJourney): void {\n  if (!isValidJourney(journey)) {\n    discardInvalidJourney();\n    return;\n  }\n  try {\n    sessionStorage.setItem(JOURNEY_KEY, JSON.stringify(journey));\n  } catch {\n    // Browser recovery context is useful but never authoritative domain state.\n  }\n}\n\nexport function currentOnboardingJourneyId(): string | undefined {\n  const journey = loadOnboardingJourney();\n  const owner = validatedOnboardingOwner();\n  return journey !== null && owner !== null && journey.ownerId === owner\n    ? journey.journeyId\n    : undefined;\n}\n\n/** Stop observation attribution while no authenticated owner is established. */\nexport function invalidateOnboardingJourneyObservation(): void {\n  clearValidatedOnboardingOwner();\n}\n\n/** Where the journey stands — the pure position apps map to their routes. */\nexport function onboardingJourneyPosition(journey: OnboardingJourney): OnboardingJourneyPosition {\n  const proof = journey.origin?.kind === \"proof\";\n  if (journey.organizationId !== undefined) {\n    return {\n      intent: journey.intent,\n      step: \"provisioning\",\n      organizationId: journey.organizationId,\n      proof,\n    };\n  }\n  return { intent: journey.intent, step: journey.step, proof };\n}\n\n/**\n * The interruption-recovery decision (behavior map §4): a journey that does\n * not match the ready destination the app just rendered must resume; a\n * matching one needs no recovery. Returns the journey to resume, or null.\n */\nexport function activeOnboardingRecovery(\n  ownerId: string,\n  renderedReadyDestination?:\n    | { readonly kind: \"personal\" }\n    | { readonly kind: \"organization\"; readonly organizationId: string },\n): OnboardingJourney | null {\n  const journey = loadOnboardingJourney(ownerId);\n  if (journey === null) return null;\n  const isMatchingDestination =\n    renderedReadyDestination?.kind === \"personal\"\n      ? journey.intent === \"personal\" &&\n        journey.step === \"provisioning\" &&\n        journey.organizationId === undefined\n      : renderedReadyDestination?.kind === \"organization\" &&\n        journey.intent === \"organization\" &&\n        journey.step === \"provisioning\" &&\n        journey.organizationId === renderedReadyDestination.organizationId;\n  return isMatchingDestination ? null : journey;\n}\n\nexport function acknowledgeOnboardingDestination(\n  destination:\n    | { readonly kind: \"personal\" }\n    | { readonly kind: \"organization\"; readonly organizationId: string },\n  ownerId: string,\n): boolean {\n  const journey = loadOnboardingJourney(ownerId);\n  if (journey === null) return false;\n  const matches =\n    destination.kind === \"personal\"\n      ? journey.intent === \"personal\" && journey.step === \"provisioning\"\n      : journey.intent === \"organization\" &&\n        journey.step === \"provisioning\" &&\n        journey.organizationId === destination.organizationId;\n  if (!matches) return false;\n  clearOnboardingJourney();\n  return true;\n}\n\nexport function clearOnboardingJourney(): void {\n  clearValidatedOnboardingOwner();\n  try {\n    sessionStorage.removeItem(JOURNEY_KEY);\n  } catch {\n    // Domain completion remains durable even if browser cleanup is unavailable.\n  }\n}\n\nfunction isValidJourney(value: unknown): value is OnboardingJourney {\n  if (!isRecord(value) || value.version !== JOURNEY_VERSION) return false;\n  if (\n    !hasOnlyKeys(value, [\n      \"version\",\n      \"ownerId\",\n      \"journeyId\",\n      \"intent\",\n      \"entryPoint\",\n      \"origin\",\n      \"step\",\n      \"profile\",\n      \"organization\",\n      \"stableHandle\",\n      \"organizationId\",\n    ])\n  ) {\n    return false;\n  }\n  if (!isBoundedId(value.ownerId)) return false;\n  if (!isBoundedId(value.journeyId) || !value.journeyId.startsWith(\"journey_\")) return false;\n  if (value.intent !== \"personal\" && value.intent !== \"organization\") return false;\n  if (value.entryPoint !== \"signup\" && value.entryPoint !== \"dashboard\") return false;\n  if (value.step !== \"profile\" && value.step !== \"organization\" && value.step !== \"provisioning\") {\n    return false;\n  }\n  if (value.origin !== undefined && !isOrigin(value.origin)) return false;\n  if (value.profile !== undefined && !isProfileDraft(value.profile)) return false;\n  if (value.organization !== undefined && !isOrganizationDraft(value.organization)) return false;\n  if (value.stableHandle !== undefined && !isDraftText(value.stableHandle)) return false;\n  if (value.organizationId !== undefined && !isBoundedId(value.organizationId)) return false;\n  if (value.organization !== undefined && value.stableHandle !== value.organization.handle) {\n    return false;\n  }\n  if (value.stableHandle !== undefined && value.organization === undefined) return false;\n  if (\n    value.intent === \"personal\" &&\n    (value.step === \"organization\" ||\n      value.organization !== undefined ||\n      value.stableHandle !== undefined)\n  ) {\n    return false;\n  }\n  if (value.step === \"organization\" && value.intent !== \"organization\") return false;\n  if (value.organizationId !== undefined && value.intent !== \"organization\") return false;\n  if (value.organizationId !== undefined && value.step !== \"provisioning\") return false;\n  return true;\n}\n\nfunction isOrigin(value: unknown): value is OnboardingOrigin {\n  if (!isRecord(value)) return false;\n  if (value.kind === \"personal\") return hasOnlyKeys(value, [\"kind\"]);\n  if (value.kind === \"organization\") {\n    return hasOnlyKeys(value, [\"kind\", \"organizationId\"]) && isBoundedId(value.organizationId);\n  }\n  return (\n    value.kind === \"proof\" &&\n    hasOnlyKeys(value, [\"kind\", \"organizationId\"]) &&\n    (value.organizationId === undefined || isBoundedId(value.organizationId))\n  );\n}\n\nfunction isProfileDraft(value: unknown): value is ProfileDraft {\n  if (\n    !isRecord(value) ||\n    !hasOnlyKeys(value, [\n      \"displayName\",\n      \"country\",\n      \"withdrawalAddress\",\n      \"username\",\n      \"payoutAddresses\",\n    ]) ||\n    !isDraftText(value.displayName) ||\n    !isDraftText(value.country) ||\n    !isDraftText(value.withdrawalAddress)\n  ) {\n    return false;\n  }\n  if (value.username !== undefined && !isDraftText(value.username)) return false;\n  if (value.payoutAddresses !== undefined && !isPayoutDraftList(value.payoutAddresses)) {\n    return false;\n  }\n  return true;\n}\n\nfunction isPayoutDraftList(value: unknown): value is readonly PayoutDraftEntry[] {\n  return (\n    Array.isArray(value) &&\n    value.length <= MAX_PAYOUT_DRAFT_ENTRIES &&\n    value.every(\n      (entry: unknown) =>\n        isRecord(entry) &&\n        hasOnlyKeys(entry, [\"chain\", \"address\"]) &&\n        (entry.chain === \"evm\" || entry.chain === \"solana\" || entry.chain === \"starknet\") &&\n        isDraftText(entry.address),\n    )\n  );\n}\n\nfunction isOrganizationDraft(value: unknown): value is OrganizationDraft {\n  if (\n    !isRecord(value) ||\n    !hasOnlyKeys(value, [\"name\", \"handle\", \"country\", \"bio\", \"size\"]) ||\n    !isDraftText(value.name) ||\n    !isDraftText(value.handle) ||\n    !isDraftText(value.country)\n  ) {\n    return false;\n  }\n  if (value.bio !== undefined && !isDraftText(value.bio)) return false;\n  if (value.size !== undefined && !isDraftText(value.size)) return false;\n  return true;\n}\n\nfunction isDraftText(value: unknown): value is string {\n  return typeof value === \"string\" && value.length <= MAX_DRAFT_TEXT_LENGTH;\n}\n\nfunction isBoundedId(value: unknown): value is string {\n  return typeof value === \"string\" && value.length > 0 && value.length <= MAX_ID_LENGTH;\n}\n\nfunction discardInvalidJourney(): null {\n  clearValidatedOnboardingOwner();\n  try {\n    sessionStorage.removeItem(JOURNEY_KEY);\n  } catch {\n    // Invalid browser context remains non-authoritative when storage is unavailable.\n  }\n  return null;\n}\n\nfunction createRandomId(): string {\n  if (typeof globalThis.crypto?.randomUUID === \"function\") return globalThis.crypto.randomUUID();\n  return Math.random().toString(36).slice(2);\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nfunction hasOnlyKeys(value: Record<string, unknown>, allowed: readonly string[]): boolean {\n  return Object.keys(value).every((key) => allowed.includes(key));\n}\n","\"use client\";\n\nimport { useEffect, useState } from \"react\";\n\n/** The value as of `delayMs` after its last change (initial value immediate). */\nexport function useDebouncedValue<T>(value: T, delayMs: number): T {\n  const [debounced, setDebounced] = useState(value);\n  useEffect(() => {\n    const timer = setTimeout(() => setDebounced(value), delayMs);\n    return () => clearTimeout(timer);\n  }, [value, delayMs]);\n  return debounced;\n}\n","\"use client\";\n\nimport { useQuery, type UseQueryResult } from \"@tanstack/react-query\";\n\nimport type { CapxulError } from \"@capxul/sdk\";\n\nimport { useCapxulClientOrNull } from \"../../internal/capxul-client-context\";\nimport { capxulKeys } from \"../../internal/reactivity-keys\";\nimport { requireBootstrappedClient } from \"../../internal/require-bootstrapped-client\";\nimport { unwrapCapxulResult } from \"../../internal/unwrap-capxul-result\";\nimport { useDebouncedValue } from \"../../internal/use-debounced-value\";\n\nexport type UsernameAvailability = {\n  readonly available: boolean;\n  readonly normalized: string;\n};\n\nexport type UseCapxulUsernameAvailabilityReturn = UseQueryResult<UsernameAvailability, CapxulError>;\n\n/**\n * #1062: debounced availability probe for the username the user is typing.\n * Disabled until the candidate reaches the 3-character floor; a malformed or\n * reserved candidate surfaces as the query's error (INVALID_INPUT with the\n * boundary's message), not as `available: false` — only a username someone\n * else owns is \"taken\".\n */\nexport function useCapxulUsernameAvailability(\n  username: string,\n  options?: { readonly enabled?: boolean; readonly debounceMs?: number },\n): UseCapxulUsernameAvailabilityReturn {\n  const client = useCapxulClientOrNull();\n  const candidate = useDebouncedValue(username.trim(), options?.debounceMs ?? 300);\n  return useQuery({\n    queryKey: capxulKeys.usernameAvailability(candidate),\n    queryFn: async () => {\n      const bootstrappedClient = requireBootstrappedClient(client, \"identity.usernameAvailable\");\n      return unwrapCapxulResult(\n        await bootstrappedClient.identity.usernameAvailable(candidate),\n        bootstrappedClient._internal.telemetry,\n      );\n    },\n    enabled: client !== null && candidate.length >= 3 && (options?.enabled ?? true),\n  });\n}\n","\"use client\";\n\nimport { useMutation, useQueryClient, type UseMutationResult } from \"@tanstack/react-query\";\n\nimport type { CapxulError } from \"@capxul/sdk\";\n\nimport { useCapxulClientOrNull } from \"../../internal/capxul-client-context\";\nimport { capxulKeys } from \"../../internal/reactivity-keys\";\nimport { requireBootstrappedClient } from \"../../internal/require-bootstrapped-client\";\nimport { unwrapCapxulResult } from \"../../internal/unwrap-capxul-result\";\n\nexport type ImageUploadTarget =\n  | { readonly kind: \"profile\" }\n  | { readonly kind: \"orgLogo\"; readonly orgId: string };\n\nexport type ImageUploadInput = {\n  readonly blob: Blob;\n  readonly target: ImageUploadTarget;\n};\n\nexport type UseCapxulImageUploadReturn = UseMutationResult<\n  { readonly url: string | null },\n  CapxulError,\n  ImageUploadInput\n>;\n\n/**\n * #1061 / ADR-0014: the whole upload→record sequence as one mutation —\n * upload the blob, then bind the returned storage id to the profile image or\n * the org logo. The url is the resolved serving URL (re-read from queries,\n * never persisted by consumers).\n */\nexport function useCapxulImageUpload(): UseCapxulImageUploadReturn {\n  const client = useCapxulClientOrNull();\n  const queryClient = useQueryClient();\n  return useMutation({\n    mutationFn: async ({ blob, target }) => {\n      const bootstrappedClient = requireBootstrappedClient(client, \"media.uploadImage\");\n      const media = bootstrappedClient.media;\n      const telemetry = bootstrappedClient._internal.telemetry;\n      const uploaded = unwrapCapxulResult(await media.uploadImage(blob), telemetry);\n      if (target.kind === \"profile\") {\n        const set = unwrapCapxulResult(\n          await media.setProfileImage({ storageId: uploaded.storageId }),\n          telemetry,\n        );\n        return { url: set.imageUrl };\n      }\n      const set = unwrapCapxulResult(\n        await media.setOrgLogo({ orgId: target.orgId, storageId: uploaded.storageId }),\n        telemetry,\n      );\n      return { url: set.logoUrl };\n    },\n    onSuccess: async (_value, input) => {\n      await queryClient.invalidateQueries({\n        queryKey: input.target.kind === \"profile\" ? capxulKeys.profile : capxulKeys.orgs,\n      });\n    },\n  });\n}\n"],"mappings":"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"}

package/dist/testing/index.d.mts

@@ -0,0 +1,21 @@
+import { a as AuthenticationSlots, d as OnboardingControllerProps } from "../controllers-DuHYSiw1.mjs";
+import * as React from "react";
+import { ReactNode } from "react";
+import { CapxulTestClient, CapxulTestClock, CapxulTestObservation, CreateCapxulTestClientOptions, SeedTestIdentityInput, createCapxulTestClient } from "@capxul/sdk/testing";
+
+//#region src/testing/index.d.ts
+interface CreateCapxulReactTestHarnessOptions extends CreateCapxulTestClientOptions {
+  readonly testing?: CapxulTestClient;
+}
+interface CapxulReactTestHarness {
+  readonly testing: CapxulTestClient;
+  readonly client: CapxulTestClient["client"];
+  readonly provider: (children: ReactNode) => React.JSX.Element;
+  readonly authentication: (slots: AuthenticationSlots) => React.JSX.Element;
+  readonly onboarding: (props: OnboardingControllerProps) => React.JSX.Element;
+}
+/** Build renderer-neutral React test elements over the real SDK testing client. */
+declare function createCapxulReactTestHarness(options?: CreateCapxulReactTestHarnessOptions): CapxulReactTestHarness;
+//#endregion
+export { CapxulReactTestHarness, type CapxulTestClient, type CapxulTestClock, type CapxulTestObservation, CreateCapxulReactTestHarnessOptions, type CreateCapxulTestClientOptions, type SeedTestIdentityInput, createCapxulReactTestHarness, createCapxulTestClient };
+//# sourceMappingURL=index.d.mts.map

package/dist/testing/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/testing/index.tsx"],"mappings":";;;;;;UA6BiB,mCAAA,SAA4C,6BAA6B;EAAA,SAC/E,OAAA,GAAU,gBAAA;AAAA;AAAA,UAGJ,sBAAA;EAAA,SACN,OAAA,EAAS,gBAAA;EAAA,SACT,MAAA,EAAQ,gBAAA;EAAA,SACR,QAAA,GAAW,QAAA,EAAU,SAAA,KAAc,KAAA,CAAM,GAAA,CAAI,OAAA;EAAA,SAC7C,cAAA,GAAiB,KAAA,EAAO,mBAAA,KAAwB,KAAA,CAAM,GAAA,CAAI,OAAA;EAAA,SAC1D,UAAA,GAAa,KAAA,EAAO,yBAAA,KAA8B,KAAA,CAAM,GAAA,CAAI,OAAA;AAAA;;iBAIvD,4BAAA,CACd,OAAA,GAAS,mCAAA,GACR,sBAAsB"}

package/dist/testing/index.mjs

@@ -0,0 +1,24 @@
+import { n as CapxulOnboardingController, r as CapxulProvider, t as CapxulAuthenticationController } from "../controllers-BU11km12.mjs";
+import "react";
+import { jsx } from "react/jsx-runtime";
+import { createCapxulTestClient } from "@capxul/sdk/testing";
+//#region src/testing/index.tsx
+/** Build renderer-neutral React test elements over the real SDK testing client. */
+function createCapxulReactTestHarness(options = {}) {
+	const { testing: suppliedTesting, ...clientOptions } = options;
+	const testing = suppliedTesting ?? createCapxulTestClient(clientOptions);
+	return {
+		testing,
+		client: testing.client,
+		provider: (children) => /* @__PURE__ */ jsx(CapxulProvider, {
+			client: testing.client,
+			children
+		}),
+		authentication: (slots) => /* @__PURE__ */ jsx(CapxulAuthenticationController, { slots }),
+		onboarding: (props) => /* @__PURE__ */ jsx(CapxulOnboardingController, { ...props })
+	};
+}
+//#endregion
+export { createCapxulReactTestHarness, createCapxulTestClient };
+
+//# sourceMappingURL=index.mjs.map

package/dist/testing/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../../src/testing/index.tsx"],"sourcesContent":["import * as React from \"react\";\nimport type { ReactNode } from \"react\";\n\nimport {\n  createCapxulTestClient,\n  type CapxulTestClient,\n  type CapxulTestClock,\n  type CapxulTestObservation,\n  type CreateCapxulTestClientOptions,\n  type SeedTestIdentityInput,\n} from \"@capxul/sdk/testing\";\n\nimport {\n  CapxulAuthenticationController,\n  CapxulOnboardingController,\n  type AuthenticationSlots,\n  type OnboardingControllerProps,\n} from \"../controllers\";\nimport { CapxulProvider } from \"../provider\";\n\nexport { createCapxulTestClient };\nexport type {\n  CapxulTestClient,\n  CapxulTestClock,\n  CapxulTestObservation,\n  CreateCapxulTestClientOptions,\n  SeedTestIdentityInput,\n};\n\nexport interface CreateCapxulReactTestHarnessOptions extends CreateCapxulTestClientOptions {\n  readonly testing?: CapxulTestClient;\n}\n\nexport interface CapxulReactTestHarness {\n  readonly testing: CapxulTestClient;\n  readonly client: CapxulTestClient[\"client\"];\n  readonly provider: (children: ReactNode) => React.JSX.Element;\n  readonly authentication: (slots: AuthenticationSlots) => React.JSX.Element;\n  readonly onboarding: (props: OnboardingControllerProps) => React.JSX.Element;\n}\n\n/** Build renderer-neutral React test elements over the real SDK testing client. */\nexport function createCapxulReactTestHarness(\n  options: CreateCapxulReactTestHarnessOptions = {},\n): CapxulReactTestHarness {\n  const { testing: suppliedTesting, ...clientOptions } = options;\n  const testing = suppliedTesting ?? createCapxulTestClient(clientOptions);\n  return {\n    testing,\n    client: testing.client,\n    provider: (children) => <CapxulProvider client={testing.client}>{children}</CapxulProvider>,\n    authentication: (slots) => <CapxulAuthenticationController slots={slots} />,\n    onboarding: (props) => <CapxulOnboardingController {...props} />,\n  };\n}\n"],"mappings":";;;;;;AA0CA,SAAgB,6BACd,UAA+C,CAAC,GACxB;CACxB,MAAM,EAAE,SAAS,iBAAiB,GAAG,kBAAkB;CACvD,MAAM,UAAU,mBAAmB,uBAAuB,aAAa;CACvE,OAAO;EACL;EACA,QAAQ,QAAQ;EAChB,WAAW,aAAa,oBAAC,gBAAD;GAAgB,QAAQ,QAAQ;GAAS;EAAyB,CAAA;EAC1F,iBAAiB,UAAU,oBAAC,gCAAD,EAAuC,MAAQ,CAAA;EAC1E,aAAa,UAAU,oBAAC,4BAAD,EAA4B,GAAI,MAAQ,CAAA;CACjE;AACF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@capxul/sdk-react",
-  "version": "1.0.0-alpha.9",
+  "version": "1.2.0",
   "files": [
     "dist",
     "package.json",
@@ -11,32 +11,32 @@
     ".": {
       "types": "./dist/index.d.mts",
       "import": "./dist/index.mjs"
+    },
+    "./testing": {
+      "types": "./dist/testing/index.d.mts",
+      "import": "./dist/testing/index.mjs"
     }
   },
   "publishConfig": {
-    "access": "public",
-    "tag": "alpha"
+    "access": "public"
   },
   "dependencies": {
-    "@capxul/sdk": "1.0.0-alpha.9"
+    "@capxul/sdk": "1.2.0"
   },
   "devDependencies": {
     "@tanstack/react-query": "^5.66.9",
-    "@testing-library/jest-dom": "^6.9.1",
     "@testing-library/react": "^16.3.2",
     "@types/jsdom": "^28.0.3",
     "@types/react": "^19.2.15",
-    "@types/react-test-renderer": "^19.1.0",
     "@vitest/coverage-v8": "4.1.7",
     "ink": "^7.0.3",
     "ink-testing-library": "^4.0.0",
     "jsdom": "^29.1.1",
     "react": "^19.2.6",
     "react-dom": "^19.2.6",
-    "react-test-renderer": "^19.2.6",
     "vitest": "npm:@voidzero-dev/vite-plus-test@0.1.23",
-    "@capxul/errors": "0.0.0",
-    "@capxul/types": "0.1.0-alpha.0"
+    "@capxul/types": "0.1.0",
+    "@capxul/errors": "0.0.1"
   },
   "peerDependencies": {
     "@tanstack/react-query": "^5.66.9",
@@ -49,7 +49,6 @@
     "check-types": "tsc -p tsconfig.json --noEmit",
     "lint": "oxlint -c ../../.oxlintrc.json . --deny-warnings",
     "build": "NODE_OPTIONS=--max-old-space-size=24576 vp pack",
-    "_vp-tasks-allowed": "vp-allowed: `test` + `test:coverage` are vp tasks in vite.config.ts so vitest self-writes don't bust cache (#205).",
-    "test:e2e": "vp test run --config vitest.e2e.config.ts"
+    "_vp-tasks-allowed": "vp-allowed: `test` + `test:coverage` are vp tasks in vite.config.ts so vitest self-writes don't bust cache (#205)."
   }
 }