@stridge/kit 0.1.0-alpha.17 → 0.1.0-alpha.18

package/dist/KitProvider.d.ts

@@ -2,6 +2,8 @@ import { DepositDriver } from "./flows/deposit/driver/types.js";
 import { WithdrawDriver } from "./flows/withdraw/driver/types.js";
 import { KitScope } from "./scope/KitScope.js";
 import { KitI18nConfig } from "./shared/i18n/createKitI18n.js";
+import { IntercomMerchantContext } from "./shared/support/useIntercomMerchantContext.js";
+import { SupportConfig } from "./shared/support/types.js";
 import { KitStoragePersistence } from "./storage/types.js";
 import * as _$react_jsx_runtime0 from "react/jsx-runtime";
 
@@ -48,6 +50,8 @@ declare function KitProvider({
   withdraw,
   storage,
   storageNamespace,
+  support,
+  merchantContext,
   attribution,
   ...scopeProps
 }: KitProvider.Props): _$react_jsx_runtime0.JSX.Element;
@@ -86,6 +90,14 @@ declare namespace KitProvider {
      * keep state isolated. Defaults to `stridge-kit:storage:v1`.
      */
     storageNamespace?: string;
+    /**
+     * Merchant-configurable in-dialog "Get help" override for direct `<KitProvider />` mounts.
+     */
+    support?: SupportConfig;
+    /**
+     * Merchant and user triage metadata passed to merchant-owned support callbacks.
+     */
+    merchantContext?: IntercomMerchantContext;
   }
 }
 //#endregion

package/dist/KitProvider.js

@@ -1 +1 @@
-"use client";import{KitStorageProvider as e}from"./storage/context.js";import"./storage/index.js";import{DepositDriverProvider as t}from"./flows/deposit/driver/context.js";import{getLocaleDirection as n}from"./shared/i18n/getLocaleDirection.js";import{KitI18nProvider as r}from"./shared/i18n/KitI18nProvider.js";import"./i18n/index.js";import{GatewayController as i}from"./flows/deposit/orchestrator/controller.js";import{WithdrawDriverProvider as a}from"./flows/withdraw/driver/context.js";import{WithdrawDialogBindingsProvider as o}from"./flows/withdraw/dialog/WithdrawDialogBindingsContext.js";import{WithdrawControllerProvider as s}from"./flows/withdraw/orchestrator/controller.js";import{KitScope as c}from"./scope/KitScope.js";import"./scope/index.js";import{jsx as l}from"react/jsx-runtime";function u({children:u,i18n:d,direction:f,deposit:p,withdraw:m,storage:h,storageNamespace:g,attribution:_=`visible`,...v}){let y=n(d?.locale),b=u;return m&&(b=l(o,{children:l(a,{driver:m,children:l(s,{children:b})})})),p&&(b=l(t,{driver:p,children:l(i,{children:b})})),l(r,{locale:d?.locale,messages:d?.messages,children:l(c,{...v,direction:f??y,locale:d?.locale,attribution:_,children:l(e,{storage:h,namespace:g,children:b})})})}export{u as KitProvider};
+"use client";import{KitStorageProvider as e}from"./storage/context.js";import"./storage/index.js";import{DepositDriverProvider as t}from"./flows/deposit/driver/context.js";import{getLocaleDirection as n}from"./shared/i18n/getLocaleDirection.js";import{KitI18nProvider as r}from"./shared/i18n/KitI18nProvider.js";import"./i18n/index.js";import{GatewayController as i}from"./flows/deposit/orchestrator/controller.js";import{WithdrawDriverProvider as a}from"./flows/withdraw/driver/context.js";import{WithdrawDialogBindingsProvider as o}from"./flows/withdraw/dialog/WithdrawDialogBindingsContext.js";import{WithdrawControllerProvider as s}from"./flows/withdraw/orchestrator/controller.js";import{KitScope as c}from"./scope/KitScope.js";import"./scope/index.js";import{SupportConfigContext as l}from"./shared/support/SupportConfigContext.js";import{useMemo as u}from"react";import{jsx as d}from"react/jsx-runtime";function f({children:f,i18n:p,direction:m,deposit:h,withdraw:g,storage:_,storageNamespace:v,support:y,merchantContext:b,attribution:x=`visible`,...S}){let C=n(p?.locale),w=f;g&&(w=d(o,{children:d(a,{driver:g,children:d(s,{children:w})})})),h&&(w=d(t,{driver:h,children:d(i,{children:w})}));let T=u(()=>({config:y,merchantContext:b??null}),[y,b]),E=y!==void 0||b!==void 0,D=d(r,{locale:p?.locale,messages:p?.messages,children:d(c,{...S,direction:m??C,locale:p?.locale,attribution:x,children:d(e,{storage:_,namespace:v,children:w})})});return E?d(l.Provider,{value:T,children:D}):D}export{f as KitProvider};

