@zerohash-sdk/travel-rule-react 0.3.0 → 0.3.1

package/dist/index.d.ts

@@ -66,7 +66,7 @@ declare type Theme = 'auto' | 'light' | 'dark';
  *
  * @param props - Component properties
  * @param jwt - JWT token for authentication (required)
- * @param depositId - Deposit id the submission is tied to (required, TRD §4.1)
+ * @param depositId - Deposit id the submission is tied to (required)
  * @param env - Target environment ("local" | "dev" | "cert" | "prod", defaults to "prod")
  * @param theme - Theme mode ("auto" | "light" | "dark", defaults to "auto")
  * @param onCompleted - Callback invoked when the flow is successfully completed
@@ -107,21 +107,26 @@ declare interface TravelRuleProps {
     jwt: string;
     /**
      * Deposit id the travel-rule submission is tied to. Required — every
-     * travel-rule submission is scoped to a specific deposit (TRD §4.1 host
-     * handoff contract). Init-only: post-mount changes are ignored, matching
-     * the behaviour of `env`.
+     * travel-rule submission is scoped to a specific deposit. Init-only:
+     * post-mount changes are ignored, matching the behaviour of `env`.
      *
      * @example "deposit-abc123"
      */
     depositId: string;
     /**
-     * Wallet address the travel-rule submission relates to. Optional —
-     * carried alongside `depositId` when known. Init-only: post-mount changes are
-     * ignored, matching the behaviour of `depositId` / `env`.
+     * On-chain address the SDK is asking about (deposit source wallet for
+     * deposits, destination wallet for withdrawals). Used to query the
+     * travel-rule ownership status and pick which screen to show. Init-only.
      *
-     * @example "0xabc123..."
+     * @example "0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266"
      */
-    walletAddress?: string;
+    walletAddress: string;
+    /**
+     * Which side of the flow the SDK is being opened for. Sent as
+     * `intention_action` on the status query — the same address can require
+     * different ownership evidence for deposits vs. withdrawals. Init-only.
+     */
+    intentionAction: 'deposit' | 'withdrawal';
     /**
      * Target environment for the Zerohash Travel Rule service.
      *

package/dist/index.js

@@ -1,4 +1,4 @@
-import { jsxs as W, jsx as y } from "react/jsx-runtime";
+import { jsxs as A, jsx as y } from "react/jsx-runtime";
 import j, { useEffect as U, useState as z, useCallback as D, useRef as M } from "react";
 const $ = {
   dev: "https://grafana-faro-collector.dev.0hash.com/collect",
@@ -23,28 +23,28 @@ const $ = {
   } catch {
     return null;
   }
-}, A = (e, t) => V(t) !== "eu" ? e : e === "cert" ? "eu-cert" : e === "prod" ? "eu-prod" : e, P = (e) => {
+}, I = (e, t) => V(t) !== "eu" ? e : e === "cert" ? "eu-cert" : e === "prod" ? "eu-prod" : e, P = (e) => {
   if (!e || typeof e != "string")
     return {};
   const t = e.split(".");
   if (t.length < 2)
     return {};
   try {
-    const o = t[1].replace(/-/g, "+").replace(/_/g, "/"), r = o + "===".slice(0, (4 - o.length % 4) % 4), n = typeof atob < "u" ? atob(r) : Buffer.from(r, "base64").toString("utf-8"), l = JSON.parse(n), c = l?.payload ?? {}, a = (s) => typeof s == "string" && s.length > 0 ? s : void 0;
+    const o = t[1].replace(/-/g, "+").replace(/_/g, "/"), r = o + "===".slice(0, (4 - o.length % 4) % 4), n = typeof atob < "u" ? atob(r) : Buffer.from(r, "base64").toString("utf-8"), s = JSON.parse(n), c = s?.payload ?? {}, a = (l) => typeof l == "string" && l.length > 0 ? l : void 0;
     return {
       participantCode: a(c.participant_code),
       platformName: a(c.platform_name),
-      platformCode: a(l.platform_code),
+      platformCode: a(s.platform_code),
       region: a(c.region)
     };
   } catch {
     return {};
   }
 }, L = (e, t, o) => {
-  const r = A(t, o);
+  const r = I(t, o);
   return e[r] ?? e[t] ?? e.prod;
 }, J = (e, t, o) => {
-  const r = A(t, o);
+  const r = I(t, o);
   return e[r] ?? e[t];
 }, x = () => {
 }, H = () => {
@@ -53,7 +53,7 @@ const $ = {
 }, K = (e, t) => {
   const o = H(), r = globalThis.__ZH_WEB_SDK_VERSION__, n = {};
   e.claims.participantCode && (n.participant_code = e.claims.participantCode), e.claims.platformName && (n.platform_name = e.claims.platformName), e.claims.platformCode && (n.platform_code = e.claims.platformCode), e.claims.region && (n.region = e.claims.region), r && (n.zh_web_sdk_version = r);
-  const l = {
+  const s = {
     meta: {
       app: { name: e.appName, version: t ?? "unknown", environment: e.env },
       session: { id: o, attributes: n },
@@ -75,7 +75,7 @@ const $ = {
       }
     ]
   };
-  return { sessionId: o, payload: l };
+  return { sessionId: o, payload: s };
 }, G = (e, t, o) => {
   if (!e || typeof fetch > "u")
     return;
@@ -91,47 +91,47 @@ const $ = {
   } catch {
   }
 }, Z = (e) => {
-  const { webComponentTag: t, appName: o, appVersion: r, scriptUrls: n, fallbackScriptUrls: l, collectorUrls: c, env: a, jwt: s, timeoutMs: g = 15e3, onLoad: _, onError: f } = e;
+  const { webComponentTag: t, appName: o, appVersion: r, scriptUrls: n, fallbackScriptUrls: s, collectorUrls: c, env: a, jwt: l, timeoutMs: m = 15e3, onLoad: _, onError: g } = e;
   if (typeof document > "u")
     return x;
   const d = `${t}-script-${a}`;
   if (customElements.get(t) || document.getElementById(d))
     return x;
-  const b = P(s), v = e.report ?? ((p) => G(c && J(c, a, s), p, r));
-  let m = !1, E = 0, C;
-  const S = () => {
+  const b = P(l), R = e.report ?? ((p) => G(c && J(c, a, l), p, r));
+  let f = !1, E = 0, C;
+  const v = () => {
     C !== void 0 && clearTimeout(C);
   }, k = (p, h, i) => {
-    if (m)
+    if (f)
       return;
-    const I = Math.round(performance.now() - E), N = {
+    const W = Math.round(performance.now() - E), N = {
       webComponentTag: t,
       appName: o,
       env: a,
       scriptUrl: h,
       reason: p,
       triedFallback: i,
-      elapsedMs: I,
+      elapsedMs: W,
       claims: b
     };
-    v(N);
-    const O = i ? void 0 : L(l ?? {}, a, s);
+    R(N);
+    const O = i ? void 0 : L(s ?? {}, a, l);
     if (O && O !== h) {
       T(O, !0);
       return;
     }
-    m = !0, S(), document.getElementById(d)?.remove(), f?.(N);
+    f = !0, v(), document.getElementById(d)?.remove(), g?.(N);
   }, T = (p, h) => {
-    S(), E = performance.now();
+    v(), E = performance.now();
     const i = document.createElement("script");
     i.id = d, i.src = p, i.type = "module", i.async = !0, i.onload = () => {
       setTimeout(() => {
-        m || (customElements.get(t) ? (m = !0, S(), _?.()) : k("not-defined", p, h));
+        f || (customElements.get(t) ? (f = !0, v(), _?.()) : k("not-defined", p, h));
       }, 0);
-    }, i.onerror = () => k("network", p, h), C = setTimeout(() => k("timeout", p, h), g), document.getElementById(d)?.remove(), document.head.appendChild(i);
-  }, w = L(n, a, s);
+    }, i.onerror = () => k("network", p, h), C = setTimeout(() => k("timeout", p, h), m), document.getElementById(d)?.remove(), document.head.appendChild(i);
+  }, w = L(n, a, l);
   return w ? (T(w, !1), () => {
-    m = !0, S();
+    f = !0, v();
   }) : x;
 }, u = {
   local: "http://localhost:5173",
@@ -141,8 +141,8 @@ const $ = {
   "eu-cert": "https://sdk-cdn.cert.zerohash.eu",
   "eu-prod": "https://sdk-cdn.zerohash.eu"
 }, q = (e, t, o = {}) => {
-  const { eu: r = !1, legacyAliases: n = !1, local: l = u.local } = o, c = (s) => `${s}/${e}/${t}`, a = {
-    local: c(l),
+  const { eu: r = !1, legacyAliases: n = !1, local: s = u.local } = o, c = (l) => `${l}/${e}/${t}`, a = {
+    local: c(s),
     dev: c(u.dev),
     cert: c(u.cert),
     prod: c(u.prod)
@@ -153,12 +153,12 @@ var F;
 (function(e) {
   e.NETWORK_ERROR = "network_error", e.AUTH_ERROR = "auth_error", e.NOT_FOUND_ERROR = "not_found_error", e.VALIDATION_ERROR = "validation_error", e.SERVER_ERROR = "server_error", e.CLIENT_ERROR = "client_error", e.UNKNOWN_ERROR = "unknown_error";
 })(F || (F = {}));
-const R = {
+const S = {
   evergreen: "#00381D",
   green: "#CCFFD0",
   offBlack: "#1C1B1C",
   grayLight: "#EBEBE9"
-}, Q = ({ onRetry: e }) => W("div", { role: "alert", style: {
+}, Q = ({ onRetry: e }) => A("div", { role: "alert", style: {
   display: "flex",
   flexDirection: "column",
   alignItems: "center",
@@ -168,18 +168,18 @@ const R = {
   padding: "32px 24px",
   textAlign: "center",
   fontFamily: "inherit",
-  color: R.offBlack,
+  color: S.offBlack,
   background: "#FFFFFF",
-  border: `1px solid ${R.grayLight}`,
+  border: `1px solid ${S.grayLight}`,
   borderRadius: "12px"
-}, children: [y("svg", { width: "32", height: "32", viewBox: "0 0 24 24", fill: "none", "aria-hidden": "true", children: y("path", { d: "M12 9v4m0 4h.01M10.29 3.86L1.82 18a2 2 0 001.71 3h16.94a2 2 0 001.71-3L13.71 3.86a2 2 0 00-3.42 0z", stroke: R.evergreen, strokeWidth: "1.5", strokeLinecap: "round", strokeLinejoin: "round" }) }), y("p", { style: { margin: 0, fontSize: "16px", fontWeight: 600 }, children: "Something went wrong" }), y("p", { style: { margin: 0, fontSize: "14px", opacity: 0.75 }, children: "We couldn't load this content. Please check your internet connection and try again." }), y("button", { type: "button", onClick: e, style: {
+}, children: [y("svg", { width: "32", height: "32", viewBox: "0 0 24 24", fill: "none", "aria-hidden": "true", children: y("path", { d: "M12 9v4m0 4h.01M10.29 3.86L1.82 18a2 2 0 001.71 3h16.94a2 2 0 001.71-3L13.71 3.86a2 2 0 00-3.42 0z", stroke: S.evergreen, strokeWidth: "1.5", strokeLinecap: "round", strokeLinejoin: "round" }) }), y("p", { style: { margin: 0, fontSize: "16px", fontWeight: 600 }, children: "Something went wrong" }), y("p", { style: { margin: 0, fontSize: "14px", opacity: 0.75 }, children: "We couldn't load this content. Please check your internet connection and try again." }), y("button", { type: "button", onClick: e, style: {
   marginTop: "8px",
   padding: "8px 20px",
   fontSize: "14px",
   fontWeight: 600,
   fontFamily: "inherit",
-  color: R.green,
-  background: R.evergreen,
+  color: S.green,
+  background: S.evergreen,
   border: "none",
   borderRadius: "8px",
   cursor: "pointer"
@@ -191,74 +191,77 @@ const R = {
         n !== void 0 && (o[r] = n);
   });
 }, Y = (e) => {
-  const { webComponentTag: t, appName: o, appVersion: r, scriptUrls: n, fallbackScriptUrls: l, collectorUrls: c, env: a, jwt: s, timeoutMs: g } = e, [_, f] = z(!1), [d, b] = z(0);
-  U(() => (f(!1), Z({
+  const { webComponentTag: t, appName: o, appVersion: r, scriptUrls: n, fallbackScriptUrls: s, collectorUrls: c, env: a, jwt: l, timeoutMs: m } = e, [_, g] = z(!1), [d, b] = z(0);
+  U(() => (g(!1), Z({
     webComponentTag: t,
     appName: o ?? t,
     appVersion: r,
     scriptUrls: n,
-    fallbackScriptUrls: l,
+    fallbackScriptUrls: s,
     collectorUrls: c ?? $,
     env: a,
-    jwt: s,
-    timeoutMs: g,
-    onError: () => f(!0)
+    jwt: l,
+    timeoutMs: m,
+    onError: () => g(!0)
   })), [
     t,
     o,
     r,
     n,
-    l,
+    s,
     c,
     a,
-    s,
-    g,
+    l,
+    m,
     d
   ]);
-  const v = D(() => b((m) => m + 1), []);
-  return { loadFailed: _, retry: v };
+  const R = D(() => b((f) => f + 1), []);
+  return { loadFailed: _, retry: R };
 }, ee = q("travel-rule-web", "index.js", { eu: !0 }), B = "zerohash-travel-rule", re = ({
   jwt: e,
   depositId: t,
   walletAddress: o,
-  env: r = "prod",
-  theme: n,
-  onCompleted: l,
-  onError: c,
-  onClose: a,
-  onLoaded: s,
-  onEvent: g,
-  ..._
+  intentionAction: r,
+  env: n = "prod",
+  theme: s,
+  onCompleted: c,
+  onError: a,
+  onClose: l,
+  onLoaded: m,
+  onEvent: _,
+  ...g
 }) => {
-  const f = M(null);
-  X(f, {
-    theme: n,
+  const d = M(null);
+  X(d, {
+    theme: s,
     depositId: t,
     walletAddress: o,
-    onCompleted: l,
-    onError: c,
-    onClose: a,
-    onLoaded: s,
-    onEvent: g
+    intentionAction: r,
+    onCompleted: c,
+    onError: a,
+    onClose: l,
+    onLoaded: m,
+    onEvent: _
   });
-  const { loadFailed: d, retry: b } = Y({
+  const { loadFailed: b, retry: R } = Y({
     webComponentTag: B,
     scriptUrls: ee,
-    env: r,
+    env: n,
     jwt: e
   });
-  return d ? /* @__PURE__ */ y(Q, { onRetry: b }) : j.createElement(B, {
-    ref: f,
+  return b ? /* @__PURE__ */ y(Q, { onRetry: R }) : j.createElement(B, {
+    ref: d,
     jwt: e,
-    env: r,
-    theme: n,
-    // camelCase — React 19 sets this as a property via the extra-prop setter
-    // before connectedCallback runs, so the value lands in the URL fragment
-    // reliably (the hyphenated attribute path fails for JSON extra props
-    // because the raw string isn't valid JSON).
+    env: n,
+    theme: s,
+    // camelCase — React 19 sets these as properties via the extra-prop
+    // setters before connectedCallback runs when the element is registered,
+    // and as lowercased HTML attributes when it isn't (the base's
+    // `parseJsonAttr` accepts raw string values on that fallback path).
     depositId: t,
     walletAddress: o,
-    ..._
+    intentionAction: r,
+    ...g
   });
 };
 export {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zerohash-sdk/travel-rule-react",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "private": false,
   "type": "module",
   "main": "./dist/index.js",