@qtsurfer/api-client 0.11.0 → 0.13.0

package/README.md

@@ -68,8 +68,8 @@ pluggable token stores so callers don't reinvent that plumbing.
 
 All operations are exported as standalone functions; every operation accepts an `Options` object and returns `{ data, error, response }`.
 
-The table is exhaustive: `src/generated/` is produced from the OpenAPI spec, so **all 21 operations**
-the spec declares are exported. The rows below describe **spec version 0.109.2**, which is versioned
+The table is exhaustive: `src/generated/` is produced from the OpenAPI spec, so **all 29 operations**
+the spec declares are exported. The rows below describe **spec version 0.111.2**, which is versioned
 independently of this package.
 
 | Function | Method | Path | Purpose |
@@ -92,9 +92,17 @@ independently of this package.
 | `getSweepResult` | GET | `/backtest/{exchangeId}/{type}/executeSweep/{requestId}/{sweepId}` | Get sweep progress and results |
 | `cancelSweep` | DELETE | `/backtest/{exchangeId}/{type}/executeSweep/{requestId}/{sweepId}` | Cancel a running parameter sweep |
 | `getSweepSensitivity` | GET | `/backtest/{exchangeId}/{type}/executeSweep/{requestId}/{sweepId}/sensitivity` | Get sweep sensitivity surfaces |
+| `getSweepRunEquityCurve` | GET | `/backtest/{exchangeId}/{type}/executeSweep/{requestId}/{sweepId}/runs/{runIx}/equityCurve` | Get one sweep trial's equity curve |
 | `executeBacktest` | POST | `/backtest/{exchangeId}/{type}/execute` | Execute a compiled strategy against a prepared dataset |
 | `cancelBacktest` | DELETE | `/backtest/{exchangeId}/{type}/execute/{jobId}` | Cancel a running backtest execution |
 | `getBacktestResult` | GET | `/backtest/{exchangeId}/{type}/execute/{jobId}` | Get the result of a backtest execution job |
+| `listDatasets` | GET | `/datasets` | List your datasets |
+| `createDataset` | POST | `/datasets` | Create a dataset and obtain its first upload session |
+| `deleteDataset` | DELETE | `/datasets/{datasetId}` | Soft-delete a dataset |
+| `getDataset` | GET | `/datasets/{datasetId}` | Get dataset metadata |
+| `openDatasetUpload` | POST | `/datasets/{datasetId}/uploads` | Open an upload session for a later dataset version |
+| `finalizeDatasetUpload` | POST | `/datasets/{datasetId}/uploads/{uploadId}/finalize` | Queue ingest after uploading a file |
+| `getDatasetUpload` | GET | `/datasets/{datasetId}/uploads/{uploadId}` | Get an upload's ingestion state |
 
 All generated types (`Exchange`, `InstrumentDetail`, `BacktestJobResult`, `PrepareJobState`, `ResultMap`, etc.) are re-exported from the root.
 

package/dist/index.d.ts

@@ -400,6 +400,41 @@ type ExecuteSweepRequest = {
      */
     minTradeFloor?: number;
     walkForward?: WalkForwardRequest;
+    equityCurve?: EquityCurveRequest;
+};
+/**
+ * Requested equity-curve transform, applied server-side in a fixed pipeline order: `resample` (point count) then `differential` (encoding) then `outMode` (JSON shape) — each stage assumes the previous one already ran. A server-side size guard can still force a smaller/deflated shape above its thresholds regardless of what is requested here — see `EquityCurveMeta` for what actually happened.
+ */
+type EquityCurveOptions = {
+    /**
+     * Downsample to at most this many points (extrema-preserving — the global max/min and the exact first/last point are always kept). Omit for no downsampling.
+     */
+    resample?: number;
+    /**
+     * Delta-encode both fields from the second (post-resample) point onward.
+     */
+    differential?: boolean;
+    /**
+     * Requested JSON shape.
+     */
+    outMode?: EquityCurveOutMode;
+};
+/**
+ * Selection (`mode`/`n`/`maxPct`) plus the transform preference (`resample`/`differential`/`outMode`) applied by `GET .../equityCurve` whenever ITS OWN query params are absent, for a curve this sweep retained. The transform half never affects retention or `sweepId` — a caller can always override it per-request at read time regardless of what was submitted here.
+ */
+type EquityCurveRequest = EquityCurveOptions & {
+    /**
+     * Which trials keep their per-point equity curve. `auto` retains curves only while the accumulated size stays within server limits; `topN`/`topPct` retain curves for the best-ranked trials explicitly; `none` retains no curves.
+     */
+    mode?: "auto" | "topN" | "topPct" | "none";
+    /**
+     * Trial count to retain when mode is topN.
+     */
+    n?: number;
+    /**
+     * Top percentage of trials to retain when mode is topPct.
+     */
+    maxPct?: number;
 };
 /**
  * Opt in to walk-forward validation. Present, the sweep runs as F sequential folds and the result gains a `walkForward` section; absent, nothing about the sweep changes. Two requests that differ only in this block are two different sweeps and do not deduplicate against each other.
@@ -512,6 +547,10 @@ type SweepRunRow = {
     belowTradeFloor: boolean;
     aborted: boolean;
     runtimeMs: number;
+    /**
+     * Present only when this trial's curve was selected (`equityCurve.mode` was `topN`/`topPct` on the request, and this row ranked among the winners) — absent, not null, otherwise; a run that was never spilled and one that was spilled but not selected look identical here. Always a pointer today (`url` present, no inline points): a sweep's curves live in a spill store, not the response, until fetched separately. `GET` the `url` to fetch the curve itself; its own `meta` there is the real, possibly size-guarded outcome, while this outer `meta` is a raw, untransformed preview from selection time and can differ.
+     */
+    equityCurve?: EquityCurveResult;
 };
 /**
  * Sensitivity aggregates over a sweep's stored rows. Marginals are always complete; heatmaps may be capped, in which case `heatmapsTruncated` is true.
@@ -571,6 +610,9 @@ type SweepHeatmapCell = {
 };
 type ExecuteSweepResult = {
     sweepId: string;
+    /**
+     * The sweep's own status vocabulary — not the same set `state.status` below uses. See `state` for why.
+     */
     status: "RUNNING" | "COMPLETED" | "PARTIAL" | "CANCELLED";
     objective: "sharpe" | "sortino" | "pnl" | "maxdd";
     order: "ranked" | "natural";
