@synnaxlabs/client 0.56.1 → 0.57.0

package/dist/src/user/types.gen.d.ts

@@ -3,8 +3,8 @@ import { ontology } from '../ontology';
 export declare const keyZ: z.ZodUUID;
 export type Key = z.infer<typeof keyZ>;
 /**
- * User is an account entity representing a person accessing the Synnax system.
- * Users can have roles assigned for permission management.
+ * User is an account entity representing a person accessing the Synnax system. Users
+ * can have roles assigned for permission management.
  */
 export declare const userZ: z.ZodObject<{
     key: z.ZodUUID;
@@ -26,10 +26,10 @@ export interface New extends z.input<typeof newZ> {
 }
 export declare const ontologyID: ontology.CreateID<string>;
 export declare const TYPE_ONTOLOGY_ID: {
-    type: "arc" | "builtin" | "channel" | "device" | "framer" | "group" | "label" | "lineplot" | "log" | "node" | "policy" | "rack" | "range" | "range-alias" | "role" | "schematic" | "schematic_symbol" | "status" | "table" | "task" | "user" | "view" | "workspace";
+    type: "arc" | "builtin" | "channel" | "device" | "framer" | "group" | "label" | "lineplot" | "log" | "node" | "panel" | "policy" | "project" | "rack" | "range" | "range-alias" | "role" | "schematic" | "schematic_symbol" | "status" | "table" | "task" | "user" | "view";
     key: string;
 } | {
-    type: "arc" | "builtin" | "channel" | "device" | "framer" | "group" | "label" | "lineplot" | "log" | "node" | "policy" | "rack" | "range" | "range-alias" | "role" | "schematic" | "schematic_symbol" | "status" | "table" | "task" | "user" | "view" | "workspace";
+    type: "arc" | "builtin" | "channel" | "device" | "framer" | "group" | "label" | "lineplot" | "log" | "node" | "panel" | "policy" | "project" | "rack" | "range" | "range-alias" | "role" | "schematic" | "schematic_symbol" | "status" | "table" | "task" | "user" | "view";
     key: string;
 };
 //# sourceMappingURL=types.gen.d.ts.map

package/dist/src/util/retrieve.d.ts

@@ -1,13 +1,13 @@
 import { primitive } from '@synnaxlabs/x';
 export type SingleParamAnalysisResult<T extends primitive.Value, K extends PartialTypeNameRecord<T>> = T extends unknown ? {
     single: true;
-    variant: K[keyof K];
+    variant: K[TypeName<T>];
     normalized: T[];
     actual: T;
 } : never;
 export type MultiParamAnalysisResult<T extends primitive.Value, K extends PartialTypeNameRecord<T>> = T extends unknown ? {
     single: false;
-    variant: K[keyof K];
+    variant: K[TypeName<T>];
     normalized: T[];
     actual: T[];
 } : never;

package/dist/src/util/retrieve.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"retrieve.d.ts","sourceRoot":"","sources":["../../../src/util/retrieve.ts"],"names":[],"mappings":"AASA,OAAO,EAAS,KAAK,SAAS,EAAE,MAAM,eAAe,CAAC;AAItD,MAAM,MAAM,yBAAyB,CACnC,CAAC,SAAS,SAAS,CAAC,KAAK,EACzB,CAAC,SAAS,qBAAqB,CAAC,CAAC,CAAC,IAChC,CAAC,SAAS,OAAO,GACjB;IAAE,MAAM,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;IAAC,UAAU,EAAE,CAAC,EAAE,CAAC;IAAC,MAAM,EAAE,CAAC,CAAA;CAAE,GACjE,KAAK,CAAC;AAEV,MAAM,MAAM,wBAAwB,CAClC,CAAC,SAAS,SAAS,CAAC,KAAK,EACzB,CAAC,SAAS,qBAAqB,CAAC,CAAC,CAAC,IAChC,CAAC,SAAS,OAAO,GACjB;IAAE,MAAM,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;IAAC,UAAU,EAAE,CAAC,EAAE,CAAC;IAAC,MAAM,EAAE,CAAC,EAAE,CAAA;CAAE,GACpE,KAAK,CAAC;AAEV,KAAK,QAAQ,CAAC,CAAC,IAAI,CAAC,SAAS,MAAM,GAC/B,QAAQ,GACR,CAAC,SAAS,MAAM,GACd,QAAQ,GACR,CAAC,SAAS,OAAO,GACf,SAAS,GACT,CAAC,SAAS,SAAS,GACjB,WAAW,GACX,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,GAC/B,UAAU,GACV,QAAQ,CAAC;AAErB,MAAM,MAAM,qBAAqB,CAAC,CAAC,SAAS,SAAS,CAAC,KAAK,IAAI,OAAO,CACpE,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAC5B,CAAC;AAEF,MAAM,MAAM,mBAAmB,CAC7B,CAAC,SAAS,SAAS,CAAC,KAAK,EACzB,CAAC,SAAS,qBAAqB,CAAC,CAAC,CAAC,GAAG,qBAAqB,CAAC,CAAC,CAAC,IAC3D,yBAAyB,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,wBAAwB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAErE,MAAM,WAAW,oBAAoB;IACnC,qBAAqB,CAAC,EAAE,OAAO,CAAC;CACjC;AAED,eAAO,MAAM,aAAa,GACxB,CAAC,SAAS,SAAS,CAAC,KAAK,GAAG,SAAS,CAAC,KAAK,EAC3C,CAAC,SAAS,qBAAqB,CAAC,CAAC,CAAC,GAAG,qBAAqB,CAAC,CAAC,CAAC,EAE7D,MAAM,CAAC,SAAS,OAAO,GAAG,CAAC,GAAG,CAAC,EAAE,GAAG,KAAK,EACzC,YAAY,CAAC,EACb,4BAAkC,oBAAyB,KAC1D,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAkB1B,CAAC;AAEF,eAAO,MAAM,2BAA2B,GAAI,CAAC,EAAE,CAAC,EAC9C,MAAM,MAAM,EACZ,QAAQ,CAAC,GAAG,CAAC,EAAE,EACf,SAAS,CAAC,EAAE,EACZ,UAAU,OAAO,KAChB,IAQF,CAAC"}
+{"version":3,"file":"retrieve.d.ts","sourceRoot":"","sources":["../../../src/util/retrieve.ts"],"names":[],"mappings":"AASA,OAAO,EAAS,KAAK,SAAS,EAAE,MAAM,eAAe,CAAC;AAItD,MAAM,MAAM,yBAAyB,CACnC,CAAC,SAAS,SAAS,CAAC,KAAK,EACzB,CAAC,SAAS,qBAAqB,CAAC,CAAC,CAAC,IAChC,CAAC,SAAS,OAAO,GACjB;IAAE,MAAM,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IAAC,UAAU,EAAE,CAAC,EAAE,CAAC;IAAC,MAAM,EAAE,CAAC,CAAA;CAAE,GACrE,KAAK,CAAC;AAEV,MAAM,MAAM,wBAAwB,CAClC,CAAC,SAAS,SAAS,CAAC,KAAK,EACzB,CAAC,SAAS,qBAAqB,CAAC,CAAC,CAAC,IAChC,CAAC,SAAS,OAAO,GACjB;IAAE,MAAM,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IAAC,UAAU,EAAE,CAAC,EAAE,CAAC;IAAC,MAAM,EAAE,CAAC,EAAE,CAAA;CAAE,GACxE,KAAK,CAAC;AAEV,KAAK,QAAQ,CAAC,CAAC,IAAI,CAAC,SAAS,MAAM,GAC/B,QAAQ,GACR,CAAC,SAAS,MAAM,GACd,QAAQ,GACR,CAAC,SAAS,OAAO,GACf,SAAS,GACT,CAAC,SAAS,SAAS,GACjB,WAAW,GACX,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,GAC/B,UAAU,GACV,QAAQ,CAAC;AAErB,MAAM,MAAM,qBAAqB,CAAC,CAAC,SAAS,SAAS,CAAC,KAAK,IAAI,OAAO,CACpE,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAC5B,CAAC;AAEF,MAAM,MAAM,mBAAmB,CAC7B,CAAC,SAAS,SAAS,CAAC,KAAK,EACzB,CAAC,SAAS,qBAAqB,CAAC,CAAC,CAAC,GAAG,qBAAqB,CAAC,CAAC,CAAC,IAC3D,yBAAyB,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,wBAAwB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAErE,MAAM,WAAW,oBAAoB;IACnC,qBAAqB,CAAC,EAAE,OAAO,CAAC;CACjC;AAED,eAAO,MAAM,aAAa,GACxB,CAAC,SAAS,SAAS,CAAC,KAAK,GAAG,SAAS,CAAC,KAAK,EAC3C,CAAC,SAAS,qBAAqB,CAAC,CAAC,CAAC,GAAG,qBAAqB,CAAC,CAAC,CAAC,EAE7D,MAAM,CAAC,SAAS,OAAO,GAAG,CAAC,GAAG,CAAC,EAAE,GAAG,KAAK,EACzC,YAAY,CAAC,EACb,4BAAkC,oBAAyB,KAC1D,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAkB1B,CAAC;AAEF,eAAO,MAAM,2BAA2B,GAAI,CAAC,EAAE,CAAC,EAC9C,MAAM,MAAM,EACZ,QAAQ,CAAC,GAAG,CAAC,EAAE,EACf,SAAS,CAAC,EAAE,EACZ,UAAU,OAAO,KAChB,IAQF,CAAC"}

