@yieldfabric/wallet 0.2.6 → 0.2.7

package/dist/index.d.cts

@@ -2594,8 +2594,13 @@ interface OnboardingWizardProps {
      *  linked to. One agreement should be consented to once, on the screen that
      *  actually displays it. */
     sponsorshipConsent?: 'wizard' | 'host';
+    /** Host-paid applications never offer personal plans/card capture, including
+     * backend-paid apps whose end-user JWT deliberately has no sponsor tag.
+     * Bank/account opening is deferred to the host's explicit post-consent action.
+     * This controls onboarding UX only; server-side billing gates still apply. */
+    billingMode?: 'automatic' | 'host';
 }
-declare function OnboardingWizard({ initialPathname, chrome, onComplete, branding, invite, platform, onSelectPlatform, sponsorshipConsent, }: OnboardingWizardProps): react_jsx_runtime.JSX.Element;
+declare function OnboardingWizard({ initialPathname, chrome, onComplete, branding, invite, platform, onSelectPlatform, sponsorshipConsent, billingMode, }: OnboardingWizardProps): react_jsx_runtime.JSX.Element;
 
 /**
  * @file ui/onboarding/OnboardingPolicySection.tsx

package/dist/index.d.ts

@@ -2594,8 +2594,13 @@ interface OnboardingWizardProps {
      *  linked to. One agreement should be consented to once, on the screen that
      *  actually displays it. */
     sponsorshipConsent?: 'wizard' | 'host';
+    /** Host-paid applications never offer personal plans/card capture, including
+     * backend-paid apps whose end-user JWT deliberately has no sponsor tag.
+     * Bank/account opening is deferred to the host's explicit post-consent action.
+     * This controls onboarding UX only; server-side billing gates still apply. */
+    billingMode?: 'automatic' | 'host';
 }
-declare function OnboardingWizard({ initialPathname, chrome, onComplete, branding, invite, platform, onSelectPlatform, sponsorshipConsent, }: OnboardingWizardProps): react_jsx_runtime.JSX.Element;
+declare function OnboardingWizard({ initialPathname, chrome, onComplete, branding, invite, platform, onSelectPlatform, sponsorshipConsent, billingMode, }: OnboardingWizardProps): react_jsx_runtime.JSX.Element;
 
 /**
  * @file ui/onboarding/OnboardingPolicySection.tsx

package/dist/index.js

@@ -5,7 +5,7 @@
  * Source review requires written authorization; see package LICENSE.md and NOTICE.md.
  * Runtime use requires a separate express license.
  */
-import React55, { createContext, lazy, useContext, useState, useEffect, useRef, useCallback, useMemo, Suspense, useId, Component } from 'react';
+import React39, { createContext, lazy, useContext, useState, useEffect, useRef, useCallback, useMemo, Suspense, useId, Component } from 'react';
 import { jsx, jsxs, Fragment } from 'react/jsx-runtime';
 import { AvererSdkProvider, useAvererWallet, AvererWebSdk } from '@averer/averer-websdk';
 import sha3, { keccak256 } from 'js-sha3';
