@synnaxlabs/client 0.49.2 → 0.50.0

package/dist/src/view/payload.d.ts

@@ -0,0 +1,20 @@
+import { default as z } from 'zod';
+export declare const keyZ: z.ZodUUID;
+export type Key = z.infer<typeof keyZ>;
+export declare const viewZ: z.ZodObject<{
+    key: z.ZodUUID;
+    name: z.ZodString;
+    type: z.ZodString;
+    query: z.ZodRecord<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>, z.ZodUnknown>;
+}, z.core.$strip>;
+export interface View extends z.infer<typeof viewZ> {
+}
+export declare const newZ: z.ZodObject<{
+    name: z.ZodString;
+    type: z.ZodString;
+    query: z.ZodRecord<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>, z.ZodUnknown>;
+    key: z.ZodOptional<z.ZodUUID>;
+}, z.core.$strip>;
+export interface New extends z.infer<typeof newZ> {
+}
+//# sourceMappingURL=payload.d.ts.map

package/dist/src/view/payload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"payload.d.ts","sourceRoot":"","sources":["../../../src/view/payload.ts"],"names":[],"mappings":"AAUA,OAAO,CAAC,MAAM,KAAK,CAAC;AAEpB,eAAO,MAAM,IAAI,WAAW,CAAC;AAC7B,MAAM,MAAM,GAAG,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC;AAEvC,eAAO,MAAM,KAAK;;;;;iBAKhB,CAAC;AACH,MAAM,WAAW,IAAK,SAAQ,CAAC,CAAC,KAAK,CAAC,OAAO,KAAK,CAAC;CAAG;AAEtD,eAAO,MAAM,IAAI;;;;;iBAAyC,CAAC;AAC3D,MAAM,WAAW,GAAI,SAAQ,CAAC,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC;CAAG"}

package/dist/src/view/view.spec.d.ts

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

package/dist/src/view/view.spec.d.ts.map

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

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

@@ -18,7 +18,7 @@ export interface RetrieveRequest extends z.infer<typeof retrieveReqZ> {
 }
 declare const setLayoutReqZ: z.ZodObject<{
     key: z.ZodUUID;
-    layout: z.ZodPipe<z.ZodRecord<z.ZodUnion<readonly [z.ZodNumber, z.ZodString, z.ZodSymbol]>, z.ZodUnknown>, z.ZodTransform<string, Record<string | number | symbol, unknown>>>;
+    layout: z.ZodPipe<z.ZodRecord<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>, z.ZodUnknown>, z.ZodTransform<string, Record<string | number, unknown>>>;
 }, z.core.$strip>;
 export declare const SET_CHANNEL_NAME = "sy_workspace_set";
 export declare const DELETE_CHANNEL_NAME = "sy_workspace_delete";
@@ -43,10 +43,10 @@ export declare class Client {
 }
 export declare const ontologyID: ontology.CreateID<string>;
 export declare const TYPE_ONTOLOGY_ID: {
-    type: "status" | "label" | "log" | "builtin" | "cluster" | "channel" | "node" | "group" | "range" | "framer" | "range-alias" | "user" | "workspace" | "schematic" | "lineplot" | "rack" | "device" | "task" | "policy" | "role" | "table" | "arc" | "schematic_symbol";
+    type: "channel" | "status" | "label" | "log" | "builtin" | "cluster" | "node" | "group" | "range" | "framer" | "range-alias" | "user" | "workspace" | "schematic" | "lineplot" | "rack" | "device" | "task" | "policy" | "role" | "table" | "arc" | "schematic_symbol" | "view";
     key: string;
 } | {
-    type: "status" | "label" | "log" | "builtin" | "cluster" | "channel" | "node" | "group" | "range" | "framer" | "range-alias" | "user" | "workspace" | "schematic" | "lineplot" | "rack" | "device" | "task" | "policy" | "role" | "table" | "arc" | "schematic_symbol";
+    type: "channel" | "status" | "label" | "log" | "builtin" | "cluster" | "node" | "group" | "range" | "framer" | "range-alias" | "user" | "workspace" | "schematic" | "lineplot" | "rack" | "device" | "task" | "policy" | "role" | "table" | "arc" | "schematic_symbol" | "view";
     key: string;
 };
 export {};

