@synnaxlabs/client 0.49.3 → 0.52.3

package/src/{workspace/table → table}/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.
@@ -12,8 +12,6 @@ import { array, type record } from "@synnaxlabs/x";
 import { z } from "zod";
 
 import { ontology } from "@/ontology";
-import { checkForMultipleOrNoResults } from "@/util/retrieve";
-import { type Key as WorkspaceKey, keyZ as workspaceKeyZ } from "@/workspace/payload";
 import {
   type Key,
   keyZ,
@@ -22,7 +20,9 @@ import {
   type Params,
   remoteZ,
   type Table,
-} from "@/workspace/table/payload";
+} from "@/table/payload";
+import { checkForMultipleOrNoResults } from "@/util/retrieve";
+import { workspace } from "@/workspace";
 
 const renameReqZ = z.object({ key: keyZ, name: z.string() });
 
@@ -41,7 +41,7 @@ export type RetrieveMultipleParams = z.input<typeof retrieveReqZ>;
 
 const retrieveResZ = z.object({ tables: array.nullableZ(remoteZ) });
 
-const createReqZ = z.object({ workspace: workspaceKeyZ, tables: newZ.array() });
+const createReqZ = z.object({ workspace: workspace.keyZ, tables: newZ.array() });
 const createResZ = z.object({ tables: remoteZ.array() });
 
 const emptyResZ = z.object({});
@@ -53,13 +53,16 @@ export class Client {
     this.client = client;
   }
 
