@symmio/trading-core 1.1.0 → 3.0.0

package/README.md

@@ -19,9 +19,9 @@ viem is a peer dependency.
 ```ts
 import { createConfig, getMarkets } from "@symmio/trading-core";
 import { createPublicClient, http } from "viem";
-import { hyperEvm } from "viem/chains";
+import { arbitrum } from "viem/chains";
 
-const publicClient = createPublicClient({ chain: hyperEvm, transport: http() });
+const publicClient = createPublicClient({ chain: arbitrum, transport: http() });
 
 const config = createConfig({
   getClient: () => publicClient,

package/dist/balance-history/get-balance-history/types.d.ts

@@ -69,7 +69,7 @@ export type InternalTransfersMode =
  * @remarks
  * `amount` is a raw `bigint` in the **collateral token's decimals** (not 18) —
  * scale it with `config.getChainConfig(chainId).addresses.collateralDecimals`
- * (6 on HyperEVM) for display.
+ * (6 on Arbitrum) for display.
  */
 export interface BalanceHistoryRow {
     /** Subgraph entity id (use as a stable row key). */

package/dist/balance-history/get-balance-history/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","names":[],"sources":["../../../src/balance-history/get-balance-history/types.ts"],"sourcesContent":["import type { Address, Hex } from \"viem\";\n\n/**\n * Subgraph `BalanceChange.type` values for the collateral movements that make up\n * deposit / withdraw history.\n *\n * @remarks\n * Mirrors the `type` strings emitted by the SYMMIO analytics subgraph. The\n * subgraph also emits margin moves (`ALLOCATE` / `DEALLOCATE`); those are out of\n * scope for this slice and are never returned by {@link \"getBalanceHistory\"}.\n */\nexport enum BalanceChangeType {\n  /** Collateral deposited into a sub-account. */\n  Deposit = \"DEPOSIT\",\n  /** Collateral withdrawn from a sub-account. */\n  Withdraw = \"WITHDRAW\",\n  /** A withdraw routed through a bridge (instant / CCTP). Treated as a withdraw. */\n  Bridge = \"BRIDGE\",\n}\n\n/**\n * Filter selecting which movements a {@link \"getBalanceHistory\"} read returns.\n * Maps to the subgraph `type_in` clause via {@link \"balanceHistoryFilterToTypes\"}.\n */\nexport enum BalanceHistoryFilter {\n  /** Deposits and withdraws (including bridge withdraws). */\n  All = \"All\",\n  /** Deposits only. */\n  Deposit = \"Deposit\",\n  /** Withdraws, including bridge withdraws. */\n  Withdraw = \"Withdraw\",\n}\n\n/**\n * The kind of margin transfer an internal-transfer leg belongs to (subgraph\n * `BalanceChange.marginTransferType`). Present only on rows where\n * {@link BalanceHistoryRow.isInternalTransfer} is `true`.\n *\n * @remarks\n * A margin transfer moves collateral between a user's own SubAccount and one of\n * its Virtual Accounts; it expands into a cluster of primitive balance legs that\n * carry this tag (verified against the live analytics subgraph).\n */\nexport enum MarginTransferType {\n  /** Funding a Virtual Account's margin from the SubAccount. */\n  Add = \"ADD\",\n  /** Pulling margin out of a Virtual Account back to the SubAccount. */\n  Remove = \"REMOVE\",\n  /** Margin automatically returned to the SubAccount (e.g. on close / deallocate). */\n  AutoReturn = \"AUTO_RETURN\",\n}\n\n/**\n * How a {@link \"getBalanceHistory\"} read treats **internal margin-transfer legs**\n * — the `WITHDRAW` / `DEPOSIT` rows that are bookkeeping side effects of moving\n * margin between a user's own accounts, not real collateral movements in or out\n * of the protocol. Maps to the subgraph `isMarginTransferSideEffect` filter.\n *\n * @remarks\n * Orthogonal to {@link BalanceHistoryFilter} (which chooses deposit vs withdraw):\n * `filter` picks the direction, `internalTransfers` picks real-vs-transfer.\n */\nexport type InternalTransfersMode =\n  /** Only genuine user deposits / withdrawals (`isMarginTransferSideEffect: false`). The default. */\n  | \"exclude\"\n  /** Only internal-transfer legs (`isMarginTransferSideEffect: true`). */\n  | \"only\"\n  /** Both — no constraint on `isMarginTransferSideEffect`. */\n  | \"include\";\n\n/**\n * One settled collateral movement (deposit or withdraw) on a sub-account.\n *\n * @remarks\n * `amount` is a raw `bigint` in the **collateral token's decimals** (not 18) —\n * scale it with `config.getChainConfig(chainId).addresses.collateralDecimals`\n * (6 on HyperEVM) for display.\n */\nexport interface BalanceHistoryRow {\n  /** Subgraph entity id (use as a stable row key). */\n  id: string;\n  /** Movement kind, decoded from the subgraph `type`. */\n  type: BalanceChangeType;\n  /** Amount, raw `bigint` in collateral decimals. */\n  amount: bigint;\n  /** The sub-account the movement belongs to. */\n  account: Address;\n  /** Block timestamp, unix seconds. */\n  timestamp: number;\n  /** Transaction hash of the movement. */\n  transaction: Hex;\n  /**\n   * `true` when this row is an internal margin-transfer leg (a side effect of\n   * moving margin between the user's own SubAccount and a Virtual Account) rather\n   * than a real user deposit / withdrawal. Always `false` under the default\n   * `internalTransfers: \"exclude\"`; only meaningful when transfers are included.\n   */\n  isInternalTransfer: boolean;\n  /** The margin-transfer kind when {@link isInternalTransfer} is `true`; otherwise `null`. */\n  marginTransferType: MarginTransferType | null;\n}\n"],"mappings":";AAWA,IAAY,IAAL,yBAAA,GAAA;QAEL,EAAA,UAAA,WAEA,EAAA,WAAA,YAEA,EAAA,SAAA;AACF,EAAA,CAAA,CAAA,GAMY,IAAL,yBAAA,GAAA;QAEL,EAAA,MAAA,OAEA,EAAA,UAAA,WAEA,EAAA,WAAA;AACF,EAAA,CAAA,CAAA,GAYY,IAAL,yBAAA,GAAA;QAEL,EAAA,MAAA,OAEA,EAAA,SAAA,UAEA,EAAA,aAAA;AACF,EAAA,CAAA,CAAA"}
+{"version":3,"file":"types.js","names":[],"sources":["../../../src/balance-history/get-balance-history/types.ts"],"sourcesContent":["import type { Address, Hex } from \"viem\";\n\n/**\n * Subgraph `BalanceChange.type` values for the collateral movements that make up\n * deposit / withdraw history.\n *\n * @remarks\n * Mirrors the `type` strings emitted by the SYMMIO analytics subgraph. The\n * subgraph also emits margin moves (`ALLOCATE` / `DEALLOCATE`); those are out of\n * scope for this slice and are never returned by {@link \"getBalanceHistory\"}.\n */\nexport enum BalanceChangeType {\n  /** Collateral deposited into a sub-account. */\n  Deposit = \"DEPOSIT\",\n  /** Collateral withdrawn from a sub-account. */\n  Withdraw = \"WITHDRAW\",\n  /** A withdraw routed through a bridge (instant / CCTP). Treated as a withdraw. */\n  Bridge = \"BRIDGE\",\n}\n\n/**\n * Filter selecting which movements a {@link \"getBalanceHistory\"} read returns.\n * Maps to the subgraph `type_in` clause via {@link \"balanceHistoryFilterToTypes\"}.\n */\nexport enum BalanceHistoryFilter {\n  /** Deposits and withdraws (including bridge withdraws). */\n  All = \"All\",\n  /** Deposits only. */\n  Deposit = \"Deposit\",\n  /** Withdraws, including bridge withdraws. */\n  Withdraw = \"Withdraw\",\n}\n\n/**\n * The kind of margin transfer an internal-transfer leg belongs to (subgraph\n * `BalanceChange.marginTransferType`). Present only on rows where\n * {@link BalanceHistoryRow.isInternalTransfer} is `true`.\n *\n * @remarks\n * A margin transfer moves collateral between a user's own SubAccount and one of\n * its Virtual Accounts; it expands into a cluster of primitive balance legs that\n * carry this tag (verified against the live analytics subgraph).\n */\nexport enum MarginTransferType {\n  /** Funding a Virtual Account's margin from the SubAccount. */\n  Add = \"ADD\",\n  /** Pulling margin out of a Virtual Account back to the SubAccount. */\n  Remove = \"REMOVE\",\n  /** Margin automatically returned to the SubAccount (e.g. on close / deallocate). */\n  AutoReturn = \"AUTO_RETURN\",\n}\n\n/**\n * How a {@link \"getBalanceHistory\"} read treats **internal margin-transfer legs**\n * — the `WITHDRAW` / `DEPOSIT` rows that are bookkeeping side effects of moving\n * margin between a user's own accounts, not real collateral movements in or out\n * of the protocol. Maps to the subgraph `isMarginTransferSideEffect` filter.\n *\n * @remarks\n * Orthogonal to {@link BalanceHistoryFilter} (which chooses deposit vs withdraw):\n * `filter` picks the direction, `internalTransfers` picks real-vs-transfer.\n */\nexport type InternalTransfersMode =\n  /** Only genuine user deposits / withdrawals (`isMarginTransferSideEffect: false`). The default. */\n  | \"exclude\"\n  /** Only internal-transfer legs (`isMarginTransferSideEffect: true`). */\n  | \"only\"\n  /** Both — no constraint on `isMarginTransferSideEffect`. */\n  | \"include\";\n\n/**\n * One settled collateral movement (deposit or withdraw) on a sub-account.\n *\n * @remarks\n * `amount` is a raw `bigint` in the **collateral token's decimals** (not 18) —\n * scale it with `config.getChainConfig(chainId).addresses.collateralDecimals`\n * (6 on Arbitrum) for display.\n */\nexport interface BalanceHistoryRow {\n  /** Subgraph entity id (use as a stable row key). */\n  id: string;\n  /** Movement kind, decoded from the subgraph `type`. */\n  type: BalanceChangeType;\n  /** Amount, raw `bigint` in collateral decimals. */\n  amount: bigint;\n  /** The sub-account the movement belongs to. */\n  account: Address;\n  /** Block timestamp, unix seconds. */\n  timestamp: number;\n  /** Transaction hash of the movement. */\n  transaction: Hex;\n  /**\n   * `true` when this row is an internal margin-transfer leg (a side effect of\n   * moving margin between the user's own SubAccount and a Virtual Account) rather\n   * than a real user deposit / withdrawal. Always `false` under the default\n   * `internalTransfers: \"exclude\"`; only meaningful when transfers are included.\n   */\n  isInternalTransfer: boolean;\n  /** The margin-transfer kind when {@link isInternalTransfer} is `true`; otherwise `null`. */\n  marginTransferType: MarginTransferType | null;\n}\n"],"mappings":";AAWA,IAAY,IAAL,yBAAA,GAAA;QAEL,EAAA,UAAA,WAEA,EAAA,WAAA,YAEA,EAAA,SAAA;AACF,EAAA,CAAA,CAAA,GAMY,IAAL,yBAAA,GAAA;QAEL,EAAA,MAAA,OAEA,EAAA,UAAA,WAEA,EAAA,WAAA;AACF,EAAA,CAAA,CAAA,GAYY,IAAL,yBAAA,GAAA;QAEL,EAAA,MAAA,OAEA,EAAA,SAAA,UAEA,EAAA,aAAA;AACF,EAAA,CAAA,CAAA"}

