@synnaxlabs/client 0.53.0 → 0.54.0

package/src/schematic/symbol/external.ts

@@ -8,4 +8,4 @@
 // included in the file licenses/APL.txt.
 
 export * from "@/schematic/symbol/client";
-export * from "@/schematic/symbol/payload";
+export * from "@/schematic/symbol/types.gen";

package/src/schematic/symbol/types.gen.ts

@@ -0,0 +1,124 @@
+// 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 { array, spatial } from "@synnaxlabs/x";
+import { z } from "zod";
+
+import { ontology } from "@/ontology";
+
+/**
+ * Region is a visual styling area within a symbol state, targeting specific SVG
+ * elements for dynamic coloring.
+ */
+export const regionZ = z.object({
+  /** key is the region identifier. */
+  key: z.string(),
+  /** name is a human-readable name for the region. */
+  name: z.string(),
+  /** selectors contains CSS selectors targeting SVG elements within the symbol. */
+  selectors: array.nullishToEmpty(z.string()),
+  /** strokeColor is an optional stroke color in hex format (#RRGGBB). */
+  strokeColor: z.string().optional(),
+  /** fillColor is an optional fill color in hex format (#RRGGBB). */
+  fillColor: z.string().optional(),
+});
+export interface Region extends z.infer<typeof regionZ> {}
+
+/** Handle is a connection point on a symbol for linking to other diagram elements. */
+export const handleZ = z.object({
+  /** key is the handle identifier. */
+  key: z.string(),
+  /** position is the (x, y) coordinate within the symbol's local space. */
+  position: spatial.xyZ,
+  /** orientation is the direction the handle faces (top, right, bottom, left). */
+  orientation: spatial.outerLocationZ,
+});
+export interface Handle extends z.infer<typeof handleZ> {}
+
+/** Viewport is the camera state for viewing or previewing a symbol. */
+export const viewportZ = z.object({
+  /** zoom is the zoom level where 1.0 equals 100%. */
+  zoom: z.number().default(1),
+  /** position is the (x, y) pan offset. */
+  position: spatial.xyZ,
+});
+export interface Viewport extends z.infer<typeof viewportZ> {}
+
+export const keyZ = z.uuid();
+export type Key = z.infer<typeof keyZ>;
+
+/** State is a named visual state of a symbol with regional styling configurations. */
+export const stateZ = z.object({
+  /** key is the state identifier. */
+  key: z.string(),
+  /** name is a human-readable name for this state. */
+  name: z.string(),
+  /** regions contains style regions defining visual appearance for this state. */
+  regions: array.nullishToEmpty(regionZ),
+});
+export interface State extends z.infer<typeof stateZ> {}
+
+/**
+ * Spec is the complete symbol definition including geometry, states, handles, and
+ * rendering properties.
+ */
+export const specZ = z.object({
+  /** svg is the SVG markup defining the symbol's visual geometry. */
+  svg: z.string().min(1),
+  /** states contains available visual states with regional styling configurations. */
+  states: array.nullishToEmpty(stateZ),
+  /** variant is the symbol variant or category identifier (e.g., 'sensor', 'valve'). */
+  variant: z.string().min(1),
+  /** handles contains connection points for linking to other diagram elements. */
+  handles: array.nullishToEmpty(handleZ),
+  /** scale is the symbol scale factor. */
+  scale: z.number().default(1),
+  /** scaleStroke indicates whether stroke width scales with the symbol size. */
+  scaleStroke: z.boolean().default(false),
+  /** previewViewport is an optional viewport configuration for symbol preview rendering. */
+  previewViewport: viewportZ.optional(),
+});
+export interface Spec extends z.infer<typeof specZ> {}
+
+/**
+ * Symbol is a persisted schematic symbol with versioning, defining reusable visual
+ * components for diagrams.
+ */
+export const symbolZ = z.object({
+  /** key is the unique identifier for this symbol. */
+  key: keyZ,
+  /** version is the symbol schema version for migration support. */
+  version: z.uint32().default(1),
+  /** name is a human-readable name for the symbol. */
+  name: z.string().min(1),
+  /** data is the complete symbol specification. */
+  data: specZ,
+});
+export interface Symbol extends z.infer<typeof symbolZ> {}
+
+/** New contains parameters for creating a new schematic symbol. */
+export const newZ = z.object({
+  /**
+   * key is an optional key for the symbol. If not provided, one will be
+   * automatically assigned.
+   */
+  key: keyZ.optional(),
+  /** version is the symbol schema version. */
+  version: z.uint32().default(1),
+  /** name is a human-readable name for the symbol. */
+  name: z.string().min(1),
+  /** data is the complete symbol specification. */
+  data: specZ,
+});
+export interface New extends z.input<typeof newZ> {}
+
+export const ontologyID = ontology.createIDFactory<Key>("schematic_symbol");
+export const TYPE_ONTOLOGY_ID = ontologyID("");

