@symmio/trading-react 1.1.0 → 3.0.0

package/dist/tpsl/use-quote-group-tpsl.js

@@ -0,0 +1,67 @@
+"use client";
+import { useSymmioChainId as e } from "../provider/use-symmio-chain-id.js";
+import { useSymmioConfig as t } from "../provider/use-symmio-config.js";
+import { normalizeSymmError as n } from "../errors/normalize-symm-error.js";
+import { useTpSlRecords as r, useTpSlStore as i } from "./tpsl-store.js";
+import { dedupeAddresses as a, useWatchTpSlAccounts as o } from "./use-watch-tpsl-accounts.js";
+import { getQuoteTpSlQueryOptions as s, summarizeQuoteGroupTpSl as c, supportsTpSl as l, toGroupTpSlChildren as u, toGroupTpSlOrders as d } from "@symmio/trading-core";
+import { useCallback as f, useMemo as p, useRef as m } from "react";
+import { useQueries as h } from "@tanstack/react-query";
+//#region src/tpsl/use-quote-group-tpsl.ts
+function g(g) {
+	let { quotes: v, overrides: y, live: b = !0, enabled: x = !0 } = g, S = t(g), C = e(), w = g.chainId ?? C, T = l(S, { chainId: w }), E = p(() => v.map(_), [v]), D = h({ queries: v.map((e, t) => {
+		let r = E[t] ?? 0n, a = s(S, {
+			chainId: w,
+			quoteId: r,
+			query: g.query
+		});
+		return {
+			...a,
+			enabled: (a.enabled ?? !0) && x && T,
+			queryFn: async () => {
+				try {
+					let e = await a.queryFn();
+					return i.getState().setRows(r, e), e;
+				} catch (e) {
+					throw n(e);
+				}
+			}
+		};
+	}) });
+	o({
+		accounts: p(() => g.accounts ? a(g.accounts) : a([g.subAccount, ...v.map((e) => e.vaAddress ?? e.partyA)]), [
+			g.accounts,
+			g.subAccount,
+			v
+		]),
+		ids: E,
+		chainId: w,
+		config: g.config,
+		enabled: b && x && T
+	});
+	let O = r(E), k = p(() => {
+		let e = /* @__PURE__ */ new Map();
+		return v.forEach((t, n) => e.set(t.key, O[n])), u(v, (t) => e.get(t.key));
+	}, [v, O]), A = p(() => c(k, { overrides: y }), [k, y]), j = p(() => d(k, { overrides: y }), [k, y]), M = m(D);
+	M.current = D;
+	let N = f(async () => {
+		await Promise.all(M.current.map((e) => e.refetch()));
+	}, []);
+	return {
+		children: k,
+		summary: A,
+		orders: j,
+		isLoading: D.some((e) => e.isLoading),
+		isFetching: D.some((e) => e.isFetching),
+		error: D.find((e) => e.error)?.error ?? null,
+		refetch: N
+	};
+}
+function _(e) {
+	if (e.quoteId !== void 0) return e.quoteId;
+	if (e.tempQuoteId !== void 0) return BigInt(e.tempQuoteId);
+}
+//#endregion
+export { g as useQuoteGroupTpSl };
+
+//# sourceMappingURL=use-quote-group-tpsl.js.map