package/dist/candles/adapters/tradingview/index.d.ts

@@ -0,0 +1,4 @@
+export * from './map-resolution.js';
+export * from './to-tradingview-datafeed.js';
+export * from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/candles/adapters/tradingview/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/candles/adapters/tradingview/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,SAAS,CAAC"}

package/dist/candles/adapters/tradingview/map-resolution.d.ts

@@ -0,0 +1,26 @@
+import { CandleResolution } from '../../types.js';
+/**
+ * Translate a TradingView resolution code into an SDK resolution.
+ *
+ * @param resolution - The code the charting library passed (e.g. `"240"`).
+ * @returns The SDK resolution, or `undefined` when the code is unrecognized.
+ *
+ * @example
+ * ```ts
+ * fromTradingViewResolution("60"); // "1h"
+ * ```
+ */
+export declare function fromTradingViewResolution(resolution: string): CandleResolution | undefined;
+/**
+ * Translate an SDK resolution into the TradingView code to advertise for it.
+ *
+ * @param resolution - The SDK resolution.
+ * @returns The TradingView code (e.g. `"1h"` → `"60"`).
+ *
+ * @example
+ * ```ts
+ * toTradingViewResolution("1h"); // "60"
+ * ```
+ */
+export declare function toTradingViewResolution(resolution: CandleResolution): string;
+//# sourceMappingURL=map-resolution.d.ts.map

package/dist/candles/adapters/tradingview/map-resolution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"map-resolution.d.ts","sourceRoot":"","sources":["../../../../src/candles/adapters/tradingview/map-resolution.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AA4DpD;;;;;;;;;;GAUG;AACH,wBAAgB,yBAAyB,CAAC,UAAU,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS,CAE1F;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,gBAAgB,GAAG,MAAM,CAE5E"}