package/dist/src/workspace/lineplot/client.d.ts

@@ -39,10 +39,10 @@ export declare class Client {
 }
 export declare const ontologyID: ontology.CreateID<string>;
 export declare const TYPE_ONTOLOGY_ID: {
-    type: "status" | "label" | "log" | "builtin" | "cluster" | "channel" | "node" | "group" | "range" | "framer" | "range-alias" | "user" | "workspace" | "schematic" | "lineplot" | "rack" | "device" | "task" | "policy" | "role" | "table" | "arc" | "schematic_symbol";
+    type: "channel" | "status" | "label" | "log" | "builtin" | "cluster" | "node" | "group" | "range" | "framer" | "range-alias" | "user" | "workspace" | "schematic" | "lineplot" | "rack" | "device" | "task" | "policy" | "role" | "table" | "arc" | "schematic_symbol" | "view";
     key: string;
 } | {
-    type: "status" | "label" | "log" | "builtin" | "cluster" | "channel" | "node" | "group" | "range" | "framer" | "range-alias" | "user" | "workspace" | "schematic" | "lineplot" | "rack" | "device" | "task" | "policy" | "role" | "table" | "arc" | "schematic_symbol";
+    type: "channel" | "status" | "label" | "log" | "builtin" | "cluster" | "node" | "group" | "range" | "framer" | "range-alias" | "user" | "workspace" | "schematic" | "lineplot" | "rack" | "device" | "task" | "policy" | "role" | "table" | "arc" | "schematic_symbol" | "view";
     key: string;
 };
 export {};

package/dist/src/workspace/lineplot/payload.d.ts