package/dist/tpsl/use-quote-group-tpsl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-quote-group-tpsl.js","names":[],"sources":["../../src/tpsl/use-quote-group-tpsl.ts"],"sourcesContent":["\"use client\";\n\nimport {\n  getQuoteTpSlQueryOptions,\n  summarizeQuoteGroupTpSl,\n  supportsTpSl,\n  toGroupTpSlChildren,\n  toGroupTpSlOrders,\n  type ConfigParameter,\n  type GetQuoteTpSlOptions,\n  type GroupTpSlChild,\n  type GroupTpSlDesiredMap,\n  type GroupTpSlOrder,\n  type QuoteGroupTpSlSummary,\n  type QuoteTpSl,\n  type UnifiedQuote,\n} from \"@symmio/trading-core\";\nimport { useQueries } from \"@tanstack/react-query\";\nimport { useCallback, useMemo, useRef } from \"react\";\nimport type { Address } from \"viem\";\nimport { normalizeSymmError } from \"../errors/normalize-symm-error\";\nimport type { SymmioRequestError } from \"../errors/symmio-request-error\";\nimport { useSymmioChainId } from \"../provider/use-symmio-chain-id\";\nimport { useSymmioConfig } from \"../provider/use-symmio-config\";\nimport { useTpSlRecords, useTpSlStore } from \"./tpsl-store\";\nimport { dedupeAddresses, useWatchTpSlAccounts } from \"./use-watch-tpsl-accounts\";\n\n/** Parameters for {@link useQuoteGroupTpSl}. */\nexport interface UseQuoteGroupTpSlParameters extends ConfigParameter {\n  /** The grouped position's child quotes — pass `group.quotes`. */\n  quotes: readonly UnifiedQuote[];\n  /**\n   * SubAccount that owns the children's Virtual Accounts.\n   *\n   * Pass it. The handler publishes TP/SL reports on the **subscribing account's**\n   * stream, not on the VA that owns the order — a report's `address` is the same\n   * for two quotes under different VAs. Without it this hook only hears the VA\n   * channels, and a live update arrives whenever the next REST read happens to run.\n   */\n  subAccount?: Address;\n  /**\n   * Accounts whose TP/SL streams report on these children. Overrides the\n   * default, which is `subAccount` plus the deduped `vaAddress ?? partyA`\n   * across `quotes` — a grouped position can span Virtual Accounts, since the\n   * VA is not part of the group key.\n   */\n  accounts?: readonly Address[];\n  /** Pending per-child edits that win over the confirmed snapshot. */\n  overrides?: GroupTpSlDesiredMap;\n  /** Subscribe to the TP/SL WebSocket. Default `true`. */\n  live?: boolean;\n  /** Master switch. When `false` every child query is idle. Default `true`. */\n  enabled?: boolean;\n  /** Chain override; defaults to the connected chain. */\n  chainId?: number;\n  /** Query overrides forwarded to every child fetch. */\n  query?: GetQuoteTpSlOptions[\"query\"];\n}\n\n/** Return type of {@link useQuoteGroupTpSl}. */\nexport interface UseQuoteGroupTpSlReturnType {\n  /** Children with their confirmed snapshots, in input order — the input to every core helper. */\n  children: GroupTpSlChild[];\n  /** Folded cell/modal state: counts, uniform-vs-mixed, notional coverage. */\n  summary: QuoteGroupTpSlSummary;\n  /** One row per live-or-desired TP/SL order, for an overview list. */\n  orders: GroupTpSlOrder[];\n  /** `true` while any child's first fetch is in flight. */\n  isLoading: boolean;\n  /** `true` while any child query is fetching, including background refetches. */\n  isFetching: boolean;\n  /** First normalized error across the fan-out, or `null`. */\n  error: SymmioRequestError | null;\n  /** Refetch every child. Resolves when all settle. */\n  refetch: () => Promise<void>;\n}\n\n/**\n * Read the folded TP/SL state of a grouped position.\n *\n * One TanStack query per child — keyed with the shared `getQuoteTpSlQueryKey`,\n * so a row that also renders the per-quote `useQuoteTpSl` issues **one** request\n * per quote rather than two — all writing into the same module-level TP/SL\n * store, plus one WebSocket subscription per **distinct account** rather than\n * one per child. Everything above the store is `@symmio/trading-core`'s pure\n * `summarizeQuoteGroupTpSl` / `toGroupTpSlOrders`.\n *\n * @param parameters - The group's quotes plus optional accounts, edits and query overrides.\n * @returns Children, the folded summary, the order rows, and the load surface.\n *\n * @example\n * ```tsx\n * const { summary, children } = useQuoteGroupTpSl({ quotes: group.quotes });\n * if (summary.isEmpty) return <span>Not set</span>;\n * if (summary.takeProfit.display === \"uniform\") return <span>{summary.takeProfit.price}</span>;\n * return <span>{summary.takeProfit.count} TP</span>;\n * ```\n */\nexport function useQuoteGroupTpSl(parameters: UseQuoteGroupTpSlParameters): UseQuoteGroupTpSlReturnType {\n  const { quotes, overrides, live = true, enabled = true } = parameters;\n  const config = useSymmioConfig(parameters);\n  const defaultChainId = useSymmioChainId();\n  const chainId = parameters.chainId ?? defaultChainId;\n  // The resolved solver may have no TP/SL handler (e.g. rasa on Base). When it\n  // doesn't, keep every child query idle and skip the subscription so the hook\n  // returns an empty summary instead of throwing `TPSL_NOT_CONFIGURED`.\n  const supported = supportsTpSl(config, { chainId });\n\n  /** One addressable TP/SL id per child: the on-chain id, else the hedger temp id. */\n  const ids = useMemo(() => quotes.map(tpslIdOf), [quotes]);\n\n  const results = useQueries({\n    queries: quotes.map((_quote, index) => {\n      const id = ids[index] ?? 0n;\n      const options = getQuoteTpSlQueryOptions(config, { chainId, quoteId: id, query: parameters.query });\n      return {\n        ...options,\n        enabled: (options.enabled ?? true) && enabled && supported,\n        queryFn: async () => {\n          try {\n            const rows = await options.queryFn();\n            useTpSlStore.getState().setRows(id, rows);\n            return rows;\n          } catch (err) {\n            throw normalizeSymmError(err);\n          }\n        },\n      };\n    }),\n  });\n\n  /**\n   * Accounts to watch: the SubAccount, where the handler publishes its reports,\n   * plus every Virtual Account the children live under — a grouped position can\n   * span several, and one of them may be where a given deployment reports.\n   */\n  const accounts = useMemo(() => {\n    if (parameters.accounts) return dedupeAddresses(parameters.accounts);\n    return dedupeAddresses([parameters.subAccount, ...quotes.map((quote) => quote.vaAddress ?? quote.partyA)]);\n  }, [parameters.accounts, parameters.subAccount, quotes]);\n\n  useWatchTpSlAccounts({\n    accounts,\n    ids,\n    chainId,\n    config: parameters.config,\n    enabled: live && enabled && supported,\n  });\n\n  const records = useTpSlRecords(ids);\n  const children = useMemo(() => {\n    const byKey = new Map<string, QuoteTpSl | undefined>();\n    quotes.forEach((quote, index) => byKey.set(quote.key, records[index]));\n    return toGroupTpSlChildren(quotes, (quote) => byKey.get(quote.key));\n  }, [quotes, records]);\n\n  const summary = useMemo(() => summarizeQuoteGroupTpSl(children, { overrides }), [children, overrides]);\n  const orders = useMemo(() => toGroupTpSlOrders(children, { overrides }), [children, overrides]);\n\n  /** `useQueries` hands back a fresh array each render; keep `refetch` stable. */\n  const resultsRef = useRef(results);\n  resultsRef.current = results;\n  const refetch = useCallback(async () => {\n    await Promise.all(resultsRef.current.map((result) => result.refetch()));\n  }, []);\n\n  return {\n    children,\n    summary,\n    orders,\n    isLoading: results.some((result) => result.isLoading),\n    isFetching: results.some((result) => result.isFetching),\n    error: (results.find((result) => result.error)?.error as SymmioRequestError | undefined) ?? null,\n    refetch,\n  };\n}\n\n/** The id a quote's TP/SL record is addressed by: on-chain first, else the hedger temp id. */\nfunction tpslIdOf(quote: UnifiedQuote): bigint | undefined {\n  if (quote.quoteId !== undefined) return quote.quoteId;\n  if (quote.tempQuoteId !== undefined) return BigInt(quote.tempQuoteId);\n  return undefined;\n}\n"],"mappings":";;;;;;;;;;AAkGA,SAAgB,EAAkB,GAAsE;CACtG,IAAM,EAAE,WAAQ,cAAW,UAAO,IAAM,aAAU,OAAS,GACrD,IAAS,EAAgB,CAAU,GACnC,IAAiB,EAAiB,GAClC,IAAU,EAAW,WAAW,GAIhC,IAAY,EAAa,GAAQ,EAAE,WAAQ,CAAC,GAG5C,IAAM,QAAc,EAAO,IAAI,CAAQ,GAAG,CAAC,CAAM,CAAC,GAElD,IAAU,EAAW,EACzB,SAAS,EAAO,KAAK,GAAQ,MAAU;EACrC,IAAM,IAAK,EAAI,MAAU,IACnB,IAAU,EAAyB,GAAQ;GAAE;GAAS,SAAS;GAAI,OAAO,EAAW;EAAM,CAAC;EAClG,OAAO;GACL,GAAG;GACH,UAAU,EAAQ,WAAW,OAAS,KAAW;GACjD,SAAS,YAAY;IACnB,IAAI;KACF,IAAM,IAAO,MAAM,EAAQ,QAAQ;KAEnC,OADA,EAAa,SAAS,EAAE,QAAQ,GAAI,CAAI,GACjC;IACT,SAAS,GAAK;KACZ,MAAM,EAAmB,CAAG;IAC9B;GACF;EACF;CACF,CAAC,EACH,CAAC;CAYD,EAAqB;EACnB,UANe,QACX,EAAW,WAAiB,EAAgB,EAAW,QAAQ,IAC5D,EAAgB,CAAC,EAAW,YAAY,GAAG,EAAO,KAAK,MAAU,EAAM,aAAa,EAAM,MAAM,CAAC,CAAC,GACxG;GAAC,EAAW;GAAU,EAAW;GAAY;EAAM,CAGpD;EACA;EACA;EACA,QAAQ,EAAW;EACnB,SAAS,KAAQ,KAAW;CAC9B,CAAC;CAED,IAAM,IAAU,EAAe,CAAG,GAC5B,IAAW,QAAc;EAC7B,IAAM,oBAAQ,IAAI,IAAmC;EAErD,OADA,EAAO,SAAS,GAAO,MAAU,EAAM,IAAI,EAAM,KAAK,EAAQ,EAAM,CAAC,GAC9D,EAAoB,IAAS,MAAU,EAAM,IAAI,EAAM,GAAG,CAAC;CACpE,GAAG,CAAC,GAAQ,CAAO,CAAC,GAEd,IAAU,QAAc,EAAwB,GAAU,EAAE,aAAU,CAAC,GAAG,CAAC,GAAU,CAAS,CAAC,GAC/F,IAAS,QAAc,EAAkB,GAAU,EAAE,aAAU,CAAC,GAAG,CAAC,GAAU,CAAS,CAAC,GAGxF,IAAa,EAAO,CAAO;CACjC,EAAW,UAAU;CACrB,IAAM,IAAU,EAAY,YAAY;EACtC,MAAM,QAAQ,IAAI,EAAW,QAAQ,KAAK,MAAW,EAAO,QAAQ,CAAC,CAAC;CACxE,GAAG,CAAC,CAAC;CAEL,OAAO;EACL;EACA;EACA;EACA,WAAW,EAAQ,MAAM,MAAW,EAAO,SAAS;EACpD,YAAY,EAAQ,MAAM,MAAW,EAAO,UAAU;EACtD,OAAQ,EAAQ,MAAM,MAAW,EAAO,KAAK,GAAG,SAA4C;EAC5F;CACF;AACF;AAGA,SAAS,EAAS,GAAyC;CACzD,IAAI,EAAM,YAAY,KAAA,GAAW,OAAO,EAAM;CAC9C,IAAI,EAAM,gBAAgB,KAAA,GAAW,OAAO,OAAO,EAAM,WAAW;AAEtE"}