package/dist/candles/adapters/tradingview/map-resolution.js

@@ -0,0 +1,51 @@
+//#region src/candles/adapters/tradingview/map-resolution.ts
+var e = {
+	"1S": "1s",
+	"10S": "10s",
+	1: "1m",
+	3: "3m",
+	5: "5m",
+	15: "15m",
+	30: "30m",
+	60: "1h",
+	120: "2h",
+	240: "4h",
+	360: "6h",
+	480: "8h",
+	720: "12h",
+	D: "1d",
+	"1D": "1d",
+	"3D": "3d",
+	W: "1w",
+	"1W": "1w",
+	M: "1M",
+	"1M": "1M"
+}, t = {
+	"1s": "1S",
+	"10s": "10S",
+	"1m": "1",
+	"3m": "3",
+	"5m": "5",
+	"15m": "15",
+	"30m": "30",
+	"1h": "60",
+	"2h": "120",
+	"4h": "240",
+	"6h": "360",
+	"8h": "480",
+	"12h": "720",
+	"1d": "1D",
+	"3d": "3D",
+	"1w": "1W",
+	"1M": "1M"
+};
+function n(t) {
+	return e[t];
+}
+function r(e) {
+	return t[e];
+}
+//#endregion
+export { n as fromTradingViewResolution, r as toTradingViewResolution };
+
+//# sourceMappingURL=map-resolution.js.map

package/dist/candles/adapters/tradingview/map-resolution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"map-resolution.js","names":[],"sources":["../../../../src/candles/adapters/tradingview/map-resolution.ts"],"sourcesContent":["import type { CandleResolution } from \"../../types\";\n\n/**\n * TradingView resolution code → SDK {@link CandleResolution}.\n *\n * TradingView encodes intraday resolutions as bare minute counts (`\"60\"` is one\n * hour), seconds with an `S` suffix, and days/weeks/months with a letter. The\n * bare-letter forms (`\"D\"`, `\"W\"`, `\"M\"`) are accepted alongside the numbered\n * ones because the library emits both depending on how the chart was configured.\n */\nconst FROM_TRADINGVIEW: Record<string, CandleResolution> = {\n  \"1S\": \"1s\",\n  \"10S\": \"10s\",\n  \"1\": \"1m\",\n  \"3\": \"3m\",\n  \"5\": \"5m\",\n  \"15\": \"15m\",\n  \"30\": \"30m\",\n  \"60\": \"1h\",\n  \"120\": \"2h\",\n  \"240\": \"4h\",\n  \"360\": \"6h\",\n  \"480\": \"8h\",\n  \"720\": \"12h\",\n  D: \"1d\",\n  \"1D\": \"1d\",\n  \"3D\": \"3d\",\n  W: \"1w\",\n  \"1W\": \"1w\",\n  M: \"1M\",\n  \"1M\": \"1M\",\n};\n\n/**\n * SDK {@link CandleResolution} → the TradingView code to advertise for it.\n *\n * The inverse of {@link FROM_TRADINGVIEW}, but not derived from it: that map is\n * intentionally many-to-one (`\"D\"` and `\"1D\"` both mean a day) and only one\n * spelling should appear in `supported_resolutions`.\n */\nconst TO_TRADINGVIEW: Record<CandleResolution, string> = {\n  \"1s\": \"1S\",\n  \"10s\": \"10S\",\n  \"1m\": \"1\",\n  \"3m\": \"3\",\n  \"5m\": \"5\",\n  \"15m\": \"15\",\n  \"30m\": \"30\",\n  \"1h\": \"60\",\n  \"2h\": \"120\",\n  \"4h\": \"240\",\n  \"6h\": \"360\",\n  \"8h\": \"480\",\n  \"12h\": \"720\",\n  \"1d\": \"1D\",\n  \"3d\": \"3D\",\n  \"1w\": \"1W\",\n  \"1M\": \"1M\",\n};\n\n/**\n * Translate a TradingView resolution code into an SDK resolution.\n *\n * @param resolution - The code the charting library passed (e.g. `\"240\"`).\n * @returns The SDK resolution, or `undefined` when the code is unrecognized.\n *\n * @example\n * ```ts\n * fromTradingViewResolution(\"60\"); // \"1h\"\n * ```\n */\nexport function fromTradingViewResolution(resolution: string): CandleResolution | undefined {\n  return FROM_TRADINGVIEW[resolution];\n}\n\n/**\n * Translate an SDK resolution into the TradingView code to advertise for it.\n *\n * @param resolution - The SDK resolution.\n * @returns The TradingView code (e.g. `\"1h\"` → `\"60\"`).\n *\n * @example\n * ```ts\n * toTradingViewResolution(\"1h\"); // \"60\"\n * ```\n */\nexport function toTradingViewResolution(resolution: CandleResolution): string {\n  return TO_TRADINGVIEW[resolution];\n}\n"],"mappings":";AAUA,IAAM,IAAqD;CACzD,MAAM;CACN,OAAO;CACP,GAAK;CACL,GAAK;CACL,GAAK;CACL,IAAM;CACN,IAAM;CACN,IAAM;CACN,KAAO;CACP,KAAO;CACP,KAAO;CACP,KAAO;CACP,KAAO;CACP,GAAG;CACH,MAAM;CACN,MAAM;CACN,GAAG;CACH,MAAM;CACN,GAAG;CACH,MAAM;AACR,GASM,IAAmD;CACvD,MAAM;CACN,OAAO;CACP,MAAM;CACN,MAAM;CACN,MAAM;CACN,OAAO;CACP,OAAO;CACP,MAAM;CACN,MAAM;CACN,MAAM;CACN,MAAM;CACN,MAAM;CACN,OAAO;CACP,MAAM;CACN,MAAM;CACN,MAAM;CACN,MAAM;AACR;AAaA,SAAgB,EAA0B,GAAkD;CAC1F,OAAO,EAAiB;AAC1B;AAaA,SAAgB,EAAwB,GAAsC;CAC5E,OAAO,EAAe;AACxB"}

package/dist/candles/adapters/tradingview/to-tradingview-datafeed.d.ts

