@synnaxlabs/client 0.49.0 → 0.49.3

package/dist/src/framer/client.d.ts

@@ -3,6 +3,7 @@ import { CrudeSeries, CrudeTimeRange, CrudeTimeStamp, MultiSeries } from '@synna
 import { channel } from '../channel';
 import { Frame } from './frame';
 import { Iterator, IteratorConfig } from './iterator';
+import { ReadRequest } from './reader';
 import { Streamer, StreamerConfig } from './streamer';
 import { Writer, WriterConfig } from './writer';
 import { ontology } from '../ontology';
@@ -18,6 +19,7 @@ export declare class Client {
     private readonly streamClient;
     private readonly retriever;
     private readonly deleter;
+    private readonly reader;
     constructor(stream: WebSocketClient, unary: UnaryClient, retriever: channel.Retriever);
     /**
      * Opens a new iterator over the given channels within the provided time range.
@@ -53,6 +55,7 @@ export declare class Client {
     write(start: CrudeTimeStamp, data: Record<channel.KeyOrName, CrudeSeries>): Promise<void>;
     read(tr: CrudeTimeRange, channel: channel.KeyOrName): Promise<MultiSeries>;
     read(tr: CrudeTimeRange, channels: channel.Params): Promise<Frame>;
+    read(request: ReadRequest): Promise<ReadableStream<Uint8Array>>;
     private readFrame;
     readLatest(channel: channel.KeyOrName, n: number): Promise<MultiSeries>;
     readLatest(channels: channel.Params, n: number): Promise<Frame>;

package/dist/src/framer/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/framer/client.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,KAAK,WAAW,EAAE,KAAK,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC/E,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,WAAW,EAGjB,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AACvC,OAAO,EAAa,QAAQ,EAAE,KAAK,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAC7E,OAAO,EAAgB,KAAK,QAAQ,EAAE,KAAK,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACrF,OAAO,EAAE,MAAM,EAAE,KAAK,YAAY,EAAc,MAAM,iBAAiB,CAAC;AACxE,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC,eAAO,MAAM,UAAU,2BAA6C,CAAC;AACrE,eAAO,MAAM,gBAAgB;;;;;;CAAiB,CAAC;AAE/C,qBAAa,MAAM;IACjB,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAkB;IAC/C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAoB;IAC9C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;gBAGhC,MAAM,EAAE,eAAe,EACvB,KAAK,EAAE,WAAW,EAClB,SAAS,EAAE,OAAO,CAAC,SAAS;IAO9B;;;;;;;OAOG;IACG,YAAY,CAChB,EAAE,EAAE,cAAc,EAClB,QAAQ,EAAE,OAAO,CAAC,MAAM,EACxB,IAAI,CAAC,EAAE,cAAc,GACpB,OAAO,CAAC,QAAQ,CAAC;IAIpB;;;;;;OAMG;IACG,UAAU,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC;IAIvD;;;;;;;;;;OAUG;IACG,YAAY,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,QAAQ,CAAC;IAIvD,KAAK,CACT,KAAK,EAAE,cAAc,EACrB,OAAO,EAAE,OAAO,CAAC,SAAS,EAC1B,IAAI,EAAE,WAAW,GAChB,OAAO,CAAC,IAAI,CAAC;IAEV,KAAK,CACT,KAAK,EAAE,cAAc,EACrB,QAAQ,EAAE,OAAO,CAAC,WAAW,EAC7B,IAAI,EAAE,WAAW,EAAE,GAClB,OAAO,CAAC,IAAI,CAAC;IAEV,KAAK,CACT,KAAK,EAAE,cAAc,EACrB,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,SAAS,EAAE,WAAW,CAAC,GAC3C,OAAO,CAAC,IAAI,CAAC;IAuCV,IAAI,CAAC,EAAE,EAAE,cAAc,EAAE,OAAO,EAAE,OAAO,CAAC,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC;IAE1E,IAAI,CAAC,EAAE,EAAE,cAAc,EAAE,QAAQ,EAAE,OAAO,CAAC,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;YAY1D,SAAS;IAcjB,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,SAAS,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAEvE,UAAU,CAAC,QAAQ,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;YAYvD,gBAAgB;IAcxB,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,MAAM,EAAE,SAAS,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;CAajF"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/framer/client.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,KAAK,WAAW,EAAE,KAAK,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC/E,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,WAAW,EAGjB,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AACvC,OAAO,EAAa,QAAQ,EAAE,KAAK,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAC7E,OAAO,EAAU,KAAK,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC3D,OAAO,EAAgB,KAAK,QAAQ,EAAE,KAAK,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACrF,OAAO,EAAE,MAAM,EAAE,KAAK,YAAY,EAAc,MAAM,iBAAiB,CAAC;AACxE,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC,eAAO,MAAM,UAAU,2BAA6C,CAAC;AACrE,eAAO,MAAM,gBAAgB;;;;;;CAAiB,CAAC;AAE/C,qBAAa,MAAM;IACjB,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAkB;IAC/C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAoB;IAC9C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;IAClC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAG9B,MAAM,EAAE,eAAe,EACvB,KAAK,EAAE,WAAW,EAClB,SAAS,EAAE,OAAO,CAAC,SAAS;IAQ9B;;;;;;;OAOG;IACG,YAAY,CAChB,EAAE,EAAE,cAAc,EAClB,QAAQ,EAAE,OAAO,CAAC,MAAM,EACxB,IAAI,CAAC,EAAE,cAAc,GACpB,OAAO,CAAC,QAAQ,CAAC;IAIpB;;;;;;OAMG;IACG,UAAU,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC;IAIvD;;;;;;;;;;OAUG;IACG,YAAY,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,QAAQ,CAAC;IAIvD,KAAK,CACT,KAAK,EAAE,cAAc,EACrB,OAAO,EAAE,OAAO,CAAC,SAAS,EAC1B,IAAI,EAAE,WAAW,GAChB,OAAO,CAAC,IAAI,CAAC;IAEV,KAAK,CACT,KAAK,EAAE,cAAc,EACrB,QAAQ,EAAE,OAAO,CAAC,WAAW,EAC7B,IAAI,EAAE,WAAW,EAAE,GAClB,OAAO,CAAC,IAAI,CAAC;IAEV,KAAK,CACT,KAAK,EAAE,cAAc,EACrB,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,SAAS,EAAE,WAAW,CAAC,GAC3C,OAAO,CAAC,IAAI,CAAC;IAuCV,IAAI,CAAC,EAAE,EAAE,cAAc,EAAE,OAAO,EAAE,OAAO,CAAC,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC;IAC1E,IAAI,CAAC,EAAE,EAAE,cAAc,EAAE,QAAQ,EAAE,OAAO,CAAC,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;IAClE,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC;YAYvD,SAAS;IAcjB,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,SAAS,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAEvE,UAAU,CAAC,QAAQ,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;YAYvD,gBAAgB;IAcxB,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,MAAM,EAAE,SAAS,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;CAOjF"}

package/dist/src/framer/external.d.ts

@@ -2,6 +2,7 @@ export * from './client';
 export * from './frame';
 export * from './iterator';
 export * from './payload';
+export * from './reader';
 export * from './streamer';
 export * from './writer';
 //# sourceMappingURL=external.d.ts.map

package/dist/src/framer/external.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"external.d.ts","sourceRoot":"","sources":["../../../src/framer/external.ts"],"names":[],"mappings":"AASA,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC"}
+{"version":3,"file":"external.d.ts","sourceRoot":"","sources":["../../../src/framer/external.ts"],"names":[],"mappings":"AASA,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC"}

package/dist/src/framer/iterator.d.ts

@@ -8,6 +8,11 @@ export interface IteratorConfig {
      * resulting from a call to next with {@link AUTO_SPAN}.
      */
     chunkSize?: number;
+    /**
+     * downsampleFactor is the factor to downsample the data by. If downsampleFactor is
+     * less than or equal to 1, no downsampling will be performed.
+     */
+    downsampleFactor?: number;
 }
 /**
  * Used to iterate over a clusters telemetry in time-order. It should not be

package/dist/src/framer/iterator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"iterator.d.ts","sourceRoot":"","sources":["../../../src/framer/iterator.ts"],"names":[],"mappings":"AASA,OAAO,EAAe,KAAK,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACvE,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,cAAc,EAGnB,QAAQ,EAET,MAAM,eAAe,CAAC;AAGvB,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,KAAK,EAAU,MAAM,gBAAgB,CAAC;AAG/C,eAAO,MAAM,SAAS,UAAmB,CAAC;AAsC1C,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;GAOG;AACH,qBAAa,QAAQ;IACnB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwC;IAC/D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAc;IACtC,KAAK,EAAE,KAAK,CAAC;IAEb,OAAO;IAMP;;;;;;;;;;OAUG;WACU,KAAK,CAChB,EAAE,EAAE,cAAc,EAClB,QAAQ,EAAE,OAAO,CAAC,MAAM,EACxB,SAAS,EAAE,OAAO,CAAC,SAAS,EAC5B,MAAM,EAAE,YAAY,EACpB,IAAI,GAAE,cAAmB,GACxB,OAAO,CAAC,QAAQ,CAAC;IAapB;;;;;;;;;;OAUG;IACG,IAAI,CAAC,IAAI,GAAE,aAAyB,GAAG,OAAO,CAAC,OAAO,CAAC;IAI7D;;;;;;;;;;OAUG;IACG,IAAI,CAAC,IAAI,GAAE,aAAyB,GAAG,OAAO,CAAC,OAAO,CAAC;IAI7D;;;;;;;OAOG;IACG,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC;IAInC;;;;;;OAMG;IACG,QAAQ,IAAI,OAAO,CAAC,OAAO,CAAC;IAIlC;;;;;;;OAOG;IACG,MAAM,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC;IAIrD;;;;;;;OAOG;IACG,MAAM,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC;IAIrD;;;;OAIG;IACG,KAAK,IAAI,OAAO,CAAC,OAAO,CAAC;IAI/B;;;;OAIG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,aAAa,CAAC,KAAK,EAAE,GAAG,EAAE,SAAS,CAAC;YAIhD,OAAO;CAStB"}
+{"version":3,"file":"iterator.d.ts","sourceRoot":"","sources":["../../../src/framer/iterator.ts"],"names":[],"mappings":"AASA,OAAO,EAAe,KAAK,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACvE,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,cAAc,EAGnB,QAAQ,EAET,MAAM,eAAe,CAAC;AAGvB,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,KAAK,EAAU,MAAM,gBAAgB,CAAC;AAG/C,eAAO,MAAM,SAAS,UAAmB,CAAC;AAuC1C,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;;;GAOG;AACH,qBAAa,QAAQ;IACnB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwC;IAC/D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAc;IACtC,KAAK,EAAE,KAAK,CAAC;IAEb,OAAO;IAMP;;;;;;;;;;OAUG;WACU,KAAK,CAChB,EAAE,EAAE,cAAc,EAClB,QAAQ,EAAE,OAAO,CAAC,MAAM,EACxB,SAAS,EAAE,OAAO,CAAC,SAAS,EAC5B,MAAM,EAAE,YAAY,EACpB,IAAI,GAAE,cAAmB,GACxB,OAAO,CAAC,QAAQ,CAAC;IAcpB;;;;;;;;;;OAUG;IACG,IAAI,CAAC,IAAI,GAAE,aAAyB,GAAG,OAAO,CAAC,OAAO,CAAC;IAI7D;;;;;;;;;;OAUG;IACG,IAAI,CAAC,IAAI,GAAE,aAAyB,GAAG,OAAO,CAAC,OAAO,CAAC;IAI7D;;;;;;;OAOG;IACG,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC;IAInC;;;;;;OAMG;IACG,QAAQ,IAAI,OAAO,CAAC,OAAO,CAAC;IAIlC;;;;;;;OAOG;IACG,MAAM,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC;IAIrD;;;;;;;OAOG;IACG,MAAM,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC;IAIrD;;;;OAIG;IACG,KAAK,IAAI,OAAO,CAAC,OAAO,CAAC;IAI/B;;;;OAIG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,aAAa,CAAC,KAAK,EAAE,GAAG,EAAE,SAAS,CAAC;YAIhD,OAAO;CAStB"}

package/dist/src/framer/reader.d.ts

@@ -0,0 +1,18 @@
+import { WebSocketClient } from '@synnaxlabs/freighter';
+import { CrudeTimeRange } from '@synnaxlabs/x';
+import { channel } from '../channel';
+import { IteratorConfig } from './iterator';
+export interface ReadRequest {
+    channels: channel.Params;
+    timeRange: CrudeTimeRange;
+    channelNames?: Record<channel.KeyOrName, string>;
+    responseType: "csv";
+    iteratorConfig?: IteratorConfig;
+}
+export declare class Reader {
+    private readonly retriever;
+    private readonly streamClient;
+    constructor(retriever: channel.Retriever, streamClient: WebSocketClient);
+    read(request: ReadRequest): Promise<ReadableStream<Uint8Array>>;
+}
+//# sourceMappingURL=reader.d.ts.map

package/dist/src/framer/reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reader.d.ts","sourceRoot":"","sources":["../../../src/framer/reader.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,KAAK,cAAc,EAAgB,MAAM,eAAe,CAAC;AAElE,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,WAAW,CAAC;AAGzC,OAAO,EAAY,KAAK,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAElE,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC;IACzB,SAAS,EAAE,cAAc,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IACjD,YAAY,EAAE,KAAK,CAAC;IACpB,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC;AAED,qBAAa,MAAM;IACjB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAoB;IAC9C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAkB;gBAEnC,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,YAAY,EAAE,eAAe;IAKjE,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC;CAiCtE"}

package/dist/src/framer/reader.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=reader.spec.d.ts.map

package/dist/src/framer/reader.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reader.spec.d.ts","sourceRoot":"","sources":["../../../src/framer/reader.spec.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@synnaxlabs/client",
-  "version": "0.49.0",
+  "version": "0.49.3",
   "description": "The Synnax Client Library",
   "keywords": [
     "synnax",
@@ -26,8 +26,8 @@
   "dependencies": {
     "async-mutex": "^0.5.0",
     "zod": "^4.1.12",
-    "@synnaxlabs/freighter": "^0.49.0",
-    "@synnaxlabs/x": "^0.49.0"
+    "@synnaxlabs/x": "^0.49.3",
+    "@synnaxlabs/freighter": "^0.49.0"
   },
   "devDependencies": {
     "@vitest/coverage-v8": "^3.2.4",
@@ -38,8 +38,8 @@
     "vite": "^7.1.12",
     "vitest": "^3.2.4",
     "@synnaxlabs/tsconfig": "^0.43.0",
-    "@synnaxlabs/vite-plugin": "^0.43.0",
-    "eslint-config-synnaxlabs": "^0.43.0"
+    "eslint-config-synnaxlabs": "^0.43.0",
+    "@synnaxlabs/vite-plugin": "^0.43.0"
   },
   "type": "module",
   "types": "dist/src/index.d.ts",

package/src/framer/client.ts

@@ -21,6 +21,7 @@ import { channel } from "@/channel";
 import { Deleter } from "@/framer/deleter";
 import { Frame } from "@/framer/frame";
 import { AUTO_SPAN, Iterator, type IteratorConfig } from "@/framer/iterator";
+import { Reader, type ReadRequest } from "@/framer/reader";
 import { openStreamer, type Streamer, type StreamerConfig } from "@/framer/streamer";
 import { Writer, type WriterConfig, WriterMode } from "@/framer/writer";
 import { ontology } from "@/ontology";
@@ -32,6 +33,7 @@ export class Client {
   private readonly streamClient: WebSocketClient;
   private readonly retriever: channel.Retriever;
   private readonly deleter: Deleter;
+  private readonly reader: Reader;
 
   constructor(
     stream: WebSocketClient,
@@ -41,6 +43,7 @@ export class Client {
     this.streamClient = stream;
     this.retriever = retriever;
     this.deleter = new Deleter(unary);
+    this.reader = new Reader(retriever, stream);
   }
 
   /**
@@ -140,15 +143,15 @@ export class Client {
   }
 
   async read(tr: CrudeTimeRange, channel: channel.KeyOrName): Promise<MultiSeries>;
-
   async read(tr: CrudeTimeRange, channels: channel.Params): Promise<Frame>;
-
+  async read(request: ReadRequest): Promise<ReadableStream<Uint8Array>>;
   async read(
-    tr: CrudeTimeRange,
-    channels: channel.Params,
-  ): Promise<MultiSeries | Frame> {
-    const { single } = channel.analyzeParams(channels);
-    const fr = await this.readFrame(tr, channels);
+    tr: CrudeTimeRange | ReadRequest,
+    channels?: channel.Params,
+  ): Promise<MultiSeries | Frame | ReadableStream<Uint8Array>> {
+    if (!("start" in tr)) return this.reader.read(tr);
+    const { single } = channel.analyzeParams(channels!);
+    const fr = await this.readFrame(tr, channels!);
     if (single) return fr.get(channels as channel.KeyOrName);
     return fr;
   }
@@ -199,13 +202,7 @@ export class Client {
     const { normalized, variant } = channel.analyzeParams(channels);
     const bounds = new TimeRange(timeRange);
     if (variant === "keys")
-      return await this.deleter.delete({
-        keys: normalized as channel.Key[],
-        bounds,
-      });
-    return await this.deleter.delete({
-      names: normalized as string[],
-      bounds,
-    });
+      return await this.deleter.delete({ keys: normalized as channel.Key[], bounds });
+    return await this.deleter.delete({ names: normalized as string[], bounds });
   }
 }

package/src/framer/external.ts

@@ -11,5 +11,6 @@ export * from "@/framer/client";
 export * from "@/framer/frame";
 export * from "@/framer/iterator";
 export * from "@/framer/payload";
+export * from "@/framer/reader";
 export * from "@/framer/streamer";
 export * from "@/framer/writer";

package/src/framer/iterator.spec.ts

@@ -99,4 +99,71 @@ describe("Iterator", () => {
       await iter.close();
     }
   });
+  test("downsample factor 2", async () => {
+    const channels = await newIndexedPair(client);
+    const [idx_ch, data_ch] = channels;
+    const writer = await client.openWriter({ start: TimeStamp.SECOND, channels });
+    await writer.write({
+      [idx_ch.key]: secondsLinspace(1, 8),
+      [data_ch.key]: new Float64Array([1, 2, 3, 4, 5, 6, 7, 8]),
+    });
+    await writer.close();
+    const iter = await client.openIterator(TimeRange.MAX, channels, {
+      downsampleFactor: 2,
+    });
+
+    try {
+      expect(await iter.seekFirst()).toBe(true);
+      expect(await iter.next(AUTO_SPAN)).toBe(true);
+      // [1, 2, 3, 4, 5, 6, 7, 8] downsampled by 2 = [1, 3, 5, 7]
+      expect(iter.value.get(data_ch.key).data).toEqual(new Float64Array([1, 3, 5, 7]));
+      expect(await iter.next(AUTO_SPAN)).toBe(false);
+    } finally {
+      await iter.close();
+    }
+  });
+  test("downsample factor 3", async () => {
+    const channels = await newIndexedPair(client);
+    const [idx_ch, data_ch] = channels;
+    const writer = await client.openWriter({ start: TimeStamp.SECOND, channels });
+    await writer.write({
+      [idx_ch.key]: secondsLinspace(1, 9),
+      [data_ch.key]: new Float64Array([1, 2, 3, 4, 5, 6, 7, 8, 9]),
+    });
+    await writer.close();
+    const iter = await client.openIterator(TimeRange.MAX, channels, {
+      downsampleFactor: 3,
+    });
+
+    try {
+      expect(await iter.seekFirst()).toBe(true);
+      expect(await iter.next(AUTO_SPAN)).toBe(true);
+      // [1, 2, 3, 4, 5, 6, 7, 8, 9] downsampled by 3 = [1, 4, 7]
+      expect(iter.value.get(data_ch.key).data).toEqual(new Float64Array([1, 4, 7]));
+      expect(await iter.next(AUTO_SPAN)).toBe(false);
+    } finally {
+      await iter.close();
+    }
+  });
+  test("no downsample when factor is 1", async () => {
+    const channels = await newIndexedPair(client);
+    const [idx_ch, data_ch] = channels;
+    const writer = await client.openWriter({ start: TimeStamp.SECOND, channels });
+    await writer.write({
+      [idx_ch.key]: secondsLinspace(1, 4),
+      [data_ch.key]: new Float64Array([1, 2, 3, 4]),
+    });
+    await writer.close();
+    const iter = await client.openIterator(TimeRange.MAX, channels, {
+      downsampleFactor: 1,
+    });
+    try {
+      expect(await iter.seekFirst()).toBe(true);
+      expect(await iter.next(AUTO_SPAN)).toBe(true);
+      expect(iter.value.get(data_ch.key).data).toEqual(new Float64Array([1, 2, 3, 4]));
+      expect(await iter.next(AUTO_SPAN)).toBe(false);
+    } finally {
+      await iter.close();
+    }
+  });
 });

package/src/framer/iterator.ts

@@ -51,6 +51,7 @@ const reqZ = z.object({
   stamp: TimeStamp.z.optional(),
   keys: channel.keyZ.array().optional(),
   chunkSize: z.number().optional(),
+  downsampleFactor: z.int().optional(),
 });
 interface Request extends z.infer<typeof reqZ> {}
 
@@ -67,6 +68,11 @@ export interface IteratorConfig {
    * resulting from a call to next with {@link AUTO_SPAN}.
    */
   chunkSize?: number;
+  /**
+   * downsampleFactor is the factor to downsample the data by. If downsampleFactor is
+   * less than or equal to 1, no downsampling will be performed.
+   */
+  downsampleFactor?: number;
 }
 
 /**
@@ -114,6 +120,7 @@ export class Iterator {
       keys: Array.from(adapter.keys),
       bounds: new TimeRange(tr),
       chunkSize: opts.chunkSize ?? 1e5,
+      downsampleFactor: opts.downsampleFactor ?? 1,
     });
     return iter;
   }