package/dist/tpsl/use-quote-tpsl.d.ts

@@ -1,4 +1,4 @@
-import { ConfigParameter, GetQuoteTpSlOptions } from '@symmio/trading-core';
+import { ConfigParameter, GetQuoteTpSlOptions, QuoteTpSlRow } from '@symmio/trading-core';
 import { UseQueryResult } from '@tanstack/react-query';
 import { Address } from 'viem';
 import { SymmioRequestError } from '../errors/symmio-request-error.js';
@@ -18,7 +18,20 @@ export type UseQuoteTpSlParameters = Omit<GetQuoteTpSlOptions, "quoteId"> & Conf
     account?: Address;
 };
 /** Return type of {@link useQuoteTpSl}. */
-export type UseQuoteTpSlReturnType = UseQueryResult<TpSlRecord, SymmioRequestError>;
+export interface UseQuoteTpSlReturnType {
+    /** The folded TP/SL snapshot from the shared store, or `undefined` before the first load. */
+    data?: TpSlRecord;
+    /** `true` while the first fetch for this quote is in flight. */
+    isLoading: boolean;
+    /** `true` while any fetch is in flight, including background refetches. */
+    isFetching: boolean;
+    /** Normalized fetch error, or `null`. */
+    error: SymmioRequestError | null;
+    /** Re-read the handler rows for this quote. */
+    refetch: () => Promise<void>;
+    /** The underlying handler-row query, for advanced use. */
+    query: UseQueryResult<QuoteTpSlRow[], SymmioRequestError>;
+}
 /**
  * Read the folded TP/SL snapshot for one quote. Pass either the on-chain
  * `quoteId` or the hedger `tempQuoteId` — the store keeps a single record per
@@ -28,6 +41,9 @@ export type UseQuoteTpSlReturnType = UseQueryResult<TpSlRecord, SymmioRequestErr
  * The `confirming` overlay ("POST accepted, awaiting handler") is merged into
  * `tpState` / `slState` at read time — a side flagged as confirming reports
  * state `"confirming"` regardless of what the row set says.
+ *
+ * @param parameters - Quote id, optional sub-account for the live stream, query overrides.
+ * @returns The snapshot plus the usual load/error/refetch surface.
  */
 export declare function useQuoteTpSl(parameters: UseQuoteTpSlParameters): UseQuoteTpSlReturnType;
 //# sourceMappingURL=use-quote-tpsl.d.ts.map