@@ -0,0 +1,48 @@
+import { CandleSource } from '../../types.js';
+import { TradingViewDatafeed } from './types.js';
+/**
+ * Options for {@link toTradingViewDatafeed}.
+ */
+export interface ToTradingViewDatafeedOptions {
+    /**
+     * Exchange label shown in the chart's symbol header. Defaults to the source's
+     * {@link CandleSource.id}.
+     */
+    exchange?: string;
+    /**
+     * Session string for the instrument. Defaults to `"24x7"` — correct for
+     * crypto perps, which never close.
+     */
+    session?: string;
+    /**
+     * Timezone the chart renders bar times in. Defaults to `"Etc/UTC"`, matching
+     * the UTC-aligned bar boundaries every source returns.
+     */
+    timezone?: string;
+}
+/**
+ * Adapt a {@link CandleSource} into a TradingView Charting Library datafeed.
+ *
+ * A pure translation layer: resolution codes, unix-second period params, and
+ * the library's callback style on one side; the SDK's resolution vocabulary,
+ * millisecond timestamps, and promise/`Unwatch` style on the other. It holds no
+ * framework state and imports nothing from TradingView — the datafeed contract
+ * is modeled structurally, so the returned object satisfies the library's own
+ * `IBasicDataFeed` type without the SDK depending on the licensed package.
+ *
+ * Symbol search is reported as unsupported. A SYMMIO app already has its market
+ * list (`useMarkets`), and driving symbol selection from that is both more
+ * accurate and less surprising than a second search surface here.
+ *
+ * @param source - The candle source to read from.
+ * @param options - Presentation overrides for the symbol header.
+ * @returns A datafeed object to pass to `widget({ datafeed })`.
+ *
+ * @example
+ * ```ts
+ * const datafeed = toTradingViewDatafeed(createBinanceCandleSource());
+ * new TradingView.widget({ datafeed, symbol: "BTCUSDT", interval: "60" });
+ * ```
+ */
+export declare function toTradingViewDatafeed(source: CandleSource, options?: ToTradingViewDatafeedOptions): TradingViewDatafeed;
+//# sourceMappingURL=to-tradingview-datafeed.d.ts.map

package/dist/candles/adapters/tradingview/to-tradingview-datafeed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"to-tradingview-datafeed.d.ts","sourceRoot":"","sources":["../../../../src/candles/adapters/tradingview/to-tradingview-datafeed.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,OAAO,KAAK,EAAkB,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAEnE;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AA0BD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,YAAY,EACpB,OAAO,GAAE,4BAAiC,GACzC,mBAAmB,CA4IrB"}

package/dist/candles/adapters/tradingview/to-tradingview-datafeed.js

@@ -0,0 +1,115 @@
+import { fromTradingViewResolution as e, toTradingViewResolution as t } from "./map-resolution.js";
+import { resolutionToMs as n } from "../../resolution.js";
+//#region src/candles/adapters/tradingview/to-tradingview-datafeed.ts
+function r(e) {
+	let t = e.indexOf(":");
+	return t === -1 ? e : e.slice(t + 1);
+}
+function i(e) {
+	return {
+		time: e.time,
+		open: e.open,
+		high: e.high,
+		low: e.low,
+		close: e.close,
+		volume: e.volume
+	};
+}
+function a(a, o = {}) {
+	let s = o.exchange ?? a.id, c = o.session ?? "24x7", l = o.timezone ?? "Etc/UTC", u = a.supportedResolutions.map(t), d = a.supportedResolutions.filter((e) => e === "1s" || e === "10s").map((e) => e === "1s" ? "1" : "10"), f = /* @__PURE__ */ new Map();
+	return {
+		onReady(e) {
+			setTimeout(() => {
+				e({
+					supported_resolutions: u,
+					exchanges: [{
+						value: s,
+						name: s,
+						desc: s
+					}],
+					symbols_types: [{
+						name: "crypto",
+						value: "crypto"
+					}],
+					supports_search: !1,
+					supports_group_request: !1
+				});
+			}, 0);
+		},
+		searchSymbols(e, t, n, r) {
+			r([]);
+		},
+		resolveSymbol(e, t, n) {
+			let i = r(e);
+			a.getSymbol(i).then((r) => {
+				if (!r) {
+					n(`Unknown symbol: ${e}`);
+					return;
+				}
+				t({
+					ticker: r.marketName,
+					name: r.marketName,
+					full_name: r.marketName,
+					description: r.description,
+					type: "crypto",
+					session: c,
+					timezone: l,
+					exchange: s,
+					listed_exchange: s,
+					format: "price",
+					pricescale: 10 ** r.pricePrecision,
+					minmov: 1,
+					has_intraday: !0,
+					has_daily: !0,
+					has_weekly_and_monthly: !0,
+					has_seconds: d.length > 0,
+					has_empty_bars: !1,
+					supported_resolutions: u,
+					...d.length > 0 ? { seconds_multipliers: d } : {},
+					volume_precision: r.volumePrecision,
+					data_status: a.watchCandles ? "streaming" : "endofday"
+				});
+			}).catch((e) => {
+				n(e instanceof Error ? e.message : String(e));
+			});
+		},
+		getBars(t, r, o, s, c) {
+			let l = e(r);
+			if (!l) {
+				c(`Unsupported resolution: ${r}`);
+				return;
+			}
+			let { from: u, to: d, countBack: f } = o, p = d * 1e3, m = Math.min(u * 1e3, p - f * n(l));
+			a.getCandles({
+				marketName: t.name,
+				resolution: l,
+				from: m,
+				to: p,
+				limit: f
+			}).then((e) => {
+				s(e.candles.map(i), { noData: e.noMoreData });
+			}).catch((e) => {
+				c(e instanceof Error ? e.message : String(e));
+			});
+		},
+		subscribeBars(t, n, r, o, s) {
+			let c = e(n);
+			if (!c || !a.watchCandles) return;
+			f.get(o)?.();
+			let l = a.watchCandles({
+				marketName: t.name,
+				resolution: c,
+				onCandle: (e) => r(i(e)),
+				onReset: s
+			});
+			f.set(o, l);
+		},
+		unsubscribeBars(e) {
+			f.get(e)?.(), f.delete(e);
+		}
+	};
+}
+//#endregion
+export { a as toTradingViewDatafeed };
+
+//# sourceMappingURL=to-tradingview-datafeed.js.map

