@synnaxlabs/client 0.19.0 → 0.20.0

package/examples/node/package-lock.json

@@ -9,7 +9,7 @@
       "version": "1.0.0",
       "license": "ISC",
       "dependencies": {
-        "@synnaxlabs/client": "^0.18.2"
+        "@synnaxlabs/client": "^0.19.0"
       }
     },
     "node_modules/@grpc/grpc-js": {
@@ -3653,35 +3653,23 @@
       }
     },
     "node_modules/@synnaxlabs/client": {
-      "version": "0.18.2",
-      "resolved": "https://registry.npmjs.org/@synnaxlabs/client/-/client-0.18.2.tgz",
-      "integrity": "sha512-y/uetgJq4zeB+7HTqFZyMkLYe1cV4iU0gRc90V/kYvVwTtWt0F5aB2kpZi5ta4nJTFFczPSUwzHOQNVm0zUZOQ==",
+      "version": "0.19.0",
+      "resolved": "https://registry.npmjs.org/@synnaxlabs/client/-/client-0.19.0.tgz",
+      "integrity": "sha512-GS0TOznRbxMeRS1wMGo3tz91goM2tmaqN/QEUebfCY6UjTKAmLZEUKqtjQZGvrk/0k4euP5DoEf4i1YE0julCg==",
       "dependencies": {
-        "@synnaxlabs/freighter": "0.9.3",
-        "@synnaxlabs/x": "0.15.2",
+        "@synnaxlabs/freighter": "0.9.4",
+        "@synnaxlabs/x": "0.15.4",
         "async-mutex": "^0.4.0",
         "zod": "3.22.4"
       }
     },
-    "node_modules/@synnaxlabs/client/node_modules/@synnaxlabs/x": {
-      "version": "0.15.2",
-      "resolved": "https://registry.npmjs.org/@synnaxlabs/x/-/x-0.15.2.tgz",
-      "integrity": "sha512-d0XP4tk7dx7847aeXppAFVCKLmPSGIWRnsyDvTkbU9rEZdt1XLnQh1+PoWBmlYUNtliGhcgOKkbCv3Tj9Di38Q==",
-      "dependencies": {
-        "async-mutex": "^0.4.0",
-        "js-convert-case": "^4.2.0",
-        "nanoid": "^5.0.2",
-        "typescript": "^5.3.3",
-        "zod": "3.22.4"
-      }
-    },
     "node_modules/@synnaxlabs/freighter": {
-      "version": "0.9.3",
-      "resolved": "https://registry.npmjs.org/@synnaxlabs/freighter/-/freighter-0.9.3.tgz",
-      "integrity": "sha512-H8a4HePVykwlkQMw8yClJ/BpydMDieBD2HHC2bBcvfJKZ3w32uiAqvhqezy14aU2XgNG92hU65IBi2FT6esBng==",
+      "version": "0.9.4",
+      "resolved": "https://registry.npmjs.org/@synnaxlabs/freighter/-/freighter-0.9.4.tgz",
+      "integrity": "sha512-WgkpLPuJrX3DA5+6c3i+OGJ/aeTFcEVGb1vf1nz47GGzAMRI4LikVSvodG9FuM2i2oTWsdbJJJpweX84PKDRvw==",
       "dependencies": {
         "@synnaxlabs/alamos": "0.3.0",
-        "@synnaxlabs/x": "0.15.0",
+        "@synnaxlabs/x": "0.15.3",
         "js-convert-case": "^4.2.0",
         "node-fetch": "2.6.11",
         "ws": "^8.15.1",
@@ -3691,14 +3679,25 @@
         "node": ">=18"
       }
     },
