@zerohash-sdk/fund-withdrawals-react 0.1.0

package/README.md

@@ -0,0 +1,7 @@
+# @zerohash-sdk/fund-withdrawals-react
+
+This library was generated with [Nx](https://nx.dev).
+
+## Running unit tests
+
+Run `nx test @zerohash-sdk/fund-withdrawals-react` to execute the unit tests via [Vitest](https://vitest.dev/).

package/dist/index.d.ts

@@ -0,0 +1,124 @@
+import { default as default_2 } from 'react';
+
+/**
+ * Generic app event structure
+ * @template TType - Event type string
+ * @template TData - Event data payload
+ */
+declare type AppEvent<TType extends string = string, TData = Record<string, unknown>> = {
+    /** The type of event that occurred */
+    type: TType;
+    /** Data associated with the event */
+    data: TData;
+};
+
+/**
+ * Available environments for the Fund Withdrawals service.
+ */
+declare type Environment = 'local' | 'dev' | 'cert' | 'prod';
+
+/**
+ * Generic error codes for all Connect applications
+ */
+declare enum ErrorCode {
+    /** Network connectivity error */
+    NETWORK_ERROR = 'network_error',
+    /** Authentication or session expired error */
+    AUTH_ERROR = 'auth_error',
+    /** Resource not found error */
+    NOT_FOUND_ERROR = 'not_found_error',
+    /** Validation error from user input */
+    VALIDATION_ERROR = 'validation_error',
+    /** Server error (5xx) */
+    SERVER_ERROR = 'server_error',
+    /** Client error (4xx) */
+    CLIENT_ERROR = 'client_error',
+    /** Unknown or unexpected error */
+    UNKNOWN_ERROR = 'unknown_error',
+}
+
+/**
+ * Generic error payload structure for error callbacks
+ */
+declare type ErrorPayload = {
+    /** Error code indicating the type of error */
+    errorCode: ErrorCode;
+    /** Human-readable reason for the error */
+    reason: string;
+};
+
+/**
+ * A React wrapper component for the Fund Withdrawals product.
+ *
+ * @example
+ * ```tsx
+ * <FundWithdrawals jwt="your-jwt-token" env="cert" />
+ * ```
+ */
+export declare const FundWithdrawals: default_2.FC<FundWithdrawalsProps>;
+
+declare type FundWithdrawalsCompletedData = {
+    /** External account identifier the funds were sent to */
+    externalAccountId: string;
+    /** Symbol of the asset that was withdrawn (e.g. 'BTC') */
+    assetSymbol: string;
+    /** Quantity withdrawn as a string */
+    amount: string;
+};
+
+declare type FundWithdrawalsEvent = AppEvent<FundWithdrawalsEventType>;
+
+declare type FundWithdrawalsEventType = string;
+
+declare interface FundWithdrawalsProps {
+    /**
+     * JWT token used for authentication.
+     */
+    jwt: string;
+    /**
+     * Target environment for the Fund Withdrawals service.
+     *
+     * @default "prod"
+     */
+    env?: Environment;
+    /**
+     * Theme mode.
+     *
+     * @default "auto"
+     */
+    theme?: Theme;
+    /**
+     * When true, the widget renders as the Payouts flow. When false or omitted,
+     * renders as the standard Fund Withdrawals flow.
+     *
+     * @default false
+     */
+    isPayouts?: boolean;
+    /**
+     * Callback invoked when the withdrawal flow is successfully completed.
+     */
+    onCompleted?: (data: FundWithdrawalsCompletedData) => void;
+    /**
+     * Callback invoked when an error occurs.
+     */
+    onError?: (error: ErrorPayload) => void;
+    /**
+     * Callback invoked when the user closes the widget.
+     */
+    onClose?: () => void;
+    /**
+     * Callback invoked when the widget has finished loading and is ready.
+     */
+    onLoaded?: () => void;
+    /**
+     * Callback invoked for general application events during the flow.
+     */
+    onEvent?: (event: FundWithdrawalsEvent) => void;
+}
+
+/**
+ * Theme mode for the Fund Withdrawals interface.
+ */
+declare type Theme = 'auto' | 'light' | 'dark';
+
+export { }

package/dist/index.js

@@ -0,0 +1,42 @@
+import m, { useRef as x, useEffect as h } from "react";
+const b = {
+  local: "http://localhost:5173/fund-withdrawals-web/index.js",
+  dev: "https://connect-sdk.dev.0hash.com/fund-withdrawals-web/index.js",
+  cert: "https://sdk.sandbox.connect.xyz/fund-withdrawals-web/index.js",
+  prod: "https://sdk.connect.xyz/fund-withdrawals-web/index.js"
+}, y = "zerohash-fund-withdrawals-script", u = "zerohash-fund-withdrawals", I = (s = "prod") => b[s], j = ({
+  jwt: s,
+  env: r = "prod",
+  theme: p,
+  isPayouts: c = !1,
+  onCompleted: n,
+  onError: d,
+  onClose: o,
+  onLoaded: i,
+  onEvent: a,
+  ...w
+}) => {
+  const l = x(null);
+  return h(() => {
+    const t = l.current;
+    t && (t.isPayouts = c, n && (t.onCompleted = n), d && (t.onError = d), o && (t.onClose = o), i && (t.onLoaded = i), a && (t.onEvent = a));
+  }, [c, n, d, o, i, a]), h(() => {
+    const t = I(r), f = `${y}-${r}`;
+    if (document.getElementById(f))
+      return;
+    const e = document.createElement("script");
+    e.id = f, e.src = t, e.type = "module", e.async = !0, e.onerror = () => {
+      console.error(`Failed to load the script for ${u} from ${r} environment.`);
+    }, document.head.appendChild(e);
+  }, [r]), m.createElement(u, {
+    ref: l,
+    jwt: s,
+    env: r,
+    theme: p,
+    "is-payouts": c ? "true" : "false",
+    ...w
+  });
+};
+export {
+  j as FundWithdrawals
+};

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "@zerohash-sdk/fund-withdrawals-react",
+  "version": "0.1.0",
+  "private": false,
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "license": "MIT",
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "!**/*.tsbuildinfo"
+  ],
+  "nx": {
+    "name": "fund-withdrawals-react"
+  },
+  "peerDependencies": {
+    "react": ">=18.0.0",
+    "react-dom": ">=18.0.0"
+  }
+}