package/dist/candles/adapters/tradingview/to-tradingview-datafeed.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"to-tradingview-datafeed.js","names":[],"sources":["../../../../src/candles/adapters/tradingview/to-tradingview-datafeed.ts"],"sourcesContent":["import type { Unwatch } from \"../../../websocket/notifications/watch-notifications\";\nimport { resolutionToMs } from \"../../resolution\";\nimport type { CandleSource } from \"../../types\";\nimport { fromTradingViewResolution, toTradingViewResolution } from \"./map-resolution\";\nimport type { TradingViewBar, TradingViewDatafeed } from \"./types\";\n\n/**\n * Options for {@link toTradingViewDatafeed}.\n */\nexport interface ToTradingViewDatafeedOptions {\n  /**\n   * Exchange label shown in the chart's symbol header. Defaults to the source's\n   * {@link CandleSource.id}.\n   */\n  exchange?: string;\n  /**\n   * Session string for the instrument. Defaults to `\"24x7\"` — correct for\n   * crypto perps, which never close.\n   */\n  session?: string;\n  /**\n   * Timezone the chart renders bar times in. Defaults to `\"Etc/UTC\"`, matching\n   * the UTC-aligned bar boundaries every source returns.\n   */\n  timezone?: string;\n}\n\n/** Strips an exchange prefix, so `\"BINANCE:BTCUSDT\"` resolves as `\"BTCUSDT\"`. */\nfunction toMarketName(symbolName: string): string {\n  const separatorIndex = symbolName.indexOf(\":\");\n  return separatorIndex === -1 ? symbolName : symbolName.slice(separatorIndex + 1);\n}\n\nfunction toTradingViewBar(candle: {\n  time: number;\n  open: number;\n  high: number;\n  low: number;\n  close: number;\n  volume: number;\n}): TradingViewBar {\n  return {\n    time: candle.time,\n    open: candle.open,\n    high: candle.high,\n    low: candle.low,\n    close: candle.close,\n    volume: candle.volume,\n  };\n}\n\n/**\n * Adapt a {@link CandleSource} into a TradingView Charting Library datafeed.\n *\n * A pure translation layer: resolution codes, unix-second period params, and\n * the library's callback style on one side; the SDK's resolution vocabulary,\n * millisecond timestamps, and promise/`Unwatch` style on the other. It holds no\n * framework state and imports nothing from TradingView — the datafeed contract\n * is modeled structurally, so the returned object satisfies the library's own\n * `IBasicDataFeed` type without the SDK depending on the licensed package.\n *\n * Symbol search is reported as unsupported. A SYMMIO app already has its market\n * list (`useMarkets`), and driving symbol selection from that is both more\n * accurate and less surprising than a second search surface here.\n *\n * @param source - The candle source to read from.\n * @param options - Presentation overrides for the symbol header.\n * @returns A datafeed object to pass to `widget({ datafeed })`.\n *\n * @example\n * ```ts\n * const datafeed = toTradingViewDatafeed(createBinanceCandleSource());\n * new TradingView.widget({ datafeed, symbol: \"BTCUSDT\", interval: \"60\" });\n * ```\n */\nexport function toTradingViewDatafeed(\n  source: CandleSource,\n  options: ToTradingViewDatafeedOptions = {},\n): TradingViewDatafeed {\n  const exchange = options.exchange ?? source.id;\n  const session = options.session ?? \"24x7\";\n  const timezone = options.timezone ?? \"Etc/UTC\";\n\n  const supportedResolutions = source.supportedResolutions.map(toTradingViewResolution);\n  const secondsMultipliers = source.supportedResolutions\n    .filter((resolution) => resolution === \"1s\" || resolution === \"10s\")\n    .map((resolution) => (resolution === \"1s\" ? \"1\" : \"10\"));\n\n  /** Live subscriptions keyed by the library's listener guid. */\n  const subscriptions = new Map<string, Unwatch>();\n\n  return {\n    onReady(callback) {\n      /**\n       * The library requires `onReady` to resolve asynchronously; calling the\n       * callback synchronously puts it into an inconsistent startup state.\n       */\n      setTimeout(() => {\n        callback({\n          supported_resolutions: supportedResolutions,\n          exchanges: [{ value: exchange, name: exchange, desc: exchange }],\n          symbols_types: [{ name: \"crypto\", value: \"crypto\" }],\n          supports_search: false,\n          supports_group_request: false,\n        });\n      }, 0);\n    },\n\n    searchSymbols(_userInput, _exchange, _symbolType, onResult) {\n      onResult([]);\n    },\n\n    resolveSymbol(symbolName, onResolve, onError) {\n      const marketName = toMarketName(symbolName);\n\n      source\n        .getSymbol(marketName)\n        .then((symbol) => {\n          if (!symbol) {\n            onError(`Unknown symbol: ${symbolName}`);\n            return;\n          }\n\n          onResolve({\n            ticker: symbol.marketName,\n            name: symbol.marketName,\n            full_name: symbol.marketName,\n            description: symbol.description,\n            type: \"crypto\",\n            session,\n            timezone,\n            exchange,\n            listed_exchange: exchange,\n            format: \"price\",\n            /** The library divides integer prices by this to place the decimal point. */\n            pricescale: 10 ** symbol.pricePrecision,\n            minmov: 1,\n            has_intraday: true,\n            has_daily: true,\n            has_weekly_and_monthly: true,\n            has_seconds: secondsMultipliers.length > 0,\n            /**\n             * `false` so the chart leaves real gaps rather than inventing flat\n             * bars where the venue reported none.\n             */\n            has_empty_bars: false,\n            supported_resolutions: supportedResolutions,\n            ...(secondsMultipliers.length > 0 ? { seconds_multipliers: secondsMultipliers } : {}),\n            volume_precision: symbol.volumePrecision,\n            data_status: source.watchCandles ? \"streaming\" : \"endofday\",\n          });\n        })\n        .catch((err: unknown) => {\n          onError(err instanceof Error ? err.message : String(err));\n        });\n    },\n\n    getBars(symbolInfo, resolution, periodParams, onResult, onError) {\n      const candleResolution = fromTradingViewResolution(resolution);\n      if (!candleResolution) {\n        onError(`Unsupported resolution: ${resolution}`);\n        return;\n      }\n\n      const { from, to, countBack } = periodParams;\n      const toMs = to * 1000;\n\n      /**\n       * `countBack` takes precedence over `from` in the library's contract: it\n       * is the exact number of bars the chart needs ending at `to`. Widening\n       * the window to at least that many bars keeps a short `from` from\n       * starving the chart, while still honoring an explicitly wider request.\n       */\n      const fromMs = Math.min(from * 1000, toMs - countBack * resolutionToMs(candleResolution));\n\n      source\n        .getCandles({\n          marketName: symbolInfo.name,\n          resolution: candleResolution,\n          from: fromMs,\n          to: toMs,\n          limit: countBack,\n        })\n        .then((result) => {\n          onResult(result.candles.map(toTradingViewBar), { noData: result.noMoreData });\n        })\n        .catch((err: unknown) => {\n          onError(err instanceof Error ? err.message : String(err));\n        });\n    },\n\n    subscribeBars(symbolInfo, resolution, onTick, listenerGuid, onResetCacheNeeded) {\n      const candleResolution = fromTradingViewResolution(resolution);\n      if (!candleResolution || !source.watchCandles) return;\n\n      /** Guard against the library re-subscribing a guid it never released. */\n      subscriptions.get(listenerGuid)?.();\n\n      const unwatch = source.watchCandles({\n        marketName: symbolInfo.name,\n        resolution: candleResolution,\n        onCandle: (candle) => onTick(toTradingViewBar(candle)),\n        /**\n         * A reconnect means bars were missed. Telling the library to drop its\n         * cache makes it refetch history instead of splicing the live bar onto\n         * a series with a hole in it.\n         */\n        onReset: onResetCacheNeeded,\n      });\n\n      subscriptions.set(listenerGuid, unwatch);\n    },\n\n    unsubscribeBars(listenerGuid) {\n      subscriptions.get(listenerGuid)?.();\n      subscriptions.delete(listenerGuid);\n    },\n  };\n}\n"],"mappings":"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"}

