@stridge/kit 0.1.0-alpha.0

package/dist/stridge/StridgeContext.js

@@ -0,0 +1 @@
+"use client";import{createContext as e,use as t}from"react";const n=e(null);n.displayName=`StridgeContext`;function r(){let e=t(n);if(!e)throw Error(`useStridge: must be used inside a <StridgeProvider />. Hosts assembling a custom driver against <KitProvider /> should not call useStridge.`);return e}function i(){return t(n)}export{n as StridgeContext,i as useOptionalStridge,r as useStridge};

package/dist/stridge/StridgeProvider.d.ts

@@ -0,0 +1,158 @@
+import { KitI18nConfig } from "../shared/i18n/createKitI18n.js";
+import { StridgeEnvironment } from "../drivers/stridge/types.js";
+import { ChainInput } from "../shared/chains/index.js";
+import { ReactNode } from "react";
+import * as _$react_jsx_runtime0 from "react/jsx-runtime";
+
+//#region src/stridge/StridgeProvider.d.ts
+/**
+ * Settlement-asset tuple. `chain` accepts any of: an EIP-155 chain id (`56`), a slug from the
+ * `chains` namespace (`chains.bsc`), or a Stridge `network_id` string (`"9006"`). `symbol` is
+ * the asset symbol on that chain (e.g. `"USDC"`). The kit normalizes `chain` internally — the
+ * gateway always receives the wire-shape `network_id`.
+ *
+ * The same `asset` drives both flows:
+ *
+ * - **Deposit** settles to this `(chain, symbol)` at the connected wallet (same-owner pattern).
+ * - **Withdraw** sources from this `(chain, symbol)` of the user's on-chain balance.
+ */
+interface StridgeAsset {
+  chain: ChainInput;
+  symbol: string;
+}
+/**
+ * Per-flow deposit tuning. Pass `deposit: {}` to enable the deposit flow with defaults.
+ */
+interface StridgeDepositFlowConfig {
+  /**
+   * Low-balance / amount-entry USD floor. Defaults to the kit's internal default
+   * (`STRIDGE_DEFAULT_MIN_DEPOSIT_USD`) when omitted.
+   */
+  minDepositUsd?: number;
+  /**
+   * Metadata persisted on the UDA at `gateway/start` time. Echoed back on `gateway/{owner}`
+   * and webhook payloads. Treat as untrusted display data.
+   */
+  metadata?: Record<string, unknown>;
+}
+/**
+ * Per-flow withdraw tuning. Pass `withdraw: {}` to enable the withdraw flow with defaults.
+ */
+interface StridgeWithdrawFlowConfig {
+  /**
+   * Metadata persisted on every UDA the withdraw flow provisions. Merged under the kit-set
+   * `kit_flow` / `kit_version` / `source` keys (kit keys win).
+   */
+  metadata?: Record<string, unknown>;
+}
+/**
+ * Visual configuration for the kit's rendered UI. Drives every kit primitive — primary action
+ * accents, dialog frames, picker rows, copy pills.
+ */
+interface StridgeAppearance {
+  /** Theme preset. `"dark"` by default. */
+  theme?: "dark" | "light";
+  /** Accent color applied to every kit primitive. Accepts any CSS color string. */
+  accent?: string;
+  /** Border-radius preset. `"sharp" | "subtle" | "rounded" | "pill"`. */
+  radius?: "sharp" | "subtle" | "rounded" | "pill";
+  /**
+   * Text direction the kit's primitives render with. Falls back to a locale-derived default
+   * (`"rtl"` for Arabic, Hebrew, Persian, Urdu) when omitted.
+   */
+  direction?: "ltr" | "rtl";
+}
+/**
+ * Persistence configuration for the kit's per-tab state (settlement banner acks, future
+ * kit-wide features).
+ */
+interface StridgeStorageConfig {
+  /**
+   * Storage backend. `"session"` (default — `sessionStorage`, forgotten on tab close),
+   * `"local"` (`localStorage`, survives restarts), or `"memory"` (in-process only, ideal for
+   * tests).
+   */
+  driver?: "session" | "local" | "memory";
+  /**
+   * Prefix every key the kit writes under. Two `<StridgeProvider />` instances on the same
+   * page sharing a backend should pick distinct namespaces to keep state isolated. Defaults
+   * to `stridge-kit:storage:v1`.
+   */
+  namespace?: string;
+}
+declare namespace StridgeProvider {
+  interface Props {
+    /**
+     * Stridge gateway key. Pull from your workspace dashboard
+     * (Developer → Gateway Kit → Connection).
+     */
+    gatewayKey: string;
+    /**
+     * Which Stridge API host the kit talks to. Defaults to `"production"`
+     * (`api.stridge.com`). Pass `"staging"` (`api.stridge.dev`) for integration testing.
+     * Note that gateway keys are environment-scoped — a staging key won't authenticate
+     * against production and vice versa.
+     */
+    environment?: StridgeEnvironment;
+    /**
+     * Settlement asset — the single source of truth for which `(chain, symbol)` the gateway
+     * operates in. Deposit settles to this asset; withdraw sources from this asset.
+     */
+    asset: StridgeAsset;
+    /**
+     * Enabled flows + their per-flow tuning. At least one of `deposit` / `withdraw` is
+     * required.
+     */
+    flows: {
+      deposit?: StridgeDepositFlowConfig;
+      withdraw?: StridgeWithdrawFlowConfig;
+    };
+    /** Visual configuration. */
+    appearance?: StridgeAppearance;
+    /** Active locale config. */
+    i18n?: KitI18nConfig;
+    /** Persistence configuration for kit-internal state. */
+    storage?: StridgeStorageConfig;
+    /** Optional className applied to the kit's scope root `<div>`. */
+    className?: string;
+    children?: ReactNode;
+  }
+}
+/**
+ * Single integration entry point for `@stridge/kit`. Reads the connected wallet via wagmi,
+ * instantiates a Stridge-backed driver per enabled flow, and mounts the kit's scope (theme,
+ * accent, radius, direction), locale, and persistent storage.
+ *
+ * Mount once at the host's app root. Drop `<DepositDialog />` and / or `<WithdrawDialog />`
+ * from the per-flow `/dialog` subpaths anywhere inside; open them with `useDeposit().open()` /
+ * `useWithdraw().open()`.
+ *
+ * @example
+ * ```tsx
+ * import { StridgeProvider, chains } from "@stridge/kit";
+ * import { DepositDialog } from "@stridge/kit/deposit/dialog";
+ *
+ * <StridgeProvider
+ *     gatewayKey={process.env.NEXT_PUBLIC_STRIDGE_GATEWAY_KEY!}
+ *     asset={{ chain: chains.bsc, symbol: "USDC" }}
+ *     flows={{ deposit: {} }}
+ *     appearance={{ theme: "dark", accent: "oklch(78% 0.15 240)", radius: "rounded" }}
+ * >
+ *     <YourApp />
+ *     <DepositDialog />
+ * </StridgeProvider>;
+ * ```
+ */
+declare function StridgeProvider({
+  gatewayKey,
+  environment,
+  asset,
+  flows,
+  appearance,
+  i18n,
+  storage,
+  className,
+  children
+}: StridgeProvider.Props): _$react_jsx_runtime0.JSX.Element;
+//#endregion
+export { StridgeAppearance, StridgeAsset, StridgeDepositFlowConfig, StridgeProvider, StridgeStorageConfig, StridgeWithdrawFlowConfig };

