@synnaxlabs/client 0.45.1 → 0.46.0

package/examples/node/package-lock.json

@@ -9,7 +9,7 @@
       "version": "1.0.0",
       "license": "ISC",
       "dependencies": {
-        "@synnaxlabs/client": "^0.43.0"
+        "@synnaxlabs/client": "^0.45.1"
       }
     },
     "node_modules/@msgpack/msgpack": {
@@ -31,49 +31,47 @@
       }
     },
     "node_modules/@synnaxlabs/alamos": {
-      "version": "0.43.0",
-      "resolved": "https://registry.npmjs.org/@synnaxlabs/alamos/-/alamos-0.43.0.tgz",
-      "integrity": "sha512-NSBfO4eGLqEUuMvGqYEq8mdoezA/+mSFZR2+NJ7yQMbAsDE4yUWLol2RaakiZNV8rZk5vszEI/rc2BhY7RMdug==",
+      "version": "0.45.1",
+      "resolved": "https://registry.npmjs.org/@synnaxlabs/alamos/-/alamos-0.45.1.tgz",
+      "integrity": "sha512-UF+vWStLOfyk3sDGl1AMccoYuGjwDr7NU9VmoES8WANjlW/IpxCuUHwZgMQLbMsWrTKyzBi0UKaRRHcdV7g2iA==",
       "license": "MIT",
       "dependencies": {
         "@opentelemetry/api": "^1.9.0",
-        "@synnaxlabs/x": "0.43.0"
+        "@synnaxlabs/x": "^0.45.1"
       }
     },
     "node_modules/@synnaxlabs/client": {
-      "version": "0.43.0",
-      "resolved": "https://registry.npmjs.org/@synnaxlabs/client/-/client-0.43.0.tgz",
-      "integrity": "sha512-u+1IlU+R2jmy/sFJKc/9T9AeHvTERLhtVF2dWK3CcxrjyjNVNEzfOMBQXlEF4CZJtuMmiv4cgw5S7UL64hCW3w==",
+      "version": "0.45.1",
+      "resolved": "https://registry.npmjs.org/@synnaxlabs/client/-/client-0.45.1.tgz",
+      "integrity": "sha512-DSIaLauKaa7VO9UL5nAaCXJKhSbWkLIvCJpHESWXgrkMMV3qSBayxrWDK7USoaa/qbINRQjL03TbsxTyCGI0tg==",
       "license": "BUSL-1.1",
       "dependencies": {
-        "@synnaxlabs/freighter": "0.43.0",
-        "@synnaxlabs/x": "0.43.0",
+        "@synnaxlabs/freighter": "^0.45.1",
+        "@synnaxlabs/x": "^0.45.1",
         "async-mutex": "^0.5.0",
-        "zod": "^3.25.63"
+        "zod": "^4.0.2"
       }
     },
     "node_modules/@synnaxlabs/freighter": {
-      "version": "0.43.0",
-      "resolved": "https://registry.npmjs.org/@synnaxlabs/freighter/-/freighter-0.43.0.tgz",
-      "integrity": "sha512-b/TPZjgg1M9fdK1B8AkofhJ+fC47XqdUfjN/xPvVHzKx371bkr+LeYnVBN+FPhWP+20uL6SPxlGK5R/zWra6oQ==",
+      "version": "0.45.1",
+      "resolved": "https://registry.npmjs.org/@synnaxlabs/freighter/-/freighter-0.45.1.tgz",
+      "integrity": "sha512-lwX0xboE7cXX6SI0N1ojaQzbtXQ82MAwCfG9RRM+lkzq/dQi3XcGbOSsqBz6uHvxENJRPJADGljmnb4vO1CMzA==",
       "dependencies": {
-        "@synnaxlabs/alamos": "0.43.0",
-        "@synnaxlabs/x": "0.43.0",
-        "node-fetch": "^2.7.0",
-        "ws": "^8.18.2",
-        "zod": "^3.25.63"
+        "@synnaxlabs/alamos": "^0.45.1",
+        "@synnaxlabs/x": "^0.45.1",
+        "zod": "^4.0.2"
       }
     },
     "node_modules/@synnaxlabs/x": {
-      "version": "0.43.0",
-      "resolved": "https://registry.npmjs.org/@synnaxlabs/x/-/x-0.43.0.tgz",
-      "integrity": "sha512-DsMuFjKtTvscfjEq3PeUhMdkHf9CuPUEyYGjGJhthqn19KftNRzoFqlPvvQsngq9bjv7shd4p0qaMOm4y/FimQ==",
+      "version": "0.45.1",
+      "resolved": "https://registry.npmjs.org/@synnaxlabs/x/-/x-0.45.1.tgz",
+      "integrity": "sha512-EDPxThi/bXoyNhs8Az4e4R52nliSkVE6TGYsTO1OFKTOU3Ej9dx9ucxy3HaClv0EsaNSEpSCEueSMx9KYxHXQw==",
       "dependencies": {
         "@msgpack/msgpack": "^3.1.2",
         "async-mutex": "^0.5.0",
         "nanoid": "^5.1.5",
         "uuid": "^11.1.0",
-        "zod": "^3.25.63"
+        "zod": "^4.0.2"
       }
     },
     "node_modules/async-mutex": {
@@ -86,9 +84,9 @@
       }
     },
     "node_modules/nanoid": {
-      "version": "5.1.5",
-      "resolved": "https://registry.npmjs.org/nanoid/-/nanoid-5.1.5.tgz",
-      "integrity": "sha512-Ir/+ZpE9fDsNH0hQ3C68uyThDXzYcim2EqcZ8zn8Chtt1iylPT9xXJB0kPCnqzgcEGikO9RxSrh63MsmVCU7Fw==",
+      "version": "5.1.6",
+      "resolved": "https://registry.npmjs.org/nanoid/-/nanoid-5.1.6.tgz",
+      "integrity": "sha512-c7+7RQ+dMB5dPwwCp4ee1/iV/q2P6aK1mTZcfr1BTuVlyW9hJYiMPybJCcnBlQtuSmTIWNeazm/zqNoZSSElBg==",
       "funding": [
         {
           "type": "github",
@@ -103,36 +101,10 @@
         "node": "^18 || >=20"
       }
     },
-    "node_modules/node-fetch": {
-      "version": "2.7.0",
-      "resolved": "https://registry.npmjs.org/node-fetch/-/node-fetch-2.7.0.tgz",
-      "integrity": "sha512-c4FRfUm/dbcWZ7U+1Wq0AwCyFL+3nt2bEw05wfxSz+DWpWsitgmSgYmy2dQdWyKC1694ELPqMs/YzUSNozLt8A==",
-      "license": "MIT",
-      "dependencies": {
-        "whatwg-url": "^5.0.0"
-      },
-      "engines": {
-        "node": "4.x || >=6.0.0"
-      },
-      "peerDependencies": {
-        "encoding": "^0.1.0"
-      },
-      "peerDependenciesMeta": {
-        "encoding": {
-          "optional": true
-        }
-      }
-    },
-    "node_modules/tr46": {
-      "version": "0.0.3",
-      "resolved": "https://registry.npmjs.org/tr46/-/tr46-0.0.3.tgz",
-      "integrity": "sha512-N3WMsuqV66lT30CrXNbEjx4GEwlow3v6rr4mCcv6prnfwhS01rkgyFdjPNBYd9br7LpXV1+Emh01fHnq2Gdgrw==",
-      "license": "MIT"
-    },
     "node_modules/tslib": {
-      "version": "2.7.0",
-      "resolved": "https://registry.npmjs.org/tslib/-/tslib-2.7.0.tgz",
-      "integrity": "sha512-gLXCKdN1/j47AiHiOkJN69hJmcbGTHI0ImLmbYLHykhgeN0jVGola9yVjFgzCUklsZQMW55o+dW7IXv3RCXDzA==",
+      "version": "2.8.1",
+      "resolved": "https://registry.npmjs.org/tslib/-/tslib-2.8.1.tgz",
+      "integrity": "sha512-oJFu94HQb+KVduSUQL7wnpmqnfmLsOA/nAh6b6EH0wCEoK0/mPeXU6c3wKDV83MkOuHPRHtSXKKU99IBazS/2w==",
       "license": "0BSD"
     },
     "node_modules/uuid": {
@@ -148,47 +120,10 @@
         "uuid": "dist/esm/bin/uuid"
       }
     },