package/dist/candles/adapters/tradingview/types.d.ts

@@ -0,0 +1,102 @@
+/**
+ * Structural types for the slice of TradingView's Charting Library datafeed
+ * contract the SDK implements.
+ *
+ * Declared here rather than imported because the Charting Library is a licensed
+ * artifact a consumer self-hosts — it is not on npm, so the SDK cannot depend on
+ * its types without forcing every consumer to vendor it. These interfaces are
+ * structurally compatible with the real `IBasicDataFeed`, so the object
+ * {@link toTradingViewDatafeed} returns can be passed straight to `widget({
+ * datafeed })` and TypeScript accepts it against the library's own types.
+ *
+ * Only what a datafeed must provide is modeled. Fields the library passes but
+ * the SDK ignores are typed loosely on purpose.
+ */
+/** A bar in TradingView's shape. Note `time` is unix **milliseconds** here. */
+export interface TradingViewBar {
+    /** Bar open time, unix ms. */
+    time: number;
+    open: number;
+    high: number;
+    low: number;
+    close: number;
+    volume?: number;
+}
+/** Datafeed capabilities reported from `onReady`. */
+export interface TradingViewDatafeedConfiguration {
+    /** Resolution codes the chart may request, in the library's own vocabulary. */
+    supported_resolutions?: string[];
+    /** Exchanges offered in the symbol search dialog. */
+    exchanges?: {
+        value: string;
+        name: string;
+        desc: string;
+    }[];
+    /** Instrument types offered in the symbol search dialog. */
+    symbols_types?: {
+        name: string;
+        value: string;
+    }[];
+    /** Whether the library should call `searchSymbols`. */
+    supports_search?: boolean;
+    /** Whether the library may group requests by resolution. */
+    supports_group_request?: boolean;
+    /** Whether `getMarks` is implemented (bar-level annotations). */
+    supports_marks?: boolean;
+    /** Whether `getTimescaleMarks` is implemented (timescale annotations). */
+    supports_timescale_marks?: boolean;
+}
+/** Symbol metadata returned from `resolveSymbol`. */
+export interface TradingViewSymbolInfo {
+    ticker: string;
+    name: string;
+    full_name: string;
+    description: string;
+    type: string;
+    session: string;
+    timezone: string;
+    exchange: string;
+    listed_exchange: string;
+    format: string;
+    /** `10 ** pricePrecision` — the library divides by this to place the decimal point. */
+    pricescale: number;
+    /** Minimum price movement in `pricescale` units. */
+    minmov: number;
+    has_intraday: boolean;
+    has_daily: boolean;
+    has_weekly_and_monthly: boolean;
+    has_seconds: boolean;
+    has_empty_bars: boolean;
+    supported_resolutions: string[];
+    seconds_multipliers?: string[];
+    volume_precision: number;
+    data_status: string;
+}
+/** The range and bar count the library asks `getBars` for. */
+export interface TradingViewPeriodParams {
+    /** Range start, unix **seconds**. */
+    from: number;
+    /** Range end, unix **seconds**. */
+    to: number;
+    /** `true` on the initial load for a symbol/resolution. */
+    firstDataRequest: boolean;
+    /** Minimum bars the library needs, counting back from `to`. */
+    countBack: number;
+}
+/** Metadata accompanying a `getBars` result. */
+export interface TradingViewHistoryMetadata {
+    /** `true` when there is nothing older, so the library stops paging back. */
+    noData: boolean;
+}
+/**
+ * The datafeed object TradingView's `widget({ datafeed })` expects.
+ */
+export interface TradingViewDatafeed {
+    onReady(callback: (configuration: TradingViewDatafeedConfiguration) => void): void;
+    searchSymbols(userInput: string, exchange: string, symbolType: string, onResult: (symbols: unknown[]) => void): void;
+    resolveSymbol(symbolName: string, onResolve: (symbolInfo: TradingViewSymbolInfo) => void, onError: (reason: string) => void): void;
+    getBars(symbolInfo: TradingViewSymbolInfo, resolution: string, periodParams: TradingViewPeriodParams, onResult: (bars: TradingViewBar[], meta: TradingViewHistoryMetadata) => void, onError: (reason: string) => void): void;
+    subscribeBars(symbolInfo: TradingViewSymbolInfo, resolution: string, onTick: (bar: TradingViewBar) => void, listenerGuid: string, onResetCacheNeeded: () => void): void;
+    unsubscribeBars(listenerGuid: string): void;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/candles/adapters/tradingview/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/candles/adapters/tradingview/types.ts"],"names":[],"mappings":"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"}

package/dist/candles/index.d.ts

@@ -0,0 +1,6 @@
+export * from './adapters/tradingview/index.js';
+export * from './query.js';
+export * from './resolution.js';
+export * from './sources/binance/index.js';
+export * from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/candles/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/candles/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC;AACvC,cAAc,SAAS,CAAC;AACxB,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,SAAS,CAAC"}

package/dist/candles/query.d.ts

@@ -0,0 +1,58 @@
+import { Compute } from '../shared/types/properties.js';
+import { QueryParameter, SymmioQueryOptions } from '../shared/types/query.js';
+import { CandleSource, GetCandlesParameters, GetCandlesReturnType } from './types.js';
+/** Data resolved by the {@link getCandlesQueryOptions} query. */
+export type GetCandlesData = GetCandlesReturnType;
+/**
+ * The identifying half of {@link GetCandlesOptions}: everything that decides
+ * which bars are being asked for.
+ *
+ * `signal` is excluded — cancellation is TanStack's concern, not part of the
+ * request's identity.
+ */
+export type GetCandlesQueryKeyParameters = Compute<Omit<GetCandlesParameters, "signal"> & {
+    /** {@link CandleSource.id}, so two sources never share a cache entry. */
+    sourceId: string;
+}>;
+/**
+ * Build the TanStack Query key for {@link getCandlesQueryOptions}.
+ *
+ * @param options - Source id, market, resolution, and range.
+ * @returns A stable, hashable query key.
+ */
+export declare function getCandlesQueryKey(options: GetCandlesQueryKeyParameters): readonly ["getCandles", Record<string, unknown>];
+/** Query-key type produced by {@link getCandlesQueryKey}. */
+export type GetCandlesQueryKey = ReturnType<typeof getCandlesQueryKey>;
+/**
+ * Options accepted by {@link getCandlesQueryOptions}: the range to fetch plus
+ * TanStack overrides.
+ */
+export type GetCandlesOptions = Compute<Omit<GetCandlesParameters, "signal"> & QueryParameter<GetCandlesData, Error, GetCandlesData, GetCandlesQueryKey>>;
+/** TanStack Query options returned by {@link getCandlesQueryOptions}. */
+export type GetCandlesQueryOptions = SymmioQueryOptions<GetCandlesData, Error, GetCandlesData, GetCandlesQueryKey>;
+/**
+ * Build TanStack Query options for a {@link CandleSource}'s historical bars.
+ *
+ * Unlike the chain-scoped factories in the SDK, this takes a source rather than
+ * a {@link Config}: which venue to chart is the consumer's choice, not a
+ * property of the SYMMIO deployment. The source's `id` is folded into the query
+ * key so switching venues does not read another venue's cached bars.
+ *
+ * @param source - The candle source to read from.
+ * @param options - Market, resolution, range, and TanStack overrides.
+ * @returns Options to pass to `useQuery` / `queryClient.fetchQuery`.
+ *
+ * @example
+ * ```ts
+ * useQuery(
+ *   getCandlesQueryOptions(source, {
+ *     marketName: "BTCUSDT",
+ *     resolution: "1m",
+ *     from: Date.now() - 3_600_000,
+ *     to: Date.now(),
+ *   }),
+ * );
+ * ```
+ */
+export declare function getCandlesQueryOptions(source: CandleSource, options: GetCandlesOptions): GetCandlesQueryOptions;
+//# sourceMappingURL=query.d.ts.map

package/dist/candles/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../src/candles/query.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAEhF,OAAO,KAAK,EAAE,YAAY,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAExF,iEAAiE;AACjE,MAAM,MAAM,cAAc,GAAG,oBAAoB,CAAC;AAElD;;;;;;GAMG;AACH,MAAM,MAAM,4BAA4B,GAAG,OAAO,CAChD,IAAI,CAAC,oBAAoB,EAAE,QAAQ,CAAC,GAAG;IACrC,yEAAyE;IACzE,QAAQ,EAAE,MAAM,CAAC;CAClB,CACF,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,4BAA4B,oDAEvE;AAED,6DAA6D;AAC7D,MAAM,MAAM,kBAAkB,GAAG,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAEvE;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG,OAAO,CACrC,IAAI,CAAC,oBAAoB,EAAE,QAAQ,CAAC,GAAG,cAAc,CAAC,cAAc,EAAE,KAAK,EAAE,cAAc,EAAE,kBAAkB,CAAC,CACjH,CAAC;AAEF,yEAAyE;AACzE,MAAM,MAAM,sBAAsB,GAAG,kBAAkB,CAAC,cAAc,EAAE,KAAK,EAAE,cAAc,EAAE,kBAAkB,CAAC,CAAC;AAEnH;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,iBAAiB,GAAG,sBAAsB,CAS/G"}

package/dist/candles/query.js

@@ -0,0 +1,31 @@
+import { filterQueryOptions as e } from "../shared/utils/query.js";
+//#region src/candles/query.ts
+function t(t) {
+	return ["getCandles", e(t)];
+}
+function n(e, n) {
+	let { marketName: r, resolution: i, from: a, to: o, limit: s } = n;
+	return {
+		...n.query,
+		queryKey: t({
+			sourceId: e.id,
+			marketName: r,
+			resolution: i,
+			from: a,
+			to: o,
+			limit: s
+		}),
+		enabled: n.query?.enabled ?? !0,
+		queryFn: () => e.getCandles({
+			marketName: r,
+			resolution: i,
+			from: a,
+			to: o,
+			limit: s
+		})
+	};
+}
+//#endregion
+export { t as getCandlesQueryKey, n as getCandlesQueryOptions };
+
+//# sourceMappingURL=query.js.map

package/dist/candles/query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.js","names":[],"sources":["../../src/candles/query.ts"],"sourcesContent":["import type { Compute } from \"../shared/types/properties\";\nimport type { QueryParameter, SymmioQueryOptions } from \"../shared/types/query\";\nimport { filterQueryOptions } from \"../shared/utils/query\";\nimport type { CandleSource, GetCandlesParameters, GetCandlesReturnType } from \"./types\";\n\n/** Data resolved by the {@link getCandlesQueryOptions} query. */\nexport type GetCandlesData = GetCandlesReturnType;\n\n/**\n * The identifying half of {@link GetCandlesOptions}: everything that decides\n * which bars are being asked for.\n *\n * `signal` is excluded — cancellation is TanStack's concern, not part of the\n * request's identity.\n */\nexport type GetCandlesQueryKeyParameters = Compute<\n  Omit<GetCandlesParameters, \"signal\"> & {\n    /** {@link CandleSource.id}, so two sources never share a cache entry. */\n    sourceId: string;\n  }\n>;\n\n/**\n * Build the TanStack Query key for {@link getCandlesQueryOptions}.\n *\n * @param options - Source id, market, resolution, and range.\n * @returns A stable, hashable query key.\n */\nexport function getCandlesQueryKey(options: GetCandlesQueryKeyParameters) {\n  return [\"getCandles\", filterQueryOptions(options)] as const;\n}\n\n/** Query-key type produced by {@link getCandlesQueryKey}. */\nexport type GetCandlesQueryKey = ReturnType<typeof getCandlesQueryKey>;\n\n/**\n * Options accepted by {@link getCandlesQueryOptions}: the range to fetch plus\n * TanStack overrides.\n */\nexport type GetCandlesOptions = Compute<\n  Omit<GetCandlesParameters, \"signal\"> & QueryParameter<GetCandlesData, Error, GetCandlesData, GetCandlesQueryKey>\n>;\n\n/** TanStack Query options returned by {@link getCandlesQueryOptions}. */\nexport type GetCandlesQueryOptions = SymmioQueryOptions<GetCandlesData, Error, GetCandlesData, GetCandlesQueryKey>;\n\n/**\n * Build TanStack Query options for a {@link CandleSource}'s historical bars.\n *\n * Unlike the chain-scoped factories in the SDK, this takes a source rather than\n * a {@link Config}: which venue to chart is the consumer's choice, not a\n * property of the SYMMIO deployment. The source's `id` is folded into the query\n * key so switching venues does not read another venue's cached bars.\n *\n * @param source - The candle source to read from.\n * @param options - Market, resolution, range, and TanStack overrides.\n * @returns Options to pass to `useQuery` / `queryClient.fetchQuery`.\n *\n * @example\n * ```ts\n * useQuery(\n *   getCandlesQueryOptions(source, {\n *     marketName: \"BTCUSDT\",\n *     resolution: \"1m\",\n *     from: Date.now() - 3_600_000,\n *     to: Date.now(),\n *   }),\n * );\n * ```\n */\nexport function getCandlesQueryOptions(source: CandleSource, options: GetCandlesOptions): GetCandlesQueryOptions {\n  const { marketName, resolution, from, to, limit } = options;\n\n  return {\n    ...options.query,\n    queryKey: getCandlesQueryKey({ sourceId: source.id, marketName, resolution, from, to, limit }),\n    enabled: options.query?.enabled ?? true,\n    queryFn: () => source.getCandles({ marketName, resolution, from, to, limit }),\n  };\n}\n"],"mappings":";;AA4BA,SAAgB,EAAmB,GAAuC;CACxE,OAAO,CAAC,cAAc,EAAmB,CAAO,CAAC;AACnD;AAwCA,SAAgB,EAAuB,GAAsB,GAAoD;CAC/G,IAAM,EAAE,eAAY,eAAY,SAAM,OAAI,aAAU;CAEpD,OAAO;EACL,GAAG,EAAQ;EACX,UAAU,EAAmB;GAAE,UAAU,EAAO;GAAI;GAAY;GAAY;GAAM;GAAI;EAAM,CAAC;EAC7F,SAAS,EAAQ,OAAO,WAAW;EACnC,eAAe,EAAO,WAAW;GAAE;GAAY;GAAY;GAAM;GAAI;EAAM,CAAC;CAC9E;AACF"}