@@ -602,6 +644,13 @@ type ExecuteSweepResult = {
     truncated: boolean;
     leaderboard: Array<SweepRunRow>;
     walkForward?: WalkForwardResult;
+    /**
+     * The same `JobState` shape a single-execute `BacktestJobResult` carries — not a sweep-specific lookalike, the actual type, so field names and timestamp formatting match exactly.
+     * `state.status` uses `JobState`'s own vocabulary (`New`/`Started`/`Completed`/ `Aborted`/`Failed`), mapped from the sweep's `status` field above rather than copying it: `PARTIAL` and `CANCELLED` both map to `Aborted`, because a sweep's `PARTIAL` is already terminal (some shards finished, some failed, nothing more is coming) unlike a single job's non-terminal `Partial`, which has no equivalent here at all.
+     * `state.completed` is real ticks processed on a plain sweep. On a `walkForward` sweep it is currently always `0` — the walk-forward fold runner was not wired to count ticks when this shipped, unlike the plain shard path.
+     * `state.size` is always `0` on every path (single execute, plain sweep, walk-forward alike) — nothing populates it anywhere yet. That is a known gap across the whole API, not a sweep-specific omission.
+     */
+    state: JobState;
 };
 /**
  * Present only on a sweep submitted with `walkForward`, and present from acceptance onward — its presence, not its contents, is what identifies a walk-forward sweep. `completedFolds` is 0 while the first fold is still running.
@@ -762,9 +811,9 @@ type ResultMap = {
      */
     maxDrawdownPercent?: number;
     /**
-     * Equity curve over the backtest. Element 0 is an anchor at the backtest `from` with `initialCapital`; the remaining points are one sample per emitted yield, in order. Use it to plot the strategy's running equity without re-deriving it from the yield history.
+     * Equity curve over the backtest. `points[0]` (or `timestamps[0]`/`equities[0]` in `SHORT` mode) is an anchor at the backtest `from` with `initialCapital`; the remaining points are one sample per emitted yield, in order. Use it to plot the strategy's running equity without re-deriving it from the yield history. Always inline for a plain backtest today — never a pointer (`url`); that shape exists only for a sweep row's top-N winners.
      */
-    equityCurve?: Array<EquityPoint>;
+    equityCurve?: EquityCurveResult;
     /**
      * Number of signals emitted during strategy execution
      */
@@ -803,6 +852,57 @@ type EquityPoint = {
      */
     equity: number;
 };
