@synnaxlabs/client 0.49.2 → 0.50.0

package/src/access/role/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/role/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/role.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/arc/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.
@@ -31,7 +31,6 @@ describe("arc", () => {
           edges: [],
         },
         text: { raw: "" },
-        deploy: false,
         version: "1.0.0",
       };
       const randomArc = await client.arcs.create(a);
@@ -53,7 +52,6 @@ describe("arc", () => {
           edges: [],
         },
         text: { raw: "" },
-        deploy: false,
         version: "1.0.0",
       });
       const retrieved = await userClient.arcs.retrieve({ key: randomArc.key });
@@ -74,7 +72,6 @@ describe("arc", () => {
           edges: [],
         },
         text: { raw: "" },
-        deploy: false,
         version: "1.0.0",
       });
     });
@@ -93,7 +90,6 @@ describe("arc", () => {
             edges: [],
           },
           text: { raw: "" },
-          deploy: false,
           version: "1.0.0",
         }),
       ).rejects.toThrow(AuthError);
@@ -112,7 +108,6 @@ describe("arc", () => {
           edges: [],
         },
         text: { raw: "" },
-        deploy: false,
         version: "1.0.0",
       });
       await userClient.arcs.delete(randomArc.key);
@@ -134,7 +129,6 @@ describe("arc", () => {
           edges: [],
         },
         text: { raw: "" },
-        deploy: false,
         version: "1.0.0",
       });
       await expect(userClient.arcs.delete(randomArc.key)).rejects.toThrow(AuthError);

package/src/arc/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/arc/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/arc/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/arc/lsp.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.
@@ -592,11 +592,8 @@ describe("Arc LSP", () => {
         expect(diagnostics.length).toBeGreaterThan(0);
 
         // Position should be mapped correctly (line 0 for original expression)
-        // Note: Parse errors may not be position-mapped correctly yet
-        // This is a known limitation - for now we just verify diagnostics exist
         const firstDiag = diagnostics[0];
-        console.log("Diagnostic position:", firstDiag.range.start);
-        // expect(firstDiag.range.start.line).toBe(0);
+        expect(firstDiag.range.start.line).toBe(0);
       }
 
       stream.closeSend();

package/src/arc/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.
@@ -11,7 +11,6 @@ import { record, xy } from "@synnaxlabs/x";
 import { z } from "zod/v4";
 
 import { ontology } from "@/ontology";
-import { statusZ as baseStatusZ } from "@/status/payload";
 import { parseWithoutKeyConversion } from "@/util/parseWithoutKeyConversion";
 
 export const irNodeZ = z.object({
@@ -48,27 +47,23 @@ export const keyZ = z.uuid();
 export type Key = z.infer<typeof keyZ>;
 export type Params = Key | Key[];
 
-export const statusDetailsZ = z.object({
-  running: z.boolean(),
-});
-
-export const statusZ = baseStatusZ(statusDetailsZ);
-
-export type Status = z.infer<typeof statusZ>;
+export const modeZ = z
+  .enum(["graph", "text"])
+  .or(z.literal("").transform<"graph">(() => "graph"));
+export type Mode = z.infer<typeof modeZ>;
 
 export const arcZ = z.object({
   key: keyZ,
   name: z.string(),
   graph: graphZ,
   text: textZ,
-  deploy: z.boolean(),
   version: z.string(),
-  status: statusZ.optional().nullable(),
+  mode: modeZ,
 });
 
 export interface Arc extends z.infer<typeof arcZ> {}
 
-export const newZ = arcZ.partial({ key: true }).omit({ status: true });
+export const newZ = arcZ.partial({ key: true, mode: true });
 export interface New extends z.input<typeof newZ> {}
 
 export const ONTOLOGY_TYPE = "arc";

package/src/auth/auth.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/auth/auth.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/auth/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/channel/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/channel/batchRetriever.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.
@@ -55,7 +55,6 @@ describe("channelchannel.Retriever", () => {
         virtual: false,
         expression: "",
         operations: [],
-        requires: [],
       }));
     });
     const retriever = new channel.DebouncedBatchRetriever(base, 10);
@@ -85,7 +84,6 @@ describe("channelchannel.Retriever", () => {
         virtual: false,
         expression: "",
         operations: [],
-        requires: [],
       }));
     });
     const retriever = new channel.DebouncedBatchRetriever(base, 10);

package/src/channel/channel.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.
@@ -11,7 +11,7 @@ import { DataType, id } from "@synnaxlabs/x";
 import { describe, expect, it, test } from "vitest";
 
 import { Channel } from "@/channel/client";
