@synnaxlabs/client 0.38.0 → 0.39.0

package/src/channel/payload.ts

@@ -1,4 +1,4 @@
-// Copyright 2024 Synnax Labs, Inc.
+// Copyright 2025 Synnax Labs, Inc.
 //
 // Use of this software is governed by the Business Source License included in the file
 // licenses/BSL.txt.
@@ -10,25 +10,25 @@
 import { DataType, Rate } from "@synnaxlabs/x/telem";
 import { z } from "zod";
 
-import { ontology } from "@/ontology";
 import { nullableArrayZ } from "@/util/zod";
 
 export const keyZ = z.number();
-export type Key = number;
-export type Keys = number[];
-export type Name = string;
-export type Names = string[];
+export type Key = z.infer<typeof keyZ>;
+export type Keys = Key[];
+export const nameZ = z.string();
+export type Name = z.infer<typeof nameZ>;
+export type Names = Name[];
 export type KeyOrName = Key | Name;
 export type KeysOrNames = Keys | Names;
 export type Params = Key | Name | Keys | Names;
 
-export const payload = z.object({
-  name: z.string(),
-  key: z.number(),
+export const channelZ = z.object({
+  name: nameZ,
+  key: keyZ,
   rate: Rate.z,
   dataType: DataType.z,
   leaseholder: z.number(),
-  index: z.number(),
+  index: keyZ,
   isIndex: z.boolean(),
   internal: z.boolean(),
   virtual: z.boolean(),
@@ -36,13 +36,12 @@ export const payload = z.object({
   expression: z.string().default(""),
   requires: nullableArrayZ(keyZ),
 });
+export interface Payload extends z.infer<typeof channelZ> {}
 
-export type Payload = z.infer<typeof payload>;
-
-export const newPayload = payload.extend({
-  key: z.number().optional(),
+export const newZ = channelZ.extend({
+  key: keyZ.optional(),
   leaseholder: z.number().optional(),
-  index: z.number().optional(),
+  index: keyZ.optional(),
   rate: Rate.z.optional().default(0),
   isIndex: z.boolean().optional(),
   internal: z.boolean().optional().default(false),
@@ -50,10 +49,7 @@ export const newPayload = payload.extend({
   expression: z.string().optional().default(""),
   requires: nullableArrayZ(keyZ).optional().default([]),
 });
+export interface New extends z.input<typeof newZ> {}
 
-export type NewPayload = z.input<typeof newPayload>;
-
-export const ONTOLOGY_TYPE: ontology.ResourceType = "channel";
-
-export const ontologyID = (key: Key): ontology.ID =>
-  new ontology.ID({ type: ONTOLOGY_TYPE, key: key.toString() });
+export const ONTOLOGY_TYPE = "channel";
+export type OntologyType = typeof ONTOLOGY_TYPE;

package/src/channel/retriever.ts

@@ -1,4 +1,4 @@
-// Copyright 2024 Synnax Labs, Inc.
+// Copyright 2025 Synnax Labs, Inc.
 //
 // Use of this software is governed by the Business Source License included in the file
 // licenses/BSL.txt.
@@ -6,28 +6,33 @@
 // 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 type { UnaryClient } from "@synnaxlabs/freighter";
+
+import { type UnaryClient } from "@synnaxlabs/freighter";
 import { debounce } from "@synnaxlabs/x/debounce";
 import { DataType } from "@synnaxlabs/x/telem";
 import { Mutex } from "async-mutex";
 import { z } from "zod";
 
 import {
+  channelZ,
   type Key,
   type KeyOrName,
   type Keys,
   type KeysOrNames,
+  keyZ,
   type Params,
   type Payload,
-  payload,
 } from "@/channel/payload";
 import { QueryError } from "@/errors";
-import { analyzeParams, type ParamAnalysisResult } from "@/util/retrieve";
+import {
+  analyzeParams as analyzeParameters,
+  type ParamAnalysisResult,
+} from "@/util/retrieve";
 import { nullableArrayZ } from "@/util/zod";
 
 const reqZ = z.object({
   leaseholder: z.number().optional(),
-  keys: z.number().array().optional(),
+  keys: keyZ.array().optional(),
   names: z.string().array().optional(),
   search: z.string().optional(),
   rangeKey: z.string().optional(),
@@ -39,23 +44,17 @@ const reqZ = z.object({
   isIndex: z.boolean().optional(),
   internal: z.boolean().optional(),
 });
+interface Request extends z.input<typeof reqZ> {}
 
-type Request = z.input<typeof reqZ>;
+export interface RetrieveOptions extends Omit<Request, "keys" | "names" | "search"> {}
+export interface PageOptions extends Omit<RetrieveOptions, "offset" | "limit"> {}
 
-export type RetrieveOptions = Omit<Request, "keys" | "names" | "search">;
-export type PageOptions = Omit<RetrieveOptions, "offset" | "limit">;
+const resZ = z.object({ channels: nullableArrayZ(channelZ) });
 
-const resZ = z.object({
-  channels: nullableArrayZ(payload),
-});
-
-export const analyzeChannelParams = (
+export const analyzeParams = (
   channels: Params,
 ): ParamAnalysisResult<KeyOrName, { number: "keys"; string: "names" }> =>
-  analyzeParams(channels, {
-    number: "keys",
-    string: "names",
-  });
+  analyzeParameters(channels, { number: "keys", string: "names" });
 
 export interface Retriever {
   retrieve: (channels: Params, opts?: RetrieveOptions) => Promise<Payload[]>;
@@ -76,7 +75,7 @@ export class ClusterRetriever implements Retriever {
   }
 
   async retrieve(channels: Params, options?: RetrieveOptions): Promise<Payload[]> {
-    const res = analyzeChannelParams(channels);
+    const res = analyzeParams(channels);
     const { variant } = res;
     let { normalized } = res;
     if (variant === "keys" && (normalized as Key[]).indexOf(0) !== -1)
@@ -121,7 +120,7 @@ export class CacheRetriever implements Retriever {
   }
 
   async retrieve(channels: Params, options?: RetrieveOptions): Promise<Payload[]> {
-    const { normalized } = analyzeParams<string | number>(channels, {
+    const { normalized } = analyzeParameters<string | number>(channels, {
       string: "names",
       number: "keys",
     });
@@ -139,7 +138,7 @@ export class CacheRetriever implements Retriever {
   }
 
   delete(channels: Params): void {
-    const { variant, normalized } = analyzeChannelParams(channels);
+    const { variant, normalized } = analyzeParams(channels);
     if (variant === "names")
       (normalized as string[]).forEach((name) => {
         const keys = this.namesToKeys.get(name);
@@ -234,7 +233,7 @@ export class DebouncedBatchRetriever implements Retriever {
   }
 
   async retrieve(channels: Params): Promise<Payload[]> {
-    const { normalized, variant } = analyzeChannelParams(channels);
+    const { normalized, variant } = analyzeParams(channels);
     // Bypass on name fetches for now.
     if (variant === "names") return await this.wrapped.retrieve(normalized);
 
@@ -269,7 +268,7 @@ export const retrieveRequired = async (
   r: Retriever,
   channels: Params,
 ): Promise<Payload[]> => {
-  const { normalized } = analyzeChannelParams(channels);
+  const { normalized } = analyzeParams(channels);
   const results = await r.retrieve(normalized);
   const notFound: KeyOrName[] = [];
   normalized.forEach((v) => {

package/src/channel/writer.ts

@@ -1,4 +1,4 @@
-// Copyright 2024 Synnax Labs, Inc.
+// Copyright 2025 Synnax Labs, Inc.
 //
 // Use of this software is governed by the Business Source License included in the file
 // licenses/BSL.txt.
@@ -11,36 +11,34 @@ import { sendRequired, type UnaryClient } from "@synnaxlabs/freighter";
 import { z } from "zod";
 
 import {
+  channelZ,
   type Key,
   keyZ,
-  type NewPayload,
-  newPayload,
+  nameZ,
+  type New,
+  newZ,
   type Payload,
-  payload,
 } from "@/channel/payload";
 import { type CacheRetriever } from "@/channel/retriever";
 
-const createReqZ = z.object({ channels: newPayload.array() });
-const createResZ = z.object({ channels: payload.array() });
+const createReqZ = z.object({ channels: newZ.array() });
+const createResZ = z.object({ channels: channelZ.array() });
 
 const deleteReqZ = z.object({
   keys: keyZ.array().optional(),
-  names: z.string().array().optional(),
+  names: nameZ.array().optional(),
 });
 const deleteResZ = z.object({});
 
-const renameReqZ = z.object({
-  keys: keyZ.array(),
-  names: z.string().array(),
-});
+const renameReqZ = z.object({ keys: keyZ.array(), names: nameZ.array() });
 const renameResZ = z.object({});
 
 const CREATE_ENDPOINT = "/channel/create";
 const DELETE_ENDPOINT = "/channel/delete";
 const RENAME_ENDPOINT = "/channel/rename";
 
-export type DeleteProps = z.input<typeof deleteReqZ>;
-export type RenameProps = z.input<typeof renameReqZ>;
+export interface DeleteProps extends z.input<typeof deleteReqZ> {}
+export interface RenameProps extends z.input<typeof renameReqZ> {}
 
 export class Writer {
   private readonly client: UnaryClient;
@@ -51,7 +49,7 @@ export class Writer {
     this.cache = cache;
   }
 
-  async create(channels: NewPayload[]): Promise<Payload[]> {
+  async create(channels: New[]): Promise<Payload[]> {
     const { channels: created } = await sendRequired<
       typeof createReqZ,
       typeof createResZ

package/src/client.ts

@@ -1,4 +1,4 @@
-// Copyright 2024 Synnax Labs, Inc.
+// Copyright 2025 Synnax Labs, Inc.
 //
 // Use of this software is governed by the Business Source License included in the file
 // licenses/BSL.txt.
@@ -31,20 +31,10 @@ import { user } from "@/user";
 import { workspace } from "@/workspace";
 
 export const synnaxPropsZ = z.object({
-  host: z
-    .string({
-      required_error: "Host is required",
-    })
-    .min(1, "Host is required"),
+  host: z.string({ required_error: "Host is required" }).min(1, "Host is required"),
   port: z
-    .number({
-      required_error: "Port is required",
-    })
-    .or(
-      z.string({
-        required_error: "Port is required",
-      }),
-    ),
+    .number({ required_error: "Port is required" })
+    .or(z.string({ required_error: "Port is required" })),
   username: z.string().min(1, "Username is required"),
   password: z.string().min(1, "Password is required"),
   connectivityPollFrequency: TimeSpan.z.default(TimeSpan.seconds(30)),
@@ -53,8 +43,8 @@ export const synnaxPropsZ = z.object({
   retry: breaker.breakerConfig.optional(),
 });
 
-export type SynnaxProps = z.input<typeof synnaxPropsZ>;
-export type ParsedSynnaxProps = z.output<typeof synnaxPropsZ>;
+export interface SynnaxProps extends z.input<typeof synnaxPropsZ> {}
+export interface ParsedSynnaxProps extends z.output<typeof synnaxPropsZ> {}
 
 /**
  * Client to perform operations against a Synnax cluster.
@@ -161,7 +151,7 @@ export default class Synnax extends framer.Client {
       this.ontology,
       this.ranges,
     );
-    const racks = new rack.Client(this.transport.unary, this, tasks);
+    const racks = new rack.Client(this.transport.unary, tasks);
     this.hardware = new hardware.Client(tasks, racks, devices);
   }
 

package/src/connection/checker.ts

@@ -1,4 +1,4 @@
-// Copyright 2024 Synnax Labs, Inc.
+// Copyright 2025 Synnax Labs, Inc.
 //
 // Use of this software is governed by the Business Source License included in the file
 // licenses/BSL.txt.
@@ -12,12 +12,11 @@ import { migrate } from "@synnaxlabs/x";
 import { TimeSpan } from "@synnaxlabs/x/telem";
 import { z } from "zod";
 
-const STATUSES = ["disconnected", "connecting", "connected", "failed"] as const;
-export const status = z.enum(STATUSES);
-export type Status = z.infer<typeof status>;
+export const statusZ = z.enum(["disconnected", "connecting", "connected", "failed"]);
+export type Status = z.infer<typeof statusZ>;
 
-export const state = z.object({
-  status,
+export const stateZ = z.object({
+  status: statusZ,
   error: z.instanceof(Error).optional(),
   message: z.string().optional(),
   clusterKey: z.string(),
@@ -25,8 +24,7 @@ export const state = z.object({
   clientServerCompatible: z.boolean(),
   nodeVersion: z.string().optional(),
 });
-
-export type State = z.infer<typeof state>;
+export interface State extends z.infer<typeof stateZ> {}
 
 const responseZ = z.object({
   clusterKey: z.string(),
@@ -42,7 +40,7 @@ const DEFAULT: State = {
   clientVersion: __VERSION__,
 };
 
-const generateWarning = (
+const createWarning = (
   nodeVersion: string | null,
   clientVersion: string,
   clientIsNewer: boolean,
@@ -64,7 +62,7 @@ export class Checker {
   private interval?: NodeJS.Timeout;
   private readonly clientVersion: string;
   private readonly onChangeHandlers: Array<(state: State) => void> = [];
-  static readonly connectionStateZ = state;
+  static readonly connectionStateZ = stateZ;
   private versionWarned = false;
 
   /**
@@ -112,7 +110,7 @@ export class Checker {
       if (nodeVersion == null) {
         this._state.clientServerCompatible = false;
         if (!warned) {
-          console.warn(generateWarning(null, clientVersion, true));
+          console.warn(createWarning(null, clientVersion, true));
           this.versionWarned = true;
         }
       } else if (
@@ -125,7 +123,7 @@ export class Checker {
         this._state.clientServerCompatible = false;
         if (!warned) {
           console.warn(
-            generateWarning(
+            createWarning(
               nodeVersion,
               clientVersion,
               migrate.semVerNewer(clientVersion, nodeVersion),

package/src/connection/connection.spec.ts

@@ -1,4 +1,4 @@
-// Copyright 2024 Synnax Labs, Inc.
+// Copyright 2025 Synnax Labs, Inc.
 //
 // Use of this software is governed by the Business Source License included in the file
 // licenses/BSL.txt.
@@ -12,7 +12,7 @@ import { describe, expect, it } from "vitest";
 import { z } from "zod";
 
 import { auth } from "@/auth";
-import { Checker } from "@/connection/checker";
+import { connection } from "@/connection";
 import { HOST, PORT } from "@/setupspecs";
 import { Transport } from "@/transport";
 
@@ -24,7 +24,11 @@ describe("connectivity", () => {
       password: "seldon",
     });
     transport.use(client.middleware());
-    const connectivity = new Checker(transport.unary, undefined, __VERSION__);
+    const connectivity = new connection.Checker(
+      transport.unary,
+      undefined,
+      __VERSION__,
+    );
     const state = await connectivity.check();
     expect(state.status).toEqual("connected");
     expect(z.string().uuid().safeParse(state.clusterKey).success).toBe(true);
@@ -37,7 +41,11 @@ describe("connectivity", () => {
         password: "seldon",
       });
       transport.use(client.middleware());
-      const connectivity = new Checker(transport.unary, undefined, __VERSION__);
+      const connectivity = new connection.Checker(
+        transport.unary,
+        undefined,
+        __VERSION__,
+      );
       const state = await connectivity.check();
       expect(state.clientServerCompatible).toBe(true);
       expect(state.clientVersion).toBe(__VERSION__);
@@ -49,7 +57,11 @@ describe("connectivity", () => {
         password: "seldon",
       });
       transport.use(client.middleware());
-      const connectivity = new Checker(transport.unary, undefined, "50000.0.0");
+      const connectivity = new connection.Checker(
+        transport.unary,
+        undefined,
+        "50000.0.0",
+      );
       const state = await connectivity.check();
       expect(state.clientServerCompatible).toBe(false);
       expect(state.clientVersion).toBe("50000.0.0");
@@ -61,7 +73,7 @@ describe("connectivity", () => {
         password: "seldon",
       });
       transport.use(client.middleware());
-      const connectivity = new Checker(transport.unary, undefined, "0.0.0");
+      const connectivity = new connection.Checker(transport.unary, undefined, "0.0.0");
       const state = await connectivity.check();
       expect(state.clientServerCompatible).toBe(false);
       expect(state.clientVersion).toBe("0.0.0");

package/src/connection/index.ts

@@ -1,4 +1,4 @@
-// Copyright 2024 Synnax Labs, Inc.
+// Copyright 2025 Synnax Labs, Inc.
 //
 // Use of this software is governed by the Business Source License included in the file
 // licenses/BSL.txt.

package/src/control/client.ts

@@ -1,4 +1,4 @@
-// Copyright 2024 Synnax Labs, Inc.
+// Copyright 2025 Synnax Labs, Inc.
 //
 // Use of this software is governed by the Business Source License included in the file
 // licenses/BSL.txt.

package/src/control/external.ts

@@ -1,4 +1,4 @@
-// Copyright 2024 Synnax Labs, Inc.
+// Copyright 2025 Synnax Labs, Inc.
 //
 // Use of this software is governed by the Business Source License included in the file
 // licenses/BSL.txt.

package/src/control/index.ts

@@ -1,4 +1,4 @@
-// Copyright 2024 Synnax Labs, Inc.
+// Copyright 2025 Synnax Labs, Inc.
 //
 // Use of this software is governed by the Business Source License included in the file
 // licenses/BSL.txt.

package/src/control/state.spec.ts

@@ -1,4 +1,4 @@
-// Copyright 2024 Synnax Labs, Inc.
+// Copyright 2025 Synnax Labs, Inc.
 //
 // Use of this software is governed by the Business Source License included in the file
 // licenses/BSL.txt.

package/src/control/state.ts

@@ -1,4 +1,4 @@
-// Copyright 2024 Synnax Labs, Inc.
+// Copyright 2025 Synnax Labs, Inc.
 //
 // Use of this software is governed by the Business Source License included in the file
 // licenses/BSL.txt.
@@ -12,15 +12,14 @@ import { binary } from "@synnaxlabs/x/binary";
 import { type observe } from "@synnaxlabs/x/observe";
 import { z } from "zod";
 
-import { type Key as ChannelKey } from "@/channel/payload";
+import { type channel } from "@/channel";
 import { framer } from "@/framer";
-import { type Streamer as FrameStreamer } from "@/framer/streamer";
 
-export type Authority = control.Authority;
+export interface Authority extends control.Authority {}
 export const Authority = control.Authority;
-export type Transfer = control.Transfer<ChannelKey>;
-export type State = control.State<ChannelKey>;
-export type Subject = control.Subject;
+export type Transfer = control.Transfer<channel.Key>;
+export interface State extends control.State<channel.Key> {}
+export interface Subject extends control.Subject {}
 export const stateZ = control.stateZ(z.number());
 
 export const transferString = (t: Transfer): string => {
@@ -35,17 +34,17 @@ export const transferString = (t: Transfer): string => {
 };
 
 interface Update {
-  transfers: control.Transfer<ChannelKey>[];
+  transfers: control.Transfer<channel.Key>[];
 }
 
 export class StateTracker
   extends framer.ObservableStreamer<Transfer[]>
   implements observe.ObservableAsyncCloseable<Transfer[]>
 {
-  readonly states: Map<ChannelKey, State>;
+  readonly states: Map<channel.Key, State>;
   private readonly codec: binary.Codec;
 
-  constructor(streamer: FrameStreamer) {
+  constructor(streamer: framer.Streamer) {
     super(streamer, (frame) => {
       const update: Update = this.codec.decode(frame.series[0].buffer);
       this.merge(update);

package/src/errors.spec.ts

@@ -1,4 +1,4 @@
-// Copyright 2024 Synnax Labs, Inc.
+// Copyright 2025 Synnax Labs, Inc.
 //
 // Use of this software is governed by the Business Source License included in the file
 // licenses/BSL.txt.
@@ -55,7 +55,7 @@ const client = newClient();
 test("client", async () => {
   expect.assertions(2);
   try {
-    await client.channels.retrieve(id.id());
+    await client.channels.retrieve(id.create());
   } catch (e) {
     expect(NotFoundError.matches(e)).toBe(true);
   }

package/src/errors.ts

@@ -1,4 +1,4 @@
-// Copyright 2024 Synnax Labs, Inc.
+// Copyright 2025 Synnax Labs, Inc.
 //
 // Use of this software is governed by the Business Source License included in the file
 // licenses/BSL.txt.
@@ -64,6 +64,12 @@ export class InvalidTokenError extends AuthError {
   static readonly matches = errorMatcher(InvalidTokenError.TYPE);
 }
 
+export class ExpiredTokenError extends AuthError {
+  static readonly TYPE = `${AuthError.TYPE}.expired-token`;
+  type = ExpiredTokenError.TYPE;
+  static readonly matches = errorMatcher(ExpiredTokenError.TYPE);
+}
+
 /**
  * UnexpectedError is raised when an unexpected error occurs.
  */
@@ -154,6 +160,8 @@ const decode = (payload: ErrorPayload): Error | null => {
   if (payload.type.startsWith(AuthError.TYPE)) {
     if (payload.type.startsWith(InvalidTokenError.TYPE))
       return new InvalidTokenError(payload.data);
+    if (payload.type.startsWith(ExpiredTokenError.TYPE))
+      return new ExpiredTokenError(payload.data);
     return new AuthError(payload.data);
   }
 

package/src/framer/adapter.spec.ts

@@ -1,4 +1,4 @@
-// Copyright 2024 Synnax Labs, Inc.
+// Copyright 2025 Synnax Labs, Inc.
 //
 // Use of this software is governed by the Business Source License included in the file
 // licenses/BSL.txt.
@@ -11,7 +11,7 @@ import { DataType, Series, TimeStamp } from "@synnaxlabs/x/telem";
 import { beforeAll, describe, expect, it } from "vitest";
 
 import { type channel } from "@/channel";
-import { WriteFrameAdapter } from "@/framer/adapter";
+import { WriteAdapter } from "@/framer/adapter";
 import { Frame } from "@/index";
 import { newClient } from "@/setupspecs";
 
@@ -20,7 +20,7 @@ const client = newClient();
 describe("WriteFrameAdapter", () => {
   let timeCh: channel.Channel;
   let dataCh: channel.Channel;
-  let adapter: WriteFrameAdapter;
+  let adapter: WriteAdapter;
 
   beforeAll(async () => {
     timeCh = await client.channels.create({
@@ -34,7 +34,7 @@ describe("WriteFrameAdapter", () => {
       index: timeCh.key,
     });
 
-    adapter = await WriteFrameAdapter.open(client.channels.retriever, [
+    adapter = await WriteAdapter.open(client.channels.retriever, [
       timeCh.key,
       dataCh.key,
     ]);
@@ -42,10 +42,7 @@ describe("WriteFrameAdapter", () => {
 
   it("should correctly adapt a record of keys to single values", async () => {
     const ts = TimeStamp.now().valueOf();
-    const res = await adapter.adapt({
-      [timeCh.key]: ts,
-      [dataCh.key]: 1,
-    });
+    const res = await adapter.adapt({ [timeCh.key]: ts, [dataCh.key]: 1 });
     expect(res.columns).toHaveLength(2);
     expect(res.series).toHaveLength(2);
     expect(res.get(timeCh.key)).toHaveLength(1);
@@ -56,10 +53,7 @@ describe("WriteFrameAdapter", () => {
 
   it("should correctly adapt a record of names to single values", async () => {
     const ts = TimeStamp.now().valueOf();
-    const res2 = await adapter.adapt({
-      [timeCh.name]: ts,
-      [dataCh.name]: 1,
-    });
+    const res2 = await adapter.adapt({ [timeCh.name]: ts, [dataCh.name]: 1 });
     expect(res2.columns).toHaveLength(2);
     expect(res2.series).toHaveLength(2);
     expect(res2.get(timeCh.key)).toHaveLength(1);
@@ -103,10 +97,7 @@ describe("WriteFrameAdapter", () => {
 
   it("should not modify a frame keyed by key", async () => {
     const ts = TimeStamp.now().valueOf();
-    const fr = new Frame({
-      [timeCh.key]: new Series(ts),
-      [dataCh.key]: new Series(1),
-    });
+    const fr = new Frame({ [timeCh.key]: new Series(ts), [dataCh.key]: new Series(1) });
     const res = await adapter.adapt(fr);
     expect(res.columns).toHaveLength(2);
     expect(res.series).toHaveLength(2);
@@ -131,7 +122,7 @@ describe("WriteFrameAdapter", () => {
       dataType: DataType.JSON,
       virtual: true,
     });
-    const adapter = await WriteFrameAdapter.open(client.channels.retriever, [
+    const adapter = await WriteAdapter.open(client.channels.retriever, [
       jsonChannel.key,
     ]);
     const res = await adapter.adapt(jsonChannel.name, [{ dog: "blue" }]);
@@ -147,7 +138,7 @@ describe("WriteFrameAdapter", () => {
       dataType: DataType.JSON,
       virtual: true,
     });
-    const adapter = await WriteFrameAdapter.open(client.channels.retriever, [
+    const adapter = await WriteAdapter.open(client.channels.retriever, [
       jsonChannel.key,
     ]);
     const res = await adapter.adapt(jsonChannel.name, new Series([{ dog: "blue" }]));
@@ -157,12 +148,26 @@ describe("WriteFrameAdapter", () => {
     expect(res.get(jsonChannel.key).at(0)).toEqual({ dog: "blue" });
   });
 
-  it("should correctly adapt generic object keys", async () => {
-    const res = await adapter.adaptObjectKeys({
-      [timeCh.name]: 532,
-      [dataCh.name]: 123,
+  it("should correctly adapt a numeric value to a BigInt keyed by key", async () => {
+    const bigIntCh = await client.channels.create({
+      name: `bigint-${Math.random()}-${TimeStamp.now().toString()}`,
+      dataType: DataType.INT64,
+      virtual: true,
+    });
+    const res = await adapter.adapt({
+      [bigIntCh.key]: 12,
+    });
+    expect(res.get(bigIntCh.key).at(0)).toEqual(12n);
+  });
+
+  describe("adaptObjectKeys", () => {
+    it("should correctly adapt generic object keys", async () => {
+      const res = await adapter.adaptObjectKeys({
+        [timeCh.name]: 532,
+        [dataCh.name]: 123,
+      });
+      expect(res).toHaveProperty(timeCh.key.toString());
+      expect(res).toHaveProperty(dataCh.key.toString());
     });
-    expect(res).toHaveProperty(timeCh.key.toString());
-    expect(res).toHaveProperty(dataCh.key.toString());
   });
 });