@symmio/trading-core 1.0.1 → 2.0.0

package/dist/notifications/search/adapters/enigma-search.js

@@ -0,0 +1,33 @@
+import { SymmApiError as e, SymmError as t } from "../../../shared/errors/symm-error.js";
+import n, { isAxiosError as r } from "axios";
+//#region src/notifications/search/adapters/enigma-search.ts
+function i(e) {
+	let t = { ...e.filter };
+	return e.account !== void 0 && (t.address = e.account), e.quoteId !== void 0 && (t["data.quote_id"] = e.quoteId), e.tempQuoteId !== void 0 && (t["data.temp_quote_id"] = e.tempQuoteId), t;
+}
+async function a(a, o) {
+	let s = o.baseUrl ?? a.notifications.searchUrl;
+	if (!s) throw new t("config", "NOTIFICATION_SEARCH_URL_NOT_CONFIGURED", "No notification search URL is configured for this solver. Set `notifications.searchUrl` in the solver config or pass `baseUrl`.");
+	try {
+		let { total: e, count: t, data: r } = (await n.post("/api/v1/search", {
+			query: i(o),
+			size: o.size,
+			start: o.start
+		}, { baseURL: s })).data;
+		return {
+			kind: "enigma",
+			total: e ?? 0,
+			count: t ?? 0,
+			rows: r ?? []
+		};
+	} catch (n) {
+		throw n instanceof t ? n : r(n) ? e.fromAxios(n, {
+			code: "SEARCH_NOTIFICATIONS_FAILED",
+			baseURL: s
+		}) : new t("api", "SEARCH_NOTIFICATIONS_FAILED", `Failed to search notifications: ${n instanceof Error ? n.message : String(n)}`, { cause: n instanceof Error ? n : void 0 });
+	}
+}
+//#endregion
+export { a as searchEnigmaNotifications };
+
+//# sourceMappingURL=enigma-search.js.map

package/dist/notifications/search/adapters/enigma-search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"enigma-search.js","names":[],"sources":["../../../../src/notifications/search/adapters/enigma-search.ts"],"sourcesContent":["import axios, { isAxiosError } from \"axios\";\nimport type { SymmioResolvedSolver } from \"../../../core/chains\";\nimport { SymmApiError, SymmError } from \"../../../shared/errors/symm-error\";\nimport type { NotificationDocument, NotificationSearchFilter } from \"../../types\";\nimport type { EnigmaNotificationSearchResult, SearchNotificationsParameters } from \"../types\";\n\n/** Raw shape of the notification service's `POST /api/v1/search` response. */\ninterface EnigmaSearchResponse {\n  total: number;\n  count: number;\n  data: NotificationDocument[];\n}\n\n/** Map the unified common filters onto the enigma service's equality filter. */\nfunction toEnigmaFilter(parameters: SearchNotificationsParameters): NotificationSearchFilter {\n  const filter: NotificationSearchFilter = { ...parameters.filter };\n  if (parameters.account !== undefined) filter.address = parameters.account;\n  if (parameters.quoteId !== undefined) filter[\"data.quote_id\"] = parameters.quoteId;\n  if (parameters.tempQuoteId !== undefined) filter[\"data.temp_quote_id\"] = parameters.tempQuoteId;\n  return filter;\n}\n\n/**\n * Search an enigma solver's stored notifications via the standalone notification\n * service's `POST /api/v1/search`. The base URL resolves from the solver's\n * `notifications.searchUrl`, or the per-call `baseUrl` override.\n *\n * @throws {SymmError} `NOTIFICATION_SEARCH_URL_NOT_CONFIGURED` when neither is set.\n * @throws {SymmApiError} when the request fails.\n *\n * @internal\n */\nexport async function searchEnigmaNotifications(\n  solver: SymmioResolvedSolver,\n  parameters: SearchNotificationsParameters,\n): Promise<EnigmaNotificationSearchResult> {\n  const baseURL = parameters.baseUrl ?? solver.notifications.searchUrl;\n  if (!baseURL) {\n    throw new SymmError(\n      \"config\",\n      \"NOTIFICATION_SEARCH_URL_NOT_CONFIGURED\",\n      \"No notification search URL is configured for this solver. Set `notifications.searchUrl` in the solver config or pass `baseUrl`.\",\n    );\n  }\n\n  try {\n    const response = await axios.post<EnigmaSearchResponse>(\n      \"/api/v1/search\",\n      { query: toEnigmaFilter(parameters), size: parameters.size, start: parameters.start },\n      { baseURL },\n    );\n    const { total, count, data } = response.data;\n    return { kind: \"enigma\", total: total ?? 0, count: count ?? 0, rows: data ?? [] };\n  } catch (err) {\n    if (err instanceof SymmError) throw err;\n    if (isAxiosError(err)) throw SymmApiError.fromAxios(err, { code: \"SEARCH_NOTIFICATIONS_FAILED\", baseURL });\n    throw new SymmError(\n      \"api\",\n      \"SEARCH_NOTIFICATIONS_FAILED\",\n      `Failed to search notifications: ${err instanceof Error ? err.message : String(err)}`,\n      { cause: err instanceof Error ? err : undefined },\n    );\n  }\n}\n"],"mappings":";;;AAcA,SAAS,EAAe,GAAqE;CAC3F,IAAM,IAAmC,EAAE,GAAG,EAAW,OAAO;CAIhE,OAHI,EAAW,YAAY,KAAA,MAAW,EAAO,UAAU,EAAW,UAC9D,EAAW,YAAY,KAAA,MAAW,EAAO,mBAAmB,EAAW,UACvE,EAAW,gBAAgB,KAAA,MAAW,EAAO,wBAAwB,EAAW,cAC7E;AACT;AAYA,eAAsB,EACpB,GACA,GACyC;CACzC,IAAM,IAAU,EAAW,WAAW,EAAO,cAAc;CAC3D,IAAI,CAAC,GACH,MAAM,IAAI,EACR,UACA,0CACA,iIACF;CAGF,IAAI;EAMF,IAAM,EAAE,UAAO,UAAO,aAAS,MALR,EAAM,KAC3B,kBACA;GAAE,OAAO,EAAe,CAAU;GAAG,MAAM,EAAW;GAAM,OAAO,EAAW;EAAM,GACpF,EAAE,WAAQ,CACZ,GACwC;EACxC,OAAO;GAAE,MAAM;GAAU,OAAO,KAAS;GAAG,OAAO,KAAS;GAAG,MAAM,KAAQ,CAAC;EAAE;CAClF,SAAS,GAAK;EAGZ,MAFI,aAAe,IAAiB,IAChC,EAAa,CAAG,IAAS,EAAa,UAAU,GAAK;GAAE,MAAM;GAA+B;EAAQ,CAAC,IACnG,IAAI,EACR,OACA,+BACA,mCAAmC,aAAe,QAAQ,EAAI,UAAU,OAAO,CAAG,KAClF,EAAE,OAAO,aAAe,QAAQ,IAAM,KAAA,EAAU,CAClD;CACF;AACF"}

package/dist/notifications/search/adapters/rasa-search.d.ts

@@ -0,0 +1,13 @@
+import { SymmioResolvedSolver } from '../../../core/chains/index.js';
+import { RasaNotificationSearchResult, SearchNotificationsParameters } from '../types.js';
+/**
+ * Search a rasa solver's notification history via its own position-state
+ * endpoint (`POST /position-state/{start}/{size}`) — the rasa protocol's
+ * notification search. `timestampGte` filters on the record's create time.
+ *
+ * @throws {SymmApiError} when the request fails.
+ *
+ * @internal
+ */
+export declare function searchRasaNotifications(solver: SymmioResolvedSolver, parameters: SearchNotificationsParameters): Promise<RasaNotificationSearchResult>;
+//# sourceMappingURL=rasa-search.d.ts.map

