@qtsurfer/sdk 0.1.1 → 0.2.0

package/LICENSE

@@ -186,7 +186,7 @@
       same "printed page" as the copyright notice for easier
       identification within third-party archives.
 
-   Copyright 2026 QTSurfer
+   Copyright 2026 Wualabs LTD
 
    Licensed under the Apache License, Version 2.0 (the "License");
    you may not use this file except in compliance with the License.

package/README.md

@@ -35,7 +35,7 @@ const result = await qts.backtest(
   {
     strategy: readFileSync('./MyStrategy.java', 'utf8'),
     exchangeId: 'binance',
-    instrument: 'BTCUSDT',
+    instrument: 'BTC/USDT',
     from: '2024-01-01',
     to: '2024-12-31',
     storeSignals: true,
@@ -67,6 +67,32 @@ Polling uses exponential backoff (`intervalMs * 1.5`, capped at `maxIntervalMs`)
 
 Progress is emitted on every stage transition and after each poll whose `size > 0`.
 
+## Hourly tickers/klines downloads
+
+Stream one hour of raw ticker or kline data for an instrument. The default wire format is [Lastra](https://github.com/QTSurfer/lastra-ts) (`application/vnd.lastra`); pass `format: 'parquet'` for on-the-fly Parquet conversion.
+
+```ts
+// Lastra (default)
+const blob = await qts.tickers({
+  exchangeId: 'binance',
+  base: 'BTC',
+  quote: 'USDT',
+  hour: '2026-01-15T10',
+});
+await Bun.write('BTC_USDT_2026-01-15_h10.lastra', await blob.arrayBuffer());
+
+// Parquet
+const klines = await qts.klines({
+  exchangeId: 'binance',
+  base: 'BTC',
+  quote: 'USDT',
+  hour: '2026-01-15T10',
+  format: 'parquet',
+});
+```
+
+HTTP errors surface as `QTSDownloadError` (subclass of `QTSError`).
+
 ## Error hierarchy
 
 All SDK errors extend `QTSError` so you can catch them generically or match by subclass.
@@ -77,6 +103,7 @@ import {
   QTSStrategyCompileError,
   QTSPreparationError,
   QTSExecutionError,
+  QTSDownloadError,
   QTSTimeoutError,
   QTSCanceledError,
 } from '@qtsurfer/sdk';
@@ -90,6 +117,8 @@ try {
     console.error('Data prep failed:', e.message);
   } else if (e instanceof QTSExecutionError) {
     console.error('Execution failed:', e.message);
+  } else if (e instanceof QTSDownloadError) {
+    console.error('Download failed:', e.message);
   } else if (e instanceof QTSTimeoutError) {
     console.error('Stage timed out');
   } else if (e instanceof QTSCanceledError) {
@@ -145,7 +174,8 @@ src/
 ├── client.ts             # QTSurfer class
 ├── errors.ts             # QTSError hierarchy
 └── workflows/
-    └── backtest.ts       # compile → prepare → execute (cockatiel policies)
+    ├── backtest.ts       # compile → prepare → execute (cockatiel policies)
+    └── downloads.ts      # hourly tickers/klines as Lastra/Parquet blobs
 ```
 
 ## Development
@@ -153,7 +183,21 @@ src/
 | Script | Description |
 | ------ | ----------- |
 | `npm run lint` | Type-check without emitting |
-| `npm run build` | Compile to `dist/` |
+| `npm run build` | Bundle to `dist/` via `tsup` |
+| `npm test` | Run unit tests |
+| `npm run test:integration` | Run the integration test (requires `JWT_API_TOKEN`). Set `QTSURFER_TEST_VERBOSE=1` to stream progress + final result |
+| `npm run changeset` | Record a changeset for the next release |
+| `npm run changeset:version` | Consume pending changesets: bump `package.json` and update `CHANGELOG.md` |
+| `npm run changeset:publish` | Publish released packages to npm (used by CI) |
+
+### Releasing
+
+Versioning and changelogs are managed with [changesets](https://github.com/changesets/changesets):
+
+1. Create a changeset describing your change: `npm run changeset`
+2. Commit the generated `.changeset/<slug>.md` with your PR.
+3. When ready to release, run `npm run changeset:version` locally. It bumps `package.json` and appends to `CHANGELOG.md`.
+4. Commit the version bump, tag `vX.Y.Z`, and push the tag; the `Publish to npm` workflow handles the rest.
 
 ## License
 

package/dist/index.d.ts

@@ -1,4 +1,89 @@
-export { QTSurfer, type QTSurferOptions } from './client';
-export { QTSError, QTSStrategyCompileError, QTSPreparationError, QTSExecutionError, QTSTimeoutError, QTSCanceledError, } from './errors';
-export type { BacktestRequest, BacktestResult, BacktestProgress, BacktestStage, BacktestOptions, } from './workflows/backtest';
-//# sourceMappingURL=index.d.ts.map
+import { ResultMap } from '@qtsurfer/api-client';
+
+interface BacktestRequest {
+    /** Strategy source code (Java) */
+    strategy: string;
+    /** Exchange id, e.g. `binance` */
+    exchangeId: string;
+    /** Instrument symbol, e.g. `BTC/USDT` */
+    instrument: string;
+    /** Date range start (ISO-8601, ISO DATE or BASIC ISO DATE) */
+    from: string;
+    /** Date range end (same formats as `from`) */
+    to: string;
+    /** When true, the worker uploads emitted signals to object storage. */
+    storeSignals?: boolean;
+}
+type BacktestResult = ResultMap;
+type BacktestStage = 'compiling' | 'preparing' | 'executing';
+interface BacktestProgress {
+    stage: BacktestStage;
+    /** 0-100 when size is known. Undefined during stage start. */
+    percent?: number;
+}
+interface BacktestOptions {
+    /** Abort the workflow. Cancels the current poll and calls `cancelExecution` server-side if execution has started. */
+    signal?: AbortSignal;
+    /** Called on stage transitions and after each poll with updated progress. */
+    onProgress?: (p: BacktestProgress) => void;
+    /** Initial interval between polls. Default 500ms, backed off up to `maxPollIntervalMs`. */
+    pollIntervalMs?: number;
+    /** Upper bound for exponential backoff. Default 5000ms. */
+    maxPollIntervalMs?: number;
+    /** Per-stage timeout. Default none. */
+    timeoutMs?: number;
+}
+
+/** Wire format for hourly tickers/klines downloads. */
+type DownloadFormat = 'lastra' | 'parquet';
+
+interface QTSurferOptions {
+    baseUrl: string;
+    token?: string;
+    fetch?: typeof fetch;
+}
+interface DownloadHourArgs {
+    exchangeId: string;
+    base: string;
+    quote: string;
+    /** Hour selector in `YYYY-MM-DDTHH` (UTC). */
+    hour: string;
+    /** Wire format. Defaults to `'lastra'`. */
+    format?: DownloadFormat;
+}
+declare class QTSurfer {
+    constructor(options: QTSurferOptions);
+    backtest(req: BacktestRequest, opts?: BacktestOptions): Promise<BacktestResult>;
+    /**
+     * Download one hour of raw tickers for an instrument as a {@link Blob}.
+     * Defaults to Lastra; pass `{ format: 'parquet' }` for Parquet.
+     */
+    tickers(args: DownloadHourArgs): Promise<Blob>;
+    /** Download one hour of klines for an instrument as a {@link Blob}. */
+    klines(args: DownloadHourArgs): Promise<Blob>;
+}
+
+declare class QTSError extends Error {
+    readonly cause?: unknown | undefined;
+    constructor(message: string, cause?: unknown | undefined);
+}
+declare class QTSStrategyCompileError extends QTSError {
+    constructor(message: string, cause?: unknown);
+}
+declare class QTSPreparationError extends QTSError {
+    constructor(message: string, cause?: unknown);
+}
+declare class QTSExecutionError extends QTSError {
+    constructor(message: string, cause?: unknown);
+}
+declare class QTSTimeoutError extends QTSError {
+    constructor(message: string, cause?: unknown);
+}
+declare class QTSCanceledError extends QTSError {
+    constructor(message: string, cause?: unknown);
+}
+declare class QTSDownloadError extends QTSError {
+    constructor(message: string, cause?: unknown);
+}
+
+export { type BacktestOptions, type BacktestProgress, type BacktestRequest, type BacktestResult, type BacktestStage, type DownloadFormat, type DownloadHourArgs, QTSCanceledError, QTSDownloadError, QTSError, QTSExecutionError, QTSPreparationError, QTSStrategyCompileError, QTSTimeoutError, QTSurfer, type QTSurferOptions };

package/dist/index.js

@@ -1,3 +1,331 @@
-export { QTSurfer } from './client';
-export { QTSError, QTSStrategyCompileError, QTSPreparationError, QTSExecutionError, QTSTimeoutError, QTSCanceledError, } from './errors';
+// src/client.ts
+import { client as apiClient } from "@qtsurfer/api-client";
+
+// src/workflows/backtest.ts
+import {
+  cancelExecution,
+  executeBacktesting,
+  getExecutionResult,
+  getPreparationStatus,
+  getStrategyStatus,
+  postStrategy,
+  prepareBacktesting
+} from "@qtsurfer/api-client";
+import {
+  ExponentialBackoff,
+  TaskCancelledError,
+  TimeoutStrategy,
+  handleWhenResult,
+  retry,
+  timeout,
+  wrap
+} from "cockatiel";
+
+// src/errors.ts
+var QTSError = class extends Error {
+  constructor(message, cause) {
+    super(message);
+    this.cause = cause;
+    this.name = "QTSError";
+  }
+  cause;
+};
+var QTSStrategyCompileError = class extends QTSError {
+  constructor(message, cause) {
+    super(message, cause);
+    this.name = "QTSStrategyCompileError";
+  }
+};
+var QTSPreparationError = class extends QTSError {
+  constructor(message, cause) {
+    super(message, cause);
+    this.name = "QTSPreparationError";
+  }
+};
+var QTSExecutionError = class extends QTSError {
+  constructor(message, cause) {
+    super(message, cause);
+    this.name = "QTSExecutionError";
+  }
+};
+var QTSTimeoutError = class extends QTSError {
+  constructor(message, cause) {
+    super(message, cause);
+    this.name = "QTSTimeoutError";
+  }
+};
+var QTSCanceledError = class extends QTSError {
+  constructor(message, cause) {
+    super(message, cause);
+    this.name = "QTSCanceledError";
+  }
+};
+var QTSDownloadError = class extends QTSError {
+  constructor(message, cause) {
+    super(message, cause);
+    this.name = "QTSDownloadError";
+  }
+};
+
+// src/workflows/backtest.ts
+var TICKER = "ticker";
+function normalizeStatus(raw) {
+  const value = typeof raw === "string" ? raw.toLowerCase() : "";
+  if (value === "completed") return "completed";
+  if (value === "failed") return "failed";
+  if (value === "aborted" || value === "cancelled" || value === "canceled") {
+    return "aborted";
+  }
+  return "in-progress";
+}
+async function backtest(req, opts = {}) {
+  const policy = buildStagePolicy(opts);
+  opts.onProgress?.({ stage: "compiling" });
+  const strategyId = await compileStrategy(req.strategy, policy, opts);
+  opts.onProgress?.({ stage: "preparing" });
+  const prepareJobId = await prepareData(req, policy, opts);
+  opts.onProgress?.({ stage: "executing" });
+  return executeStrategy(req, prepareJobId, strategyId, policy, opts);
+}
+function buildStagePolicy(opts) {
+  const retryPolicy = retry(
+    handleWhenResult((r) => {
+      const status = r?.status;
+      return normalizeStatus(status) === "in-progress";
+    }),
+    {
+      maxAttempts: Number.MAX_SAFE_INTEGER,
+      backoff: new ExponentialBackoff({
+        initialDelay: opts.pollIntervalMs ?? 500,
+        maxDelay: opts.maxPollIntervalMs ?? 5e3
+      })
+    }
+  );
+  return opts.timeoutMs ? wrap(timeout(opts.timeoutMs, TimeoutStrategy.Cooperative), retryPolicy) : retryPolicy;
+}
+async function compileStrategy(source, policy, opts) {
+  const { data, error } = await postStrategy({
+    body: source,
+    headers: { "X-Compile-Async": true },
+    ...opts.signal ? { signal: opts.signal } : {}
+  });
+  if (error) throw new QTSStrategyCompileError("Strategy submission failed", error);
+  if (!data) throw new QTSStrategyCompileError("Empty response from strategy endpoint");
+  if ("strategyId" in data && data.strategyId) {
+    return data.strategyId;
+  }
+  if (!("jobId" in data) || !data.jobId) {
+    throw new QTSStrategyCompileError("Missing jobId/strategyId in compile response");
+  }
+  const compileJobId = data.jobId;
+  const status = await runStage(
+    policy,
+    opts,
+    async ({ signal }) => {
+      const res = await getStrategyStatus({ path: { strategyId: compileJobId }, signal });
+      if (res.error) throw new QTSStrategyCompileError("Compile status request failed", res.error);
+      if (!res.data) throw new QTSStrategyCompileError("Empty compile status response");
+      return res.data;
+    }
+  );
+  const norm = normalizeStatus(status.status);
+  if (norm === "failed") {
+    throw new QTSStrategyCompileError(status.statusDetail ?? "Strategy compilation failed");
+  }
+  if (norm === "aborted") {
+    throw new QTSCanceledError("Strategy compilation aborted");
+  }
+  if (!status.strategyId) {
+    throw new QTSStrategyCompileError("Compile completed without a strategyId");
+  }
+  return status.strategyId;
+}
+async function prepareData(req, policy, opts) {
+  const { data, error } = await prepareBacktesting({
+    path: { exchangeId: req.exchangeId, type: TICKER },
+    body: { instrument: req.instrument, from: req.from, to: req.to },
+    ...opts.signal ? { signal: opts.signal } : {}
+  });
+  if (error) throw new QTSPreparationError("Prepare submission failed", error);
+  if (!data?.jobId) throw new QTSPreparationError("Missing jobId in prepare response");
+  const prepareJobId = data.jobId;
+  const state = await runStage(
+    policy,
+    opts,
+    async ({ signal }) => {
+      const res = await getPreparationStatus({
+        path: { exchangeId: req.exchangeId, type: TICKER, jobId: prepareJobId },
+        signal
+      });
+      if (res.error) throw new QTSPreparationError("Preparation status request failed", res.error);
+      if (!res.data) throw new QTSPreparationError("Empty preparation status response");
+      return res.data;
+    },
+    (r) => {
+      if (r.size > 0) {
+        opts.onProgress?.({ stage: "preparing", percent: r.completed / r.size * 100 });
+      }
+    }
+  );
+  const prepNorm = normalizeStatus(state.status);
+  if (prepNorm === "failed") {
+    throw new QTSPreparationError(state.statusDetail ?? "Data preparation failed");
+  }
+  if (prepNorm === "aborted") {
+    throw new QTSCanceledError("Data preparation aborted");
+  }
+  return prepareJobId;
+}
+async function executeStrategy(req, prepareJobId, strategyId, policy, opts) {
+  const { data, error } = await executeBacktesting({
+    path: { exchangeId: req.exchangeId, type: TICKER },
+    body: {
+      prepareJobId,
+      strategyId,
+      ...req.storeSignals !== void 0 ? { storeSignals: req.storeSignals } : {}
+    },
+    ...opts.signal ? { signal: opts.signal } : {}
+  });
+  if (error) throw new QTSExecutionError("Execute submission failed", error);
+  if (!data?.jobId) throw new QTSExecutionError("Missing jobId in execute response");
+  const executeJobId = data.jobId;
+  try {
+    const finalResult = await runStage(
+      policy,
+      opts,
+      async ({ signal }) => {
+        const res = await getExecutionResult({
+          path: { exchangeId: req.exchangeId, type: TICKER, jobId: executeJobId },
+          signal
+        });
+        if (res.error) throw new QTSExecutionError("Execution result request failed", res.error);
+        if (!res.data) throw new QTSExecutionError("Empty execution result response");
+        return { ...res.data.state, __result: res.data.results };
+      },
+      (r) => {
+        if (r.size > 0) {
+          opts.onProgress?.({ stage: "executing", percent: r.completed / r.size * 100 });
+        }
+      }
+    );
+    const execNorm = normalizeStatus(finalResult.status);
+    if (execNorm === "failed") {
+      throw new QTSExecutionError(finalResult.statusDetail ?? "Execution failed");
+    }
+    if (execNorm === "aborted") {
+      throw new QTSCanceledError("Execution aborted");
+    }
+    return finalResult.__result;
+  } catch (err) {
+    if (err instanceof QTSCanceledError) {
+      await cancelExecution({
+        path: { exchangeId: req.exchangeId, type: TICKER, jobId: executeJobId }
+      }).catch(() => void 0);
+    }
+    throw err;
+  }
+}
+async function runStage(policy, opts, fetchFn, onEachAttempt) {
+  try {
+    return await policy.execute(async (ctx) => {
+      if (opts.signal?.aborted) throw new QTSCanceledError("Workflow aborted");
+      const result = await fetchFn(ctx);
+      onEachAttempt?.(result);
+      if (opts.signal?.aborted) throw new QTSCanceledError("Workflow aborted");
+      return result;
+    }, opts.signal);
+  } catch (err) {
+    if (err instanceof QTSCanceledError) throw err;
+    if (err instanceof TaskCancelledError) {
+      if (opts.signal?.aborted) throw new QTSCanceledError("Workflow aborted", err);
+      throw new QTSTimeoutError(`Stage exceeded ${opts.timeoutMs}ms`, err);
+    }
+    if (opts.signal?.aborted) throw new QTSCanceledError("Workflow aborted", err);
+    throw err;
+  }
+}
+
+// src/workflows/downloads.ts
+import {
+  getExchangeKlinesHour,
+  getExchangeTickersHour
+} from "@qtsurfer/api-client";
+async function downloadTickers(params) {
+  const { exchangeId, base, quote, hour, format } = params;
+  const { data, error, response } = await getExchangeTickersHour({
+    path: { exchangeId, base, quote },
+    query: { hour, ...format ? { format } : {} }
+  });
+  if (error) {
+    throw new QTSDownloadError(
+      `tickers download failed: HTTP ${response.status} \u2014 ${describe(error)}`,
+      error
+    );
+  }
+  return data;
+}
+async function downloadKlines(params) {
+  const { exchangeId, base, quote, hour, format } = params;
+  const { data, error, response } = await getExchangeKlinesHour({
+    path: { exchangeId, base, quote },
+    query: { hour, ...format ? { format } : {} }
+  });
+  if (error) {
+    throw new QTSDownloadError(
+      `klines download failed: HTTP ${response.status} \u2014 ${describe(error)}`,
+      error
+    );
+  }
+  return data;
+}
+function describe(error) {
+  if (error && typeof error === "object") {
+    const e = error;
+    const code = typeof e.code === "string" ? e.code : void 0;
+    const message = typeof e.message === "string" ? e.message : void 0;
+    if (code && message) return `${code}: ${message}`;
+    if (message) return message;
+    if (code) return code;
+  }
+  return String(error);
+}
+
+// src/client.ts
+var QTSurfer = class {
+  constructor(options) {
+    apiClient.setConfig({
+      baseUrl: options.baseUrl,
+      ...options.token ? { headers: { Authorization: `Bearer ${options.token}` } } : {},
+      ...options.fetch ? { fetch: options.fetch } : {}
+    });
+  }
+  backtest(req, opts) {
+    return backtest(req, opts);
+  }
+  /**
+   * Download one hour of raw tickers for an instrument as a {@link Blob}.
+   * Defaults to Lastra; pass `{ format: 'parquet' }` for Parquet.
+   */
+  tickers(args) {
+    return downloadTickers(args);
+  }
+  /** Download one hour of klines for an instrument as a {@link Blob}. */
+  klines(args) {
+    return downloadKlines(args);
+  }
+  // Future surface:
+  //   strategies: { compile, status, list }
+  //   instruments: { list, get } with TTL cache
+  //   jobs: { cancel, stream, result }
+};
+export {
+  QTSCanceledError,
+  QTSDownloadError,
+  QTSError,
+  QTSExecutionError,
+  QTSPreparationError,
+  QTSStrategyCompileError,
+  QTSTimeoutError,
+  QTSurfer
+};
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAwB,MAAM,UAAU,CAAC;AAC1D,OAAO,EACL,QAAQ,EACR,uBAAuB,EACvB,mBAAmB,EACnB,iBAAiB,EACjB,eAAe,EACf,gBAAgB,GACjB,MAAM,UAAU,CAAC"}
+{"version":3,"sources":["../src/client.ts","../src/workflows/backtest.ts","../src/errors.ts","../src/workflows/downloads.ts"],"sourcesContent":["import { client as apiClient } from '@qtsurfer/api-client';\nimport {\n  backtest,\n  type BacktestOptions,\n  type BacktestRequest,\n  type BacktestResult,\n} from './workflows/backtest';\nimport {\n  downloadKlines,\n  downloadTickers,\n  type DownloadFormat,\n} from './workflows/downloads';\n\nexport interface QTSurferOptions {\n  baseUrl: string;\n  token?: string;\n  fetch?: typeof fetch;\n}\n\nexport interface DownloadHourArgs {\n  exchangeId: string;\n  base: string;\n  quote: string;\n  /** Hour selector in `YYYY-MM-DDTHH` (UTC). */\n  hour: string;\n  /** Wire format. Defaults to `'lastra'`. */\n  format?: DownloadFormat;\n}\n\nexport class QTSurfer {\n  constructor(options: QTSurferOptions) {\n    apiClient.setConfig({\n      baseUrl: options.baseUrl,\n      ...(options.token\n        ? { headers: { Authorization: `Bearer ${options.token}` } }\n        : {}),\n      ...(options.fetch ? { fetch: options.fetch } : {}),\n    });\n  }\n\n  backtest(req: BacktestRequest, opts?: BacktestOptions): Promise<BacktestResult> {\n    return backtest(req, opts);\n  }\n\n  /**\n   * Download one hour of raw tickers for an instrument as a {@link Blob}.\n   * Defaults to Lastra; pass `{ format: 'parquet' }` for Parquet.\n   */\n  tickers(args: DownloadHourArgs): Promise<Blob> {\n    return downloadTickers(args);\n  }\n\n  /** Download one hour of klines for an instrument as a {@link Blob}. */\n  klines(args: DownloadHourArgs): Promise<Blob> {\n    return downloadKlines(args);\n  }\n\n  // Future surface:\n  //   strategies: { compile, status, list }\n  //   instruments: { list, get } with TTL cache\n  //   jobs: { cancel, stream, result }\n}\n","import {\n  cancelExecution,\n  executeBacktesting,\n  getExecutionResult,\n  getPreparationStatus,\n  getStrategyStatus,\n  postStrategy,\n  prepareBacktesting,\n  type DataSourceType,\n  type ResultMap,\n} from '@qtsurfer/api-client';\nimport {\n  ExponentialBackoff,\n  TaskCancelledError,\n  TimeoutStrategy,\n  handleWhenResult,\n  retry,\n  timeout,\n  wrap,\n  type IPolicy,\n  type ICancellationContext,\n} from 'cockatiel';\nimport {\n  QTSCanceledError,\n  QTSExecutionError,\n  QTSPreparationError,\n  QTSStrategyCompileError,\n  QTSTimeoutError,\n} from '../errors';\n\nexport interface BacktestRequest {\n  /** Strategy source code (Java) */\n  strategy: string;\n  /** Exchange id, e.g. `binance` */\n  exchangeId: string;\n  /** Instrument symbol, e.g. `BTC/USDT` */\n  instrument: string;\n  /** Date range start (ISO-8601, ISO DATE or BASIC ISO DATE) */\n  from: string;\n  /** Date range end (same formats as `from`) */\n  to: string;\n  /** When true, the worker uploads emitted signals to object storage. */\n  storeSignals?: boolean;\n}\n\nexport type BacktestResult = ResultMap;\n\nexport type BacktestStage = 'compiling' | 'preparing' | 'executing';\n\nexport interface BacktestProgress {\n  stage: BacktestStage;\n  /** 0-100 when size is known. Undefined during stage start. */\n  percent?: number;\n}\n\nexport interface BacktestOptions {\n  /** Abort the workflow. Cancels the current poll and calls `cancelExecution` server-side if execution has started. */\n  signal?: AbortSignal;\n  /** Called on stage transitions and after each poll with updated progress. */\n  onProgress?: (p: BacktestProgress) => void;\n  /** Initial interval between polls. Default 500ms, backed off up to `maxPollIntervalMs`. */\n  pollIntervalMs?: number;\n  /** Upper bound for exponential backoff. Default 5000ms. */\n  maxPollIntervalMs?: number;\n  /** Per-stage timeout. Default none. */\n  timeoutMs?: number;\n}\n\nconst TICKER: DataSourceType = 'ticker';\n\ntype JobStatus = 'New' | 'Started' | 'Completed' | 'Aborted' | 'Failed' | 'Partial';\n\n/**\n * Normalize the backend job status to a stable lowercase form so we can\n * reason about it regardless of OpenAPI spec drift (the live API sometimes\n * returns lowercase values like `queued` / `completed` / `failed`).\n */\ntype NormalizedStatus = 'in-progress' | 'completed' | 'failed' | 'aborted';\n\nfunction normalizeStatus(raw: unknown): NormalizedStatus {\n  const value = typeof raw === 'string' ? raw.toLowerCase() : '';\n  if (value === 'completed') return 'completed';\n  if (value === 'failed') return 'failed';\n  if (value === 'aborted' || value === 'cancelled' || value === 'canceled') {\n    return 'aborted';\n  }\n  // new / started / queued / running / anything else → still running\n  return 'in-progress';\n}\n\nexport async function backtest(\n  req: BacktestRequest,\n  opts: BacktestOptions = {},\n): Promise<BacktestResult> {\n  const policy = buildStagePolicy(opts);\n\n  // 1. Compile strategy (async mode)\n  opts.onProgress?.({ stage: 'compiling' });\n  const strategyId = await compileStrategy(req.strategy, policy, opts);\n\n  // 2. Prepare data\n  opts.onProgress?.({ stage: 'preparing' });\n  const prepareJobId = await prepareData(req, policy, opts);\n\n  // 3. Execute\n  opts.onProgress?.({ stage: 'executing' });\n  return executeStrategy(req, prepareJobId, strategyId, policy, opts);\n}\n\nfunction buildStagePolicy(opts: BacktestOptions): IPolicy<ICancellationContext, never> {\n  const retryPolicy = retry(\n    handleWhenResult((r) => {\n      const status = (r as { status?: unknown } | undefined)?.status;\n      return normalizeStatus(status) === 'in-progress';\n    }),\n    {\n      maxAttempts: Number.MAX_SAFE_INTEGER,\n      backoff: new ExponentialBackoff({\n        initialDelay: opts.pollIntervalMs ?? 500,\n        maxDelay: opts.maxPollIntervalMs ?? 5000,\n      }),\n    },\n  );\n\n  return opts.timeoutMs\n    ? wrap(timeout(opts.timeoutMs, TimeoutStrategy.Cooperative), retryPolicy)\n    : retryPolicy;\n}\n\nasync function compileStrategy(\n  source: string,\n  policy: IPolicy<ICancellationContext, never>,\n  opts: BacktestOptions,\n): Promise<string> {\n  const { data, error } = await postStrategy({\n    body: source,\n    headers: { 'X-Compile-Async': true },\n    ...(opts.signal ? { signal: opts.signal } : {}),\n  });\n  if (error) throw new QTSStrategyCompileError('Strategy submission failed', error);\n  if (!data) throw new QTSStrategyCompileError('Empty response from strategy endpoint');\n\n  // Sync mode returns { strategyId }; async mode returns { jobId }.\n  if ('strategyId' in data && data.strategyId) {\n    return data.strategyId;\n  }\n  if (!('jobId' in data) || !data.jobId) {\n    throw new QTSStrategyCompileError('Missing jobId/strategyId in compile response');\n  }\n\n  const compileJobId = data.jobId;\n  const status = await runStage(\n    policy,\n    opts,\n    async ({ signal }) => {\n      const res = await getStrategyStatus({ path: { strategyId: compileJobId }, signal });\n      if (res.error) throw new QTSStrategyCompileError('Compile status request failed', res.error);\n      if (!res.data) throw new QTSStrategyCompileError('Empty compile status response');\n      return res.data;\n    },\n  );\n\n  const norm = normalizeStatus(status.status);\n  if (norm === 'failed') {\n    throw new QTSStrategyCompileError(status.statusDetail ?? 'Strategy compilation failed');\n  }\n  if (norm === 'aborted') {\n    throw new QTSCanceledError('Strategy compilation aborted');\n  }\n  if (!status.strategyId) {\n    throw new QTSStrategyCompileError('Compile completed without a strategyId');\n  }\n  return status.strategyId;\n}\n\nasync function prepareData(\n  req: BacktestRequest,\n  policy: IPolicy<ICancellationContext, never>,\n  opts: BacktestOptions,\n): Promise<string> {\n  const { data, error } = await prepareBacktesting({\n    path: { exchangeId: req.exchangeId, type: TICKER },\n    body: { instrument: req.instrument, from: req.from, to: req.to },\n    ...(opts.signal ? { signal: opts.signal } : {}),\n  });\n  if (error) throw new QTSPreparationError('Prepare submission failed', error);\n  if (!data?.jobId) throw new QTSPreparationError('Missing jobId in prepare response');\n\n  const prepareJobId = data.jobId;\n  const state = await runStage(\n    policy,\n    opts,\n    async ({ signal }) => {\n      const res = await getPreparationStatus({\n        path: { exchangeId: req.exchangeId, type: TICKER, jobId: prepareJobId },\n        signal,\n      });\n      if (res.error) throw new QTSPreparationError('Preparation status request failed', res.error);\n      if (!res.data) throw new QTSPreparationError('Empty preparation status response');\n      return res.data;\n    },\n    (r) => {\n      if (r.size > 0) {\n        opts.onProgress?.({ stage: 'preparing', percent: (r.completed / r.size) * 100 });\n      }\n    },\n  );\n\n  const prepNorm = normalizeStatus(state.status);\n  if (prepNorm === 'failed') {\n    throw new QTSPreparationError(state.statusDetail ?? 'Data preparation failed');\n  }\n  if (prepNorm === 'aborted') {\n    throw new QTSCanceledError('Data preparation aborted');\n  }\n  return prepareJobId;\n}\n\nasync function executeStrategy(\n  req: BacktestRequest,\n  prepareJobId: string,\n  strategyId: string,\n  policy: IPolicy<ICancellationContext, never>,\n  opts: BacktestOptions,\n): Promise<BacktestResult> {\n  const { data, error } = await executeBacktesting({\n    path: { exchangeId: req.exchangeId, type: TICKER },\n    body: {\n      prepareJobId,\n      strategyId,\n      ...(req.storeSignals !== undefined ? { storeSignals: req.storeSignals } : {}),\n    },\n    ...(opts.signal ? { signal: opts.signal } : {}),\n  });\n  if (error) throw new QTSExecutionError('Execute submission failed', error);\n  if (!data?.jobId) throw new QTSExecutionError('Missing jobId in execute response');\n\n  const executeJobId = data.jobId;\n\n  try {\n    const finalResult = await runStage(\n      policy,\n      opts,\n      async ({ signal }) => {\n        const res = await getExecutionResult({\n          path: { exchangeId: req.exchangeId, type: TICKER, jobId: executeJobId },\n          signal,\n        });\n        if (res.error) throw new QTSExecutionError('Execution result request failed', res.error);\n        if (!res.data) throw new QTSExecutionError('Empty execution result response');\n        return { ...res.data.state, __result: res.data.results };\n      },\n      (r) => {\n        if (r.size > 0) {\n          opts.onProgress?.({ stage: 'executing', percent: (r.completed / r.size) * 100 });\n        }\n      },\n    );\n\n    const execNorm = normalizeStatus(finalResult.status);\n    if (execNorm === 'failed') {\n      throw new QTSExecutionError(finalResult.statusDetail ?? 'Execution failed');\n    }\n    if (execNorm === 'aborted') {\n      throw new QTSCanceledError('Execution aborted');\n    }\n    return finalResult.__result;\n  } catch (err) {\n    if (err instanceof QTSCanceledError) {\n      await cancelExecution({\n        path: { exchangeId: req.exchangeId, type: TICKER, jobId: executeJobId },\n      }).catch(() => undefined);\n    }\n    throw err;\n  }\n}\n\nasync function runStage<T extends { status: JobStatus }>(\n  policy: IPolicy<ICancellationContext, never>,\n  opts: BacktestOptions,\n  fetchFn: (ctx: ICancellationContext) => Promise<T>,\n  onEachAttempt?: (r: T) => void,\n): Promise<T> {\n  try {\n    return await policy.execute(async (ctx) => {\n      if (opts.signal?.aborted) throw new QTSCanceledError('Workflow aborted');\n      const result = await fetchFn(ctx);\n      onEachAttempt?.(result);\n      if (opts.signal?.aborted) throw new QTSCanceledError('Workflow aborted');\n      return result;\n    }, opts.signal);\n  } catch (err) {\n    if (err instanceof QTSCanceledError) throw err;\n    if (err instanceof TaskCancelledError) {\n      if (opts.signal?.aborted) throw new QTSCanceledError('Workflow aborted', err);\n      throw new QTSTimeoutError(`Stage exceeded ${opts.timeoutMs}ms`, err);\n    }\n    if (opts.signal?.aborted) throw new QTSCanceledError('Workflow aborted', err);\n    throw err;\n  }\n}\n","export class QTSError extends Error {\n  constructor(message: string, readonly cause?: unknown) {\n    super(message);\n    this.name = 'QTSError';\n  }\n}\n\nexport class QTSStrategyCompileError extends QTSError {\n  constructor(message: string, cause?: unknown) {\n    super(message, cause);\n    this.name = 'QTSStrategyCompileError';\n  }\n}\n\nexport class QTSPreparationError extends QTSError {\n  constructor(message: string, cause?: unknown) {\n    super(message, cause);\n    this.name = 'QTSPreparationError';\n  }\n}\n\nexport class QTSExecutionError extends QTSError {\n  constructor(message: string, cause?: unknown) {\n    super(message, cause);\n    this.name = 'QTSExecutionError';\n  }\n}\n\nexport class QTSTimeoutError extends QTSError {\n  constructor(message: string, cause?: unknown) {\n    super(message, cause);\n    this.name = 'QTSTimeoutError';\n  }\n}\n\nexport class QTSCanceledError extends QTSError {\n  constructor(message: string, cause?: unknown) {\n    super(message, cause);\n    this.name = 'QTSCanceledError';\n  }\n}\n\nexport class QTSDownloadError extends QTSError {\n  constructor(message: string, cause?: unknown) {\n    super(message, cause);\n    this.name = 'QTSDownloadError';\n  }\n}\n","import {\n  getExchangeKlinesHour,\n  getExchangeTickersHour,\n} from '@qtsurfer/api-client';\nimport { QTSDownloadError } from '../errors';\n\n/** Wire format for hourly tickers/klines downloads. */\nexport type DownloadFormat = 'lastra' | 'parquet';\n\nexport interface DownloadParams {\n  exchangeId: string;\n  base: string;\n  quote: string;\n  /** Hour selector in `YYYY-MM-DDTHH` (UTC). */\n  hour: string;\n  /** Defaults to {@code 'lastra'}. */\n  format?: DownloadFormat;\n}\n\n/**\n * Download one hour of raw tickers as a {@link Blob}.\n *\n * The default wire format is Lastra (`application/vnd.lastra`); pass\n * `format: 'parquet'` for on-the-fly Parquet conversion.\n *\n * @throws QTSDownloadError on HTTP 4xx/5xx or transport failure.\n */\nexport async function downloadTickers(params: DownloadParams): Promise<Blob> {\n  const { exchangeId, base, quote, hour, format } = params;\n  const { data, error, response } = await getExchangeTickersHour({\n    path: { exchangeId, base, quote },\n    query: { hour, ...(format ? { format } : {}) },\n  });\n  if (error) {\n    throw new QTSDownloadError(\n      `tickers download failed: HTTP ${response.status} — ${describe(error)}`,\n      error,\n    );\n  }\n  return data as Blob;\n}\n\n/**\n * Download one hour of klines as a {@link Blob}. See {@link downloadTickers}\n * for semantics.\n *\n * @throws QTSDownloadError on HTTP 4xx/5xx or transport failure.\n */\nexport async function downloadKlines(params: DownloadParams): Promise<Blob> {\n  const { exchangeId, base, quote, hour, format } = params;\n  const { data, error, response } = await getExchangeKlinesHour({\n    path: { exchangeId, base, quote },\n    query: { hour, ...(format ? { format } : {}) },\n  });\n  if (error) {\n    throw new QTSDownloadError(\n      `klines download failed: HTTP ${response.status} — ${describe(error)}`,\n      error,\n    );\n  }\n  return data as Blob;\n}\n\nfunction describe(error: unknown): string {\n  if (error && typeof error === 'object') {\n    const e = error as { code?: unknown; message?: unknown };\n    const code = typeof e.code === 'string' ? e.code : undefined;\n    const message = typeof e.message === 'string' ? e.message : undefined;\n    if (code && message) return `${code}: ${message}`;\n    if (message) return message;\n    if (code) return code;\n  }\n  return String(error);\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qtsurfer/sdk",
-  "version": "0.1.1",
+  "version": "0.2.0",
   "description": "Opinionated TypeScript SDK for QTSurfer: workflow orchestration, domain objects, normalized errors",
   "type": "module",
   "main": "./dist/index.js",
@@ -18,8 +18,14 @@
     "LICENSE"
   ],
   "scripts": {
-    "build": "tsc",
-    "lint": "tsc --noEmit",
+    "build": "tsup",
+    "lint": "tsc --noEmit -p tsconfig.test.json",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:integration": "vitest run --config vitest.integration.config.ts",
+    "changeset": "changeset",
+    "changeset:version": "changeset version",
+    "changeset:publish": "changeset publish",
     "prepublishOnly": "npm run build"
   },
   "repository": {
@@ -44,11 +50,17 @@
     "access": "public"
   },
   "dependencies": {
-    "@qtsurfer/api-client": "^0.1.0",
+    "@qtsurfer/api-client": "^0.1.2",
     "cockatiel": "^3.2.1"
   },
   "devDependencies": {
-    "typescript": "^5.8.0"
+    "@changesets/changelog-github": "^0.6.0",
+    "@changesets/cli": "^2.30.0",
+    "@types/node": "^25.6.0",
+    "@vitest/coverage-v8": "^4.1.4",
+    "tsup": "^8.5.1",
+    "typescript": "^5.8.0",
+    "vitest": "^4.1.4"
   },
   "engines": {
     "node": ">=20"

package/src/client.ts

@@ -5,6 +5,11 @@ import {
   type BacktestRequest,
   type BacktestResult,
 } from './workflows/backtest';
+import {
+  downloadKlines,
+  downloadTickers,
+  type DownloadFormat,
+} from './workflows/downloads';
 
 export interface QTSurferOptions {
   baseUrl: string;
@@ -12,6 +17,16 @@ export interface QTSurferOptions {
   fetch?: typeof fetch;
 }
 
+export interface DownloadHourArgs {
+  exchangeId: string;
+  base: string;
+  quote: string;
+  /** Hour selector in `YYYY-MM-DDTHH` (UTC). */
+  hour: string;
+  /** Wire format. Defaults to `'lastra'`. */
+  format?: DownloadFormat;
+}
+
 export class QTSurfer {
   constructor(options: QTSurferOptions) {
     apiClient.setConfig({
@@ -27,6 +42,19 @@ export class QTSurfer {
     return backtest(req, opts);
   }
 
+  /**
+   * Download one hour of raw tickers for an instrument as a {@link Blob}.
+   * Defaults to Lastra; pass `{ format: 'parquet' }` for Parquet.
+   */
+  tickers(args: DownloadHourArgs): Promise<Blob> {
+    return downloadTickers(args);
+  }
+
+  /** Download one hour of klines for an instrument as a {@link Blob}. */
+  klines(args: DownloadHourArgs): Promise<Blob> {
+    return downloadKlines(args);
+  }
+
   // Future surface:
   //   strategies: { compile, status, list }
   //   instruments: { list, get } with TTL cache

package/src/errors.ts

@@ -39,3 +39,10 @@ export class QTSCanceledError extends QTSError {
     this.name = 'QTSCanceledError';
   }
 }
+
+export class QTSDownloadError extends QTSError {
+  constructor(message: string, cause?: unknown) {
+    super(message, cause);
+    this.name = 'QTSDownloadError';
+  }
+}

package/src/index.ts

@@ -1,4 +1,4 @@
-export { QTSurfer, type QTSurferOptions } from './client';
+export { QTSurfer, type QTSurferOptions, type DownloadHourArgs } from './client';
 export {
   QTSError,
   QTSStrategyCompileError,
@@ -6,6 +6,7 @@ export {
   QTSExecutionError,
   QTSTimeoutError,
   QTSCanceledError,
+  QTSDownloadError,
 } from './errors';
 export type {
   BacktestRequest,
@@ -14,3 +15,4 @@ export type {
   BacktestStage,
   BacktestOptions,
 } from './workflows/backtest';
+export type { DownloadFormat } from './workflows/downloads';

package/src/workflows/backtest.ts

@@ -33,7 +33,7 @@ export interface BacktestRequest {
   strategy: string;
   /** Exchange id, e.g. `binance` */
   exchangeId: string;
-  /** Instrument symbol, e.g. `BTCUSDT` */
+  /** Instrument symbol, e.g. `BTC/USDT` */
   instrument: string;
   /** Date range start (ISO-8601, ISO DATE or BASIC ISO DATE) */
   from: string;
@@ -68,7 +68,25 @@ export interface BacktestOptions {
 
 const TICKER: DataSourceType = 'ticker';
 
-type JobStatus = 'New' | 'Started' | 'Completed' | 'Aborted' | 'Failed';
+type JobStatus = 'New' | 'Started' | 'Completed' | 'Aborted' | 'Failed' | 'Partial';
+
+/**
+ * Normalize the backend job status to a stable lowercase form so we can
+ * reason about it regardless of OpenAPI spec drift (the live API sometimes
+ * returns lowercase values like `queued` / `completed` / `failed`).
+ */
+type NormalizedStatus = 'in-progress' | 'completed' | 'failed' | 'aborted';
+
+function normalizeStatus(raw: unknown): NormalizedStatus {
+  const value = typeof raw === 'string' ? raw.toLowerCase() : '';
+  if (value === 'completed') return 'completed';
+  if (value === 'failed') return 'failed';
+  if (value === 'aborted' || value === 'cancelled' || value === 'canceled') {
+    return 'aborted';
+  }
+  // new / started / queued / running / anything else → still running
+  return 'in-progress';
+}
 
 export async function backtest(
   req: BacktestRequest,
@@ -92,8 +110,8 @@ export async function backtest(
 function buildStagePolicy(opts: BacktestOptions): IPolicy<ICancellationContext, never> {
   const retryPolicy = retry(
     handleWhenResult((r) => {
-      const status = (r as { status?: JobStatus } | undefined)?.status;
-      return status === 'New' || status === 'Started';
+      const status = (r as { status?: unknown } | undefined)?.status;
+      return normalizeStatus(status) === 'in-progress';
     }),
     {
       maxAttempts: Number.MAX_SAFE_INTEGER,
@@ -142,10 +160,11 @@ async function compileStrategy(
     },
   );
 
-  if (status.status === 'Failed') {
+  const norm = normalizeStatus(status.status);
+  if (norm === 'failed') {
     throw new QTSStrategyCompileError(status.statusDetail ?? 'Strategy compilation failed');
   }
-  if (status.status === 'Aborted') {
+  if (norm === 'aborted') {
     throw new QTSCanceledError('Strategy compilation aborted');
   }
   if (!status.strategyId) {
@@ -187,10 +206,11 @@ async function prepareData(
     },
   );
 
-  if (state.status === 'Failed') {
+  const prepNorm = normalizeStatus(state.status);
+  if (prepNorm === 'failed') {
     throw new QTSPreparationError(state.statusDetail ?? 'Data preparation failed');
   }
-  if (state.status === 'Aborted') {
+  if (prepNorm === 'aborted') {
     throw new QTSCanceledError('Data preparation aborted');
   }
   return prepareJobId;
@@ -237,10 +257,11 @@ async function executeStrategy(
       },
     );
 
-    if (finalResult.status === 'Failed') {
+    const execNorm = normalizeStatus(finalResult.status);
+    if (execNorm === 'failed') {
       throw new QTSExecutionError(finalResult.statusDetail ?? 'Execution failed');
     }
-    if (finalResult.status === 'Aborted') {
+    if (execNorm === 'aborted') {
       throw new QTSCanceledError('Execution aborted');
     }
     return finalResult.__result;
@@ -262,15 +283,19 @@ async function runStage<T extends { status: JobStatus }>(
 ): Promise<T> {
   try {
     return await policy.execute(async (ctx) => {
+      if (opts.signal?.aborted) throw new QTSCanceledError('Workflow aborted');
       const result = await fetchFn(ctx);
       onEachAttempt?.(result);
+      if (opts.signal?.aborted) throw new QTSCanceledError('Workflow aborted');
       return result;
     }, opts.signal);
   } catch (err) {
+    if (err instanceof QTSCanceledError) throw err;
     if (err instanceof TaskCancelledError) {
       if (opts.signal?.aborted) throw new QTSCanceledError('Workflow aborted', err);
       throw new QTSTimeoutError(`Stage exceeded ${opts.timeoutMs}ms`, err);
     }
+    if (opts.signal?.aborted) throw new QTSCanceledError('Workflow aborted', err);
     throw err;
   }
 }

package/src/workflows/downloads.ts

@@ -0,0 +1,74 @@
+import {
+  getExchangeKlinesHour,
+  getExchangeTickersHour,
+} from '@qtsurfer/api-client';
+import { QTSDownloadError } from '../errors';
+
+/** Wire format for hourly tickers/klines downloads. */
+export type DownloadFormat = 'lastra' | 'parquet';
+
+export interface DownloadParams {
+  exchangeId: string;
+  base: string;
+  quote: string;
+  /** Hour selector in `YYYY-MM-DDTHH` (UTC). */
+  hour: string;
+  /** Defaults to {@code 'lastra'}. */
+  format?: DownloadFormat;
+}
+
+/**
+ * Download one hour of raw tickers as a {@link Blob}.
+ *
+ * The default wire format is Lastra (`application/vnd.lastra`); pass
+ * `format: 'parquet'` for on-the-fly Parquet conversion.
+ *
+ * @throws QTSDownloadError on HTTP 4xx/5xx or transport failure.
+ */
+export async function downloadTickers(params: DownloadParams): Promise<Blob> {
+  const { exchangeId, base, quote, hour, format } = params;
+  const { data, error, response } = await getExchangeTickersHour({
+    path: { exchangeId, base, quote },
+    query: { hour, ...(format ? { format } : {}) },
+  });
+  if (error) {
+    throw new QTSDownloadError(
+      `tickers download failed: HTTP ${response.status} — ${describe(error)}`,
+      error,
+    );
+  }
+  return data as Blob;
+}
+
+/**
+ * Download one hour of klines as a {@link Blob}. See {@link downloadTickers}
+ * for semantics.
+ *
+ * @throws QTSDownloadError on HTTP 4xx/5xx or transport failure.
+ */
+export async function downloadKlines(params: DownloadParams): Promise<Blob> {
+  const { exchangeId, base, quote, hour, format } = params;
+  const { data, error, response } = await getExchangeKlinesHour({
+    path: { exchangeId, base, quote },
+    query: { hour, ...(format ? { format } : {}) },
+  });
+  if (error) {
+    throw new QTSDownloadError(
+      `klines download failed: HTTP ${response.status} — ${describe(error)}`,
+      error,
+    );
+  }
+  return data as Blob;
+}
+
+function describe(error: unknown): string {
+  if (error && typeof error === 'object') {
+    const e = error as { code?: unknown; message?: unknown };
+    const code = typeof e.code === 'string' ? e.code : undefined;
+    const message = typeof e.message === 'string' ? e.message : undefined;
+    if (code && message) return `${code}: ${message}`;
+    if (message) return message;
+    if (code) return code;
+  }
+  return String(error);
+}

package/dist/client.d.ts

@@ -1,11 +0,0 @@
-import { type BacktestOptions, type BacktestRequest, type BacktestResult } from './workflows/backtest';
-export interface QTSurferOptions {
-    baseUrl: string;
-    token?: string;
-    fetch?: typeof fetch;
-}
-export declare class QTSurfer {
-    constructor(options: QTSurferOptions);
-    backtest(req: BacktestRequest, opts?: BacktestOptions): Promise<BacktestResult>;
-}
-//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,cAAc,EACpB,MAAM,sBAAsB,CAAC;AAE9B,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;CACtB;AAED,qBAAa,QAAQ;gBACP,OAAO,EAAE,eAAe;IAUpC,QAAQ,CAAC,GAAG,EAAE,eAAe,EAAE,IAAI,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC;CAQhF"}

package/dist/client.js

@@ -1,17 +0,0 @@
-import { client as apiClient } from '@qtsurfer/api-client';
-import { backtest, } from './workflows/backtest';
-export class QTSurfer {
-    constructor(options) {
-        apiClient.setConfig({
-            baseUrl: options.baseUrl,
-            ...(options.token
-                ? { headers: { Authorization: `Bearer ${options.token}` } }
-                : {}),
-            ...(options.fetch ? { fetch: options.fetch } : {}),
-        });
-    }
-    backtest(req, opts) {
-        return backtest(req, opts);
-    }
-}
-//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EACL,QAAQ,GAIT,MAAM,sBAAsB,CAAC;AAQ9B,MAAM,OAAO,QAAQ;IACnB,YAAY,OAAwB;QAClC,SAAS,CAAC,SAAS,CAAC;YAClB,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,GAAG,CAAC,OAAO,CAAC,KAAK;gBACf,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,aAAa,EAAE,UAAU,OAAO,CAAC,KAAK,EAAE,EAAE,EAAE;gBAC3D,CAAC,CAAC,EAAE,CAAC;YACP,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACnD,CAAC,CAAC;IACL,CAAC;IAED,QAAQ,CAAC,GAAoB,EAAE,IAAsB;QACnD,OAAO,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IAC7B,CAAC;CAMF"}

package/dist/errors.d.ts

@@ -1,20 +0,0 @@
-export declare class QTSError extends Error {
-    readonly cause?: unknown | undefined;
-    constructor(message: string, cause?: unknown | undefined);
-}
-export declare class QTSStrategyCompileError extends QTSError {
-    constructor(message: string, cause?: unknown);
-}
-export declare class QTSPreparationError extends QTSError {
-    constructor(message: string, cause?: unknown);
-}
-export declare class QTSExecutionError extends QTSError {
-    constructor(message: string, cause?: unknown);
-}
-export declare class QTSTimeoutError extends QTSError {
-    constructor(message: string, cause?: unknown);
-}
-export declare class QTSCanceledError extends QTSError {
-    constructor(message: string, cause?: unknown);
-}
-//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,QAAS,SAAQ,KAAK;IACJ,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO;gBAAzC,OAAO,EAAE,MAAM,EAAW,KAAK,CAAC,EAAE,OAAO,YAAA;CAItD;AAED,qBAAa,uBAAwB,SAAQ,QAAQ;gBACvC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAI7C;AAED,qBAAa,mBAAoB,SAAQ,QAAQ;gBACnC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAI7C;AAED,qBAAa,iBAAkB,SAAQ,QAAQ;gBACjC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAI7C;AAED,qBAAa,eAAgB,SAAQ,QAAQ;gBAC/B,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAI7C;AAED,qBAAa,gBAAiB,SAAQ,QAAQ;gBAChC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAI7C"}

package/dist/errors.js

@@ -1,39 +0,0 @@
-export class QTSError extends Error {
-    cause;
-    constructor(message, cause) {
-        super(message);
-        this.cause = cause;
-        this.name = 'QTSError';
-    }
-}
-export class QTSStrategyCompileError extends QTSError {
-    constructor(message, cause) {
-        super(message, cause);
-        this.name = 'QTSStrategyCompileError';
-    }
-}
-export class QTSPreparationError extends QTSError {
-    constructor(message, cause) {
-        super(message, cause);
-        this.name = 'QTSPreparationError';
-    }
-}
-export class QTSExecutionError extends QTSError {
-    constructor(message, cause) {
-        super(message, cause);
-        this.name = 'QTSExecutionError';
-    }
-}
-export class QTSTimeoutError extends QTSError {
-    constructor(message, cause) {
-        super(message, cause);
-        this.name = 'QTSTimeoutError';
-    }
-}
-export class QTSCanceledError extends QTSError {
-    constructor(message, cause) {
-        super(message, cause);
-        this.name = 'QTSCanceledError';
-    }
-}
-//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,QAAS,SAAQ,KAAK;IACK;IAAtC,YAAY,OAAe,EAAW,KAAe;QACnD,KAAK,CAAC,OAAO,CAAC,CAAC;QADqB,UAAK,GAAL,KAAK,CAAU;QAEnD,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;IACzB,CAAC;CACF;AAED,MAAM,OAAO,uBAAwB,SAAQ,QAAQ;IACnD,YAAY,OAAe,EAAE,KAAe;QAC1C,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QACtB,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;IACxC,CAAC;CACF;AAED,MAAM,OAAO,mBAAoB,SAAQ,QAAQ;IAC/C,YAAY,OAAe,EAAE,KAAe;QAC1C,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QACtB,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AAED,MAAM,OAAO,iBAAkB,SAAQ,QAAQ;IAC7C,YAAY,OAAe,EAAE,KAAe;QAC1C,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QACtB,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;IAClC,CAAC;CACF;AAED,MAAM,OAAO,eAAgB,SAAQ,QAAQ;IAC3C,YAAY,OAAe,EAAE,KAAe;QAC1C,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QACtB,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AAED,MAAM,OAAO,gBAAiB,SAAQ,QAAQ;IAC5C,YAAY,OAAe,EAAE,KAAe;QAC1C,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QACtB,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF"}

package/dist/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,KAAK,eAAe,EAAE,MAAM,UAAU,CAAC;AAC1D,OAAO,EACL,QAAQ,EACR,uBAAuB,EACvB,mBAAmB,EACnB,iBAAiB,EACjB,eAAe,EACf,gBAAgB,GACjB,MAAM,UAAU,CAAC;AAClB,YAAY,EACV,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,aAAa,EACb,eAAe,GAChB,MAAM,sBAAsB,CAAC"}

package/dist/workflows/backtest.d.ts

@@ -1,36 +0,0 @@
-import { type ResultMap } from '@qtsurfer/api-client';
-export interface BacktestRequest {
-    /** Strategy source code (Java) */
-    strategy: string;
-    /** Exchange id, e.g. `binance` */
-    exchangeId: string;
-    /** Instrument symbol, e.g. `BTCUSDT` */
-    instrument: string;
-    /** Date range start (ISO-8601, ISO DATE or BASIC ISO DATE) */
-    from: string;
-    /** Date range end (same formats as `from`) */
-    to: string;
-    /** When true, the worker uploads emitted signals to object storage. */
-    storeSignals?: boolean;
-}
-export type BacktestResult = ResultMap;
-export type BacktestStage = 'compiling' | 'preparing' | 'executing';
-export interface BacktestProgress {
-    stage: BacktestStage;
-    /** 0-100 when size is known. Undefined during stage start. */
-    percent?: number;
-}
-export interface BacktestOptions {
-    /** Abort the workflow. Cancels the current poll and calls `cancelExecution` server-side if execution has started. */
-    signal?: AbortSignal;
-    /** Called on stage transitions and after each poll with updated progress. */
-    onProgress?: (p: BacktestProgress) => void;
-    /** Initial interval between polls. Default 500ms, backed off up to `maxPollIntervalMs`. */
-    pollIntervalMs?: number;
-    /** Upper bound for exponential backoff. Default 5000ms. */
-    maxPollIntervalMs?: number;
-    /** Per-stage timeout. Default none. */
-    timeoutMs?: number;
-}
-export declare function backtest(req: BacktestRequest, opts?: BacktestOptions): Promise<BacktestResult>;
-//# sourceMappingURL=backtest.d.ts.map

package/dist/workflows/backtest.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"backtest.d.ts","sourceRoot":"","sources":["../../src/workflows/backtest.ts"],"names":[],"mappings":"AAAA,OAAO,EASL,KAAK,SAAS,EACf,MAAM,sBAAsB,CAAC;AAoB9B,MAAM,WAAW,eAAe;IAC9B,kCAAkC;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,kCAAkC;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,wCAAwC;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,8DAA8D;IAC9D,IAAI,EAAE,MAAM,CAAC;IACb,8CAA8C;IAC9C,EAAE,EAAE,MAAM,CAAC;IACX,uEAAuE;IACvE,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,MAAM,cAAc,GAAG,SAAS,CAAC;AAEvC,MAAM,MAAM,aAAa,GAAG,WAAW,GAAG,WAAW,GAAG,WAAW,CAAC;AAEpE,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,aAAa,CAAC;IACrB,8DAA8D;IAC9D,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,qHAAqH;IACrH,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,6EAA6E;IAC7E,UAAU,CAAC,EAAE,CAAC,CAAC,EAAE,gBAAgB,KAAK,IAAI,CAAC;IAC3C,2FAA2F;IAC3F,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,2DAA2D;IAC3D,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,uCAAuC;IACvC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAMD,wBAAsB,QAAQ,CAC5B,GAAG,EAAE,eAAe,EACpB,IAAI,GAAE,eAAoB,GACzB,OAAO,CAAC,cAAc,CAAC,CAczB"}

package/dist/workflows/backtest.js

@@ -1,168 +0,0 @@
-import { cancelExecution, executeBacktesting, getExecutionResult, getPreparationStatus, getStrategyStatus, postStrategy, prepareBacktesting, } from '@qtsurfer/api-client';
-import { ExponentialBackoff, TaskCancelledError, TimeoutStrategy, handleWhenResult, retry, timeout, wrap, } from 'cockatiel';
-import { QTSCanceledError, QTSExecutionError, QTSPreparationError, QTSStrategyCompileError, QTSTimeoutError, } from '../errors';
-const TICKER = 'ticker';
-export async function backtest(req, opts = {}) {
-    const policy = buildStagePolicy(opts);
-    // 1. Compile strategy (async mode)
-    opts.onProgress?.({ stage: 'compiling' });
-    const strategyId = await compileStrategy(req.strategy, policy, opts);
-    // 2. Prepare data
-    opts.onProgress?.({ stage: 'preparing' });
-    const prepareJobId = await prepareData(req, policy, opts);
-    // 3. Execute
-    opts.onProgress?.({ stage: 'executing' });
-    return executeStrategy(req, prepareJobId, strategyId, policy, opts);
-}
-function buildStagePolicy(opts) {
-    const retryPolicy = retry(handleWhenResult((r) => {
-        const status = r?.status;
-        return status === 'New' || status === 'Started';
-    }), {
-        maxAttempts: Number.MAX_SAFE_INTEGER,
-        backoff: new ExponentialBackoff({
-            initialDelay: opts.pollIntervalMs ?? 500,
-            maxDelay: opts.maxPollIntervalMs ?? 5000,
-        }),
-    });
-    return opts.timeoutMs
-        ? wrap(timeout(opts.timeoutMs, TimeoutStrategy.Cooperative), retryPolicy)
-        : retryPolicy;
-}
-async function compileStrategy(source, policy, opts) {
-    const { data, error } = await postStrategy({
-        body: source,
-        headers: { 'X-Compile-Async': true },
-        ...(opts.signal ? { signal: opts.signal } : {}),
-    });
-    if (error)
-        throw new QTSStrategyCompileError('Strategy submission failed', error);
-    if (!data)
-        throw new QTSStrategyCompileError('Empty response from strategy endpoint');
-    // Sync mode returns { strategyId }; async mode returns { jobId }.
-    if ('strategyId' in data && data.strategyId) {
-        return data.strategyId;
-    }
-    if (!('jobId' in data) || !data.jobId) {
-        throw new QTSStrategyCompileError('Missing jobId/strategyId in compile response');
-    }
-    const compileJobId = data.jobId;
-    const status = await runStage(policy, opts, async ({ signal }) => {
-        const res = await getStrategyStatus({ path: { strategyId: compileJobId }, signal });
-        if (res.error)
-            throw new QTSStrategyCompileError('Compile status request failed', res.error);
-        if (!res.data)
-            throw new QTSStrategyCompileError('Empty compile status response');
-        return res.data;
-    });
-    if (status.status === 'Failed') {
-        throw new QTSStrategyCompileError(status.statusDetail ?? 'Strategy compilation failed');
-    }
-    if (status.status === 'Aborted') {
-        throw new QTSCanceledError('Strategy compilation aborted');
-    }
-    if (!status.strategyId) {
-        throw new QTSStrategyCompileError('Compile completed without a strategyId');
-    }
-    return status.strategyId;
-}
-async function prepareData(req, policy, opts) {
-    const { data, error } = await prepareBacktesting({
-        path: { exchangeId: req.exchangeId, type: TICKER },
-        body: { instrument: req.instrument, from: req.from, to: req.to },
-        ...(opts.signal ? { signal: opts.signal } : {}),
-    });
-    if (error)
-        throw new QTSPreparationError('Prepare submission failed', error);
-    if (!data?.jobId)
-        throw new QTSPreparationError('Missing jobId in prepare response');
-    const prepareJobId = data.jobId;
-    const state = await runStage(policy, opts, async ({ signal }) => {
-        const res = await getPreparationStatus({
-            path: { exchangeId: req.exchangeId, type: TICKER, jobId: prepareJobId },
-            signal,
-        });
-        if (res.error)
-            throw new QTSPreparationError('Preparation status request failed', res.error);
-        if (!res.data)
-            throw new QTSPreparationError('Empty preparation status response');
-        return res.data;
-    }, (r) => {
-        if (r.size > 0) {
-            opts.onProgress?.({ stage: 'preparing', percent: (r.completed / r.size) * 100 });
-        }
-    });
-    if (state.status === 'Failed') {
-        throw new QTSPreparationError(state.statusDetail ?? 'Data preparation failed');
-    }
-    if (state.status === 'Aborted') {
-        throw new QTSCanceledError('Data preparation aborted');
-    }
-    return prepareJobId;
-}
-async function executeStrategy(req, prepareJobId, strategyId, policy, opts) {
-    const { data, error } = await executeBacktesting({
-        path: { exchangeId: req.exchangeId, type: TICKER },
-        body: {
-            prepareJobId,
-            strategyId,
-            ...(req.storeSignals !== undefined ? { storeSignals: req.storeSignals } : {}),
-        },
-        ...(opts.signal ? { signal: opts.signal } : {}),
-    });
-    if (error)
-        throw new QTSExecutionError('Execute submission failed', error);
-    if (!data?.jobId)
-        throw new QTSExecutionError('Missing jobId in execute response');
-    const executeJobId = data.jobId;
-    try {
-        const finalResult = await runStage(policy, opts, async ({ signal }) => {
-            const res = await getExecutionResult({
-                path: { exchangeId: req.exchangeId, type: TICKER, jobId: executeJobId },
-                signal,
-            });
-            if (res.error)
-                throw new QTSExecutionError('Execution result request failed', res.error);
-            if (!res.data)
-                throw new QTSExecutionError('Empty execution result response');
-            return { ...res.data.state, __result: res.data.results };
-        }, (r) => {
-            if (r.size > 0) {
-                opts.onProgress?.({ stage: 'executing', percent: (r.completed / r.size) * 100 });
-            }
-        });
-        if (finalResult.status === 'Failed') {
-            throw new QTSExecutionError(finalResult.statusDetail ?? 'Execution failed');
-        }
-        if (finalResult.status === 'Aborted') {
-            throw new QTSCanceledError('Execution aborted');
-        }
-        return finalResult.__result;
-    }
-    catch (err) {
-        if (err instanceof QTSCanceledError) {
-            await cancelExecution({
-                path: { exchangeId: req.exchangeId, type: TICKER, jobId: executeJobId },
-            }).catch(() => undefined);
-        }
-        throw err;
-    }
-}
-async function runStage(policy, opts, fetchFn, onEachAttempt) {
-    try {
-        return await policy.execute(async (ctx) => {
-            const result = await fetchFn(ctx);
-            onEachAttempt?.(result);
-            return result;
-        }, opts.signal);
-    }
-    catch (err) {
-        if (err instanceof TaskCancelledError) {
-            if (opts.signal?.aborted)
-                throw new QTSCanceledError('Workflow aborted', err);
-            throw new QTSTimeoutError(`Stage exceeded ${opts.timeoutMs}ms`, err);
-        }
-        throw err;
-    }
-}
-//# sourceMappingURL=backtest.js.map

package/dist/workflows/backtest.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"backtest.js","sourceRoot":"","sources":["../../src/workflows/backtest.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,kBAAkB,EAClB,oBAAoB,EACpB,iBAAiB,EACjB,YAAY,EACZ,kBAAkB,GAGnB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,eAAe,EACf,gBAAgB,EAChB,KAAK,EACL,OAAO,EACP,IAAI,GAGL,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,EACnB,uBAAuB,EACvB,eAAe,GAChB,MAAM,WAAW,CAAC;AAwCnB,MAAM,MAAM,GAAmB,QAAQ,CAAC;AAIxC,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,GAAoB,EACpB,OAAwB,EAAE;IAE1B,MAAM,MAAM,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;IAEtC,mCAAmC;IACnC,IAAI,CAAC,UAAU,EAAE,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC,CAAC;IAC1C,MAAM,UAAU,GAAG,MAAM,eAAe,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;IAErE,kBAAkB;IAClB,IAAI,CAAC,UAAU,EAAE,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC,CAAC;IAC1C,MAAM,YAAY,GAAG,MAAM,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;IAE1D,aAAa;IACb,IAAI,CAAC,UAAU,EAAE,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC,CAAC;IAC1C,OAAO,eAAe,CAAC,GAAG,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;AACtE,CAAC;AAED,SAAS,gBAAgB,CAAC,IAAqB;IAC7C,MAAM,WAAW,GAAG,KAAK,CACvB,gBAAgB,CAAC,CAAC,CAAC,EAAE,EAAE;QACrB,MAAM,MAAM,GAAI,CAAwC,EAAE,MAAM,CAAC;QACjE,OAAO,MAAM,KAAK,KAAK,IAAI,MAAM,KAAK,SAAS,CAAC;IAClD,CAAC,CAAC,EACF;QACE,WAAW,EAAE,MAAM,CAAC,gBAAgB;QACpC,OAAO,EAAE,IAAI,kBAAkB,CAAC;YAC9B,YAAY,EAAE,IAAI,CAAC,cAAc,IAAI,GAAG;YACxC,QAAQ,EAAE,IAAI,CAAC,iBAAiB,IAAI,IAAI;SACzC,CAAC;KACH,CACF,CAAC;IAEF,OAAO,IAAI,CAAC,SAAS;QACnB,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,eAAe,CAAC,WAAW,CAAC,EAAE,WAAW,CAAC;QACzE,CAAC,CAAC,WAAW,CAAC;AAClB,CAAC;AAED,KAAK,UAAU,eAAe,CAC5B,MAAc,EACd,MAA4C,EAC5C,IAAqB;IAErB,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,YAAY,CAAC;QACzC,IAAI,EAAE,MAAM;QACZ,OAAO,EAAE,EAAE,iBAAiB,EAAE,IAAI,EAAE;QACpC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAChD,CAAC,CAAC;IACH,IAAI,KAAK;QAAE,MAAM,IAAI,uBAAuB,CAAC,4BAA4B,EAAE,KAAK,CAAC,CAAC;IAClF,IAAI,CAAC,IAAI;QAAE,MAAM,IAAI,uBAAuB,CAAC,uCAAuC,CAAC,CAAC;IAEtF,kEAAkE;IAClE,IAAI,YAAY,IAAI,IAAI,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;QAC5C,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IACD,IAAI,CAAC,CAAC,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;QACtC,MAAM,IAAI,uBAAuB,CAAC,8CAA8C,CAAC,CAAC;IACpF,CAAC;IAED,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC;IAChC,MAAM,MAAM,GAAG,MAAM,QAAQ,CAC3B,MAAM,EACN,IAAI,EACJ,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;QACnB,MAAM,GAAG,GAAG,MAAM,iBAAiB,CAAC,EAAE,IAAI,EAAE,EAAE,UAAU,EAAE,YAAY,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;QACpF,IAAI,GAAG,CAAC,KAAK;YAAE,MAAM,IAAI,uBAAuB,CAAC,+BAA+B,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC;QAC7F,IAAI,CAAC,GAAG,CAAC,IAAI;YAAE,MAAM,IAAI,uBAAuB,CAAC,+BAA+B,CAAC,CAAC;QAClF,OAAO,GAAG,CAAC,IAAI,CAAC;IAClB,CAAC,CACF,CAAC;IAEF,IAAI,MAAM,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC/B,MAAM,IAAI,uBAAuB,CAAC,MAAM,CAAC,YAAY,IAAI,6BAA6B,CAAC,CAAC;IAC1F,CAAC;IACD,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAChC,MAAM,IAAI,gBAAgB,CAAC,8BAA8B,CAAC,CAAC;IAC7D,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;QACvB,MAAM,IAAI,uBAAuB,CAAC,wCAAwC,CAAC,CAAC;IAC9E,CAAC;IACD,OAAO,MAAM,CAAC,UAAU,CAAC;AAC3B,CAAC;AAED,KAAK,UAAU,WAAW,CACxB,GAAoB,EACpB,MAA4C,EAC5C,IAAqB;IAErB,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,kBAAkB,CAAC;QAC/C,IAAI,EAAE,EAAE,UAAU,EAAE,GAAG,CAAC,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE;QAClD,IAAI,EAAE,EAAE,UAAU,EAAE,GAAG,CAAC,UAAU,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE;QAChE,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAChD,CAAC,CAAC;IACH,IAAI,KAAK;QAAE,MAAM,IAAI,mBAAmB,CAAC,2BAA2B,EAAE,KAAK,CAAC,CAAC;IAC7E,IAAI,CAAC,IAAI,EAAE,KAAK;QAAE,MAAM,IAAI,mBAAmB,CAAC,mCAAmC,CAAC,CAAC;IAErF,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC;IAChC,MAAM,KAAK,GAAG,MAAM,QAAQ,CAC1B,MAAM,EACN,IAAI,EACJ,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;QACnB,MAAM,GAAG,GAAG,MAAM,oBAAoB,CAAC;YACrC,IAAI,EAAE,EAAE,UAAU,EAAE,GAAG,CAAC,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE;YACvE,MAAM;SACP,CAAC,CAAC;QACH,IAAI,GAAG,CAAC,KAAK;YAAE,MAAM,IAAI,mBAAmB,CAAC,mCAAmC,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC;QAC7F,IAAI,CAAC,GAAG,CAAC,IAAI;YAAE,MAAM,IAAI,mBAAmB,CAAC,mCAAmC,CAAC,CAAC;QAClF,OAAO,GAAG,CAAC,IAAI,CAAC;IAClB,CAAC,EACD,CAAC,CAAC,EAAE,EAAE;QACJ,IAAI,CAAC,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;YACf,IAAI,CAAC,UAAU,EAAE,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,GAAG,EAAE,CAAC,CAAC;QACnF,CAAC;IACH,CAAC,CACF,CAAC;IAEF,IAAI,KAAK,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,IAAI,mBAAmB,CAAC,KAAK,CAAC,YAAY,IAAI,yBAAyB,CAAC,CAAC;IACjF,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAC/B,MAAM,IAAI,gBAAgB,CAAC,0BAA0B,CAAC,CAAC;IACzD,CAAC;IACD,OAAO,YAAY,CAAC;AACtB,CAAC;AAED,KAAK,UAAU,eAAe,CAC5B,GAAoB,EACpB,YAAoB,EACpB,UAAkB,EAClB,MAA4C,EAC5C,IAAqB;IAErB,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,kBAAkB,CAAC;QAC/C,IAAI,EAAE,EAAE,UAAU,EAAE,GAAG,CAAC,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE;QAClD,IAAI,EAAE;YACJ,YAAY;YACZ,UAAU;YACV,GAAG,CAAC,GAAG,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,GAAG,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC9E;QACD,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAChD,CAAC,CAAC;IACH,IAAI,KAAK;QAAE,MAAM,IAAI,iBAAiB,CAAC,2BAA2B,EAAE,KAAK,CAAC,CAAC;IAC3E,IAAI,CAAC,IAAI,EAAE,KAAK;QAAE,MAAM,IAAI,iBAAiB,CAAC,mCAAmC,CAAC,CAAC;IAEnF,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC;IAEhC,IAAI,CAAC;QACH,MAAM,WAAW,GAAG,MAAM,QAAQ,CAChC,MAAM,EACN,IAAI,EACJ,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;YACnB,MAAM,GAAG,GAAG,MAAM,kBAAkB,CAAC;gBACnC,IAAI,EAAE,EAAE,UAAU,EAAE,GAAG,CAAC,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE;gBACvE,MAAM;aACP,CAAC,CAAC;YACH,IAAI,GAAG,CAAC,KAAK;gBAAE,MAAM,IAAI,iBAAiB,CAAC,iCAAiC,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC;YACzF,IAAI,CAAC,GAAG,CAAC,IAAI;gBAAE,MAAM,IAAI,iBAAiB,CAAC,iCAAiC,CAAC,CAAC;YAC9E,OAAO,EAAE,GAAG,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;QAC3D,CAAC,EACD,CAAC,CAAC,EAAE,EAAE;YACJ,IAAI,CAAC,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;gBACf,IAAI,CAAC,UAAU,EAAE,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,GAAG,EAAE,CAAC,CAAC;YACnF,CAAC;QACH,CAAC,CACF,CAAC;QAEF,IAAI,WAAW,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;YACpC,MAAM,IAAI,iBAAiB,CAAC,WAAW,CAAC,YAAY,IAAI,kBAAkB,CAAC,CAAC;QAC9E,CAAC;QACD,IAAI,WAAW,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YACrC,MAAM,IAAI,gBAAgB,CAAC,mBAAmB,CAAC,CAAC;QAClD,CAAC;QACD,OAAO,WAAW,CAAC,QAAQ,CAAC;IAC9B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,gBAAgB,EAAE,CAAC;YACpC,MAAM,eAAe,CAAC;gBACpB,IAAI,EAAE,EAAE,UAAU,EAAE,GAAG,CAAC,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE;aACxE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAC5B,CAAC;QACD,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC;AAED,KAAK,UAAU,QAAQ,CACrB,MAA4C,EAC5C,IAAqB,EACrB,OAAkD,EAClD,aAA8B;IAE9B,IAAI,CAAC;QACH,OAAO,MAAM,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;YACxC,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC;YAClC,aAAa,EAAE,CAAC,MAAM,CAAC,CAAC;YACxB,OAAO,MAAM,CAAC;QAChB,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IAClB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,kBAAkB,EAAE,CAAC;YACtC,IAAI,IAAI,CAAC,MAAM,EAAE,OAAO;gBAAE,MAAM,IAAI,gBAAgB,CAAC,kBAAkB,EAAE,GAAG,CAAC,CAAC;YAC9E,MAAM,IAAI,eAAe,CAAC,kBAAkB,IAAI,CAAC,SAAS,IAAI,EAAE,GAAG,CAAC,CAAC;QACvE,CAAC;QACD,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC"}