@synnaxlabs/client 0.56.2 → 0.57.0

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

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

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

@@ -1,6 +1,6 @@
-import { status } from '@synnaxlabs/x';
 import { z } from 'zod';
 import { ontology } from '../ontology';
+import { status } from '../status';
 export declare const keyZ: z.ZodUInt32;
 export type Key = z.infer<typeof keyZ>;
 /** StatusDetails contains rack-specific status details. */
@@ -12,8 +12,8 @@ export interface StatusDetails extends z.infer<typeof statusDetailsZ> {
 export declare const statusZ: status.StatusZodObject<z.ZodObject<{
     rack: z.ZodUInt32;
 }, z.core.$strip>, z.ZodEnum<{
-    success: "success";
     error: "error";
+    success: "success";
     info: "info";
     warning: "warning";
     loading: "loading";
@@ -22,25 +22,24 @@ export declare const statusZ: status.StatusZodObject<z.ZodObject<{
 export type Status = z.infer<typeof statusZ>;
 /**
  * Payload is a collection container for hardware devices and tasks running on a
- * specific cluster node. Racks serve as the integration point between the
- * Synnax server and physical hardware via the Driver system.
+ * specific Core. Racks are the integration point between the Core and physical hardware
+ * through the Driver.
  */
 export declare const payloadZ: z.ZodObject<{
     key: z.ZodUInt32;
     name: z.ZodString;
-    taskCounter: z.ZodOptional<z.ZodUInt32>;
-    embedded: z.ZodOptional<z.ZodBoolean>;
+    embedded: z.ZodDefault<z.ZodBoolean>;
     status: z.ZodOptional<status.StatusZodObject<z.ZodObject<{
         rack: z.ZodUInt32;
     }, z.core.$strip>, z.ZodEnum<{
-        success: "success";
         error: "error";
+        success: "success";
         info: "info";
         warning: "warning";
         loading: "loading";
         disabled: "disabled";
     }>>>;
-    integrations: z.ZodOptional<z.ZodPipe<z.ZodNullable<z.ZodArray<z.ZodString>>, z.ZodTransform<string[] | undefined, string[] | null>>>;
+    integrations: z.ZodDefault<z.ZodArray<z.ZodString>>;
 }, z.core.$strip>;
 export interface Payload extends z.infer<typeof payloadZ> {
 }
@@ -49,24 +48,24 @@ export declare const newZ: z.ZodObject<{
     status: z.ZodOptional<status.StatusZodObject<z.ZodObject<{
         rack: z.ZodUInt32;
     }, z.core.$strip>, z.ZodEnum<{
-        success: "success";
         error: "error";
+        success: "success";
         info: "info";
         warning: "warning";
         loading: "loading";
         disabled: "disabled";
     }>>>;
-    integrations: z.ZodOptional<z.ZodPipe<z.ZodNullable<z.ZodArray<z.ZodString>>, z.ZodTransform<string[] | undefined, string[] | null>>>;
+    integrations: z.ZodDefault<z.ZodArray<z.ZodString>>;
     key: z.ZodDefault<z.ZodUInt32>;
 }, z.core.$strip>;
 export interface New extends z.input<typeof newZ> {
 }
 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/rack/types.gen.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.gen.d.ts","sourceRoot":"","sources":["../../../src/rack/types.gen.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,MAAM,EAAO,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC,eAAO,MAAM,IAAI,aAAa,CAAC;AAC/B,MAAM,MAAM,GAAG,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC;AAEvC,2DAA2D;AAC3D,eAAO,MAAM,cAAc;;iBAGzB,CAAC;AACH,MAAM,WAAW,aAAc,SAAQ,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC;CAAG;AAExE,eAAO,MAAM,OAAO;;;;;;;;;GAA8C,CAAC;AACnE,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,OAAO,CAAC,CAAC;AAE7C;;;;GAIG;AACH,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;iBAgBnB,CAAC;AACH,MAAM,WAAW,OAAQ,SAAQ,CAAC,CAAC,KAAK,CAAC,OAAO,QAAQ,CAAC;CAAG;AAE5D,eAAO,MAAM,IAAI;;;;;;;;;;;;;;iBAIb,CAAC;AACL,MAAM,WAAW,GAAI,SAAQ,CAAC,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC;CAAG;AAEpD,eAAO,MAAM,UAAU,2BAAwC,CAAC;AAChE,eAAO,MAAM,gBAAgB;;;;;;CAAgB,CAAC"}
+{"version":3,"file":"types.gen.d.ts","sourceRoot":"","sources":["../../../src/rack/types.gen.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC,eAAO,MAAM,IAAI,aAAa,CAAC;AAC/B,MAAM,MAAM,GAAG,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC;AAEvC,2DAA2D;AAC3D,eAAO,MAAM,cAAc;;iBAGzB,CAAC;AACH,MAAM,WAAW,aAAc,SAAQ,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC;CAAG;AAExE,eAAO,MAAM,OAAO;;;;;;;;;GAA8C,CAAC;AACnE,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,OAAO,CAAC,CAAC;AAE7C;;;;GAIG;AACH,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;iBAiBnB,CAAC;AACH,MAAM,WAAW,OAAQ,SAAQ,CAAC,CAAC,KAAK,CAAC,OAAO,QAAQ,CAAC;CAAG;AAE5D,eAAO,MAAM,IAAI;;;;;;;;;;;;;;iBAEf,CAAC;AACH,MAAM,WAAW,GAAI,SAAQ,CAAC,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC;CAAG;AAEpD,eAAO,MAAM,UAAU,2BAAwC,CAAC;AAChE,eAAO,MAAM,gBAAgB;;;;;;CAAgB,CAAC"}

package/dist/src/range/alias/types.gen.d.ts

@@ -1,8 +1,7 @@
 import { z } from 'zod';
 /**
- * Alias associates a human-readable string alias with a channel within the
- * context of a specific range. Enables semantic naming of channels that varies by
- * range context.
+ * Alias associates a human-readable string alias with a channel within the context of a
+ * specific range. Enables semantic naming of channels that varies by range context.
  */
 export declare const aliasZ: z.ZodObject<{
     range: z.ZodUUID;

package/dist/src/range/alias/types.gen.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.gen.d.ts","sourceRoot":"","sources":["../../../../src/range/alias/types.gen.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB;;;;GAIG;AACH,eAAO,MAAM,MAAM;;;;iBAOjB,CAAC;AACH,MAAM,WAAW,KAAM,SAAQ,CAAC,CAAC,KAAK,CAAC,OAAO,MAAM,CAAC;CAAG"}
+{"version":3,"file":"types.gen.d.ts","sourceRoot":"","sources":["../../../../src/range/alias/types.gen.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB;;;GAGG;AACH,eAAO,MAAM,MAAM;;;;iBAOjB,CAAC;AACH,MAAM,WAAW,KAAM,SAAQ,CAAC,CAAC,KAAK,CAAC,OAAO,MAAM,CAAC;CAAG"}

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

@@ -1,26 +1,32 @@
 import { UnaryClient } from '@synnaxlabs/freighter';
-import { color, CrudeTimeRange, Series, TimeRange } from '@synnaxlabs/x';
+import { color, CrudeTimeRange, destructor, Series, TimeRange } from '@synnaxlabs/x';
 import { z } from 'zod';
 import { channel } from '../channel';
 import { framer } from '../framer';
 import { label } from '../label';
 import { ontology } from '../ontology';
+import { query } from '../query';
+import { alias } from './alias';
 import { Client as AliasClient } from './alias/client';
+import { kv } from './kv';
 import { Client as KVClient } from './kv/client';
 import { Name, Params } from './payload';
 import { Key, New, Payload } from './types.gen';
-import { CreateOptions, Writer } from './writer';
 export declare const SET_CHANNEL_NAME = "sy_range_set";
 export declare const DELETE_CHANNEL_NAME = "sy_range_delete";
 interface RangeConstructionOptions {
     frameClient: framer.Client;
     kv: KVClient;
     aliaser: AliasClient;
-    channels: channel.Retriever;
+    channels: framer.ChannelRetriever;
     labelClient: label.Client;
     ontologyClient: ontology.Client;
     rangeClient: Client;
 }
+/**
+ * A named window of time, with the labels, metadata, and channel aliases attached to
+ * it. Its `read` and `kv` members scope those operations to its own time range.
+ */
 export declare class Range {
     key: string;
     name: string;
@@ -29,7 +35,7 @@ export declare class Range {
     readonly color?: color.Color;
     readonly parent?: Payload;
     readonly labels?: label.Label[];
-    readonly channels: channel.Retriever;
+    readonly channels: framer.ChannelRetriever;
     private readonly aliaser;
     private readonly frameClient;
     private readonly labelClient;
@@ -60,12 +66,12 @@ declare const retrieveRequestZ: z.ZodObject<{
             value: z.ZodBigInt;
         }, z.core.$strip>, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, {
             value: bigint;
-        }>>, z.ZodPipe<z.ZodString, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, string>>, z.ZodPipe<z.ZodNumber, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, number>>, z.ZodPipe<z.ZodBigInt, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, bigint>>, z.ZodPipe<z.ZodDate, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, Date>>, z.ZodPipe<z.ZodCustom<import('@synnaxlabs/x').TimeSpan, import('@synnaxlabs/x').TimeSpan>, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, import('@synnaxlabs/x').TimeSpan>>, z.ZodPipe<z.ZodUnion<readonly [z.ZodTuple<[z.ZodInt], null>, z.ZodTuple<[z.ZodInt, z.ZodInt], null>, z.ZodTuple<[z.ZodInt, z.ZodInt, z.ZodInt], null>]>, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, [number, number, number] | [number, number] | [number]>>]>;
+        }>>, z.ZodPipe<z.ZodString, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, string>>, z.ZodPipe<z.ZodNumber, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, number>>, z.ZodPipe<z.ZodBigInt, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, bigint>>, z.ZodPipe<z.ZodDate, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, Date>>, z.ZodPipe<z.ZodCustom<import('@synnaxlabs/x').TimeSpan, import('@synnaxlabs/x').TimeSpan>, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, import('@synnaxlabs/x').TimeSpan>>, z.ZodPipe<z.ZodUnion<readonly [z.ZodTuple<[z.ZodInt], null>, z.ZodTuple<[z.ZodInt, z.ZodInt], null>, z.ZodTuple<[z.ZodInt, z.ZodInt, z.ZodInt], null>]>, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, [number, number] | [number] | [number, number, number]>>]>;
         end: z.ZodUnion<readonly [z.ZodCustom<import('@synnaxlabs/x').TimeStamp, import('@synnaxlabs/x').TimeStamp>, z.ZodPipe<z.ZodObject<{
             value: z.ZodBigInt;
         }, z.core.$strip>, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, {
             value: bigint;
-        }>>, z.ZodPipe<z.ZodString, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, string>>, z.ZodPipe<z.ZodNumber, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, number>>, z.ZodPipe<z.ZodBigInt, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, bigint>>, z.ZodPipe<z.ZodDate, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, Date>>, z.ZodPipe<z.ZodCustom<import('@synnaxlabs/x').TimeSpan, import('@synnaxlabs/x').TimeSpan>, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, import('@synnaxlabs/x').TimeSpan>>, z.ZodPipe<z.ZodUnion<readonly [z.ZodTuple<[z.ZodInt], null>, z.ZodTuple<[z.ZodInt, z.ZodInt], null>, z.ZodTuple<[z.ZodInt, z.ZodInt, z.ZodInt], null>]>, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, [number, number, number] | [number, number] | [number]>>]>;
+        }>>, z.ZodPipe<z.ZodString, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, string>>, z.ZodPipe<z.ZodNumber, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, number>>, z.ZodPipe<z.ZodBigInt, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, bigint>>, z.ZodPipe<z.ZodDate, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, Date>>, z.ZodPipe<z.ZodCustom<import('@synnaxlabs/x').TimeSpan, import('@synnaxlabs/x').TimeSpan>, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, import('@synnaxlabs/x').TimeSpan>>, z.ZodPipe<z.ZodUnion<readonly [z.ZodTuple<[z.ZodInt], null>, z.ZodTuple<[z.ZodInt, z.ZodInt], null>, z.ZodTuple<[z.ZodInt, z.ZodInt, z.ZodInt], null>]>, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, [number, number] | [number] | [number, number, number]>>]>;
     }, z.core.$strip>, z.ZodTransform<TimeRange, {
         start: import('@synnaxlabs/x').TimeStamp;
         end: import('@synnaxlabs/x').TimeStamp;
@@ -75,9 +81,11 @@ declare const retrieveRequestZ: z.ZodObject<{
     offset: z.ZodOptional<z.ZodInt>;
     includeLabels: z.ZodOptional<z.ZodBoolean>;
     includeParent: z.ZodOptional<z.ZodBoolean>;
+    ignoreNotFoundError: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>;
+/** Everything a range retrieval can filter on. */
 export type RetrieveRequest = z.infer<typeof retrieveRequestZ>;
-declare const retrieveArgsZ: z.ZodUnion<[z.ZodUnion<[z.ZodUnion<[z.ZodUnion<[z.ZodUnion<[z.ZodObject<{
+declare const retrieveParamsZ: z.ZodUnion<[z.ZodUnion<[z.ZodUnion<[z.ZodUnion<[z.ZodUnion<[z.ZodObject<{
     keys: z.ZodOptional<z.ZodArray<z.ZodUUID>>;
     names: z.ZodOptional<z.ZodArray<z.ZodString>>;
     searchTerm: z.ZodOptional<z.ZodString>;
@@ -86,12 +94,12 @@ declare const retrieveArgsZ: z.ZodUnion<[z.ZodUnion<[z.ZodUnion<[z.ZodUnion<[z.Z
             value: z.ZodBigInt;
         }, z.core.$strip>, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, {
             value: bigint;
-        }>>, z.ZodPipe<z.ZodString, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, string>>, z.ZodPipe<z.ZodNumber, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, number>>, z.ZodPipe<z.ZodBigInt, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, bigint>>, z.ZodPipe<z.ZodDate, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, Date>>, z.ZodPipe<z.ZodCustom<import('@synnaxlabs/x').TimeSpan, import('@synnaxlabs/x').TimeSpan>, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, import('@synnaxlabs/x').TimeSpan>>, z.ZodPipe<z.ZodUnion<readonly [z.ZodTuple<[z.ZodInt], null>, z.ZodTuple<[z.ZodInt, z.ZodInt], null>, z.ZodTuple<[z.ZodInt, z.ZodInt, z.ZodInt], null>]>, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, [number, number, number] | [number, number] | [number]>>]>;
+        }>>, z.ZodPipe<z.ZodString, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, string>>, z.ZodPipe<z.ZodNumber, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, number>>, z.ZodPipe<z.ZodBigInt, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, bigint>>, z.ZodPipe<z.ZodDate, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, Date>>, z.ZodPipe<z.ZodCustom<import('@synnaxlabs/x').TimeSpan, import('@synnaxlabs/x').TimeSpan>, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, import('@synnaxlabs/x').TimeSpan>>, z.ZodPipe<z.ZodUnion<readonly [z.ZodTuple<[z.ZodInt], null>, z.ZodTuple<[z.ZodInt, z.ZodInt], null>, z.ZodTuple<[z.ZodInt, z.ZodInt, z.ZodInt], null>]>, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, [number, number] | [number] | [number, number, number]>>]>;
         end: z.ZodUnion<readonly [z.ZodCustom<import('@synnaxlabs/x').TimeStamp, import('@synnaxlabs/x').TimeStamp>, z.ZodPipe<z.ZodObject<{
             value: z.ZodBigInt;
         }, z.core.$strip>, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, {
             value: bigint;
-        }>>, z.ZodPipe<z.ZodString, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, string>>, z.ZodPipe<z.ZodNumber, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, number>>, z.ZodPipe<z.ZodBigInt, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, bigint>>, z.ZodPipe<z.ZodDate, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, Date>>, z.ZodPipe<z.ZodCustom<import('@synnaxlabs/x').TimeSpan, import('@synnaxlabs/x').TimeSpan>, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, import('@synnaxlabs/x').TimeSpan>>, z.ZodPipe<z.ZodUnion<readonly [z.ZodTuple<[z.ZodInt], null>, z.ZodTuple<[z.ZodInt, z.ZodInt], null>, z.ZodTuple<[z.ZodInt, z.ZodInt, z.ZodInt], null>]>, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, [number, number, number] | [number, number] | [number]>>]>;
+        }>>, z.ZodPipe<z.ZodString, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, string>>, z.ZodPipe<z.ZodNumber, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, number>>, z.ZodPipe<z.ZodBigInt, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, bigint>>, z.ZodPipe<z.ZodDate, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, Date>>, z.ZodPipe<z.ZodCustom<import('@synnaxlabs/x').TimeSpan, import('@synnaxlabs/x').TimeSpan>, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, import('@synnaxlabs/x').TimeSpan>>, z.ZodPipe<z.ZodUnion<readonly [z.ZodTuple<[z.ZodInt], null>, z.ZodTuple<[z.ZodInt, z.ZodInt], null>, z.ZodTuple<[z.ZodInt, z.ZodInt, z.ZodInt], null>]>, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, [number, number] | [number] | [number, number, number]>>]>;
     }, z.core.$strip>, z.ZodTransform<TimeRange, {
         start: import('@synnaxlabs/x').TimeStamp;
         end: import('@synnaxlabs/x').TimeStamp;
@@ -101,6 +109,7 @@ declare const retrieveArgsZ: z.ZodUnion<[z.ZodUnion<[z.ZodUnion<[z.ZodUnion<[z.Z
     offset: z.ZodOptional<z.ZodInt>;
     includeLabels: z.ZodOptional<z.ZodBoolean>;
     includeParent: z.ZodOptional<z.ZodBoolean>;
+    ignoreNotFoundError: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>, z.ZodPipe<z.ZodArray<z.ZodUUID>, z.ZodTransform<{
     keys: string[];
 }, string[]>>]>, z.ZodPipe<z.ZodUUID, z.ZodTransform<{
@@ -114,51 +123,153 @@ declare const retrieveArgsZ: z.ZodUnion<[z.ZodUnion<[z.ZodUnion<[z.ZodUnion<[z.Z
         value: z.ZodBigInt;
     }, z.core.$strip>, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, {
         value: bigint;
-    }>>, z.ZodPipe<z.ZodString, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, string>>, z.ZodPipe<z.ZodNumber, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, number>>, z.ZodPipe<z.ZodBigInt, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, bigint>>, z.ZodPipe<z.ZodDate, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, Date>>, z.ZodPipe<z.ZodCustom<import('@synnaxlabs/x').TimeSpan, import('@synnaxlabs/x').TimeSpan>, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, import('@synnaxlabs/x').TimeSpan>>, z.ZodPipe<z.ZodUnion<readonly [z.ZodTuple<[z.ZodInt], null>, z.ZodTuple<[z.ZodInt, z.ZodInt], null>, z.ZodTuple<[z.ZodInt, z.ZodInt, z.ZodInt], null>]>, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, [number, number, number] | [number, number] | [number]>>]>;
+    }>>, z.ZodPipe<z.ZodString, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, string>>, z.ZodPipe<z.ZodNumber, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, number>>, z.ZodPipe<z.ZodBigInt, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, bigint>>, z.ZodPipe<z.ZodDate, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, Date>>, z.ZodPipe<z.ZodCustom<import('@synnaxlabs/x').TimeSpan, import('@synnaxlabs/x').TimeSpan>, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, import('@synnaxlabs/x').TimeSpan>>, z.ZodPipe<z.ZodUnion<readonly [z.ZodTuple<[z.ZodInt], null>, z.ZodTuple<[z.ZodInt, z.ZodInt], null>, z.ZodTuple<[z.ZodInt, z.ZodInt, z.ZodInt], null>]>, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, [number, number] | [number] | [number, number, number]>>]>;
     end: z.ZodUnion<readonly [z.ZodCustom<import('@synnaxlabs/x').TimeStamp, import('@synnaxlabs/x').TimeStamp>, z.ZodPipe<z.ZodObject<{
         value: z.ZodBigInt;
     }, z.core.$strip>, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, {
         value: bigint;
-    }>>, z.ZodPipe<z.ZodString, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, string>>, z.ZodPipe<z.ZodNumber, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, number>>, z.ZodPipe<z.ZodBigInt, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, bigint>>, z.ZodPipe<z.ZodDate, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, Date>>, z.ZodPipe<z.ZodCustom<import('@synnaxlabs/x').TimeSpan, import('@synnaxlabs/x').TimeSpan>, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, import('@synnaxlabs/x').TimeSpan>>, z.ZodPipe<z.ZodUnion<readonly [z.ZodTuple<[z.ZodInt], null>, z.ZodTuple<[z.ZodInt, z.ZodInt], null>, z.ZodTuple<[z.ZodInt, z.ZodInt, z.ZodInt], null>]>, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, [number, number, number] | [number, number] | [number]>>]>;
+    }>>, z.ZodPipe<z.ZodString, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, string>>, z.ZodPipe<z.ZodNumber, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, number>>, z.ZodPipe<z.ZodBigInt, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, bigint>>, z.ZodPipe<z.ZodDate, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, Date>>, z.ZodPipe<z.ZodCustom<import('@synnaxlabs/x').TimeSpan, import('@synnaxlabs/x').TimeSpan>, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, import('@synnaxlabs/x').TimeSpan>>, z.ZodPipe<z.ZodUnion<readonly [z.ZodTuple<[z.ZodInt], null>, z.ZodTuple<[z.ZodInt, z.ZodInt], null>, z.ZodTuple<[z.ZodInt, z.ZodInt, z.ZodInt], null>]>, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, [number, number] | [number] | [number, number, number]>>]>;
 }, z.core.$strip>, z.ZodTransform<TimeRange, {
     start: import('@synnaxlabs/x').TimeStamp;
     end: import('@synnaxlabs/x').TimeStamp;
 }>>, z.ZodCustom<TimeRange, TimeRange>]>, z.ZodTransform<{
     overlapsWith: TimeRange;
 }, TimeRange>>]>;
-export type RetrieveArgs = z.input<typeof retrieveArgsZ>;
-export declare class Client {
+/** Params for a range retrieval. A bare key, name, or time range is shorthand. */
+export type RetrieveParams = z.input<typeof retrieveParamsZ>;
+/** Canonicalizes every retrieve shape addressing more than one range. */
+declare const retrieveMultiParamsZ: z.ZodUnion<[z.ZodUnion<[z.ZodUnion<[z.ZodObject<{
+    keys: z.ZodOptional<z.ZodArray<z.ZodUUID>>;
+    names: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    searchTerm: z.ZodOptional<z.ZodString>;
+    overlapsWith: z.ZodOptional<z.ZodUnion<readonly [z.ZodPipe<z.ZodObject<{
+        start: z.ZodUnion<readonly [z.ZodCustom<import('@synnaxlabs/x').TimeStamp, import('@synnaxlabs/x').TimeStamp>, z.ZodPipe<z.ZodObject<{
+            value: z.ZodBigInt;
+        }, z.core.$strip>, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, {
+            value: bigint;
+        }>>, z.ZodPipe<z.ZodString, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, string>>, z.ZodPipe<z.ZodNumber, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, number>>, z.ZodPipe<z.ZodBigInt, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, bigint>>, z.ZodPipe<z.ZodDate, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, Date>>, z.ZodPipe<z.ZodCustom<import('@synnaxlabs/x').TimeSpan, import('@synnaxlabs/x').TimeSpan>, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, import('@synnaxlabs/x').TimeSpan>>, z.ZodPipe<z.ZodUnion<readonly [z.ZodTuple<[z.ZodInt], null>, z.ZodTuple<[z.ZodInt, z.ZodInt], null>, z.ZodTuple<[z.ZodInt, z.ZodInt, z.ZodInt], null>]>, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, [number, number] | [number] | [number, number, number]>>]>;
+        end: z.ZodUnion<readonly [z.ZodCustom<import('@synnaxlabs/x').TimeStamp, import('@synnaxlabs/x').TimeStamp>, z.ZodPipe<z.ZodObject<{
+            value: z.ZodBigInt;
+        }, z.core.$strip>, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, {
+            value: bigint;
+        }>>, z.ZodPipe<z.ZodString, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, string>>, z.ZodPipe<z.ZodNumber, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, number>>, z.ZodPipe<z.ZodBigInt, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, bigint>>, z.ZodPipe<z.ZodDate, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, Date>>, z.ZodPipe<z.ZodCustom<import('@synnaxlabs/x').TimeSpan, import('@synnaxlabs/x').TimeSpan>, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, import('@synnaxlabs/x').TimeSpan>>, z.ZodPipe<z.ZodUnion<readonly [z.ZodTuple<[z.ZodInt], null>, z.ZodTuple<[z.ZodInt, z.ZodInt], null>, z.ZodTuple<[z.ZodInt, z.ZodInt, z.ZodInt], null>]>, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, [number, number] | [number] | [number, number, number]>>]>;
+    }, z.core.$strip>, z.ZodTransform<TimeRange, {
+        start: import('@synnaxlabs/x').TimeStamp;
+        end: import('@synnaxlabs/x').TimeStamp;
+    }>>, z.ZodCustom<TimeRange, TimeRange>]>>;
+    hasLabels: z.ZodOptional<z.ZodArray<z.ZodUUID>>;
+    limit: z.ZodOptional<z.ZodInt>;
+    offset: z.ZodOptional<z.ZodInt>;
+    includeLabels: z.ZodOptional<z.ZodBoolean>;
+    includeParent: z.ZodOptional<z.ZodBoolean>;
+    ignoreNotFoundError: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>, z.ZodPipe<z.ZodArray<z.ZodUUID>, z.ZodTransform<{
+    keys: string[];
+}, string[]>>]>, z.ZodPipe<z.ZodArray<z.ZodString>, z.ZodTransform<{
+    names: string[];
+}, string[]>>]>, z.ZodPipe<z.ZodUnion<readonly [z.ZodPipe<z.ZodObject<{
+    start: z.ZodUnion<readonly [z.ZodCustom<import('@synnaxlabs/x').TimeStamp, import('@synnaxlabs/x').TimeStamp>, z.ZodPipe<z.ZodObject<{
+        value: z.ZodBigInt;
+    }, z.core.$strip>, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, {
+        value: bigint;
+    }>>, z.ZodPipe<z.ZodString, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, string>>, z.ZodPipe<z.ZodNumber, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, number>>, z.ZodPipe<z.ZodBigInt, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, bigint>>, z.ZodPipe<z.ZodDate, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, Date>>, z.ZodPipe<z.ZodCustom<import('@synnaxlabs/x').TimeSpan, import('@synnaxlabs/x').TimeSpan>, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, import('@synnaxlabs/x').TimeSpan>>, z.ZodPipe<z.ZodUnion<readonly [z.ZodTuple<[z.ZodInt], null>, z.ZodTuple<[z.ZodInt, z.ZodInt], null>, z.ZodTuple<[z.ZodInt, z.ZodInt, z.ZodInt], null>]>, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, [number, number] | [number] | [number, number, number]>>]>;
+    end: z.ZodUnion<readonly [z.ZodCustom<import('@synnaxlabs/x').TimeStamp, import('@synnaxlabs/x').TimeStamp>, z.ZodPipe<z.ZodObject<{
+        value: z.ZodBigInt;
+    }, z.core.$strip>, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, {
+        value: bigint;
+    }>>, z.ZodPipe<z.ZodString, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, string>>, z.ZodPipe<z.ZodNumber, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, number>>, z.ZodPipe<z.ZodBigInt, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, bigint>>, z.ZodPipe<z.ZodDate, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, Date>>, z.ZodPipe<z.ZodCustom<import('@synnaxlabs/x').TimeSpan, import('@synnaxlabs/x').TimeSpan>, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, import('@synnaxlabs/x').TimeSpan>>, z.ZodPipe<z.ZodUnion<readonly [z.ZodTuple<[z.ZodInt], null>, z.ZodTuple<[z.ZodInt, z.ZodInt], null>, z.ZodTuple<[z.ZodInt, z.ZodInt, z.ZodInt], null>]>, z.ZodTransform<import('@synnaxlabs/x').TimeStamp, [number, number] | [number] | [number, number, number]>>]>;
+}, z.core.$strip>, z.ZodTransform<TimeRange, {
+    start: import('@synnaxlabs/x').TimeStamp;
+    end: import('@synnaxlabs/x').TimeStamp;
+}>>, z.ZodCustom<TimeRange, TimeRange>]>, z.ZodTransform<{
+    overlapsWith: TimeRange;
+}, TimeRange>>]>;
+/** Config for {@link Client}. */
+export interface ClientConfig {
+    framer: framer.Client;
+    unary: UnaryClient;
+    channels: framer.ChannelRetriever;
+    labels: label.Client;
+    ontology: ontology.Client;
+    cache: query.Cache;
+}
+/**
+ * Creates, reads, and deletes ranges on a Core. Reach it through `client.ranges`. Reads
+ * return sugared {@link Range}s, served from a cache a change stream keeps current.
+ */
+export declare class Client extends query.Retriever<typeof retrieveMultiParamsZ, Key, Range, Range, Key | Name> {
     readonly type: string;
-    private readonly frameClient;
+    /** The range alias table; injected into sibling clients at wiring. */
+    readonly aliases: query.Table<string, alias.Alias>;
+    /** Cached queries for the children of a range, keyed by the parent's key. */
+    readonly children: query.Retrieves<Key, Range[]>;
+    /**
+     * Cached queries for the closest range parent of a resource, keyed by the
+     * child's ontology ID.
+     */
+    readonly parent: query.Retrieves<ontology.ID, Range | null>;
+    /** Cached queries for a range's KV metadata pairs, keyed by the range's key. */
+    readonly kv: query.Retrieves<Key, kv.Pair[]>;
+    private readonly cfg;
     private readonly writer;
-    private readonly unaryClient;
-    private readonly channels;
-    private readonly labelClient;
-    private readonly ontologyClient;
-    private readonly createAliasClient;
-    private readonly createKVClient;
-    constructor(frameClient: framer.Client, writer: Writer, unary: UnaryClient, channels: channel.Retriever, labelClient: label.Client, ontologyClient: ontology.Client, createAliasClient: (key: Key) => AliasClient, createKVClient: (key: Key) => KVClient);
-    create(range: New, options?: CreateOptions): Promise<Range>;
-    create(ranges: New[], options?: CreateOptions): Promise<Range[]>;
-    rename(key: Key, name: Name): Promise<void>;
-    delete(key: Key | Key[]): Promise<void>;
+    private readonly store;
+    private readonly kvPairs;
+    constructor(cfg: ClientConfig);
+    create(range: New): Promise<Range>;
+    create(ranges: New[]): Promise<Range[]>;
+    rename(key: Key, name: Name, opts?: query.WriteOptions): Promise<void>;
+    delete(key: Key | Key[], opts?: query.WriteOptions): Promise<void>;
     retrieve(params: Key | Name): Promise<Range>;
     retrieve(params: Key[] | Name[]): Promise<Range[]>;
     retrieve(params: CrudeTimeRange): Promise<Range[]>;
     retrieve(params: RetrieveRequest): Promise<Range[]>;
+    private execRetrieve;
+    /** Subscribes to every range set delivered to the cache. */
+    onSet(handler: (range: Range) => void): destructor.Destructor;
+    /** Subscribes to every range delete delivered to the cache. */
+    onDelete(handler: (key: Key) => void): destructor.Destructor;
+    private createAliasClient;
+    private createKVClient;
+    /** Rebuilds a cached range with its cached labels and parent attached. */
+    private composeOne;
+    /** Writes a fetched range and its included labels/parent relationships. */
+    private writeThrough;
+    /**
+     * Fetches the given keys with labels and parents included, writing them and
+     * their relationships through. Powers the table's fetch primitive.
+     */
+    private fetchThrough;
+    private fetchSingle;
+    /**
+     * Fetches records a relationship points at that the cache is missing, so compositions
+     * and membership checks can include them. Presence guards make it idempotent.
+     */
+    private ensureRelationshipTargets;
+    private fetchRequest;
+    /** Exact client-side evaluation of a request against a cached range. */
+    private requestMatches;
+    private fetchChildren;
+    private fetchParent;
+    private fetchKV;
     getKV(range: Key): KVClient;
+    /** Returns the parent of the given range, or null when it has none. */
     retrieveParent(range: Key): Promise<Range | null>;
     sugarOntologyResource(resource: ontology.Resource): Range;
     retrieveAlias(range: Key, channel: channel.Key): Promise<string>;
     retrieveAliases(range: Key, channels: channel.Key[]): Promise<Record<channel.Key, string>>;
     listAliases(range: Key): Promise<Record<channel.Key, string>>;
-    setAlias(range: Key, channel: channel.Key, alias: string): Promise<void>;
-    deleteAlias(range: Key, channels: channel.Key | channel.Key[]): Promise<void>;
+    setAlias(range: Key, channel: channel.Key, aliasName: string, opts?: query.WriteOptions): Promise<void>;
+    deleteAlias(range: Key, channels: channel.Key | channel.Key[], opts?: query.WriteOptions): Promise<void>;
     sugarOne(payload: Payload): Range;
     sugarMany(payloads: Payload[]): Range[];
     resourceToRange(resource: ontology.Resource): Range;
 }
+/** @returns the ontology ID of a range's alias set. */
 export declare const aliasOntologyID: (key: Key) => ontology.ID;
+/**
+ * Rebuilds a range payload from its ontology resource, for a search result that arrives
+ * through the ontology rather than the range endpoint.
+ */
 export declare const convertOntologyResourceToPayload: ({ data, id: { key }, name, }: ontology.Resource) => Payload;
 export {};
 //# sourceMappingURL=client.d.ts.map

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

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

package/dist/src/ranger/kv/client.d.ts

@@ -1,14 +1,17 @@
 import { UnaryClient } from '@synnaxlabs/freighter';
+import { query } from '../../query';
+import { Pair } from './types.gen';
 import { Key } from '../types.gen';
 export declare class Client {
     private readonly rangeKey;
     private readonly client;
-    constructor(rng: Key, client: UnaryClient);
+    private readonly pairs;
+    constructor(rng: Key, client: UnaryClient, pairs: query.Table<string, Pair>);
     get(key: string): Promise<string>;
     get(keys: string[]): Promise<Record<string, string>>;
     list(): Promise<Record<string, string>>;
-    set(key: string, value: string): Promise<void>;
-    set(kv: Record<string, string>): Promise<void>;
-    delete(key: string | string[]): Promise<void>;
+    set(key: string, value: string, opts?: query.WriteOptions): Promise<void>;
+    set(kv: Record<string, string>, opts?: query.WriteOptions): Promise<void>;
+    delete(key: string | string[], opts?: query.WriteOptions): Promise<void>;
 }
 //# sourceMappingURL=client.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../../src/ranger/kv/client.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAKzD,OAAO,EAAE,KAAK,GAAG,EAAQ,MAAM,oBAAoB,CAAC;AAOpD,qBAAa,MAAM;IACjB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAM;IAC/B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAc;gBAEzB,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,WAAW;IAKnC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IACjC,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAYpD,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAIvC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAC9C,GAAG,CAAC,EAAE,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAmB9C,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CAQpD"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../../src/ranger/kv/client.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAIzD,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAEhC,OAAO,EAAE,KAAK,IAAI,EAAS,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,KAAK,GAAG,EAAQ,MAAM,oBAAoB,CAAC;AAOpD,qBAAa,MAAM;IACjB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAM;IAC/B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAc;IACrC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA4B;gBAEtC,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC;IAMrE,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IACjC,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAYpD,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAIvC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,KAAK,CAAC,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IACzE,GAAG,CAAC,EAAE,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,IAAI,CAAC,EAAE,KAAK,CAAC,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAkCzE,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,IAAI,GAAE,KAAK,CAAC,YAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;CAoBnF"}

package/dist/src/ranger/payload.d.ts

@@ -1,6 +1,9 @@
 import { z } from 'zod';
 import { Key } from './types.gen';
+/** Zod schema for {@link Name}. A range name cannot be empty. */
 export declare const nameZ: z.ZodString;
+/** A range's display name. */
 export type Name = z.infer<typeof nameZ>;
+/** One or many ranges, named by key or by name. */
 export type Params = Key | Name | Key[] | Name[];
 //# sourceMappingURL=payload.d.ts.map

package/dist/src/ranger/payload.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"payload.d.ts","sourceRoot":"","sources":["../../../src/ranger/payload.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,KAAK,GAAG,EAAE,MAAM,oBAAoB,CAAC;AAE9C,eAAO,MAAM,KAAK,aAAoB,CAAC;AACvC,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,KAAK,CAAC,CAAC;AACzC,MAAM,MAAM,MAAM,GAAG,GAAG,GAAG,IAAI,GAAG,GAAG,EAAE,GAAG,IAAI,EAAE,CAAC"}
+{"version":3,"file":"payload.d.ts","sourceRoot":"","sources":["../../../src/ranger/payload.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,KAAK,GAAG,EAAE,MAAM,oBAAoB,CAAC;AAE9C,iEAAiE;AACjE,eAAO,MAAM,KAAK,aAAoB,CAAC;AACvC,8BAA8B;AAC9B,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,KAAK,CAAC,CAAC;AACzC,mDAAmD;AACnD,MAAM,MAAM,MAAM,GAAG,GAAG,GAAG,IAAI,GAAG,GAAG,EAAE,GAAG,IAAI,EAAE,CAAC"}