@@ -9985,7 +9985,7 @@ function WizardProvider({
   const [planSelection, setPlanSelection] = useState(
     readOnboardingPlanSelectionHint
   );
-  const pendingSponsorshipRef = React55.useRef(
+  const pendingSponsorshipRef = React39.useRef(
     pendingSponsorship
   );
   const stageSponsorship = useCallback((groupId, destination) => {
@@ -11199,8 +11199,8 @@ var DynamicCompleter = ({ sdk, action, onError }) => {
   const ctx = sdk.useDynamicContext();
   const wallet = ctx.primaryWallet;
   const dynamicUser = ctx.user;
-  const [done, setDone] = React55.useState(false);
-  React55.useEffect(() => {
+  const [done, setDone] = React39.useState(false);
+  React39.useEffect(() => {
     if (done || !wallet?.address) return;
     setDone(true);
     (async () => {
@@ -11625,8 +11625,8 @@ var KycFlow3 = ({ onComplete, onError, instanceId }) => {
   const settings = config?.kyc.settings[providerId];
   const publishableKey = settings?.publishable_key;
   const requiredForCompletion = settings?.required_for_completion ?? false;
-  const [stage, setStage] = React55.useState({ kind: "idle" });
-  React55.useEffect(() => {
+  const [stage, setStage] = React39.useState({ kind: "idle" });
+  React39.useEffect(() => {
     let cancelled = false;
     (async () => {
       try {
@@ -11650,7 +11650,7 @@ var KycFlow3 = ({ onComplete, onError, instanceId }) => {
       cancelled = true;
     };
   }, []);
-  React55.useEffect(() => {
+  React39.useEffect(() => {
     if (stage.kind !== "pending-poll") return;
     let cancelled = false;
     const pollOnce = async () => {
@@ -11902,14 +11902,14 @@ function useIdentityStatusPoll(opts) {
     provider,
     credentialType
   } = opts;
-  const [stuckHint, setStuckHint] = React55.useState(false);
-  const onVerifiedRef = React55.useRef(onVerified);
-  const onRejectedRef = React55.useRef(onRejected);
-  React55.useEffect(() => {
+  const [stuckHint, setStuckHint] = React39.useState(false);
+  const onVerifiedRef = React39.useRef(onVerified);
+  const onRejectedRef = React39.useRef(onRejected);
+  React39.useEffect(() => {
     onVerifiedRef.current = onVerified;
     onRejectedRef.current = onRejected;
   }, [onVerified, onRejected]);
-  React55.useEffect(() => {
+  React39.useEffect(() => {
     if (!active) {
       setStuckHint(false);
       return;
@@ -12047,12 +12047,12 @@ var KycFlow4 = ({ onComplete, onError, instanceId, subject }) => {
   const groupId = subject?.kind === "group" ? subject.id : void 0;
   const configuredLevel = config?.kyc.settings[providerId]?.level_name?.trim();
   const levelName = configuredLevel || "id-and-liveness";
-  const [token, setToken] = React55.useState(null);
-  const [stage, setStage] = React55.useState({ kind: "init" });
-  const [attempt, setAttempt] = React55.useState(0);
-  const submittedRef = React55.useRef(false);
-  const applicantIdRef = React55.useRef(void 0);
-  React55.useEffect(() => {
+  const [token, setToken] = React39.useState(null);
+  const [stage, setStage] = React39.useState({ kind: "init" });
+  const [attempt, setAttempt] = React39.useState(0);
+  const submittedRef = React39.useRef(false);
+  const applicantIdRef = React39.useRef(void 0);
+  React39.useEffect(() => {
     let cancelled = false;
     submittedRef.current = false;
     (async () => {
@@ -16018,7 +16018,7 @@ function Field({
   value,
   copyable
 }) {
-  const [copied, setCopied] = React55.useState(false);
+  const [copied, setCopied] = React39.useState(false);
   return /* @__PURE__ */ jsxs("div", { children: [
     /* @__PURE__ */ jsx("p", { className: "text-[10px] uppercase tracking-wider text-text-secondary", children: label }),
     /* @__PURE__ */ jsxs("div", { className: "mt-0.5 flex items-center gap-2", children: [
@@ -16082,14 +16082,16 @@ var STAGE_COPY = {
   not_applicable: { title: "Finishing up", body: "" }
 };
 var AccountOpeningPanel = ({ onContinue, continueLabel = "Continue" }) => {
-  const [status, setStatus] = React55.useState(null);
-  const [impatient, setImpatient] = React55.useState(false);
-  const activationStarted = React55.useRef(false);
-  const onContinueRef = React55.useRef(onContinue);
-  React55.useEffect(() => {
+  const [status, setStatus] = React39.useState(null);
+  const [impatient, setImpatient] = React39.useState(false);
+  const [unavailable, setUnavailable] = React39.useState(false);
+  const [attempt, setAttempt] = React39.useState(0);
+  const activationStarted = React39.useRef(false);
+  const onContinueRef = React39.useRef(onContinue);
+  React39.useEffect(() => {
     onContinueRef.current = onContinue;
   }, [onContinue]);
-  React55.useEffect(() => {
+  React39.useEffect(() => {
     let cancelled = false;
     let timer;
     const startedAt = Date.now();
@@ -16097,8 +16099,9 @@ var AccountOpeningPanel = ({ onContinue, continueLabel = "Continue" }) => {
       if (cancelled) return;
       let terminal = false;
       try {
-        const next = await fetchAccountOpeningStatus();
+        const next = await withDeadline(fetchAccountOpeningStatus(), "Account opening status");
         if (cancelled) return;
+        setUnavailable(false);
         setStatus(next);
         if (next.status === "not_started") {
           onContinueRef.current();
@@ -16115,6 +16118,8 @@ var AccountOpeningPanel = ({ onContinue, continueLabel = "Continue" }) => {
           );
         }
       } catch {
+        if (cancelled) return;
+        setUnavailable(true);
       }
       if (cancelled || terminal) return;
       const waited = Date.now() - startedAt;
@@ -16126,8 +16131,20 @@ var AccountOpeningPanel = ({ onContinue, continueLabel = "Continue" }) => {
       cancelled = true;
       if (timer !== void 0) window.clearTimeout(timer);
     };
-  }, []);
-  if (!status) return null;
+  }, [attempt]);
+  if (unavailable || !status) {
+    return /* @__PURE__ */ jsxs("div", { className: "space-y-4 text-center", role: "status", "aria-live": "polite", children: [
+      /* @__PURE__ */ jsx("p", { children: unavailable ? "We couldn\u2019t check your account right now." : "Checking your account\u2026" }),
+      unavailable && /* @__PURE__ */ jsxs(Fragment, { children: [
+        /* @__PURE__ */ jsx("p", { className: "text-[12px] text-text-secondary", children: "You can try again or continue. Your account details will be available when setup finishes." }),
+        /* @__PURE__ */ jsx("button", { type: "button", className: "min-h-[44px] w-full rounded-lg bg-cta px-4 py-2.5 text-on-cta", onClick: () => {
+          setUnavailable(false);
+          setAttempt((value) => value + 1);
+        }, children: "Try again" }),
+        /* @__PURE__ */ jsx("button", { type: "button", className: "min-h-[44px] w-full", onClick: onContinue, children: continueLabel })
+      ] })
+    ] });
+  }
   if (status.status === "ready" && status.account) {
     return /* @__PURE__ */ jsxs("div", { className: "space-y-4", role: "status", "aria-live": "polite", children: [
       /* @__PURE__ */ jsxs("div", { children: [
@@ -16185,13 +16202,13 @@ var AccountOpeningPanel = ({ onContinue, continueLabel = "Continue" }) => {
 init_authService();
 var WALLET_AWAKENING_MS = 1100;
 var TOTAL_MS = 3e3;
-function OnboardingWelcomeMoment({ chrome } = {}) {
+function OnboardingWelcomeMoment({ chrome, deferAccountOpening = false } = {}) {
   const navigate = useWizardNavigate();
   const { messages } = useBranding();
   const [name, setName] = useState("");
   const [walletShort, setWalletShort] = useState(null);
   const [phase, setPhase] = useState("wallet");
-  const [accountOpened, setAccountOpened] = useState(false);
+  const [accountOpened, setAccountOpened] = useState(deferAccountOpening);
   useEffect(() => {
     let cancelled = false;
     (async () => {
@@ -17363,7 +17380,8 @@ function OnboardingWizard({
   invite,
   platform,
   onSelectPlatform,
-  sponsorshipConsent = "wizard"
+  sponsorshipConsent = "wizard",
+  billingMode = "automatic"
 }) {
   return /* @__PURE__ */ jsx(BrandingProvider, { branding, children: /* @__PURE__ */ jsx(
     WizardProvider,
@@ -17377,7 +17395,8 @@ function OnboardingWizard({
         {
           chrome,
           onSelectPlatform,
-          sponsorshipConsent
+          sponsorshipConsent,
+          billingMode
         }
       )
     }
@@ -17407,7 +17426,8 @@ function gateToPath(status) {
 function WizardRouter({
   chrome,
   onSelectPlatform,
-  sponsorshipConsent = "wizard"
+  sponsorshipConsent = "wizard",
+  billingMode = "automatic"
 }) {
   const pathname = useWizardPathname();
   const { config } = useProviderConfig();
@@ -17416,7 +17436,7 @@ function WizardRouter({
   const effectivePlatform = wizardPlatform ?? config?.platform?.group_id ?? pendingSponsorship?.groupId;
   const primaryKycId = config?.kyc.primary;
   const identityRequired = !!(primaryKycId && config?.kyc.enabled.includes(primaryKycId) && config?.kyc.settings[primaryKycId]?.required_for_completion);
-  const planApplicable = !effectivePlatform && !personalSessionHasGroupPayer();
+  const planApplicable = billingMode !== "host" && !effectivePlatform && !personalSessionHasGroupPayer();
   const allowedIdentityProviders = userIdentityStatusScopes(config);
   const gate = useOnboardingState(
     identityRequired,
@@ -17427,11 +17447,14 @@ function WizardRouter({
     identityRequired && primaryKycVerifiesEmail(config)
   );
   const hostOwnsSponsorshipConsent = sponsorshipConsent === "host";
-  React55.useEffect(() => {
+  React39.useEffect(() => {
     if (hostOwnsSponsorshipConsent && pendingSponsorship) {
       discardSponsorship();
     }
   }, [hostOwnsSponsorshipConsent, pendingSponsorship, discardSponsorship]);
+  if (!planApplicable && ["/onboarding", "/onboarding/pricing", "/onboarding/plan", "/onboarding/card"].includes(pathname)) {
+    return /* @__PURE__ */ jsx(WizardRedirect, { to: "/onboarding/choose", replace: true });
+  }
   const sponsorshipContext = !hostOwnsSponsorshipConsent && !!effectivePlatform && (pendingSponsorship !== null || authService.isAuthenticated() && !authService.hasExactSponsoredSession(effectivePlatform));
   const exactSponsorship = !!effectivePlatform && authService.hasExactSponsoredSession(effectivePlatform);
   const gateCanAnswer = authService.isAuthenticated() && !!tokenManager.getAccessToken();
@@ -17515,7 +17538,7 @@ function WizardRouter({
       }
     );
   if (pathname === "/onboarding/welcome")
-    return /* @__PURE__ */ jsx(OnboardingWelcomeMoment, { chrome });
+    return /* @__PURE__ */ jsx(OnboardingWelcomeMoment, { chrome, deferAccountOpening: billingMode === "host" });
   if (pathname === "/onboarding")
     return /* @__PURE__ */ jsx(SelectPlan, { chrome, platformPlansAvailable: !!onSelectPlatform });
   if (pathname.startsWith("/onboarding/"))
@@ -17643,7 +17666,7 @@ function builtinProviderDisplayName(id) {
   }
 }
 function useProviderDisplayName(config) {
-  return React55.useCallback(
+  return React39.useCallback(
     (id) => {
       const labelled = config?.kyc?.settings?.[id]?.label ?? config?.auth?.settings?.[id]?.label;
       const trimmed = typeof labelled === "string" ? labelled.trim() : "";
@@ -17979,7 +18002,7 @@ var OnboardingPolicySection = ({
       )
     ] }) }) : /* @__PURE__ */ jsxs("div", { className: "space-y-3", children: [
       /* @__PURE__ */ jsxs("div", { className: "flex flex-wrap items-center gap-x-2.5 gap-y-1.5 rounded-lg border border-primary/20 bg-primary/[0.04] px-3.5 py-2.5", children: [
-        journeySteps.map((step, i) => /* @__PURE__ */ jsxs(React55.Fragment, { children: [
+        journeySteps.map((step, i) => /* @__PURE__ */ jsxs(React39.Fragment, { children: [
           i > 0 && /* @__PURE__ */ jsx("span", { "aria-hidden": true, className: "text-[12px] text-text-muted/60", children: "\u203A" }),
           /* @__PURE__ */ jsxs("span", { className: "inline-flex items-center gap-1.5", children: [
             /* @__PURE__ */ jsx("span", { className: "flex h-4 w-4 items-center justify-center rounded-full bg-primary/20 text-[9px] font-bold text-primary", children: i + 1 }),
@@ -21167,11 +21190,11 @@ var SaveButton = ({ onClick, busy, disabled, saved = false, classNames }) => /*
 );
 function useSavedFlash(ms = 1800) {
   const [saved, setSaved] = useState(false);
-  const timer = React55.useRef(null);
+  const timer = React39.useRef(null);
   useEffect(() => () => {
     if (timer.current) clearTimeout(timer.current);
   }, []);
-  const flash = React55.useCallback(() => {
+  const flash = React39.useCallback(() => {
     setSaved(true);
     if (timer.current) clearTimeout(timer.current);
     timer.current = setTimeout(() => setSaved(false), ms);
@@ -24924,17 +24947,17 @@ function ActiveEnvironmentBadge({
     configuredTestChains
   );
   const canChoose = Boolean(activeChainId && options.length > 1);
-  const [busyChainId, setBusyChainId] = React55.useState(null);
-  const [pendingLiveChainId, setPendingLiveChainId] = React55.useState(null);
-  const [error, setError] = React55.useState(null);
-  const switchingRef = React55.useRef(false);
-  const confirmLiveRef = React55.useRef(null);
-  const liveWarningId = React55.useId();
+  const [busyChainId, setBusyChainId] = React39.useState(null);
+  const [pendingLiveChainId, setPendingLiveChainId] = React39.useState(null);
+  const [error, setError] = React39.useState(null);
+  const switchingRef = React39.useRef(false);
+  const confirmLiveRef = React39.useRef(null);
+  const liveWarningId = React39.useId();
   const label = modeLabel(environment.mode);
   const modeCounts = { test: 0, live: 0, unknown: 0 };
   for (const option of options) modeCounts[option.mode] += 1;
   const pendingLive = options.find((option) => option.chainId === pendingLiveChainId) ?? null;
-  React55.useEffect(() => {
+  React39.useEffect(() => {
     if (pendingLiveChainId) confirmLiveRef.current?.focus();
   }, [pendingLiveChainId]);
   async function switchTo(option) {
@@ -25694,7 +25717,7 @@ function WalletMenu({
   const secondaryItems = items.filter((item) => item.placement === "secondary");
   const activeActor = actors.find((actor) => actor.active) ?? actors[0];
   const userName = identity.name ?? "You";
-  const renderCard = (cardItems) => /* @__PURE__ */ jsx("div", { className: "overflow-hidden rounded-[24px] border border-border-light bg-raised shadow-sm", children: cardItems.map((item, index) => /* @__PURE__ */ jsxs(React55.Fragment, { children: [
+  const renderCard = (cardItems) => /* @__PURE__ */ jsx("div", { className: "overflow-hidden rounded-[24px] border border-border-light bg-raised shadow-sm", children: cardItems.map((item, index) => /* @__PURE__ */ jsxs(React39.Fragment, { children: [
     index > 0 && /* @__PURE__ */ jsx("div", { className: "mx-4 border-t border-border-light" }),
     /* @__PURE__ */ jsx(
       WalletMenuRow,
@@ -25944,7 +25967,7 @@ function ActorsPane({
     error && /* @__PURE__ */ jsx(ErrorBanner, { children: error }),
     /* @__PURE__ */ jsx("div", { className: "overflow-hidden rounded-[22px] border border-border-light bg-raised", children: actors.map((actor, index) => {
       const ActorIcon = actor.icon;
-      return /* @__PURE__ */ jsxs(React55.Fragment, { children: [
+      return /* @__PURE__ */ jsxs(React39.Fragment, { children: [
         index > 0 && /* @__PURE__ */ jsx("div", { className: "mx-4 border-t border-border-light" }),
         /* @__PURE__ */ jsxs(
           "button",
@@ -29768,25 +29791,25 @@ function BusinessVerificationSection({
   initialStatus
 }) {
   const { config } = useProviderConfig();
-  const [status, setStatus] = React55.useState(initialStatus ?? "not_required");
-  const [flowInstance, setFlowInstance] = React55.useState(null);
-  const [error, setError] = React55.useState(null);
-  const [busy, setBusy] = React55.useState(false);
-  const kybInstances = React55.useMemo(
+  const [status, setStatus] = React39.useState(initialStatus ?? "not_required");
+  const [flowInstance, setFlowInstance] = React39.useState(null);
+  const [error, setError] = React39.useState(null);
+  const [busy, setBusy] = React39.useState(false);
+  const kybInstances = React39.useMemo(
     () => (config?.kyc.enabled ?? []).filter(
       (id) => config?.kyc.settings[id]?.subject === "group"
     ),
     [config]
   );
   const entityDefault = config?.kyc.entity_default_profile ?? null;
-  const refreshStatus = React55.useCallback(async () => {
+  const refreshStatus = React39.useCallback(async () => {
     try {
       const s = await getIdentityStatus({ groupId });
       setStatus(s.status === "unverified" ? "unverified" : s.status);
     } catch {
     }
   }, [groupId]);
-  React55.useEffect(() => {
+  React39.useEffect(() => {
     if (initialStatus !== void 0) setStatus(initialStatus);
   }, [initialStatus]);
   const startFlow = async (bindFirst) => {
@@ -30974,7 +30997,7 @@ var IncomingPaymentsInbox = ({
   ...hookOptions
 }) => {
   const inbox = useIncomingPayments(hookOptions);
-  const allPayments = React55.useMemo(
+  const allPayments = React39.useMemo(
     () => [
       ...inbox.payments,
       ...inbox.contracts.flatMap((c) => c.payments ?? [])

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yieldfabric/wallet",
-  "version": "0.2.6",
+  "version": "0.2.7",
   "description": "Reusable YieldFabric wallet — login, signing, profile, and key management",
   "license": "SEE LICENSE IN LICENSE.md",
   "author": "YieldFabric Technologies Ltd",