+    "node_modules/@synnaxlabs/freighter/node_modules/@synnaxlabs/x": {
+      "version": "0.15.3",
+      "resolved": "https://registry.npmjs.org/@synnaxlabs/x/-/x-0.15.3.tgz",
+      "integrity": "sha512-gVIh1xSvvIlkuOr4QPMeFdzAStX+YhSjL2Pc7sytxDnm0iYhIJn+4kGSBE7GAqBqFbaeaIVNoo1Iif4v+mlYOg==",
+      "dependencies": {
+        "async-mutex": "^0.4.0",
+        "js-convert-case": "^4.2.0",
+        "nanoid": "^5.0.2",
+        "typescript": "^5.3.3",
+        "zod": "3.22.4"
+      }
+    },
     "node_modules/@synnaxlabs/x": {
-      "version": "0.15.0",
-      "resolved": "https://registry.npmjs.org/@synnaxlabs/x/-/x-0.15.0.tgz",
-      "integrity": "sha512-baowvPsc0oKeMscKHh/5u0WVRB7J3ylIYzkx8feyP67QkjE8PCQpf0gmdThMGg6r0HwUbubzTcD0N64TNvahWw==",
+      "version": "0.15.4",
+      "resolved": "https://registry.npmjs.org/@synnaxlabs/x/-/x-0.15.4.tgz",
+      "integrity": "sha512-uk9A+wDy5d0F3grB3M/sIxpetj7Zs06nMpgMw/6AKc7op+GWoqqh2ohhnV4LxEDtku9CfDYySa1OngtCGZKzDA==",
       "dependencies": {
         "async-mutex": "^0.4.0",
         "js-convert-case": "^4.2.0",
-        "msgpackr": "^1.9.9",
         "nanoid": "^5.0.2",
         "typescript": "^5.3.3",
         "zod": "3.22.4"
@@ -3770,9 +3769,9 @@
       }
     },
     "node_modules/@types/express-serve-static-core": {
-      "version": "4.17.43",
-      "resolved": "https://registry.npmjs.org/@types/express-serve-static-core/-/express-serve-static-core-4.17.43.tgz",
-      "integrity": "sha512-oaYtiBirUOPQGSWNGPWnzyAFJ0BP3cwvN4oWZQY+zUBwpVIGsKUkpBpSztp74drYcjavs7SKFZ4DX1V2QeN8rg==",
+      "version": "4.19.0",
+      "resolved": "https://registry.npmjs.org/@types/express-serve-static-core/-/express-serve-static-core-4.19.0.tgz",
+      "integrity": "sha512-bGyep3JqPCRry1wq+O5n7oiBgGWmeIJXPjXXCo8EK0u8duZGSYar7cGqd3ML2JUsLGeB7fmc06KYo9fLGWqPvQ==",
       "dependencies": {
         "@types/node": "*",
         "@types/qs": "*",
@@ -3898,9 +3897,9 @@
       }
     },
     "node_modules/@types/node": {
-      "version": "20.12.4",
-      "resolved": "https://registry.npmjs.org/@types/node/-/node-20.12.4.tgz",
-      "integrity": "sha512-E+Fa9z3wSQpzgYQdYmme5X3OTuejnnTx88A6p6vkkJosR3KBz+HpE3kqNm98VE6cfLFcISx7zW7MsJkH6KwbTw==",
+      "version": "20.12.7",
+      "resolved": "https://registry.npmjs.org/@types/node/-/node-20.12.7.tgz",
+      "integrity": "sha512-wq0cICSkRLVaf3UGLMGItu/PtdY7oaXaI/RVU+xliKVOtRna3PRY57ZDfztpDL0n11vfymMUnXv8QwYCO7L1wg==",
       "dependencies": {
         "undici-types": "~5.26.4"
       }
@@ -3924,9 +3923,9 @@
       }
     },
     "node_modules/@types/qs": {
-      "version": "6.9.14",
-      "resolved": "https://registry.npmjs.org/@types/qs/-/qs-6.9.14.tgz",
-      "integrity": "sha512-5khscbd3SwWMhFqylJBLQ0zIu7c1K6Vz0uBIt915BI3zV0q1nfjRQD3RqSBcPaO6PHEF4ov/t9y89fSiyThlPA=="
+      "version": "6.9.15",
+      "resolved": "https://registry.npmjs.org/@types/qs/-/qs-6.9.15.tgz",
+      "integrity": "sha512-uXHQKES6DQKKCLh441Xv/dwxOq1TVS3JPUMlEqoEglvlhR6Mxnlew/Xq/LRVHpLyk7iK3zODe1qYHIMltO7XGg=="
     },
     "node_modules/@types/range-parser": {
       "version": "1.2.7",
@@ -4426,9 +4425,9 @@
       }
     },
     "node_modules/gaxios": {
-      "version": "6.4.0",
-      "resolved": "https://registry.npmjs.org/gaxios/-/gaxios-6.4.0.tgz",
-      "integrity": "sha512-apAloYrY4dlBGlhauDAYSZveafb5U6+L9titing1wox6BvWM0TSXBp603zTrLpyLMGkrcFgohnUN150dFN/zOA==",
+      "version": "6.5.0",
+      "resolved": "https://registry.npmjs.org/gaxios/-/gaxios-6.5.0.tgz",
+      "integrity": "sha512-R9QGdv8j4/dlNoQbX3hSaK/S0rkMijqjVvW3YM06CoBdbU/VdKd159j4hePpng0KuE6Lh6JJ7UdmVGJZFcAG1w==",
       "dependencies": {
         "extend": "^3.0.2",
         "https-proxy-agent": "^7.0.1",
@@ -4525,9 +4524,9 @@
       }
     },
     "node_modules/joi": {
-      "version": "17.12.3",
-      "resolved": "https://registry.npmjs.org/joi/-/joi-17.12.3.tgz",
-      "integrity": "sha512-2RRziagf555owrm9IRVtdKynOBeITiDpuZqIpgwqXShPncPKNiRQoiGsl/T8SQdq+8ugRzH2LqY67irr2y/d+g==",
+      "version": "17.13.0",
+      "resolved": "https://registry.npmjs.org/joi/-/joi-17.13.0.tgz",
+      "integrity": "sha512-9qcrTyoBmFZRNHeVP4edKqIUEgFzq7MHvTNSDuHSqkpOPtiBkgNgcmTSqmiw1kw9tdKaiddvIDv/eCJDxmqWCA==",
       "dependencies": {
         "@hapi/hoek": "^9.3.0",
         "@hapi/topo": "^5.1.0",
@@ -4615,9 +4614,9 @@
       }
     },
     "node_modules/nanoid": {
-      "version": "5.0.6",
-      "resolved": "https://registry.npmjs.org/nanoid/-/nanoid-5.0.6.tgz",
-      "integrity": "sha512-rRq0eMHoGZxlvaFOUdK1Ev83Bd1IgzzR+WJ3IbDJ7QOSdAxYjlurSPqFs9s4lJg29RT6nPwizFtJhQS6V5xgiA==",
+      "version": "5.0.7",
+      "resolved": "https://registry.npmjs.org/nanoid/-/nanoid-5.0.7.tgz",
+      "integrity": "sha512-oLxFY2gd2IqnjcYyOXD8XGCftpGtZP2AbHbOkthDkvRywH5ayNtPVy9YlOPcHckXzbLTCHpkb7FB+yuxKV13pQ==",
       "funding": [
         {
           "type": "github",
@@ -4854,9 +4853,9 @@
       "integrity": "sha512-AEYxH93jGFPn/a2iVAwW87VuUIkR1FVUKB77NwMF7nBTDkDrrT/Hpt/IrCJ0QXhW27jTBDcf5ZY7w6RiqTMw2Q=="
     },
     "node_modules/typescript": {
-      "version": "5.4.3",
-      "resolved": "https://registry.npmjs.org/typescript/-/typescript-5.4.3.tgz",
-      "integrity": "sha512-KrPd3PKaCLr78MalgiwJnA25Nm8HAmdwN3mYUYZgG/wizIo9EainNVQI9/yDavtVFRN2h3k8uf3GLHuhDMgEHg==",
+      "version": "5.4.5",
+      "resolved": "https://registry.npmjs.org/typescript/-/typescript-5.4.5.tgz",
+      "integrity": "sha512-vcI4UpRgg81oIRUFwR0WSIHKt11nJ7SAVlYNIu+QpqeyXP+gpQJy/Z4+F0aGxSE4MqwjyXvW/TzgkLAx2AGHwQ==",
       "bin": {
         "tsc": "bin/tsc",
         "tsserver": "bin/tsserver"

package/examples/node/package.json

@@ -11,6 +11,6 @@
   "author": "",
   "license": "ISC",
   "dependencies": {
-    "@synnaxlabs/client": "^0.18.2"
+    "@synnaxlabs/client": "^0.19.0"
   }
-}
+}

package/examples/node/streamWrite.js

@@ -48,7 +48,7 @@ const roughRate = Rate.hz(40);
 // historical reads every 500 samples.
 const commitInterval = 500;
 
-const writer = await client.telem.openWriter({
+const writer = await client.openWriter({
     start, 
     channels: [timeChannel.key, dataChannel1.key, dataChannel2.key]
 });

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@synnaxlabs/client",
   "private": false,
-  "version": "0.19.0",
+  "version": "0.20.0",
   "type": "module",
   "description": "The Client Library for Synnax",
   "repository": "https://github.com/synnaxlabs/synnax/tree/main/client/ts",
@@ -16,21 +16,21 @@
     "control systems"
   ],
   "dependencies": {
-    "async-mutex": "^0.4.0",
+    "async-mutex": "^0.4.1",
     "zod": "3.22.4",
-    "@synnaxlabs/x": "0.15.4",
-    "@synnaxlabs/freighter": "0.9.4"
+    "@synnaxlabs/freighter": "0.9.4",
+    "@synnaxlabs/x": "0.16.0"
   },
   "devDependencies": {
-    "@types/node": "^20.10.5",
-    "@vitest/coverage-v8": "^1.2.2",
-    "eslint": "^8.55.0",
-    "typescript": "^5.3.3",
-    "vite": "^5.1.2",
-    "vitest": "^1.2.2",
-    "eslint-config-synnaxlabs": "0.0.1",
+    "@types/node": "^20.12.7",
+    "@vitest/coverage-v8": "1.2.2",
+    "eslint": "^8.57.0",
+    "typescript": "^5.4.5",
+    "vite": "5.1.2",
+    "vitest": "1.2.2",
+    "@synnaxlabs/tsconfig": "0.0.2",
     "@synnaxlabs/vite-plugin": "0.0.1",
-    "@synnaxlabs/tsconfig": "0.0.2"
+    "eslint-config-synnaxlabs": "0.0.1"
   },
   "main": "dist/client.cjs",
   "module": "dist/client.js",

package/src/channel/client.ts

@@ -13,11 +13,11 @@ import {
   Rate,
   type TypedArray,
   type CrudeDensity,
-  type Series,
   type TimeRange,
   type AsyncTermSearcher,
   toArray,
   type CrudeTimeStamp,
+  type MultiSeries,
 } from "@synnaxlabs/x";
 
 import {
@@ -36,7 +36,7 @@ import {
   type Retriever,
 } from "@/channel/retriever";
 import { type Writer } from "@/channel/writer";
-import { MultipleResultsError, NoResultsError, ValidationError } from "@/errors";
+import { MultipleFoundError, NotFoundError, ValidationError } from "@/errors";
 import { type framer } from "@/framer";
 
 interface CreateOptions {
@@ -148,7 +148,7 @@ export class Channel {
    * @param end - The ending timestamp of the range to read from.
    * @returns A typed array containing the retrieved
    */
-  async read(tr: TimeRange): Promise<Series | undefined> {
+  async read(tr: TimeRange): Promise<MultiSeries> {
     return await this.framer.read(tr, this.key);
   }
 
@@ -159,7 +159,7 @@ export class Channel {
    * @param data - THe telemetry to write to the channel.
    */
   async write(start: CrudeTimeStamp, data: TypedArray): Promise<void> {
-    return await this.framer.write(this.key, start, data);
+    return await this.framer.write(start, this.key, data);
   }
 }
 
@@ -277,7 +277,7 @@ export class Client implements AsyncTermSearcher<string, Key, Channel> {
    *
    * @returns The retrieved channel.
    * @throws {NotFoundError} if the channel does not exist in the cluster.
-   * @throws {MultipleResultsError} is only thrown if the channel is retrieved by name,
+   * @throws {MultipleFoundError} is only thrown if the channel is retrieved by name,
    * and multiple channels with the same name exist in the cluster.
    *
    * @example
@@ -316,9 +316,9 @@ export class Client implements AsyncTermSearcher<string, Key, Channel> {
     const res = this.sugar(await this.retriever.retrieve(channels, rangeKey));
     if (!single) return res;
     if (res.length === 0)
-      throw new NoResultsError(`channel matching ${actual} not found`);
+      throw new NotFoundError(`channel matching ${actual} not found`);
     if (res.length > 1)
-      throw new MultipleResultsError(`multiple channels matching ${actual} found`);
+      throw new MultipleFoundError(`multiple channels matching ${actual} found`);
     return res[0];
   }
 

package/src/client.ts

@@ -47,10 +47,9 @@ export type ParsedSynnaxProps = z.output<typeof synnaxPropsZ>;
  * @property ontology - Client for querying the cluster's ontology.
  */
 // eslint-disable-next-line import/no-default-export
-export default class Synnax {
+export default class Synnax extends framer.Client {
   readonly createdAt: TimeStamp;
   readonly props: ParsedSynnaxProps;
-  readonly telem: framer.Client;
   readonly ranges: ranger.Client;
   readonly channels: channel.Client;
   readonly auth: auth.Client | undefined;
@@ -77,42 +76,40 @@ export default class Synnax {
    * A Synnax client must be closed when it is no longer needed. This will stop
    * the client from polling the cluster for connectivity information.
    */
-  constructor(props: SynnaxProps) {
-    this.createdAt = TimeStamp.now();
-    this.props = synnaxPropsZ.parse(props);
-    const { host, port, username, password, connectivityPollFrequency, secure } =
-      this.props;
-    this.transport = new Transport(new URL({ host, port: Number(port) }), secure);
-    this.transport.use(errorsMiddleware);
+  constructor(props_: SynnaxProps) {
+    const props = synnaxPropsZ.parse(props_);
+    const { host, port, username, password, connectivityPollFrequency, secure } = props;
+    const transport = new Transport(new URL({ host, port: Number(port) }), secure);
+    transport.use(errorsMiddleware);
+    let auth_: auth.Client | undefined;
     if (username != null && password != null) {
-      this.auth = new auth.Client(this.transport.unary, {
+      const auth_ = new auth.Client(transport.unary, {
         username,
         password,
       });
-      this.transport.use(this.auth.middleware());
+      transport.use(auth_.middleware());
     }
     const chRetriever = new channel.CacheRetriever(
-      new channel.ClusterRetriever(this.transport.unary),
-    );
-    const chCreator = new channel.Writer(this.transport.unary);
-    this.telem = new framer.Client(this.transport.stream, chRetriever);
-    this.channels = new channel.Client(
-      this.telem,
-      chRetriever,
-      this.transport.unary,
-      chCreator,
+      new channel.ClusterRetriever(transport.unary),
     );
+    const chCreator = new channel.Writer(transport.unary);
+    super(transport.stream, chRetriever);
+    this.createdAt = TimeStamp.now();
+    this.props = props;
+    this.auth = auth_;
+    this.transport = transport;
+    this.channels = new channel.Client(this, chRetriever, transport.unary, chCreator);
     this.connectivity = new connection.Checker(
-      this.transport.unary,
+      transport.unary,
       connectivityPollFrequency,
       props.name,
     );
-    this.ontology = new ontology.Client(this.transport.unary, this.telem);
-    const rangeRetriever = new ranger.Retriever(this.transport.unary);
+    this.ontology = new ontology.Client(transport.unary, this);
+    const rangeRetriever = new ranger.Retriever(transport.unary);
     const rangeWriter = new ranger.Writer(this.transport.unary);
-    this.labels = new label.Client(this.transport.unary, this.telem);
+    this.labels = new label.Client(this.transport.unary, this);
     this.ranges = new ranger.Client(
-      this.telem,
+      this,
       rangeRetriever,
       rangeWriter,
       this.transport.unary,
@@ -123,7 +120,7 @@ export default class Synnax {
     const devices = new device.Client(
       new device.Retriever(this.transport.unary),
       new device.Writer(this.transport.unary),
-      this.telem,
+      this,
     );
     const taskRetriever = new task.Retriever(this.transport.unary);
     const taskWriter = new task.Writer(this.transport.unary);
@@ -131,7 +128,7 @@ export default class Synnax {
     const racks = new rack.Client(
       new rack.Retriever(this.transport.unary),
       new rack.Writer(this.transport.unary),
-      this.telem,
+      this,
       taskWriter,
       taskRetriever,
     );

package/src/control/state.spec.ts

@@ -16,9 +16,9 @@ const client = newClient();
 
 describe("state", () => {
   it("should receive the initial control state from the cluster", async () => {
-    const s = await control.StateTracker.open(client.telem);
+    const s = await control.StateTracker.open(client);
     await new Promise((resolve) => setTimeout(resolve, 50));
     expect(s.states.size).toBeGreaterThan(0);
-    s.close();
+    await s.close();
   });
 });

package/src/errors.ts

@@ -95,9 +95,9 @@ export class UnexpectedError extends BaseError {
  */
 export class QueryError extends BaseError {}
 
-export class NoResultsError extends QueryError {}
+export class NotFoundError extends QueryError {}
 
-export class MultipleResultsError extends QueryError {}
+export class MultipleFoundError extends QueryError {}
 
 /**
  * RouteError is raised when a routing error occurs.

package/src/framer/client.spec.ts

@@ -0,0 +1,63 @@
+// Copyright 2023 Synnax Labs, Inc.
+//
+// Use of this software is governed by the Business Source License included in the file
+// licenses/BSL.txt.
+//
+// As of the Change Date specified in that file, in accordance with the Business Source
+// License, use of this software will be governed by the Apache License, Version 2.0,
+// included in the file licenses/APL.txt.
+
+import { TimeSpan, TimeStamp } from "@synnaxlabs/x";
+import { describe, expect, it } from "vitest";
+
+import { newClient } from "@/setupspecs";
+
+const client = newClient();
+
+describe("Client", () => {
+  describe("read + write", () => {
+    it("should correctly write and read a frame of data", async () => {
+      const rand = `${TimeStamp.now().toString()}${Math.random()}`;
+      const time = await client.channels.create({
+        name: `time-${rand}`,
+        dataType: "timestamp",
+        isIndex: true,
+      });
+      const data = await client.channels.create({
+        name: `data-${rand}`,
+        dataType: "float32",
+        index: time.key,
+      });
+      const start = TimeStamp.now();
+      await client.write(start, {
+        [time.key]: [start],
+        [data.key]: [1],
+      });
+      const frame = await client.read(
+        {
+          start,
+          end: start.add(TimeSpan.seconds(1)),
+        },
+        [time.key, data.key],
+      );
+      expect(Array.from(frame.get(time.key))).toEqual([start.valueOf()]);
+      expect(Array.from(frame.get(data.key))).toEqual([1]);
+    });
+    it("should correctly write a single series of data", async () => {
+      const rand = `${TimeStamp.now().toString()}${Math.random()}`;
+      const time = await client.channels.create({
+        name: `time-${rand}`,
+        dataType: "timestamp",
+        isIndex: true,
+      });
+      const data = await client.channels.create({
+        name: `data-${rand}`,
+        dataType: "float32",
+        index: time.key,
+      });
+      const start = TimeStamp.now();
+      await client.write(start, time.key, TimeStamp.now());
+      await client.write(start, data.key, 1);
+    });
+  });
+});

package/src/framer/client.ts

@@ -9,13 +9,13 @@
 
 import { type StreamClient } from "@synnaxlabs/freighter";
 import {
-  type Series,
-  type TimeRange,
   type CrudeTimeStamp,
   type CrudeSeries,
+  type CrudeTimeRange,
+  type MultiSeries,
 } from "@synnaxlabs/x";
 
-import { type KeyOrName, type Params } from "@/channel/payload";
+import { type KeysOrNames, type KeyOrName, type Params } from "@/channel/payload";
 import { type Retriever, analyzeParams } from "@/channel/retriever";
 import { Frame } from "@/framer/frame";
 import { Iterator } from "@/framer/iterator";
@@ -38,7 +38,7 @@ export class Client {
    * @param keys - A list of channel keys to iterate over.
    * @returns a new {@link TypedIterator}.
    */
-  async openIterator(tr: TimeRange, channels: Params): Promise<Iterator> {
+  async openIterator(tr: CrudeTimeRange, channels: Params): Promise<Iterator> {
     return await Iterator._open(tr, channels, this.retriever, this.stream);
   }
 
@@ -84,45 +84,77 @@ export class Client {
     return await Streamer._open(this.retriever, this.stream, config as StreamerConfig);
   }
 
+  async write(
+    start: CrudeTimeStamp,
+    channel: KeyOrName,
+    data: CrudeSeries,
+  ): Promise<void>;
+
+  async write(
+    start: CrudeTimeStamp,
+    channels: KeysOrNames,
+    data: CrudeSeries[],
+  ): Promise<void>;
+
+  async write(
+    start: CrudeTimeStamp,
+    data: Record<KeyOrName, CrudeSeries>,
+  ): Promise<void>;
+
   /**
    * Writes telemetry to the given channel starting at the given timestamp.
    *
-   * @param channel - The key of the channel to write to.
+   * @param channels - The key of the channel to write to.
    * @param start - The starting timestamp of the first sample in data.
    * @param data  - The telemetry to write. This telemetry must have the same
    * data type as the channel.
    * @throws if the channel does not exist.
    */
   async write(
-    channel: KeyOrName,
     start: CrudeTimeStamp,
-    data: CrudeSeries,
+    channels: Params | Record<KeyOrName, CrudeSeries>,
+    data?: CrudeSeries | CrudeSeries[],
   ): Promise<void> {
+    if (data == null) {
+      const data_ = channels as Record<KeyOrName, CrudeSeries>;
+      const w = await this.openWriter({
+        start,
+        channels: Object.keys(data_),
+        mode: WriterMode.PersistOnly,
+      });
+      try {
+        await w.write(data_);
+        await w.commit();
+      } finally {
+        await w.close();
+      }
+      return;
+    }
     const w = await this.openWriter({
       start,
-      channels: channel,
+      channels: channels as Params,
       mode: WriterMode.PersistOnly,
     });
     try {
-      await w.write(channel, data);
+      await w.write(channels as Params, data);
       await w.commit();
     } finally {
       await w.close();
     }
   }
 
-  async read(tr: TimeRange, channel: KeyOrName): Promise<Series>;
+  async read(tr: CrudeTimeRange, channel: KeyOrName): Promise<MultiSeries>;
 
-  async read(tr: TimeRange, channels: Params): Promise<Frame>;
+  async read(tr: CrudeTimeRange, channels: Params): Promise<Frame>;
 
-  async read(tr: TimeRange, channels: Params): Promise<Series | Frame> {
+  async read(tr: CrudeTimeRange, channels: Params): Promise<MultiSeries | Frame> {
     const { single } = analyzeParams(channels);
     const fr = await this.readFrame(tr, channels);
-    if (single) return fr.series[0];
+    if (single) return fr.get(channels as KeyOrName);
     return fr;
   }
 
-  private async readFrame(tr: TimeRange, params: Params): Promise<Frame> {
+  private async readFrame(tr: CrudeTimeRange, params: Params): Promise<Frame> {
     const i = await this.openIterator(tr, params);
     const frame = new Frame();
     try {

package/src/framer/iterator.spec.ts

@@ -28,7 +28,7 @@ const newChannel = async (): Promise<channel.Channel> => {
 describe("Iterator", () => {
   test("happy path", async () => {
     const ch = await newChannel();
-    const writer = await client.telem.openWriter({
+    const writer = await client.openWriter({
       start: TimeStamp.SECOND,
       channels: ch.key,
     });
@@ -42,7 +42,7 @@ describe("Iterator", () => {
       await writer.close();
     }
 
-    const iter = await client.telem.openIterator(
+    const iter = await client.openIterator(
       new TimeRange(TimeSpan.ZERO, TimeSpan.seconds(4)),
       [ch.key],
     );

package/src/framer/iterator.ts

@@ -14,6 +14,7 @@ import {
   TimeRange,
   TimeSpan,
   TimeStamp,
+  type CrudeTimeRange,
 } from "@synnaxlabs/x";
 import { z } from "zod";
 
@@ -92,7 +93,7 @@ export class Iterator {
    * @param keys - The keys of the channels to iterate over.
    */
   static async _open(
-    tr: TimeRange,
+    tr: CrudeTimeRange,
     channels: Params,
     retriever: Retriever,
     client: StreamClient,
@@ -100,7 +101,11 @@ export class Iterator {
     const adapter = await ReadFrameAdapter.open(retriever, channels);
     const stream = await client.stream(Iterator.ENDPOINT, reqZ, resZ);
     const iter = new Iterator(stream, adapter);
-    await iter.execute({ command: Command.Open, keys: adapter.keys, bounds: tr });
+    await iter.execute({
+      command: Command.Open,
+      keys: adapter.keys,
+      bounds: new TimeRange(tr),
+    });
     return iter;
   }