@synnaxlabs/client 0.18.3 → 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.18.3",
+  "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/freighter": "0.9.4",
-    "@synnaxlabs/x": "0.15.3"
+    "@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",
+    "@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",
-    "eslint-config-synnaxlabs": "0.0.1",
-    "@synnaxlabs/vite-plugin": "0.0.1"
+    "@synnaxlabs/vite-plugin": "0.0.1",
+    "eslint-config-synnaxlabs": "0.0.1"
   },
   "main": "dist/client.cjs",
   "module": "dist/client.js",

package/src/channel/channel.spec.ts

@@ -193,4 +193,31 @@ describe("Channel", () => {
     expect(retrieved.length).toBeGreaterThan(0);
     retrieved.forEach((ch) => expect(ch.name).toEqual("test"));
   });
+
+  describe("delete", async () => {
+    test("delete by key", async () => {
+      const channel = await client.channels.create({
+        name: "test",
+        leaseholder: 1,
+        rate: Rate.hz(1),
+        dataType: DataType.FLOAT32,
+      });
+      await client.channels.delete(channel.key);
+      await expect(
+        async () => await client.channels.retrieve(channel.key),
+      ).rejects.toThrow(QueryError);
+    });
+    test("delete by name", async () => {
+      const channel = await client.channels.create({
+        name: "test",
+        leaseholder: 1,
+        rate: Rate.hz(1),
+        dataType: DataType.FLOAT32,
+      });
+      await client.channels.delete(["test"]);
+      await expect(
+        async () => await client.channels.retrieve(channel.key),
+      ).rejects.toThrow(QueryError);
+    });
+  });
 });

package/src/channel/client.ts

@@ -13,14 +13,13 @@ import {
   Rate,
   type TypedArray,
   type CrudeDensity,
-  type Series,
   type TimeRange,
   type AsyncTermSearcher,
   toArray,
   type CrudeTimeStamp,
+  type MultiSeries,
 } from "@synnaxlabs/x";
 
-import { type Creator } from "@/channel/creator";
 import {
   type Key,
   type KeyOrName,
@@ -36,7 +35,8 @@ import {
   DebouncedBatchRetriever,
   type Retriever,
 } from "@/channel/retriever";
-import { MultipleResultsError, NoResultsError, ValidationError } from "@/errors";
+import { type Writer } from "@/channel/writer";
+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);
   }
 }
 
@@ -170,20 +170,20 @@ export class Channel {
  */
 export class Client implements AsyncTermSearcher<string, Key, Channel> {
   private readonly frameClient: framer.Client;
-  readonly retriever: Retriever;
-  private readonly creator: Creator;
   private readonly client: UnaryClient;
+  readonly retriever: Retriever;
+  readonly writer: Writer;
 
   constructor(
     frameClient: framer.Client,
     retriever: Retriever,
     client: UnaryClient,
-    creator: Creator,
+    writer: Writer,
   ) {
     this.frameClient = frameClient;
     this.retriever = retriever;
     this.client = client;
-    this.creator = creator;
+    this.writer = writer;
   }
 
   /**
@@ -261,7 +261,7 @@ export class Client implements AsyncTermSearcher<string, Key, Channel> {
       toCreate = toCreate.filter((c) => !existingNames.has(c.name));
       created = this.sugar(res);
     }
-    created = created.concat(this.sugar(await this.creator.create(toCreate)));
+    created = created.concat(this.sugar(await this.writer.create(toCreate)));
     return single ? created[0] : created;
   }
 
@@ -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,12 +316,18 @@ 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];
   }
 
+  async delete(channels: Params): Promise<void> {
+    const { normalized, variant } = analyzeParams(channels);
+    if (variant === "keys") return await this.writer.delete({ keys: normalized });
+    return await this.writer.delete({ names: normalized });
+  }
+
   async search(term: string, rangeKey?: string): Promise<Channel[]> {
     return this.sugar(await this.retriever.search(term, rangeKey));
   }

package/src/channel/external.ts

@@ -7,7 +7,7 @@
 // License, use of this software will be governed by the Apache License, Version 2.0,
 // included in the file licenses/APL.txt.
 
-export * from "@/channel/creator";
+export * from "@/channel/writer";
 export * from "@/channel/client";
 export * from "@/channel/payload";
 export * from "@/channel/retriever";

package/src/channel/payload.ts

@@ -36,18 +36,8 @@ export const newPayload = payload.extend({
   key: z.number().optional(),
   leaseholder: z.number().optional(),
   index: z.number().optional(),
-  rate: Rate.z.optional(),
+  rate: Rate.z.optional().default(0),
   isIndex: z.boolean().optional(),
 });
 
 export type NewPayload = z.input<typeof newPayload>;
-
-export const parseChannels = (channels: NewPayload[]): NewPayload[] =>
-  channels.map((channel) => ({
-    name: channel.name,
-    dataType: channel.dataType,
-    rate: channel.rate ?? 0,
-    leaseholder: channel.leaseholder,
-    index: channel.index,
-    isIndex: channel.isIndex,
-  }));

package/src/channel/retriever.ts

@@ -22,7 +22,7 @@ import {
   type Payload,
   payload,
 } from "@/channel/payload";
-import { QueryError, ValidationError } from "@/errors";
+import { QueryError } from "@/errors";
 
 const reqZ = z.object({
   leaseholder: z.number().optional(),

package/src/channel/writer.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 { sendRequired, type UnaryClient } from "@synnaxlabs/freighter";
+import { z } from "zod";
+
+import {
+  type Payload,
+  payload,
+  newPayload,
+  type NewPayload,
+  keyZ,
+} from "@/channel/payload";
+
+const createReqZ = z.object({ channels: newPayload.array() });
+const createResZ = z.object({ channels: payload.array() });
+
+const deleteReqZ = z.object({
+  keys: keyZ.array().optional(),
+  names: z.string().array().optional(),
+});
+const deleteResZ = z.object({});
+
+const CREATE_ENDPOINT = "/channel/create";
+const DELETE_ENDPOINT = "/channel/delete";
+
+export type DeleteProps = z.input<typeof deleteReqZ>;
+
+export class Writer {
+  private readonly client: UnaryClient;
+
+  constructor(client: UnaryClient) {
+    this.client = client;
+  }
+
+  async create(channels: NewPayload[]): Promise<Payload[]> {
+    return (
+      await sendRequired<typeof createReqZ, typeof createResZ>(
+        this.client,
+        CREATE_ENDPOINT,
+        { channels },
+        createReqZ,
+        createResZ,
+      )
+    ).channels;
+  }
+
+  async delete(props: DeleteProps): Promise<void> {
+    await sendRequired<typeof deleteReqZ, typeof deleteResZ>(
+      this.client,
+      DELETE_ENDPOINT,
+      props,
+      deleteReqZ,
+      deleteResZ,
+    );
+  }
+}

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.Creator(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);
+    });
+  });
+});