@synnaxlabs/client 0.32.0 → 0.34.0

package/src/framer/frame.ts

@@ -10,7 +10,7 @@
 import {
   MultiSeries,
   Series,
-  SeriesPayload,
+  type SeriesPayload,
   Size,
   type TelemValue,
   TimeRange,
@@ -126,7 +126,7 @@ export class Frame {
         Object.entries(columnsOrData).forEach(([k, v]) => {
           const key = parseInt(k);
           if (!isNaN(key)) return this.push(key, ...toArray(v));
-          else this.push(k, ...toArray(v));
+          this.push(k, ...toArray(v));
         });
       return;
     }
@@ -334,7 +334,7 @@ export class Frame {
    */
   has(channel: KeyOrName): boolean {
     if (typeof channel === "string" && this.colType === "key") return false;
-    else if (typeof channel === "number" && this.colType === "name") return false;
+    if (typeof channel === "number" && this.colType === "name") return false;
     return (this.columns as Keys).includes(channel as Key);
   }
 
@@ -418,11 +418,9 @@ export const seriesFromPayload = (series: SeriesPayload): Series => {
   return new Series({ data, dataType, timeRange, glBufferUsage: "static", alignment });
 };
 
-export const seriesToPayload = (series: Series): SeriesPayload => {
-  return {
-    timeRange: series._timeRange,
-    dataType: series.dataType,
-    data: new Uint8Array(series.data.buffer),
-    alignment: series.alignment,
-  };
-};
+export const seriesToPayload = (series: Series): SeriesPayload => ({
+  timeRange: series._timeRange,
+  dataType: series.dataType,
+  data: new Uint8Array(series.data.buffer),
+  alignment: series.alignment,
+});

package/src/framer/iterator.spec.ts

@@ -17,14 +17,13 @@ import { randomSeries } from "@/util/telem";
 
 const client = newClient();
 
-const newChannel = async (): Promise<channel.Channel> => {
-  return await client.channels.create({
+const newChannel = async (): Promise<channel.Channel> =>
+  await client.channels.create({
     name: "test",
     leaseholder: 1,
     rate: Rate.hz(25),
     dataType: DataType.FLOAT64,
   });
-};
 
 describe("Iterator", () => {
   test("happy path", async () => {

package/src/framer/writer.ts

@@ -245,7 +245,7 @@ export class Writer {
     value: Record<KeyOrName, control.Authority> | KeyOrName | number,
     authority?: control.Authority,
   ): Promise<boolean> {
-    let config: Config = { keys: [], authorities: [] };
+    let config: Config;
     if (typeof value === "number" && authority == null)
       config = { keys: [], authorities: [value] };
     else {

package/src/hardware/device/client.ts

@@ -14,11 +14,11 @@ import { z } from "zod";
 
 import { type framer } from "@/framer";
 import {
-  Device,
-  DeviceKey,
+  type Device,
+  type DeviceKey,
   deviceKeyZ,
   deviceZ,
-  NewDevice,
+  type NewDevice,
   newDeviceZ,
 } from "@/hardware/device/payload";
 import { signals } from "@/signals";

package/src/hardware/device/payload.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.
 
-import { binary, UnknownRecord } from "@synnaxlabs/x";
+import { binary, type UnknownRecord } from "@synnaxlabs/x";
 import { z } from "zod";
 
 import { rackKeyZ } from "@/hardware/rack/payload";

package/src/hardware/rack/client.ts

@@ -15,11 +15,11 @@ import { z } from "zod";
 
 import { type framer } from "@/framer";
 import {
-  NewRack,
+  type NewRack,
   newRackZ,
-  RackKey,
+  type RackKey,
   rackKeyZ,
-  RackPayload,
+  type RackPayload,
   rackZ,
 } from "@/hardware/rack/payload";
 import { type task } from "@/hardware/task";

package/src/hardware/task/client.ts

@@ -19,18 +19,18 @@ import { framer } from "@/framer";
 import { type Frame } from "@/framer/frame";
 import { rack } from "@/hardware/rack";
 import {
-  NewTask,
+  type NewTask,
   newTaskZ,
-  Payload,
-  State,
-  StateObservable,
+  type Payload,
+  type State,
+  type StateObservable,
   stateZ,
-  TaskKey,
+  type TaskKey,
   taskKeyZ,
   taskZ,
 } from "@/hardware/task/payload";
 import { ontology } from "@/ontology";
-import { ranger } from "@/ranger";
+import { type ranger } from "@/ranger";
 import { signals } from "@/signals";
 import { analyzeParams, checkForMultipleOrNoResults } from "@/util/retrieve";
 import { nullableArrayZ } from "@/util/zod";
@@ -123,9 +123,7 @@ export class Task<
       if (parsed.success) {
         res = parsed.data as State<D>;
         if (res.key === cmdKey) break;
-      } else {
-        console.error(parsed.error);
-      }
+      } else console.error(parsed.error);
     }
     streamer.close();
     return res;
@@ -316,10 +314,14 @@ export class Client implements AsyncTermSearcher<string, TaskKey, Payload> {
     return this.sugar([res.task])[0];
   }
 
-  async retrieveByName(name: string, rack?: number): Promise<Task> {
+  async retrieveByName<
+    C extends UnknownRecord = UnknownRecord,
+    D extends {} = UnknownRecord,
+    T extends string = string,
+  >(name: string, rack?: number): Promise<Task<C, D, T>> {
     const tasks = await this.execRetrieve({ names: [name], rack });
     checkForMultipleOrNoResults("Task", name, tasks, true);
-    return this.sugar(tasks)[0];
+    return this.sugar(tasks)[0] as Task<C, D, T>;
   }
 
   private async execRetrieve(req: RetrieveRequest): Promise<Payload[]> {

package/src/hardware/task/ni/types.ts

@@ -10,7 +10,7 @@
 import { z } from "zod";
 
 import { device } from "@/hardware/device";
-import { task } from "@/hardware/task";
+import { type task } from "@/hardware/task";
 
 export const unitsVoltsZ = z.literal("Volts");
 export type UnitsVolts = z.infer<typeof unitsVoltsZ>;
@@ -259,7 +259,7 @@ export const ZERO_AI_ACCEL_CHAN: AIAccelChan = {
 };
 
 // 2 - https://www.ni.com/docs/en-US/bundle/ni-daqmx-c-api-ref/page/daqmxcfunc/daqmxcreateaiaccel4wiredcvoltagechan.html
-const aiAccel4WireDCVoltageChanZ = baseAiAccelChanZ.extend({
+export const aiAccel4WireDCVoltageChanZ = baseAiAccelChanZ.extend({
   type: z.literal("ai_accel_4_wire_dc_voltage"),
   units: accelerationUnitsZ,
   voltageExcitSource: excitSourceZ,
@@ -290,7 +290,7 @@ export const ZERO_AI_ACCEL_4WIRE_DC_VOLTAGE_CHAN: AIAccel4WireDCVoltageChan = {
 };
 
 // 3 - https://www.ni.com/docs/en-US/bundle/ni-daqmx-c-api-ref/page/daqmxcfunc/daqmxcreateaiaccelchargechan.html
-const aiAccelChargeChanZ = baseAiAccelChanZ.extend({
+export const aiAccelChargeChanZ = baseAiAccelChanZ.extend({
   type: z.literal("ai_accel_charge"),
   units: accelerationUnitsZ,
   customScale: scaleZ,
@@ -354,7 +354,7 @@ export const ZERO_AI_BRIDGE_CHAN: AIBridgeChan = {
 };
 
 // 5 - https://www.ni.com/docs/en-US/bundle/ni-daqmx-c-api-ref/page/daqmxcfunc/daqmxcreateaichargechan.html
-const aiChargeChan = baseAIChanZ.extend({
+export const aiChargeChan = baseAIChanZ.extend({
   type: z.literal("ai_charge"),
   terminalConfig: terminalConfigZ,
   minVal: z.number(),
@@ -420,7 +420,7 @@ export const ZERO_AI_CURRENT_CHAN: AICurrentChan = {
 };
 
 // 7 - https://www.ni.com/docs/en-US/bundle/ni-daqmx-c-api-ref/page/daqmxcfunc/daqmxcreateaicurrentrmschan.html
-const aiCurrentRMSChanZ = baseAIChanZ.extend({
+export const aiCurrentRMSChanZ = baseAIChanZ.extend({
   type: z.literal("ai_current_rms"),
   terminalConfig: terminalConfigZ,
   minVal: z.number(),
@@ -450,7 +450,7 @@ export const ZERO_AI_CURRENT_RMS_CHAN: AICurrentRMSChan = {
 };
 
 // 8 - https://www.ni.com/docs/en-US/bundle/ni-daqmx-c-api-ref/page/daqmxcfunc/daqmxcreateaiforcebridgepolynomialchan.html
-const aiForceBridgePolynomialChanZ = baseAIChanZ.extend({
+export const aiForceBridgePolynomialChanZ = baseAIChanZ.extend({
   type: z.literal("ai_force_bridge_polynomial"),
   terminalConfig: terminalConfigZ,
   minVal: z.number(),
@@ -612,7 +612,7 @@ export const ZERO_AI_FORCE_IEPE_CHAN: AIForceEPEChan = {
 };
 
 // 12 - https://www.ni.com/docs/en-US/bundle/ni-daqmx-c-api-ref/page/daqmxcfunc/daqmxcreateaifreqvoltagechan.html
-const aiFreqVoltageChanZ = baseAIChanZ.extend({
+export const aiFreqVoltageChanZ = baseAIChanZ.extend({
   type: z.literal("ai_freq_voltage"),
   minVal: z.number(),
   maxVal: z.number(),
@@ -673,7 +673,7 @@ export const pressureUnitsZ = z.enum(["PoundsPerSquareInch", "Pascals", "Bar"]);
 export type PressureUnits = z.infer<typeof pressureUnitsZ>;
 
 // 14 - https://www.ni.com/docs/en-US/bundle/ni-daqmx-c-api-ref/page/daqmxcfunc/daqmxcreateaipressurebridgepolynomialchan.html
-const aiPressureBridgePolynomialChanZ = baseAIChanZ.extend({
+export const aiPressureBridgePolynomialChanZ = baseAIChanZ.extend({
   type: z.literal("ai_pressure_bridge_polynomial"),
   minVal: z.number(),
   maxVal: z.number(),
@@ -839,7 +839,7 @@ export const ZERO_AI_RESISTANCE_CHAN: AIResistanceChan = {
 };
 
 // 18 -  https://www.ni.com/docs/en-US/bundle/ni-daqmx-c-api-ref/page/daqmxcfunc/daqmxcreateairosettestraingagechan.html
-const aiRosetteStrainGageChanZ = baseAIChanZ.extend({
+export const aiRosetteStrainGageChanZ = baseAIChanZ.extend({
   type: z.literal("ai_rosette_strain_gage"),
   terminalConfig: terminalConfigZ,
   minVal: z.number(),
@@ -1065,7 +1065,7 @@ export const ZERO_AI_THERMOCOUPLE_CHAN: AIThermocoupleChan = {
 };
 
 // 23 - https://www.ni.com/docs/en-US/bundle/ni-daqmx-c-api-ref/page/daqmxcfunc/daqmxcreateaithrmstrchaniex.html
-const aiThermistorChanIex = baseAIChanZ.extend({
+export const aiThermistorChanIex = baseAIChanZ.extend({
   key: z.string(),
   type: z.literal("ai_thermistor_iex"),
   minVal: z.number(),
@@ -1100,7 +1100,7 @@ export const ZERO_AI_THERMISTOR_CHAN_IEX: AIThermistorChanIex = {
 };
 
 // 24 - https://www.ni.com/docs/en-US/bundle/ni-daqmx-c-api-ref/page/daqmxcfunc/daqmxcreateaitorquebridgepolynomialchan.html
-const aiThermistorChanVex = baseAIChanZ.extend({
+export const aiThermistorChanVex = baseAIChanZ.extend({
   key: z.string(),
   type: z.literal("ai_thermistor_vex"),
   minVal: z.number(),
@@ -1140,7 +1140,7 @@ export const torqueUnitsZ = z.enum(["NewtonMeters", "InchOunces", "FootPounds"])
 export type TorqueUnits = z.infer<typeof torqueUnitsZ>;
 
 // 25 - https://www.ni.com/docs/en-US/bundle/ni-daqmx-c-api-ref/page/daqmxcfunc/daqmxcreateaitorquebridgepolynomialchan.html
-const aiTorqueBridgePolynomialChanZ = baseAIChanZ.extend({
+export const aiTorqueBridgePolynomialChanZ = baseAIChanZ.extend({
   key: z.string(),
   type: z.literal("ai_torque_bridge_polynomial"),
   minVal: z.number(),
@@ -1345,7 +1345,7 @@ export const ZERO_AI_VOLTAGE_CHAN: AIVoltageChan = {
 };
 
 // 30 - https://www.ni.com/docs/en-US/bundle/ni-daqmx-c-api-ref/page/daqmxcfunc/daqmxcreateaivoltagermschan.html
-const aiVoltageRMSChanZ = baseAIChanZ.extend({
+export const aiVoltageRMSChanZ = baseAIChanZ.extend({
   key: z.string(),
   type: z.literal("ai_voltage_rms"),
   terminalConfig: terminalConfigZ,
@@ -1372,7 +1372,7 @@ export const ZERO_AI_VOLTAGE_RMS_CHAN: AIVoltageRMSChan = {
 };
 
 // 31 - https://www.ni.com/docs/en-US/bundle/ni-daqmx-c-api-ref/page/daqmxcfunc/daqmxcreateaivoltagechanwithexcit.html
-const aiVoltageChanWithExcitZ = baseAIChanZ.extend({
+export const aiVoltageChanWithExcitZ = baseAIChanZ.extend({
   type: z.literal("ai_voltage_with_excit"),
   terminalConfig: terminalConfigZ,
   minVal: z.number(),

package/src/hardware/task/payload.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.
 
-import { binary, observe, UnknownRecord } from "@synnaxlabs/x";
+import { binary, type observe, type UnknownRecord } from "@synnaxlabs/x";
 import { z } from "zod";
 
 import { ontology } from "@/ontology";

package/src/hardware/task/task.spec.ts

@@ -10,7 +10,7 @@
 import { id } from "@synnaxlabs/x";
 import { describe, expect, it } from "vitest";
 
-import { task } from "@/hardware/task";
+import { type task } from "@/hardware/task";
 import { newClient } from "@/setupspecs";
 
 const client = newClient();

package/src/index.ts

@@ -9,7 +9,7 @@
 
 export { access } from "@/access";
 export { policy } from "@/access/policy";
-export * from "@/channel";
+export { channel } from "@/channel";
 export { Channel } from "@/channel/client";
 export { default as Synnax, type SynnaxProps, synnaxPropsZ } from "@/client";
 export * from "@/connection";
@@ -37,6 +37,7 @@ export { signals } from "@/signals";
 export { user } from "@/user";
 export { workspace } from "@/workspace";
 export { linePlot } from "@/workspace/lineplot";
+export { log } from "@/workspace/log";
 export { schematic } from "@/workspace/schematic";
 export {
   type CrudeDataType,
@@ -48,7 +49,6 @@ export {
   DataType,
   Density,
   MultiSeries,
-  type NumericTelemValue,
   Rate,
   Series,
   type TelemValue,

package/src/label/client.ts

@@ -14,7 +14,7 @@ import { type AsyncTermSearcher } from "@synnaxlabs/x/search";
 import { type framer } from "@/framer";
 import { type Key, type Label, labelZ } from "@/label/payload";
 import { Retriever } from "@/label/retriever";
-import { type NewLabelPayload, SetOptions, Writer } from "@/label/writer";
+import { type NewLabelPayload, type SetOptions, Writer } from "@/label/writer";
 import { ontology } from "@/ontology";
 import { signals } from "@/signals";
 

package/src/ontology/client.ts

@@ -214,7 +214,7 @@ export class Client implements AsyncTermSearcher<string, string, Resource> {
   /**
    * Opens an observable that can be used to subscribe to changes in both the ontology's
    * resources and relationships.
-   * @see ChangeTracker for more information.
+   * @link ChangeTracker for more information.
    * @returns An observable that emits changes to the ontology's resources and relationships.
    */
   async openChangeTracker(): Promise<ChangeTracker> {
@@ -290,9 +290,7 @@ export class ChangeTracker {
   }
 
   private async start(): Promise<void> {
-    for await (const frame of this.streamer) {
-      await this.update(frame);
-    }
+    for await (const frame of this.streamer) await this.update(frame);
   }
 
   private async update(frame: framer.Frame): Promise<void> {

package/src/ontology/group/payload.ts

@@ -52,9 +52,9 @@ export type ParamAnalysisResult =
 
 export const analyzeParams = (groups: Params): ParamAnalysisResult => {
   const normal = toArray(groups) as Keys | Names;
-  if (normal.length === 0) {
+  if (normal.length === 0) 
     throw new Error("No groups specified");
-  }
+  
   const isKey = keyZ.safeParse(normal[0]).success;
   return {
     single: !Array.isArray(groups),

package/src/ontology/payload.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.
 
-import { change, UnknownRecord } from "@synnaxlabs/x";
+import { type change, type UnknownRecord } from "@synnaxlabs/x";
 import { z } from "zod";
 
 export type ResourceChange = change.Change<ID, Resource>;
@@ -19,6 +19,7 @@ export type RelationshipDelete = change.Delete<Relationship, undefined>;
 
 export const resourceTypeZ = z.union([
   z.literal("label"),
+  z.literal("log"),
   z.literal("allow_all"),
   z.literal("builtin"),
   z.literal("cluster"),

package/src/ranger/alias.ts

@@ -12,7 +12,7 @@ import { type change } from "@synnaxlabs/x/change";
 import { z } from "zod";
 
 import { type channel } from "@/channel";
-import { type Key as ChannelKey,keyZ as channelKeyZ } from "@/channel/payload";
+import { type Key as ChannelKey, keyZ as channelKeyZ } from "@/channel/payload";
 import { type Client as FrameClient } from "@/framer/client";
 import { type Key, keyZ } from "@/ranger/payload";
 import { signals } from "@/signals";
@@ -161,7 +161,7 @@ const aliasSeparator = "---";
 const decodeAliasChanges =
   (rangeKey: Key): signals.Decoder<string, Alias> =>
   (variant, data) => {
-    if (variant === "delete") {
+    if (variant === "delete")
       return data
         .toStrings()
         .filter((k) => k.split(aliasSeparator)[0] === rangeKey)
@@ -170,7 +170,6 @@ const decodeAliasChanges =
           key: alias,
           value: undefined,
         }));
-    }
     return data.parseJSON(aliasZ).map((alias) => ({
       variant,
       key: alias.alias,

package/src/ranger/client.ts

@@ -8,21 +8,20 @@
 // included in the file licenses/APL.txt.
 
 import { sendRequired, type UnaryClient } from "@synnaxlabs/freighter";
-import { CrudeTimeRange, observe, TimeRange } from "@synnaxlabs/x";
+import { type CrudeTimeRange, observe, TimeRange } from "@synnaxlabs/x";
 import { type AsyncTermSearcher } from "@synnaxlabs/x/search";
 import { type Series } from "@synnaxlabs/x/telem";
 import { toArray } from "@synnaxlabs/x/toArray";
 import { z } from "zod";
 
-import { Key as ChannelKey } from "@/channel/payload";
+import { type Key as ChannelKey } from "@/channel/payload";
 import { type Retriever as ChannelRetriever } from "@/channel/retriever";
-import { MultipleFoundError, NotFoundError } from "@/errors";
-import { QueryError } from "@/errors";
+import { MultipleFoundError, NotFoundError, QueryError } from "@/errors";
 import { type framer } from "@/framer";
 import { type label } from "@/label";
 import { type Label } from "@/label/payload";
 import { ontology } from "@/ontology";
-import { Resource } from "@/ontology/payload";
+import { type Resource } from "@/ontology/payload";
 import { type Alias, Aliaser } from "@/ranger/alias";
 import { KV } from "@/ranger/kv";
 import {
@@ -37,7 +36,7 @@ import {
   type Payload,
   payloadZ,
 } from "@/ranger/payload";
-import { CreateOptions, type Writer } from "@/ranger/writer";
+import { type CreateOptions, type Writer } from "@/ranger/writer";
 import { signals } from "@/signals";
 import { nullableArrayZ } from "@/util/zod";
 
@@ -98,9 +97,8 @@ export class Range {
 
   async setAlias(channel: ChannelKey | Name, alias: string): Promise<void> {
     const ch = await this.channels.retrieve(channel);
-    if (ch.length === 0) {
-      throw new QueryError(`Channel ${channel} does not exist`);
-    }
+    if (ch.length === 0) throw new QueryError(`Channel ${channel} does not exist`);
+
     await this.aliaser.set({ [ch[0].key]: alias });
   }
 

package/src/ranger/kv.ts

@@ -12,7 +12,7 @@ import { isObject } from "@synnaxlabs/x/identity";
 import { toArray } from "@synnaxlabs/x/toArray";
 import { z } from "zod";
 
-import { framer } from "@/framer";
+import { type framer } from "@/framer";
 import { type Key, keyZ } from "@/ranger/payload";
 import { signals } from "@/signals";
 import { nullableArrayZ } from "@/util/zod";
@@ -96,7 +96,7 @@ export class KV {
         key: k,
         value: v,
       }));
-    else pairs = [{ range: this.rangeKey, key: key, value: value }];
+    else pairs = [{ range: this.rangeKey, key, value }];
     await sendRequired(
       this.client,
       KV.SET_ENDPOINT,

package/src/ranger/payload.ts

@@ -79,7 +79,7 @@ export const ONTOLOGY_TYPE: ontology.ResourceType = "range";
 export const ALIAS_ONTOLOGY_TYPE: ontology.ResourceType = "range-alias";
 
 export const rangeOntologyID = (key: Key): ontology.ID =>
-  new ontology.ID({ type: ONTOLOGY_TYPE, key: key });
+  new ontology.ID({ type: ONTOLOGY_TYPE, key });
 
 export const rangeAliasOntologyID = (key: Key): ontology.ID =>
-  new ontology.ID({ type: ALIAS_ONTOLOGY_TYPE, key: key });
+  new ontology.ID({ type: ALIAS_ONTOLOGY_TYPE, key });

package/src/ranger/ranger.spec.ts

@@ -7,12 +7,12 @@
 // License, use of this software will be governed by the Apache License, Version 2.0,
 // included in the file licenses/APL.txt.
 
-import { change } from "@synnaxlabs/x";
+import { type change } from "@synnaxlabs/x";
 import { DataType, Rate, TimeSpan, TimeStamp } from "@synnaxlabs/x/telem";
 import { describe, expect, it } from "vitest";
 
 import { QueryError } from "@/errors";
-import { ranger } from "@/ranger";
+import { type ranger } from "@/ranger";
 import { type NewPayload } from "@/ranger/payload";
 import { newClient } from "@/setupspecs";
 

package/src/user/user.spec.ts

@@ -183,9 +183,8 @@ describe("User", () => {
           });
         });
         test("not found", async () => {
-          for (const u of userArray) {
+          for (const u of userArray)
             await expect(client.user.delete(u.key as string)).resolves.toBeUndefined();
-          }
           await expect(
             client.user.retrieve(userArray.map((u) => u.key as string)),
           ).rejects.toThrow(NotFoundError);

package/src/util/telem.ts

@@ -12,8 +12,6 @@ import { type DataType, type TypedArray } from "@synnaxlabs/x/telem";
 export const randomSeries = (length: number, dataType: DataType): TypedArray => {
   // generate random bytes of the correct length
   const bytes = new Uint8Array(length * dataType.density.valueOf());
-  for (let i = 0; i < bytes.byteLength; i++) {
-    bytes[i] = Math.floor(Math.random() * 256);
-  }
+  for (let i = 0; i < bytes.byteLength; i++) bytes[i] = Math.floor(Math.random() * 256);
   return new dataType.Array(bytes.buffer);
 };

package/src/workspace/client.ts

@@ -12,6 +12,7 @@ import { type UnknownRecord } from "@synnaxlabs/x/record";
 import { type AsyncTermSearcher } from "@synnaxlabs/x/search";
 
 import { linePlot } from "@/workspace/lineplot";
+import { log } from "@/workspace/log";
 import { type Key, type Workspace } from "@/workspace/payload";
 import { Retriever } from "@/workspace/retriever";
 import { schematic } from "@/workspace/schematic";
@@ -21,6 +22,7 @@ export class Client implements AsyncTermSearcher<string, Key, Workspace> {
   readonly type = "workspace";
   readonly schematic: schematic.Client;
   readonly linePlot: linePlot.Client;
+  readonly log: log.Client;
   private readonly retriever: Retriever;
   private readonly writer: Writer;
 
@@ -28,6 +30,7 @@ export class Client implements AsyncTermSearcher<string, Key, Workspace> {
     this.schematic = new schematic.Client(client);
     this.linePlot = new linePlot.Client(client);
     this.retriever = new Retriever(client);
+    this.log = new log.Client(client);
     this.writer = new Writer(client);
   }
 

package/src/workspace/lineplot/payload.ts

@@ -27,4 +27,4 @@ export type LinePlot = z.infer<typeof linePlotZ>;
 export const ONTOLOGY_TYPE: ontology.ResourceType = "lineplot";
 
 export const ontologyID = (key: Key): ontology.ID =>
-  new ontology.ID({ type: ONTOLOGY_TYPE, key: key });
+  new ontology.ID({ type: ONTOLOGY_TYPE, key });

package/src/workspace/log/client.ts

@@ -0,0 +1,51 @@
+// Copyright 2024 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 { type UnaryClient } from "@synnaxlabs/freighter";
+import { type UnknownRecord } from "@synnaxlabs/x/record";
+
+import { type Key, type Log, type Params } from "@/workspace/log/payload";
+import { Retriever } from "@/workspace/log/retriever";
+import { type NewLog, Writer } from "@/workspace/log/writer";
+
+export class Client {
+  private readonly writer: Writer;
+  private readonly retriever: Retriever;
+
+  constructor(client: UnaryClient) {
+    this.writer = new Writer(client);
+    this.retriever = new Retriever(client);
+  }
+
+  async create(workspace: string, log: NewLog): Promise<Log> {
+    return await this.writer.create(workspace, log);
+  }
+
+  async rename(key: Key, name: string): Promise<void> {
+    await this.writer.rename(key, name);
+  }
+
+  async setData(key: Key, data: UnknownRecord): Promise<void> {
+    await this.writer.setData(key, data);
+  }
+
+  async retrieve(key: Key): Promise<Log>;
+
+  async retrieve(keys: Key[]): Promise<Log[]>;
+
+  async retrieve(keys: Params): Promise<Log | Log[]> {
+    const isMany = Array.isArray(keys);
+    const res = await this.retriever.retrieve(keys);
+    return isMany ? res : res[0];
+  }
+
+  async delete(keys: Params): Promise<void> {
+    await this.writer.delete(keys);
+  }
+}

package/src/workspace/log/external.ts

@@ -0,0 +1,11 @@
+// Copyright 2024 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.
+
+export * from "@/workspace/log/client";
+export * from "@/workspace/log/payload";

package/src/workspace/log/index.ts

@@ -0,0 +1,10 @@
+// Copyright 2024 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.
+
+export * as log from "@/workspace/log/external";