@synnaxlabs/client 0.55.0 → 0.56.0

package/src/lineplot/client.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 { sendRequired, type UnaryClient } from "@synnaxlabs/freighter";
+import { type UnaryClient } from "@synnaxlabs/freighter";
 import { array, caseconv, record } from "@synnaxlabs/x";
 import { z } from "zod";
 
@@ -61,8 +61,7 @@ export class Client {
     linePlots: New | New[],
   ): Promise<LinePlot | LinePlot[]> {
     const isMany = Array.isArray(linePlots);
-    const res = await sendRequired(
-      this.client,
+    const res = await this.client.send(
       "/lineplot/create",
       { workspace, linePlots: array.toArray(linePlots) },
       createReqZ,
@@ -72,23 +71,11 @@ export class Client {
   }
 
   async rename(key: Key, name: string): Promise<void> {
-    await sendRequired(
-      this.client,
-      "/lineplot/rename",
-      { key, name },
-      renameReqZ,
-      emptyResZ,
-    );
+    await this.client.send("/lineplot/rename", { key, name }, renameReqZ, emptyResZ);
   }
 
   async setData(key: Key, data: record.Unknown): Promise<void> {
-    await sendRequired(
-      this.client,
-      "/lineplot/set-data",
-      { key, data },
-      setDataReqZ,
-      emptyResZ,
-    );
+    await this.client.send("/lineplot/set-data", { key, data }, setDataReqZ, emptyResZ);
   }
 
   async retrieve(args: RetrieveSingleParams): Promise<LinePlot>;
@@ -97,8 +84,7 @@ export class Client {
     args: RetrieveSingleParams | RetrieveMultipleParams,
   ): Promise<LinePlot | LinePlot[]> {
     const isSingle = singleRetrieveArgsZ.safeParse(args).success;
-    const res = await sendRequired(
-      this.client,
+    const res = await this.client.send(
       "/lineplot/retrieve",
       args,
       retrieveArgsZ,
@@ -109,8 +95,7 @@ export class Client {
   }
 
   async delete(keys: Key | Key[]): Promise<void> {
-    await sendRequired(
-      this.client,
+    await this.client.send(
       "/lineplot/delete",
       { keys: array.toArray(keys) },
       deleteReqZ,

package/src/log/client.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 { sendRequired, type UnaryClient } from "@synnaxlabs/freighter";
+import { type UnaryClient } from "@synnaxlabs/freighter";
 import { array, caseconv, record } from "@synnaxlabs/x";
 import { z } from "zod";
 
@@ -51,8 +51,7 @@ export class Client {
   async create(workspace: workspace.Key, logs: New[]): Promise<Log[]>;
   async create(workspace: workspace.Key, logs: New | New[]): Promise<Log | Log[]> {
     const isMany = Array.isArray(logs);
-    const res = await sendRequired(
-      this.client,
+    const res = await this.client.send(
       "/log/create",
       { workspace, logs: array.toArray(logs) },
       createReqZ,
@@ -62,23 +61,11 @@ export class Client {
   }
 
   async rename(key: Key, name: string): Promise<void> {
-    await sendRequired(
-      this.client,
-      "/log/rename",
-      { key, name },
-      renameReqZ,
-      emptyResZ,
-    );
+    await this.client.send("/log/rename", { key, name }, renameReqZ, emptyResZ);
   }
 
   async setData(key: Key, data: record.Unknown): Promise<void> {
-    await sendRequired(
-      this.client,
-      "/log/set-data",
-      { key, data },
-      setDataReqZ,
-      emptyResZ,
-    );
+    await this.client.send("/log/set-data", { key, data }, setDataReqZ, emptyResZ);
   }
 
   async retrieve(args: RetrieveSingleParams): Promise<Log>;
@@ -87,8 +74,7 @@ export class Client {
     args: RetrieveSingleParams | RetrieveMultipleParams,
   ): Promise<Log | Log[]> {
     const isSingle = singleRetrieveArgsZ.safeParse(args).success;
-    const res = await sendRequired(
-      this.client,
+    const res = await this.client.send(
       "/log/retrieve",
       args,
       retrieveArgsZ,
@@ -99,8 +85,7 @@ export class Client {
   }
 
   async delete(keys: Key | Key[]): Promise<void> {
-    await sendRequired(
-      this.client,
+    await this.client.send(
       "/log/delete",
       { keys: array.toArray(keys) },
       deleteReqZ,

package/src/ontology/client.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 { sendRequired, type UnaryClient } from "@synnaxlabs/freighter";
+import { type UnaryClient } from "@synnaxlabs/freighter";
 import { array, strings } from "@synnaxlabs/x";
 import { z } from "zod";
 
@@ -163,8 +163,7 @@ export class Client {
   }
 
   private async execRetrieve(request: RetrieveRequest): Promise<Resource[]> {
-    const { resources } = await sendRequired(
-      this.client,
+    const { resources } = await this.client.send(
       "/ontology/retrieve",
       request,
       retrieveReqZ,

package/src/ontology/types.gen.ts

@@ -15,7 +15,6 @@ export const RESOURCE_TYPES = [
   "arc",
   "builtin",
   "channel",
-  "cluster",
   "device",
   "framer",
   "group",

package/src/ontology/writer.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 { sendRequired, type UnaryClient } from "@synnaxlabs/freighter";
+import { type UnaryClient } from "@synnaxlabs/freighter";
 import { z } from "zod";
 
 import { type ID, idZ } from "@/ontology/payload";
@@ -24,8 +24,7 @@ export class Writer {
   }
 
   async addChildren(id: ID, ...children: ID[]): Promise<void> {
-    await sendRequired<typeof addRemoveChildrenReqZ, typeof emptyResZ>(
-      this.client,
+    await this.client.send(
       "/ontology/add-children",
       { id, children },
       addRemoveChildrenReqZ,
@@ -34,8 +33,7 @@ export class Writer {
   }
 
   async removeChildren(id: ID, ...children: ID[]): Promise<void> {
-    await sendRequired<typeof addRemoveChildrenReqZ, typeof emptyResZ>(
-      this.client,
+    await this.client.send(
       "/ontology/remove-children",
       { id, children },
       addRemoveChildrenReqZ,
@@ -44,8 +42,7 @@ export class Writer {
   }
 
   async moveChildren(from: ID, to: ID, ...children: ID[]): Promise<void> {
-    await sendRequired<typeof moveChildrenReqZ, typeof emptyResZ>(
-      this.client,
+    await this.client.send(
       "/ontology/move-children",
       { from, to, children },
       moveChildrenReqZ,

package/src/rack/client.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 { sendRequired, type UnaryClient } from "@synnaxlabs/freighter";
+import { type UnaryClient } from "@synnaxlabs/freighter";
 import { array } from "@synnaxlabs/x";
 import { z } from "zod";
 
@@ -82,8 +82,7 @@ export class Client {
   }
 
   async delete(keys: Key | Key[]): Promise<void> {
-    await sendRequired<typeof deleteReqZ, typeof deleteResZ>(
-      this.client,
+    await this.client.send(
       "/rack/delete",
       { keys: array.toArray(keys) },
       deleteReqZ,
@@ -95,8 +94,7 @@ export class Client {
   async create(racks: New[]): Promise<Rack[]>;
   async create(rack: New | New[]): Promise<Rack | Rack[]> {
     const isSingle = !Array.isArray(rack);
-    const res = await sendRequired<typeof createReqZ, typeof createResZ>(
-      this.client,
+    const res = await this.client.send(
       "/rack/create",
       { racks: array.toArray(rack) },
       createReqZ,
@@ -110,8 +108,7 @@ export class Client {
   async retrieve(args: RetrieveMultipleParams): Promise<Rack[]>;
   async retrieve(args: RetrieveArgs): Promise<Rack | Rack[]> {
     const isSingle = "key" in args || "name" in args;
-    const res = await sendRequired(
-      this.client,
+    const res = await this.client.send(
       "/rack/retrieve",
       args,
       retrieveArgsZ,

package/src/ranger/alias/client.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 { sendRequired, type UnaryClient } from "@synnaxlabs/freighter";
+import { type UnaryClient } from "@synnaxlabs/freighter";
 import { array } from "@synnaxlabs/x";
 import { z } from "zod";
 
@@ -64,8 +64,7 @@ export class Client {
         else toFetch.push(alias);
       });
     if (toFetch.length === 0) return cached;
-    const res = await sendRequired<typeof resolveReqZ, typeof resolveResZ>(
-      this.client,
+    const res = await this.client.send(
       "/range/alias/resolve",
       { range: this.rangeKey, aliases: toFetch },
       resolveReqZ,
@@ -76,8 +75,7 @@ export class Client {
   }
 
   async set(aliases: Record<channel.Key, string>): Promise<void> {
-    await sendRequired<typeof setReqZ, typeof setResZ>(
-      this.client,
+    await this.client.send(
       "/range/alias/set",
       { range: this.rangeKey, aliases },
       setReqZ,
@@ -87,8 +85,7 @@ export class Client {
 
   async list(): Promise<Record<channel.Key, string>> {
     return (
-      await sendRequired<typeof listReqZ, typeof listResZ>(
-        this.client,
+      await this.client.send(
         "/range/alias/list",
         { range: this.rangeKey },
         listReqZ,
@@ -104,8 +101,7 @@ export class Client {
     alias: channel.Key | channel.Key[],
   ): Promise<string | Record<channel.Key, string>> {
     const isSingle = typeof alias === "number";
-    const res = await sendRequired<typeof retrieveReqZ, typeof retrieveResZ>(
-      this.client,
+    const res = await this.client.send(
       "/range/alias/retrieve",
       { range: this.rangeKey, channels: array.toArray(alias) },
       retrieveReqZ,
@@ -115,8 +111,7 @@ export class Client {
   }
 
   async delete(aliases: channel.Key | channel.Key[]): Promise<void> {
-    await sendRequired<typeof deleteReqZ, typeof deleteResZ>(
-      this.client,
+    await this.client.send(
       "/range/alias/delete",
       { range: this.rangeKey, channels: array.toArray(aliases) },
       deleteReqZ,

package/src/ranger/client.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 { sendRequired, type UnaryClient } from "@synnaxlabs/freighter";
+import { type UnaryClient } from "@synnaxlabs/freighter";
 import {
   array,
   color,
@@ -249,8 +249,7 @@ export class Client {
   async retrieve(params: RetrieveRequest): Promise<Range[]>;
   async retrieve(params: RetrieveArgs): Promise<Range | Range[]> {
     const isSingle = typeof params === "string";
-    const { ranges } = await sendRequired(
-      this.unaryClient,
+    const { ranges } = await this.unaryClient.send(
       "/range/retrieve",
       params,
       retrieveArgsZ,

package/src/ranger/kv/client.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 { sendRequired, type UnaryClient } from "@synnaxlabs/freighter";
+import { type UnaryClient } from "@synnaxlabs/freighter";
 import { array } from "@synnaxlabs/x";
 import { z } from "zod";
 
@@ -31,8 +31,7 @@ export class Client {
   async get(key: string): Promise<string>;
   async get(keys: string[]): Promise<Record<string, string>>;
   async get(keys: string | string[]): Promise<string | Record<string, string>> {
-    const res = await sendRequired(
-      this.client,
+    const res = await this.client.send(
       "/range/kv/get",
       { range: this.rangeKey, keys: array.toArray(keys) },
       getReqZ,
@@ -58,8 +57,7 @@ export class Client {
         value: v,
       }));
 
-    await sendRequired(
-      this.client,
+    await this.client.send(
       "/range/kv/set",
       { range: this.rangeKey, pairs },
       setReqZ,
@@ -68,8 +66,7 @@ export class Client {
   }
 
   async delete(key: string | string[]): Promise<void> {
-    await sendRequired(
-      this.client,
+    await this.client.send(
       "/range/kv/delete",
       { range: this.rangeKey, keys: array.toArray(key) },
       deleteReqZ,

package/src/ranger/writer.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 { sendRequired, type UnaryClient } from "@synnaxlabs/freighter";
+import { type UnaryClient } from "@synnaxlabs/freighter";
 import { z } from "zod";
 
 import { ontology } from "@/ontology";
@@ -35,18 +35,11 @@ export class Writer {
   }
 
   async rename(key: string, name: string): Promise<void> {
-    await sendRequired<typeof renameReqZ, typeof renameResZ>(
-      this.client,
-      "/range/rename",
-      { key, name },
-      renameReqZ,
-      renameResZ,
-    );
+    await this.client.send("/range/rename", { key, name }, renameReqZ, renameResZ);
   }
 
   async create(ranges: New[], options?: CreateOptions): Promise<Payload[]> {
-    const res = await sendRequired<typeof createReqZ, typeof createResZ>(
-      this.client,
+    const res = await this.client.send(
       "/range/create",
       { ranges, ...options },
       createReqZ,
@@ -56,12 +49,6 @@ export class Writer {
   }
 
   async delete(keys: string[]): Promise<void> {
-    await sendRequired<typeof deleteReqZ, typeof deleteResZ>(
-      this.client,
-      "/range/delete",
-      { keys },
-      deleteReqZ,
-      deleteResZ,
-    );
+    await this.client.send("/range/delete", { keys }, deleteReqZ, deleteResZ);
   }
 }

package/src/schematic/access.spec.ts

@@ -29,8 +29,8 @@ describe("schematic", () => {
         layout: {},
       });
       const randomSchematic = await client.schematics.create(ws.key, {
+        ...schematic.ZERO_NEW,
         name: "test",
-        data: {},
       });
       await expect(
         userClient.schematics.retrieve({ key: randomSchematic.key }),
@@ -48,8 +48,8 @@ describe("schematic", () => {
         layout: {},
       });
       const randomSchematic = await client.schematics.create(ws.key, {
+        ...schematic.ZERO_NEW,
         name: "test",
-        data: {},
       });
       const retrieved = await userClient.schematics.retrieve({
         key: randomSchematic.key,
@@ -69,8 +69,8 @@ describe("schematic", () => {
         layout: {},
       });
       await userClient.schematics.create(ws.key, {
+        ...schematic.ZERO_NEW,
         name: "test",
-        data: {},
       });
     });
 
@@ -86,8 +86,8 @@ describe("schematic", () => {
       });
       await expect(
         userClient.schematics.create(ws.key, {
+          ...schematic.ZERO_NEW,
           name: "test",
-          data: {},
         }),
       ).rejects.toThrow(AuthError);
     });
@@ -103,8 +103,8 @@ describe("schematic", () => {
         layout: {},
       });
       const randomSchematic = await client.schematics.create(ws.key, {
+        ...schematic.ZERO_NEW,
         name: "test",
-        data: {},
       });
       await userClient.schematics.delete(randomSchematic.key);
       await expect(
@@ -123,8 +123,8 @@ describe("schematic", () => {
         layout: {},
       });
       const randomSchematic = await client.schematics.create(ws.key, {
+        ...schematic.ZERO_NEW,
         name: "test",
-        data: {},
       });
       await expect(userClient.schematics.delete(randomSchematic.key)).rejects.toThrow(
         AuthError,

package/src/schematic/actions.gen.ts

@@ -0,0 +1,200 @@
+// 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.
+
+// Code generated by Oracle. DO NOT EDIT.
+import { caseconv, record, spatial, zod } from "@synnaxlabs/x";
+import { type Draft } from "immer";
+import { z } from "zod";
+
+import { actions } from "@/actions";
+import { edgeZ, keyZ, nodeZ, type Schematic } from "@/schematic/types.gen";
+
+/** Rename renames the schematic. */
+export const renamePayloadZ = z.object({
+  name: z.string(),
+});
+
+export type RenamePayload = z.infer<typeof renamePayloadZ>;
+
+/** SetNodePosition moves a node to a new position. */
+export const setNodePositionPayloadZ = z.object({
+  key: z.string(),
+  position: spatial.xyZ,
+});
+
+export type SetNodePositionPayload = z.infer<typeof setNodePositionPayloadZ>;
+
+/**
+ * SetNodeMeasured updates the rendered pixel size of a node. Emitted by the
+ * renderer after measuring the mounted node and stored on the
+ * node so diagram measurements stay consistent across re-renders.
+ */
+export const setNodeMeasuredPayloadZ = z.object({
+  key: z.string(),
+  measured: spatial.dimensionsZ,
+});
+
+export type SetNodeMeasuredPayload = z.infer<typeof setNodeMeasuredPayloadZ>;
+
+/**
+ * SetNode inserts the node if no node with the same key exists, otherwise
+ * replaces the existing node in place. If config is non-empty it is
+ * stored under the node's key in the schematic configs map.
+ */
+export const setNodePayloadZ = z.object({
+  node: nodeZ,
+  config: caseconv.preserveCase(zod.nullToUndefined(record.unknownZ())),
+});
+
+export type SetNodePayload = z.infer<typeof setNodePayloadZ>;
+
+/** RemoveNode removes a node and any config stored under its key. */
+export const removeNodePayloadZ = z.object({
+  key: z.string(),
+});
+
+export type RemoveNodePayload = z.infer<typeof removeNodePayloadZ>;
+
+/**
+ * AddEdge appends the edge to the schematic. No-op when an edge with the
+ * same key already exists.
+ */
+export const addEdgePayloadZ = z.object({
+  edge: edgeZ,
+});
+
+export type AddEdgePayload = z.infer<typeof addEdgePayloadZ>;
+
+/** RemoveEdge removes the edge with the given key, if present. */
+export const removeEdgePayloadZ = z.object({
+  key: z.string(),
+});
+
+export type RemoveEdgePayload = z.infer<typeof removeEdgePayloadZ>;
+
+/**
+ * SetConfig merges the given config fields into the existing config entry for
+ * the given node or edge key. Top-level fields present in the payload
+ * overwrite existing fields; fields absent from the payload are
+ * preserved. When no entry exists yet and the key matches an edge
+ * whose source node carries a color, the source color overrides
+ * whatever color (if any) was in the payload.
+ */
+export const setConfigPayloadZ = z.object({
+  key: z.string(),
+  config: caseconv.preserveCase(record.nullishToEmpty()),
+});
+
+export type SetConfigPayload = z.infer<typeof setConfigPayloadZ>;
+
+export const actionZ = z.discriminatedUnion("type", [
+  z.object({ type: z.literal("rename"), rename: renamePayloadZ }),
+  z.object({
+    type: z.literal("set_node_position"),
+    setNodePosition: setNodePositionPayloadZ,
+  }),
+  z.object({
+    type: z.literal("set_node_measured"),
+    setNodeMeasured: setNodeMeasuredPayloadZ,
+  }),
+  z.object({ type: z.literal("set_node"), setNode: setNodePayloadZ }),
+  z.object({ type: z.literal("remove_node"), removeNode: removeNodePayloadZ }),
+  z.object({ type: z.literal("add_edge"), addEdge: addEdgePayloadZ }),
+  z.object({ type: z.literal("remove_edge"), removeEdge: removeEdgePayloadZ }),
+  z.object({ type: z.literal("set_config"), setConfig: setConfigPayloadZ }),
+]);
+
+export type Action = z.infer<typeof actionZ>;
+
+export const rename = (payload: RenamePayload): Action => ({
+  type: "rename",
+  rename: payload,
+});
+
+export const setNodePosition = (payload: SetNodePositionPayload): Action => ({
+  type: "set_node_position",
+  setNodePosition: payload,
+});
+
+export const setNodeMeasured = (payload: SetNodeMeasuredPayload): Action => ({
+  type: "set_node_measured",
+  setNodeMeasured: payload,
+});
+
+export const setNode = (payload: SetNodePayload): Action => ({
+  type: "set_node",
+  setNode: payload,
+});
+
+export const removeNode = (payload: RemoveNodePayload): Action => ({
+  type: "remove_node",
+  removeNode: payload,
+});
+
+export const addEdge = (payload: AddEdgePayload): Action => ({
+  type: "add_edge",
+  addEdge: payload,
+});
+
+export const removeEdge = (payload: RemoveEdgePayload): Action => ({
+  type: "remove_edge",
+  removeEdge: payload,
+});
+
+export const setConfig = (payload: SetConfigPayload): Action => ({
+  type: "set_config",
+  setConfig: payload,
+});
+
+export type HandlerResult = actions.HandlerResult<Action>;
+
+export type ReduceAllResult = actions.ReduceAllResult<Schematic, Action>;
+
+export interface Handlers {
+  rename: (state: Draft<Schematic>, payload: RenamePayload) => HandlerResult;
+  setNodePosition: (
+    state: Draft<Schematic>,
+    payload: SetNodePositionPayload,
+  ) => HandlerResult;
+  setNodeMeasured: (
+    state: Draft<Schematic>,
+    payload: SetNodeMeasuredPayload,
+  ) => HandlerResult;
+  setNode: (state: Draft<Schematic>, payload: SetNodePayload) => HandlerResult;
+  removeNode: (state: Draft<Schematic>, payload: RemoveNodePayload) => HandlerResult;
+  addEdge: (state: Draft<Schematic>, payload: AddEdgePayload) => HandlerResult;
+  removeEdge: (state: Draft<Schematic>, payload: RemoveEdgePayload) => HandlerResult;
+  setConfig: (state: Draft<Schematic>, payload: SetConfigPayload) => HandlerResult;
+}
+
+export const createReduceAll = (handlers: Handlers) =>
+  actions.createReduceAll<Schematic, Action>((state, action) => {
+    switch (action.type) {
+      case "rename":
+        return handlers.rename(state, action.rename);
+      case "set_node_position":
+        return handlers.setNodePosition(state, action.setNodePosition);
+      case "set_node_measured":
+        return handlers.setNodeMeasured(state, action.setNodeMeasured);
+      case "set_node":
+        return handlers.setNode(state, action.setNode);
+      case "remove_node":
+        return handlers.removeNode(state, action.removeNode);
+      case "add_edge":
+        return handlers.addEdge(state, action.addEdge);
+      case "remove_edge":
+        return handlers.removeEdge(state, action.removeEdge);
+      case "set_config":
+        return handlers.setConfig(state, action.setConfig);
+    }
+  });
+
+export const scopedActionZ = actions.scopedZ(keyZ, actionZ);
+
+export const dispatchReqZ = actions.dispatchReqZ(keyZ, actionZ);