package/dist/notifications/search/adapters/rasa-search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rasa-search.d.ts","sourceRoot":"","sources":["../../../../src/notifications/search/adapters/rasa-search.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAGjE,OAAO,KAAK,EAAE,4BAA4B,EAAE,6BAA6B,EAAE,MAAM,UAAU,CAAC;AAE5F;;;;;;;;GAQG;AACH,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE,oBAAoB,EAC5B,UAAU,EAAE,6BAA6B,GACxC,OAAO,CAAC,4BAA4B,CAAC,CAyBvC"}

package/dist/notifications/search/adapters/rasa-search.js

@@ -0,0 +1,28 @@
+import { SymmApiError as e, SymmError as t } from "../../../shared/errors/symm-error.js";
+import { searchPositionStatePositionStateStartSizePost as n } from "../../../solvers/types/generated/rasa-solver.js";
+import { isAxiosError as r } from "axios";
+//#region src/notifications/search/adapters/rasa-search.ts
+async function i(i, a) {
+	try {
+		let e = await n(a.start ?? 0, a.size ?? 100, {
+			address: a.account ?? null,
+			quote_id: a.quoteId ?? null,
+			create_time_gte: a.timestampGte ?? null,
+			modify_time_gte: null
+		}, { baseURL: i.url });
+		return {
+			kind: "rasa",
+			count: e.data.count,
+			rows: e.data.position_state
+		};
+	} catch (n) {
+		throw n instanceof t ? n : r(n) ? e.fromAxios(n, {
+			code: "SEARCH_NOTIFICATIONS_FAILED",
+			baseURL: i.url
+		}) : new t("api", "SEARCH_NOTIFICATIONS_FAILED", `Failed to search notifications: ${n instanceof Error ? n.message : String(n)}`, { cause: n instanceof Error ? n : void 0 });
+	}
+}
+//#endregion
+export { i as searchRasaNotifications };
+
+//# sourceMappingURL=rasa-search.js.map

package/dist/notifications/search/adapters/rasa-search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rasa-search.js","names":[],"sources":["../../../../src/notifications/search/adapters/rasa-search.ts"],"sourcesContent":["import { isAxiosError } from \"axios\";\nimport type { SymmioResolvedSolver } from \"../../../core/chains\";\nimport { SymmApiError, SymmError } from \"../../../shared/errors/symm-error\";\nimport { searchPositionStatePositionStateStartSizePost } from \"../../../solvers/types/generated/rasa-solver\";\nimport type { RasaNotificationSearchResult, SearchNotificationsParameters } from \"../types\";\n\n/**\n * Search a rasa solver's notification history via its own position-state\n * endpoint (`POST /position-state/{start}/{size}`) — the rasa protocol's\n * notification search. `timestampGte` filters on the record's create time.\n *\n * @throws {SymmApiError} when the request fails.\n *\n * @internal\n */\nexport async function searchRasaNotifications(\n  solver: SymmioResolvedSolver,\n  parameters: SearchNotificationsParameters,\n): Promise<RasaNotificationSearchResult> {\n  try {\n    const response = await searchPositionStatePositionStateStartSizePost(\n      parameters.start ?? 0,\n      parameters.size ?? 100,\n      {\n        address: parameters.account ?? null,\n        quote_id: parameters.quoteId ?? null,\n        create_time_gte: parameters.timestampGte ?? null,\n        modify_time_gte: null,\n      },\n      { baseURL: solver.url },\n    );\n    return { kind: \"rasa\", count: response.data.count, rows: response.data.position_state };\n  } catch (err) {\n    if (err instanceof SymmError) throw err;\n    if (isAxiosError(err))\n      throw SymmApiError.fromAxios(err, { code: \"SEARCH_NOTIFICATIONS_FAILED\", baseURL: solver.url });\n    throw new SymmError(\n      \"api\",\n      \"SEARCH_NOTIFICATIONS_FAILED\",\n      `Failed to search notifications: ${err instanceof Error ? err.message : String(err)}`,\n      { cause: err instanceof Error ? err : undefined },\n    );\n  }\n}\n"],"mappings":";;;;AAeA,eAAsB,EACpB,GACA,GACuC;CACvC,IAAI;EACF,IAAM,IAAW,MAAM,EACrB,EAAW,SAAS,GACpB,EAAW,QAAQ,KACnB;GACE,SAAS,EAAW,WAAW;GAC/B,UAAU,EAAW,WAAW;GAChC,iBAAiB,EAAW,gBAAgB;GAC5C,iBAAiB;EACnB,GACA,EAAE,SAAS,EAAO,IAAI,CACxB;EACA,OAAO;GAAE,MAAM;GAAQ,OAAO,EAAS,KAAK;GAAO,MAAM,EAAS,KAAK;EAAe;CACxF,SAAS,GAAK;EAIZ,MAHI,aAAe,IAAiB,IAChC,EAAa,CAAG,IACZ,EAAa,UAAU,GAAK;GAAE,MAAM;GAA+B,SAAS,EAAO;EAAI,CAAC,IAC1F,IAAI,EACR,OACA,+BACA,mCAAmC,aAAe,QAAQ,EAAI,UAAU,OAAO,CAAG,KAClF,EAAE,OAAO,aAAe,QAAQ,IAAM,KAAA,EAAU,CAClD;CACF;AACF"}

package/dist/notifications/search/query.d.ts