package/src/schematic/types.gen.ts

@@ -0,0 +1,44 @@
+// 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 } from "@synnaxlabs/x";
+import { z } from "zod";
+
+import { ontology } from "@/ontology";
+
+export const keyZ = z.uuid();
+export type Key = z.infer<typeof keyZ>;
+
+/**
+ * Schematic is a visual diagram editor component for drawing system schematics,
+ * control flows, and process diagrams. Schematics support interactive
+ * symbols, connection handles, and dynamic state visualization.
+ */
+export const schematicZ = z.object({
+  /** key is the unique identifier for this schematic. */
+  key: keyZ,
+  /** name is a human-readable name for the schematic. */
+  name: z.string(),
+  /**
+   * data is the schematic content including symbols, connections, and layout
+   * configuration.
+   */
+  data: caseconv.preserveCase(record.nullishToEmpty()),
+  /** snapshot indicates whether this schematic represents a saved snapshot state. */
+  snapshot: z.boolean(),
+});
+export interface Schematic extends z.infer<typeof schematicZ> {}
+
+export const newZ = schematicZ.partial({ key: true, snapshot: true });
+export interface New extends z.input<typeof newZ> {}
+
+export const ontologyID = ontology.createIDFactory<Key>("schematic");
+export const TYPE_ONTOLOGY_ID = ontologyID("");

package/src/status/client.ts

@@ -36,6 +36,7 @@ const retrieveRequestZ = z.object({
   limit: z.int().optional(),
   includeLabels: z.boolean().optional(),
   hasLabels: label.keyZ.array().optional(),
+  variants: z.string().array().optional(),
 });
 
 const singleRetrieveArgsZ = z
@@ -50,7 +51,7 @@ export type MultiRetrieveArgs = z.input<typeof retrieveRequestZ>;
 
 const retrieveResponseZ = <DetailsSchema extends z.ZodType = z.ZodNever>(
   detailsSchema?: DetailsSchema,
-) => z.object({ statuses: array.nullableZ(statusZ(detailsSchema)) });
+) => z.object({ statuses: array.nullishToEmpty(statusZ(detailsSchema)) });
 
 export interface SetOptions {
   parent?: ontology.ID;
@@ -81,7 +82,7 @@ export class Client {
       retrieveResponseZ<DetailsSchema>(args.detailsSchema),
     );
     checkForMultipleOrNoResults("Status", args, res.statuses, isSingle);
-    const statuses = res.statuses as unknown as Status<DetailsSchema>[];
+    const statuses = res.statuses as Status<DetailsSchema>[];
     return isSingle ? statuses[0] : statuses;
   }
 
@@ -109,7 +110,7 @@ export class Client {
       setReqZ(opts.detailsSchema),
       setResZ(opts.detailsSchema),
     );
-    const created = res.statuses as unknown as Status<DetailsSchema>[];
+    const created = res.statuses as Status<DetailsSchema>[];
     return isMany ? created : created[0];
   }
 

package/src/status/payload.ts

@@ -15,20 +15,21 @@ import { ontology } from "@/ontology";
 export const keyZ = z.string();
 export type Key = z.infer<typeof keyZ>;
 
-export type Params = Key | Key[];
-
+// Wrapper functions with single-param style
 export const statusZ = <Details extends z.ZodType = z.ZodNever>(
   detailsSchema?: Details,
-) => status.statusZ(detailsSchema);
+) => status.statusZ({ details: detailsSchema });
 
 export const newZ = <DetailsSchema extends z.ZodType = z.ZodNever>(
   detailsSchema?: DetailsSchema,
-) => statusZ(detailsSchema).omit({ labels: true }).extend({ key: keyZ.optional() });
+) => status.newZ({ details: detailsSchema }).omit({ labels: true });
 
+// Input type derived from Zod schema for consistency
 export type New<DetailsSchema extends z.ZodType = z.ZodNever> = z.input<
   ReturnType<typeof newZ<DetailsSchema>>
 >;
 
+// Output type re-exported from x package
 export type Status<Details extends z.ZodType = z.ZodNever> = status.Status<Details>;
 
 export const SET_CHANNEL_NAME = "sy_status_set";

package/src/status/status.spec.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 { TimeStamp, uuid } from "@synnaxlabs/x";
+import { color, status as xStatus, TimeStamp, uuid } from "@synnaxlabs/x";
 import { describe, expect, it } from "vitest";
 import z from "zod";
 