package/dist/stridge/StridgeProvider.js

@@ -0,0 +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{createStubDepositDriver as o,createStubWithdrawDriver as s}from"./stubs.js";import{useMemo as c,useRef as l,useSyncExternalStore as u}from"react";import{jsx as d}from"react/jsx-runtime";import{useAccount as f,useConfig as p}from"wagmi";function m({gatewayKey:m,environment:h,asset:g,flows:_,appearance:v,i18n:y,storage:b,className:x,children:S}){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 C=p(),{address:w}=f(),T=c(()=>t(y??{}),[y?.locale,y?.catalogs]),E=l(T);E.current=T;let D=c(()=>e(g.chain),[g.chain]),O=g.symbol,k=_.deposit,A=_.withdraw,j=c(()=>{if(!(!k||!w))return r({userAddress:w,projectKey:m,destination:{network_id:D,asset_symbol:O},wagmiConfig:C,getI18n:()=>E.current,...h?{environment:h}:{},...k.minDepositUsd===void 0?{}:{minDepositUsd:k.minDepositUsd},...k.metadata?{metadata:k.metadata}:{}})},[k,w,m,h,D,O,C]),M=c(()=>o(),[]),N=k?j??M:void 0,P=c(()=>{if(!(!A||!w))return i({userAddress:w,projectKey:m,currency:{networkId:D,assetSymbol:O},wagmiConfig:C,getI18n:()=>E.current,...h?{environment:h}:{},...A.metadata?{metadata:A.metadata}:{}})},[A,w,m,h,D,O,C]),F=c(()=>s(),[]),I=A?P??F:void 0,L=j??P,R=u(e=>L?.subscribe(e)??(()=>{}),()=>{if(j){let e=j.getSnapshot();return e.brand.status===`ready`&&e.target.status===`ready`}return P?P.getSnapshot().receiveOptions.status===`ready`:!1},()=>!1);return d(n,{value:c(()=>({isReady:R,driver:j}),[R,j]),children:d(a,{theme:v?.theme,accent:v?.accent,radius:v?.radius,direction:v?.direction,i18n:y,storage:b?.driver,storageNamespace:b?.namespace,className:x,...N?{deposit:N}:{},...I?{withdraw:I}:{},children:S})})}export{m as StridgeProvider};

package/dist/stridge/stubs.js

@@ -0,0 +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};