-    "node_modules/webidl-conversions": {
-      "version": "3.0.1",
-      "resolved": "https://registry.npmjs.org/webidl-conversions/-/webidl-conversions-3.0.1.tgz",
-      "integrity": "sha512-2JAn3z8AR6rjK8Sm8orRC0h/bcl/DqL7tRPdGZ4I1CjdF+EaMLmYxBHyXuKL849eucPFhvBoxMsflfOb8kxaeQ==",
-      "license": "BSD-2-Clause"
-    },
-    "node_modules/whatwg-url": {
-      "version": "5.0.0",
-      "resolved": "https://registry.npmjs.org/whatwg-url/-/whatwg-url-5.0.0.tgz",
-      "integrity": "sha512-saE57nupxk6v3HY35+jzBwYa0rKSy0XR8JSxZPwgLr7ys0IBzhGviA1/TUGJLmSVqs8pb9AnvICXEuOHLprYTw==",
-      "license": "MIT",
-      "dependencies": {
-        "tr46": "~0.0.3",
-        "webidl-conversions": "^3.0.0"
-      }
-    },
-    "node_modules/ws": {
-      "version": "8.18.2",
-      "resolved": "https://registry.npmjs.org/ws/-/ws-8.18.2.tgz",
-      "integrity": "sha512-DMricUmwGZUVr++AEAe2uiVM7UoO9MAVZMDu05UQOaUII0lp+zOzLLU4Xqh/JvTqklB1T4uELaaPBKyjE1r4fQ==",
-      "license": "MIT",
-      "engines": {
-        "node": ">=10.0.0"
-      },
-      "peerDependencies": {
-        "bufferutil": "^4.0.1",
-        "utf-8-validate": ">=5.0.2"
-      },
-      "peerDependenciesMeta": {
-        "bufferutil": {
-          "optional": true
-        },
-        "utf-8-validate": {
-          "optional": true
-        }
-      }
-    },
     "node_modules/zod": {
-      "version": "3.25.64",
-      "resolved": "https://registry.npmjs.org/zod/-/zod-3.25.64.tgz",
-      "integrity": "sha512-hbP9FpSZf7pkS7hRVUrOjhwKJNyampPgtXKc3AN6DsWtoHsg2Sb4SQaS4Tcay380zSwd2VPo9G9180emBACp5g==",
+      "version": "4.1.11",
+      "resolved": "https://registry.npmjs.org/zod/-/zod-4.1.11.tgz",
+      "integrity": "sha512-WPsqwxITS2tzx1bzhIKsEs19ABD5vmCVa4xBo2tq/SrV4RNZtfws1EnCWQXM6yh8bD08a1idvkB5MZSBiZsjwg==",
       "license": "MIT",
       "funding": {
         "url": "https://github.com/sponsors/colinhacks"

package/examples/node/package.json

@@ -12,6 +12,6 @@
   "author": "",
   "license": "ISC",
   "dependencies": {
-    "@synnaxlabs/client": "^0.43.0"
+    "@synnaxlabs/client": "^0.45.1"
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@synnaxlabs/client",
-  "version": "0.45.1",
+  "version": "0.46.0",
   "description": "The Synnax Client Library",
   "keywords": [
     "synnax",
@@ -25,20 +25,20 @@
   },
   "dependencies": {
     "async-mutex": "^0.5.0",
-    "zod": "^4.0.2",
-    "@synnaxlabs/freighter": "^0.45.1",
-    "@synnaxlabs/x": "^0.45.1"
+    "zod": "^4.1.8",
+    "@synnaxlabs/freighter": "^0.46.0",
+    "@synnaxlabs/x": "^0.46.0"
   },
   "devDependencies": {
     "@vitest/coverage-v8": "^3.2.4",
-    "@types/node": "^24.0.12",
-    "eslint": "^9.30.1",
+    "@types/node": "^24.4.0",
+    "eslint": "^9.35.0",
     "madge": "^8.0.0",
-    "typescript": "^5.8.3",
-    "vite": "^7.0.4",
+    "typescript": "^5.9.2",
+    "vite": "^7.1.5",
     "vitest": "^3.2.4",
-    "@synnaxlabs/vite-plugin": "^0.43.0",
     "@synnaxlabs/tsconfig": "^0.43.0",
+    "@synnaxlabs/vite-plugin": "^0.43.0",
     "eslint-config-synnaxlabs": "^0.43.0"
   },
   "type": "module",

package/src/access/policy/client.ts

@@ -20,7 +20,6 @@ import {
   policyZ,
 } from "@/access/policy/payload";
 import { ontology } from "@/ontology";
-import { nullableArrayZ } from "@/util/zod";
 
 const retrieveRequestZ = z.object({
   keys: keyZ.array().optional(),
@@ -41,14 +40,14 @@ const listRetrieveArgsZ = z.union([
   retrieveRequestZ,
 ]);
 
-export type SingleRetrieveArgs = z.input<typeof keyRetrieveRequestZ>;
-export type ListRetrieveArgs = z.input<typeof listRetrieveArgsZ>;
+export type RetrieveSingleParams = z.input<typeof keyRetrieveRequestZ>;
+export type RetrieveMultipleParams = z.input<typeof listRetrieveArgsZ>;
 
 const retrieveArgsZ = z.union([keyRetrieveRequestZ, listRetrieveArgsZ]);
 
 export type RetrieveArgs = z.input<typeof retrieveArgsZ>;
 
-const retrieveResZ = z.object({ policies: nullableArrayZ(policyZ) });
+const retrieveResZ = z.object({ policies: array.nullableZ(policyZ) });
 
 const createReqZ = z.object({ policies: policyZ.partial({ key: true }).array() });
 const createResZ = z.object({ policies: policyZ.array() });
@@ -86,8 +85,8 @@ export class Client {
     return isMany ? res.policies : res.policies[0];
   }
 
-  async retrieve(args: SingleRetrieveArgs): Promise<Policy>;
-  async retrieve(args: ListRetrieveArgs): Promise<Policy[]>;
+  async retrieve(args: RetrieveSingleParams): Promise<Policy>;
+  async retrieve(args: RetrieveMultipleParams): Promise<Policy[]>;
   async retrieve(args: RetrieveArgs): Promise<Policy | Policy[]> {
     const isSingle = "key" in args;
     const res = await sendRequired<typeof retrieveArgsZ, typeof retrieveResZ>(

package/src/access/policy/payload.ts

@@ -7,20 +7,20 @@
 // License, use of this software will be governed by the Apache License, Version 2.0,
 // included in the file licenses/APL.txt.
 
+import { array } from "@synnaxlabs/x";
 import { z } from "zod";
 
 import { actionZ } from "@/access/payload";
 import { ontology } from "@/ontology";
-import { nullableArrayZ } from "@/util/zod";
 
 export const keyZ = z.uuid();
 export type Key = z.infer<typeof keyZ>;
 
 export const policyZ = z.object({
   key: keyZ,
-  subjects: nullableArrayZ(ontology.idZ),
-  objects: nullableArrayZ(ontology.idZ),
-  actions: nullableArrayZ(actionZ),
+  subjects: array.nullableZ(ontology.idZ),
+  objects: array.nullableZ(ontology.idZ),
+  actions: array.nullableZ(actionZ),
 });
 export interface Policy extends z.infer<typeof policyZ> {}
 

package/src/access/policy/policy.spec.ts

@@ -297,11 +297,11 @@ describe("Policy", () => {
 describe("privilege", async () => {
   test("new user", async () => {
     const username = id.create();
-    const user2 = await client.user.create({ username, password: "pwd1" });
+    const user2 = await client.users.create({ username, password: "pwd1" });
     expect(user2).toBeDefined();
     const client2 = createTestClient({ username: user2.username, password: "pwd1" });
     await expect(
-      client2.user.create({ username: id.create(), password: id.create() }),
+      client2.users.create({ username: id.create(), password: id.create() }),
     ).rejects.toThrow(AuthError);
 
     const policy = await client.access.policy.create({
@@ -312,7 +312,7 @@ describe("privilege", async () => {
 
     const newUsername = id.create();
 
-    const newUser = await client2.user.create({
+    const newUser = await client2.users.create({
       username: newUsername,
       password: id.create(),
     });
@@ -323,7 +323,7 @@ describe("privilege", async () => {
     await client.access.policy.delete(policy.key);
 
     await expect(
-      client2.user.create({ username: id.create(), password: id.create() }),
+      client2.users.create({ username: id.create(), password: id.create() }),
     ).rejects.toThrow(AuthError);
   });
 });

package/src/arc/client.ts

@@ -0,0 +1,117 @@
+// Copyright 2025 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 { sendRequired, type UnaryClient } from "@synnaxlabs/freighter";
+import { array } from "@synnaxlabs/x";
+import { z } from "zod/v4";
+
+import {
+  type Arc,
+  arcZ,
+  type Key,
+  keyZ,
+  type New,
+  newZ,
+  ONTOLOGY_TYPE,
+  type Params,
+} from "@/arc/payload";
+import { type ontology } from "@/ontology";
+import { checkForMultipleOrNoResults } from "@/util/retrieve";
+
+const RETRIEVE_ENDPOINT = "/arc/retrieve";
+const CREATE_ENDPOINT = "/arc/create";
+const DELETE_ENDPOINT = "/arc/delete";
+
+const retrieveReqZ = z.object({
+  keys: keyZ.array().optional(),
+  names: z.string().array().optional(),
+  searchTerm: z.string().optional(),
+  limit: z.number().optional(),
+  offset: z.number().optional(),
+  includeStatus: z.boolean().optional(),
+});
+const createReqZ = z.object({ arcs: newZ.array() });
+const deleteReqZ = z.object({ keys: keyZ.array() });
+
+const retrieveResZ = z.object({ arcs: array.nullableZ(arcZ) });
+const createResZ = z.object({ arcs: arcZ.array() });
+const emptyResZ = z.object({});
+
+export type RetrieveRequest = z.input<typeof retrieveReqZ>;
+
+const keyRetrieveRequestZ = z
+  .object({
+    key: keyZ,
+    includeStatus: z.boolean().optional(),
+  })
+  .transform(({ key, includeStatus }) => ({ keys: [key], includeStatus }));
+
+const nameRetrieveRequestZ = z
+  .object({
+    name: z.string(),
+    includeStatus: z.boolean().optional(),
+  })
+  .transform(({ name, includeStatus }) => ({ names: [name], includeStatus }));
+
+export const singleRetrieveArgsZ = z.union([keyRetrieveRequestZ, nameRetrieveRequestZ]);
+
+export type SingleRetrieveArgs = z.input<typeof singleRetrieveArgsZ>;
+
+const retrieveArgsZ = z.union([singleRetrieveArgsZ, retrieveReqZ]);
+
+export type RetrieveArgs = z.input<typeof retrieveArgsZ>;
+
+export class Client {
+  private readonly client: UnaryClient;
+
+  constructor(client: UnaryClient) {
+    this.client = client;
+  }
+
+  async create(arc: New): Promise<Arc>;
+  async create(arcs: New[]): Promise<Arc[]>;
+  async create(arcs: New | New[]): Promise<Arc | Arc[]> {
+    const isMany = Array.isArray(arcs);
+    const res = await sendRequired(
+      this.client,
+      CREATE_ENDPOINT,
+      { arcs: array.toArray(arcs) },
+      createReqZ,
+      createResZ,
+    );
+    return isMany ? res.arcs : res.arcs[0];
+  }
+
+  async retrieve(args: SingleRetrieveArgs): Promise<Arc>;
+  async retrieve(args: RetrieveArgs): Promise<Arc[]>;
+  async retrieve(args: RetrieveArgs): Promise<Arc | Arc[]> {
+    const isSingle = "key" in args || "name" in args;
+    const res = await sendRequired(
+      this.client,
+      RETRIEVE_ENDPOINT,
+      args,
+      retrieveArgsZ,
+      retrieveResZ,
+    );
+    checkForMultipleOrNoResults("Arc", args, res.arcs, isSingle);
+    return isSingle ? res.arcs[0] : res.arcs;
+  }
+
+  async delete(keys: Params): Promise<void> {
+    await sendRequired(
+      this.client,
+      DELETE_ENDPOINT,
+      { keys: array.toArray(keys) },
+      deleteReqZ,
+      emptyResZ,
+    );
+  }
+}
+
+export const ontologyID = (key: Key): ontology.ID => ({ type: ONTOLOGY_TYPE, key });

package/src/{util/zod.ts → arc/external.ts}

@@ -7,10 +7,5 @@
 // License, use of this software will be governed by the Apache License, Version 2.0,
 // included in the file licenses/APL.txt.
 
-import { z } from "zod";
-
-export const nullableArrayZ = <Z extends z.ZodType>(item: Z) =>
-  z.union([
-    z.union([z.null(), z.undefined()]).transform<z.infer<Z>[]>(() => []),
-    item.array(),
-  ]);
+export * from "@/arc/client";
+export * from "@/arc/payload";

package/src/arc/index.ts

@@ -0,0 +1,10 @@
+// Copyright 2025 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 arc from "@/arc/external";

package/src/arc/payload.ts

@@ -0,0 +1,69 @@
+// Copyright 2025 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 { xy } from "@synnaxlabs/x";
+import { record } from "@synnaxlabs/x/record";
+import { z } from "zod/v4";
+
+import { type Status } from "@/status/payload";
+import { parseWithoutKeyConversion } from "@/util/parseWithoutKeyConversion";
+
+export const irNodeZ = z.object({
+  key: z.string(),
+  type: z.string(),
+  config: record.unknownZ.or(z.string().transform(parseWithoutKeyConversion)),
+  source: z.string().optional(),
+});
+
+export const graphNodeZ = irNodeZ.extend({
+  position: xy.xy,
+});
+
+export const handleZ = z.object({ param: z.string(), node: z.string() });
+
+export const edgeZ = z.object({ source: handleZ, target: handleZ });
+
+export const irZ = z.object({
+  nodes: irNodeZ.array(),
+  edges: edgeZ.array(),
+});
+
+export const graphZ = z.object({
+  nodes: graphNodeZ.array(),
+  edges: edgeZ.array(),
+});
+
+export const textZ = z.object({ raw: z.string() });
+
+export interface IR extends z.infer<typeof irZ> {}
+export interface Graph extends z.infer<typeof graphZ> {}
+export interface Text extends z.infer<typeof textZ> {}
+
+export const keyZ = z.uuid();
+export type Key = z.infer<typeof keyZ>;
+export type Params = Key | Key[];
+
+export const arcZ = z.object({
+  key: keyZ,
+  name: z.string(),
+  graph: graphZ,
+  text: textZ,
+  deploy: z.boolean(),
+  version: z.string(),
+});
+
+export interface Arc extends z.infer<typeof arcZ> {
+  status?: Status;
+}
+
+export const newZ = arcZ.partial({ key: true });
+export interface New extends z.input<typeof newZ> {}
+
+export const ONTOLOGY_TYPE = "arc";
+export type OntologyType = typeof ONTOLOGY_TYPE;

package/src/channel/client.ts

@@ -11,10 +11,10 @@ import { sendRequired, type UnaryClient } from "@synnaxlabs/freighter";
 import { array, status } from "@synnaxlabs/x";
 import {
   type CrudeDensity,
+  type CrudeTimeRange,
   type CrudeTimeStamp,
   DataType,
   type MultiSeries,
-  type TimeRange,
   type TypedArray,
 } from "@synnaxlabs/x/telem";
 import { z } from "zod";
@@ -201,7 +201,7 @@ export class Channel {
    * @param end - The ending timestamp of the range to read from.
    * @returns A typed array containing the retrieved
    */
-  async read(tr: TimeRange): Promise<MultiSeries> {
+  async read(tr: CrudeTimeRange): Promise<MultiSeries> {
     return await this.framer.read(tr, this.key);
   }
 
@@ -230,7 +230,6 @@ const retrieveGroupResZ = z.object({ group: group.groupZ });
  * through the `channels` property of an {@link Synnax} client.
  */
 export class Client {
-  readonly type = "channel";
   private readonly frameClient: framer.Client;
   private readonly client: UnaryClient;
   readonly retriever: Retriever;
@@ -428,7 +427,7 @@ export class Client {
       retrieveGroupReqZ,
       retrieveGroupResZ,
     );
-    return new group.Group(res.group.name, res.group.key);
+    return res.group;
   }
 }
 

package/src/channel/payload.ts

@@ -7,18 +7,16 @@
 // License, use of this software will be governed by the Apache License, Version 2.0,
 // included in the file licenses/APL.txt.
 
-import { type CrudeDataType, DataType, status, zod } from "@synnaxlabs/x";
+import { array, type CrudeDataType, DataType, math, status, zod } from "@synnaxlabs/x";
 import { z } from "zod";
 
-import { nullableArrayZ } from "@/util/zod";
-
 const errorMessage = "Channel key must be a valid uint32.";
 export const keyZ = z.uint32().or(
   z
     .string()
     .refine((val) => !isNaN(Number(val)), { message: errorMessage })
     .transform(Number)
-    .refine((val) => val < 2 ** 32 - 1, { message: errorMessage }),
+    .refine((val) => val < math.MAX_UINT32, { message: errorMessage }),
 );
 export type Key = z.infer<typeof keyZ>;
 export type Keys = Key[];
@@ -42,7 +40,7 @@ export const payloadZ = z.object({
   virtual: z.boolean(),
   alias: z.string().optional(),
   expression: z.string().default(""),
-  requires: nullableArrayZ(keyZ),
+  requires: array.nullableZ(keyZ),
   status: statusZ.optional(),
 });
 export interface Payload extends z.infer<typeof payloadZ> {}
@@ -55,7 +53,7 @@ export const newZ = payloadZ.extend({
   internal: z.boolean().optional().default(false),
   virtual: z.boolean().optional().default(false),
   expression: z.string().optional().default(""),
-  requires: nullableArrayZ(keyZ).optional().default([]),
+  requires: array.nullableZ(keyZ).optional().default([]),
 });
 
 export interface New

package/src/channel/retriever.ts

@@ -8,6 +8,7 @@
 // included in the file licenses/APL.txt.
 
 import { type UnaryClient } from "@synnaxlabs/freighter";
+import { array } from "@synnaxlabs/x/array";
 import { debounce } from "@synnaxlabs/x/debounce";
 import { DataType } from "@synnaxlabs/x/telem";
 import { Mutex } from "async-mutex";
@@ -30,7 +31,6 @@ import {
   analyzeParams as analyzeParameters,
   type ParamAnalysisResult,
 } from "@/util/retrieve";
-import { nullableArrayZ } from "@/util/zod";
 
 const reqZ = z.object({
   leaseholder: z.number().optional(),
@@ -53,7 +53,7 @@ export interface RetrieveOptions
   extends Omit<RetrieveRequest, "keys" | "names" | "search"> {}
 export interface PageOptions extends Omit<RetrieveOptions, "offset" | "limit"> {}
 
-const resZ = z.object({ channels: nullableArrayZ(payloadZ) });
+const resZ = z.object({ channels: array.nullableZ(payloadZ) });
 
 export const analyzeParams = (
   channels: Params,