package/dist/index.d.ts

@@ -5,6 +5,8 @@ import { WithdrawSnapshot } from "./flows/withdraw/driver/types.js";
 import { useWithdrawSnapshot } from "./flows/withdraw/driver/context.js";
 import { useKitConfig } from "./scope/context.js";
 import { KitPortalScope } from "./scope/KitPortalScope.js";
+import { IntercomMerchantContext } from "./shared/support/useIntercomMerchantContext.js";
+import { SupportConfig, SupportOpenContext } from "./shared/support/types.js";
 import { createLocalStorageAdapter, createMemoryStorageAdapter, createSessionStorageAdapter, resolveStorageAdapter } from "./storage/adapters.js";
 import { createKitStorage } from "./storage/createKitStorage.js";
 import { DEFAULT_KIT_STORAGE_NAMESPACE, KitStorageProvider, useKitStorage, useKitStorageValue } from "./storage/context.js";
@@ -23,4 +25,4 @@ import { useWithdrawState } from "./flows/withdraw/orchestrator/controller.js";
 import { useWithdraw } from "./flows/withdraw/orchestrator/useWithdraw.js";
 import { useOptionalStridge, useStridge } from "./stridge/StridgeContext.js";
 import { StridgeAppearance, StridgeAsset, StridgeDepositDestination, StridgeDepositFlowConfig, StridgeFlowOwner, StridgeProvider, StridgeStorageConfig, StridgeWithdrawFlowConfig } from "./stridge/StridgeProvider.js";
-export { type BannerAckBucket, type ChainInput, type ChainLogoInput, type ChainLogoMeta, type ChainSlug, DEFAULT_KIT_STORAGE_NAMESPACE, type DepositActions, type DepositController, type DepositMethod, type OpenInput as DepositOpenInput, type DepositSnapshot, type DepositState, type DepositStateName, type FailureInfo, KitPortalScope, KitStorageProvider, type LogosNamespace, type StridgeAppearance, type StridgeAsset, type StridgeDepositDestination, type StridgeDepositFlowConfig, type StridgeEnvironment, type StridgeFlowOwner, StridgeProvider, type StridgeStorageConfig, type StridgeWithdrawFlowConfig, type TokenLogoInput, type TxRef, type WithdrawActions, type WithdrawController, type WithdrawSnapshot, type WithdrawState, type WithdrawStateName, type WithdrawalFormSnapshot, bannerAckStorageKey, bucketFromSettlement, chains, createKitStorage, createLocalStorageAdapter, createMemoryStorageAdapter, createSessionStorageAdapter, logos, resolveStorageAdapter, useBannerAck, useBannerAckForSettlement, useDeposit, useDepositSnapshot, useDepositState, useKitConfig, useKitStorage, useKitStorageValue, useOptionalStridge, useStridge, useWithdraw, useWithdrawSnapshot, useWithdrawState };
+export { type BannerAckBucket, type ChainInput, type ChainLogoInput, type ChainLogoMeta, type ChainSlug, DEFAULT_KIT_STORAGE_NAMESPACE, type DepositActions, type DepositController, type DepositMethod, type OpenInput as DepositOpenInput, type DepositSnapshot, type DepositState, type DepositStateName, type FailureInfo, type IntercomMerchantContext, KitPortalScope, KitStorageProvider, type LogosNamespace, type StridgeAppearance, type StridgeAsset, type StridgeDepositDestination, type StridgeDepositFlowConfig, type StridgeEnvironment, type StridgeFlowOwner, StridgeProvider, type StridgeStorageConfig, type StridgeWithdrawFlowConfig, type SupportConfig, type SupportOpenContext, type TokenLogoInput, type TxRef, type WithdrawActions, type WithdrawController, type WithdrawSnapshot, type WithdrawState, type WithdrawStateName, type WithdrawalFormSnapshot, bannerAckStorageKey, bucketFromSettlement, chains, createKitStorage, createLocalStorageAdapter, createMemoryStorageAdapter, createSessionStorageAdapter, logos, resolveStorageAdapter, useBannerAck, useBannerAckForSettlement, useDeposit, useDepositSnapshot, useDepositState, useKitConfig, useKitStorage, useKitStorageValue, useOptionalStridge, useStridge, useWithdraw, useWithdrawSnapshot, useWithdrawState };