@@ -254,13 +254,15 @@ describe("Status", () => {
     it("should delete multiple statuses", async () => {
       const keys = ["del-1", "del-2", "del-3"];
       await client.statuses.set(
-        keys.map((key) => ({
-          name: `Delete ${key}`,
-          key,
-          variant: "info" as status.Status["variant"],
-          message: "To be deleted",
-          time: TimeStamp.now(),
-        })),
+        keys.map((key) =>
+          xStatus.create({
+            name: `Delete ${key}`,
+            key,
+            variant: "info",
+            message: "To be deleted",
+            time: TimeStamp.now(),
+          }),
+        ),
       );
 
       await client.statuses.delete(keys);
@@ -296,11 +298,11 @@ describe("Status", () => {
     it("should correctly retrieve a status with labels attached", async () => {
       const label1 = await client.labels.create({
         name: "Label 1",
-        color: "#0000FF",
+        color: color.construct("#0000FF"),
       });
       const label2 = await client.labels.create({
         name: "Label 2",
-        color: "#FF0000",
+        color: color.construct("#FF0000"),
       });
       const stat = await client.statuses.set({
         name: "Idempotent",
@@ -322,9 +324,102 @@ describe("Status", () => {
     });
   });
 
+  describe("retrieve with variants filter", () => {
+    it("should filter statuses by a single variant", async () => {
+      const prefix = `variant-filter-${Date.now()}`;
+      await client.statuses.set([
+        {
+          name: "Success",
+          key: `${prefix}-success`,
+          variant: "success",
+          message: "ok",
+          time: TimeStamp.now(),
+        },
+        {
+          name: "Error",
+          key: `${prefix}-error`,
+          variant: "error",
+          message: "fail",
+          time: TimeStamp.now(),
+        },
+        {
+          name: "Warning",
+          key: `${prefix}-warning`,
+          variant: "warning",
+          message: "warn",
+          time: TimeStamp.now(),
+        },
+      ]);
+
+      const results = await client.statuses.retrieve({
+        keys: [`${prefix}-success`, `${prefix}-error`, `${prefix}-warning`],
+        variants: ["error"],
+      });
+
+      expect(results).toHaveLength(1);
+      expect(results[0].variant).toBe("error");
+    });
+
+    it("should filter statuses by multiple variants", async () => {
+      const prefix = `variant-multi-${Date.now()}`;
+      await client.statuses.set([
+        {
+          name: "Info",
+          key: `${prefix}-info`,
+          variant: "info",
+          message: "info",
+          time: TimeStamp.now(),
+        },
+        {
+          name: "Error",
+          key: `${prefix}-error`,
+          variant: "error",
+          message: "error",
+          time: TimeStamp.now(),
+        },
+        {
+          name: "Success",
+          key: `${prefix}-success`,
+          variant: "success",
+          message: "success",
+          time: TimeStamp.now(),
+        },
+      ]);
+
+      const results = await client.statuses.retrieve({
+        keys: [`${prefix}-info`, `${prefix}-error`, `${prefix}-success`],
+        variants: ["info", "success"],
+      });
+
+      expect(results).toHaveLength(2);
+      const variants = results.map((s) => s.variant);
+      expect(variants).toContain("info");
+      expect(variants).toContain("success");
+      expect(variants).not.toContain("error");
+    });
+
+    it("should return empty when no statuses match variant", async () => {
+      const prefix = `variant-none-${Date.now()}`;
+      await client.statuses.set({
+        name: "Info Only",
+        key: `${prefix}-info`,
+        variant: "info",
+        message: "info",
+        time: TimeStamp.now(),
+      });
+
+      const results = await client.statuses.retrieve({
+        keys: [`${prefix}-info`],
+        variants: ["error"],
+      });
+
+      expect(results).toHaveLength(0);
+    });
+  });
+
   describe("status variants", () => {
     it("should support all status variants", async () => {
-      const variants: status.Status["variant"][] = [
+      const variants: xStatus.Variant[] = [
         "success",
         "info",
         "warning",

package/src/table/client.ts

@@ -8,25 +8,19 @@
 // included in the file licenses/APL.txt.
 
 import { sendRequired, type UnaryClient } from "@synnaxlabs/freighter";
-import { array, type record } from "@synnaxlabs/x";
+import { array, caseconv, record } from "@synnaxlabs/x";
 import { z } from "zod";
 
-import { ontology } from "@/ontology";
-import {
-  type Key,
-  keyZ,
-  type New,
-  newZ,
-  type Params,
-  remoteZ,
-  type Table,
-} from "@/table/payload";
+import { type Key, keyZ, type New, newZ, type Table, tableZ } from "@/table/types.gen";
 import { checkForMultipleOrNoResults } from "@/util/retrieve";
 import { workspace } from "@/workspace";
 
 const renameReqZ = z.object({ key: keyZ, name: z.string() });
 
-const setDataReqZ = z.object({ key: keyZ, data: z.string() });
+const setDataReqZ = z.object({
+  key: keyZ,
+  data: caseconv.preserveCase(record.unknownZ()),
+});
 const deleteReqZ = z.object({ keys: keyZ.array() });
 
 const retrieveReqZ = z.object({ keys: keyZ.array() });
@@ -39,10 +33,10 @@ export type RetrieveArgs = z.input<typeof retrieveArgsZ>;
 export type RetrieveSingleParams = z.input<typeof singleRetrieveArgsZ>;
 export type RetrieveMultipleParams = z.input<typeof retrieveReqZ>;
 
-const retrieveResZ = z.object({ tables: array.nullableZ(remoteZ) });
+const retrieveResZ = z.object({ tables: array.nullishToEmpty(tableZ) });
 
 const createReqZ = z.object({ workspace: workspace.keyZ, tables: newZ.array() });
-const createResZ = z.object({ tables: remoteZ.array() });
+const createResZ = z.object({ tables: tableZ.array() });
 
 const emptyResZ = z.object({});
 
@@ -84,7 +78,7 @@ export class Client {
     await sendRequired(
       this.client,
       "/table/set-data",
-      { key, data: JSON.stringify(data) },
+      { key, data },
       setDataReqZ,
       emptyResZ,
     );
@@ -107,7 +101,7 @@ export class Client {
     return isSingle ? res.tables[0] : res.tables;
   }
 
-  async delete(keys: Params): Promise<void> {
+  async delete(keys: Key | Key[]): Promise<void> {
     await sendRequired(
       this.client,
       "/table/delete",
@@ -117,6 +111,3 @@ export class Client {
     );
   }
 }
-
-export const ontologyID = ontology.createIDFactory<Key>("table");
-export const TYPE_ONTOLOGY_ID = ontologyID("");

package/src/table/external.ts

@@ -8,4 +8,4 @@
 // included in the file licenses/APL.txt.
 
 export * from "@/table/client";
-export * from "@/table/payload";
+export * from "@/table/types.gen";

package/src/table/table.spec.ts

@@ -65,4 +65,42 @@ describe("Table", () => {
       );
     });
   });
+  describe("case preservation", () => {
+    test("should preserve key casing in data field on create/retrieve cycle", async () => {
+      const ws = await client.workspaces.create({ name: "CaseTest", layout: {} });
+      const table = await client.tables.create(ws.key, {
+        name: "CaseTest",
+        data: {
+          camelCaseKey: "value1",
+          PascalCaseKey: "value2",
+          snake_case_key: "value3",
+          nested: {
+            innerCamelCase: 123,
+            InnerPascalCase: { deepKey: true },
+          },
+        },
+      });
+
+      const retrieved = await client.tables.retrieve({ key: table.key });
+
+      const data = retrieved.data as Record<string, unknown>;
+      expect(data.camelCaseKey).toEqual("value1");
+      expect(data.PascalCaseKey).toEqual("value2");
+      expect(data.snake_case_key).toEqual("value3");
+      expect((data.nested as Record<string, unknown>).innerCamelCase).toEqual(123);
+      expect(
+        (
+          (data.nested as Record<string, unknown>).InnerPascalCase as Record<
+            string,
+            unknown
+          >
+        ).deepKey,
+      ).toEqual(true);
+      expect(Object.keys(data)).toContain("camelCaseKey");
+      expect(Object.keys(data)).toContain("PascalCaseKey");
+      expect(Object.keys(data)).toContain("snake_case_key");
+      expect(Object.keys(data)).not.toContain("camel_case_key");
+      expect(Object.keys(data)).not.toContain("pascal_case_key");
+    });
+  });
 });

package/src/table/types.gen.ts

@@ -0,0 +1,42 @@
+// 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 } from "@synnaxlabs/x";
+import { z } from "zod";
+
+import { ontology } from "@/ontology";
+
+export const keyZ = z.uuid();
+export type Key = z.infer<typeof keyZ>;
+
+/**
+ * Table is a tabular data display component for viewing structured telemetry
+ * data. Tables support multiple columns, channel data sources, and
+ * customizable formatting options.
+ */
+export const tableZ = z.object({
+  /** key is the unique identifier for this table. */
+  key: keyZ,
+  /** name is a human-readable name for the table. */
+  name: z.string(),
+  /**
+   * data is the table configuration including column definitions, channel
+   * references, and formatting options.
+   */
+  data: caseconv.preserveCase(record.nullishToEmpty()),
+});
+export interface Table extends z.infer<typeof tableZ> {}
+
+export const newZ = tableZ.partial({ key: true });
+export interface New extends z.input<typeof newZ> {}
+
+export const ontologyID = ontology.createIDFactory<Key>("table");
+export const TYPE_ONTOLOGY_ID = ontologyID("");