+/**
+ * JSON shape for an equity curve's points. `ARRAY` is `[{timestamp, equity}, ...]`; `SHORT` is `{timestamps: [...], equities: [...]}` (parallel arrays, no repeated key text). The one schema shared by every place `outMode` appears, request or response, so the two cannot drift to different value sets.
+ */
+type EquityCurveOutMode = "ARRAY" | "SHORT";
+/**
+ * What the transform pipeline actually did, computed from the observed outcome — never a copy of what was requested. Lets a caller detect a forced or no-op transform (e.g. a `resample` ceiling already above the curve's size is a legal no-op, reported honestly as `resampled: false`).
+ */
+type EquityCurveMeta = {
+    /**
+     * Size of the curve the transform pipeline received.
+     */
+    inputPointCount: number;
+    /**
+     * Size after the full pipeline (resample, then differential, then outMode).
+     */
+    outputPointCount: number;
+    /**
+     * True only if the resample stage actually changed the point count.
+     */
+    resampled: boolean;
+    /**
+     * True only if delta-encoding actually ran. Requesting it on a curve of 0 or 1 points has nothing to encode, so it does not run even if asked.
+     */
+    differential: boolean;
+    /**
+     * The actual JSON shape served. Present even when the points themselves are not (a pointer curve, `EquityCurveResult.url`) — a caller resolving that URL separately still needs to know how to parse what it gets back before fetching it. May override an explicit request above a server-side size threshold; this field, not the request, is the source of truth for what shape actually came back.
+     */
+    outMode: EquityCurveOutMode;
+};
+/**
+ * An equity curve, shaped per `meta.outMode`: `points` when `ARRAY`, `timestamps` + `equities` (parallel arrays) when `SHORT`. Used identically wherever a curve is returned — a plain backtest's inline `equityCurve` and a sweep row's `equityCurve` are the same type. `url` is present *instead of* any points when the curve is served by pointer rather than inline (a sweep row's top-N winners only): `GET` it separately to fetch this exact same shape with the points populated.
+ */
+type EquityCurveResult = {
+    meta: EquityCurveMeta;
+    /**
+     * Present when `meta.outMode` is `ARRAY` and the curve is inline (not a pointer).
+     */
+    points?: Array<EquityPoint>;
+    /**
+     * Present when `meta.outMode` is `SHORT` and the curve is inline (not a pointer).
+     */
+    timestamps?: Array<number>;
+    /**
+     * Present when `meta.outMode` is `SHORT` and the curve is inline (not a pointer), parallel to `timestamps` (same index, same point).
+     */
+    equities?: Array<number>;
+    /**
+     * Present only for a sweep row's pointer curve. `GET` this to fetch the curve itself, in this exact `{points|timestamps+equities, meta}` shape — `meta` there is the real, possibly size-guarded outcome; this outer `meta` is a raw, untransformed preview from the moment the sweep selected this trial's curve, and the two can legitimately differ.
+     */
+    url?: string;
+};
 /**
  * Unique identifier for a compiled strategy, derived from the source itself: the same code
  * always yields the same id, for every caller, whatever its formatting. See
@@ -810,6 +910,51 @@ type EquityPoint = {
  *
  */
 type StrategyId = string;
+/**
+ * One property name `POST /strategy` could establish without constructing the strategy —
+ * either declared with `@StrategyProperty` on the compiled source, or one of the small set of
+ * base properties every strategy carries (`amnt`, `enabled`, `multiEntry`, ...).
+ *
+ * **Best-effort, not exhaustive.** A property registered through an attached risk/backtest
+ * config needs a live instance to discover and is not listed here. Use this to catch a typo'd
+ * sweep key before submitting, not as the definitive list of what a sweep will accept — a
+ * name absent from this list may still be valid.
+ *
+ */
+type DeclaredProperty = {
+    /**
+     * The key a sweep or execute param map uses for this property.
+     */
+    name: string;
+    /**
+     * Human-readable label, as declared.
+     */
+    description?: string;
+    /**
+     * The declared default, as a string, if one was given. Absent, not null, when none was
+     * declared.
+     *
+     */
+    defaultValue?: string;
+    /**
+     * Whether a value for this key is injected into the strategy's field (`true`) or only
+     * available through the property map (`false`).
+     *
+     */
+    reflected?: boolean;
+    /**
+     * Suggested sweep/range minimum, if declared. Advisory only, never validated.
+     */
+    min?: number;
+    /**
+     * Suggested sweep/range maximum, if declared. Advisory only, never validated.
+     */
+    max?: number;
+    /**
+     * Suggested sweep/range step, if declared. Advisory only, never validated.
+     */
+    step?: number;
+};
 /**
  * A diagnostic the engine raised while the strategy ran. Advisory: it describes something worth
  * knowing about how the strategy is wired, not necessarily an error.
@@ -996,32 +1141,60 @@ type DatasetWithLinks = Dataset & {
     };
 };
 /**
- * A `Dataset` plus the first upload session — the presigned URL to PUT the file to.
+ * A presigned destination for uploading a raw dataset file directly to storage.
+ */
+type DatasetUploadTarget = {
+    /**
+     * Presigned URL. `PUT` the raw CSV file here directly — no `Authorization` header,
+     * no other API credentials.
+     *
+     */
+    url: string;
+    /**
+     * How long `url` stays valid.
+     */
+    expiresInMinutes: number;
+};
+/**
+ * An upload session — an id plus the presigned URL to PUT the raw file to. Returned both by
+ * `POST /datasets` (as part of the new dataset) and by `POST /datasets/{datasetId}/uploads`
+ * (on its own, for an existing one).
  *
  */