package/dist/package.js

@@ -1 +1 @@
-var e=`0.1.0-alpha.17`;export{e as version};
+var e=`0.1.0-alpha.18`;export{e as version};

package/dist/shared/support/SupportButton.d.ts

@@ -0,0 +1 @@
+import { ComponentProps, ReactNode } from "react";

package/dist/shared/support/SupportButton.js

@@ -0,0 +1 @@
+"use client";import{styles as e}from"../ui/ExternalLink/ExternalLink.styles.js";import{joinClassNames as t}from"../utils/joinClassNames.js";import{cloneElement as n,isValidElement as r}from"react";import{jsx as i,jsxs as a}from"react/jsx-runtime";import*as o from"@stylexjs/stylex";function s({children:n,suffix:r,className:s,style:d,...f}){let p=r!=null&&r!==!1,m=o.props(e.root,l.button),h=t(m.className,s),g=o.props(e.iconSlot,e.suffixSpacing);return a(`button`,{"data-stridge-slot":u.root,type:`button`,...f,className:h,style:{...m.style,...d},children:[n,p?i(`span`,{"data-icon":`inline-end`,...g,children:c(r)}):null]})}function c(t){if(!r(t))return t;let i=o.props(e.iconSvg);return n(t,{className:[t.props.className,i.className].filter(Boolean).join(` `),style:{...t.props.style,...i.style}})}const l={button:{"SupportButton__supportButtonStyles.button":`SupportButton__supportButtonStyles.button`,"appearance-kysU6D":`xjyslct`,"padding-kmVPX3":`x1717udv`,"font-kVVagm":`xln7xf2`,"color-kMwMTN":`x1heor9g`,"cursor-kkrTdU":`x1ypdohk`,"textAlign-k9WMMc":`x16tdsg8`,$$css:`@stridge/kit:src/shared/support/SupportButton.tsx:52`}},u={root:`support-button`};export{s as SupportButton};

package/dist/shared/support/SupportConfigContext.d.ts

@@ -0,0 +1 @@
+export { };

package/dist/shared/support/SupportConfigContext.js

@@ -0,0 +1 @@
+"use client";import{createContext as e,use as t}from"react";const n=e({config:void 0,merchantContext:null});n.displayName=`SupportConfigContext`;function r(){return t(n)}export{n as SupportConfigContext,r as useSupportConfig};

package/dist/shared/support/SupportLink.d.ts

@@ -0,0 +1 @@
+import { CSSProperties, MouseEventHandler, ReactNode } from "react";

package/dist/shared/support/SupportLink.js