package/dist/tpsl/use-quote-tpsl.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-quote-tpsl.d.ts","sourceRoot":"","sources":["../../src/tpsl/use-quote-tpsl.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,mBAAmB,EAEzB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAY,KAAK,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACtE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAEpC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAGzE,OAAO,EAA+B,KAAK,UAAU,EAAE,MAAM,cAAc,CAAC;AAG5E,2CAA2C;AAC3C,MAAM,MAAM,sBAAsB,GAAG,IAAI,CAAC,mBAAmB,EAAE,SAAS,CAAC,GACvE,eAAe,GAAG;IAChB;;;;OAIG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAEJ,2CAA2C;AAC3C,MAAM,MAAM,sBAAsB,GAAG,cAAc,CAAC,UAAU,EAAE,kBAAkB,CAAC,CAAC;AAEpF;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,UAAU,EAAE,sBAAsB,GAAG,sBAAsB,CA8CvF"}
+{"version":3,"file":"use-quote-tpsl.d.ts","sourceRoot":"","sources":["../../src/tpsl/use-quote-tpsl.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACxB,KAAK,YAAY,EAClB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAY,KAAK,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEtE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAEpC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAIzE,OAAO,EAA+B,KAAK,UAAU,EAAE,MAAM,cAAc,CAAC;AAG5E,2CAA2C;AAC3C,MAAM,MAAM,sBAAsB,GAAG,IAAI,CAAC,mBAAmB,EAAE,SAAS,CAAC,GACvE,eAAe,GAAG;IAChB;;;;OAIG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAEJ,2CAA2C;AAC3C,MAAM,WAAW,sBAAsB;IACrC,6FAA6F;IAC7F,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,gEAAgE;IAChE,SAAS,EAAE,OAAO,CAAC;IACnB,2EAA2E;IAC3E,UAAU,EAAE,OAAO,CAAC;IACpB,yCAAyC;IACzC,KAAK,EAAE,kBAAkB,GAAG,IAAI,CAAC;IACjC,+CAA+C;IAC/C,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,0DAA0D;IAC1D,KAAK,EAAE,cAAc,CAAC,YAAY,EAAE,EAAE,kBAAkB,CAAC,CAAC;CAC3D;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAAC,UAAU,EAAE,sBAAsB,GAAG,sBAAsB,CA+DvF"}

package/dist/tpsl/use-quote-tpsl.js

@@ -3,42 +3,50 @@ import { useSymmioChainId as e } from "../provider/use-symmio-chain-id.js";
 import { useSymmioConfig as t } from "../provider/use-symmio-config.js";
 import { normalizeSymmError as n } from "../errors/normalize-symm-error.js";
 import { useTpSlRecord as r, useTpSlStore as i } from "./tpsl-store.js";
-import { useWatchTpSlNotifications as a } from "./use-watch-tpsl-notifications.js";
-import { getQuoteTpSlQueryOptions as o } from "@symmio/trading-core";
-import { useQuery as s } from "@tanstack/react-query";
+import { linkTpSlNotificationIds as a, matchTpSlNotification as o } from "./match-tpsl-notification.js";
+import { useWatchTpSlNotifications as s } from "./use-watch-tpsl-notifications.js";
+import { getQuoteTpSlQueryOptions as c } from "@symmio/trading-core";
+import { useCallback as l } from "react";
+import { useQuery as u } from "@tanstack/react-query";
 //#region src/tpsl/use-quote-tpsl.ts
-function c(c) {
-	let u = t(c), d = e(), f = c.chainId ?? d, p = r(c.quoteId), m = o(u, {
-		...c,
-		chainId: f,
-		quoteId: c.quoteId
-	}), h = s({
-		...m,
+function d(d) {
+	let f = t(d), p = e(), m = d.chainId ?? p, h = r(d.quoteId), g = c(f, {
+		chainId: m,
+		quoteId: d.quoteId,
+		query: d.query
+	}), _ = u({
+		...g,
 		queryFn: async () => {
 			try {
-				let e = await m.queryFn();
-				return i.getState().setRows(c.quoteId, e), e;
+				let e = await g.queryFn();
+				return i.getState().setRows(d.quoteId, e), e;
 			} catch (e) {
 				throw n(e);
 			}
 		}
 	});
-	return a({
-		account: c.account,
-		enabled: !!c.account && c.quoteId !== 0n,
+	s({
+		account: d.account,
+		enabled: !!d.account && d.quoteId !== 0n,
 		onNotification: (e) => {
-			e.primaryIdentifier !== 0 && e.secondaryIdentifier !== 0 && i.getState().link(BigInt(e.primaryIdentifier), BigInt(e.secondaryIdentifier)), l(e, c.quoteId) && i.getState().applyNotification(c.quoteId, e);
+			a(e);
+			let t = o(e, [d.quoteId]);
+			t !== void 0 && i.getState().applyNotification(t, e);
 		}
-	}), {
-		query: h,
-		data: p
+	});
+	let v = l(async () => {
+		await _.refetch();
+	}, [_]);
+	return {
+		data: h,
+		isLoading: _.isLoading,
+		isFetching: _.isFetching,
+		error: _.error ?? null,
+		refetch: v,
+		query: _
 	};
 }
-function l(e, t) {
-	let n = i.getState(), r = n.get(t);
-	return r ? e.primaryIdentifier !== 0 && n.get(BigInt(e.primaryIdentifier)) === r || e.secondaryIdentifier !== 0 && n.get(BigInt(e.secondaryIdentifier)) === r : e.primaryIdentifier === Number(t) || e.secondaryIdentifier === Number(t) || e.quoteId === Number(t);
-}
 //#endregion
-export { c as useQuoteTpSl };
+export { d as useQuoteTpSl };
 
 //# sourceMappingURL=use-quote-tpsl.js.map

package/dist/tpsl/use-quote-tpsl.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-quote-tpsl.js","names":[],"sources":["../../src/tpsl/use-quote-tpsl.ts"],"sourcesContent":["\"use client\";\n\nimport {\n  getQuoteTpSlQueryOptions,\n  type ConfigParameter,\n  type GetQuoteTpSlOptions,\n  type TpSlNotification,\n} from \"@symmio/trading-core\";\nimport { useQuery, type UseQueryResult } from \"@tanstack/react-query\";\nimport type { Address } from \"viem\";\nimport { normalizeSymmError } from \"../errors/normalize-symm-error\";\nimport type { SymmioRequestError } from \"../errors/symmio-request-error\";\nimport { useSymmioChainId } from \"../provider/use-symmio-chain-id\";\nimport { useSymmioConfig } from \"../provider/use-symmio-config\";\nimport { useTpSlRecord, useTpSlStore, type TpSlRecord } from \"./tpsl-store\";\nimport { useWatchTpSlNotifications } from \"./use-watch-tpsl-notifications\";\n\n/** Parameters for {@link useQuoteTpSl}. */\nexport type UseQuoteTpSlParameters = Omit<GetQuoteTpSlOptions, \"quoteId\"> &\n  ConfigParameter & {\n    /**\n     * Quote id — accepts either the on-chain `quoteId` or the hedger\n     * `tempQuoteId`. Whichever is passed, the hook resolves to the same\n     * shared record via the store's id index.\n     */\n    quoteId: bigint;\n    /**\n     * SubAccount address — when provided, the hook also subscribes to the\n     * TP/SL WebSocket and reconciles the record without manual polling.\n     */\n    account?: Address;\n  };\n\n/** Return type of {@link useQuoteTpSl}. */\nexport type UseQuoteTpSlReturnType = UseQueryResult<TpSlRecord, SymmioRequestError>;\n\n/**\n * Read the folded TP/SL snapshot for one quote. Pass either the on-chain\n * `quoteId` or the hedger `tempQuoteId` — the store keeps a single record per\n * quote indexed under every id it has learned for that quote, so both callers\n * get the same object.\n *\n * The `confirming` overlay (\"POST accepted, awaiting handler\") is merged into\n * `tpState` / `slState` at read time — a side flagged as confirming reports\n * state `\"confirming\"` regardless of what the row set says.\n */\nexport function useQuoteTpSl(parameters: UseQuoteTpSlParameters): UseQuoteTpSlReturnType {\n  const config = useSymmioConfig(parameters);\n  const defaultChainId = useSymmioChainId();\n  const chainId = parameters.chainId ?? defaultChainId;\n\n  const record = useTpSlRecord(parameters.quoteId);\n  const options = getQuoteTpSlQueryOptions(config, {\n    ...parameters,\n    chainId,\n    quoteId: parameters.quoteId,\n  });\n  // Re-fetch is driven by TanStack Query cache: mutations invalidate `rowsKey`,\n  // which triggers a refetch here so the store record picks up the newly\n  // committed tp/sl values. (An earlier version gated on `record === undefined`\n  // to avoid a duplicate fetch when the on-chain quoteId first appeared, but\n  // that also swallowed post-mutation invalidations — leaving the box stuck on\n  // the old values.)\n  const queryResult = useQuery({\n    ...options,\n    queryFn: async () => {\n      try {\n        const rows = await options.queryFn();\n        useTpSlStore.getState().setRows(parameters.quoteId, rows);\n        return rows;\n      } catch (err) {\n        throw normalizeSymmError(err);\n      }\n    },\n  });\n\n  useWatchTpSlNotifications({\n    account: parameters.account,\n    enabled: Boolean(parameters.account) && parameters.quoteId !== 0n,\n    onNotification: (notification) => {\n      if (notification.primaryIdentifier !== 0 && notification.secondaryIdentifier !== 0) {\n        useTpSlStore.getState().link(BigInt(notification.primaryIdentifier), BigInt(notification.secondaryIdentifier));\n      }\n      if (!matchesQuote(notification, parameters.quoteId)) return;\n      useTpSlStore.getState().applyNotification(parameters.quoteId, notification);\n    },\n  });\n\n  return {\n    query: queryResult,\n    data: record,\n  } as unknown as UseQuoteTpSlReturnType;\n}\n\n/**\n * True when the notification and the caller address the same store record.\n * Uses the store's id index — every id linked to the same record maps to\n * the same object, so reference equality decides the match.\n */\nfunction matchesQuote(notification: TpSlNotification, quoteId: bigint): boolean {\n  const store = useTpSlStore.getState();\n  const target = store.get(quoteId);\n  if (!target) {\n    // No record yet for the target — fall back to raw-id compare so the\n    // first \"seed\" frame still matches.\n    return (\n      notification.primaryIdentifier === Number(quoteId) ||\n      notification.secondaryIdentifier === Number(quoteId) ||\n      notification.quoteId === Number(quoteId)\n    );\n  }\n  if (notification.primaryIdentifier !== 0 && store.get(BigInt(notification.primaryIdentifier)) === target) return true;\n  if (notification.secondaryIdentifier !== 0 && store.get(BigInt(notification.secondaryIdentifier)) === target)\n    return true;\n  return false;\n}\n"],"mappings":";;;;;;;;;AA8CA,SAAgB,EAAa,GAA4D;CACvF,IAAM,IAAS,EAAgB,CAAU,GACnC,IAAiB,EAAiB,GAClC,IAAU,EAAW,WAAW,GAEhC,IAAS,EAAc,EAAW,OAAO,GACzC,IAAU,EAAyB,GAAQ;EAC/C,GAAG;EACH;EACA,SAAS,EAAW;CACtB,CAAC,GAOK,IAAc,EAAS;EAC3B,GAAG;EACH,SAAS,YAAY;GACnB,IAAI;IACF,IAAM,IAAO,MAAM,EAAQ,QAAQ;IAEnC,OADA,EAAa,SAAS,EAAE,QAAQ,EAAW,SAAS,CAAI,GACjD;GACT,SAAS,GAAK;IACZ,MAAM,EAAmB,CAAG;GAC9B;EACF;CACF,CAAC;CAcD,OAZA,EAA0B;EACxB,SAAS,EAAW;EACpB,SAAS,EAAQ,EAAW,WAAY,EAAW,YAAY;EAC/D,iBAAiB,MAAiB;GAChC,AAAI,EAAa,sBAAsB,KAAK,EAAa,wBAAwB,KAC/E,EAAa,SAAS,EAAE,KAAK,OAAO,EAAa,iBAAiB,GAAG,OAAO,EAAa,mBAAmB,CAAC,GAE1G,EAAa,GAAc,EAAW,OAAO,KAClD,EAAa,SAAS,EAAE,kBAAkB,EAAW,SAAS,CAAY;EAC5E;CACF,CAAC,GAEM;EACL,OAAO;EACP,MAAM;CACR;AACF;AAOA,SAAS,EAAa,GAAgC,GAA0B;CAC9E,IAAM,IAAQ,EAAa,SAAS,GAC9B,IAAS,EAAM,IAAI,CAAO;CAahC,OAZK,IASD,EAAa,sBAAsB,KAAK,EAAM,IAAI,OAAO,EAAa,iBAAiB,CAAC,MAAM,KAC9F,EAAa,wBAAwB,KAAK,EAAM,IAAI,OAAO,EAAa,mBAAmB,CAAC,MAAM,IANlG,EAAa,sBAAsB,OAAO,CAAO,KACjD,EAAa,wBAAwB,OAAO,CAAO,KACnD,EAAa,YAAY,OAAO,CAAO;AAO7C"}
+{"version":3,"file":"use-quote-tpsl.js","names":[],"sources":["../../src/tpsl/use-quote-tpsl.ts"],"sourcesContent":["\"use client\";\n\nimport {\n  getQuoteTpSlQueryOptions,\n  type ConfigParameter,\n  type GetQuoteTpSlOptions,\n  type QuoteTpSlRow,\n} from \"@symmio/trading-core\";\nimport { useQuery, type UseQueryResult } from \"@tanstack/react-query\";\nimport { useCallback } from \"react\";\nimport type { Address } from \"viem\";\nimport { normalizeSymmError } from \"../errors/normalize-symm-error\";\nimport type { SymmioRequestError } from \"../errors/symmio-request-error\";\nimport { useSymmioChainId } from \"../provider/use-symmio-chain-id\";\nimport { useSymmioConfig } from \"../provider/use-symmio-config\";\nimport { linkTpSlNotificationIds, matchTpSlNotification } from \"./match-tpsl-notification\";\nimport { useTpSlRecord, useTpSlStore, type TpSlRecord } from \"./tpsl-store\";\nimport { useWatchTpSlNotifications } from \"./use-watch-tpsl-notifications\";\n\n/** Parameters for {@link useQuoteTpSl}. */\nexport type UseQuoteTpSlParameters = Omit<GetQuoteTpSlOptions, \"quoteId\"> &\n  ConfigParameter & {\n    /**\n     * Quote id — accepts either the on-chain `quoteId` or the hedger\n     * `tempQuoteId`. Whichever is passed, the hook resolves to the same\n     * shared record via the store's id index.\n     */\n    quoteId: bigint;\n    /**\n     * SubAccount address — when provided, the hook also subscribes to the\n     * TP/SL WebSocket and reconciles the record without manual polling.\n     */\n    account?: Address;\n  };\n\n/** Return type of {@link useQuoteTpSl}. */\nexport interface UseQuoteTpSlReturnType {\n  /** The folded TP/SL snapshot from the shared store, or `undefined` before the first load. */\n  data?: TpSlRecord;\n  /** `true` while the first fetch for this quote is in flight. */\n  isLoading: boolean;\n  /** `true` while any fetch is in flight, including background refetches. */\n  isFetching: boolean;\n  /** Normalized fetch error, or `null`. */\n  error: SymmioRequestError | null;\n  /** Re-read the handler rows for this quote. */\n  refetch: () => Promise<void>;\n  /** The underlying handler-row query, for advanced use. */\n  query: UseQueryResult<QuoteTpSlRow[], SymmioRequestError>;\n}\n\n/**\n * Read the folded TP/SL snapshot for one quote. Pass either the on-chain\n * `quoteId` or the hedger `tempQuoteId` — the store keeps a single record per\n * quote indexed under every id it has learned for that quote, so both callers\n * get the same object.\n *\n * The `confirming` overlay (\"POST accepted, awaiting handler\") is merged into\n * `tpState` / `slState` at read time — a side flagged as confirming reports\n * state `\"confirming\"` regardless of what the row set says.\n *\n * @param parameters - Quote id, optional sub-account for the live stream, query overrides.\n * @returns The snapshot plus the usual load/error/refetch surface.\n */\nexport function useQuoteTpSl(parameters: UseQuoteTpSlParameters): UseQuoteTpSlReturnType {\n  const config = useSymmioConfig(parameters);\n  const defaultChainId = useSymmioChainId();\n  const chainId = parameters.chainId ?? defaultChainId;\n\n  const record = useTpSlRecord(parameters.quoteId);\n  /**\n   * Only the fields the read itself takes are forwarded — never the whole\n   * `parameters`. `account` selects which WebSocket to subscribe to and has no\n   * bearing on `GET /api/v5/?quote_id=…`, but the key factory hashes every\n   * field it is handed, so spreading it fragmented the cache: the same quote\n   * read from a flow (`account: subAccount`), from a row cell\n   * (`account: vaAddress`) and from `useQuoteGroupTpSl` (no account) landed in\n   * three separate entries, and one invalidation fired three identical\n   * requests.\n   */\n  const options = getQuoteTpSlQueryOptions(config, {\n    chainId,\n    quoteId: parameters.quoteId,\n    query: parameters.query,\n  });\n  // Re-fetch is driven by TanStack Query cache: mutations invalidate `rowsKey`,\n  // which triggers a refetch here so the store record picks up the newly\n  // committed tp/sl values. (An earlier version gated on `record === undefined`\n  // to avoid a duplicate fetch when the on-chain quoteId first appeared, but\n  // that also swallowed post-mutation invalidations — leaving the box stuck on\n  // the old values.)\n  const query = useQuery({\n    ...options,\n    queryFn: async () => {\n      try {\n        const rows = await options.queryFn();\n        useTpSlStore.getState().setRows(parameters.quoteId, rows);\n        return rows;\n      } catch (err) {\n        throw normalizeSymmError(err);\n      }\n    },\n  }) as UseQueryResult<QuoteTpSlRow[], SymmioRequestError>;\n\n  useWatchTpSlNotifications({\n    account: parameters.account,\n    enabled: Boolean(parameters.account) && parameters.quoteId !== 0n,\n    onNotification: (notification) => {\n      linkTpSlNotificationIds(notification);\n      const target = matchTpSlNotification(notification, [parameters.quoteId]);\n      if (target === undefined) return;\n      useTpSlStore.getState().applyNotification(target, notification);\n    },\n  });\n\n  const refetch = useCallback(async () => {\n    await query.refetch();\n  }, [query]);\n\n  return {\n    data: record,\n    isLoading: query.isLoading,\n    isFetching: query.isFetching,\n    error: query.error ?? null,\n    refetch,\n    query,\n  };\n}\n"],"mappings":";;;;;;;;;;;AAgEA,SAAgB,EAAa,GAA4D;CACvF,IAAM,IAAS,EAAgB,CAAU,GACnC,IAAiB,EAAiB,GAClC,IAAU,EAAW,WAAW,GAEhC,IAAS,EAAc,EAAW,OAAO,GAWzC,IAAU,EAAyB,GAAQ;EAC/C;EACA,SAAS,EAAW;EACpB,OAAO,EAAW;CACpB,CAAC,GAOK,IAAQ,EAAS;EACrB,GAAG;EACH,SAAS,YAAY;GACnB,IAAI;IACF,IAAM,IAAO,MAAM,EAAQ,QAAQ;IAEnC,OADA,EAAa,SAAS,EAAE,QAAQ,EAAW,SAAS,CAAI,GACjD;GACT,SAAS,GAAK;IACZ,MAAM,EAAmB,CAAG;GAC9B;EACF;CACF,CAAC;CAED,EAA0B;EACxB,SAAS,EAAW;EACpB,SAAS,EAAQ,EAAW,WAAY,EAAW,YAAY;EAC/D,iBAAiB,MAAiB;GAChC,EAAwB,CAAY;GACpC,IAAM,IAAS,EAAsB,GAAc,CAAC,EAAW,OAAO,CAAC;GACnE,MAAW,KAAA,KACf,EAAa,SAAS,EAAE,kBAAkB,GAAQ,CAAY;EAChE;CACF,CAAC;CAED,IAAM,IAAU,EAAY,YAAY;EACtC,MAAM,EAAM,QAAQ;CACtB,GAAG,CAAC,CAAK,CAAC;CAEV,OAAO;EACL,MAAM;EACN,WAAW,EAAM;EACjB,YAAY,EAAM;EAClB,OAAO,EAAM,SAAS;EACtB;EACA;CACF;AACF"}

package/dist/tpsl/use-search-tpsl-orders.d.ts

@@ -0,0 +1,30 @@
+import { ConfigParameter, SearchTpSlOrdersOptions, SearchTpSlOrdersReturnType } from '@symmio/trading-core';
+import { UseQueryResult } from '@tanstack/react-query';
+import { SymmioRequestError } from '../errors/symmio-request-error.js';
+/** Parameters for {@link useSearchTpSlOrders}: the core query options plus an optional `config`. */
+export type UseSearchTpSlOrdersParameters = SearchTpSlOrdersOptions & ConfigParameter;
+/** Return type of {@link useSearchTpSlOrders}: one page of conditional-order rows. */
+export type UseSearchTpSlOrdersReturnType = UseQueryResult<SearchTpSlOrdersReturnType, SymmioRequestError>;
+/**
+ * Search conditional orders at the chain's TP/SL handler.
+ *
+ * Every filter is optional, including `account`. Pass one to read a single
+ * account's TP/SL legs; **omit it** to read across accounts — which is how a
+ * pool's order book is read: filter by `symbolId` and
+ * `conditionalOrderType: "send_quote"` and you get every trader's pending
+ * trigger-to-open orders on that market.
+ *
+ * `isComplete` is the field to trust when deciding whether an absent order is
+ * really gone; `count` is advisory. Errors are normalized to
+ * {@link SymmioRequestError}.
+ *
+ * @example
+ * ```tsx
+ * const { data } = useSearchTpSlOrders({
+ *   symbolId,
+ *   conditionalOrderType: ConditionalOrderType.send_quote,
+ * });
+ * ```
+ */
+export declare function useSearchTpSlOrders(parameters?: UseSearchTpSlOrdersParameters): UseSearchTpSlOrdersReturnType;
+//# sourceMappingURL=use-search-tpsl-orders.d.ts.map

package/dist/tpsl/use-search-tpsl-orders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-search-tpsl-orders.d.ts","sourceRoot":"","sources":["../../src/tpsl/use-search-tpsl-orders.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,uBAAuB,EAC5B,KAAK,0BAA0B,EAChC,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAY,KAAK,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEtE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAIzE,oGAAoG;AACpG,MAAM,MAAM,6BAA6B,GAAG,uBAAuB,GAAG,eAAe,CAAC;AAEtF,sFAAsF;AACtF,MAAM,MAAM,6BAA6B,GAAG,cAAc,CAAC,0BAA0B,EAAE,kBAAkB,CAAC,CAAC;AAE3G;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,GAAE,6BAAkC,GAAG,6BAA6B,CAkBjH"}

package/dist/tpsl/use-search-tpsl-orders.js

@@ -0,0 +1,27 @@
+"use client";
+import { useSymmioChainId as e } from "../provider/use-symmio-chain-id.js";
+import { useSymmioConfig as t } from "../provider/use-symmio-config.js";
+import { normalizeSymmError as n } from "../errors/normalize-symm-error.js";
+import { searchTpSlOrdersQueryOptions as r } from "@symmio/trading-core";
+import { useQuery as i } from "@tanstack/react-query";
+//#region src/tpsl/use-search-tpsl-orders.ts
+function a(a = {}) {
+	let o = t(a), s = e(), c = r(o, {
+		...a,
+		chainId: a.chainId ?? s
+	});
+	return i({
+		...c,
+		queryFn: async () => {
+			try {
+				return await c.queryFn();
+			} catch (e) {
+				throw n(e);
+			}
+		}
+	});
+}
+//#endregion
+export { a as useSearchTpSlOrders };
+
+//# sourceMappingURL=use-search-tpsl-orders.js.map

package/dist/tpsl/use-search-tpsl-orders.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-search-tpsl-orders.js","names":[],"sources":["../../src/tpsl/use-search-tpsl-orders.ts"],"sourcesContent":["\"use client\";\n\nimport {\n  searchTpSlOrdersQueryOptions,\n  type ConfigParameter,\n  type SearchTpSlOrdersOptions,\n  type SearchTpSlOrdersReturnType,\n} from \"@symmio/trading-core\";\nimport { useQuery, type UseQueryResult } from \"@tanstack/react-query\";\nimport { normalizeSymmError } from \"../errors/normalize-symm-error\";\nimport type { SymmioRequestError } from \"../errors/symmio-request-error\";\nimport { useSymmioChainId } from \"../provider/use-symmio-chain-id\";\nimport { useSymmioConfig } from \"../provider/use-symmio-config\";\n\n/** Parameters for {@link useSearchTpSlOrders}: the core query options plus an optional `config`. */\nexport type UseSearchTpSlOrdersParameters = SearchTpSlOrdersOptions & ConfigParameter;\n\n/** Return type of {@link useSearchTpSlOrders}: one page of conditional-order rows. */\nexport type UseSearchTpSlOrdersReturnType = UseQueryResult<SearchTpSlOrdersReturnType, SymmioRequestError>;\n\n/**\n * Search conditional orders at the chain's TP/SL handler.\n *\n * Every filter is optional, including `account`. Pass one to read a single\n * account's TP/SL legs; **omit it** to read across accounts — which is how a\n * pool's order book is read: filter by `symbolId` and\n * `conditionalOrderType: \"send_quote\"` and you get every trader's pending\n * trigger-to-open orders on that market.\n *\n * `isComplete` is the field to trust when deciding whether an absent order is\n * really gone; `count` is advisory. Errors are normalized to\n * {@link SymmioRequestError}.\n *\n * @example\n * ```tsx\n * const { data } = useSearchTpSlOrders({\n *   symbolId,\n *   conditionalOrderType: ConditionalOrderType.send_quote,\n * });\n * ```\n */\nexport function useSearchTpSlOrders(parameters: UseSearchTpSlOrdersParameters = {}): UseSearchTpSlOrdersReturnType {\n  const config = useSymmioConfig(parameters);\n  const chainId = useSymmioChainId();\n  const options = searchTpSlOrdersQueryOptions(config, {\n    ...parameters,\n    chainId: parameters.chainId ?? chainId,\n  });\n\n  return useQuery({\n    ...options,\n    queryFn: async () => {\n      try {\n        return await options.queryFn();\n      } catch (err) {\n        throw normalizeSymmError(err);\n      }\n    },\n  }) as UseSearchTpSlOrdersReturnType;\n}\n"],"mappings":";;;;;;;AAyCA,SAAgB,EAAoB,IAA4C,CAAC,GAAkC;CACjH,IAAM,IAAS,EAAgB,CAAU,GACnC,IAAU,EAAiB,GAC3B,IAAU,EAA6B,GAAQ;EACnD,GAAG;EACH,SAAS,EAAW,WAAW;CACjC,CAAC;CAED,OAAO,EAAS;EACd,GAAG;EACH,SAAS,YAAY;GACnB,IAAI;IACF,OAAO,MAAM,EAAQ,QAAQ;GAC/B,SAAS,GAAK;IACZ,MAAM,EAAmB,CAAG;GAC9B;EACF;CACF,CAAC;AACH"}

package/dist/tpsl/use-set-quote-group-tpsl.d.ts

@@ -0,0 +1,234 @@
+import { ConfigParameter, GroupTpSlChild, GroupTpSlDesiredMap, GroupTpSlSkipReason, PlanGroupTpSlResult, TpSlConditionalOrderType, TpSlConfig, TpSlValidation } from '@symmio/trading-core';
+import { Address } from 'viem';
+import { SymmioRequestError } from '../errors/symmio-request-error.js';
+/**
+ * Lifecycle of one step inside a grouped TP/SL run:
+ * `queued` → `submitting` (request in flight) → `confirming` (handler returned
+ * 200) → `done` (the WebSocket reported the order live, or gone for a cancel),
+ * or `failed`, or `skipped` (the plan decided the leg needs no write).
+ */
+export type SetQuoteGroupTpSlStepStatus = "queued" | "submitting" | "confirming" | "done" | "failed" | "skipped";
+/** What a step does. A leg can produce a `cancel` **and** a `write` in one run. */
+export type SetQuoteGroupTpSlStepKind = "write" | "cancel" | "skip";
+/** Live state of one step. */
+export interface SetQuoteGroupTpSlStep {
+    /**
+     * Stable step identity, unique within a run. A leg may yield several steps
+     * (cancel one side, write the other), so this — not `key` — is what a
+     * consumer should use as a list key.
+     */
+    id: string;
+    /** Leg identity (`GroupTpSlChild.key`). Several steps can share it. */
+    key: string;
+    /** What this step does. */
+    kind: SetQuoteGroupTpSlStepKind;
+    /** On-chain quote id. `0n` for a leg the plan skipped before it anchored. */
+    quoteId: bigint;
+    /**
+     * Sides this step still awaits confirmation for. A write starts with the
+     * sides it wrote and empties as reports land; a cancel carries exactly one.
+     */
+    sides: TpSlConditionalOrderType[];
+    /** Current stage. */
+    status: SetQuoteGroupTpSlStepStatus;
+    /** Why the leg was skipped, when `status` is `"skipped"`. */
+    skipReason?: GroupTpSlSkipReason;
+    /** Per-side validation errors, when `skipReason` is `"invalid"`. */
+    validation?: TpSlValidation;
+    /** Handler-issued conditional-order id — reported by a write, targeted by a cancel. */
+    cohQuoteId?: string;
+    /** Normalized error, when `status` is `"failed"`. */
+    error?: SymmioRequestError;
+}
+/** Overall lifecycle of a grouped TP/SL run. */
+export type SetQuoteGroupTpSlStatus = "idle"
+/** At least one request is in flight. */
+ | "submitting"
+/** Every request settled; at least one step still awaits its handler report. */
+ | "confirming"
+/** Every written and cancelled step is confirmed. */
+ | "success"
+/** Some steps were accepted, some failed. */
+ | "partial"
+/** Every step failed. */
+ | "failed";
+/** Inputs for one {@link UseSetQuoteGroupTpSlReturnType.set} run. */
+export interface SetQuoteGroupTpSlParameters {
+    /** Legs with their confirmed snapshots — from {@link useQuoteGroupTpSl}. */
+    children: readonly GroupTpSlChild[];
+    /** Desired per-leg state, keyed by `GroupTpSlChild.key`. */
+    desired: GroupTpSlDesiredMap;
+    /** SubAccount that owns every leg's Virtual Account — required in the signed message. */
+    subAccount: Address;
+    /** Market price precision. One value per run — a grouped position is one market. */
+    pricePrecision: number;
+    /** Live handler `/configs/` rules; with `referencePrice`, invalid legs are skipped, not submitted. */
+    config?: TpSlConfig;
+    /** Reference price for validation (decimal string) — pass the live mark price. */
+    referencePrice?: string;
+    /** Slippage percent forwarded to every write. Defaults to the SDK's TP/SL default. */
+    slippage?: number;
+    /** Affiliate override forwarded to every write. */
+    affiliate?: Address;
+    /** Delegated session key to sign from, when delegation is active. */
+    from?: Address;
+    /**
+     * How many requests may be in flight at once. Default `1` — every leg needs
+     * its own EIP-712 signature from the same wallet client, and serializing
+     * avoids signature races and simultaneous wallet prompts. Raise it only when
+     * signing with a session key.
+     */
+    concurrency?: number;
+    /**
+     * Stop the run when the wallet rejects a signature, instead of prompting for
+     * every remaining leg. Default `true` — a trader who dismisses one prompt did
+     * not consent to five more.
+     */
+    stopOnUserRejection?: boolean;
+    /**
+     * Accounts whose live streams confirm the run. Defaults to the deduped
+     * Virtual Account of every leg the plan touches — the channel the handler
+     * reports these orders on, and the reason a group spanning several VAs is
+     * fully covered.
+     */
+    notificationsAccounts?: readonly Address[];
+    /**
+     * Single-account form of {@link SetQuoteGroupTpSlParameters.notificationsAccounts}.
+     *
+     * @deprecated Pass `notificationsAccounts`. A grouped position can span
+     *   Virtual Accounts, so one address rarely covers the whole run.
+     */
+    notificationsAccount?: Address;
+    /**
+     * How long a step may wait for its report before the run refetches the
+     * handler's rows and, failing that, gives up on it. Defaults to
+     * {@link DEFAULT_TPSL_CONFIRMATION_TIMEOUT_MS}.
+     */
+    confirmationTimeoutMs?: number;
+    /**
+     * How long the WebSocket report gets on its own before the fallback sweep
+     * starts, in milliseconds. Defaults to {@link TPSL_FALLBACK_POLL_DELAY_MS}.
+     *
+     * The sweep exists for reports that never come; while one can still
+     * plausibly arrive, reading the handler adds load and answers nothing.
+     */
+    fallbackPollDelayMs?: number;
+    /**
+     * Cadence of the fallback sweep once it has started, in milliseconds.
+     * Defaults to {@link TPSL_FALLBACK_POLL_INTERVAL_MS}; `0` disables the sweep
+     * and leaves the WebSocket report as the only confirmation signal.
+     */
+    fallbackPollIntervalMs?: number;
+    /** Chain override; defaults to the connected chain. */
+    chainId?: number;
+    /** Restrict the run to these leg keys — the retry-failed-only path. */
+    only?: readonly string[];
+}
+/**
+ * Outcome of one run, reported once every step has been confirmed by the
+ * handler's report — or given up on. Nothing about the run is still in flight
+ * when this resolves.
+ */
+export interface SetQuoteGroupTpSlSummary {
+    /** `true` when every planned step was accepted **and** confirmed. */
+    ok: boolean;
+    /** Steps the handler accepted (writes and cancels). */
+    submittedCount: number;
+    /** Steps the handler's report confirmed. */
+    confirmedCount: number;
+    /** Steps that failed. */
+    failedCount: number;
+    /** Legs the plan skipped. */
+    skippedCount: number;
+    /** Per-step final states at resolve time. */
+    steps: SetQuoteGroupTpSlStep[];
+    /** The plan the run executed — inspect `skips` for why a leg was left out. */
+    plan: PlanGroupTpSlResult;
+    /** `true` when the run stopped early because the wallet rejected a signature. */
+    stoppedByUser: boolean;
+    /** First error, when any step failed. */
+    error?: SymmioRequestError;
+}
+/** Return type of {@link useSetQuoteGroupTpSl}. */
+export interface UseSetQuoteGroupTpSlReturnType {
+    /**
+     * Plan and apply. Resolves once every step has been confirmed by the
+     * handler's report or given up on (never rejects).
+     */
+    set: (parameters: SetQuoteGroupTpSlParameters) => Promise<SetQuoteGroupTpSlSummary>;
+    /**
+     * Re-run only the steps that failed, against fresh children when supplied
+     * (so a leg that confirmed via a race is diffed away). Steps that already
+     * succeeded are preserved, not reset. Never rejects.
+     */
+    retryFailed: (children?: readonly GroupTpSlChild[]) => Promise<SetQuoteGroupTpSlSummary>;
+    /** Clear the run state back to `idle`. No-op while a run is in flight. */
+    reset: () => void;
+    /** Overall run lifecycle. */
+    status: SetQuoteGroupTpSlStatus;
+    /** `true` while a request is in flight. */
+    isSubmitting: boolean;
+    /** `true` while every request has settled but some step still awaits its handler report. */
+    isConfirming: boolean;
+    /**
+     * Share of steps that reached a terminal state — confirmed or failed — as
+     * `0`–`100` (2-decimal resolution). A step the handler accepted but has not
+     * reported on yet does **not** count.
+     */
+    progressPercent: number;
+    /** Steps the handler accepted so far — **excludes** failures. */
+    acceptedCount: number;
+    /** Steps the handler's report has confirmed so far. */
+    confirmedCount: number;
+    /** Steps that failed so far. */
+    failedCount: number;
+    /** Steps the current/last run intends to execute (writes + cancels). */
+    totalCount: number;
+    /** Per-step states of the current/last run, in execution order. */
+    steps: SetQuoteGroupTpSlStep[];
+    /** The last run's plan, for UI gating. */
+    plan?: PlanGroupTpSlResult;
+    /** First error of the last run, when a step failed. */
+    error?: SymmioRequestError;
+}
+/** Parameters for {@link useSetQuoteGroupTpSl}. */
+export type UseSetQuoteGroupTpSlParameters = ConfigParameter;
+/**
+ * Apply a desired take-profit / stop-loss state across a grouped position.
+ *
+ * The run first diffs the desired state with `planGroupTpSl`, so a leg whose
+ * trigger price and price type already match the handler is never re-submitted
+ * and a side that did not change is dropped from its request. It then executes
+ * the plan — **one signed request per leg, sequentially by default**, because
+ * the conditional-order handler has no bulk endpoint and every request needs
+ * its own EIP-712 signature.
+ *
+ * Both halves of the plan run: a side the caller cleared becomes a cancel
+ * (`deleteQuoteTpSl`), a side with a new value becomes a write
+ * (`setQuoteTpSl`). One leg can do both in the same run.
+ *
+ * A step goes `confirming` as soon as the handler returns 200 (the shared TP/SL
+ * store is marked so the UI can show the target price straight away) and `done`
+ * once the WebSocket reports the matching transition — live for a write, gone
+ * for a cancel. **`set()` waits for those reports**: it resolves only when every
+ * step is confirmed, so a caller that awaits it can trust the exits are real.
+ * A step whose report never arrives falls back to the handler's REST rows after
+ * `confirmationTimeoutMs` and fails if those do not show it either.
+ *
+ * A failed step fails only itself and the run ends as `"partial"`, except when
+ * the wallet rejects a signature, which stops the run rather than prompting
+ * again.
+ *
+ * @param parameters - Optional config override.
+ * @returns The run controls and its live per-step state.
+ *
+ * @example
+ * ```tsx
+ * const { set, steps, isConfirming } = useSetQuoteGroupTpSl();
+ * // Resolves once the handler has reported every leg live.
+ * const summary = await set({ children, desired: editor.desired, subAccount, pricePrecision });
+ * if (!summary.ok) showError(summary.error);
+ * ```
+ */
+export declare function useSetQuoteGroupTpSl(parameters?: UseSetQuoteGroupTpSlParameters): UseSetQuoteGroupTpSlReturnType;
+//# sourceMappingURL=use-set-quote-group-tpsl.d.ts.map

package/dist/tpsl/use-set-quote-group-tpsl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-set-quote-group-tpsl.d.ts","sourceRoot":"","sources":["../../src/tpsl/use-set-quote-group-tpsl.ts"],"names":[],"mappings":"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"}