@stridge/kit 0.1.0-alpha.13 → 0.1.0-alpha.14

package/dist/stridge/StridgeProvider.d.ts

@@ -22,9 +22,44 @@ interface StridgeAsset {
   symbol: string;
 }
 /**
- * Per-flow deposit tuning. Pass `deposit: {}` to enable the deposit flow with defaults.
+ * Settlement destination for the deposit flow. The kit does not infer a destination from any
+ * connected wagmi wallet — businesses pass the treasury / settlement address where deposited
+ * funds should land.
+ *
+ * @remarks
+ * If the gateway-kit admin config has "Same-owner only" enabled (default), `address` must
+ * equal {@link StridgeDepositFlowConfig.owner | the deposit owner}. Turn the toggle off — and
+ * optionally pair it with a destination whitelist — to route funds to an address that differs
+ * from the owner.
+ */
+interface StridgeDepositDestination {
+  address: Address;
+}
+/**
+ * Stridge `gateway/start.owner` identifier for a single flow. Scopes UDA provisioning and the
+ * proactive `gateway/{owner}` settlement poll. The kit treats the address as opaque — businesses
+ * pick whatever per-customer (real EOA, derived per-user EOA) or shared (treasury) granularity
+ * fits their model.
+ */
+interface StridgeFlowOwner {
+  address: Address;
+}
+/**
+ * Per-flow deposit tuning.
  */
 interface StridgeDepositFlowConfig {
+  /**
+   * Settlement destination address — where settled brand-currency funds land at completion.
+   * Required when the deposit flow is enabled.
+   */
+  destination: StridgeDepositDestination;
+  /**
+   * Owner used as `gateway/start.owner` for deposit UDAs. Optional — falls back to the
+   * connected wagmi wallet address, then to `dev.userAddressOverride`. Set explicitly when
+   * the customer is identified by something other than their wagmi address (e.g. a derived
+   * per-user identifier, or a shared business owner that is not the wagmi-connected EOA).
+   */
+  owner?: StridgeFlowOwner;
   /**
    * Low-balance / amount-entry USD floor. Defaults to the kit's internal default
    * (`STRIDGE_DEFAULT_MIN_DEPOSIT_USD`) when omitted.
@@ -37,9 +72,15 @@ interface StridgeDepositFlowConfig {
   metadata?: Record<string, unknown>;
 }
 /**
- * Per-flow withdraw tuning. Pass `withdraw: {}` to enable the withdraw flow with defaults.
+ * Per-flow withdraw tuning.
  */
 interface StridgeWithdrawFlowConfig {
+  /**
+   * Owner used as `gateway/start.owner` for every withdraw UDA the flow provisions. Required —
+   * the withdraw flow has no wagmi fallback because the business (not the end-user) is the
+   * party broadcasting the source-chain tx to the UDA.
+   */
+  owner: StridgeFlowOwner;
   /**
    * Metadata persisted on every UDA the withdraw flow provisions. Merged under the kit-set
    * `kit_flow` / `kit_version` / `source` keys (kit keys win).
@@ -183,4 +224,4 @@ declare function StridgeProvider({
   children
 }: StridgeProvider.Props): _$react_jsx_runtime0.JSX.Element;
 //#endregion
-export { StridgeAppearance, StridgeAsset, StridgeDepositFlowConfig, StridgeProvider, StridgeStorageConfig, StridgeWithdrawFlowConfig };
+export { StridgeAppearance, StridgeAsset, StridgeDepositDestination, StridgeDepositFlowConfig, StridgeFlowOwner, StridgeProvider, StridgeStorageConfig, StridgeWithdrawFlowConfig };

package/dist/stridge/StridgeProvider.js

@@ -1 +1 @@
-"use client";import{normalizeChainToNetworkId as e}from"../shared/chains/index.js";import{createKitI18n as t}from"../shared/i18n/createKitI18n.js";import"../i18n/index.js";import{StridgeContext as n}from"./StridgeContext.js";import{createStridgeDepositDriver as r}from"../drivers/stridge/createStridgeDepositDriver.js";import{createStridgeWithdrawDriver as i}from"../drivers/stridge/createStridgeWithdrawDriver.js";import"../_internal/drivers/stridge/index.js";import{KitProvider as a}from"../KitProvider.js";import{useIntercomMerchantContext as o}from"../shared/support/useIntercomMerchantContext.js";import"../shared/support/index.js";import{createStubDepositDriver as s,createStubWithdrawDriver as c}from"./stubs.js";import{useMemo as l,useRef as u,useSyncExternalStore as d}from"react";import{jsx as f}from"react/jsx-runtime";import{useAccount as p,useConfig as m}from"wagmi";function h({gatewayKey:h,environment:g,asset:_,flows:v,appearance:y,i18n:b,storage:x,dev:S,className:C,children:w}){if(!v.deposit&&!v.withdraw)throw Error("<StridgeProvider /> requires at least one of `flows.deposit` or `flows.withdraw`.");if(!_)throw Error("<StridgeProvider /> requires `asset: { chain, symbol }`.");let T=m(),{address:E}=p(),D=E??S?.userAddressOverride,O=l(()=>t(b??{}),[b?.locale,b?.messages]),k=u(O);k.current=O;let A=l(()=>e(_.chain),[_.chain]),j=_.symbol,M=v.deposit,N=v.withdraw,P=l(()=>{if(!(!M||!D))return r({userAddress:D,projectKey:h,destination:{network_id:A,asset_symbol:j},wagmiConfig:T,getI18n:()=>k.current,...g?{environment:g}:{},...M.minDepositUsd===void 0?{}:{minDepositUsd:M.minDepositUsd},...M.metadata?{metadata:M.metadata}:{}})},[M,D,h,g,A,j,T]),F=l(()=>s(),[]),I=M?P??F:void 0,L=l(()=>{if(!(!N||!D))return i({userAddress:D,projectKey:h,currency:{networkId:A,assetSymbol:j},wagmiConfig:T,getI18n:()=>k.current,...g?{environment:g}:{},...N.metadata?{metadata:N.metadata}:{}})},[N,D,h,g,A,j,T]),R=l(()=>c(),[]),z=N?L??R:void 0,B=P??L,V=d(e=>B?.subscribe(e)??(()=>{}),()=>{if(P){let e=P.getSnapshot();return e.brand.status===`ready`&&e.target.status===`ready`}return L?L.getSnapshot().receiveOptions.status===`ready`:!1},()=>!1),H=d(e=>P?.subscribe(e)??(()=>{}),()=>{let e=P;if(!e)return;let t=e.getSnapshot();if(t.brand.status===`ready`||t.brand.status===`stale`)return t.brand.payload.name},()=>void 0),U=d(e=>P?.subscribe(e)??(()=>{}),()=>{let e=P;if(!e)return;let t=e.getSnapshot();if(t.brand.status===`ready`||t.brand.status===`stale`)return t.brand.payload.checkoutItemTitle},()=>void 0);return o({gatewayKey:h,environment:g??`production`,assetChain:A,assetSymbol:j,...D?{userAddress:D}:{},...H?{brandName:H}:{},...U?{checkoutItemTitle:U}:{}}),f(n,{value:l(()=>({isReady:V,driver:P}),[V,P]),children:f(a,{theme:y?.theme,accent:y?.accent,radius:y?.radius,direction:y?.direction,i18n:b,storage:x?.driver,storageNamespace:x?.namespace,className:C,...I?{deposit:I}:{},...z?{withdraw:z}:{},children:w})})}export{h as StridgeProvider};
+"use client";import{normalizeChainToNetworkId as e}from"../shared/chains/index.js";import{createKitI18n as t}from"../shared/i18n/createKitI18n.js";import"../i18n/index.js";import{StridgeContext as n}from"./StridgeContext.js";import{createStridgeDepositDriver as r}from"../drivers/stridge/createStridgeDepositDriver.js";import{createStridgeWithdrawDriver as i}from"../drivers/stridge/createStridgeWithdrawDriver.js";import"../_internal/drivers/stridge/index.js";import{KitProvider as a}from"../KitProvider.js";import{useIntercomMerchantContext as o}from"../shared/support/useIntercomMerchantContext.js";import"../shared/support/index.js";import{useOptionalWagmi as s}from"./optionalWagmi.js";import{createStubDepositDriver as c,createStubWithdrawDriver as l}from"./stubs.js";import{useMemo as u,useRef as d,useSyncExternalStore as f}from"react";import{jsx as p}from"react/jsx-runtime";function m({gatewayKey:m,environment:h,asset:g,flows:_,appearance:v,i18n:y,storage:b,dev:x,className:S,children:C}){if(!_.deposit&&!_.withdraw)throw Error("<StridgeProvider /> requires at least one of `flows.deposit` or `flows.withdraw`.");if(!g)throw Error("<StridgeProvider /> requires `asset: { chain, symbol }`.");let{config:w,address:T}=s(),E=u(()=>t(y??{}),[y?.locale,y?.messages]),D=d(E);D.current=E;let O=u(()=>e(g.chain),[g.chain]),k=g.symbol,A=_.deposit,j=_.withdraw,M=A?.owner?.address??T??x?.userAddressOverride,N=j?.owner.address,P=u(()=>{if(!(!A||!M))return r({userAddress:M,projectKey:m,destination:{network_id:O,asset_symbol:k,to_address:A.destination.address},wagmiConfig:w,getI18n:()=>D.current,...h?{environment:h}:{},...A.minDepositUsd===void 0?{}:{minDepositUsd:A.minDepositUsd},...A.metadata?{metadata:A.metadata}:{}})},[A,M,m,h,O,k,w]),F=u(()=>c(),[]),I=A?P??F:void 0,L=u(()=>{if(!(!j||!N))return i({userAddress:N,projectKey:m,currency:{networkId:O,assetSymbol:k},wagmiConfig:w,getI18n:()=>D.current,...h?{environment:h}:{},...j.metadata?{metadata:j.metadata}:{}})},[j,N,m,h,O,k,w]),R=u(()=>l(),[]),z=j?L??R:void 0,B=P??L,V=f(e=>B?.subscribe(e)??(()=>{}),()=>{if(P){let e=P.getSnapshot();return e.brand.status===`ready`&&e.target.status===`ready`}return L?L.getSnapshot().receiveOptions.status===`ready`:!1},()=>!1),H=f(e=>P?.subscribe(e)??(()=>{}),()=>{let e=P;if(!e)return;let t=e.getSnapshot();if(t.brand.status===`ready`||t.brand.status===`stale`)return t.brand.payload.name},()=>void 0),U=f(e=>P?.subscribe(e)??(()=>{}),()=>{let e=P;if(!e)return;let t=e.getSnapshot();if(t.brand.status===`ready`||t.brand.status===`stale`)return t.brand.payload.checkoutItemTitle},()=>void 0),W=M??N;return o({gatewayKey:m,environment:h??`production`,assetChain:O,assetSymbol:k,...W?{userAddress:W}:{},...H?{brandName:H}:{},...U?{checkoutItemTitle:U}:{}}),p(n,{value:u(()=>({isReady:V,driver:P}),[V,P]),children:p(a,{theme:v?.theme,accent:v?.accent,radius:v?.radius,direction:v?.direction,i18n:y,storage:b?.driver,storageNamespace:b?.namespace,className:S,...I?{deposit:I}:{},...z?{withdraw:z}:{},children:C})})}export{m as StridgeProvider};

package/dist/stridge/optionalWagmi.js

@@ -0,0 +1 @@
+"use client";import{use as e,useCallback as t,useSyncExternalStore as n}from"react";import{getAccount as r,watchAccount as i}from"wagmi/actions";import{WagmiContext as a}from"wagmi";function o(){let o=e(a);return{config:o,address:n(t(e=>o?i(o,{onChange:()=>e()}):()=>{},[o]),t(()=>{if(o)return r(o).address},[o]),()=>void 0)}}export{o as useOptionalWagmi};

package/dist/stridge/stubs.js

@@ -1 +1 @@
-const e=Object.freeze({status:`idle`}),t=Object.freeze({brand:e,target:e,addresses:e,balances:e,quote:e,settlement:e,wallet:e}),n=Object.freeze({withdrawableBalances:e,receiveOptions:e,quote:e,settlement:e}),r=()=>{};function i(){if(typeof DOMException==`function`)return new DOMException(`Aborted`,`AbortError`);let e=Error(`Aborted`);return e.name=`AbortError`,e}function a(e){return new Promise((t,n)=>{if(e.aborted){n(i());return}e.addEventListener(`abort`,()=>n(i()),{once:!0})})}function o(){return{getSnapshot:()=>t,subscribe:()=>r,requestQuote:(e,t)=>a(t),submitDeposit:(e,t)=>a(t),watchSettlement:()=>{},fetchActiveSettlement:async()=>null}}function s(){return{getSnapshot:()=>n,subscribe:()=>r,requestQuote:(e,t)=>a(t),submitWithdrawal:(e,t)=>a(t),watchSettlement:()=>{}}}export{o as createStubDepositDriver,s as createStubWithdrawDriver};
+const e=Object.freeze({status:`idle`}),t=Object.freeze({brand:e,target:e,addresses:e,balances:e,quote:e,settlement:e,wallet:e}),n=Object.freeze({withdrawableBalances:e,receiveOptions:e,quote:e,settlement:e}),r=()=>{};function i(){if(typeof DOMException==`function`)return new DOMException(`Aborted`,`AbortError`);let e=Error(`Aborted`);return e.name=`AbortError`,e}function a(e){return new Promise((t,n)=>{if(e.aborted){n(i());return}e.addEventListener(`abort`,()=>n(i()),{once:!0})})}function o(){return{getSnapshot:()=>t,subscribe:()=>r,requestQuote:(e,t)=>a(t),submitDeposit:(e,t)=>a(t),watchSettlement:()=>{},fetchActiveSettlement:async()=>null}}function s(){return{getSnapshot:()=>n,subscribe:()=>r,requestQuote:(e,t)=>a(t),prepareWithdrawal:(e,t)=>a(t),watchSettlement:()=>{}}}export{o as createStubDepositDriver,s as createStubWithdrawDriver};

package/dist/withdraw/dialog/index.d.ts

@@ -1,2 +1,4 @@
+import { WithdrawSubmitActions, WithdrawSubmitCallback, WithdrawSubmitInput } from "../../flows/withdraw/orchestrator/types.js";
+import { WithdrawBalanceInput, WithdrawSuggestedRecipient } from "../../flows/withdraw/dialog/WithdrawDialogBindingsContext.js";
 import { WithdrawDialog } from "../../flows/withdraw/dialog/WithdrawDialog.js";
-export { WithdrawDialog };
+export { type WithdrawBalanceInput, WithdrawDialog, type WithdrawSubmitActions, type WithdrawSubmitCallback, type WithdrawSubmitInput, type WithdrawSuggestedRecipient };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stridge/kit",
-  "version": "0.1.0-alpha.13",
+  "version": "0.1.0-alpha.14",
   "license": "MIT",
   "type": "module",
   "files": [