@@ -1 +1 @@
-"use client";import{BRAND_LINKS as e}from"../constants/brand-links.js";import{ExternalLink as t}from"../ui/ExternalLink/ExternalLink.js";import"../ui/ExternalLink/index.js";import{SupportSpinner as n}from"./SupportSpinner.js";import{useSupportTrigger as r}from"./useSupportTrigger.js";import{useCallback as i}from"react";import{jsx as a}from"react/jsx-runtime";const o={cursor:`not-allowed`,opacity:.6,pointerEvents:`none`};function s({children:s,suffix:c,onClick:l,style:u,...d}){let f=r(),p=f.status===`loading`,m=i(e=>{l?.(e),!e.defaultPrevented&&e.button===0&&(e.metaKey||e.ctrlKey||e.shiftKey||e.altKey||(e.preventDefault(),f.open()))},[f,l]),h=p?{...u,...o}:u;return a(t,{...d,href:e.support,suffix:p?a(n,{}):c,onClick:m,"aria-busy":p||void 0,"aria-disabled":p||void 0,style:h,children:s})}export{s as SupportLink};
+"use client";import{useSupportConfig as e}from"./SupportConfigContext.js";import{resolveSupport as t}from"./resolveSupport.js";import{SupportButton as n}from"./SupportButton.js";import{BRAND_LINKS as r}from"../constants/brand-links.js";import{ExternalLink as i}from"../ui/ExternalLink/ExternalLink.js";import"../ui/ExternalLink/index.js";import{SupportSpinner as a}from"./SupportSpinner.js";import{useSupportTrigger as o}from"./useSupportTrigger.js";import{useCallback as s}from"react";import{jsx as c}from"react/jsx-runtime";const l={cursor:`not-allowed`,opacity:.6,pointerEvents:`none`};function u(n){let{config:r,merchantContext:i}=e(),a=t(r);return a.kind===`stridge`?c(d,{...n}):a.kind===`url`?c(f,{...n,url:a.url}):c(p,{...n,url:a.url,onOpen:a.onOpen,merchantContext:i})}function d({children:e,suffix:t,onClick:n,style:u,...d}){let f=o(),p=f.status===`loading`,m=s(e=>{n?.(e),!e.defaultPrevented&&e.button===0&&(e.metaKey||e.ctrlKey||e.shiftKey||e.altKey||(e.preventDefault(),f.open()))},[f,n]),h=p?{...u,...l}:u;return c(i,{...d,href:r.support,suffix:p?c(a,{}):t,onClick:m,"aria-busy":p||void 0,"aria-disabled":p||void 0,style:h,children:e})}function f({url:e,children:t,...n}){return c(i,{...n,href:e,children:t})}function p({url:e,onOpen:t,merchantContext:r,children:a,suffix:o,onClick:l,...u}){let d=s(e=>{l?.(e),!e.defaultPrevented&&e.button===0&&(e.metaKey||e.ctrlKey||e.shiftKey||e.altKey||(e.preventDefault(),t({event:e,...m(r)})))},[l,t,r]),f=s(e=>{l?.(e),!e.defaultPrevented&&t({event:e,...m(r)})},[l,t,r]);return e?c(i,{...u,href:e,suffix:o,onClick:d,children:a}):c(n,{...u,suffix:o,onClick:f,children:a})}function m(e){return e??{gatewayKey:``,environment:``,assetChain:``,assetSymbol:``}}export{u as SupportLink};

package/dist/shared/support/SupportSpinner.d.ts

@@ -0,0 +1 @@
+export { };

package/dist/shared/support/index.d.ts

@@ -0,0 +1,2 @@
+import { IntercomMerchantContext } from "./useIntercomMerchantContext.js";
+import { SupportConfig, SupportOpenContext } from "./types.js";

package/dist/shared/support/index.js

@@ -1 +1 @@
-import"./intercom-loader.js";import"./SupportSpinner.js";import"./useSupportTrigger.js";import"./SupportLink.js";import"./useIntercomMerchantContext.js";import"./useIntercomShutdownOnUnmount.js";
+import"./SupportConfigContext.js";import"./intercom-loader.js";import"./resolveSupport.js";import"./SupportButton.js";import"./SupportSpinner.js";import"./useSupportTrigger.js";import"./SupportLink.js";import"./useIntercomMerchantContext.js";import"./useIntercomShutdownOnUnmount.js";import"./useMerchantContext.js";

package/dist/shared/support/intercom-loader.d.ts

@@ -0,0 +1,17 @@
+//#region src/shared/support/intercom-loader.d.ts
+/**
+ * Messenger command dispatcher exposed at `window.Intercom`. The vendor accepts arbitrary
+ * command tuples (`["boot", settings]`, `["onShow", callback]`, `["show"]`, …); our calls
+ * are funneled through {@link openIntercom} / {@link shutdownIntercom}.
+ */
+type IntercomFn = (...args: unknown[]) => void;
+declare global {
+  interface Window {
+    Intercom?: IntercomFn;
+    intercomSettings?: Record<string, unknown>;
+  }
+}
+/**
+ * Returns `true` when the vendor's real dispatcher is mounted on `window.Intercom`. Used by
+ * {@link useSupportTrigger} as a hint for whether a subsequent click can skip the spinner.
+ */