package/dist/candles/resolution.d.ts

@@ -0,0 +1,25 @@
+import { CandleResolution } from './types.js';
+/**
+ * Nominal length of each {@link CandleResolution} in milliseconds.
+ *
+ * `1w` and `1M` are calendar units — a month is not a fixed span. The values
+ * here use nominal 7-day and 30-day lengths and are only ever used for request
+ * paging arithmetic (advancing a cursor past bars already received), never for
+ * aligning a bar to its boundary. Bars arrive already aligned by the venue.
+ */
+export declare const CANDLE_RESOLUTION_MS: Record<CandleResolution, number>;
+/**
+ * Nominal length of a resolution in milliseconds.
+ *
+ * @param resolution - The resolution to measure.
+ * @returns Its nominal length in ms. See {@link CANDLE_RESOLUTION_MS} for the
+ *   caveat on calendar units.
+ * @throws {SymmError} when the resolution is not a known {@link CandleResolution}.
+ *
+ * @example
+ * ```ts
+ * resolutionToMs("5m"); // 300_000
+ * ```
+ */
+export declare function resolutionToMs(resolution: CandleResolution): number;
+//# sourceMappingURL=resolution.d.ts.map

package/dist/candles/resolution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolution.d.ts","sourceRoot":"","sources":["../../src/candles/resolution.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAEhD;;;;;;;GAOG;AACH,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,gBAAgB,EAAE,MAAM,CAkBjE,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,gBAAgB,GAAG,MAAM,CAMnE"}