@@ -25,8 +25,10 @@ export type SearchNotificationsOptions = Compute<SearchNotificationsParameters &
 export type SearchNotificationsQueryOptions = SymmioQueryOptions<SearchNotificationsData, Error, SearchNotificationsData, SearchNotificationsQueryKey>;
 /**
  * Build TanStack Query options for {@link searchNotifications}. The query is
- * disabled until `filter` has at least one key (so an empty filter never fires
- * a match-all request); pass `query.refetchInterval` to poll.
+ * **enabled by default** and fires on mount — an empty `{}` is a match-all page
+ * (rasa pages `/position-state/0/100`; enigma posts an empty filter). For an
+ * on-demand search box, gate it with `query: { enabled: false }` and call
+ * `refetch` yourself; pass `query.refetchInterval` to poll.
  *
  * @param config - The SDK config.
  * @param options - Search parameters and TanStack overrides.

package/dist/notifications/search/query.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../../src/notifications/search/query.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,EAAE,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAC/F,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAEnF,OAAO,EAEL,KAAK,6BAA6B,EAClC,KAAK,6BAA6B,EACnC,MAAM,wBAAwB,CAAC;AAEhC,0EAA0E;AAC1E,MAAM,MAAM,uBAAuB,GAAG,6BAA6B,CAAC;AAEpE;;;;;;;;GAQG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,GAAE,OAAO,CAAC,YAAY,CAAC,6BAA6B,CAAC,GAAG,kBAAkB,CAAM,6DAGxF;AAED,sEAAsE;AACtE,MAAM,MAAM,2BAA2B,GAAG,UAAU,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEzF;;;GAGG;AACH,MAAM,MAAM,0BAA0B,GAAG,OAAO,CAC9C,6BAA6B,GAC3B,cAAc,CAAC,uBAAuB,EAAE,KAAK,EAAE,uBAAuB,EAAE,2BAA2B,CAAC,CACvG,CAAC;AAEF,kFAAkF;AAClF,MAAM,MAAM,+BAA+B,GAAG,kBAAkB,CAC9D,uBAAuB,EACvB,KAAK,EACL,uBAAuB,EACvB,2BAA2B,CAC5B,CAAC;AAEF;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,+BAA+B,CAC7C,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,0BAA0B,GAClC,+BAA+B,CAkBjC"}
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../../src/notifications/search/query.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,EAAE,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAC/F,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAEnF,OAAO,EAEL,KAAK,6BAA6B,EAClC,KAAK,6BAA6B,EACnC,MAAM,wBAAwB,CAAC;AAEhC,0EAA0E;AAC1E,MAAM,MAAM,uBAAuB,GAAG,6BAA6B,CAAC;AAEpE;;;;;;;;GAQG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,GAAE,OAAO,CAAC,YAAY,CAAC,6BAA6B,CAAC,GAAG,kBAAkB,CAAM,6DAGxF;AAED,sEAAsE;AACtE,MAAM,MAAM,2BAA2B,GAAG,UAAU,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEzF;;;GAGG;AACH,MAAM,MAAM,0BAA0B,GAAG,OAAO,CAC9C,6BAA6B,GAC3B,cAAc,CAAC,uBAAuB,EAAE,KAAK,EAAE,uBAAuB,EAAE,2BAA2B,CAAC,CACvG,CAAC;AAEF,kFAAkF;AAClF,MAAM,MAAM,+BAA+B,GAAG,kBAAkB,CAC9D,uBAAuB,EACvB,KAAK,EACL,uBAAuB,EACvB,2BAA2B,CAC5B,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,+BAA+B,CAC7C,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,0BAA0B,GAClC,+BAA+B,CAsBjC"}

package/dist/notifications/search/query.js

@@ -5,19 +5,23 @@ function n(t = {}) {
 	return ["searchNotifications", e(t)];
 }
 function r(e, r) {
-	let i = r.filter != null && Object.keys(r.filter).length > 0;
 	return {
 		...r.query,
 		queryKey: n({
 			...r,
 			configKey: e.getChainConfigKey(r.chainId)
 		}),
-		enabled: i && (r.query?.enabled ?? !0),
+		enabled: r.query?.enabled ?? !0,
 		queryFn: () => t(e, {
 			chainId: r.chainId,
-			filter: r.filter,
-			size: r.size,
+			solverId: r.solverId,
+			account: r.account,
+			quoteId: r.quoteId,
+			tempQuoteId: r.tempQuoteId,
+			timestampGte: r.timestampGte,
 			start: r.start,
+			size: r.size,
+			filter: r.filter,
 			baseUrl: r.baseUrl
 		})
 	};

package/dist/notifications/search/query.js.map

@@ -1 +1 @@
-{"version":3,"file":"query.js","names":[],"sources":["../../../src/notifications/search/query.ts"],"sourcesContent":["import type { Config } from \"../../core/config\";\nimport type { Compute, ConfigKeyParameter, ExactPartial } from \"../../shared/types/properties\";\nimport type { QueryParameter, SymmioQueryOptions } from \"../../shared/types/query\";\nimport { filterQueryOptions } from \"../../shared/utils/query\";\nimport {\n  searchNotifications,\n  type SearchNotificationsParameters,\n  type SearchNotificationsReturnType,\n} from \"./search-notifications\";\n\n/** Data resolved by the {@link searchNotificationsQueryOptions} query. */\nexport type SearchNotificationsData = SearchNotificationsReturnType;\n\n/**\n * Build the TanStack Query key for {@link searchNotificationsQueryOptions}.\n *\n * The `filter` object is folded into the key, so two searches with different\n * filters cache independently; TanStack control fields (`query`) are stripped.\n *\n * @param options - Search parameters (filter, pagination, chain id, config key).\n * @returns A stable, hashable query key.\n */\nexport function searchNotificationsQueryKey(\n  options: Compute<ExactPartial<SearchNotificationsParameters> & ConfigKeyParameter> = {},\n) {\n  return [\"searchNotifications\", filterQueryOptions(options)] as const;\n}\n\n/** Query-key type produced by {@link searchNotificationsQueryKey}. */\nexport type SearchNotificationsQueryKey = ReturnType<typeof searchNotificationsQueryKey>;\n\n/**\n * Options accepted by {@link searchNotificationsQueryOptions}: the action's\n * parameters, an optional cache scope, and TanStack overrides (`query`).\n */\nexport type SearchNotificationsOptions = Compute<\n  SearchNotificationsParameters &\n    QueryParameter<SearchNotificationsData, Error, SearchNotificationsData, SearchNotificationsQueryKey>\n>;\n\n/** TanStack Query options returned by {@link searchNotificationsQueryOptions}. */\nexport type SearchNotificationsQueryOptions = SymmioQueryOptions<\n  SearchNotificationsData,\n  Error,\n  SearchNotificationsData,\n  SearchNotificationsQueryKey\n>;\n\n/**\n * Build TanStack Query options for {@link searchNotifications}. The query is\n * disabled until `filter` has at least one key (so an empty filter never fires\n * a match-all request); pass `query.refetchInterval` to poll.\n *\n * @param config - The SDK config.\n * @param options - Search parameters and TanStack overrides.\n * @returns Options to pass to `useQuery` / `queryClient.fetchQuery`.\n *\n * @example\n * ```ts\n * useQuery(\n *   searchNotificationsQueryOptions(config, {\n *     filter: { \"data.temp_quote_id\": -172 },\n *     query: { refetchInterval: 5_000 },\n *   }),\n * );\n * ```\n */\nexport function searchNotificationsQueryOptions(\n  config: Config,\n  options: SearchNotificationsOptions,\n): SearchNotificationsQueryOptions {\n  const hasFilter = options.filter != null && Object.keys(options.filter).length > 0;\n  return {\n    ...options.query,\n    queryKey: searchNotificationsQueryKey({\n      ...options,\n      configKey: config.getChainConfigKey(options.chainId),\n    }),\n    enabled: hasFilter && (options.query?.enabled ?? true),\n    queryFn: () =>\n      searchNotifications(config, {\n        chainId: options.chainId,\n        filter: options.filter,\n        size: options.size,\n        start: options.start,\n        baseUrl: options.baseUrl,\n      }),\n  };\n}\n"],"mappings":";;;AAsBA,SAAgB,EACd,IAAqF,CAAC,GACtF;CACA,OAAO,CAAC,uBAAuB,EAAmB,CAAO,CAAC;AAC5D;AAyCA,SAAgB,EACd,GACA,GACiC;CACjC,IAAM,IAAY,EAAQ,UAAU,QAAQ,OAAO,KAAK,EAAQ,MAAM,EAAE,SAAS;CACjF,OAAO;EACL,GAAG,EAAQ;EACX,UAAU,EAA4B;GACpC,GAAG;GACH,WAAW,EAAO,kBAAkB,EAAQ,OAAO;EACrD,CAAC;EACD,SAAS,MAAc,EAAQ,OAAO,WAAW;EACjD,eACE,EAAoB,GAAQ;GAC1B,SAAS,EAAQ;GACjB,QAAQ,EAAQ;GAChB,MAAM,EAAQ;GACd,OAAO,EAAQ;GACf,SAAS,EAAQ;EACnB,CAAC;CACL;AACF"}
+{"version":3,"file":"query.js","names":[],"sources":["../../../src/notifications/search/query.ts"],"sourcesContent":["import type { Config } from \"../../core/config\";\nimport type { Compute, ConfigKeyParameter, ExactPartial } from \"../../shared/types/properties\";\nimport type { QueryParameter, SymmioQueryOptions } from \"../../shared/types/query\";\nimport { filterQueryOptions } from \"../../shared/utils/query\";\nimport {\n  searchNotifications,\n  type SearchNotificationsParameters,\n  type SearchNotificationsReturnType,\n} from \"./search-notifications\";\n\n/** Data resolved by the {@link searchNotificationsQueryOptions} query. */\nexport type SearchNotificationsData = SearchNotificationsReturnType;\n\n/**\n * Build the TanStack Query key for {@link searchNotificationsQueryOptions}.\n *\n * The `filter` object is folded into the key, so two searches with different\n * filters cache independently; TanStack control fields (`query`) are stripped.\n *\n * @param options - Search parameters (filter, pagination, chain id, config key).\n * @returns A stable, hashable query key.\n */\nexport function searchNotificationsQueryKey(\n  options: Compute<ExactPartial<SearchNotificationsParameters> & ConfigKeyParameter> = {},\n) {\n  return [\"searchNotifications\", filterQueryOptions(options)] as const;\n}\n\n/** Query-key type produced by {@link searchNotificationsQueryKey}. */\nexport type SearchNotificationsQueryKey = ReturnType<typeof searchNotificationsQueryKey>;\n\n/**\n * Options accepted by {@link searchNotificationsQueryOptions}: the action's\n * parameters, an optional cache scope, and TanStack overrides (`query`).\n */\nexport type SearchNotificationsOptions = Compute<\n  SearchNotificationsParameters &\n    QueryParameter<SearchNotificationsData, Error, SearchNotificationsData, SearchNotificationsQueryKey>\n>;\n\n/** TanStack Query options returned by {@link searchNotificationsQueryOptions}. */\nexport type SearchNotificationsQueryOptions = SymmioQueryOptions<\n  SearchNotificationsData,\n  Error,\n  SearchNotificationsData,\n  SearchNotificationsQueryKey\n>;\n\n/**\n * Build TanStack Query options for {@link searchNotifications}. The query is\n * **enabled by default** and fires on mount — an empty `{}` is a match-all page\n * (rasa pages `/position-state/0/100`; enigma posts an empty filter). For an\n * on-demand search box, gate it with `query: { enabled: false }` and call\n * `refetch` yourself; pass `query.refetchInterval` to poll.\n *\n * @param config - The SDK config.\n * @param options - Search parameters and TanStack overrides.\n * @returns Options to pass to `useQuery` / `queryClient.fetchQuery`.\n *\n * @example\n * ```ts\n * useQuery(\n *   searchNotificationsQueryOptions(config, {\n *     filter: { \"data.temp_quote_id\": -172 },\n *     query: { refetchInterval: 5_000 },\n *   }),\n * );\n * ```\n */\nexport function searchNotificationsQueryOptions(\n  config: Config,\n  options: SearchNotificationsOptions,\n): SearchNotificationsQueryOptions {\n  return {\n    ...options.query,\n    queryKey: searchNotificationsQueryKey({\n      ...options,\n      configKey: config.getChainConfigKey(options.chainId),\n    }),\n    enabled: options.query?.enabled ?? true,\n    queryFn: () =>\n      searchNotifications(config, {\n        chainId: options.chainId,\n        solverId: options.solverId,\n        account: options.account,\n        quoteId: options.quoteId,\n        tempQuoteId: options.tempQuoteId,\n        timestampGte: options.timestampGte,\n        start: options.start,\n        size: options.size,\n        filter: options.filter,\n        baseUrl: options.baseUrl,\n      }),\n  };\n}\n"],"mappings":";;;AAsBA,SAAgB,EACd,IAAqF,CAAC,GACtF;CACA,OAAO,CAAC,uBAAuB,EAAmB,CAAO,CAAC;AAC5D;AA2CA,SAAgB,EACd,GACA,GACiC;CACjC,OAAO;EACL,GAAG,EAAQ;EACX,UAAU,EAA4B;GACpC,GAAG;GACH,WAAW,EAAO,kBAAkB,EAAQ,OAAO;EACrD,CAAC;EACD,SAAS,EAAQ,OAAO,WAAW;EACnC,eACE,EAAoB,GAAQ;GAC1B,SAAS,EAAQ;GACjB,UAAU,EAAQ;GAClB,SAAS,EAAQ;GACjB,SAAS,EAAQ;GACjB,aAAa,EAAQ;GACrB,cAAc,EAAQ;GACtB,OAAO,EAAQ;GACf,MAAM,EAAQ;GACd,QAAQ,EAAQ;GAChB,SAAS,EAAQ;EACnB,CAAC;CACL;AACF"}