package/dist/shared/support/intercom-loader.js

@@ -1 +1 @@
-import{BRAND_INTERCOM as e}from"../constants/brand-intercom.js";const t=`__stridgeKitShim__`;let n=null;function r(e){return e[t]===!0}function i(){if(typeof window>`u`)return!1;let t=window.intercomSettings?.app_id;if(typeof t==`string`&&t!==e.appId)return!0;let n=window.Intercom;return typeof n!=`function`||r(n)?!1:t===void 0}function a(){let e=window;if(typeof e.Intercom==`function`)return e.Intercom;let n=[],r=Object.assign((...e)=>{n.push(e)},{q:n,c:e=>{n.push(e)},[t]:!0});return e.Intercom=r,r}function o(){return n||(typeof document>`u`?Promise.reject(Error(`Intercom can only load in a browser`)):(n=new Promise((t,i)=>{let a=document.createElement(`script`);a.type=`text/javascript`,a.async=!0,a.src=`https://widget.intercom.io/widget/${e.appId}`,a.dataset.stridgeIntercom=`true`,a.addEventListener(`load`,()=>t()),a.addEventListener(`error`,()=>{n=null,a.remove(),typeof window<`u`&&window.Intercom&&r(window.Intercom)&&delete window.Intercom,i(Error(`Failed to load Intercom widget script`))}),document.head.appendChild(a)}),n))}function s(){if(typeof window>`u`)return!1;let e=window.Intercom;return typeof e==`function`&&!r(e)}function c(){return typeof window>`u`?Promise.reject(Error(`Intercom can only load in a browser`)):i()?Promise.reject(Error(`Another Intercom workspace is already mounted; falling back to web link`)):new Promise((t,n)=>{let r=window;r.intercomSettings={...r.intercomSettings,app_id:e.appId,hide_default_launcher:!0};let i=a(),s=!1,c,u=e=>{s||(s=!0,c!==void 0&&clearTimeout(c),e())};i(`boot`,{...r.intercomSettings,app_id:e.appId,hide_default_launcher:!0}),i(`onShow`,()=>{u(()=>t())}),i(`onHide`,()=>{l()}),i(`show`),c=setTimeout(()=>{u(()=>n(Error(`Intercom messenger did not display within timeout`)))},1e4),o().catch(e=>{u(()=>n(e))})})}function l(){if(typeof window>`u`)return;let e=window.Intercom;if(typeof e==`function`&&!r(e))try{e(`shutdown`)}catch{}}export{s as isIntercomReady,c as openIntercom,l as shutdownIntercom};
+import{BRAND_INTERCOM as e}from"../constants/brand-intercom.js";const t=`__stridgeKitShim__`;let n=null,r=!1;function i(e){return e[t]===!0}function a(){if(typeof window>`u`)return!1;let t=window.intercomSettings?.app_id,n=!1;if(typeof t==`string`&&t!==e.appId)n=!0;else{let e=window.Intercom;typeof e==`function`&&!i(e)&&t===void 0&&(n=!0)}return n&&o(),n}function o(){r||process.env.NODE_ENV!==`production`&&(r=!0,console.warn("[@stridge/kit] Detected a foreign Intercom workspace already mounted on this page. The kit's support link will fall back to opening the static support URL in a new tab. Configure `<StridgeProvider support={{ url: '...' }} />` or `<StridgeProvider support={{ onOpen: ... }} />` to silence this warning and customize the behavior."))}function s(){let e=window;if(typeof e.Intercom==`function`)return e.Intercom;let n=[],r=Object.assign((...e)=>{n.push(e)},{q:n,c:e=>{n.push(e)},[t]:!0});return e.Intercom=r,r}function c(){return n||(typeof document>`u`?Promise.reject(Error(`Intercom can only load in a browser`)):(n=new Promise((t,r)=>{let a=document.createElement(`script`);a.type=`text/javascript`,a.async=!0,a.src=`https://widget.intercom.io/widget/${e.appId}`,a.dataset.stridgeIntercom=`true`,a.addEventListener(`load`,()=>t()),a.addEventListener(`error`,()=>{n=null,a.remove(),typeof window<`u`&&window.Intercom&&i(window.Intercom)&&delete window.Intercom,r(Error(`Failed to load Intercom widget script`))}),document.head.appendChild(a)}),n))}function l(){if(typeof window>`u`)return!1;let e=window.Intercom;return typeof e==`function`&&!i(e)}function u(){return typeof window>`u`?Promise.reject(Error(`Intercom can only load in a browser`)):a()?Promise.reject(Error(`Another Intercom workspace is already mounted; falling back to web link`)):new Promise((t,n)=>{let r=window;r.intercomSettings={...r.intercomSettings,app_id:e.appId,hide_default_launcher:!0};let i=s(),a=!1,o,l=e=>{a||(a=!0,o!==void 0&&clearTimeout(o),e())};i(`boot`,{...r.intercomSettings,app_id:e.appId,hide_default_launcher:!0}),i(`onShow`,()=>{l(()=>t())}),i(`onHide`,()=>{d()}),i(`show`),o=setTimeout(()=>{l(()=>n(Error(`Intercom messenger did not display within timeout`)))},1e4),c().catch(e=>{l(()=>n(e))})})}function d(){if(typeof window>`u`)return;let e=window.Intercom;if(typeof e==`function`&&!i(e))try{e(`shutdown`)}catch{}}export{l as isIntercomReady,u as openIntercom,d as shutdownIntercom};