@@ -6,21 +6,21 @@ export type Params = Key | Key[];
 export declare const linePlotZ: z.ZodObject<{
     key: z.ZodUUID;
     name: z.ZodString;
-    data: z.ZodUnion<[z.ZodRecord<z.ZodUnion<readonly [z.ZodNumber, z.ZodString, z.ZodSymbol]>, z.ZodUnknown>, z.ZodPipe<z.ZodString, z.ZodTransform<record.Unknown, string>>]>;
+    data: z.ZodUnion<[z.ZodRecord<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>, z.ZodUnknown>, z.ZodPipe<z.ZodString, z.ZodTransform<record.Unknown, string>>]>;
 }, z.core.$strip>;
 export interface LinePlot extends z.infer<typeof linePlotZ> {
 }
 export declare const newZ: z.ZodPipe<z.ZodObject<{
     key: z.ZodOptional<z.ZodUUID>;
     name: z.ZodString;
-    data: z.ZodUnion<[z.ZodRecord<z.ZodUnion<readonly [z.ZodNumber, z.ZodString, z.ZodSymbol]>, z.ZodUnknown>, z.ZodPipe<z.ZodString, z.ZodTransform<record.Unknown, string>>]>;
+    data: z.ZodUnion<[z.ZodRecord<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>, z.ZodUnknown>, z.ZodPipe<z.ZodString, z.ZodTransform<record.Unknown, string>>]>;
 }, z.core.$strip>, z.ZodTransform<{
     data: string;
     name: string;
     key?: string | undefined;
 }, {
     name: string;
-    data: record.Unknown | Record<string | number | symbol, unknown>;
+    data: record.Unknown | Record<string | number, unknown>;
     key?: string | undefined;
 }>>;
 export interface New extends z.input<typeof newZ> {

package/dist/src/workspace/log/client.d.ts

@@ -39,10 +39,10 @@ export declare class Client {
 }
 export declare const ontologyID: ontology.CreateID<string>;
 export declare const TYPE_ONTOLOGY_ID: {
-    type: "status" | "label" | "log" | "builtin" | "cluster" | "channel" | "node" | "group" | "range" | "framer" | "range-alias" | "user" | "workspace" | "schematic" | "lineplot" | "rack" | "device" | "task" | "policy" | "role" | "table" | "arc" | "schematic_symbol";
+    type: "channel" | "status" | "label" | "log" | "builtin" | "cluster" | "node" | "group" | "range" | "framer" | "range-alias" | "user" | "workspace" | "schematic" | "lineplot" | "rack" | "device" | "task" | "policy" | "role" | "table" | "arc" | "schematic_symbol" | "view";
     key: string;
 } | {
-    type: "status" | "label" | "log" | "builtin" | "cluster" | "channel" | "node" | "group" | "range" | "framer" | "range-alias" | "user" | "workspace" | "schematic" | "lineplot" | "rack" | "device" | "task" | "policy" | "role" | "table" | "arc" | "schematic_symbol";
+    type: "channel" | "status" | "label" | "log" | "builtin" | "cluster" | "node" | "group" | "range" | "framer" | "range-alias" | "user" | "workspace" | "schematic" | "lineplot" | "rack" | "device" | "task" | "policy" | "role" | "table" | "arc" | "schematic_symbol" | "view";
     key: string;
 };
 export {};

package/dist/src/workspace/log/payload.d.ts

@@ -6,21 +6,21 @@ export type Params = Key | Key[];
 export declare const logZ: z.ZodObject<{
     key: z.ZodUUID;
     name: z.ZodString;
-    data: z.ZodUnion<[z.ZodRecord<z.ZodUnion<readonly [z.ZodNumber, z.ZodString, z.ZodSymbol]>, z.ZodUnknown>, z.ZodPipe<z.ZodString, z.ZodTransform<record.Unknown, string>>]>;
+    data: z.ZodUnion<[z.ZodRecord<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>, z.ZodUnknown>, z.ZodPipe<z.ZodString, z.ZodTransform<record.Unknown, string>>]>;
 }, z.core.$strip>;
 export interface Log extends z.infer<typeof logZ> {
 }
 export declare const newZ: z.ZodPipe<z.ZodObject<{
     key: z.ZodOptional<z.ZodUUID>;
     name: z.ZodString;
-    data: z.ZodUnion<[z.ZodRecord<z.ZodUnion<readonly [z.ZodNumber, z.ZodString, z.ZodSymbol]>, z.ZodUnknown>, z.ZodPipe<z.ZodString, z.ZodTransform<record.Unknown, string>>]>;
+    data: z.ZodUnion<[z.ZodRecord<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>, z.ZodUnknown>, z.ZodPipe<z.ZodString, z.ZodTransform<record.Unknown, string>>]>;
 }, z.core.$strip>, z.ZodTransform<{
     data: string;
     name: string;
     key?: string | undefined;
 }, {
     name: string;
-    data: record.Unknown | Record<string | number | symbol, unknown>;
+    data: record.Unknown | Record<string | number, unknown>;
     key?: string | undefined;
 }>>;
 export interface New extends z.input<typeof newZ> {

package/dist/src/workspace/payload.d.ts

@@ -6,21 +6,21 @@ export type Params = Key | Key[];
 export declare const workspaceZ: z.ZodObject<{
     key: z.ZodUUID;
     name: z.ZodString;
-    layout: z.ZodUnion<[z.ZodRecord<z.ZodUnion<readonly [z.ZodNumber, z.ZodString, z.ZodSymbol]>, z.ZodUnknown>, z.ZodPipe<z.ZodString, z.ZodTransform<record.Unknown, string>>]>;
+    layout: z.ZodUnion<[z.ZodRecord<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>, z.ZodUnknown>, z.ZodPipe<z.ZodString, z.ZodTransform<record.Unknown, string>>]>;
 }, z.core.$strip>;
 export interface Workspace extends z.infer<typeof workspaceZ> {
 }
 export declare const newZ: z.ZodPipe<z.ZodObject<{
     key: z.ZodOptional<z.ZodUUID>;
     name: z.ZodString;
-    layout: z.ZodUnion<[z.ZodRecord<z.ZodUnion<readonly [z.ZodNumber, z.ZodString, z.ZodSymbol]>, z.ZodUnknown>, z.ZodPipe<z.ZodString, z.ZodTransform<record.Unknown, string>>]>;
+    layout: z.ZodUnion<[z.ZodRecord<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>, z.ZodUnknown>, z.ZodPipe<z.ZodString, z.ZodTransform<record.Unknown, string>>]>;
 }, z.core.$strip>, z.ZodTransform<{
     layout: string;
     name: string;
     key?: string | undefined;
 }, {
     name: string;
-    layout: record.Unknown | Record<string | number | symbol, unknown>;
+    layout: record.Unknown | Record<string | number, unknown>;
     key?: string | undefined;
 }>>;
 export interface New extends z.input<typeof newZ> {

package/dist/src/workspace/schematic/client.d.ts

@@ -48,10 +48,10 @@ export declare class Client {
 }
 export declare const ontologyID: ontology.CreateID<string>;
 export declare const TYPE_ONTOLOGY_ID: {
-    type: "status" | "label" | "log" | "builtin" | "cluster" | "channel" | "node" | "group" | "range" | "framer" | "range-alias" | "user" | "workspace" | "schematic" | "lineplot" | "rack" | "device" | "task" | "policy" | "role" | "table" | "arc" | "schematic_symbol";
+    type: "channel" | "status" | "label" | "log" | "builtin" | "cluster" | "node" | "group" | "range" | "framer" | "range-alias" | "user" | "workspace" | "schematic" | "lineplot" | "rack" | "device" | "task" | "policy" | "role" | "table" | "arc" | "schematic_symbol" | "view";
     key: string;
 } | {
-    type: "status" | "label" | "log" | "builtin" | "cluster" | "channel" | "node" | "group" | "range" | "framer" | "range-alias" | "user" | "workspace" | "schematic" | "lineplot" | "rack" | "device" | "task" | "policy" | "role" | "table" | "arc" | "schematic_symbol";
+    type: "channel" | "status" | "label" | "log" | "builtin" | "cluster" | "node" | "group" | "range" | "framer" | "range-alias" | "user" | "workspace" | "schematic" | "lineplot" | "rack" | "device" | "task" | "policy" | "role" | "table" | "arc" | "schematic_symbol" | "view";
     key: string;
 };
 export {};

package/dist/src/workspace/schematic/payload.d.ts

@@ -6,7 +6,7 @@ export type Params = Key | Key[];
 export declare const schematicZ: z.ZodObject<{
     key: z.ZodUUID;
     name: z.ZodString;
-    data: z.ZodUnion<[z.ZodRecord<z.ZodUnion<readonly [z.ZodNumber, z.ZodString, z.ZodSymbol]>, z.ZodUnknown>, z.ZodPipe<z.ZodString, z.ZodTransform<record.Unknown, string>>]>;
+    data: z.ZodUnion<[z.ZodRecord<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>, z.ZodUnknown>, z.ZodPipe<z.ZodString, z.ZodTransform<record.Unknown, string>>]>;
     snapshot: z.ZodBoolean;
 }, z.core.$strip>;
 export interface Schematic extends z.infer<typeof schematicZ> {
@@ -14,7 +14,7 @@ export interface Schematic extends z.infer<typeof schematicZ> {
 export declare const newZ: z.ZodPipe<z.ZodObject<{
     key: z.ZodOptional<z.ZodUUID>;
     name: z.ZodString;
-    data: z.ZodUnion<[z.ZodRecord<z.ZodUnion<readonly [z.ZodNumber, z.ZodString, z.ZodSymbol]>, z.ZodUnknown>, z.ZodPipe<z.ZodString, z.ZodTransform<record.Unknown, string>>]>;
+    data: z.ZodUnion<[z.ZodRecord<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>, z.ZodUnknown>, z.ZodPipe<z.ZodString, z.ZodTransform<record.Unknown, string>>]>;
     snapshot: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>, z.ZodTransform<{
     data: string;
@@ -23,7 +23,7 @@ export declare const newZ: z.ZodPipe<z.ZodObject<{
     snapshot?: boolean | undefined;
 }, {
     name: string;
-    data: record.Unknown | Record<string | number | symbol, unknown>;
+    data: record.Unknown | Record<string | number, unknown>;
     key?: string | undefined;
     snapshot?: boolean | undefined;
 }>>;

package/dist/src/workspace/table/client.d.ts

@@ -39,10 +39,10 @@ export declare class Client {
 }
 export declare const ontologyID: ontology.CreateID<string>;
 export declare const TYPE_ONTOLOGY_ID: {
-    type: "status" | "label" | "log" | "builtin" | "cluster" | "channel" | "node" | "group" | "range" | "framer" | "range-alias" | "user" | "workspace" | "schematic" | "lineplot" | "rack" | "device" | "task" | "policy" | "role" | "table" | "arc" | "schematic_symbol";
+    type: "channel" | "status" | "label" | "log" | "builtin" | "cluster" | "node" | "group" | "range" | "framer" | "range-alias" | "user" | "workspace" | "schematic" | "lineplot" | "rack" | "device" | "task" | "policy" | "role" | "table" | "arc" | "schematic_symbol" | "view";
     key: string;
 } | {
-    type: "status" | "label" | "log" | "builtin" | "cluster" | "channel" | "node" | "group" | "range" | "framer" | "range-alias" | "user" | "workspace" | "schematic" | "lineplot" | "rack" | "device" | "task" | "policy" | "role" | "table" | "arc" | "schematic_symbol";
+    type: "channel" | "status" | "label" | "log" | "builtin" | "cluster" | "node" | "group" | "range" | "framer" | "range-alias" | "user" | "workspace" | "schematic" | "lineplot" | "rack" | "device" | "task" | "policy" | "role" | "table" | "arc" | "schematic_symbol" | "view";
     key: string;
 };
 export {};

package/dist/src/workspace/table/payload.d.ts

@@ -6,21 +6,21 @@ export type Params = Key | Key[];
 export declare const tableZ: z.ZodObject<{
     key: z.ZodUUID;
     name: z.ZodString;
-    data: z.ZodUnion<[z.ZodRecord<z.ZodUnion<readonly [z.ZodNumber, z.ZodString, z.ZodSymbol]>, z.ZodUnknown>, z.ZodPipe<z.ZodString, z.ZodTransform<record.Unknown, string>>]>;
+    data: z.ZodUnion<[z.ZodRecord<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>, z.ZodUnknown>, z.ZodPipe<z.ZodString, z.ZodTransform<record.Unknown, string>>]>;
 }, z.core.$strip>;
 export interface Table extends z.infer<typeof tableZ> {
 }
 export declare const newZ: z.ZodPipe<z.ZodObject<{
     key: z.ZodOptional<z.ZodUUID>;
     name: z.ZodString;
-    data: z.ZodUnion<[z.ZodRecord<z.ZodUnion<readonly [z.ZodNumber, z.ZodString, z.ZodSymbol]>, z.ZodUnknown>, z.ZodPipe<z.ZodString, z.ZodTransform<record.Unknown, string>>]>;
+    data: z.ZodUnion<[z.ZodRecord<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>, z.ZodUnknown>, z.ZodPipe<z.ZodString, z.ZodTransform<record.Unknown, string>>]>;
 }, z.core.$strip>, z.ZodTransform<{
     data: string;
     name: string;
     key?: string | undefined;
 }, {
     name: string;
-    data: record.Unknown | Record<string | number | symbol, unknown>;
+    data: record.Unknown | Record<string | number, unknown>;
     key?: string | undefined;
 }>>;
 export interface New extends z.input<typeof newZ> {

package/eslint.config.ts

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

package/examples/node/basicReadWrite.js

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

package/examples/node/createChannels.js

@@ -0,0 +1,50 @@
+// Copyright 2026 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.
+
+/**
+ * A simple example that creates a large number of channels that are indexed by a single
+ * timestamp channel.
+ */
+
+import { DataType, Synnax } from "@synnaxlabs/client";
+
+// Connect to a locally running, insecure Synnax cluster. If your connection parameters
+// are different, enter them here. See https://docs.synnaxlabs.com/reference/client/quick-start.
+const client = new Synnax({
+  host: "localhost",
+  port: 9090,
+  username: "synnax",
+  password: "seldon",
+  secure: false,
+});
+
+const CHANNEL_COUNT = 100;
+
+// Create an index channel that will be used to store our timestamps.
+const timeChannel = await client.channels.create({
+  name: "create_channels_time",
+  dataType: DataType.TIMESTAMP,
+  isIndex: true,
+});
+
+// Create data channels to store our data. Since we did not call client.channels.create
+// here, the channels are not actually created in the Synnax cluster yet. We will do that
+// in the next step.
+let dataChannels = Array.from({ length: CHANNEL_COUNT }, (_, i) => ({
+  name: `create_channels_data_${i}`,
+  dataType: DataType.FLOAT64,
+  index: timeChannel.key,
+}));
+
+// Notice how we reassign the result of the create call to the dataChannels variable.
+// This means that all of the channels will have the correct key given to the channel by
+// the server.
+dataChannels = await client.channels.create(dataChannels);
+
+client.close();

package/examples/node/createRange.js

@@ -0,0 +1,67 @@
+// Copyright 2026 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.
+
+/**
+ * This example shows how to create a named range in Synnax, which can be used to identify
+ * and lookup specific periods of time in your data.
+ *
+ * We'll write  data to an index and data channel, and then create a range that spans the
+ * entire time range of the data. Then, we'll show how to read the data back using the
+ * range.
+ */
+
+import { DataType, Synnax, TimeSpan, TimeStamp } from "@synnaxlabs/client";
+
+// Connect to a locally running, insecure Synnax cluster. If your connection parameters
+// are different, enter them here. See https://docs.synnaxlabs.com/reference/client/quick-start.
+const client = new Synnax({});
+
+// Define the data.
+const start = TimeStamp.now();
+const end = start.add(TimeSpan.seconds(10));
+
+const timeData = BigInt64Array.from({ length: 1000 }, (_, i) =>
+  start.add(TimeSpan.milliseconds(i * 10)).valueOf(),
+);
+const data = Float64Array.from({ length: 1000 }, (_, i) => Math.sin(i * 0.01));
+
+// Create an index channel that will be used to store our timestamps.
+const timeChannel = await client.channels.create({
+  name: "create_range_time",
+  dataType: DataType.TIMESTAMP,
+  isIndex: true,
+});
+
+// Create a data channel that will be used to store our fake sensor data.
+const dataChannel = await client.channels.create({
+  name: "create_range_data",
+  dataType: DataType.FLOAT64,
+  index: timeChannel.key,
+});
+
+// Write the data to the Synnax cluster through the channels. Note that we need to write
+// to the index channel first, otherwise our write will fail.
+await timeChannel.write(start, timeData);
+await dataChannel.write(start, data);
+
+// Create a range that spans the start and end of the data.
+const exampleRange = await client.ranges.create({
+  name: "create_range_range",
+  timeRange: { start, end },
+});
+
+// We can pull and plot the data from the range by just accessing the channel names as if
+// they were attributes of the range itself.
+const rangeTimeData = await exampleRange.read("create_range_time");
+const rangeData = await exampleRange.read("create_range_data");
+
+console.log("Time:", rangeTimeData.at(0), "to", rangeTimeData.at(-1));
+console.log("Data:", rangeData.at(0), "to", rangeData.at(-1));
+
+client.close();

package/examples/node/readLatest.js

@@ -0,0 +1,76 @@
+// Copyright 2026 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.
+
+/**
+ * This example demonstrates how to read the latest N samples from Synnax channels. We'll:
+ * 1. Create an index channel for timestamps and a data channel for values
+ * 2. Write some sample data to these channels
+ * 3. Read the latest N samples using an iterator
+ * 4. Print the results
+ *
+ * This pattern is useful for real-time monitoring applications where you need to access
+ * the most recent data points.
+ */
+
+import { DataType, Synnax, TimeSpan, TimeStamp } from "@synnaxlabs/client";
+
+// Connect to a locally running, insecure Synnax cluster. If your connection parameters
+// are different, enter them here. See https://docs.synnaxlabs.com/reference/client/quick-start.
+const client = new Synnax({
+  host: "localhost",
+  port: 9090,
+  username: "synnax",
+  password: "seldon",
+  secure: false,
+});
+
+// Create an index channel that will be used to store our timestamps.
+const timeChannel = await client.channels.create({
+  name: "read_latest_time",
+  isIndex: true,
+  dataType: DataType.TIMESTAMP,
+});
+
+// Create a data channel that will be used to store our data.
+const dataChannel = await client.channels.create({
+  name: "read_latest_data",
+  // We need to specify the index channel that will be used to store the timestamps for
+  // this data channel.
+  index: timeChannel.key,
+  dataType: DataType.FLOAT32,
+});
+
+const SAMPLE_COUNT = 100;
+
+// We'll start our write at the current time. This timestamp should be the same as or
+// just before the first timestamp we write.
+const start = TimeStamp.now();
+
+// We'll end our write 100 seconds later
+const end = start.add(TimeSpan.seconds(2));
+
+// Generate linearly spaced int64 timestamps
+const stamps = BigInt64Array.from({ length: SAMPLE_COUNT }, (_, i) =>
+  start.add(TimeSpan.milliseconds((i * 2000) / SAMPLE_COUNT)).valueOf(),
+);
+
+// Generate a sine wave with some noise as our data
+const data = Float32Array.from(
+  { length: SAMPLE_COUNT },
+  (_, i) => Math.sin(1 + (i * 9) / SAMPLE_COUNT) * 20 + (Math.random() - 0.5),
+);
+
+// Write the data to the Synnax cluster through the channels. Note that we need to write
+// to the index channel first, otherwise our write will fail.
+await timeChannel.write(start, stamps);
+await dataChannel.write(start, data);
+
+console.log(await client.readLatest(["read_latest_time", "read_latest_data"], 1));
+
+client.close();

package/examples/node/seriesAndFrames.js

@@ -1,4 +1,4 @@
-// Copyright 2025 Synnax Labs, Inc.
+// Copyright 2026 Synnax Labs, Inc.
 //
 // Use of this software is governed by the Business Source License included in the file
 // licenses/BSL.txt.
@@ -82,7 +82,7 @@ import { DataType } from "@synnaxlabs/client";
 
 series = new Series([1, 2, 3, 4, 5]);
 console.log(series.dataType.toString()); // "float64"
-console.log(series.dataType.equals(DataType.STRING)); // true
+console.log(series.dataType.equals(DataType.FLOAT64)); // true
 
 series = new Series([1, 2, 3, 4, 5]);
 console.log(series.max); // 5

package/examples/node/{liveStream.js → streamRead.js}

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

package/examples/node/streamWrite.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@synnaxlabs/client",
-  "version": "0.49.2",
+  "version": "0.50.0",
   "description": "The Synnax Client Library",
   "keywords": [
     "synnax",
@@ -25,21 +25,21 @@
   },
   "dependencies": {
     "async-mutex": "^0.5.0",
-    "zod": "^4.1.12",
-    "@synnaxlabs/freighter": "^0.49.0",
-    "@synnaxlabs/x": "^0.49.2"
+    "zod": "^4.1.13",
+    "@synnaxlabs/freighter": "^0.50.0",
+    "@synnaxlabs/x": "^0.50.0"
   },
   "devDependencies": {
     "@vitest/coverage-v8": "^3.2.4",
-    "@types/node": "^24.10.0",
-    "eslint": "^9.39.1",
+    "@types/node": "^25.0.2",
+    "eslint": "^9.39.2",
     "madge": "^8.0.0",
     "typescript": "^5.9.3",
-    "vite": "^7.1.12",
+    "vite": "^7.2.7",
     "vitest": "^3.2.4",
-    "@synnaxlabs/tsconfig": "^0.43.0",
-    "@synnaxlabs/vite-plugin": "^0.43.0",
-    "eslint-config-synnaxlabs": "^0.43.0"
+    "@synnaxlabs/tsconfig": "^0.50.0",
+    "eslint-config-synnaxlabs": "^0.50.0",
+    "@synnaxlabs/vite-plugin": "^0.50.0"
   },
   "type": "module",
   "types": "dist/src/index.d.ts",

package/src/access/client.ts

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

package/src/access/enforce.spec.ts

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

package/src/access/enforce.ts

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

package/src/access/external.ts

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

package/src/access/index.ts

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

package/src/access/payload.ts

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

package/src/access/policy/access.spec.ts

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

package/src/access/policy/client.ts

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

package/src/access/policy/external.ts

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

package/src/access/policy/index.ts

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

package/src/access/policy/payload.ts

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

package/src/access/role/client.ts

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

package/src/access/role/external.ts

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