package/dist/notifications/search/search-notifications.d.ts

@@ -1,56 +1,36 @@
+import { SolverId } from '../../core/chains/index.js';
 import { Config } from '../../core/config/index.js';
-import { ChainIdParameter, Compute } from '../../shared/types/properties.js';
-import { NotificationSearchFilter, NotificationSearchResult } from '../types.js';
+import { SearchNotificationsParameters, SearchNotificationsReturnType } from './types.js';
+export type { EnigmaNotificationSearchResult, NotificationSearchResult, NotificationSearchResultByKind, RasaNotificationSearchResult, SearchNotificationsParameters, SearchNotificationsReturnType, } from './types.js';
 /**
- * Parameters for {@link searchNotifications}.
- */
-export type SearchNotificationsParameters = Compute<ChainIdParameter & {
-    /**
-     * Equality filter sent as the request `query`; see {@link NotificationSearchFilter}.
-     * Named `filter` (not `query`) so it never collides with the TanStack
-     * `query` overrides on the matching query-options factory.
-     */
-    filter: NotificationSearchFilter;
-    /** Maximum number of results to return (1–100). Defaults to 100 (the backend default). */
-    size?: number;
-    /** Zero-based offset of the first result. Defaults to 0. */
-    start?: number;
-    /**
-     * Override the notification-search base URL. Defaults to the chain config's
-     * `notifications.searchUrl`. The action appends `/api/v1/search`.
-     */
-    baseUrl?: string;
-}>;
-/** Return type of {@link searchNotifications}. */
-export type SearchNotificationsReturnType = NotificationSearchResult;
-/**
- * Search stored notifications via the notification service's
- * `POST /api/v1/search` endpoint.
+ * Search stored notifications for a solver, dispatched by kind:
  *
- * The filter is a free-form equality match over the stored document: every key
- * is compared exactly, whether it is a top-level field (`app_name`, `address`,
- * `type`, …) or a dotted path into the nested payload (`data.temp_quote_id`,
- * `data.quote_id`, …). Known fields are offered as autocomplete; any other
- * string key is still accepted.
+ * - **enigma** → the standalone notification service (`POST /api/v1/search`),
+ *   returning the matched documents.
+ * - **rasa** → the solver's own position-state endpoint
+ *   (`POST /position-state/{start}/{size}`), returning position-state rows.
  *
- * The base URL resolves from the chain config's `notifications.searchUrl`, or
- * the per-call `baseUrl` override.
+ * One interface for both: pass the common filters (`account`, `quoteId`,
+ * `tempQuoteId`, `timestampGte`) plus `start`/`size`; the SDK maps them to the
+ * resolved solver's native query. The result is a per-kind union — pass a
+ * **literal** `solverId` to narrow it to that kind's variant, or narrow on the
+ * returned `kind` discriminant.
  *
  * @param config - The SDK config.
- * @param parameters - `filter`, optional `size` / `start` pagination, optional
- *   `chainId`, optional `baseUrl`.
- * @returns The matched documents plus `total` and `count`.
+ * @param parameters - Solver target, common filters, and pagination.
+ * @returns `{ kind, count, rows, … }` — the enigma or rasa result variant.
+ * @throws {SymmError} `NOTIFICATION_SEARCH_URL_NOT_CONFIGURED` (enigma) when no
+ *   search URL is configured and no `baseUrl` is passed.
  * @throws {SymmApiError} when the search request fails.
- * @throws {SymmError} when no search URL is configured for the chain and no
- *   `baseUrl` is passed.
  *
  * @example
  * ```ts
- * const { documents, total } = await searchNotifications(config, {
- *   filter: { app_name: "Base_Superflow_Stage", "data.temp_quote_id": -172 },
- *   size: 50,
- * });
+ * // chain default solver → the union; narrow on `kind`
+ * const page = await searchNotifications(config, { account, quoteId: 1024 });
+ *
+ * // literal solverId → the exact variant
+ * const rasa = await searchNotifications(config, { solverId: "rasa", account }); // RasaNotificationSearchResult
  * ```
  */