package/dist/shared/support/resolveSupport.d.ts

@@ -0,0 +1 @@
+export { };

package/dist/shared/support/resolveSupport.js

@@ -0,0 +1 @@
+function e(e){return e?.onOpen?e.url?{kind:`custom`,onOpen:e.onOpen,url:e.url}:{kind:`custom`,onOpen:e.onOpen}:e?.url?{kind:`url`,url:e.url}:{kind:`stridge`}}export{e as resolveSupport};

package/dist/shared/support/types.d.ts

@@ -0,0 +1,43 @@
+import { IntercomMerchantContext } from "./useIntercomMerchantContext.js";
+import { MouseEvent } from "react";
+
+//#region src/shared/support/types.d.ts
+/**
+ * Configures the kit's in-dialog "Get help" entry point.
+ *
+ * Omit `support` to boot Stridge's hosted messenger on plain left-click and fall back to
+ * {@link https://stridge.com/contact-us | the support URL}. Provide `url`, `onOpen`, or both
+ * to use merchant-owned support; either field opts out of Stridge messenger globals. Empty
+ * values (`{}` or `{ url: "" }`) fall back to the Stridge default.
+ *
+ * Treated as static across the kit's lifetime. Switching the mode after mount (e.g. from
+ * Stridge to merchant-owned support) is not supported — the kit will not shut down an
+ * already-booted Stridge messenger or clear `window.intercomSettings` on the transition.
+ * Resolve support configuration before the first render of `<StridgeProvider>`.
+ */
+interface SupportConfig {
+  /**
+   * URL used as the "Get help" anchor `href`.
+   *
+   * Empty string is treated as if the field were omitted.
+   */
+  url?: string;
+  /**
+   * Custom click handler invoked instead of the default Stridge messenger.
+   *
+   * Fires on plain left-click with the click event and the merchant/user triage metadata.
+   * Modified clicks keep anchor navigation when `url` is set.
+   */
+  onOpen?: (ctx: SupportOpenContext) => void;
+}
+/**
+ * Represents the argument passed to {@link SupportConfig.onOpen}.
+ *
+ * Combines the click event with the same triage metadata used by the Stridge messenger.
+ */
+interface SupportOpenContext extends IntercomMerchantContext {
+  /** React synthetic event for the click that triggered support. */
+  event: MouseEvent<HTMLElement>;
+}
+//#endregion
+export { SupportConfig, SupportOpenContext };