-  async create(workspace: WorkspaceKey, table: New): Promise<Table>;
-  async create(workspace: WorkspaceKey, tables: New[]): Promise<Table[]>;
-  async create(workspace: WorkspaceKey, tables: New | New[]): Promise<Table | Table[]> {
+  async create(workspace: workspace.Key, table: New): Promise<Table>;
+  async create(workspace: workspace.Key, tables: New[]): Promise<Table[]>;
+  async create(
+    workspace: workspace.Key,
+    tables: New | New[],
+  ): Promise<Table | Table[]> {
     const isMany = Array.isArray(tables);
     const res = await sendRequired(
       this.client,
-      "/workspace/table/create",
+      "/table/create",
       { workspace, tables: array.toArray(tables) },
       createReqZ,
       createResZ,
@@ -70,7 +73,7 @@ export class Client {
   async rename(key: Key, name: string): Promise<void> {
     await sendRequired(
       this.client,
-      "/workspace/table/rename",
+      "/table/rename",
       { key, name },
       renameReqZ,
       emptyResZ,
@@ -80,7 +83,7 @@ export class Client {
   async setData(key: Key, data: record.Unknown): Promise<void> {
     await sendRequired(
       this.client,
-      "/workspace/table/set-data",
+      "/table/set-data",
       { key, data: JSON.stringify(data) },
       setDataReqZ,
       emptyResZ,
@@ -95,7 +98,7 @@ export class Client {
     const isSingle = singleRetrieveArgsZ.safeParse(args).success;
     const res = await sendRequired(
       this.client,
-      "/workspace/table/retrieve",
+      "/table/retrieve",
       args,
       retrieveArgsZ,
       retrieveResZ,
@@ -107,7 +110,7 @@ export class Client {
   async delete(keys: Params): Promise<void> {
     await sendRequired(
       this.client,
-      "/workspace/table/delete",
+      "/table/delete",
       { keys: array.toArray(keys) },
       deleteReqZ,
       emptyResZ,

package/src/table/external.ts

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

package/src/table/index.ts

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

package/src/{workspace/table → table}/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/{workspace/table → table}/table.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.
@@ -19,7 +19,7 @@ describe("Table", () => {
   describe("create", () => {
     test("create one", async () => {
       const ws = await client.workspaces.create({ name: "Table", layout: { one: 1 } });
-      const table = await client.workspaces.tables.create(ws.key, {
+      const table = await client.tables.create(ws.key, {
         name: "Table",
         data: { one: 1 },
       });
@@ -31,38 +31,38 @@ describe("Table", () => {
   describe("rename", () => {
     test("rename one", async () => {
       const ws = await client.workspaces.create({ name: "Table", layout: { one: 1 } });
-      const table = await client.workspaces.tables.create(ws.key, {
+      const table = await client.tables.create(ws.key, {
         name: "Table",
         data: { one: 1 },
       });
-      await client.workspaces.tables.rename(table.key, "Table2");
-      const res = await client.workspaces.tables.retrieve({ key: table.key });
+      await client.tables.rename(table.key, "Table2");
+      const res = await client.tables.retrieve({ key: table.key });
       expect(res.name).toEqual("Table2");
     });
   });
   describe("setData", () => {
     test("set data", async () => {
       const ws = await client.workspaces.create({ name: "Table", layout: { one: 1 } });
-      const table = await client.workspaces.tables.create(ws.key, {
+      const table = await client.tables.create(ws.key, {
         name: "Table",
         data: { one: 1 },
       });
-      await client.workspaces.tables.setData(table.key, { two: 2 });
-      const res = await client.workspaces.tables.retrieve({ key: table.key });
+      await client.tables.setData(table.key, { two: 2 });
+      const res = await client.tables.retrieve({ key: table.key });
       expect(res.data.two).toEqual(2);
     });
   });
   describe("delete", () => {
     test("delete one", async () => {
       const ws = await client.workspaces.create({ name: "Table", layout: { one: 1 } });
-      const table = await client.workspaces.tables.create(ws.key, {
+      const table = await client.tables.create(ws.key, {
         name: "Table",
         data: { one: 1 },
       });
-      await client.workspaces.tables.delete(table.key);
-      await expect(
-        client.workspaces.tables.retrieve({ key: table.key }),
-      ).rejects.toThrow(NotFoundError);
+      await client.tables.delete(table.key);
+      await expect(client.tables.retrieve({ key: table.key })).rejects.toThrow(
+        NotFoundError,
+      );
     });
   });
 });

package/src/task/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/task/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.
@@ -66,11 +66,15 @@ export interface TaskExecuteCommandSyncParams extends TaskExecuteCommandParams {
   timeout?: CrudeTimeSpan;
 }
 
-export interface ExecuteCommandsSyncParams<StatusData extends z.ZodType>
-  extends Omit<ExecuteCommandsSyncInternalParams<StatusData>, "frameClient" | "name"> {}
+export interface ExecuteCommandsSyncParams<StatusData extends z.ZodType> extends Omit<
+  ExecuteCommandsSyncInternalParams<StatusData>,
+  "frameClient" | "name"
+> {}
 
-export interface ExecuteCommandSyncParams<StatusData extends z.ZodType>
-  extends Omit<ExecuteCommandSyncInternalParams<StatusData>, "frameClient" | "name"> {}
+export interface ExecuteCommandSyncParams<StatusData extends z.ZodType> extends Omit<
+  ExecuteCommandSyncInternalParams<StatusData>,
+  "frameClient" | "name"
+> {}
 
 export class Task<
   Type extends z.ZodLiteral<string> = z.ZodLiteral<string>,
@@ -558,7 +562,8 @@ const executeCommands = async ({
 };
 
 interface ExecuteCommandSyncInternalParams<StatusData extends z.ZodType = z.ZodType>
-  extends Omit<ExecuteCommandsSyncInternalParams<StatusData>, "commands">,
+  extends
+    Omit<ExecuteCommandsSyncInternalParams<StatusData>, "commands">,
     TaskExecuteCommandSyncParams {
   task: Key;
 }

package/src/task/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/task/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/task/payload.spec.ts

@@ -0,0 +1,113 @@
+// 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.
+
+import { describe, expect, it } from "vitest";
+
+import { newKey, rackKey } from "@/task/payload";
+
+describe("newKey", () => {
+  describe("basic key generation", () => {
+    // Verifies that newKey correctly combines rack and task keys via bit shifting.
+    // The rack key occupies the upper 32 bits, task key the lower 32.
+    const cases = [
+      { rackKey: 1, taskKey: 1, expected: ((1n << 32n) + 1n).toString() },
+      { rackKey: 1, taskKey: 0, expected: (1n << 32n).toString() },
+      { rackKey: 0, taskKey: 1, expected: "1" },
+      { rackKey: 0, taskKey: 0, expected: "0" },
+      { rackKey: 255, taskKey: 65535, expected: ((255n << 32n) + 65535n).toString() },
+    ];
+    cases.forEach(({ rackKey: r, taskKey: t, expected }) => {
+      it(`should combine rackKey=${r} and taskKey=${t}`, () => {
+        expect(newKey(r, t)).toBe(expected);
+      });
+    });
+  });
+
+  describe("default taskKey", () => {
+    // Verifies that omitting taskKey defaults to 0, producing rackKey << 32.
+    const rackKeys = [0, 1, 42, 1000];
+    rackKeys.forEach((r) => {
+      it(`should default taskKey to 0 for rackKey=${r}`, () => {
+        expect(newKey(r)).toBe(newKey(r, 0));
+      });
+    });
+  });
+
+  describe("roundtrip with rackKey", () => {
+    // Verifies that rackKey correctly extracts the rack portion from a combined key.
+    // This ensures newKey and rackKey are inverse operations for the rack component.
+    const cases = [
+      { rack: 1, task: 1 },
+      { rack: 1, task: 0 },
+      { rack: 0, task: 1 },
+      { rack: 100, task: 50000 },
+      { rack: 2147483647, task: 2147483647 }, // max 32-bit signed integers
+    ];
+    cases.forEach(({ rack, task }) => {
+      it(`should extract rack=${rack} from key generated with task=${task}`, () => {
+        const key = newKey(rack, task);
+        expect(rackKey(key)).toBe(rack);
+      });
+    });
+  });
+
+  describe("edge cases", () => {
+    // Verifies behavior at boundary values to ensure no overflow or precision issues.
+    it("should handle max 32-bit unsigned rack key", () => {
+      const maxUint32 = 0xffffffff;
+      const key = newKey(maxUint32, 0);
+      expect(rackKey(key)).toBe(maxUint32);
+    });
+
+    it("should handle max 32-bit unsigned task key", () => {
+      const maxUint32 = 0xffffffff;
+      const key = newKey(1, maxUint32);
+      expect(key).toBe(((1n << 32n) + BigInt(maxUint32)).toString());
+    });
+
+    it("should handle both max 32-bit values", () => {
+      const maxUint32 = 0xffffffff;
+      const key = newKey(maxUint32, maxUint32);
+      const expected = ((BigInt(maxUint32) << 32n) + BigInt(maxUint32)).toString();
+      expect(key).toBe(expected);
+      expect(rackKey(key)).toBe(maxUint32);
+    });
+  });
+});
+
+describe("rackKey", () => {
+  // Verifies rackKey extracts upper 32 bits from various key formats.
+  // Keys can be string, bigint, or number per keyZ schema.
+  describe("key format handling", () => {
+    const rack = 42;
+    const task = 100;
+    const expectedKey = newKey(rack, task);
+
+    it("should extract rack from string key", () => {
+      expect(rackKey(expectedKey)).toBe(rack);
+    });
+
+    it("should extract rack from numeric string", () => {
+      const numericKey = ((42n << 32n) + 100n).toString();
+      expect(rackKey(numericKey)).toBe(42);
+    });
+  });
+
+  describe("zero handling", () => {
+    // Verifies correct behavior when rack or task portions are zero.
+    it("should return 0 for key with zero rack", () => {
+      expect(rackKey("100")).toBe(0);
+    });
+
+    it("should return rack when task portion is zero", () => {
+      const key = newKey(5, 0);
+      expect(rackKey(key)).toBe(5);
+    });
+  });
+});

package/src/task/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.
@@ -7,11 +7,10 @@
 // License, use of this software will be governed by the Apache License, Version 2.0,
 // included in the file licenses/APL.txt.
 
-import { binary, type observe, record, status } from "@synnaxlabs/x";
+import { type observe, record, status } from "@synnaxlabs/x";
 import { z } from "zod";
 
 import { type Key as RackKey } from "@/rack/payload";
-import { decodeJSONString } from "@/util/decodeJSONString";
 import { parseWithoutKeyConversion } from "@/util/parseWithoutKeyConversion";
 
 export const keyZ = z.union([
@@ -46,8 +45,9 @@ const newStatusDetailsZ = <DataSchema extends z.ZodType>(data: DataSchema) =>
 export const newStatusZ = <DataSchema extends z.ZodType>(data: DataSchema) =>
   status.statusZ(newStatusDetailsZ(data)).partial({ key: true, name: true });
 
-export interface NewStatus<DataSchema extends z.ZodType = z.ZodUnknown>
-  extends z.infer<ReturnType<typeof newStatusZ<DataSchema>>> {}
+export interface NewStatus<DataSchema extends z.ZodType = z.ZodUnknown> extends z.infer<
+  ReturnType<typeof newStatusZ<DataSchema>>
+> {}
 
 export const taskZ = <
   Type extends z.ZodLiteral<string> = z.ZodLiteral<string>,
@@ -56,7 +56,7 @@ export const taskZ = <
 >(
   schemas: Schemas<Type, Config, StatusData> = {
     typeSchema: z.string() as unknown as Type,
-    configSchema: z.unknown() as unknown as Config,
+    configSchema: record.nullishToEmpty() as unknown as Config,
     statusDataSchema: z.unknown() as unknown as StatusData,
   },
 ) =>
@@ -65,7 +65,7 @@ export const taskZ = <
     name: z.string(),
     type: schemas.typeSchema,
     internal: z.boolean().optional(),
-    config: z.string().transform(decodeJSONString).or(schemas.configSchema),
+    config: schemas.configSchema,
     status: statusZ(schemas.statusDataSchema).optional().nullable(),
     snapshot: z.boolean().optional(),
   });
@@ -105,7 +105,7 @@ export const newZ = <
     .omit({ key: true, status: true })
     .extend({
       key: keyZ.transform((k) => k.toString()).optional(),
-      config: z.unknown().transform((c) => binary.JSON_CODEC.encodeString(c)),
+      config: schemas?.configSchema ?? record.nullishToEmpty(),
       status: newStatusZ(schemas?.statusDataSchema ?? z.unknown())
         .optional()
         .nullable(),
@@ -138,9 +138,13 @@ export interface Command extends Omit<z.infer<typeof commandZ>, "args"> {
   args?: record.Unknown;
 }
 
-export interface StateObservable<StatusData extends z.ZodType>
-  extends observe.ObservableAsyncCloseable<Status<StatusData>> {}
+export interface StateObservable<
+  StatusData extends z.ZodType,
+> extends observe.ObservableAsyncCloseable<Status<StatusData>> {}
 
 export interface CommandObservable extends observe.ObservableAsyncCloseable<Command> {}
 
 export const rackKey = (key: Key): RackKey => Number(BigInt(key) >> 32n);
+
+export const newKey = (rackKey: RackKey, taskKey: number = 0): Key =>
+  ((BigInt(rackKey) << 32n) + BigInt(taskKey)).toString();

package/src/task/task.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/testutil/access.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/testutil/channels.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/testutil/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/testutil/telem.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/transport.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/user/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/user/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/user/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/user/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/user/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/user/user.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/util/decodeJSONString.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/util/parseWithoutKeyConversion.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/util/retrieve.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/util/retrieve.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/util/telem.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/view/client.ts

@@ -0,0 +1,96 @@
+// 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.
+
+import { sendRequired, type UnaryClient } from "@synnaxlabs/freighter";
+import { array } from "@synnaxlabs/x";
+import { z } from "zod";
+
+import { type ontology } from "@/ontology";
+import { checkForMultipleOrNoResults } from "@/util/retrieve";
+import { type Key, keyZ, type New, newZ, type View, viewZ } from "@/view/payload";
+
+export const SET_CHANNEL_NAME = "sy_view_set";
+export const DELETE_CHANNEL_NAME = "sy_view_delete";
+
+const createReqZ = z.object({ views: newZ.array() });
+const createResZ = z.object({ views: viewZ.array() });
+const deleteReqZ = z.object({ keys: keyZ.array() });
+const emptyResZ = z.object({});
+
+const retrieveRequestZ = z.object({
+  keys: keyZ.array().optional(),
+  types: z.string().array().optional(),
+  searchTerm: z.string().optional(),
+  offset: z.number().optional(),
+  limit: z.number().optional(),
+});
+
+const singleRetrieveArgsZ = z
+  .object({ key: keyZ })
+  .transform(({ key }) => ({ keys: [key] }));
+
+const retrieveArgsZ = z.union([singleRetrieveArgsZ, retrieveRequestZ]);
+
+export interface RetrieveSingleParams extends z.input<typeof singleRetrieveArgsZ> {}
+export interface RetrieveMultipleParams extends z.input<typeof retrieveRequestZ> {}
+
+const retrieveResponseZ = z.object({ views: array.nullableZ(viewZ) });
+
+export class Client {
+  private readonly client: UnaryClient;
+
+  constructor(client: UnaryClient) {
+    this.client = client;
+  }
+
+  async retrieve(args: RetrieveSingleParams): Promise<View>;
+  async retrieve(args: RetrieveMultipleParams): Promise<View[]>;
+  async retrieve(
+    args: RetrieveSingleParams | RetrieveMultipleParams,
+  ): Promise<View | View[]> {
+    const isSingle = "key" in args;
+    const res = await sendRequired(
+      this.client,
+      "/view/retrieve",
+      args,
+      retrieveArgsZ,
+      retrieveResponseZ,
+    );
+    checkForMultipleOrNoResults("View", args, res.views, isSingle);
+    return isSingle ? res.views[0] : res.views;
+  }
+
+  async create(view: New): Promise<View>;
+  async create(views: New[]): Promise<View[]>;
+  async create(views: New | New[]): Promise<View | View[]> {
+    const isMany = Array.isArray(views);
+    const res = await sendRequired<typeof createReqZ, typeof createResZ>(
+      this.client,
+      "/view/create",
+      { views: array.toArray(views) },
+      createReqZ,
+      createResZ,
+    );
+    return isMany ? res.views : res.views[0];
+  }
+
+  async delete(keys: Key | Key[]): Promise<void> {
+    await sendRequired<typeof deleteReqZ, typeof emptyResZ>(
+      this.client,
+      "/view/delete",
+      { keys: array.toArray(keys) },
+      deleteReqZ,
+      emptyResZ,
+    );
+  }
+}
+
+export const ontologyID = (key: Key): ontology.ID => ({ type: "view", key });
+
+export const TYPE_ONTOLOGY_ID = ontologyID("");

package/src/view/external.ts

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