@synnaxlabs/client 0.56.2 → 0.57.0

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

@@ -1,30 +1,31 @@
-import { control, status, telem } from '@synnaxlabs/x';
+import { control, telem } from '@synnaxlabs/x';
 import { z } from 'zod';
 import { ontology } from '../ontology';
+import { status } from '../status';
 export declare const keyZ: z.ZodUnion<[z.ZodUInt32, z.ZodPipe<z.ZodString, z.ZodTransform<number, string>>]>;
 export type Key = z.infer<typeof keyZ>;
 export declare const localKeyZ: z.ZodInt;
 export type LocalKey = z.infer<typeof localKeyZ>;
 export declare const OPERATION_TYPES: readonly ["min", "max", "avg", "none", "derivative"];
 export declare const operationTypeZ: z.ZodEnum<{
-    none: "none";
     min: "min";
     max: "max";
     avg: "avg";
+    none: "none";
     derivative: "derivative";
 }>;
 export type OperationType = z.infer<typeof operationTypeZ>;
 /**
  * Operation defines an aggregation operation applied to channel data. Operations
- * calculate min, max, or average values over a time duration or triggered
+ * calculate min, max, average, or derivative values over a time duration or triggered
  * by a reset channel.
  */
 export declare const operationZ: z.ZodObject<{
     type: z.ZodEnum<{
-        none: "none";
         min: "min";
         max: "max";
         avg: "avg";
+        none: "none";
         derivative: "derivative";
     }>;
     resetChannel: z.ZodDefault<z.ZodUnion<[z.ZodUInt32, z.ZodPipe<z.ZodString, z.ZodTransform<number, string>>]>>;
@@ -39,8 +40,8 @@ export interface Operation extends z.infer<typeof operationZ> {
 export declare const nameZ: z.ZodString;
 export type Name = z.infer<typeof nameZ>;
 export declare const statusZ: status.StatusZodObject<z.ZodNever, z.ZodEnum<{
-    success: "success";
     error: "error";
+    success: "success";
     info: "info";
     warning: "warning";
     loading: "loading";
@@ -48,27 +49,31 @@ export declare const statusZ: status.StatusZodObject<z.ZodNever, z.ZodEnum<{
 }>>;
 export type Status = z.infer<typeof statusZ>;
 /**
- * Payload is a logical collection of samples emitted by or representing values
- * from a single source. Channels are the fundamental unit of telemetry
- * storage and streaming in Synnax.
+ * Payload is a logical collection of samples emitted by or representing values from a
+ * single source. Channels are the fundamental unit of telemetry storage and streaming
+ * in Synnax.
  */
 export declare const payloadZ: z.ZodObject<{
-    key: z.ZodUnion<[z.ZodUInt32, z.ZodPipe<z.ZodString, z.ZodTransform<number, string>>]>;
+    key: z.ZodDefault<z.ZodUnion<[z.ZodUInt32, z.ZodPipe<z.ZodString, z.ZodTransform<number, string>>]>>;
     name: z.ZodString;
-    leaseholder: z.ZodInt;
-    dataType: z.ZodUnion<readonly [z.ZodPipe<z.ZodString, z.ZodTransform<telem.DataType, string>>, z.ZodCustom<telem.DataType, telem.DataType>]>;
-    isIndex: z.ZodBoolean;
-    index: z.ZodUnion<[z.ZodUInt32, z.ZodPipe<z.ZodString, z.ZodTransform<number, string>>]>;
+    leaseholder: z.ZodDefault<z.ZodInt>;
+    dataType: z.ZodUnion<readonly [z.ZodCustom<telem.DataType, telem.DataType>, z.ZodPipe<z.ZodString, z.ZodTransform<telem.DataType, string>>, z.ZodPipe<z.ZodObject<{
+        value: z.ZodString;
+    }, z.core.$strip>, z.ZodTransform<telem.DataType, {
+        value: string;
+    }>>]>;
+    isIndex: z.ZodDefault<z.ZodBoolean>;
+    index: z.ZodDefault<z.ZodUnion<[z.ZodUInt32, z.ZodPipe<z.ZodString, z.ZodTransform<number, string>>]>>;
     alias: z.ZodOptional<z.ZodString>;
     virtual: z.ZodDefault<z.ZodBoolean>;
     internal: z.ZodDefault<z.ZodBoolean>;
     expression: z.ZodDefault<z.ZodString>;
-    operations: z.ZodOptional<z.ZodPipe<z.ZodNullable<z.ZodArray<z.ZodObject<{
+    operations: z.ZodDefault<z.ZodArray<z.ZodObject<{
         type: z.ZodEnum<{
-            none: "none";
             min: "min";
             max: "max";
             avg: "avg";
+            none: "none";
             derivative: "derivative";
         }>;
         resetChannel: z.ZodDefault<z.ZodUnion<[z.ZodUInt32, z.ZodPipe<z.ZodString, z.ZodTransform<number, string>>]>>;
@@ -77,19 +82,11 @@ export declare const payloadZ: z.ZodObject<{
         }, z.core.$strip>, z.ZodTransform<telem.TimeSpan, {
             value: bigint;
         }>>, z.ZodPipe<z.ZodString, z.ZodTransform<telem.TimeSpan, string>>, z.ZodPipe<z.ZodNumber, z.ZodTransform<telem.TimeSpan, number>>, z.ZodPipe<z.ZodBigInt, z.ZodTransform<telem.TimeSpan, bigint>>, z.ZodCustom<telem.TimeSpan, telem.TimeSpan>, z.ZodPipe<z.ZodCustom<telem.TimeStamp, telem.TimeStamp>, z.ZodTransform<telem.TimeSpan, telem.TimeStamp>>, z.ZodPipe<z.ZodCustom<telem.Rate, telem.Rate>, z.ZodTransform<telem.TimeSpan, telem.Rate>>]>>;
-    }, z.core.$strip>>>, z.ZodTransform<{
-        type: "none" | "min" | "max" | "avg" | "derivative";
-        resetChannel: number;
-        duration: telem.TimeSpan;
-    }[] | undefined, {
-        type: "none" | "min" | "max" | "avg" | "derivative";
-        resetChannel: number;
-        duration: telem.TimeSpan;
-    }[] | null>>>;
-    concurrency: z.ZodOptional<z.ZodDefault<z.ZodEnum<typeof control.Concurrency>>>;
+    }, z.core.$strip>>>;
+    concurrency: z.ZodDefault<z.ZodEnum<typeof control.Concurrency>>;
     status: z.ZodOptional<status.StatusZodObject<z.ZodNever, z.ZodEnum<{
-        success: "success";
         error: "error";
+        success: "success";
         info: "info";
         warning: "warning";
         loading: "loading";
@@ -98,58 +95,14 @@ export declare const payloadZ: z.ZodObject<{
 }, z.core.$strip>;
 export interface Payload extends z.infer<typeof payloadZ> {
 }
-export declare const newZ: z.ZodObject<{
-    name: z.ZodString;
-    status: z.ZodOptional<status.StatusZodObject<z.ZodNever, z.ZodEnum<{
-        success: "success";
-        error: "error";
-        info: "info";
-        warning: "warning";
-        loading: "loading";
-        disabled: "disabled";
-    }>>>;
-    key: z.ZodOptional<z.ZodUnion<[z.ZodUInt32, z.ZodPipe<z.ZodString, z.ZodTransform<number, string>>]>>;
-    internal: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
-    dataType: z.ZodUnion<readonly [z.ZodPipe<z.ZodString, z.ZodTransform<telem.DataType, string>>, z.ZodCustom<telem.DataType, telem.DataType>]>;
-    index: z.ZodOptional<z.ZodUnion<[z.ZodUInt32, z.ZodPipe<z.ZodString, z.ZodTransform<number, string>>]>>;
-    isIndex: z.ZodOptional<z.ZodBoolean>;
-    alias: z.ZodOptional<z.ZodString>;
-    virtual: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
-    expression: z.ZodOptional<z.ZodDefault<z.ZodString>>;
-    operations: z.ZodOptional<z.ZodPipe<z.ZodNullable<z.ZodArray<z.ZodObject<{
-        type: z.ZodEnum<{
-            none: "none";
-            min: "min";
-            max: "max";
-            avg: "avg";
-            derivative: "derivative";
-        }>;
-        resetChannel: z.ZodDefault<z.ZodUnion<[z.ZodUInt32, z.ZodPipe<z.ZodString, z.ZodTransform<number, string>>]>>;
-        duration: z.ZodDefault<z.ZodUnion<readonly [z.ZodPipe<z.ZodObject<{
-            value: z.ZodBigInt;
-        }, z.core.$strip>, z.ZodTransform<telem.TimeSpan, {
-            value: bigint;
-        }>>, z.ZodPipe<z.ZodString, z.ZodTransform<telem.TimeSpan, string>>, z.ZodPipe<z.ZodNumber, z.ZodTransform<telem.TimeSpan, number>>, z.ZodPipe<z.ZodBigInt, z.ZodTransform<telem.TimeSpan, bigint>>, z.ZodCustom<telem.TimeSpan, telem.TimeSpan>, z.ZodPipe<z.ZodCustom<telem.TimeStamp, telem.TimeStamp>, z.ZodTransform<telem.TimeSpan, telem.TimeStamp>>, z.ZodPipe<z.ZodCustom<telem.Rate, telem.Rate>, z.ZodTransform<telem.TimeSpan, telem.Rate>>]>>;
-    }, z.core.$strip>>>, z.ZodTransform<{
-        type: "none" | "min" | "max" | "avg" | "derivative";
-        resetChannel: number;
-        duration: telem.TimeSpan;
-    }[] | undefined, {
-        type: "none" | "min" | "max" | "avg" | "derivative";
-        resetChannel: number;
-        duration: telem.TimeSpan;
-    }[] | null>>>;
-    concurrency: z.ZodOptional<z.ZodDefault<z.ZodEnum<typeof control.Concurrency>>>;
-    leaseholder: z.ZodOptional<z.ZodInt>;
-}, z.core.$strip>;
-export interface New extends z.input<typeof newZ> {
+export interface New extends z.input<typeof payloadZ> {
 }
 export declare const ontologyID: ontology.CreateID<number>;
 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/channel/types.gen.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.gen.d.ts","sourceRoot":"","sources":["../../../src/channel/types.gen.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAiB,MAAM,eAAe,CAAC;AACtE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC,eAAO,MAAM,IAAI,mFAKhB,CAAC;AACF,MAAM,MAAM,GAAG,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC;AAEvC,eAAO,MAAM,SAAS,UAAa,CAAC;AACpC,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,SAAS,CAAC,CAAC;AAEjD,eAAO,MAAM,eAAe,sDAAuD,CAAC;AACpF,eAAO,MAAM,cAAc;;;;;;EAA0B,CAAC;AACtD,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAE3D;;;;GAIG;AACH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;iBAUrB,CAAC;AACH,MAAM,WAAW,SAAU,SAAQ,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC;CAAG;AAEhE,eAAO,MAAM,KAAK,aAAwC,CAAC;AAC3D,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,KAAK,CAAC,CAAC;AAEzC,eAAO,MAAM,OAAO;;;;;;;GAAmB,CAAC;AACxC,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,OAAO,CAAC,CAAC;AAE7C;;;;GAIG;AACH,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAuDnB,CAAC;AACH,MAAM,WAAW,OAAQ,SAAQ,CAAC,CAAC,KAAK,CAAC,OAAO,QAAQ,CAAC;CAAG;AAE5D,eAAO,MAAM,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAYb,CAAC;AACL,MAAM,WAAW,GAAI,SAAQ,CAAC,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC;CAAG;AAEpD,eAAO,MAAM,UAAU,2BAA2C,CAAC;AACnE,eAAO,MAAM,gBAAgB;;;;;;CAAgB,CAAC"}
+{"version":3,"file":"types.gen.d.ts","sourceRoot":"","sources":["../../../src/channel/types.gen.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,OAAO,EAAE,KAAK,EAAiB,MAAM,eAAe,CAAC;AAC9D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC,eAAO,MAAM,IAAI,mFAKhB,CAAC;AACF,MAAM,MAAM,GAAG,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC;AAEvC,eAAO,MAAM,SAAS,UAAa,CAAC;AACpC,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,SAAS,CAAC,CAAC;AAEjD,eAAO,MAAM,eAAe,sDAAuD,CAAC;AACpF,eAAO,MAAM,cAAc;;;;;;EAA0B,CAAC;AACtD,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAE3D;;;;GAIG;AACH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;iBAarB,CAAC;AACH,MAAM,WAAW,SAAU,SAAQ,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC;CAAG;AAEhE,eAAO,MAAM,KAAK,aAAwC,CAAC;AAC3D,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,KAAK,CAAC,CAAC;AAEzC,eAAO,MAAM,OAAO;;;;;;;GAAmB,CAAC;AACxC,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,OAAO,CAAC,CAAC;AAE7C;;;;GAIG;AACH,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAsDnB,CAAC;AACH,MAAM,WAAW,OAAQ,SAAQ,CAAC,CAAC,KAAK,CAAC,OAAO,QAAQ,CAAC;CAAG;AAC5D,MAAM,WAAW,GAAI,SAAQ,CAAC,CAAC,KAAK,CAAC,OAAO,QAAQ,CAAC;CAAG;AAExD,eAAO,MAAM,UAAU,2BAA2C,CAAC;AACnE,eAAO,MAAM,gBAAgB;;;;;;CAAgB,CAAC"}

package/dist/src/channel/writer.d.ts

@@ -1,6 +1,5 @@
 import { UnaryClient } from '@synnaxlabs/freighter';
 import { z } from 'zod';
-import { CacheRetriever } from './retriever';
 import { Key, New, Payload } from './types.gen';
 declare const deleteReqZ: z.ZodObject<{
     keys: z.ZodOptional<z.ZodArray<z.ZodUnion<[z.ZodUInt32, z.ZodPipe<z.ZodString, z.ZodTransform<number, string>>]>>>;
@@ -16,8 +15,7 @@ export interface RenameProps extends z.input<typeof renameReqZ> {
 }
 export declare class Writer {
     private readonly client;
-    private readonly cache;
-    constructor(client: UnaryClient, cache: CacheRetriever);
+    constructor(client: UnaryClient);
     create(channels: New[]): Promise<Payload[]>;
     delete(props: DeleteProps): Promise<void>;
     rename(keys: Key[], names: string[]): Promise<void>;

package/dist/src/channel/writer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"writer.d.ts","sourceRoot":"","sources":["../../../src/channel/writer.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEzD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EACL,KAAK,GAAG,EAGR,KAAK,GAAG,EAER,KAAK,OAAO,EAEb,MAAM,qBAAqB,CAAC;AAK7B,QAAA,MAAM,UAAU;;;iBAGd,CAAC;AAGH,QAAA,MAAM,UAAU;;;iBAAyD,CAAC;AAG1E,MAAM,WAAW,WAAY,SAAQ,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC;CAAG;AAClE,MAAM,WAAW,WAAY,SAAQ,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC;CAAG;AAElE,qBAAa,MAAM;IACjB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAc;IACrC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAiB;gBAE3B,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,cAAc;IAKhD,MAAM,CAAC,QAAQ,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAgB3C,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAOzC,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CAI1D"}
+{"version":3,"file":"writer.d.ts","sourceRoot":"","sources":["../../../src/channel/writer.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEzD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EACL,KAAK,GAAG,EAGR,KAAK,GAAG,EACR,KAAK,OAAO,EAEb,MAAM,qBAAqB,CAAC;AAK7B,QAAA,MAAM,UAAU;;;iBAGd,CAAC;AAGH,QAAA,MAAM,UAAU;;;iBAAyD,CAAC;AAG1E,MAAM,WAAW,WAAY,SAAQ,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC;CAAG;AAClE,MAAM,WAAW,WAAY,SAAQ,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC;CAAG;AAElE,qBAAa,MAAM;IACjB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAc;gBAEzB,MAAM,EAAE,WAAW;IAIzB,MAAM,CAAC,QAAQ,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAe3C,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzC,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CAG1D"}

package/dist/src/client.d.ts

@@ -1,4 +1,4 @@
-import { TimeSpan, TimeStamp } from '@synnaxlabs/x';
+import { CrudeTimeSpan, TimeSpan, TimeStamp } from '@synnaxlabs/x';
 import { z } from 'zod';
 import { access } from './access';
 import { arc } from './arc';
@@ -9,10 +9,13 @@ import { control } from './control';
 import { device } from './device';
 import { framer } from './framer';
 import { group } from './group';
+import { imex } from './imex';
 import { label } from './label';
 import { lineplot } from './lineplot';
 import { log } from './log';
 import { ontology } from './ontology';
+import { panel } from './panel';
+import { project } from './project';
 import { rack } from './rack';
 import { ranger } from './ranger';
 import { schematic } from './schematic';
@@ -21,7 +24,6 @@ import { table } from './table';
 import { task } from './task';
 import { user } from './user';
 import { view } from './view';
-import { workspace } from './workspace';
 export declare const synnaxParamsZ: z.ZodObject<{
     host: z.ZodString;
     port: z.ZodUnion<[z.ZodNumber, z.ZodString]>;
@@ -44,10 +46,18 @@ export declare const synnaxParamsZ: z.ZodObject<{
             value: z.ZodBigInt;
         }, z.core.$strip>, z.ZodTransform<TimeSpan, {
             value: bigint;
-        }>>, z.ZodPipe<z.ZodString, z.ZodTransform<TimeSpan, string>>, z.ZodPipe<z.ZodNumber, z.ZodTransform<TimeSpan, number>>, z.ZodPipe<z.ZodBigInt, z.ZodTransform<TimeSpan, bigint>>, z.ZodCustom<TimeSpan, TimeSpan>, z.ZodPipe<z.ZodCustom<import('@synnaxlabs/x/dist/src/telem').TimeStamp, import('@synnaxlabs/x/dist/src/telem').TimeStamp>, z.ZodTransform<TimeSpan, import('@synnaxlabs/x/dist/src/telem').TimeStamp>>, z.ZodPipe<z.ZodCustom<import('@synnaxlabs/x').Rate, import('@synnaxlabs/x').Rate>, z.ZodTransform<TimeSpan, import('@synnaxlabs/x').Rate>>]>>;
+        }>>, z.ZodPipe<z.ZodString, z.ZodTransform<TimeSpan, string>>, z.ZodPipe<z.ZodNumber, z.ZodTransform<TimeSpan, number>>, z.ZodPipe<z.ZodBigInt, z.ZodTransform<TimeSpan, bigint>>, z.ZodCustom<TimeSpan, TimeSpan>, z.ZodPipe<z.ZodCustom<import('@synnaxlabs/x/dist/src/telem/index.js').TimeStamp, import('@synnaxlabs/x/dist/src/telem/index.js').TimeStamp>, z.ZodTransform<TimeSpan, import('@synnaxlabs/x/dist/src/telem/index.js').TimeStamp>>, z.ZodPipe<z.ZodCustom<import('@synnaxlabs/x').Rate, import('@synnaxlabs/x').Rate>, z.ZodTransform<TimeSpan, import('@synnaxlabs/x').Rate>>]>>;
+        maxInterval: z.ZodOptional<z.ZodUnion<readonly [z.ZodPipe<z.ZodObject<{
+            value: z.ZodBigInt;
+        }, z.core.$strip>, z.ZodTransform<TimeSpan, {
+            value: bigint;
+        }>>, z.ZodPipe<z.ZodString, z.ZodTransform<TimeSpan, string>>, z.ZodPipe<z.ZodNumber, z.ZodTransform<TimeSpan, number>>, z.ZodPipe<z.ZodBigInt, z.ZodTransform<TimeSpan, bigint>>, z.ZodCustom<TimeSpan, TimeSpan>, z.ZodPipe<z.ZodCustom<import('@synnaxlabs/x/dist/src/telem/index.js').TimeStamp, import('@synnaxlabs/x/dist/src/telem/index.js').TimeStamp>, z.ZodTransform<TimeSpan, import('@synnaxlabs/x/dist/src/telem/index.js').TimeStamp>>, z.ZodPipe<z.ZodCustom<import('@synnaxlabs/x').Rate, import('@synnaxlabs/x').Rate>, z.ZodTransform<TimeSpan, import('@synnaxlabs/x').Rate>>]>>;
         maxRetries: z.ZodOptional<z.ZodNumber>;
         scale: z.ZodOptional<z.ZodNumber>;
+        jitter: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>>;
+    cache: z.ZodDefault<z.ZodBoolean>;
+    onInternalError: z.ZodOptional<z.ZodFunction<z.ZodTuple<[z.ZodCustom<Error, Error>], null>, z.ZodUnknown>>;
 }, z.core.$strip>;
 export interface SynnaxParams extends z.input<typeof synnaxParamsZ> {
 }
@@ -55,13 +65,13 @@ export interface ParsedSynnaxParams extends z.infer<typeof synnaxParamsZ> {
 }
 /**
  * Client to perform operations against a Synnax cluster.
- *
  * @property channel - Channel client for creating and retrieving channels.
  * @property data - Data client for reading and writing telemetry.
- * @property connectivity - Client for retrieving connectivity information.
+ * @property connection - The connection state machine.
  * @property ontology - Client for querying the cluster's ontology.
  */
 export default class Synnax extends framer.Client {
+    readonly key: string;
     readonly createdAt: TimeStamp;
     readonly params: ParsedSynnaxParams;
     readonly ranges: ranger.Client;
@@ -69,9 +79,9 @@ export default class Synnax extends framer.Client {
     readonly auth: auth.Client;
     readonly users: user.Client;
     readonly access: access.Client;
-    readonly connectivity: connection.Checker;
+    readonly connection: connection.Handle;
     readonly ontology: ontology.Client;
-    readonly workspaces: workspace.Client;
+    readonly projects: project.Client;
     readonly labels: label.Client;
     readonly statuses: status.Client;
     readonly tasks: task.Client;
@@ -82,36 +92,54 @@ export default class Synnax extends framer.Client {
     readonly views: view.Client;
     readonly schematics: schematic.Client;
     readonly lineplots: lineplot.Client;
+    readonly panels: panel.Client;
     readonly logs: log.Client;
     readonly tables: table.Client;
     readonly groups: group.Client;
-    static readonly connectivity: typeof connection.Checker;
+    readonly imex: imex.Client;
+    private readonly cache;
     private readonly transport;
-    /**
-     * The version of the client.
-     */
+    private readonly conn;
+    /** The version of the client. */
     readonly clientVersion: string;
     /**
      * @param props.host - Hostname of a node in the cluster.
      * @param props.port - Port of the node in the cluster.
-     * @param props.username - Username for authentication. Not required if the
-     * cluster is insecure.
-     * @param props.password - Password for authentication. Not required if the
-     * cluster is insecure.
-     * @param props.connectivityPollFrequency - Frequency at which to poll the
-     * cluster for connectivity information. Defaults to 30 seconds.
-     * @param props.secure - Whether to connect to the cluster using TLS. The cluster
-     * must be configured to support TLS. Defaults to false.
-     *
-     * A Synnax client must be closed when it is no longer needed. This will stop
-     * the client from polling the cluster for connectivity information.
+     * @param props.username - Username for authentication. Not required if the cluster is
+     * insecure.
+     * @param props.password - Password for authentication. Not required if the cluster is
+     * insecure.
+     * @param props.connectivityPollFrequency - Heartbeat cadence while the connection is
+     * healthy. Defaults to 30 seconds.
+     * @param props.secure - Whether to connect to the cluster using TLS. The cluster must
+     * be configured to support TLS. Defaults to false. A Synnax client must be closed
+     * when it is no longer needed. This stops the connection machine and closes the
+     * change stream.
      */
     constructor(params: SynnaxParams);
-    get key(): string;
-    close(): void;
+    /**
+     * Awaits the connection becoming usable: success, or warning when the cluster refuses
+     * live updates. Idempotent: resolves immediately when already connected.
+     * @throws {AuthError} on a definitive credential rejection.
+     * @throws {DisconnectedError} when the cluster cannot be reached after the configured
+     * retry budget, or when the client is closed while waiting.
+     * @throws {Error} if the timeout elapses first.
+     */
+    connect({ timeout }?: ConnectOptions): Promise<connection.Status>;
+    /** Supplies new credentials after an auth failure and resumes connecting. */
+    reauthenticate(credentials: auth.Credentials): void;
+    /**
+     * Closes the client, stopping the connection check loop and tearing down the
+     * query cache and its change stream. Resolves once both are closed.
+     * @throws {AggregateError} carrying every underlying close failure.
+     */
+    close(): Promise<void>;
 }
-export interface CheckConnectionParams extends Pick<SynnaxParams, "host" | "port" | "secure" | "retry" | "name"> {
+export interface ConnectOptions {
+    /**
+     * Maximum time to wait before rejecting. Without it, connect rejects when
+     * the connection escalates to error(unreachable) after its retry budget.
+     */
+    timeout?: CrudeTimeSpan;
 }
-export declare const checkConnection: (params: CheckConnectionParams) => Promise<connection.State>;
-export declare const newConnectionChecker: (params: CheckConnectionParams) => connection.Checker;
 //# sourceMappingURL=client.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,146 @@
+import { Middleware, UnaryClient } from '@synnaxlabs/freighter';
+import { breaker, CrudeTimeSpan, destructor, TimeSpan } from '@synnaxlabs/x';
+import { Event, Handle, Info, Status } from './status';
+/**
+ * Runs a single connectivity check, measuring clock skew across the round trip.
+ * The transport must carry the full middleware chain, auth included, so that a
+ * response proves authentication.
+ * @throws {AuthError} if the cluster rejects the client's credentials.
+ * @throws {Unreachable} if the cluster cannot be reached.
+ */
+export declare const sendCheck: (unary: UnaryClient) => Promise<Info>;
+/** Address parameters for a one-shot connectivity check. */
+export interface CheckParams {
+    host: string;
+    port: number | string;
+    secure?: boolean;
+    /** Human-readable cluster name for status messages. */
+    name?: string;
+}
+/**
+ * Runs a one-shot connectivity check against the given cluster address and folds the
+ * result into a status. Never throws: failures land in the returned status.
+ */
+export declare const check: (params: CheckParams) => Promise<Status>;
+/** How hard the check loop is working. */
+export type Mode = "checking" | "heartbeat" | "idle";
+/** The mode a given connection status calls for. */
+export declare const modeFor: ({ variant, details }: Status) => Mode;
+/**
+ * The outside facts that can move the connection. Everything else that moves it
+ * (check results, retry scheduling) the client observes itself.
+ */
+export type FactEvent = Extract<Event, {
+    type: "auth.success" | "auth.failure" | "stream.live" | "stream.drop" | "stream.denied" | "credentials.replaced" | "epoch.advanced";
+}>;
+export interface ClientParams {
+    /**
+     * Check transport. Must carry the full middleware chain, auth included, so
+     * that a check response proves authentication.
+     */
+    unary: UnaryClient;
+    /** Cluster address, used in error messages. */
+    address: string;
+    /** Human-readable cluster name for status messages. */
+    name?: string;
+    /** Consecutive check failures before escalating to error(unreachable). */
+    escalateAfter?: number;
+    clockSkewThreshold?: TimeSpan;
+    /** Whether success requires a live change stream. */
+    requiresStream?: boolean;
+    /**
+     * Degraded-check policy. `maxRetries` defaults to Infinity (never give up);
+     * a finite value parks the loop once exhausted, until {@link Client.retryNow}.
+     */
+    retry?: breaker.Config;
+    /** Check cadence while connected. Defaults to 30 seconds. */
+    heartbeatInterval?: CrudeTimeSpan;
+    /**
+     * Heartbeats between re-probes of a denied change stream. Only a policy
+     * change lifts a denial, and the client cannot hear about one. Defaults to 10.
+     */
+    deniedStreamProbeAfter?: number;
+    /** Levers on the change stream, pulled when transitions demand it. */
+    stream?: {
+        /** Tears down cached state after a cluster replacement. */
+        reset: () => Promise<void>;
+        /** (Re)demands a live change stream. */
+        ensure: () => Promise<void>;
+    };
+    /** Receives errors with no caller to throw to. Defaults to console logging. */
+    onInternalError?: (error: Error) => void;
+}
+/**
+ * Owns a cluster connection's status: checks on a cadence, backs off while degraded,
+ * folds outside facts ({@link Client.notify}) into the status, and notifies observers
+ * on material changes. The check loop starts on construction, deferred one microtask so
+ * callers can finish synchronous wiring (middleware installation) first.
+ */
+export declare class Client implements Handle {
+    private readonly unary;
+    private readonly address;
+    private readonly config;
+    private readonly retry;
+    private readonly heartbeatInterval;
+    private readonly deniedStreamProbeAfter;
+    private readonly stream?;
+    private readonly onInternalError;
+    private readonly observer;
+    private readonly notifier;
+    private readonly loop;
+    private current;
+    private mode;
+    private closed;
+    private attempts;
+    private generation;
+    private probeCountdown;
+    private brk;
+    private versionWarned;
+    constructor({ unary, address, name, escalateAfter, clockSkewThreshold, requiresStream, retry, heartbeatInterval, deniedStreamProbeAfter, stream, onInternalError, }: ClientParams);
+    /** The current connection status. */
+    get status(): Status;
+    /** Subscribes to material status changes. Returns an unsubscribe destructor. */
+    onChange(callback: (status: Status) => void): destructor.Destructor;
+    /**
+     * Resets the retry backoff and checks immediately. Auth and incompatibility
+     * errors are not cleared: those rest until the user supplies something new.
+     */
+    retryNow(): void;
+    /**
+     * Resolves once the connection is usable: success, or warning when the cluster
+     * refuses live updates. Rejects with the stored failure when it settles on an error
+     * variant or is closed. An already-connected client resolves without waiting.
+     * @throws {Error} if the timeout elapses first.
+     */
+    connect(timeout?: CrudeTimeSpan): Promise<Status>;
+    /** Folds an outside fact into the connection status. */
+    notify(event: FactEvent): void;
+    /**
+     * Rejects unary requests instantly while the cluster is known unreachable,
+     * instead of burning the transport's retry budget per call. The check and
+     * login targets are exempt so the connection can heal.
+     */
+    middleware(): Middleware;
+    /** Stops the check loop and settles the status on disabled. Terminal. */
+    close(): Promise<void>;
+    /**
+     * Folds the event into the status, notifies observers, and applies the
+     * transition's side effects.
+     */
+    private dispatch;
+    /** Drops everything cached from the replaced cluster, then brings the stream up. */
+    private resetStream;
+    /** Discards in-flight checks and wakes the loop for an immediate check. */
+    private wake;
+    private setMode;
+    /**
+     * Consumes this check's turn at re-demanding a dark stream, returning whether it gets
+     * one. A denied stream probes on a slow cadence: every probe costs an open the
+     * cluster refuses until an administrator changes the caller's policies.
+     */
+    private takeStreamProbe;
+    private runCheck;
+    private run;
+    private warn;
+}
+//# sourceMappingURL=client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/connection/client.ts"],"names":[],"mappings":"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"}

package/dist/src/connection/external.d.ts

@@ -0,0 +1,3 @@
+export { check, type CheckParams, Client, type ClientParams, type FactEvent, } from './client';
+export { type Config, DEFAULT_STATUS, type ErrorStatus, type ErrorStatusDetails, errorStatusDetailsZ, type Handle, type Info, type NonErrorStatus, nonErrorVariantZ, type Reason, REASONS, reasonZ, type Status, type StatusDetails, statusDetailsZ, statusZ, } from './status';
+//# sourceMappingURL=external.d.ts.map

package/dist/src/connection/external.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"external.d.ts","sourceRoot":"","sources":["../../../src/connection/external.ts"],"names":[],"mappings":"AASA,OAAO,EACL,KAAK,EACL,KAAK,WAAW,EAChB,MAAM,EACN,KAAK,YAAY,EACjB,KAAK,SAAS,GACf,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,KAAK,MAAM,EACX,cAAc,EACd,KAAK,WAAW,EAChB,KAAK,kBAAkB,EACvB,mBAAmB,EACnB,KAAK,MAAM,EACX,KAAK,IAAI,EACT,KAAK,cAAc,EACnB,gBAAgB,EAChB,KAAK,MAAM,EACX,OAAO,EACP,OAAO,EACP,KAAK,MAAM,EACX,KAAK,aAAa,EAClB,cAAc,EACd,OAAO,GACR,MAAM,qBAAqB,CAAC"}

package/dist/src/connection/index.d.ts

@@ -1,2 +1,2 @@
-export * as connection from './checker';
+export * as connection from './external';
 //# sourceMappingURL=index.d.ts.map

package/dist/src/connection/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/connection/index.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,UAAU,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/connection/index.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,UAAU,MAAM,uBAAuB,CAAC"}