package/dist/shared/support/useIntercomMerchantContext.d.ts

@@ -0,0 +1,27 @@
+//#region src/shared/support/useIntercomMerchantContext.d.ts
+/**
+ * Merchant, asset, and end-user triage metadata the kit attaches to support requests.
+ *
+ * Stridge's hosted messenger reads these fields via `window.intercomSettings` so support
+ * agents can route an incoming conversation without asking the user for context. Merchant-
+ * owned support entry points receive the same shape via
+ * {@link SupportOpenContext}, so triage data carries through verbatim into custom handlers.
+ */
+interface IntercomMerchantContext {
+  /** Stridge gateway key — primary key uniquely identifying which integrating business the user is coming through. */
+  gatewayKey: string;
+  /** Stridge API environment the kit is talking to. Goes alongside the gateway key for support triage. */
+  environment: string;
+  /** Stridge `network_id` of the settlement asset (e.g. `"60"`, `"9006"`). */
+  assetChain: string;
+  /** Settlement asset symbol (e.g. `"USDC"`). */
+  assetSymbol: string;
+  /** Connected wallet address — best-effort end-user identifier in a web3 context. */
+  userAddress?: string;
+  /** Merchant display name resolved from `gateway/start.metadata.brand_name`. Async; undefined pre-bootstrap. */
+  brandName?: string;
+  /** Optional secondary line from `gateway/start.metadata.checkout_item_title`. */
+  checkoutItemTitle?: string;
+}
+//#endregion
+export { IntercomMerchantContext };

package/dist/shared/support/useIntercomMerchantContext.js

@@ -1 +1 @@
-"use client";import{BRAND_INTERCOM as e}from"../constants/brand-intercom.js";import{useEffect as t}from"react";function n({gatewayKey:n,environment:r,assetChain:i,assetSymbol:a,userAddress:o,brandName:s,checkoutItemTitle:c}){t(()=>{if(typeof window>`u`)return;let t=window.intercomSettings?.app_id;if(typeof t==`string`&&t!==e.appId)return;let l={company_id:n,environment:r,asset_chain:i,asset_symbol:a};s&&(l.name=s),c&&(l.checkout_item_title=c);let u={...window.intercomSettings,app_id:e.appId,hide_default_launcher:!0,company:l};if(o&&(u.user_id=o,u.wallet_address=o),window.intercomSettings=u,typeof window.Intercom==`function`)try{window.Intercom(`update`,u)}catch{}},[n,r,i,a,o,s,c])}export{n as useIntercomMerchantContext};
+"use client";import{BRAND_INTERCOM as e}from"../constants/brand-intercom.js";import{useEffect as t}from"react";function n(n){let r=n?.gatewayKey,i=n?.environment,a=n?.assetChain,o=n?.assetSymbol,s=n?.userAddress,c=n?.brandName,l=n?.checkoutItemTitle;t(()=>{if(!r||!i||!a||!o||typeof window>`u`)return;let t=window.intercomSettings?.app_id;if(typeof t==`string`&&t!==e.appId)return;let n={company_id:r,environment:i,asset_chain:a,asset_symbol:o};c&&(n.name=c),l&&(n.checkout_item_title=l);let u={...window.intercomSettings,app_id:e.appId,hide_default_launcher:!0,company:n};if(s&&(u.user_id=s,u.wallet_address=s),window.intercomSettings=u,typeof window.Intercom==`function`)try{window.Intercom(`update`,u)}catch{}},[r,i,a,o,s,c,l])}export{n as useIntercomMerchantContext};

package/dist/shared/support/useMerchantContext.d.ts

@@ -0,0 +1 @@
+export { };

package/dist/shared/support/useMerchantContext.js