-type DatasetCreated = Dataset & {
+type DatasetUploadSession = {
     /**
      * Identifies this upload session. Pass to
      * `POST /datasets/{datasetId}/uploads/{uploadId}/finalize` once the PUT completes.
      *
      */
     uploadId: string;
-    upload: {
-        /**
-         * Presigned URL. `PUT` the raw CSV file here directly — no `Authorization`
-         * header, no other API credentials.
-         *
-         */
-        url: string;
-        /**
-         * How long `url` stays valid.
-         */
-        expiresInMinutes: number;
-    };
+    upload: DatasetUploadTarget;
 };
+/**
+ * The metadata available immediately after creating a dataset, plus its first upload
+ * session — the presigned URL to PUT the file to. Version-derived fields such as
+ * `createdAt`, `currentVersionId`, range, and cadence are available from `GET /datasets/{datasetId}`
+ * after the relevant lifecycle stages, not in this creation response.
+ *
+ */
+type DatasetCreated = {
+    /**
+     * Opaque id of the newly created dataset.
+     */
+    datasetId: string;
+    /**
+     * Unique name of the newly created dataset.
+     */
+    name: string;
+    /**
+     * Always `ticker` in v1.
+     */
+    type: "ticker";
+    instrument: Instrument;
+} & DatasetUploadSession;
 /**
  * One successfully ingested upload. Cadence and timestamp unit are discovered from the file,
- * not declared by the caller (D-11).
+ * not declared by the caller.
  *
  */
 type DatasetVersion = {
@@ -1369,6 +1542,12 @@ type CompileStrategyResponses = {
      */
     200: {
         strategyId: StrategyId;
+        /**
+         * What could be established about this strategy's sweep-key vocabulary without
+         * constructing it. See `DeclaredProperty` — best-effort, not exhaustive.
+         *
+         */
+        declaredProperties?: Array<DeclaredProperty>;
     };
 };
 type CompileStrategyResponse = CompileStrategyResponses[keyof CompileStrategyResponses];
@@ -1712,6 +1891,48 @@ type GetSweepSensitivityResponses = {
     200: SweepSensitivity;
 };
 type GetSweepSensitivityResponse = GetSweepSensitivityResponses[keyof GetSweepSensitivityResponses];
+type GetSweepRunEquityCurveData = {
+    body?: never;
+    path: {
+        exchangeId: string;
+        type: DataSourceType;
+        requestId: string;
+        sweepId: string;
+        /**
+         * The trial's `runIx`, as it appears on its leaderboard row.
+         */
+        runIx: number;
+    };
+    query?: {
+        /**
+         * Requested JSON shape. Omit to use the sweep's submitted default; may be overridden either way by the server's size guard.
+         */
+        outMode?: EquityCurveOutMode;
+        /**
+         * Downsample to at most this many points (extrema-preserving — the global max/min and the exact first/last point are always kept). Omit to use the sweep's submitted default (itself omittable, for no downsampling).
+         */
+        resample?: number;
+        /**
+         * Delta-encode both fields from the second point onward. Omit to use the sweep's submitted default.
+         */
+        differential?: boolean;
+    };
+    url: "/backtest/{exchangeId}/{type}/executeSweep/{requestId}/{sweepId}/runs/{runIx}/equityCurve";
+};
+type GetSweepRunEquityCurveErrors = {
+    /**
+     * Sweep or `runIx` not found, or that trial's curve was never selected — indistinguishable from a caller's perspective.
+     */
+    404: ResponseError;
+};
+type GetSweepRunEquityCurveError = GetSweepRunEquityCurveErrors[keyof GetSweepRunEquityCurveErrors];
+type GetSweepRunEquityCurveResponses = {
+    /**
+     * The trial's equity curve, shaped per the resolved options.
+     */
+    200: EquityCurveResult;
+};
+type GetSweepRunEquityCurveResponse = GetSweepRunEquityCurveResponses[keyof GetSweepRunEquityCurveResponses];
 type ExecuteBacktestData = {
     /**
      * Execute task parameters
@@ -1728,6 +1949,7 @@ type ExecuteBacktestData = {
          *
          */
         storeSignals?: boolean;
+        equityCurve?: EquityCurveOptions;
     };
     path: {
         /**
@@ -1953,6 +2175,31 @@ type GetDatasetResponses = {
     200: DatasetWithLinks;
 };
 type GetDatasetResponse = GetDatasetResponses[keyof GetDatasetResponses];
+type OpenDatasetUploadData = {
+    body?: never;
+    path: {
+        /**
+         * The id returned by `POST /datasets`
+         */
+        datasetId: string;
+    };
+    query?: never;
+    url: "/datasets/{datasetId}/uploads";
+};
+type OpenDatasetUploadErrors = {
+    /**
+     * No such dataset for this user
+     */
+    404: ResponseError;
+};
+type OpenDatasetUploadError = OpenDatasetUploadErrors[keyof OpenDatasetUploadErrors];
+type OpenDatasetUploadResponses = {
+    /**
+     * An upload session — new, or the one already open for this dataset
+     */
+    201: DatasetUploadSession;
+};
+type OpenDatasetUploadResponse = OpenDatasetUploadResponses[keyof OpenDatasetUploadResponses];
 type FinalizeDatasetUploadData = {
     body?: never;
     path: {
@@ -1970,11 +2217,18 @@ type FinalizeDatasetUploadData = {
 };
 type FinalizeDatasetUploadErrors = {
     /**
-     * No such dataset for this user, or nothing was PUT to `upload.url` yet — a finalize with
-     * nothing to finalize.
+     * No such dataset for this user; `uploadId` was not issued for this dataset (never
+     * minted, or minted for a different one); or nothing was PUT to `upload.url` yet — a
+     * finalize with nothing to finalize.
      *
      */
     404: ResponseError;
+    /**
+     * `uploadId` already produced a version. The error message names it. Open a new upload
+     * session (`POST /datasets/{datasetId}/uploads`) for anything new.
+     *
+     */
+    409: ResponseError;
     /**
      * The uploaded file exceeds your tier's size limit for a dataset.
      */
@@ -2156,9 +2410,14 @@ declare const listStrategies: <ThrowOnError extends boolean = false>(options?: O
  * different means are two strategies, because deciding otherwise would mean deciding program
  * equivalence.
  *
+ * The response also lists `declaredProperties` — the sweep/execute param keys this strategy
+ * is known to accept, so a caller can catch a typo'd key before submitting a sweep instead of
+ * only learning it from a rejected one. See `DeclaredProperty`: best-effort, not exhaustive.
+ *
  */
 declare const compileStrategy: <ThrowOnError extends boolean = false>(options: Options<CompileStrategyData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<{
     strategyId: StrategyId;
+    declaredProperties?: Array<DeclaredProperty>;
 }, ResponseError, ThrowOnError>;
 /**
  * Check that a registered strategy can actually run
@@ -2329,6 +2588,23 @@ declare const getSweepResult: <ThrowOnError extends boolean = false>(options: Op
  *
  */
 declare const getSweepSensitivity: <ThrowOnError extends boolean = false>(options: Options<GetSweepSensitivityData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<SweepSensitivity, ResponseError, ThrowOnError>;
+/**
+ * Get one sweep trial's equity curve
+ * The resource a leaderboard row's `equityCurve.url` points at — only reachable when that
+ * trial's curve was actually selected (`equityCurve.mode: topN` or `topPct` on the sweep
+ * submission, and this trial ranked among the winners). Returns the exact same
+ * `{points|timestamps+equities, meta}` shape a plain backtest's inline `equityCurve` carries.
+ *
+ * Query params reshape the response the same way a plain backtest's `equityCurve` options do.
+ * A param genuinely absent from the query string falls back to the `equityCurve` transform
+ * preference the sweep was submitted with — a param
+ * present but malformed does not fall back, it degrades the same way it always has. Above a
+ * server-side size threshold, the shape is forced regardless of either — `meta.outMode` in
+ * the response, not the query string or the submitted default, is the source of truth for
+ * what shape actually came back.
+ *
+ */
+declare const getSweepRunEquityCurve: <ThrowOnError extends boolean = false>(options: Options<GetSweepRunEquityCurveData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<EquityCurveResult, ResponseError, ThrowOnError>;
 /**
  * Execute a compiled strategy against a prepared dataset
  * Enqueues an execute task that runs the strategy identified by `strategyId` over the data
@@ -2338,8 +2614,9 @@ declare const getSweepSensitivity: <ThrowOnError extends boolean = false>(option
  * Returns immediately with a `jobId`; poll `GET /backtest/{exchangeId}/{type}/execute/{jobId}`
  * for the result.
  *
- * The same params (same `prepareJobId`, `strategyId`, `storeSignals`) always return the same
- * `jobId` (idempotent).
+ * The same params (same `prepareJobId`, `strategyId`, `storeSignals`, `equityCurve`) always
+ * return the same `jobId` (idempotent) — a request that omits `equityCurve` dedupes exactly
+ * as it did before that field existed.
  *
  * Works unchanged for a dataset-backed prepare (`exchangeId: user`) — the request body is
  * identical either way, since the instrument and range are recovered from `prepareJobId`.
@@ -2385,6 +2662,10 @@ declare const listDatasets: <ThrowOnError extends boolean = false>(options?: Opt
  * `POST /datasets/{datasetId}/uploads/{uploadId}/finalize` once the upload completes to kick
  * off ingest.
  *
+ * Losing this response loses nothing: calling this dataset's
+ * `POST /datasets/{datasetId}/uploads` returns the very same upload session again rather than
+ * opening a new one, as long as nothing has been finalized against it yet.
+ *
  * v1 is ticker data only — `type` is not a request field, it is always `"ticker"` in the
  * response. `instrument` must be a plain spot pair (`BASE/QUOTE`, exactly one `/`); derivative
  * forms (e.g. `BTC/USDT:USDT`) are rejected.
@@ -2413,14 +2694,30 @@ declare const deleteDataset: <ThrowOnError extends boolean = false>(options: Opt
  * Detail for one dataset, plus a self link.
  */
 declare const getDataset: <ThrowOnError extends boolean = false>(options: Options<GetDatasetData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<DatasetWithLinks, ResponseError, ThrowOnError>;
+/**
+ * Open a new upload session for an existing dataset
+ * Get a fresh presigned URL to upload a new version into a dataset you already have — a
+ * corrected file, or the next chunk of history. Behaves the same way `POST /datasets` does
+ * for a brand-new dataset's own upload: at most one upload session is open per dataset at a
+ * time, so calling this again before finalizing just hands back that same session rather
+ * than opening a second one — safe to call repeatedly if a response gets lost.
+ *
+ * Once a session has been finalized (successfully or not), the next call here opens a
+ * genuinely new one for that dataset's next version.
+ *
+ */
+declare const openDatasetUpload: <ThrowOnError extends boolean = false>(options: Options<OpenDatasetUploadData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<DatasetUploadSession, ResponseError, ThrowOnError>;
 /**
  * Finalize an uploaded file and start ingest
- * Call once the file has been PUT to the `upload.url` from `POST /datasets`. Enqueues ingest
- * and returns immediately; poll
+ * Call once the file has been PUT to the `upload.url` from `POST /datasets` (or from
+ * `POST /datasets/{datasetId}/uploads`). Enqueues ingest and returns immediately; poll
  * `GET /datasets/{datasetId}/uploads/{uploadId}` for the result.
  *
- * Idempotent — a repeat finalize of the same upload returns the same `jobId` rather than
- * enqueueing a second ingest.
+ * Idempotent while the upload is still open — a repeat finalize before it has produced a
+ * version returns the same `jobId` rather than enqueueing a second ingest. Once it HAS
+ * produced a version, `uploadId` is spent: finalizing it again is a `409`, even with
+ * different bytes freshly PUT to the same URL — open a new upload session instead
+ * (`POST /datasets/{datasetId}/uploads`) rather than reusing a spent one.
  *
  */
 declare const finalizeDatasetUpload: <ThrowOnError extends boolean = false>(options: Options<FinalizeDatasetUploadData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<{
@@ -2436,4 +2733,4 @@ declare const getDatasetUpload: <ThrowOnError extends boolean = false>(options:
 
 declare const client: _hey_api_client_fetch.Client;
 
-export { type AcceptedJob, type AuthTokenError, type AuthTokenResponse, type AuthenticateData, type AuthenticateError, type AuthenticateErrors, type AuthenticateResponse, type AuthenticateResponses, type BacktestJobResult, type CancelBacktestData, type CancelBacktestError, type CancelBacktestErrors, type CancelBacktestResponse, type CancelBacktestResponses, type CancelSweepData, type CancelSweepError, type CancelSweepErrors, type CancelSweepResponse, type CancelSweepResponses, type ClientOptions, type CompileStrategyData, type CompileStrategyError, type CompileStrategyErrors, type CompileStrategyResponse, type CompileStrategyResponses, type CoverageWindow, type CreateDatasetData, type CreateDatasetError, type CreateDatasetErrors, type CreateDatasetResponse, type CreateDatasetResponses, type DataSourceType, type Dataset, type DatasetCreated, type DatasetUploadState, type DatasetVersion, type DatasetWithLinks, type DeleteDatasetData, type DeleteDatasetError, type DeleteDatasetErrors, type DeleteDatasetResponse, type DeleteDatasetResponses, type DeleteStrategyData, type DeleteStrategyError, type DeleteStrategyErrors, type DeleteStrategyResponse, type DeleteStrategyResponses, type DownloadKlinesData, type DownloadKlinesError, type DownloadKlinesErrors, type DownloadKlinesResponse, type DownloadKlinesResponses, type DownloadTickersData, type DownloadTickersError, type DownloadTickersErrors, type DownloadTickersResponse, type DownloadTickersResponses, type EquityPoint, type Exchange, type ExecuteBacktestData, type ExecuteBacktestError, type ExecuteBacktestErrors, type ExecuteBacktestResponse, type ExecuteBacktestResponses, type ExecuteSweepAccepted, type ExecuteSweepData, type ExecuteSweepError, type ExecuteSweepErrors, type ExecuteSweepRequest, type ExecuteSweepResponse, type ExecuteSweepResponses, type ExecuteSweepResult, type FinalizeDatasetUploadData, type FinalizeDatasetUploadError, type FinalizeDatasetUploadErrors, type FinalizeDatasetUploadResponse, type FinalizeDatasetUploadResponses, type GetBacktestResultData, type GetBacktestResultError, type GetBacktestResultErrors, type GetBacktestResultResponse, type GetBacktestResultResponses, type GetDatasetData, type GetDatasetError, type GetDatasetErrors, type GetDatasetResponse, type GetDatasetResponses, type GetDatasetUploadData, type GetDatasetUploadError, type GetDatasetUploadErrors, type GetDatasetUploadResponse, type GetDatasetUploadResponses, type GetPrepareStatusData, type GetPrepareStatusError, type GetPrepareStatusErrors, type GetPrepareStatusResponse, type GetPrepareStatusResponses, type GetStrategyCodeData, type GetStrategyCodeError, type GetStrategyCodeErrors, type GetStrategyCodeResponse, type GetStrategyCodeResponses, type GetStrategyData, type GetStrategyError, type GetStrategyErrors, type GetStrategyResponse, type GetStrategyResponses, type GetSweepResultData, type GetSweepResultError, type GetSweepResultErrors, type GetSweepResultResponse, type GetSweepResultResponses, type GetSweepSensitivityData, type GetSweepSensitivityError, type GetSweepSensitivityErrors, type GetSweepSensitivityResponse, type GetSweepSensitivityResponses, type HalLink, type Instrument, type InstrumentCoverage, type InstrumentDetail, type InstrumentLinks, type InstrumentListMeta, type InstrumentListResponse, type JobState, type ListDatasetsData, type ListDatasetsResponse, type ListDatasetsResponses, type ListExchangesData, type ListExchangesResponse, type ListExchangesResponses, type ListInstrumentsData, type ListInstrumentsError, type ListInstrumentsErrors, type ListInstrumentsResponse, type ListInstrumentsResponses, type ListSegmentInstrumentsData, type ListSegmentInstrumentsError, type ListSegmentInstrumentsErrors, type ListSegmentInstrumentsResponse, type ListSegmentInstrumentsResponses, type ListStrategiesData, type ListStrategiesResponse, type ListStrategiesResponses, type Notice, type Options, type PrepareBacktestData, type PrepareBacktestError, type PrepareBacktestErrors, type PrepareBacktestResponse, type PrepareBacktestResponses, type PrepareJobState, type PrepareRequest, type ResponseError, type ResultMap, type StrategyId, type StrategyLinks, type StrategyState, type StrategySummary, type SweepAxis, type SweepBaseConfig, type SweepHeatmap, type SweepHeatmapCell, type SweepMarginal, type SweepMarginalPoint, type SweepProgress, type SweepRunRow, type SweepSensitivity, type SweepSpecRequest, type ValidateStrategyData, type ValidateStrategyError, type ValidateStrategyErrors, type ValidateStrategyResponse, type ValidateStrategyResponses, type WalkForwardAccepted, type WalkForwardFold, type WalkForwardRequest, type WalkForwardResult, authenticate, cancelBacktest, cancelSweep, client, compileStrategy, createDataset, deleteDataset, deleteStrategy, downloadKlines, downloadTickers, executeBacktest, executeSweep, finalizeDatasetUpload, getBacktestResult, getDataset, getDatasetUpload, getPrepareStatus, getStrategy, getStrategyCode, getSweepResult, getSweepSensitivity, listDatasets, listExchanges, listInstruments, listSegmentInstruments, listStrategies, prepareBacktest, validateStrategy };
+export { type AcceptedJob, type AuthTokenError, type AuthTokenResponse, type AuthenticateData, type AuthenticateError, type AuthenticateErrors, type AuthenticateResponse, type AuthenticateResponses, type BacktestJobResult, type CancelBacktestData, type CancelBacktestError, type CancelBacktestErrors, type CancelBacktestResponse, type CancelBacktestResponses, type CancelSweepData, type CancelSweepError, type CancelSweepErrors, type CancelSweepResponse, type CancelSweepResponses, type ClientOptions, type CompileStrategyData, type CompileStrategyError, type CompileStrategyErrors, type CompileStrategyResponse, type CompileStrategyResponses, type CoverageWindow, type CreateDatasetData, type CreateDatasetError, type CreateDatasetErrors, type CreateDatasetResponse, type CreateDatasetResponses, type DataSourceType, type Dataset, type DatasetCreated, type DatasetUploadSession, type DatasetUploadState, type DatasetUploadTarget, type DatasetVersion, type DatasetWithLinks, type DeclaredProperty, type DeleteDatasetData, type DeleteDatasetError, type DeleteDatasetErrors, type DeleteDatasetResponse, type DeleteDatasetResponses, type DeleteStrategyData, type DeleteStrategyError, type DeleteStrategyErrors, type DeleteStrategyResponse, type DeleteStrategyResponses, type DownloadKlinesData, type DownloadKlinesError, type DownloadKlinesErrors, type DownloadKlinesResponse, type DownloadKlinesResponses, type DownloadTickersData, type DownloadTickersError, type DownloadTickersErrors, type DownloadTickersResponse, type DownloadTickersResponses, type EquityCurveMeta, type EquityCurveOptions, type EquityCurveOutMode, type EquityCurveRequest, type EquityCurveResult, type EquityPoint, type Exchange, type ExecuteBacktestData, type ExecuteBacktestError, type ExecuteBacktestErrors, type ExecuteBacktestResponse, type ExecuteBacktestResponses, type ExecuteSweepAccepted, type ExecuteSweepData, type ExecuteSweepError, type ExecuteSweepErrors, type ExecuteSweepRequest, type ExecuteSweepResponse, type ExecuteSweepResponses, type ExecuteSweepResult, type FinalizeDatasetUploadData, type FinalizeDatasetUploadError, type FinalizeDatasetUploadErrors, type FinalizeDatasetUploadResponse, type FinalizeDatasetUploadResponses, type GetBacktestResultData, type GetBacktestResultError, type GetBacktestResultErrors, type GetBacktestResultResponse, type GetBacktestResultResponses, type GetDatasetData, type GetDatasetError, type GetDatasetErrors, type GetDatasetResponse, type GetDatasetResponses, type GetDatasetUploadData, type GetDatasetUploadError, type GetDatasetUploadErrors, type GetDatasetUploadResponse, type GetDatasetUploadResponses, type GetPrepareStatusData, type GetPrepareStatusError, type GetPrepareStatusErrors, type GetPrepareStatusResponse, type GetPrepareStatusResponses, type GetStrategyCodeData, type GetStrategyCodeError, type GetStrategyCodeErrors, type GetStrategyCodeResponse, type GetStrategyCodeResponses, type GetStrategyData, type GetStrategyError, type GetStrategyErrors, type GetStrategyResponse, type GetStrategyResponses, type GetSweepResultData, type GetSweepResultError, type GetSweepResultErrors, type GetSweepResultResponse, type GetSweepResultResponses, type GetSweepRunEquityCurveData, type GetSweepRunEquityCurveError, type GetSweepRunEquityCurveErrors, type GetSweepRunEquityCurveResponse, type GetSweepRunEquityCurveResponses, type GetSweepSensitivityData, type GetSweepSensitivityError, type GetSweepSensitivityErrors, type GetSweepSensitivityResponse, type GetSweepSensitivityResponses, type HalLink, type Instrument, type InstrumentCoverage, type InstrumentDetail, type InstrumentLinks, type InstrumentListMeta, type InstrumentListResponse, type JobState, type ListDatasetsData, type ListDatasetsResponse, type ListDatasetsResponses, type ListExchangesData, type ListExchangesResponse, type ListExchangesResponses, type ListInstrumentsData, type ListInstrumentsError, type ListInstrumentsErrors, type ListInstrumentsResponse, type ListInstrumentsResponses, type ListSegmentInstrumentsData, type ListSegmentInstrumentsError, type ListSegmentInstrumentsErrors, type ListSegmentInstrumentsResponse, type ListSegmentInstrumentsResponses, type ListStrategiesData, type ListStrategiesResponse, type ListStrategiesResponses, type Notice, type OpenDatasetUploadData, type OpenDatasetUploadError, type OpenDatasetUploadErrors, type OpenDatasetUploadResponse, type OpenDatasetUploadResponses, type Options, type PrepareBacktestData, type PrepareBacktestError, type PrepareBacktestErrors, type PrepareBacktestResponse, type PrepareBacktestResponses, type PrepareJobState, type PrepareRequest, type ResponseError, type ResultMap, type StrategyId, type StrategyLinks, type StrategyState, type StrategySummary, type SweepAxis, type SweepBaseConfig, type SweepHeatmap, type SweepHeatmapCell, type SweepMarginal, type SweepMarginalPoint, type SweepProgress, type SweepRunRow, type SweepSensitivity, type SweepSpecRequest, type ValidateStrategyData, type ValidateStrategyError, type ValidateStrategyErrors, type ValidateStrategyResponse, type ValidateStrategyResponses, type WalkForwardAccepted, type WalkForwardFold, type WalkForwardRequest, type WalkForwardResult, authenticate, cancelBacktest, cancelSweep, client, compileStrategy, createDataset, deleteDataset, deleteStrategy, downloadKlines, downloadTickers, executeBacktest, executeSweep, finalizeDatasetUpload, getBacktestResult, getDataset, getDatasetUpload, getPrepareStatus, getStrategy, getStrategyCode, getSweepResult, getSweepRunEquityCurve, getSweepSensitivity, listDatasets, listExchanges, listInstruments, listSegmentInstruments, listStrategies, openDatasetUpload, prepareBacktest, validateStrategy };

package/dist/index.js

@@ -209,6 +209,18 @@ var getSweepSensitivity = (options) => {
     ...options
   });
 };
+var getSweepRunEquityCurve = (options) => {
+  return (options.client ?? client).get({
+    security: [
+      {
+        scheme: "bearer",
+        type: "http"
+      }
+    ],
+    url: "/backtest/{exchangeId}/{type}/executeSweep/{requestId}/{sweepId}/runs/{runIx}/equityCurve",
+    ...options
+  });
+};
 var executeBacktest = (options) => {
   return (options.client ?? client).post({
     security: [
@@ -301,6 +313,18 @@ var getDataset = (options) => {
     ...options
   });
 };
+var openDatasetUpload = (options) => {
+  return (options.client ?? client).post({
+    security: [
+      {
+        scheme: "bearer",
+        type: "http"
+      }
+    ],
+    url: "/datasets/{datasetId}/uploads",
+    ...options
+  });
+};
 var finalizeDatasetUpload = (options) => {
   return (options.client ?? client).post({
     security: [
@@ -346,12 +370,14 @@ export {
   getStrategy,
   getStrategyCode,
   getSweepResult,
+  getSweepRunEquityCurve,
   getSweepSensitivity,
   listDatasets,
   listExchanges,
   listInstruments,
   listSegmentInstruments,
   listStrategies,
+  openDatasetUpload,
   prepareBacktest,
   validateStrategy
 };