-import { NotFoundError, PathError } from "@/errors";
+import { NotFoundError } from "@/errors";
 import { createTestClient } from "@/testutil/client";
 
 const client = createTestClient();
@@ -51,24 +51,17 @@ describe("Channel", () => {
       expect(calculatedCH.expression).toEqual(`return ${chOneName} * 2`);
     });
 
-    test("create calculated, missing required channel", async () => {
-      try {
-        await client.channels.create({
-          name: id.create(),
-          virtual: true,
-          dataType: DataType.FLOAT32,
-          expression: `return 2`,
-        });
-      } catch (e) {
-        expect((e as Error).message).toContain(
-          "calculated channels must require at least one channel",
-        );
-        expect(PathError.matches(e)).toBe(true);
-        expect((e as PathError).path).toEqual(["requires"]);
-        expect((e as PathError).error.message).contain(
-          "calculated channels must require at least one channel",
-        );
-      }
+    test("create calculated channel with constant expression", async () => {
+      // Calculated channels can now have constant expressions that don't
+      // reference other channels
+      const calculatedCH = await client.channels.create({
+        name: id.create(),
+        virtual: true,
+        dataType: DataType.FLOAT32,
+        expression: `return 2`,
+      });
+      expect(calculatedCH.virtual).toEqual(true);
+      expect(calculatedCH.expression).toEqual(`return 2`);
     });
 
     test("create index and indexed pair", async () => {

package/src/channel/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.
@@ -111,12 +111,11 @@ export class Channel {
    */
   readonly virtual: boolean;
   /**
-   * Only used for calculated channels. Specifies the Lua expression used to evaluate
+   * Only used for calculated channels. Specifies the Arc expression used to evaluate
    * the calculated value
    */
   readonly expression: string;
   readonly operations: Operation[];
-  readonly requires: Key[];
   /**
    * The status of the channel.
    */
@@ -136,14 +135,12 @@ export class Channel {
     status: argsStatus,
     expression = "",
     operations = [],
-    requires = [],
   }: New & {
     internal?: boolean;
     frameClient?: framer.Client;
     density?: CrudeDensity;
     status?: status.Crude;
     operations?: Operation[];
-    requires?: Key[];
   }) {
     this.key = keyZ.parse(key);
     this.name = name;
@@ -156,7 +153,6 @@ export class Channel {
     this.virtual = virtual;
     this.expression = expression;
     this.operations = operations;
-    this.requires = requires;
     if (argsStatus != null) this.status = status.create(argsStatus);
     this._frameClient = frameClient ?? null;
   }
@@ -182,7 +178,6 @@ export class Channel {
       isIndex: this.isIndex,
       internal: this.internal,
       virtual: this.virtual,
-      requires: this.requires,
       expression: this.expression,
       status: this.status,
       operations: this.operations,
@@ -222,16 +217,14 @@ export class Channel {
   }
 }
 
-export const CALCULATION_STATUS_CHANNEL_NAME = "sy_calculation_status";
-
 const retrieveGroupReqZ = z.object({});
 
 const retrieveGroupResZ = z.object({ group: group.groupZ });
 
 /**
- * The core client class for executing channel operations against a Synnax
- * cluster. This class should not be instantiated directly, and instead should be used
- * through the `channels` property of an {@link Synnax} client.
+ * The main client class for executing channel operations against a Synnax Core. This
+ * class should not be instantiated directly, and instead should be used through the
+ * `channels` property of an {@link Synnax} client.
  */
 export class Client {
   private readonly frameClient: framer.Client;
@@ -437,27 +430,3 @@ export class Client {
 
 export const isCalculated = ({ virtual, expression }: Payload): boolean =>
   virtual && expression !== "";
-
-export const isLegacyCalculated = (pld: Payload): boolean =>
-  isCalculated(pld) && pld.requires.length > 0;
-
-export const resolveLegacyCalculatedIndex = async (
-  retrieve: (key: Key) => Promise<Payload | null>,
-  channel: Payload,
-): Promise<Key | null> => {
-  if (!isCalculated(channel)) return channel.index;
-  for (const required of channel.requires) {
-    const requiredChannel = await retrieve(required);
-    if (requiredChannel == null) return null;
-    if (!requiredChannel.virtual) return requiredChannel.index;
-  }
-  for (const required of channel.requires) {
-    const requiredChannel = await retrieve(required);
-    if (requiredChannel == null) return null;
-    if (isCalculated(requiredChannel)) {
-      const index = await resolveLegacyCalculatedIndex(retrieve, requiredChannel);
-      if (index != null) return index;
-    }
-  }
-  return null;
-};

package/src/channel/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/channel/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/channel/payload.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/channel/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.
@@ -58,6 +58,13 @@ export type Operation = z.infer<typeof operationZ>;
 
 export const statusZ = status.statusZ();
 export type Status = z.infer<typeof statusZ>;
+
+export const calculationStatusDetailsZ = z.object({ channel: keyZ });
+export type CalculationStatusDetails = z.infer<typeof calculationStatusDetailsZ>;
+export const calculationStatusZ = status.statusZ(calculationStatusDetailsZ);
+export type CalculationStatus = z.infer<typeof calculationStatusZ>;
+
+export const statusKey = (key: Key): string => ontology.idToString(ontologyID(key));
 export const payloadZ = z.object({
   name: z.string(),
   key: keyZ,
@@ -71,7 +78,6 @@ export const payloadZ = z.object({
   expression: z.string().default(""),
   status: statusZ.optional(),
   operations: array.nullableZ(operationZ),
-  requires: array.nullableZ(keyZ),
 });
 export interface Payload extends z.infer<typeof payloadZ> {}
 
@@ -85,11 +91,12 @@ export const newZ = payloadZ.extend({
   virtual: z.boolean().default(false),
   expression: z.string().default(""),
   operations: array.nullableZ(operationZ).optional(),
-  requires: array.nullableZ(keyZ).optional(),
 });
 
-export interface New
-  extends Omit<z.input<typeof newZ>, "dataType" | "status" | "internal"> {
+export interface New extends Omit<
+  z.input<typeof newZ>,
+  "dataType" | "status" | "internal"
+> {
   dataType: CrudeDataType;
 }
 

package/src/channel/retriever.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.
@@ -48,8 +48,10 @@ const reqZ = z.object({
 });
 export interface RetrieveRequest extends z.input<typeof reqZ> {}
 
-export interface RetrieveOptions
-  extends Omit<RetrieveRequest, "keys" | "names" | "search"> {}
+export interface RetrieveOptions extends Omit<
+  RetrieveRequest,
+  "keys" | "names" | "search"
+> {}
 export interface PageOptions extends Omit<RetrieveOptions, "offset" | "limit"> {}
 
 const resZ = z.object({ channels: array.nullableZ(payloadZ) });

package/src/channel/writer.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/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.
@@ -27,6 +27,7 @@ import { status } from "@/status";
 import { task } from "@/task";
 import { Transport } from "@/transport";
 import { user } from "@/user";
+import { view } from "@/view";
 import { workspace } from "@/workspace";
 
 export const synnaxParamsZ = z.object({
@@ -71,6 +72,7 @@ export default class Synnax extends framer.Client {
   readonly devices: device.Client;
   readonly control: control.Client;
   readonly arcs: arc.Client;
+  readonly views: view.Client;
   static readonly connectivity = connection.Checker;
   private readonly transport: Transport;
 
@@ -153,6 +155,7 @@ export default class Synnax extends framer.Client {
     this.racks = new rack.Client(this.transport.unary, this.tasks);
     this.devices = new device.Client(this.transport.unary);
     this.arcs = new arc.Client(this.transport.unary, this.transport.stream);
+    this.views = new view.Client(this.transport.unary);
   }
 
   get key(): string {
@@ -164,8 +167,10 @@ export default class Synnax extends framer.Client {
   }
 }
 
-export interface CheckConnectionParams
-  extends Pick<SynnaxParams, "host" | "port" | "secure" | "retry" | "name"> {}
+export interface CheckConnectionParams extends Pick<
+  SynnaxParams,
+  "host" | "port" | "secure" | "retry" | "name"
+> {}
 
 export const checkConnection = async (params: CheckConnectionParams) =>
   await newConnectionChecker(params).check();

package/src/connection/checker.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.
@@ -48,7 +48,7 @@ const createWarning = (
   const toUpgrade = clientIsNewer ? "Core" : "client";
   return `Synnax Core version ${nodeVersion != null ? `${nodeVersion} ` : ""}is too ${clientIsNewer ? "old" : "new"} for client version ${clientVersion}.
   This may cause compatibility issues. We recommend updating the ${toUpgrade}. For more information, see
-  https://docs.synnaxlabs.com/reference/typescript-client/troubleshooting#old-${toUpgrade}-version`;
+  https://docs.synnaxlabs.com/reference/client/resources/troubleshooting#old-${toUpgrade}-version`;
 };
 
 /** Polls a synnax cluster for connectivity information. */

package/src/connection/connection.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/connection/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/connection.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/control/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/control/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/control/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/control/state.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/control/state.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/device/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/device/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/device/device.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/device/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/device/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/device/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/errors.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/errors.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/framer/adapter.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/framer/adapter.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/framer/client.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.