@@ -0,0 +1 @@
+"use client";import{useSyncExternalStore as e}from"react";function t({gatewayKey:t,environment:n,assetChain:r,assetSymbol:i,userAddress:a,depositDriver:o}){let s=e(e=>o?.subscribe(e)??(()=>{}),()=>{if(!o)return;let e=o.getSnapshot();if(e.brand.status===`ready`||e.brand.status===`stale`)return e.brand.payload.name},()=>void 0),c=e(e=>o?.subscribe(e)??(()=>{}),()=>{if(!o)return;let e=o.getSnapshot();if(e.brand.status===`ready`||e.brand.status===`stale`)return e.brand.payload.checkoutItemTitle},()=>void 0);return{gatewayKey:t,environment:n,assetChain:r,assetSymbol:i,...a?{userAddress:a}:{},...s?{brandName:s}:{},...c?{checkoutItemTitle:c}:{}}}export{t as useMerchantContext};

package/dist/shared/ui/ExternalLink/ExternalLink.js

@@ -1 +1 @@
-"use client";import{joinClassNames as e}from"../../utils/joinClassNames.js";import{EXTERNAL_LINK_SLOTS as t}from"./ExternalLink.slots.js";import{styles as n}from"./ExternalLink.styles.js";import{toSafeHref as r}from"./toSafeHref.js";import{cloneElement as i,isValidElement as a}from"react";import{jsx as o,jsxs as s}from"react/jsx-runtime";import*as c from"@stylexjs/stylex";function l({href:i,suffix:a,className:l,style:d,children:f,...p}){let m=r(i)??`#`,h=a!=null&&a!==!1,g=c.props(n.root),_=e(g.className,l),v=c.props(n.iconSlot,n.suffixSpacing);return s(`a`,{"data-stridge-slot":t.root,...p,href:m,target:`_blank`,rel:`noreferrer noopener`,className:_,style:{...g.style,...d},children:[f,h?o(`span`,{"data-icon":`inline-end`,...v,children:u(a)}):null]})}function u(e){if(!a(e))return e;let t=c.props(n.iconSvg);return i(e,{className:[e.props.className,t.className].filter(Boolean).join(` `),style:{...e.props.style,...t.style}})}export{l as ExternalLink};
+"use client";import{styles as e}from"./ExternalLink.styles.js";import{joinClassNames as t}from"../../utils/joinClassNames.js";import{EXTERNAL_LINK_SLOTS as n}from"./ExternalLink.slots.js";import{toSafeHref as r}from"./toSafeHref.js";import{cloneElement as i,isValidElement as a}from"react";import{jsx as o,jsxs as s}from"react/jsx-runtime";import*as c from"@stylexjs/stylex";function l({href:i,suffix:a,className:l,style:d,children:f,...p}){let m=r(i)??`#`,h=a!=null&&a!==!1,g=c.props(e.root),_=t(g.className,l),v=c.props(e.iconSlot,e.suffixSpacing);return s(`a`,{"data-stridge-slot":n.root,...p,href:m,target:`_blank`,rel:`noreferrer noopener`,className:_,style:{...g.style,...d},children:[f,h?o(`span`,{"data-icon":`inline-end`,...v,children:u(a)}):null]})}function u(t){if(!a(t))return t;let n=c.props(e.iconSvg);return i(t,{className:[t.props.className,n.className].filter(Boolean).join(` `),style:{...t.props.style,...n.style}})}export{l as ExternalLink};

package/dist/stridge/StridgeProvider.d.ts

@@ -1,4 +1,5 @@
 import { KitI18nConfig } from "../shared/i18n/createKitI18n.js";
+import { SupportConfig } from "../shared/support/types.js";
 import { StridgeEnvironment } from "../drivers/stridge/types.js";
 import { ChainInput } from "../shared/chains/index.js";
 import { Address } from "viem";
@@ -187,6 +188,13 @@ declare namespace StridgeProvider {
      * prefix at the call site.
      */
     dev?: StridgeDevConfig;
+    /**
+     * Customer-support entry point configuration.
+     *
+     * Omit to use Stridge Intercom. Provide `url`, `onOpen`, or both to use merchant-owned
+     * support and opt out of Stridge messenger globals.
+     */
+    support?: SupportConfig;
     /** Optional className applied to the kit's scope root `<div>`. */
     className?: string;
     children?: ReactNode;
@@ -226,6 +234,7 @@ declare function StridgeProvider({
   i18n,
   storage,
   dev,
+  support,
   className,
   children
 }: StridgeProvider.Props): _$react_jsx_runtime0.JSX.Element;

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

package/package.json

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