package/dist/src/util/telem.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"telem.d.ts","sourceRoot":"","sources":["../../../src/util/telem.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,KAAK,QAAQ,EAAE,KAAK,UAAU,EAAE,MAAM,eAAe,CAAC;AAE/D,eAAO,MAAM,YAAY,GAAI,QAAQ,MAAM,EAAE,UAAU,QAAQ,KAAG,UAKjE,CAAC"}
+{"version":3,"file":"telem.d.ts","sourceRoot":"","sources":["../../../src/util/telem.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,KAAK,QAAQ,EAAE,KAAK,UAAU,EAAE,MAAM,eAAe,CAAC;AAE/D,eAAO,MAAM,YAAY,GAAI,QAAQ,MAAM,EAAE,UAAU,QAAQ,KAAG,UAIjE,CAAC"}

package/dist/src/view/client.d.ts

@@ -1,5 +1,8 @@
 import { UnaryClient } from '@synnaxlabs/freighter';
+import { destructor } from '@synnaxlabs/x';
 import { z } from 'zod';
+import { ontology } from '../ontology';
+import { query } from '../query';
 import { Key, New, View } from './types.gen';
 export declare const SET_CHANNEL_NAME = "sy_view_set";
 export declare const DELETE_CHANNEL_NAME = "sy_view_delete";
@@ -10,25 +13,38 @@ declare const retrieveRequestZ: z.ZodObject<{
     offset: z.ZodOptional<z.ZodNumber>;
     limit: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
-declare const singleRetrieveArgsZ: z.ZodPipe<z.ZodObject<{
-    key: z.ZodUUID;
-}, z.core.$strip>, z.ZodTransform<{
+declare const retrieveMultiParamsZ: z.ZodUnion<[z.ZodObject<{
+    keys: z.ZodOptional<z.ZodArray<z.ZodUUID>>;
+    types: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    searchTerm: z.ZodOptional<z.ZodString>;
+    offset: z.ZodOptional<z.ZodNumber>;
+    limit: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>, z.ZodPipe<z.ZodArray<z.ZodUUID>, z.ZodTransform<{
     keys: string[];
-}, {
-    key: string;
-}>>;
-export interface RetrieveSingleParams extends z.input<typeof singleRetrieveArgsZ> {
-}
+}, string[]>>]>;
+export type RetrieveSingleParams = {
+    key: Key;
+};
 export interface RetrieveMultipleParams extends z.input<typeof retrieveRequestZ> {
 }
-export declare class Client {
-    private readonly client;
-    constructor(client: UnaryClient);
-    retrieve(args: RetrieveSingleParams): Promise<View>;
-    retrieve(args: RetrieveMultipleParams): Promise<View[]>;
+export interface ClientConfig {
+    unary: UnaryClient;
+    cache: query.Cache;
+    ontology: ontology.Client;
+}
+export declare class Client extends query.Retriever<typeof retrieveMultiParamsZ, Key, View> {
+    private readonly cfg;
+    private readonly store;
+    constructor(cfg: ClientConfig);
     create(view: New): Promise<View>;
     create(views: New[]): Promise<View[]>;
-    delete(keys: Key | Key[]): Promise<void>;
+    rename(key: Key, name: string, opts?: query.WriteOptions): Promise<void>;
+    delete(keys: Key | Key[], opts?: query.WriteOptions): Promise<void>;
+    /** Subscribes to every view set delivered to the cache. */
+    onSet(handler: (view: View) => void): destructor.Destructor;
+    /** Subscribes to every view delete delivered to the cache. */
+    onDelete(handler: (key: Key) => void): destructor.Destructor;
+    private execRetrieve;
 }
 export {};
 //# sourceMappingURL=client.d.ts.map

package/dist/src/view/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/view/client.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEzD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,KAAK,GAAG,EAAQ,KAAK,GAAG,EAAQ,KAAK,IAAI,EAAS,MAAM,kBAAkB,CAAC;AAEpF,eAAO,MAAM,gBAAgB,gBAAgB,CAAC;AAC9C,eAAO,MAAM,mBAAmB,mBAAmB,CAAC;AAOpD,QAAA,MAAM,gBAAgB;;;;;;iBAMpB,CAAC;AAEH,QAAA,MAAM,mBAAmB;;;;;;GAEmB,CAAC;AAI7C,MAAM,WAAW,oBAAqB,SAAQ,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC;CAAG;AACpF,MAAM,WAAW,sBAAuB,SAAQ,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC;CAAG;AAInF,qBAAa,MAAM;IACjB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAc;gBAEzB,MAAM,EAAE,WAAW;IAIzB,QAAQ,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC;IACnD,QAAQ,CAAC,IAAI,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IAevD,MAAM,CAAC,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IAChC,MAAM,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IAYrC,MAAM,CAAC,IAAI,EAAE,GAAG,GAAG,GAAG,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CAQ/C"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/view/client.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAS,KAAK,UAAU,EAAa,MAAM,eAAe,CAAC;AAClE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EACL,KAAK,GAAG,EAER,KAAK,GAAG,EAER,KAAK,IAAI,EAEV,MAAM,kBAAkB,CAAC;AAE1B,eAAO,MAAM,gBAAgB,gBAAgB,CAAC;AAC9C,eAAO,MAAM,mBAAmB,mBAAmB,CAAC;AAOpD,QAAA,MAAM,gBAAgB;;;;;;iBAMpB,CAAC;AACH,QAAA,MAAM,oBAAoB;;;;;;;;eAA4C,CAAC;AAEvE,MAAM,MAAM,oBAAoB,GAAG;IAAE,GAAG,EAAE,GAAG,CAAA;CAAE,CAAC;AAChD,MAAM,WAAW,sBAAuB,SAAQ,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC;CAAG;AAoBnF,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,WAAW,CAAC;IACnB,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC;IACnB,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC;CAC3B;AAED,qBAAa,MAAO,SAAQ,KAAK,CAAC,SAAS,CAAC,OAAO,oBAAoB,EAAE,GAAG,EAAE,IAAI,CAAC;IACjF,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;IACnC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAyB;gBAEnC,GAAG,EAAE,YAAY;IAuBvB,MAAM,CAAC,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IAChC,MAAM,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IAarC,MAAM,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,KAAK,CAAC,YAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAgB5E,MAAM,CAAC,IAAI,EAAE,GAAG,GAAG,GAAG,EAAE,EAAE,IAAI,GAAE,KAAK,CAAC,YAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAsB7E,2DAA2D;IAC3D,KAAK,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,GAAG,UAAU,CAAC,UAAU;IAM3D,8DAA8D;IAC9D,QAAQ,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,IAAI,GAAG,UAAU,CAAC,UAAU;YAM9C,YAAY;CAS3B"}

package/dist/src/view/types.gen.d.ts

@@ -1,35 +1,27 @@
-import { record } from '@synnaxlabs/x';
 import { z } from 'zod';
 import { ontology } from '../ontology';
 export declare const keyZ: z.ZodUUID;
 export type Key = z.infer<typeof keyZ>;
 /**
- * View is a persisted view configuration storing visualization settings and
- * query parameters for line plots, tables, schematics, and other view
- * types.
+ * View is a persisted view configuration storing visualization settings and query
+ * parameters for line plots, tables, schematics, and other view types.
  */
 export declare const viewZ: z.ZodObject<{
-    key: z.ZodUUID;
+    key: z.ZodDefault<z.ZodUUID>;
     name: z.ZodString;
     type: z.ZodString;
-    query: z.ZodType<record.Unknown, unknown, z.core.$ZodTypeInternals<record.Unknown, unknown>>;
+    query: z.ZodDefault<z.ZodRecord<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>, z.ZodUnknown>>;
 }, z.core.$strip>;
 export interface View extends z.infer<typeof viewZ> {
 }
-export declare const newZ: z.ZodObject<{
-    key: z.ZodOptional<z.ZodUUID>;
-    name: z.ZodString;
-    type: z.ZodString;
-    query: z.ZodType<record.Unknown, unknown, z.core.$ZodTypeInternals<record.Unknown, unknown>>;
-}, z.core.$strip>;
-export interface New extends z.input<typeof newZ> {
+export interface New extends z.input<typeof viewZ> {
 }
 export declare const ontologyID: ontology.CreateID<string>;
 export declare const TYPE_ONTOLOGY_ID: {
-    type: "arc" | "builtin" | "channel" | "device" | "framer" | "group" | "label" | "lineplot" | "log" | "node" | "policy" | "rack" | "range" | "range-alias" | "role" | "schematic" | "schematic_symbol" | "status" | "table" | "task" | "user" | "view" | "workspace";
+    type: "arc" | "builtin" | "channel" | "device" | "framer" | "group" | "label" | "lineplot" | "log" | "node" | "panel" | "policy" | "project" | "rack" | "range" | "range-alias" | "role" | "schematic" | "schematic_symbol" | "status" | "table" | "task" | "user" | "view";
     key: string;
 } | {
-    type: "arc" | "builtin" | "channel" | "device" | "framer" | "group" | "label" | "lineplot" | "log" | "node" | "policy" | "rack" | "range" | "range-alias" | "role" | "schematic" | "schematic_symbol" | "status" | "table" | "task" | "user" | "view" | "workspace";
+    type: "arc" | "builtin" | "channel" | "device" | "framer" | "group" | "label" | "lineplot" | "log" | "node" | "panel" | "policy" | "project" | "rack" | "range" | "range-alias" | "role" | "schematic" | "schematic_symbol" | "status" | "table" | "task" | "user" | "view";
     key: string;
 };
 //# sourceMappingURL=types.gen.d.ts.map

package/dist/src/view/types.gen.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.gen.d.ts","sourceRoot":"","sources":["../../../src/view/types.gen.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AACvC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC,eAAO,MAAM,IAAI,WAAW,CAAC;AAC7B,MAAM,MAAM,GAAG,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC;AAEvC;;;;GAIG;AACH,eAAO,MAAM,KAAK;;;;;iBAYhB,CAAC;AACH,MAAM,WAAW,IAAK,SAAQ,CAAC,CAAC,KAAK,CAAC,OAAO,KAAK,CAAC;CAAG;AAEtD,eAAO,MAAM,IAAI;;;;;iBAA+B,CAAC;AACjD,MAAM,WAAW,GAAI,SAAQ,CAAC,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC;CAAG;AAEpD,eAAO,MAAM,UAAU,2BAAwC,CAAC;AAChE,eAAO,MAAM,gBAAgB;;;;;;CAAiB,CAAC"}
+{"version":3,"file":"types.gen.d.ts","sourceRoot":"","sources":["../../../src/view/types.gen.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC,eAAO,MAAM,IAAI,WAAW,CAAC;AAC7B,MAAM,MAAM,GAAG,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC;AAEvC;;;GAGG;AACH,eAAO,MAAM,KAAK;;;;;iBAYhB,CAAC;AACH,MAAM,WAAW,IAAK,SAAQ,CAAC,CAAC,KAAK,CAAC,OAAO,KAAK,CAAC;CAAG;AACtD,MAAM,WAAW,GAAI,SAAQ,CAAC,CAAC,KAAK,CAAC,OAAO,KAAK,CAAC;CAAG;AAErD,eAAO,MAAM,UAAU,2BAAwC,CAAC;AAChE,eAAO,MAAM,gBAAgB;;;;;;CAAiB,CAAC"}

package/dist/testutil.js

@@ -0,0 +1,189 @@
+import { B as e, G as t, K as n, V as r, W as i, Z as a, d as o, t as s, z as c } from "./client-B08VDLSA.js";
+import { DataType as l, TimeSpan as u, TimeStamp as d, array as f, errors as p, id as m } from "@synnaxlabs/x";
+import { afterAll as h } from "vitest";
+import { connect as g, createServer as _ } from "node:net";
+//#region src/testutil/client.ts
+var v = {
+	host: "localhost",
+	port: 9090,
+	username: "synnax",
+	password: "seldon",
+	retry: {
+		maxRetries: 4,
+		baseInterval: u.seconds(1),
+		scale: 1.5
+	}
+}, y = [];
+h(async () => {
+	let e = (await Promise.allSettled(y.map((e) => e.close()))).filter((e) => e.status === "rejected");
+	if (e.length > 0) throw AggregateError(e.map((e) => e.reason), "failed to close test clients");
+});
+var b = (e) => {
+	let t = new s({
+		...v,
+		...e
+	});
+	return y.push(t), t;
+}, x = (e) => n.matches(e) || e instanceof Error && e.cause != null && x(e.cause), S = async (e, t) => {
+	let n = b({
+		username: e,
+		password: "test",
+		onInternalError: (e) => {
+			x(e) || console.error(e);
+		}
+	});
+	try {
+		await n.access.policies.retrieveForSubject(c(t));
+	} catch (e) {
+		if (!x(e)) throw p.fromUnknown(e);
+	}
+	return n;
+}, C = async (e) => {
+	let t = m.create();
+	return {
+		username: t,
+		key: (await e.users.create({
+			username: t,
+			password: "test",
+			firstName: "test",
+			lastName: "test"
+		})).key
+	};
+}, w = async (t, n) => {
+	let i = await C(t), a = await Promise.all(f.toArray(n).map(async (e) => await t.access.policies.create(e))), o = await t.access.roles.create({
+		name: "test",
+		description: "test"
+	});
+	return await t.ontology.addChildren(e(o.key), ...a.map(({ key: e }) => r(e))), await t.access.roles.assign({
+		user: i.key,
+		role: o.key
+	}), await S(i.username, i.key);
+}, T = [
+	"Owner",
+	"Engineer",
+	"Host",
+	"Operator",
+	"Viewer"
+], E = async (e, t) => {
+	let n = (await e.access.roles.retrieve({})).find((e) => e.name === t);
+	if (n == null) throw new a(`no built-in role named ${t}`);
+	let r = await C(e);
+	return await e.access.roles.assign({
+		user: r.key,
+		role: n.key
+	}), await S(r.username, r.key);
+}, D = class {
+	client;
+	byRole = /* @__PURE__ */ new Map();
+	constructor(e) {
+		this.client = e;
+	}
+	async get(e) {
+		let t = this.byRole.get(e);
+		if (t != null) return await t;
+		let n = E(this.client, e);
+		return this.byRole.set(e, n), await n;
+	}
+}, O = async (e) => {
+	let t = await e.channels.create({
+		leaseholder: 1,
+		name: m.create(),
+		dataType: l.TIMESTAMP,
+		isIndex: !0
+	});
+	return [t, await e.channels.create({
+		leaseholder: 1,
+		name: m.create(),
+		dataType: l.FLOAT64,
+		index: t.key
+	})];
+}, k = async (e) => {
+	let t = await e.channels.create({
+		leaseholder: 1,
+		name: m.create(),
+		dataType: l.TIMESTAMP,
+		isIndex: !0
+	});
+	return [t, await e.channels.create({
+		leaseholder: 1,
+		name: m.create(),
+		dataType: l.BOOLEAN,
+		index: t.key
+	})];
+}, A = async (e) => await e.channels.create({
+	name: m.create(),
+	dataType: l.FLOAT64,
+	virtual: !0
+}), j = async (e) => await e.channels.create({
+	name: m.create(),
+	dataType: l.BOOLEAN,
+	virtual: !0
+}), M = async (e, t, n = u.seconds(5)) => t(e.status) ? e.status : await new Promise((r, i) => {
+	let a = setTimeout(() => {
+		o(), i(/* @__PURE__ */ Error("timed out waiting for connection status"));
+	}, n.milliseconds), o = e.onChange((e) => {
+		t(e) && (clearTimeout(a), o(), r(e));
+	});
+}), N = async (e, t) => await M(e, ({ variant: e, details: t }) => e === "success" && t.streamLive, t), P = async (e) => {
+	let t = await e.projects.create({
+		name: `project-${m.create()}`,
+		layout: {}
+	});
+	return o(t.key);
+}, F = {
+	host: "localhost",
+	port: 9090
+}, I = {
+	baseInterval: u.milliseconds(10),
+	maxInterval: u.milliseconds(50),
+	scale: 1.5
+}, L = async (e = {}) => {
+	let { host: t, port: n } = {
+		...F,
+		...e
+	}, r = /* @__PURE__ */ new Set(), i = !1, a = _((e) => {
+		if (i) {
+			e.destroy();
+			return;
+		}
+		let a = g(n, t);
+		r.add(e).add(a);
+		let o = () => {
+			r.delete(e), r.delete(a), e.destroy(), a.destroy();
+		};
+		e.on("error", o), a.on("error", o), e.on("close", o), a.on("close", o), e.pipe(a), a.pipe(e);
+	}), o = async (e) => await new Promise((t, n) => {
+		a.once("error", n), a.listen(e, () => {
+			a.removeListener("error", n), t();
+		});
+	});
+	await o(0);
+	let s = a.address();
+	if (s == null || typeof s == "string") throw Error("proxy failed to bind a port");
+	let c = s.port, l = async () => {
+		i = !0;
+		let e = new Promise((e) => a.close(() => e()));
+		r.forEach((e) => e.destroy()), r.clear(), await e;
+	};
+	return {
+		port: c,
+		sever: l,
+		restore: async () => {
+			i = !1, await o(c);
+		},
+		close: l
+	};
+}, R = (e) => {
+	if (!i(e)) throw Error("expected a live cached answer");
+	return e;
+}, z = (e) => {
+	if (!t.matches(e)) throw Error("expected a deleted answer");
+	return e;
+}, B = (e, t) => Array.from({ length: t }, (t, n) => e + n).map((e) => d.seconds(e)), V = (e) => e.isVariable || e.equals(l.UINT8), H = {
+	resolveDataType: (e) => V(e) ? e : l.FLOAT32,
+	convert: (e, t) => V(e.dataType) ? e : (t == null && e.dataType.usesBigInt && e.length > 0 && (t = BigInt(e.data[0])), e.convert(l.FLOAT32, t))
+};
+//#endregion
+export { T as BUILT_IN_ROLES, I as FAST_RETRY, D as RoleClients, v as TEST_CLIENT_PARAMS, P as createPanelParent, L as createSeverableProxy, b as createTestClient, w as createTestClientWithPolicy, E as createTestClientWithRole, z as expectDeleted, R as expectLive, H as glTransform, i as isLive, k as newIndexedBoolPair, O as newIndexedPair, j as newVirtualBoolChannel, A as newVirtualChannel, B as secondsLinspace, M as waitForStatus, N as waitForStreamLive };
+
+//# sourceMappingURL=testutil.js.map

package/dist/testutil.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"testutil.js","names":[],"sources":["../src/testutil/client.ts","../src/testutil/access.ts","../src/testutil/channels.ts","../src/testutil/connection.ts","../src/testutil/panels.ts","../src/testutil/proxy.ts","../src/testutil/query.ts","../src/testutil/telem.ts"],"sourcesContent":["// Copyright 2026 Synnax Labs, Inc.\n//\n// Use of this software is governed by the Business Source License included in the file\n// licenses/BSL.txt.\n//\n// As of the Change Date specified in that file, in accordance with the Business Source\n// License, use of this software will be governed by the Apache License, Version 2.0,\n// included in the file licenses/APL.txt.\n\nimport { TimeSpan } from \"@synnaxlabs/x\";\nimport { afterAll } from \"vitest\";\n\nimport Synnax, { type SynnaxParams } from \"@/client\";\n\nexport const TEST_CLIENT_PARAMS: SynnaxParams = {\n  host: \"localhost\",\n  port: 9090,\n  username: \"synnax\",\n  password: \"seldon\",\n  retry: {\n    maxRetries: 4,\n    baseInterval: TimeSpan.seconds(1),\n    scale: 1.5,\n  },\n};\n\n// A hook registered mid-test is silently dropped by vitest, so per-client afterAll\n// calls leak clients created inside test bodies. This module-level hook registers\n// during spec collection (import time) and covers every call site.\nconst openClients: Synnax[] = [];\n// Awaited so every close finishes before vitest tears down the worker; a close\n// still in flight at teardown races its logging against the closing RPC channel.\nafterAll(async () => {\n  const results = await Promise.allSettled(openClients.map((client) => client.close()));\n  const failures = results.filter((result) => result.status === \"rejected\");\n  if (failures.length > 0)\n    throw new AggregateError(\n      failures.map((failure) => failure.reason),\n      \"failed to close test clients\",\n    );\n});\n\n/**\n * Creates a client connected to the local test cluster. The client is closed\n * automatically once every test in the current spec file has finished, so callers do\n * not need to close it themselves.\n */\nexport const createTestClient = (params?: Partial<SynnaxParams>): Synnax => {\n  const client = new Synnax({ ...TEST_CLIENT_PARAMS, ...params });\n  openClients.push(client);\n  return client;\n};\n","// Copyright 2026 Synnax Labs, Inc.\n//\n// Use of this software is governed by the Business Source License included in the file\n// licenses/BSL.txt.\n//\n// As of the Change Date specified in that file, in accordance with the Business Source\n// License, use of this software will be governed by the Apache License, Version 2.0,\n// included in the file licenses/APL.txt.\n\nimport { array, errors, id } from \"@synnaxlabs/x\";\n\nimport { policy } from \"@/access/policy\";\nimport { role } from \"@/access/role\";\nimport type Synnax from \"@/client\";\nimport { AccessDeniedError, NotFoundError } from \"@/errors\";\nimport { createTestClient } from \"@/testutil/client\";\nimport { user } from \"@/user\";\n\n/** Reports whether the error, or any error in its cause chain, is an access denial. */\nconst isDenial = (err: unknown): boolean =>\n  AccessDeniedError.matches(err) ||\n  (err instanceof Error && err.cause != null && isDenial(err.cause));\n\n/**\n * Connects as a new user and primes its policy cache. Denials are tolerated: the Core\n * refuses restricted subjects by design, and the change-stream refusal logs after\n * teardown, which vitest counts as an unhandled error.\n */\nconst connectAs = async (username: string, key: user.Key) => {\n  const client = createTestClient({\n    username,\n    password: \"test\",\n    onInternalError: (err) => {\n      if (!isDenial(err)) console.error(err);\n    },\n  });\n  try {\n    await client.access.policies.retrieveForSubject(user.ontologyID(key));\n  } catch (err) {\n    if (!isDenial(err)) throw errors.fromUnknown(err);\n  }\n  return client;\n};\n\nconst createUser = async (client: Synnax) => {\n  const username = id.create();\n  const u = await client.users.create({\n    username,\n    password: \"test\",\n    firstName: \"test\",\n    lastName: \"test\",\n  });\n  return { username, key: u.key };\n};\n\n/**\n * Creates a client authenticated as a new user holding a role that carries the\n * policies. Pass several to grant different actions on different objects, which one\n * policy cannot express.\n */\nexport const createTestClientWithPolicy = async (\n  client: Synnax,\n  pol: policy.New | policy.New[],\n) => {\n  const u = await createUser(client);\n  const policies = await Promise.all(\n    array.toArray(pol).map(async (p) => await client.access.policies.create(p)),\n  );\n  const r = await client.access.roles.create({\n    name: \"test\",\n    description: \"test\",\n  });\n  await client.ontology.addChildren(\n    role.ontologyID(r.key),\n    ...policies.map(({ key }) => policy.ontologyID(key)),\n  );\n  await client.access.roles.assign({ user: u.key, role: r.key });\n  return await connectAs(u.username, u.key);\n};\n\n/** The roles the Core provisions on startup. */\nexport const BUILT_IN_ROLES = [\n  \"Owner\",\n  \"Engineer\",\n  \"Host\",\n  \"Operator\",\n  \"Viewer\",\n] as const;\n\nexport type BuiltInRole = (typeof BUILT_IN_ROLES)[number];\n\n/**\n * Creates a client authenticated as a new user holding one of the Core's built-in\n * roles, for exercising a real role's permission set instead of a synthetic policy.\n * @param name - The built-in role to assign.\n * @throws {NotFoundError} if the Core provisions no role under the name.\n */\nexport const createTestClientWithRole = async (\n  client: Synnax,\n  name: BuiltInRole,\n): Promise<Synnax> => {\n  const roles = await client.access.roles.retrieve({});\n  const r = roles.find((r) => r.name === name);\n  if (r == null) throw new NotFoundError(`no built-in role named ${name}`);\n  const u = await createUser(client);\n  await client.access.roles.assign({ user: u.key, role: r.key });\n  return await connectAs(u.username, u.key);\n};\n\n/**\n * Caches one client per built-in role, so a spec covering many roles pays the user\n * creation cost once each. Construct one per spec file.\n */\nexport class RoleClients {\n  private readonly client: Synnax;\n  private readonly byRole = new Map<BuiltInRole, Promise<Synnax>>();\n\n  constructor(client: Synnax) {\n    this.client = client;\n  }\n\n  /** Returns a client authenticated as a user holding the role. */\n  async get(name: BuiltInRole): Promise<Synnax> {\n    const existing = this.byRole.get(name);\n    if (existing != null) return await existing;\n    const created = createTestClientWithRole(this.client, name);\n    this.byRole.set(name, created);\n    return await created;\n  }\n}\n","// Copyright 2026 Synnax Labs, Inc.\n//\n// Use of this software is governed by the Business Source License included in the file\n// licenses/BSL.txt.\n//\n// As of the Change Date specified in that file, in accordance with the Business Source\n// License, use of this software will be governed by the Apache License, Version 2.0,\n// included in the file licenses/APL.txt.\n\nimport { DataType, id } from \"@synnaxlabs/x\";\n\nimport { type channel } from \"@/channel\";\nimport type Synnax from \"@/client\";\n\nexport const newIndexedPair = async (\n  client: Synnax,\n): Promise<[channel.Channel, channel.Channel]> => {\n  const index = await client.channels.create({\n    leaseholder: 1,\n    name: id.create(),\n    dataType: DataType.TIMESTAMP,\n    isIndex: true,\n  });\n  const data = await client.channels.create({\n    leaseholder: 1,\n    name: id.create(),\n    dataType: DataType.FLOAT64,\n    index: index.key,\n  });\n  return [index, data];\n};\n\nexport const newIndexedBoolPair = async (\n  client: Synnax,\n): Promise<[channel.Channel, channel.Channel]> => {\n  const index = await client.channels.create({\n    leaseholder: 1,\n    name: id.create(),\n    dataType: DataType.TIMESTAMP,\n    isIndex: true,\n  });\n  const data = await client.channels.create({\n    leaseholder: 1,\n    name: id.create(),\n    dataType: DataType.BOOLEAN,\n    index: index.key,\n  });\n  return [index, data];\n};\n\nexport const newVirtualChannel = async (client: Synnax): Promise<channel.Channel> => {\n  const ch = await client.channels.create({\n    name: id.create(),\n    dataType: DataType.FLOAT64,\n    virtual: true,\n  });\n  return ch;\n};\n\nexport const newVirtualBoolChannel = async (\n  client: Synnax,\n): Promise<channel.Channel> => {\n  const ch = await client.channels.create({\n    name: id.create(),\n    dataType: DataType.BOOLEAN,\n    virtual: true,\n  });\n  return ch;\n};\n","// Copyright 2026 Synnax Labs, Inc.\n//\n// Use of this software is governed by the Business Source License included in the file\n// licenses/BSL.txt.\n//\n// As of the Change Date specified in that file, in accordance with the Business Source\n// License, use of this software will be governed by the Apache License, Version 2.0,\n// included in the file licenses/APL.txt.\n\nimport { TimeSpan } from \"@synnaxlabs/x\";\n\nimport { type connection } from \"@/connection\";\n\n/** Resolves once the handle's status satisfies the predicate. */\nexport const waitForStatus = async (\n  handle: connection.Handle,\n  predicate: (status: connection.Status) => boolean,\n  timeout: TimeSpan = TimeSpan.seconds(5),\n): Promise<connection.Status> => {\n  if (predicate(handle.status)) return handle.status;\n  return await new Promise<connection.Status>((resolve, reject) => {\n    const timer = setTimeout(() => {\n      detach();\n      reject(new Error(\"timed out waiting for connection status\"));\n    }, timeout.milliseconds);\n    const detach = handle.onChange((status) => {\n      if (!predicate(status)) return;\n      clearTimeout(timer);\n      detach();\n      resolve(status);\n    });\n  });\n};\n\n/**\n * Resolves once the handle's change stream is live, so every later cluster write\n * reaches the client's cache.\n */\nexport const waitForStreamLive = async (\n  handle: connection.Handle,\n  timeout?: TimeSpan,\n): Promise<connection.Status> =>\n  await waitForStatus(\n    handle,\n    ({ variant, details }) => variant === \"success\" && details.streamLive,\n    timeout,\n  );\n","// Copyright 2026 Synnax Labs, Inc.\n//\n// Use of this software is governed by the Business Source License included in the file\n// licenses/BSL.txt.\n//\n// As of the Change Date specified in that file, in accordance with the Business Source\n// License, use of this software will be governed by the Apache License, Version 2.0,\n// included in the file licenses/APL.txt.\n\nimport { id } from \"@synnaxlabs/x\";\n\nimport type Synnax from \"@/client\";\nimport { type ontology } from \"@/ontology\";\nimport { project } from \"@/project\";\n\n/**\n * Creates a throwaway project and returns its ontology ID. Panel creation requires a\n * parent, so tests that mint panels directly parent them here.\n */\nexport const createPanelParent = async (client: Synnax): Promise<ontology.ID> => {\n  const proj = await client.projects.create({\n    name: `project-${id.create()}`,\n    layout: {},\n  });\n  return project.ontologyID(proj.key);\n};\n","// Copyright 2026 Synnax Labs, Inc.\n//\n// Use of this software is governed by the Business Source License included in the file\n// licenses/BSL.txt.\n//\n// As of the Change Date specified in that file, in accordance with the Business Source\n// License, use of this software will be governed by the Apache License, Version 2.0,\n// included in the file licenses/APL.txt.\n\nimport { connect, createServer, type Socket } from \"node:net\";\n\nimport { type breaker, TimeSpan } from \"@synnaxlabs/x\";\n\nconst DEFAULT_TARGET = { host: \"localhost\", port: 9090 };\n\n/**\n * Retry policy for a client pointed at a severable proxy. A spec drives its own\n * retries, so the client's must finish well inside one assertion budget: the\n * default policy waits seconds per request and outlasts a single `expect.poll`\n * attempt, which reports as a timeout rather than the real answer.\n */\nexport const FAST_RETRY: breaker.Config = {\n  baseInterval: TimeSpan.milliseconds(10),\n  maxInterval: TimeSpan.milliseconds(50),\n  scale: 1.5,\n};\n\nexport interface SeverableProxyTarget {\n  host?: string;\n  port?: number;\n}\n\nexport interface SeverableProxy {\n  /** Port the proxy accepts connections on. Point the client here. */\n  port: number;\n  /** Drops every live connection and refuses new ones, as if the cluster died. */\n  sever: () => Promise<void>;\n  /** Accepts connections again on the same port. */\n  restore: () => Promise<void>;\n  /** Shuts the proxy down for good. */\n  close: () => Promise<void>;\n}\n\n/**\n * Creates a TCP proxy in front of the live test cluster so specs can simulate\n * cluster downtime without touching the cluster itself. Connect a client to\n * the returned port, then sever() and restore() the link.\n */\nexport const createSeverableProxy = async (\n  target: SeverableProxyTarget = {},\n): Promise<SeverableProxy> => {\n  const { host, port } = { ...DEFAULT_TARGET, ...target };\n  const sockets = new Set<Socket>();\n  let severed = false;\n  const server = createServer((downstream) => {\n    // A connection the kernel accepted before the sever is still delivered after it,\n    // and forwarding it would let a request through a severed link.\n    if (severed) {\n      downstream.destroy();\n      return;\n    }\n    const upstream = connect(port, host);\n    sockets.add(downstream).add(upstream);\n    const destroy = (): void => {\n      sockets.delete(downstream);\n      sockets.delete(upstream);\n      downstream.destroy();\n      upstream.destroy();\n    };\n    downstream.on(\"error\", destroy);\n    upstream.on(\"error\", destroy);\n    downstream.on(\"close\", destroy);\n    upstream.on(\"close\", destroy);\n    downstream.pipe(upstream);\n    upstream.pipe(downstream);\n  });\n  const listen = async (listenPort: number): Promise<void> =>\n    await new Promise((resolve, reject) => {\n      server.once(\"error\", reject);\n      server.listen(listenPort, () => {\n        server.removeListener(\"error\", reject);\n        resolve();\n      });\n    });\n  await listen(0);\n  const address = server.address();\n  if (address == null || typeof address === \"string\")\n    throw new Error(\"proxy failed to bind a port\");\n  const boundPort = address.port;\n  const sever = async (): Promise<void> => {\n    severed = true;\n    const closed = new Promise<void>((resolve) => server.close(() => resolve()));\n    sockets.forEach((socket) => socket.destroy());\n    sockets.clear();\n    await closed;\n  };\n  return {\n    port: boundPort,\n    sever,\n    restore: async () => {\n      severed = false;\n      await listen(boundPort);\n    },\n    close: sever,\n  };\n};\n","// Copyright 2026 Synnax Labs, Inc.\n//\n// Use of this software is governed by the Business Source License included in the file\n// licenses/BSL.txt.\n//\n// As of the Change Date specified in that file, in accordance with the Business Source\n// License, use of this software will be governed by the Apache License, Version 2.0,\n// included in the file licenses/APL.txt.\n\nimport { query } from \"@/query\";\n\nexport { isLive } from \"@/query/query\";\n\n/** Asserts the cached answer is live (present and not deleted) and returns it. */\nexport const expectLive = <D extends query.Data>(\n  value: query.Cached<D> | undefined,\n): D => {\n  if (!query.isLive<D>(value)) throw new Error(\"expected a live cached answer\");\n  return value;\n};\n\n/** Asserts the cached answer is a deletion and returns it. */\nexport const expectDeleted = <D extends query.Data>(\n  value: query.Cached<D> | undefined,\n): query.Deleted<D> => {\n  if (!query.Deleted.matches<D>(value)) throw new Error(\"expected a deleted answer\");\n  return value;\n};\n","// Copyright 2026 Synnax Labs, Inc.\n//\n// Use of this software is governed by the Business Source License included in the file\n// licenses/BSL.txt.\n//\n// As of the Change Date specified in that file, in accordance with the Business Source\n// License, use of this software will be governed by the Apache License, Version 2.0,\n// included in the file licenses/APL.txt.\n\nimport { DataType, type Series, TimeStamp } from \"@synnaxlabs/x\";\n\nimport { type framer } from \"@/framer\";\n\nexport const secondsLinspace = (start: number, n: number): TimeStamp[] =>\n  Array.from({ length: n }, (_, i) => start + i).map((n) => TimeStamp.seconds(n));\n\nconst isRaw = (dt: DataType): boolean => dt.isVariable || dt.equals(DataType.UINT8);\n\n/** Narrows every numeric series to float32, anchoring bigints on an offset. Mirrors\n * the transform the visualization layer injects for WebGL rendering. */\nexport const glTransform: framer.Transform = {\n  resolveDataType: (dt: DataType) => (isRaw(dt) ? dt : DataType.FLOAT32),\n  convert: (series: Series, offset) => {\n    if (isRaw(series.dataType)) return series;\n    if (offset == null && series.dataType.usesBigInt && series.length > 0)\n      offset = BigInt(series.data[0]);\n    return series.convert(DataType.FLOAT32, offset);\n  },\n};\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@synnaxlabs/client",
-  "version": "0.56.1",
+  "version": "0.57.0",
   "description": "The Synnax Client Library",
   "keywords": [
     "synnax",
@@ -17,39 +17,62 @@
     "url": "https://github.com/synnaxlabs/synnax/issues"
   },
   "license": "BUSL-1.1",
-  "main": "dist/client.cjs",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/synnaxlabs/synnax.git",
     "directory": "client/ts"
   },
   "dependencies": {
-    "async-mutex": "^0.5.0",
-    "immer": "^11.1.8",
+    "immer": "^11.1.15",
     "zod": "^4.4.3",
-    "@synnaxlabs/freighter": "^0.56.1",
-    "@synnaxlabs/x": "^0.56.1"
+    "@synnaxlabs/alamos": "^0.57.0",
+    "@synnaxlabs/freighter": "^0.57.0",
+    "@synnaxlabs/x": "^0.57.0"
+  },
+  "peerDependencies": {
+    "vitest": "^4.1.10"
+  },
+  "peerDependenciesMeta": {
+    "vitest": {
+      "optional": true
+    }
   },
   "devDependencies": {
-    "@vitest/coverage-v8": "^4.1.6",
-    "@types/node": "^25.9.0",
-    "eslint": "^10.4.0",
-    "madge": "^8.0.0",
-    "typescript": "^6.0.3",
-    "vite": "^8.0.13",
-    "vitest": "^4.1.6",
+    "@vitest/coverage-v8": "^4.1.10",
+    "@types/node": "^26.1.2",
+    "eslint": "^10.8.0",
+    "typescript": "^7.0.2",
+    "vite": "^8.2.0",
+    "vitest": "^4.1.10",
+    "@synnaxlabs/madge": "^0.0.0",
+    "@synnaxlabs/tsconfig": "^0.0.0",
     "@synnaxlabs/eslint-config": "^0.0.0",
-    "@synnaxlabs/vite-plugin": "^0.0.0",
-    "@synnaxlabs/tsconfig": "^0.0.0"
+    "@synnaxlabs/vite-plugin": "^0.0.0"
   },
   "type": "module",
-  "types": "dist/src/index.d.ts",
-  "module": "dist/client.js",
+  "files": [
+    "dist",
+    "src",
+    "!**/*.spec.*",
+    "!**/*.bench.*",
+    "!dist/eslint.config.*"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/src/index.d.ts",
+      "default": "./dist/client.js"
+    },
+    "./testutil": {
+      "types": "./dist/src/testutil/index.d.ts",
+      "default": "./dist/testutil.js"
+    }
+  },
   "scripts": {
     "build": "tsc --noEmit && vite build",
     "check-types": "tsc --noEmit",
     "watch": "tsc --noEmit && vite build --watch",
     "test": "vitest",
+    "bench": "vitest bench",
     "cov": "vitest --coverage",
     "lint": "eslint",
     "fix": "eslint --fix",

package/src/access/client.ts

@@ -9,15 +9,26 @@
 
 import { type UnaryClient } from "@synnaxlabs/freighter";
 
+import { Granted } from "@/access/granted";
 import { policy } from "@/access/policy";
 import { role } from "@/access/role";
+import { type ontology } from "@/ontology";
+import { type query } from "@/query";
+
+export interface ClientConfig {
+  unary: UnaryClient;
+  cache: query.Cache;
+  ontology: ontology.Client;
+}
 
 export class Client {
   readonly policies: policy.Client;
   readonly roles: role.Client;
+  readonly granted: Granted;
 
-  constructor(client: UnaryClient) {
-    this.policies = new policy.Client(client);
-    this.roles = new role.Client(client);
+  constructor(cfg: ClientConfig) {
+    this.policies = new policy.Client(cfg);
+    this.roles = new role.Client(cfg);
+    this.granted = new Granted({ policies: this.policies });
   }
 }

package/src/access/enforce.ts

@@ -51,7 +51,6 @@ export const allowRequest = (req: Request, policies: Policy[]): boolean => {
     let allowed = false;
 
     for (const policy of policies) {
-      // Check if every requested action is allowed by this policy
       const actionAllowed = policy.actions.includes(action);
       if (!actionAllowed) continue;
 
@@ -75,10 +74,8 @@ export const allowRequest = (req: Request, policies: Policy[]): boolean => {
       if (allowed) break;
     }
 
-    // If any object is not allowed, the entire request fails
     if (!allowed) return false;
   }
 
-  // All objects are allowed
   return true;
 };

package/src/access/external.ts

@@ -10,5 +10,6 @@
 export { type Action, ACTIONS, actionZ } from "@/access/action/types.gen";
 export * from "@/access/client";
 export * from "@/access/enforce";
+export * from "@/access/granted";
 export * from "@/access/policy";
 export * from "@/access/role";