@synnaxlabs/client 0.17.4 → 0.17.5

package/dist/framer/frame.d.ts

@@ -1,4 +1,4 @@
-import { Size, Series, TimeRange, DataType, TimeStamp } from "@synnaxlabs/x";
+import { Size, Series, TimeRange, DataType, TimeStamp, type TelemValue } from "@synnaxlabs/x";
 import { z } from "zod";
 import { type KeyOrName, type Keys, type Names, type Params } from '../channel/payload';
 type ColumnType = "key" | "name" | null;
@@ -98,6 +98,7 @@ export declare class Frame {
      */
     get isWeaklyAligned(): boolean;
     timeRange(col?: KeyOrName): TimeRange;
+    latest(): Record<string, TelemValue>;
     get timeRanges(): TimeRange[];
     /**
      * @returns lazy arrays matching the given channel key or name.

package/examples/node/liveStream.js

@@ -18,7 +18,11 @@ const client = new Synnax({
 });
 
 // We can just specify the names of the channels we'd like to stream from.
-const read_from = ["stream_write_example_time", "stream_write_example_data"]
+const read_from = [
+    "stream_write_example_time", 
+    "stream_write_example_data_1", 
+    "stream_write_example_data_2"
+]
 
 const streamer = await client.telem.newStreamer(read_from);
 
@@ -31,7 +35,8 @@ try {
     for await (const frame of streamer) 
         console.log({
             time: new TimeStamp(frame.get("stream_write_example_time")[0].at(0)).toString(),
-            data: frame.get("stream_write_example_data")[0].at(0)
+            data1: frame.get("stream_write_example_data_1")[0].at(0),
+            data2: frame.get("stream_write_example_data_2")[0].at(0)
         })
 } finally {
     streamer.close();

package/examples/node/package-lock.json

@@ -9,13 +9,13 @@
       "version": "1.0.0",
       "license": "ISC",
       "dependencies": {
-        "@synnaxlabs/client": "^0.17.3"
+        "@synnaxlabs/client": "^0.17.4"
       }
     },
     "node_modules/@grpc/grpc-js": {
-      "version": "1.10.5",
-      "resolved": "https://registry.npmjs.org/@grpc/grpc-js/-/grpc-js-1.10.5.tgz",
-      "integrity": "sha512-9IS/wB9YESGysRzJ+OFcb/bDf7OmtLQ4l93LsT1/cJnqzTKHUJBwXm/dc0dLio4C/DMomx01dTZiQb7pau0hrw==",
+      "version": "1.10.6",
+      "resolved": "https://registry.npmjs.org/@grpc/grpc-js/-/grpc-js-1.10.6.tgz",
+      "integrity": "sha512-xP58G7wDQ4TCmN/cMUHh00DS7SRDv/+lC+xFLrTkMIN8h55X5NhZMLYbvy7dSELP15qlI6hPhNCRWVMtZMwqLA==",
       "dependencies": {
         "@grpc/proto-loader": "^0.7.10",
         "@js-sdsl/ordered-map": "^4.4.2"
@@ -3017,9 +3017,9 @@
       }
     },
     "node_modules/@opentelemetry/propagation-utils": {
-      "version": "0.30.7",
-      "resolved": "https://registry.npmjs.org/@opentelemetry/propagation-utils/-/propagation-utils-0.30.7.tgz",
-      "integrity": "sha512-QkxOkuCQdq8YgJstEMF4ntSyr0ivCrcQc49uvO2pyccrniu2DwA+JD071aM4BXfNVSCeOuhIyW/3QPiZYl4zdA==",
+      "version": "0.30.8",
+      "resolved": "https://registry.npmjs.org/@opentelemetry/propagation-utils/-/propagation-utils-0.30.8.tgz",
+      "integrity": "sha512-ZKjsUm//SvL8I9JS+bJpAXGpe0Fb+sO+AiWS0fb7EKKLEm3GoNAO7CDMs8GMZBZ91ElR3tBjdUKf/9MzUdYHBA==",
       "engines": {
         "node": ">=14"
       },
@@ -3122,12 +3122,12 @@
       }
     },
     "node_modules/@opentelemetry/resource-detector-alibaba-cloud": {
-      "version": "0.28.7",
-      "resolved": "https://registry.npmjs.org/@opentelemetry/resource-detector-alibaba-cloud/-/resource-detector-alibaba-cloud-0.28.7.tgz",
-      "integrity": "sha512-7o/waBJ08JrKED4blHGyBPIN1HMM1KEvhbO1HmdA+tsUqsGwZdTjsdMKFW7hc1TvAu4AQEnuvMy/Q5OByVr95A==",
+      "version": "0.28.8",
+      "resolved": "https://registry.npmjs.org/@opentelemetry/resource-detector-alibaba-cloud/-/resource-detector-alibaba-cloud-0.28.8.tgz",
+      "integrity": "sha512-njdK7S90OX99H0nlDh45vmGU3Bn46JSNjciU18NefyU6R3Dq5ZUU13DWxSlrCBWAiH/+SFJyHQMFsXRnTOFp6w==",
       "dependencies": {
         "@opentelemetry/resources": "^1.0.0",
-        "@opentelemetry/semantic-conventions": "^1.0.0"
+        "@opentelemetry/semantic-conventions": "^1.22.0"
       },
       "engines": {
         "node": ">=14"
@@ -3137,13 +3137,13 @@
       }
     },
     "node_modules/@opentelemetry/resource-detector-aws": {
-      "version": "1.4.0",
-      "resolved": "https://registry.npmjs.org/@opentelemetry/resource-detector-aws/-/resource-detector-aws-1.4.0.tgz",
-      "integrity": "sha512-Cn8eQ/heLqrNrPuHGG7xUkk//VQt4hzVIPurmLlCI0wrDV6HR+yykBvRkJBuSdLzbjeQ/qNbGel9OvTmA6PBQA==",
+      "version": "1.4.1",
+      "resolved": "https://registry.npmjs.org/@opentelemetry/resource-detector-aws/-/resource-detector-aws-1.4.1.tgz",
+      "integrity": "sha512-QsPJwXDxlt+IWQazST7renk9KDOAK3hsywb0Mw6gEwgEoe12EvdVcT+mCknTc+hu5WzxiTmFMtnn1TWab7To1g==",
       "dependencies": {
         "@opentelemetry/core": "^1.0.0",
         "@opentelemetry/resources": "^1.0.0",
-        "@opentelemetry/semantic-conventions": "^1.0.0"
+        "@opentelemetry/semantic-conventions": "^1.22.0"
       },
       "engines": {
         "node": ">=14"
@@ -3153,12 +3153,12 @@
       }
     },
     "node_modules/@opentelemetry/resource-detector-container": {
-      "version": "0.3.7",
-      "resolved": "https://registry.npmjs.org/@opentelemetry/resource-detector-container/-/resource-detector-container-0.3.7.tgz",
-      "integrity": "sha512-AYqwffGVuGLuzzVOQMLNHTztwyvsep9noxN9HTQ/grwmJSWZ6851kNx+W735K7v6GZEDmXeLpBn+J3TeqKQUJA==",
+      "version": "0.3.8",
+      "resolved": "https://registry.npmjs.org/@opentelemetry/resource-detector-container/-/resource-detector-container-0.3.8.tgz",
+      "integrity": "sha512-YusLYSo8Rr1yKEhakaJ2XgbfbLses5t8YsSRHhO0b6SLliZOFq9ymxoWgtuwyabNCqMMJJYuvrE3Nq0AL6sbcQ==",
       "dependencies": {
         "@opentelemetry/resources": "^1.0.0",
-        "@opentelemetry/semantic-conventions": "^1.0.0"
+        "@opentelemetry/semantic-conventions": "^1.22.0"
       },
       "engines": {
         "node": ">=14"
@@ -3168,9 +3168,9 @@
       }
     },
     "node_modules/@opentelemetry/resource-detector-gcp": {
-      "version": "0.29.7",
-      "resolved": "https://registry.npmjs.org/@opentelemetry/resource-detector-gcp/-/resource-detector-gcp-0.29.7.tgz",
-      "integrity": "sha512-uUHKfoOgBCZCEPCU6FWnRrbYuz1miaeIfos0Xe38YuR06vQvddhqZ0tewYunJpfECfKEcjSjY0eDe2QIRLMkXw==",
+      "version": "0.29.8",
+      "resolved": "https://registry.npmjs.org/@opentelemetry/resource-detector-gcp/-/resource-detector-gcp-0.29.8.tgz",
+      "integrity": "sha512-jvFtsnrQI7CLDxehp6BxtudbZ3a0HZ+Dj/vFy251280efc15gQdlvFUqXbKBw6ODt/3o38ilw8e0qePJbm2eAg==",
       "dependencies": {
         "@opentelemetry/core": "^1.0.0",
         "@opentelemetry/resources": "^1.0.0",
@@ -3653,23 +3653,23 @@
       }
     },
     "node_modules/@synnaxlabs/client": {
-      "version": "0.17.3",
-      "resolved": "https://registry.npmjs.org/@synnaxlabs/client/-/client-0.17.3.tgz",
-      "integrity": "sha512-yDlsatfk/Kg0SuiC+LPCb2oZ3ktlmtCAqOglyqaA25RAfTmOY8QicAFvSCafCSweSqLXJ0dFQzniRw001s26sg==",
+      "version": "0.17.4",
+      "resolved": "https://registry.npmjs.org/@synnaxlabs/client/-/client-0.17.4.tgz",
+      "integrity": "sha512-fQ2VvuHMI43BO3x2E7Nl51ZhBOyMbSWeGrid/+TkGNVYyyhVh8oDQE0O5n5mRr6h+kLeKwAv3fH84zDQXTow6w==",
       "dependencies": {
-        "@synnaxlabs/freighter": "0.9.1",
-        "@synnaxlabs/x": "0.14.1",
+        "@synnaxlabs/freighter": "0.9.2",
+        "@synnaxlabs/x": "0.14.2",
         "async-mutex": "^0.4.0",
         "zod": "3.22.4"
       }
     },
     "node_modules/@synnaxlabs/freighter": {
-      "version": "0.9.1",
-      "resolved": "https://registry.npmjs.org/@synnaxlabs/freighter/-/freighter-0.9.1.tgz",
-      "integrity": "sha512-0ulbbzZ5XixGJgy/ri6ecl9qNrU2NrSj5Sb+vfSb3438CXeTmSY+Q1aJ8/Ksk5sl97AHbtKIGZyuV75AHX6RHw==",
+      "version": "0.9.2",
+      "resolved": "https://registry.npmjs.org/@synnaxlabs/freighter/-/freighter-0.9.2.tgz",
+      "integrity": "sha512-GJ63tGtSKlqiDLI+82keEIKwKmCsMI7y5ibI1DGKS/cXgeYJFUmG4BjJFM4HfVQxt56o94UP+qP4acZcLDZwGg==",
       "dependencies": {
         "@synnaxlabs/alamos": "0.3.0",
-        "@synnaxlabs/x": "0.14.1",
+        "@synnaxlabs/x": "0.14.2",
         "js-convert-case": "^4.2.0",
         "node-fetch": "2.6.11",
         "ws": "^8.15.1",
@@ -3680,9 +3680,9 @@
       }
     },
     "node_modules/@synnaxlabs/x": {
-      "version": "0.14.1",
-      "resolved": "https://registry.npmjs.org/@synnaxlabs/x/-/x-0.14.1.tgz",
-      "integrity": "sha512-+rLxNBvFwZjU0JVRslzGoB5OCixITlRIsfibRMGV/P5lUzylA1BKBiAsjrg8i4gWtTx3pQUyrunTFbiTe0HWmA==",
+      "version": "0.14.2",
+      "resolved": "https://registry.npmjs.org/@synnaxlabs/x/-/x-0.14.2.tgz",
+      "integrity": "sha512-Js5czEi7oMhaQkDe3xGuGLbho7xBMoNIWJmrXI20lu+VbB/FyO1wVtfcdIIIZOLc3tUAdNw9ceuZXMOieRoH1g==",
       "dependencies": {
         "async-mutex": "^0.4.0",
         "js-convert-case": "^4.2.0",
@@ -4414,14 +4414,15 @@
       }
     },
     "node_modules/gaxios": {
-      "version": "6.3.0",
-      "resolved": "https://registry.npmjs.org/gaxios/-/gaxios-6.3.0.tgz",
-      "integrity": "sha512-p+ggrQw3fBwH2F5N/PAI4k/G/y1art5OxKpb2J2chwNNHM4hHuAOtivjPuirMF4KNKwTTUal/lPfL2+7h2mEcg==",
+      "version": "6.4.0",
+      "resolved": "https://registry.npmjs.org/gaxios/-/gaxios-6.4.0.tgz",
+      "integrity": "sha512-apAloYrY4dlBGlhauDAYSZveafb5U6+L9titing1wox6BvWM0TSXBp603zTrLpyLMGkrcFgohnUN150dFN/zOA==",
       "dependencies": {
         "extend": "^3.0.2",
         "https-proxy-agent": "^7.0.1",
         "is-stream": "^2.0.0",
-        "node-fetch": "^2.6.9"
+        "node-fetch": "^2.6.9",
+        "uuid": "^9.0.1"
       },
       "engines": {
         "node": ">=14"
@@ -4857,6 +4858,18 @@
       "resolved": "https://registry.npmjs.org/undici-types/-/undici-types-5.26.5.tgz",
       "integrity": "sha512-JlCMO+ehdEIKqlFxk6IfVoAUVmgz7cU7zD/h9XZ0qzeosSHmUJVOzSQvvYSYWXkFXC+IfLKSIffhv0sVZup6pA=="
     },
+    "node_modules/uuid": {
+      "version": "9.0.1",
+      "resolved": "https://registry.npmjs.org/uuid/-/uuid-9.0.1.tgz",
+      "integrity": "sha512-b+1eJOlsR9K8HJpow9Ok3fiWOWSIcIzXodvv0rQjVoOVNpWMpxf1wZNpt4y9h10odCNrqnYp1OBzRktckBe3sA==",
+      "funding": [
+        "https://github.com/sponsors/broofa",
+        "https://github.com/sponsors/ctavan"
+      ],
+      "bin": {
+        "uuid": "dist/bin/uuid"
+      }
+    },
     "node_modules/webidl-conversions": {
       "version": "3.0.1",
       "resolved": "https://registry.npmjs.org/webidl-conversions/-/webidl-conversions-3.0.1.tgz",

package/examples/node/package.json

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

package/examples/node/streamWrite.js

@@ -23,12 +23,18 @@ const timeChannel = await client.channels.create({
 }, { retrieveIfNameExists: true });
 
 // Create a data channel that will be used to store our fake sensor data.
-const dataChannel = await client.channels.create({
-    name: "stream_write_example_data",
+const dataChannel1 = await client.channels.create({
+    name: "stream_write_example_data_1",
     dataType: "float32",
     index: timeChannel.key,
 }, { retrieveIfNameExists: true });
 
+const dataChannel2 = await client.channels.create({
+    name: "stream_write_example_data_2",
+    dataType: "int32",
+    index: timeChannel.key,
+}, { retrieveIfNameExists: true });
+
 
 // We'll start our write at the current time. This timestamps should be the same as or 
 // just before the first timestamp we write.
@@ -44,7 +50,7 @@ const commitInterval = 500;
 
 const writer = await client.telem.newWriter({
     start, 
-    channels: [timeChannel.key, dataChannel.key]
+    channels: [timeChannel.key, dataChannel1.key, dataChannel2.key]
 });
 
 try {
@@ -53,12 +59,13 @@ try {
         await new Promise(resolve => setTimeout(resolve, roughRate.period.milliseconds));
         i++;
         const timestamp = TimeStamp.now();
-        const data = Math.sin(i / 10);
-        const fr = new framer.Frame({
-            [timeChannel.key]: new Series({ data: new timeChannel.dataType.Array([timestamp]) }),
-            [dataChannel.key]: new Series({ data: new dataChannel.dataType.Array([data]) })
+        const data2= i % 2;
+        const data1 = Math.sin(i / 10);
+        await writer.write({
+            [timeChannel.key]: timestamp,
+            [dataChannel1.key]: data1,
+            [dataChannel2.key]: data2,
         });
-        await writer.write(fr);
 
         if (i % 60 == 0) 
             console.log(`Writing sample ${i} at ${timestamp.toISOString()}`)

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@synnaxlabs/client",
   "private": false,
-  "version": "0.17.4",
+  "version": "0.17.5",
   "type": "module",
   "description": "The Client Library for Synnax",
   "repository": "https://github.com/synnaxlabs/synnax/tree/main/client/ts",

package/src/framer/frame.spec.ts

@@ -19,9 +19,9 @@ describe("framer.Frame", () => {
         const f = new framer.Frame(
           ["a", "b", "c"],
           [
-            new Series({data: new Float32Array([1, 2, 3])}),
-            new Series({data: new Float32Array([1, 2, 3])}),
-            new Series({data: new Float32Array([1, 2, 3])}),
+            new Series({ data: new Float32Array([1, 2, 3]) }),
+            new Series({ data: new Float32Array([1, 2, 3]) }),
+            new Series({ data: new Float32Array([1, 2, 3]) }),
           ],
         );
         expect(f.length).toEqual(9);
@@ -32,9 +32,9 @@ describe("framer.Frame", () => {
         const f = new framer.Frame(
           [12, 13, 14],
           [
-            new Series({data: new Float32Array([1, 2, 3])}),
-            new Series({data: new Float32Array([1, 2, 3])}),
-            new Series({data: new Float32Array([1, 2, 3])}),
+            new Series({ data: new Float32Array([1, 2, 3]) }),
+            new Series({ data: new Float32Array([1, 2, 3]) }),
+            new Series({ data: new Float32Array([1, 2, 3]) }),
           ],
         );
         expect(f.length).toEqual(9);
@@ -42,25 +42,35 @@ describe("framer.Frame", () => {
       });
 
       test("from a single name and an array of arrays", () => {
-        const f = new framer.Frame("a", [new Series({data: new Float32Array([1, 2, 3])})]);
+        const f = new framer.Frame("a", [
+          new Series({ data: new Float32Array([1, 2, 3]) }),
+        ]);
         expect(f.length).toEqual(3);
         expect(f.colType).toEqual("name");
       });
 
       test("from a single key and an array of arrays", () => {
-        const f = new framer.Frame(12, [new Series({data: new Float32Array([1, 2, 3])})]);
+        const f = new framer.Frame(12, [
+          new Series({ data: new Float32Array([1, 2, 3]) }),
+        ]);
         expect(f.length).toEqual(3);
         expect(f.colType).toEqual("key");
       });
 
       test("from a single key and a single array", () => {
-        const f = new framer.Frame(12, new Series({data: new Float32Array([1, 2, 3])}));
+        const f = new framer.Frame(
+          12,
+          new Series({ data: new Float32Array([1, 2, 3]) }),
+        );
         expect(f.length).toEqual(3);
         expect(f.colType).toEqual("key");
       });
 
       test("from a single name and a single array", () => {
-        const f = new framer.Frame("a", new Series({data: new Float32Array([1, 2, 3])}));
+        const f = new framer.Frame(
+          "a",
+          new Series({ data: new Float32Array([1, 2, 3]) }),
+        );
         expect(f.length).toEqual(3);
         expect(f.colType).toEqual("name");
       });
@@ -82,7 +92,7 @@ describe("framer.Frame", () => {
 
       test("from record", () => {
         const f = new framer.Frame({
-          a: new Series({data: new Float32Array([1, 2, 3])}),
+          a: new Series({ data: new Float32Array([1, 2, 3]) }),
         });
         expect(f.length.valueOf()).toEqual(3);
         expect(f.columns.length).toEqual(1);
@@ -91,7 +101,7 @@ describe("framer.Frame", () => {
 
       test("from map", () => {
         const f = new framer.Frame(
-          new Map([[12, new Series({data: new Float32Array([1, 2, 3])})]]),
+          new Map([[12, new Series({ data: new Float32Array([1, 2, 3]) })]]),
         );
         expect(f.length).toEqual(3);
         expect(f.columns.length).toEqual(1);
@@ -106,8 +116,8 @@ describe("framer.Frame", () => {
             new framer.Frame(
               ["a", "b", "c"],
               [
-                new Series({data: new Float32Array([1, 2, 3])}),
-                new Series({data: new Float32Array([1, 2, 3])}),
+                new Series({ data: new Float32Array([1, 2, 3]) }),
+                new Series({ data: new Float32Array([1, 2, 3]) }),
               ],
             ),
         ).toThrow();
@@ -119,12 +129,12 @@ describe("framer.Frame", () => {
     it("should return false if a key has more than one array", () => {
       const f = new framer.Frame(
         new Map([
-          [12, [new Series({data: new Float32Array([1, 2, 3])})]],
+          [12, [new Series({ data: new Float32Array([1, 2, 3]) })]],
           [
             13,
             [
-              new Series({data: new Float32Array([1, 2, 3])}),
-              new Series({data: new Float32Array([1, 2, 3])}),
+              new Series({ data: new Float32Array([1, 2, 3]) }),
+              new Series({ data: new Float32Array([1, 2, 3]) }),
             ],
           ],
         ]),
@@ -137,8 +147,8 @@ describe("framer.Frame", () => {
     it("should return false if there is more than one key", () => {
       const f = new framer.Frame(
         new Map([
-          [12, [new Series({data: new Float32Array([1, 2, 3])})]],
-          [13, [new Series({data: new Float32Array([1, 2, 3])})]],
+          [12, [new Series({ data: new Float32Array([1, 2, 3]) })]],
+          [13, [new Series({ data: new Float32Array([1, 2, 3]) })]],
         ]),
       );
       expect(f.isHorizontal).toEqual(false);
@@ -164,7 +174,7 @@ describe("framer.Frame", () => {
               new Series({
                 data: new Float32Array([1, 2, 3]),
                 timeRange: new TimeRange(500, 50000),
-    }),
+              }),
             ],
           ],
         ]),
@@ -181,7 +191,7 @@ describe("framer.Frame", () => {
               new Series({
                 data: new Float32Array([1, 2, 3]),
                 timeRange: new TimeRange(500, 50000),
-    }),
+              }),
             ],
           ],
           [
@@ -190,7 +200,7 @@ describe("framer.Frame", () => {
               new Series({
                 data: new Float32Array([1, 2, 3]),
                 timeRange: new TimeRange(500, 50001),
-    }),
+              }),
             ],
           ],
         ]),
@@ -201,7 +211,7 @@ describe("framer.Frame", () => {
 
   describe("timeRange", () => {
     describe("no key provided", () => {
-      it("should return the maxium time range of the frame", () => {
+      it("should return the maximum time range of the frame", () => {
         const f = new framer.Frame(
           new Map([
             [
@@ -210,7 +220,7 @@ describe("framer.Frame", () => {
                 new Series({
                   data: new Float32Array([1, 2, 3]),
                   timeRange: new TimeRange(40, 50000),
-      }),
+                }),
               ],
             ],
             [
@@ -219,7 +229,7 @@ describe("framer.Frame", () => {
                 new Series({
                   data: new Float32Array([1, 2, 3]),
                   timeRange: new TimeRange(500, 50001),
-      }),
+                }),
               ],
             ],
           ]),
@@ -234,11 +244,11 @@ describe("framer.Frame", () => {
           a: new Series({
             data: new Float32Array([1, 2, 3]),
             timeRange: new TimeRange(40, 50000),
-        }),
+          }),
           b: new Series({
             data: new Float32Array([1, 2, 3]),
             timeRange: new TimeRange(500, 50001),
-        }),
+          }),
         });
         expect(f.timeRange("a")).toEqual(new TimeRange(40, 50000));
       });
@@ -254,7 +264,7 @@ describe("framer.Frame", () => {
                 new Series({
                   data: new Float32Array([1, 2, 3]),
                   timeRange: new TimeRange(40, 50000),
-      }),
+                }),
               ],
             ],
             [
@@ -263,7 +273,7 @@ describe("framer.Frame", () => {
                 new Series({
                   data: new Float32Array([1, 2, 3]),
                   timeRange: new TimeRange(500, 50001),
-      }),
+                }),
               ],
             ],
           ]),
@@ -283,7 +293,7 @@ describe("framer.Frame", () => {
               new Series({
                 data: new Float32Array([1, 2, 3]),
                 timeRange: new TimeRange(40, 50000),
-    }),
+              }),
             ],
           ],
           [
@@ -292,7 +302,7 @@ describe("framer.Frame", () => {
               new Series({
                 data: new Float32Array([1, 2, 3]),
                 timeRange: new TimeRange(500, 50001),
-    }),
+              }),
             ],
           ],
         ]),
@@ -302,4 +312,65 @@ describe("framer.Frame", () => {
       expect(pld.series?.[0].data.byteLength).toEqual(12);
     });
   });
+
+  describe("latest", () => {
+    it("should return the latest sample from each column in the frame", () => {
+      const f = new framer.Frame(
+        new Map([
+          [
+            12,
+            [
+              new Series({
+                data: new Float32Array([1, 2, 3]),
+                timeRange: new TimeRange(40, 50000),
+              }),
+            ],
+          ],
+          [
+            13,
+            [
+              new Series({
+                data: new Float32Array([1, 2, 3]),
+                timeRange: new TimeRange(500, 50001),
+              }),
+            ],
+          ],
+        ]),
+      );
+      expect(f.latest()).toEqual({ 12: 3, 13: 3 });
+    });
+    it("should return the latest sample for each col in the frame - even with multiple series per col", () => {
+      const f = new framer.Frame(
+        new Map([
+          [
+            12,
+            [
+              new Series({
+                data: new Float32Array([1, 2, 3]),
+                timeRange: new TimeRange(40, 50000),
+              }),
+              new Series({
+                data: new Float32Array([4, 5, 6]),
+                timeRange: new TimeRange(40, 50000),
+              }),
+            ],
+          ],
+          [
+            13,
+            [
+              new Series({
+                data: new Float32Array([1, 2, 3]),
+                timeRange: new TimeRange(500, 50001),
+              }),
+              new Series({
+                data: new Float32Array([4, 5, 7]),
+                timeRange: new TimeRange(500, 50001),
+              }),
+            ],
+          ],
+        ]),
+      );
+      expect(f.latest()).toEqual({ 12: 6, 13: 7 });
+    });
+  });
 });

package/src/framer/frame.ts

@@ -15,6 +15,7 @@ import {
   DataType,
   unique,
   TimeStamp,
+  type TelemValue,
 } from "@synnaxlabs/x";
 import { z } from "zod";
 
@@ -257,6 +258,14 @@ export class Frame {
     );
   }
 
+  latest(): Record<string, TelemValue> {
+    return Object.fromEntries(
+      this.columns
+        .map((c, i) => [c, this.series[i].at(-1)])
+        .filter(([_, v]) => v != null),
+    );
+  }
+
   get timeRanges(): TimeRange[] {
     return this.uniqueColumns.map((col) => this.timeRange(col));
   }