-export declare function searchNotifications(config: Config, parameters: SearchNotificationsParameters): Promise<SearchNotificationsReturnType>;
+export declare function searchNotifications<K extends SolverId = SolverId>(config: Config, parameters: SearchNotificationsParameters<K>): Promise<SearchNotificationsReturnType<K>>;
 //# sourceMappingURL=search-notifications.d.ts.map

package/dist/notifications/search/search-notifications.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"search-notifications.d.ts","sourceRoot":"","sources":["../../../src/notifications/search/search-notifications.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAEhD,OAAO,KAAK,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAC;AAC/E,OAAO,KAAK,EAAwB,wBAAwB,EAAE,wBAAwB,EAAE,MAAM,UAAU,CAAC;AAEzG;;GAEG;AACH,MAAM,MAAM,6BAA6B,GAAG,OAAO,CACjD,gBAAgB,GAAG;IACjB;;;;OAIG;IACH,MAAM,EAAE,wBAAwB,CAAC;IACjC,0FAA0F;IAC1F,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,4DAA4D;IAC5D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CACF,CAAC;AAEF,kDAAkD;AAClD,MAAM,MAAM,6BAA6B,GAAG,wBAAwB,CAAC;AASrE;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,6BAA6B,GACxC,OAAO,CAAC,6BAA6B,CAAC,CAiCxC"}
+{"version":3,"file":"search-notifications.d.ts","sourceRoot":"","sources":["../../../src/notifications/search/search-notifications.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAGhD,OAAO,KAAK,EAAE,6BAA6B,EAAE,6BAA6B,EAAE,MAAM,SAAS,CAAC;AAE5F,YAAY,EACV,8BAA8B,EAC9B,wBAAwB,EACxB,8BAA8B,EAC9B,4BAA4B,EAC5B,6BAA6B,EAC7B,6BAA6B,GAC9B,MAAM,SAAS,CAAC;AAEjB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAsB,mBAAmB,CAAC,CAAC,SAAS,QAAQ,GAAG,QAAQ,EACrE,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,6BAA6B,CAAC,CAAC,CAAC,GAC3C,OAAO,CAAC,6BAA6B,CAAC,CAAC,CAAC,CAAC,CAQ3C"}

package/dist/notifications/search/search-notifications.js

@@ -1,28 +1,17 @@
-import { SymmApiError as e, SymmError as t } from "../../shared/errors/symm-error.js";
-import n, { isAxiosError as r } from "axios";
+import { searchEnigmaNotifications as e } from "./adapters/enigma-search.js";
+import { searchRasaNotifications as t } from "./adapters/rasa-search.js";
 //#region src/notifications/search/search-notifications.ts
-async function i(i, a) {
-	let { notifications: o } = i.getChainConfig(a.chainId), s = a.baseUrl ?? o.searchUrl;
-	if (!s) throw new t("config", "NOTIFICATION_SEARCH_URL_NOT_CONFIGURED", "No notification search URL is configured for this chain. Set `notifications.searchUrl` in the chain config or pass `baseUrl`.");
-	try {
-		let { total: e, count: t, data: r } = (await n.post("/api/v1/search", {
-			query: a.filter,
-			size: a.size,
-			start: a.start
-		}, { baseURL: s })).data;
-		return {
-			total: e,
-			count: t,
-			documents: r ?? []
-		};
-	} catch (n) {
-		throw n instanceof t ? n : r(n) ? e.fromAxios(n, {
-			code: "SEARCH_NOTIFICATIONS_FAILED",
-			baseURL: s
-		}) : new t("api", "SEARCH_NOTIFICATIONS_FAILED", `Failed to search notifications: ${n instanceof Error ? n.message : String(n)}`, { cause: n instanceof Error ? n : void 0 });
+async function n(n, r) {
+	let i = n.getSolver({
+		chainId: r.chainId,
+		solverId: r.solverId
+	});
+	switch (i.id) {
+		case "enigma": return e(i, r);
+		case "rasa": return t(i, r);
 	}
 }
 //#endregion
-export { i as searchNotifications };
+export { n as searchNotifications };
 
 //# sourceMappingURL=search-notifications.js.map

package/dist/notifications/search/search-notifications.js.map

@@ -1 +1 @@
-{"version":3,"file":"search-notifications.js","names":[],"sources":["../../../src/notifications/search/search-notifications.ts"],"sourcesContent":["import axios, { isAxiosError } from \"axios\";\nimport type { Config } from \"../../core/config\";\nimport { SymmApiError, SymmError } from \"../../shared/errors/symm-error\";\nimport type { ChainIdParameter, Compute } from \"../../shared/types/properties\";\nimport type { NotificationDocument, NotificationSearchFilter, NotificationSearchResult } from \"../types\";\n\n/**\n * Parameters for {@link searchNotifications}.\n */\nexport type SearchNotificationsParameters = Compute<\n  ChainIdParameter & {\n    /**\n     * Equality filter sent as the request `query`; see {@link NotificationSearchFilter}.\n     * Named `filter` (not `query`) so it never collides with the TanStack\n     * `query` overrides on the matching query-options factory.\n     */\n    filter: NotificationSearchFilter;\n    /** Maximum number of results to return (1–100). Defaults to 100 (the backend default). */\n    size?: number;\n    /** Zero-based offset of the first result. Defaults to 0. */\n    start?: number;\n    /**\n     * Override the notification-search base URL. Defaults to the chain config's\n     * `notifications.searchUrl`. The action appends `/api/v1/search`.\n     */\n    baseUrl?: string;\n  }\n>;\n\n/** Return type of {@link searchNotifications}. */\nexport type SearchNotificationsReturnType = NotificationSearchResult;\n\n/** Raw shape of the notification service's `POST /api/v1/search` response. */\ninterface NotificationsSearchResponse {\n  total: number;\n  count: number;\n  data: NotificationDocument[];\n}\n\n/**\n * Search stored notifications via the notification service's\n * `POST /api/v1/search` endpoint.\n *\n * The filter is a free-form equality match over the stored document: every key\n * is compared exactly, whether it is a top-level field (`app_name`, `address`,\n * `type`, …) or a dotted path into the nested payload (`data.temp_quote_id`,\n * `data.quote_id`, …). Known fields are offered as autocomplete; any other\n * string key is still accepted.\n *\n * The base URL resolves from the chain config's `notifications.searchUrl`, or\n * the per-call `baseUrl` override.\n *\n * @param config - The SDK config.\n * @param parameters - `filter`, optional `size` / `start` pagination, optional\n *   `chainId`, optional `baseUrl`.\n * @returns The matched documents plus `total` and `count`.\n * @throws {SymmApiError} when the search request fails.\n * @throws {SymmError} when no search URL is configured for the chain and no\n *   `baseUrl` is passed.\n *\n * @example\n * ```ts\n * const { documents, total } = await searchNotifications(config, {\n *   filter: { app_name: \"Base_Superflow_Stage\", \"data.temp_quote_id\": -172 },\n *   size: 50,\n * });\n * ```\n */\nexport async function searchNotifications(\n  config: Config,\n  parameters: SearchNotificationsParameters,\n): Promise<SearchNotificationsReturnType> {\n  const { notifications } = config.getChainConfig(parameters.chainId);\n  const baseURL = parameters.baseUrl ?? notifications.searchUrl;\n  if (!baseURL) {\n    throw new SymmError(\n      \"config\",\n      \"NOTIFICATION_SEARCH_URL_NOT_CONFIGURED\",\n      \"No notification search URL is configured for this chain. Set `notifications.searchUrl` in the chain config or pass `baseUrl`.\",\n    );\n  }\n\n  try {\n    const response = await axios.post<NotificationsSearchResponse>(\n      \"/api/v1/search\",\n      { query: parameters.filter, size: parameters.size, start: parameters.start },\n      { baseURL },\n    );\n    const { total, count, data } = response.data;\n    return { total, count, documents: data ?? [] };\n  } catch (err) {\n    if (err instanceof SymmError) throw err;\n\n    if (isAxiosError(err)) {\n      throw SymmApiError.fromAxios(err, { code: \"SEARCH_NOTIFICATIONS_FAILED\", baseURL });\n    }\n\n    throw new SymmError(\n      \"api\",\n      \"SEARCH_NOTIFICATIONS_FAILED\",\n      `Failed to search notifications: ${err instanceof Error ? err.message : String(err)}`,\n      { cause: err instanceof Error ? err : undefined },\n    );\n  }\n}\n"],"mappings":";;;AAoEA,eAAsB,EACpB,GACA,GACwC;CACxC,IAAM,EAAE,qBAAkB,EAAO,eAAe,EAAW,OAAO,GAC5D,IAAU,EAAW,WAAW,EAAc;CACpD,IAAI,CAAC,GACH,MAAM,IAAI,EACR,UACA,0CACA,+HACF;CAGF,IAAI;EAMF,IAAM,EAAE,UAAO,UAAO,aAAS,MALR,EAAM,KAC3B,kBACA;GAAE,OAAO,EAAW;GAAQ,MAAM,EAAW;GAAM,OAAO,EAAW;EAAM,GAC3E,EAAE,WAAQ,CACZ,GACwC;EACxC,OAAO;GAAE;GAAO;GAAO,WAAW,KAAQ,CAAC;EAAE;CAC/C,SAAS,GAAK;EAOZ,MANI,aAAe,IAAiB,IAEhC,EAAa,CAAG,IACZ,EAAa,UAAU,GAAK;GAAE,MAAM;GAA+B;EAAQ,CAAC,IAG9E,IAAI,EACR,OACA,+BACA,mCAAmC,aAAe,QAAQ,EAAI,UAAU,OAAO,CAAG,KAClF,EAAE,OAAO,aAAe,QAAQ,IAAM,KAAA,EAAU,CAClD;CACF;AACF"}
+{"version":3,"file":"search-notifications.js","names":[],"sources":["../../../src/notifications/search/search-notifications.ts"],"sourcesContent":["import type { SolverId } from \"../../core/chains\";\nimport type { Config } from \"../../core/config\";\nimport { searchEnigmaNotifications } from \"./adapters/enigma-search\";\nimport { searchRasaNotifications } from \"./adapters/rasa-search\";\nimport type { SearchNotificationsParameters, SearchNotificationsReturnType } from \"./types\";\n\nexport type {\n  EnigmaNotificationSearchResult,\n  NotificationSearchResult,\n  NotificationSearchResultByKind,\n  RasaNotificationSearchResult,\n  SearchNotificationsParameters,\n  SearchNotificationsReturnType,\n} from \"./types\";\n\n/**\n * Search stored notifications for a solver, dispatched by kind:\n *\n * - **enigma** → the standalone notification service (`POST /api/v1/search`),\n *   returning the matched documents.\n * - **rasa** → the solver's own position-state endpoint\n *   (`POST /position-state/{start}/{size}`), returning position-state rows.\n *\n * One interface for both: pass the common filters (`account`, `quoteId`,\n * `tempQuoteId`, `timestampGte`) plus `start`/`size`; the SDK maps them to the\n * resolved solver's native query. The result is a per-kind union — pass a\n * **literal** `solverId` to narrow it to that kind's variant, or narrow on the\n * returned `kind` discriminant.\n *\n * @param config - The SDK config.\n * @param parameters - Solver target, common filters, and pagination.\n * @returns `{ kind, count, rows, … }` — the enigma or rasa result variant.\n * @throws {SymmError} `NOTIFICATION_SEARCH_URL_NOT_CONFIGURED` (enigma) when no\n *   search URL is configured and no `baseUrl` is passed.\n * @throws {SymmApiError} when the search request fails.\n *\n * @example\n * ```ts\n * // chain default solver → the union; narrow on `kind`\n * const page = await searchNotifications(config, { account, quoteId: 1024 });\n *\n * // literal solverId → the exact variant\n * const rasa = await searchNotifications(config, { solverId: \"rasa\", account }); // RasaNotificationSearchResult\n * ```\n */\nexport async function searchNotifications<K extends SolverId = SolverId>(\n  config: Config,\n  parameters: SearchNotificationsParameters<K>,\n): Promise<SearchNotificationsReturnType<K>> {\n  const solver = config.getSolver({ chainId: parameters.chainId, solverId: parameters.solverId });\n  switch (solver.id) {\n    case \"enigma\":\n      return searchEnigmaNotifications(solver, parameters) as Promise<SearchNotificationsReturnType<K>>;\n    case \"rasa\":\n      return searchRasaNotifications(solver, parameters) as Promise<SearchNotificationsReturnType<K>>;\n  }\n}\n"],"mappings":";;;AA6CA,eAAsB,EACpB,GACA,GAC2C;CAC3C,IAAM,IAAS,EAAO,UAAU;EAAE,SAAS,EAAW;EAAS,UAAU,EAAW;CAAS,CAAC;CAC9F,QAAQ,EAAO,IAAf;EACE,KAAK,UACH,OAAO,EAA0B,GAAQ,CAAU;EACrD,KAAK,QACH,OAAO,EAAwB,GAAQ,CAAU;CACrD;AACF"}

package/dist/notifications/search/types.d.ts

@@ -0,0 +1,80 @@
+import { Address } from 'viem';
+import { SolverId } from '../../core/chains/index.js';
+import { ChainIdParameter, Compute } from '../../shared/types/properties.js';
+import { PositionStateResponseSchema } from '../../solvers/types/generated/rasa-solver.js';
+import { NotificationDocument, NotificationSearchFilter } from '../types.js';
+/**
+ * Parameters for {@link searchNotifications} — one shape for both solver kinds.
+ * The common filters (`account`, `quoteId`, `tempQuoteId`, `timestampGte`) are
+ * mapped to each kind's native query; `filter` is an enigma-only advanced
+ * equality filter, and `baseUrl` overrides the enigma notification service host.
+ *
+ * `solverId` is a {@link SolverId}. Pass a **literal** kind to narrow the return
+ * to that kind's result variant.
+ */
+export type SearchNotificationsParameters<K extends SolverId = SolverId> = Compute<ChainIdParameter & {
+    /** Target solver — selects the search endpoint + result variant. Defaults to the chain's default solver. */
+    solverId?: K;
+    /** Filter: counterparty (subaccount) address. */
+    account?: Address;
+    /** Filter: on-chain quote id. */
+    quoteId?: number;
+    /** Filter: pre-chain temporary quote id (negative). Enigma only. */
+    tempQuoteId?: number;
+    /** Filter: created/emitted at or after this unix timestamp (seconds). Rasa only. */
+    timestampGte?: number;
+    /** Zero-based offset of the first row. Defaults to 0. */
+    start?: number;
+    /** Maximum rows to return. Defaults to the endpoint default. */
+    size?: number;
+    /**
+     * Enigma-only advanced equality filter, merged over the mapped common
+     * filters. Ignored for rasa (which has no free-form filter).
+     */
+    filter?: NotificationSearchFilter;
+    /** Override the enigma notification-service base URL (defaults to the solver's `notifications.searchUrl`). */
+    baseUrl?: string;
+}>;
+/**
+ * A notification search result from an **enigma** solver — the standalone
+ * notification service's stored documents.
+ */
+export interface EnigmaNotificationSearchResult {
+    /** Discriminant: this page came from an enigma solver. */
+    kind: "enigma";
+    /** Total documents matching the filter, ignoring pagination (enigma service only). */
+    total: number;
+    /** Number of rows returned in this page. */
+    count: number;
+    /** The matched documents for the requested `start`/`size` window. */
+    rows: NotificationDocument[];
+}
+/**
+ * A notification search result from a **rasa** solver — the solver's own
+ * position-state records (`POST /position-state/{start}/{size}`), which are the
+ * rasa protocol's notification history.
+ */
+export interface RasaNotificationSearchResult {
+    /** Discriminant: this page came from a rasa solver. */
+    kind: "rasa";
+    /** Total matching rows on the solver, for paging. */
+    count: number;
+    /** The matched position-state rows for the requested window. */
+    rows: PositionStateResponseSchema[];
+}
+/**
+ * Notification search result, normalized per solver kind. Discriminated on
+ * `kind`; narrow to reach kind-specific fields (e.g. enigma's `total`).
+ */
+export type NotificationSearchResult = EnigmaNotificationSearchResult | RasaNotificationSearchResult;
+/**
+ * Maps each solver kind to its notification search result variant. Indexed by
+ * the caller's `solverId` to narrow the {@link searchNotifications} return.
+ */
+export interface NotificationSearchResultByKind {
+    enigma: EnigmaNotificationSearchResult;
+    rasa: RasaNotificationSearchResult;
+}
+/** Return type of {@link searchNotifications}: `NotificationSearchResultByKind[K]`. */
+export type SearchNotificationsReturnType<K extends SolverId = SolverId> = NotificationSearchResultByKind[K];
+//# sourceMappingURL=types.d.ts.map

package/dist/notifications/search/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/notifications/search/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACpC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,KAAK,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAC;AAC/E,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,2CAA2C,CAAC;AAC7F,OAAO,KAAK,EAAE,oBAAoB,EAAE,wBAAwB,EAAE,MAAM,UAAU,CAAC;AAE/E;;;;;;;;GAQG;AACH,MAAM,MAAM,6BAA6B,CAAC,CAAC,SAAS,QAAQ,GAAG,QAAQ,IAAI,OAAO,CAChF,gBAAgB,GAAG;IACjB,4GAA4G;IAC5G,QAAQ,CAAC,EAAE,CAAC,CAAC;IACb,iDAAiD;IACjD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,iCAAiC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oEAAoE;IACpE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oFAAoF;IACpF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,yDAAyD;IACzD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gEAAgE;IAChE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,MAAM,CAAC,EAAE,wBAAwB,CAAC;IAClC,8GAA8G;IAC9G,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CACF,CAAC;AAEF;;;GAGG;AACH,MAAM,WAAW,8BAA8B;IAC7C,0DAA0D;IAC1D,IAAI,EAAE,QAAQ,CAAC;IACf,sFAAsF;IACtF,KAAK,EAAE,MAAM,CAAC;IACd,4CAA4C;IAC5C,KAAK,EAAE,MAAM,CAAC;IACd,qEAAqE;IACrE,IAAI,EAAE,oBAAoB,EAAE,CAAC;CAC9B;AAED;;;;GAIG;AACH,MAAM,WAAW,4BAA4B;IAC3C,uDAAuD;IACvD,IAAI,EAAE,MAAM,CAAC;IACb,qDAAqD;IACrD,KAAK,EAAE,MAAM,CAAC;IACd,gEAAgE;IAChE,IAAI,EAAE,2BAA2B,EAAE,CAAC;CACrC;AAED;;;GAGG;AACH,MAAM,MAAM,wBAAwB,GAAG,8BAA8B,GAAG,4BAA4B,CAAC;AAErG;;;GAGG;AACH,MAAM,WAAW,8BAA8B;IAC7C,MAAM,EAAE,8BAA8B,CAAC;IACvC,IAAI,EAAE,4BAA4B,CAAC;CACpC;AAED,uFAAuF;AACvF,MAAM,MAAM,6BAA6B,CAAC,CAAC,SAAS,QAAQ,GAAG,QAAQ,IAAI,8BAA8B,CAAC,CAAC,CAAC,CAAC"}

package/dist/notifications/types.d.ts

@@ -63,15 +63,4 @@ export interface NotificationDocument {
     data?: RawPositionNotification & Record<string, unknown>;
     [key: string]: unknown;
 }
-/**
- * Normalized result of {@link searchNotifications}.
- */
-export interface NotificationSearchResult {
-    /** Total number of documents matching the filter, ignoring pagination. */
-    total: number;
-    /** Number of documents returned in this page (`documents.length`). */
-    count: number;
-    /** The matched documents for the requested `start`/`size` window. */
-    documents: NotificationDocument[];
-}
 //# sourceMappingURL=types.d.ts.map

package/dist/notifications/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/notifications/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AAEhF;;;;GAIG;AACH,MAAM,MAAM,sBAAsB,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;AAEtE;;;GAGG;AACH,MAAM,MAAM,+BAA+B,GACvC,IAAI,GACJ,UAAU,GACV,SAAS,GACT,oBAAoB,GACpB,sBAAsB,GACtB,MAAM,GACN,aAAa,GACb,aAAa,CAAC;AAElB;;;;;GAKG;AACH,MAAM,MAAM,mBAAmB,GAAG,QAAQ,OAAO,CAAC,MAAM,uBAAuB,EAAE,MAAM,CAAC,EAAE,CAAC;AAE3F;;;GAGG;AACH,MAAM,MAAM,uBAAuB,GAAG,+BAA+B,GAAG,mBAAmB,CAAC;AAE5F;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,MAAM,wBAAwB,GAAG,OAAO,CAAC,MAAM,CAAC,uBAAuB,EAAE,sBAAsB,CAAC,CAAC,GACrG,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC;AAEzC;;;;;;GAMG;AACH,MAAM,WAAW,oBAAoB;IACnC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,uFAAuF;IACvF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,sDAAsD;IACtD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,oBAAoB,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAC9C,0BAA0B;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+EAA+E;IAC/E,IAAI,CAAC,EAAE,uBAAuB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACzD,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,0EAA0E;IAC1E,KAAK,EAAE,MAAM,CAAC;IACd,sEAAsE;IACtE,KAAK,EAAE,MAAM,CAAC;IACd,qEAAqE;IACrE,SAAS,EAAE,oBAAoB,EAAE,CAAC;CACnC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/notifications/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AAEhF;;;;GAIG;AACH,MAAM,MAAM,sBAAsB,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;AAEtE;;;GAGG;AACH,MAAM,MAAM,+BAA+B,GACvC,IAAI,GACJ,UAAU,GACV,SAAS,GACT,oBAAoB,GACpB,sBAAsB,GACtB,MAAM,GACN,aAAa,GACb,aAAa,CAAC;AAElB;;;;;GAKG;AACH,MAAM,MAAM,mBAAmB,GAAG,QAAQ,OAAO,CAAC,MAAM,uBAAuB,EAAE,MAAM,CAAC,EAAE,CAAC;AAE3F;;;GAGG;AACH,MAAM,MAAM,uBAAuB,GAAG,+BAA+B,GAAG,mBAAmB,CAAC;AAE5F;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,MAAM,wBAAwB,GAAG,OAAO,CAAC,MAAM,CAAC,uBAAuB,EAAE,sBAAsB,CAAC,CAAC,GACrG,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC;AAEzC;;;;;;GAMG;AACH,MAAM,WAAW,oBAAoB;IACnC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,uFAAuF;IACvF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,sDAAsD;IACtD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,oBAAoB,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAC9C,0BAA0B;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+EAA+E;IAC/E,IAAI,CAAC,EAAE,uBAAuB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACzD,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB"}

package/dist/orderbook/aggregate.d.ts

@@ -0,0 +1,80 @@
+import { Orderbook, OrderbookDepthLevel, OrderbookDepthSummary, OrderbookLevel, OrderbookSpread } from './types.js';
+/**
+ * Collapse a book onto a coarser price grid.
+ *
+ * Bids round **down** and asks round **up**, so a grouped level never claims
+ * liquidity at a better price than actually rests there — a bid group labelled
+ * `63018.0` holds orders from `63018.0` up to just under the next tick, all of
+ * which a seller can hit at `63018.0` or better.
+ *
+ * Level ordering is preserved: bids stay descending, asks ascending.
+ *
+ * @param orderbook - The book to group.
+ * @param tickSize - Grid spacing. Must be positive.
+ * @returns A new book on the coarser grid. `lastUpdateId`, `timestamp`, and
+ *   `marketName` are carried through unchanged.
+ * @throws {SymmError} when `tickSize` is not a positive finite number.
+ *
+ * @example
+ * ```ts
+ * const grouped = groupOrderbook(book, 1);
+ * // levels at 63018.1 / 63018.4 / 63018.9 collapse into one ask at 63019
+ * ```
+ */
+export declare function groupOrderbook(orderbook: Orderbook, tickSize: number): Orderbook;
+/**
+ * Annotate each level with the depth resting at or better than it.
+ *
+ * Totals are **inclusive** of the level's own size. That matters: an exclusive
+ * running total leaves the best bid and best ask reading `0`, and normalizing
+ * a depth bar against it silently understates every row by one level's size.
+ *
+ * @param levels - One side of a book, best price first.
+ * @returns The same levels with `total` and `totalQuote` attached.
+ *
+ * @example
+ * ```ts
+ * accumulateOrderbook([
+ *   { price: 100, size: 2 },
+ *   { price: 99, size: 3 },
+ * ]);
+ * // [{ price: 100, size: 2, total: 2, totalQuote: 200 },
+ * //  { price: 99, size: 3, total: 5, totalQuote: 497 }]
+ * ```
+ */
+export declare function accumulateOrderbook(levels: readonly OrderbookLevel[]): OrderbookDepthLevel[];
+/**
+ * Best prices and the gap between them.
+ *
+ * @param orderbook - The book to measure.
+ * @returns The spread, or `undefined` when either side is empty — a one-sided
+ *   book has no spread, and reporting `0` would read as a locked market.
+ *
+ * @example
+ * ```ts
+ * const spread = getOrderbookSpread(book);
+ * if (spread) console.log(`${spread.spread} (${spread.spreadBps.toFixed(1)} bps)`);
+ * ```
+ */
+export declare function getOrderbookSpread(orderbook: Orderbook): OrderbookSpread | undefined;
+/**
+ * Measure the depth resting within a price band around the mid.
+ *
+ * More robust than top-of-book size: a single large order five percent away
+ * moves top-of-book not at all and this figure not at all, while a wall of
+ * small orders next to the mid moves this a lot. The `imbalance` it returns is
+ * the usual read on which side is leaning.
+ *
+ * @param orderbook - The book to measure.
+ * @param percent - Half-width of the band as a fraction of mid (`0.01` = ±1%).
+ * @returns Per-side size, notional, and imbalance. All zero when the book has
+ *   no mid (one side empty).
+ *
+ * @example
+ * ```ts
+ * const { imbalance } = getOrderbookDepthWithin(book, 0.01);
+ * // imbalance > 0 → more bid notional than ask within ±1% of mid
+ * ```
+ */
+export declare function getOrderbookDepthWithin(orderbook: Orderbook, percent: number): OrderbookDepthSummary;
+//# sourceMappingURL=aggregate.d.ts.map

package/dist/orderbook/aggregate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aggregate.d.ts","sourceRoot":"","sources":["../../src/orderbook/aggregate.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAEtH;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,SAAS,CAMhF;AAiBD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,cAAc,EAAE,GAAG,mBAAmB,EAAE,CAS5F;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,SAAS,GAAG,eAAe,GAAG,SAAS,CAiBpF;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,qBAAqB,CA2CpG"}

package/dist/orderbook/aggregate.js

@@ -0,0 +1,74 @@
+import { roundToTick as e } from "./tick-size.js";
+//#region src/orderbook/aggregate.ts
+function t(e, t) {
+	return {
+		...e,
+		bids: n(e.bids, t, "down"),
+		asks: n(e.asks, t, "up")
+	};
+}
+function n(t, n, r) {
+	let i = /* @__PURE__ */ new Map();
+	for (let a of t) {
+		let t = e(a.price, n, r);
+		i.set(t, (i.get(t) ?? 0) + a.size);
+	}
+	return Array.from(i, ([e, t]) => ({
+		price: e,
+		size: t
+	}));
+}
+function r(e) {
+	let t = 0, n = 0;
+	return e.map((e) => (t += e.size, n += e.price * e.size, {
+		...e,
+		total: t,
+		totalQuote: n
+	}));
+}
+function i(e) {
+	let t = e.bids[0]?.price, n = e.asks[0]?.price;
+	if (t === void 0 || n === void 0) return;
+	let r = (t + n) / 2, i = n - t;
+	return {
+		bestBid: t,
+		bestAsk: n,
+		spread: i,
+		spreadBps: r > 0 ? i / r * 1e4 : 0,
+		midPrice: r
+	};
+}
+function a(e, t) {
+	let n = {
+		percent: t,
+		bidSize: 0,
+		askSize: 0,
+		bidQuote: 0,
+		askQuote: 0,
+		imbalance: 0
+	}, r = i(e);
+	if (!r) return n;
+	let a = r.midPrice * (1 - t), o = r.midPrice * (1 + t), s = 0, c = 0;
+	for (let t of e.bids) {
+		if (t.price < a) break;
+		s += t.size, c += t.price * t.size;
+	}
+	let l = 0, u = 0;
+	for (let t of e.asks) {
+		if (t.price > o) break;
+		l += t.size, u += t.price * t.size;
+	}
+	let d = c + u;
+	return {
+		percent: t,
+		bidSize: s,
+		askSize: l,
+		bidQuote: c,
+		askQuote: u,
+		imbalance: d > 0 ? (c - u) / d : 0
+	};
+}
+//#endregion
+export { r as accumulateOrderbook, a as getOrderbookDepthWithin, i as getOrderbookSpread, t as groupOrderbook };
+
+//# sourceMappingURL=aggregate.js.map