package/dist/candles/resolution.js

@@ -0,0 +1,30 @@
+import { SymmError as e } from "../shared/errors/symm-error.js";
+//#region src/candles/resolution.ts
+var t = {
+	"1s": 1e3,
+	"10s": 1e4,
+	"1m": 6e4,
+	"3m": 18e4,
+	"5m": 3e5,
+	"15m": 9e5,
+	"30m": 18e5,
+	"1h": 36e5,
+	"2h": 72e5,
+	"4h": 144e5,
+	"6h": 216e5,
+	"8h": 288e5,
+	"12h": 432e5,
+	"1d": 864e5,
+	"3d": 2592e5,
+	"1w": 6048e5,
+	"1M": 2592e6
+};
+function n(n) {
+	let r = t[n];
+	if (r === void 0) throw new e("validation", "UNKNOWN_CANDLE_RESOLUTION", `Unknown candle resolution: "${n}".`);
+	return r;
+}
+//#endregion
+export { t as CANDLE_RESOLUTION_MS, n as resolutionToMs };
+
+//# sourceMappingURL=resolution.js.map

package/dist/candles/resolution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolution.js","names":[],"sources":["../../src/candles/resolution.ts"],"sourcesContent":["import { SymmError } from \"../shared/errors/symm-error\";\nimport type { CandleResolution } from \"./types\";\n\n/**\n * Nominal length of each {@link CandleResolution} in milliseconds.\n *\n * `1w` and `1M` are calendar units — a month is not a fixed span. The values\n * here use nominal 7-day and 30-day lengths and are only ever used for request\n * paging arithmetic (advancing a cursor past bars already received), never for\n * aligning a bar to its boundary. Bars arrive already aligned by the venue.\n */\nexport const CANDLE_RESOLUTION_MS: Record<CandleResolution, number> = {\n  \"1s\": 1_000,\n  \"10s\": 10_000,\n  \"1m\": 60_000,\n  \"3m\": 180_000,\n  \"5m\": 300_000,\n  \"15m\": 900_000,\n  \"30m\": 1_800_000,\n  \"1h\": 3_600_000,\n  \"2h\": 7_200_000,\n  \"4h\": 14_400_000,\n  \"6h\": 21_600_000,\n  \"8h\": 28_800_000,\n  \"12h\": 43_200_000,\n  \"1d\": 86_400_000,\n  \"3d\": 259_200_000,\n  \"1w\": 604_800_000,\n  \"1M\": 2_592_000_000,\n};\n\n/**\n * Nominal length of a resolution in milliseconds.\n *\n * @param resolution - The resolution to measure.\n * @returns Its nominal length in ms. See {@link CANDLE_RESOLUTION_MS} for the\n *   caveat on calendar units.\n * @throws {SymmError} when the resolution is not a known {@link CandleResolution}.\n *\n * @example\n * ```ts\n * resolutionToMs(\"5m\"); // 300_000\n * ```\n */\nexport function resolutionToMs(resolution: CandleResolution): number {\n  const ms = CANDLE_RESOLUTION_MS[resolution];\n  if (ms === undefined) {\n    throw new SymmError(\"validation\", \"UNKNOWN_CANDLE_RESOLUTION\", `Unknown candle resolution: \"${resolution}\".`);\n  }\n  return ms;\n}\n"],"mappings":";;AAWA,IAAa,IAAyD;CACpE,MAAM;CACN,OAAO;CACP,MAAM;CACN,MAAM;CACN,MAAM;CACN,OAAO;CACP,OAAO;CACP,MAAM;CACN,MAAM;CACN,MAAM;CACN,MAAM;CACN,MAAM;CACN,OAAO;CACP,MAAM;CACN,MAAM;CACN,MAAM;CACN,MAAM;AACR;AAeA,SAAgB,EAAe,GAAsC;CACnE,IAAM,IAAK,EAAqB;CAChC,IAAI,MAAO,KAAA,GACT,MAAM,IAAI,EAAU,cAAc,6BAA6B,+BAA+B,EAAW,GAAG;CAE9G,OAAO;AACT"}