@ntcore-ts/client 1.0.0-beta.2

package/dist/lib/struct/struct-descriptor.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Primitive type names and their byte sizes (WPILib struct schema).
+ */
+export declare const PRIMITIVE_SIZES: {
+    readonly bool: 1;
+    readonly char: 1;
+    readonly int8: 1;
+    readonly uint8: 1;
+    readonly int16: 2;
+    readonly uint16: 2;
+    readonly int32: 4;
+    readonly uint32: 4;
+    readonly int64: 8;
+    readonly uint64: 8;
+    readonly float: 4;
+    readonly float32: 4;
+    readonly double: 8;
+    readonly float64: 8;
+};
+export type PrimitiveTypeName = keyof typeof PRIMITIVE_SIZES;
+/**
+ * Descriptor for a single field in a struct (with resolved offset/size for layout).
+ */
+export interface StructFieldDescriptor {
+    name: string;
+    /** Byte offset of this field within the struct. */
+    offset: number;
+    /** Storage size in bytes for one element. */
+    size: number;
+    /** 1 for non-array, >1 for fixed-size array. */
+    arraySize: number;
+    /** 0 for non-bitfield, 1–N for bitfield width in bits. */
+    bitWidth: number;
+    /** Bit offset within the storage unit (for coalesced bitfields). */
+    bitShift: number;
+    /** For enum fields: enum name → integer value. */
+    enumValues?: Record<string, number>;
+    /** Set for primitive fields. */
+    primitive?: PrimitiveTypeName;
+    /** Set for nested struct fields (resolved descriptor). */
+    nestedDescriptor?: StructDescriptor;
+}
+/**
+ * Descriptor for a struct type: type name, total size, and ordered fields.
+ */
+export interface StructDescriptor {
+    typeName: string;
+    /** Total size in bytes. */
+    size: number;
+    fields: StructFieldDescriptor[];
+}
+/**
+ * Returns the size in bytes of a primitive type.
+ */
+export declare function getPrimitiveSize(primitive: PrimitiveTypeName): number;
+/**
+ * Returns whether the given string is a known primitive type name.
+ */
+export declare function isPrimitiveType(typeName: string): typeName is PrimitiveTypeName;
+//# sourceMappingURL=struct-descriptor.d.ts.map

package/dist/lib/struct/struct-descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"struct-descriptor.d.ts","sourceRoot":"","sources":["../../../src/lib/struct/struct-descriptor.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;CAee,CAAC;AAE5C,MAAM,MAAM,iBAAiB,GAAG,MAAM,OAAO,eAAe,CAAC;AAE7D;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,mDAAmD;IACnD,MAAM,EAAE,MAAM,CAAC;IACf,6CAA6C;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,gDAAgD;IAChD,SAAS,EAAE,MAAM,CAAC;IAClB,0DAA0D;IAC1D,QAAQ,EAAE,MAAM,CAAC;IACjB,oEAAoE;IACpE,QAAQ,EAAE,MAAM,CAAC;IACjB,kDAAkD;IAClD,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,gCAAgC;IAChC,SAAS,CAAC,EAAE,iBAAiB,CAAC;IAC9B,0DAA0D;IAC1D,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;CACrC;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,2BAA2B;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,qBAAqB,EAAE,CAAC;CACjC;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,iBAAiB,GAAG,MAAM,CAMrE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,IAAI,iBAAiB,CAE/E"}

package/dist/lib/struct/struct-parser.d.ts

@@ -0,0 +1,28 @@
+import { type StructDescriptor } from './struct-descriptor';
+export type ParsedField = {
+    typeName: string;
+    name: string;
+    arraySize: number;
+    bitWidth: number;
+    enumValues?: Record<string, number>;
+};
+/**
+ * Parses a WPILib struct schema string into a list of field declarations.
+ * @param schema - Schema string (e.g. "double x;double y" or "Translation2d translation;Rotation2d rotation").
+ * @returns Array of parsed fields.
+ * @throws Error on malformed schema.
+ */
+export declare function parseSchema(schema: string): ParsedField[];
+/**
+ * Builds a StructDescriptor from parsed fields and a resolver for nested struct sizes.
+ *
+ * Implements the WPILib `StructDescriptor.calculateOffsets()` algorithm for bitfield
+ * coalescing. Fields are densely packed with no alignment padding. Consecutive bitfields
+ * of the same underlying type share a single storage unit (e.g. two `uint8:4` fields
+ * occupy 1 byte, not 2). When the type changes or bits overflow the storage unit, a new
+ * unit starts.
+ *
+ * @see https://github.com/wpilibsuite/allwpilib — StructDescriptor.java, calculateOffsets()
+ */
+export declare function buildStructDescriptor(typeName: string, parsedFields: ParsedField[], getNestedDescriptor: (name: string) => StructDescriptor | null): StructDescriptor;
+//# sourceMappingURL=struct-parser.d.ts.map

package/dist/lib/struct/struct-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"struct-parser.d.ts","sourceRoot":"","sources":["../../../src/lib/struct/struct-parser.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,gBAAgB,EAEtB,MAAM,qBAAqB,CAAC;AAW7B,MAAM,MAAM,WAAW,GAAG;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACrC,CAAC;AA0DF;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,EAAE,CA6DzD;AA0BD;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,WAAW,EAAE,EAC3B,mBAAmB,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,gBAAgB,GAAG,IAAI,GAC7D,gBAAgB,CAiGlB"}

package/dist/lib/struct/struct-schema-manager.d.ts

@@ -0,0 +1,41 @@
+import type { StructDescriptor } from './struct-descriptor';
+import type { PubSubClient } from '../pubsub/pubsub';
+/**
+ * Manages struct schema fetching and caching from NetworkTables.
+ * Subscribes to `/.schema/struct:*` and parses/caches descriptors by type name.
+ */
+export declare class StructSchemaManager {
+    private readonly parsedFieldsCache;
+    private readonly descriptorCache;
+    private readonly schemaStringCache;
+    private readonly pendingTypeNames;
+    /** Type names for which we have already published a schema topic (avoids redundant republish). */
+    private readonly publishedSchemaTypes;
+    private readonly schemaPrefixTopic;
+    private readonly client;
+    constructor(client: PubSubClient);
+    /**
+     * Handles schema updates from the prefix topic subscription.
+     * Decodes UTF-8 bytes to string, parses schema, and caches descriptor when dependencies are ready.
+     * @param value - The value of the schema update (null when a topic is unannounced).
+     * @param params - The parameters of the announce message.
+     */
+    private handleSchemaUpdate;
+    private getNested;
+    private tryBuildPending;
+    /**
+     * Returns the struct descriptor for the given type name or type string (e.g. "Pose2d" or "struct:Pose2d").
+     * Returns null if not in cache and not a built-in (built-ins are resolved on first use).
+     */
+    fetchDescriptor(typeNameOrTypeString: string): StructDescriptor | null;
+    hasSchema(typeString: string): boolean;
+    clearCache(): void;
+    /**
+     * Publishes nested struct schemas to NetworkTables (nested first), then the given descriptor's schema.
+     * Used when publishing a struct topic so subscribers can decode.
+     */
+    addSchema(descriptor: StructDescriptor): Promise<void>;
+    private collectNestedTypeNames;
+    private publishSchemaTopic;
+}
+//# sourceMappingURL=struct-schema-manager.d.ts.map

package/dist/lib/struct/struct-schema-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"struct-schema-manager.d.ts","sourceRoot":"","sources":["../../../src/lib/struct/struct-schema-manager.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAI5D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAKrD;;;GAGG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAoC;IACtE,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAuC;IACvE,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAA6B;IAC/D,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAqB;IACtD,kGAAkG;IAClG,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAqB;IAC1D,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAA2B;IAC7D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;gBAE1B,MAAM,EAAE,YAAY;IAUhC;;;;;OAKG;IACH,OAAO,CAAC,kBAAkB;IAqB1B,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,eAAe;IAoBvB;;;OAGG;IACH,eAAe,CAAC,oBAAoB,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI;IAStE,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAItC,UAAU,IAAI,IAAI;IAQlB;;;OAGG;IACG,SAAS,CAAC,UAAU,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAe5D,OAAO,CAAC,sBAAsB;YAgBhB,kBAAkB;CAgCjC"}

package/dist/lib/types/index.d.ts

@@ -0,0 +1,2 @@
+export * from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC"}

package/dist/lib/types/schemas.d.ts

@@ -0,0 +1,269 @@
+import { z } from 'zod';
+/** Schema for an integer. */
+export declare const finiteNumSchema: z.ZodNumber;
+export declare const integerSchema: z.ZodNumber;
+/** Schema for type numbers in the NT protocol. */
+export declare const typeNumSchema: z.ZodUnion<readonly [z.ZodLiteral<0>, z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>, z.ZodLiteral<4>, z.ZodLiteral<5>, z.ZodLiteral<16>, z.ZodLiteral<17>, z.ZodLiteral<18>, z.ZodLiteral<19>, z.ZodLiteral<20>]>;
+/** Schema for type strings in the NT protocol (JSON text frames always use strings per NT 4.1 spec). */
+export declare const typeStringSchema: z.ZodUnion<readonly [z.ZodLiteral<"boolean">, z.ZodLiteral<"double">, z.ZodLiteral<"int">, z.ZodLiteral<"float">, z.ZodLiteral<"string">, z.ZodLiteral<"json">, z.ZodLiteral<"raw">, z.ZodLiteral<"rpc">, z.ZodLiteral<"msgpack">, z.ZodLiteral<"structschema">, z.ZodLiteral<"protobuf">, z.ZodLiteral<"boolean[]">, z.ZodLiteral<"double[]">, z.ZodLiteral<"int[]">, z.ZodLiteral<"float[]">, z.ZodLiteral<"string[]">, z.ZodString, z.ZodString, z.ZodString]>;
+/** Schema for topic properties in the NT protocol. */
+export declare const topicPropertiesSchema: z.ZodObject<{
+    persistent: z.ZodOptional<z.ZodBoolean>;
+    retained: z.ZodOptional<z.ZodBoolean>;
+    cached: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+/** Schema for a topic in the NT protocol. */
+export declare const topicSchema: z.ZodObject<{
+    name: z.ZodString;
+    id: z.ZodNumber;
+    type: z.ZodUnion<readonly [z.ZodLiteral<"boolean">, z.ZodLiteral<"double">, z.ZodLiteral<"int">, z.ZodLiteral<"float">, z.ZodLiteral<"string">, z.ZodLiteral<"json">, z.ZodLiteral<"raw">, z.ZodLiteral<"rpc">, z.ZodLiteral<"msgpack">, z.ZodLiteral<"structschema">, z.ZodLiteral<"protobuf">, z.ZodLiteral<"boolean[]">, z.ZodLiteral<"double[]">, z.ZodLiteral<"int[]">, z.ZodLiteral<"float[]">, z.ZodLiteral<"string[]">, z.ZodString, z.ZodString, z.ZodString]>;
+    properties: z.ZodObject<{
+        persistent: z.ZodOptional<z.ZodBoolean>;
+        retained: z.ZodOptional<z.ZodBoolean>;
+        cached: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+/** Schema for subscription options in the NT protocol. */
+export declare const subscriptionOptionsSchema: z.ZodObject<{
+    periodic: z.ZodOptional<z.ZodNumber>;
+    all: z.ZodOptional<z.ZodBoolean>;
+    topicsonly: z.ZodOptional<z.ZodBoolean>;
+    prefix: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+/** Schema for the publish message in the NT protocol. */
+export declare const publishMessageParamsSchema: z.ZodObject<{
+    name: z.ZodString;
+    pubuid: z.ZodNumber;
+    type: z.ZodUnion<readonly [z.ZodLiteral<"boolean">, z.ZodLiteral<"double">, z.ZodLiteral<"int">, z.ZodLiteral<"float">, z.ZodLiteral<"string">, z.ZodLiteral<"json">, z.ZodLiteral<"raw">, z.ZodLiteral<"rpc">, z.ZodLiteral<"msgpack">, z.ZodLiteral<"structschema">, z.ZodLiteral<"protobuf">, z.ZodLiteral<"boolean[]">, z.ZodLiteral<"double[]">, z.ZodLiteral<"int[]">, z.ZodLiteral<"float[]">, z.ZodLiteral<"string[]">, z.ZodString, z.ZodString, z.ZodString]>;
+    properties: z.ZodObject<{
+        persistent: z.ZodOptional<z.ZodBoolean>;
+        retained: z.ZodOptional<z.ZodBoolean>;
+        cached: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+/** Schema for the unpublish message params in the NT protocol. */
+export declare const unpublishMessageParamsSchema: z.ZodObject<{
+    pubuid: z.ZodNumber;
+}, z.core.$strip>;
+/** Schema for the set properties message params in the NT protocol. */
+export declare const setPropertiesMessageParamsSchema: z.ZodObject<{
+    name: z.ZodString;
+    update: z.ZodObject<{
+        persistent: z.ZodOptional<z.ZodBoolean>;
+        retained: z.ZodOptional<z.ZodBoolean>;
+        cached: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+/** Schema for the subscribe message params in the NT protocol. */
+export declare const subscribeMessageParamsSchema: z.ZodObject<{
+    topics: z.ZodArray<z.ZodString>;
+    subuid: z.ZodNumber;
+    options: z.ZodObject<{
+        periodic: z.ZodOptional<z.ZodNumber>;
+        all: z.ZodOptional<z.ZodBoolean>;
+        topicsonly: z.ZodOptional<z.ZodBoolean>;
+        prefix: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+/** Schema for the unsubscribe message params in the NT protocol. */
+export declare const unsubscribeMessageParamsSchema: z.ZodObject<{
+    subuid: z.ZodNumber;
+}, z.core.$strip>;
+/** Schema for the announce message params in the NT protocol. */
+export declare const announceMessageParamsSchema: z.ZodObject<{
+    name: z.ZodString;
+    id: z.ZodNumber;
+    type: z.ZodUnion<readonly [z.ZodLiteral<"boolean">, z.ZodLiteral<"double">, z.ZodLiteral<"int">, z.ZodLiteral<"float">, z.ZodLiteral<"string">, z.ZodLiteral<"json">, z.ZodLiteral<"raw">, z.ZodLiteral<"rpc">, z.ZodLiteral<"msgpack">, z.ZodLiteral<"structschema">, z.ZodLiteral<"protobuf">, z.ZodLiteral<"boolean[]">, z.ZodLiteral<"double[]">, z.ZodLiteral<"int[]">, z.ZodLiteral<"float[]">, z.ZodLiteral<"string[]">, z.ZodString, z.ZodString, z.ZodString]>;
+    properties: z.ZodObject<{
+        persistent: z.ZodOptional<z.ZodBoolean>;
+        retained: z.ZodOptional<z.ZodBoolean>;
+        cached: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>;
+    pubuid: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+/** Schema for the unannounce message params in the NT protocol. */
+export declare const unannounceMessageParamsSchema: z.ZodObject<{
+    name: z.ZodString;
+    id: z.ZodNumber;
+}, z.core.$strip>;
+/** Schema for the properties message params in the NT protocol. */
+export declare const propertiesMessageParamsSchema: z.ZodObject<{
+    name: z.ZodString;
+    ack: z.ZodOptional<z.ZodBoolean>;
+    update: z.ZodObject<{
+        persistent: z.ZodOptional<z.ZodBoolean>;
+        retained: z.ZodOptional<z.ZodBoolean>;
+        cached: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+/** Schema for a publish message in the NT protocol. */
+export declare const publishMessageSchema: z.ZodObject<{
+    method: z.ZodLiteral<"publish">;
+    params: z.ZodObject<{
+        name: z.ZodString;
+        pubuid: z.ZodNumber;
+        type: z.ZodUnion<readonly [z.ZodLiteral<"boolean">, z.ZodLiteral<"double">, z.ZodLiteral<"int">, z.ZodLiteral<"float">, z.ZodLiteral<"string">, z.ZodLiteral<"json">, z.ZodLiteral<"raw">, z.ZodLiteral<"rpc">, z.ZodLiteral<"msgpack">, z.ZodLiteral<"structschema">, z.ZodLiteral<"protobuf">, z.ZodLiteral<"boolean[]">, z.ZodLiteral<"double[]">, z.ZodLiteral<"int[]">, z.ZodLiteral<"float[]">, z.ZodLiteral<"string[]">, z.ZodString, z.ZodString, z.ZodString]>;
+        properties: z.ZodObject<{
+            persistent: z.ZodOptional<z.ZodBoolean>;
+            retained: z.ZodOptional<z.ZodBoolean>;
+            cached: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+/** Schema for an unpublish message in the NT protocol. */
+export declare const unpublishMessageSchema: z.ZodObject<{
+    method: z.ZodLiteral<"unpublish">;
+    params: z.ZodObject<{
+        pubuid: z.ZodNumber;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+/** Schema for a setproperties message in the NT protocol. */
+export declare const setPropertiesMessageSchema: z.ZodObject<{
+    method: z.ZodLiteral<"setproperties">;
+    params: z.ZodObject<{
+        name: z.ZodString;
+        update: z.ZodObject<{
+            persistent: z.ZodOptional<z.ZodBoolean>;
+            retained: z.ZodOptional<z.ZodBoolean>;
+            cached: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+/** Schema for a subscribe message in the NT protocol. */
+export declare const subscribeMessageSchema: z.ZodObject<{
+    method: z.ZodLiteral<"subscribe">;
+    params: z.ZodObject<{
+        topics: z.ZodArray<z.ZodString>;
+        subuid: z.ZodNumber;
+        options: z.ZodObject<{
+            periodic: z.ZodOptional<z.ZodNumber>;
+            all: z.ZodOptional<z.ZodBoolean>;
+            topicsonly: z.ZodOptional<z.ZodBoolean>;
+            prefix: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+/** Schema for an unsubscribe message in the NT protocol. */
+export declare const unsubscribeMessageSchema: z.ZodObject<{
+    method: z.ZodLiteral<"unsubscribe">;
+    params: z.ZodObject<{
+        subuid: z.ZodNumber;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+/** Schema for an announce message in the NT protocol. */
+export declare const announceMessageSchema: z.ZodObject<{
+    method: z.ZodLiteral<"announce">;
+    params: z.ZodObject<{
+        name: z.ZodString;
+        id: z.ZodNumber;
+        type: z.ZodUnion<readonly [z.ZodLiteral<"boolean">, z.ZodLiteral<"double">, z.ZodLiteral<"int">, z.ZodLiteral<"float">, z.ZodLiteral<"string">, z.ZodLiteral<"json">, z.ZodLiteral<"raw">, z.ZodLiteral<"rpc">, z.ZodLiteral<"msgpack">, z.ZodLiteral<"structschema">, z.ZodLiteral<"protobuf">, z.ZodLiteral<"boolean[]">, z.ZodLiteral<"double[]">, z.ZodLiteral<"int[]">, z.ZodLiteral<"float[]">, z.ZodLiteral<"string[]">, z.ZodString, z.ZodString, z.ZodString]>;
+        properties: z.ZodObject<{
+            persistent: z.ZodOptional<z.ZodBoolean>;
+            retained: z.ZodOptional<z.ZodBoolean>;
+            cached: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>;
+        pubuid: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+/** Schema for an unannounce message in the NT protocol. */
+export declare const unannounceMessageSchema: z.ZodObject<{
+    method: z.ZodLiteral<"unannounce">;
+    params: z.ZodObject<{
+        name: z.ZodString;
+        id: z.ZodNumber;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+/** Schema for a properties message in the NT protocol. */
+export declare const propertiesMessageSchema: z.ZodObject<{
+    method: z.ZodLiteral<"properties">;
+    params: z.ZodObject<{
+        name: z.ZodString;
+        ack: z.ZodOptional<z.ZodBoolean>;
+        update: z.ZodObject<{
+            persistent: z.ZodOptional<z.ZodBoolean>;
+            retained: z.ZodOptional<z.ZodBoolean>;
+            cached: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+/** Schema for a text frame message in the NT protocol. */
+export declare const messageSchema: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+    method: z.ZodLiteral<"publish">;
+    params: z.ZodObject<{
+        name: z.ZodString;
+        pubuid: z.ZodNumber;
+        type: z.ZodUnion<readonly [z.ZodLiteral<"boolean">, z.ZodLiteral<"double">, z.ZodLiteral<"int">, z.ZodLiteral<"float">, z.ZodLiteral<"string">, z.ZodLiteral<"json">, z.ZodLiteral<"raw">, z.ZodLiteral<"rpc">, z.ZodLiteral<"msgpack">, z.ZodLiteral<"structschema">, z.ZodLiteral<"protobuf">, z.ZodLiteral<"boolean[]">, z.ZodLiteral<"double[]">, z.ZodLiteral<"int[]">, z.ZodLiteral<"float[]">, z.ZodLiteral<"string[]">, z.ZodString, z.ZodString, z.ZodString]>;
+        properties: z.ZodObject<{
+            persistent: z.ZodOptional<z.ZodBoolean>;
+            retained: z.ZodOptional<z.ZodBoolean>;
+            cached: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    method: z.ZodLiteral<"unpublish">;
+    params: z.ZodObject<{
+        pubuid: z.ZodNumber;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    method: z.ZodLiteral<"setproperties">;
+    params: z.ZodObject<{
+        name: z.ZodString;
+        update: z.ZodObject<{
+            persistent: z.ZodOptional<z.ZodBoolean>;
+            retained: z.ZodOptional<z.ZodBoolean>;
+            cached: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    method: z.ZodLiteral<"subscribe">;
+    params: z.ZodObject<{
+        topics: z.ZodArray<z.ZodString>;
+        subuid: z.ZodNumber;
+        options: z.ZodObject<{
+            periodic: z.ZodOptional<z.ZodNumber>;
+            all: z.ZodOptional<z.ZodBoolean>;
+            topicsonly: z.ZodOptional<z.ZodBoolean>;
+            prefix: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    method: z.ZodLiteral<"unsubscribe">;
+    params: z.ZodObject<{
+        subuid: z.ZodNumber;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    method: z.ZodLiteral<"announce">;
+    params: z.ZodObject<{
+        name: z.ZodString;
+        id: z.ZodNumber;
+        type: z.ZodUnion<readonly [z.ZodLiteral<"boolean">, z.ZodLiteral<"double">, z.ZodLiteral<"int">, z.ZodLiteral<"float">, z.ZodLiteral<"string">, z.ZodLiteral<"json">, z.ZodLiteral<"raw">, z.ZodLiteral<"rpc">, z.ZodLiteral<"msgpack">, z.ZodLiteral<"structschema">, z.ZodLiteral<"protobuf">, z.ZodLiteral<"boolean[]">, z.ZodLiteral<"double[]">, z.ZodLiteral<"int[]">, z.ZodLiteral<"float[]">, z.ZodLiteral<"string[]">, z.ZodString, z.ZodString, z.ZodString]>;
+        properties: z.ZodObject<{
+            persistent: z.ZodOptional<z.ZodBoolean>;
+            retained: z.ZodOptional<z.ZodBoolean>;
+            cached: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>;
+        pubuid: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    method: z.ZodLiteral<"unannounce">;
+    params: z.ZodObject<{
+        name: z.ZodString;
+        id: z.ZodNumber;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    method: z.ZodLiteral<"properties">;
+    params: z.ZodObject<{
+        name: z.ZodString;
+        ack: z.ZodOptional<z.ZodBoolean>;
+        update: z.ZodObject<{
+            persistent: z.ZodOptional<z.ZodBoolean>;
+            retained: z.ZodOptional<z.ZodBoolean>;
+            cached: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>;
+    }, z.core.$strip>;
+}, z.core.$strip>], "method">>;
+/** Schema for a value in the msgpack format. */
+export declare const msgPackValueSchema: z.ZodUnion<readonly [z.ZodBoolean, z.ZodNumber, z.ZodNumber, z.ZodString, z.ZodCustom<Uint8Array<ArrayBufferLike>, Uint8Array<ArrayBufferLike>>, z.ZodArray<z.ZodBoolean>, z.ZodArray<z.ZodString>, z.ZodArray<z.ZodNumber>, z.ZodArray<z.ZodNumber>]>;
+/** Schema for a binary message in the msgpack format. */
+export declare const msgPackSchema: z.ZodTuple<[z.ZodUnion<readonly [z.ZodNumber, z.ZodLiteral<-1>]>, z.ZodNumber, z.ZodUnion<readonly [z.ZodLiteral<0>, z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>, z.ZodLiteral<4>, z.ZodLiteral<5>, z.ZodLiteral<16>, z.ZodLiteral<17>, z.ZodLiteral<18>, z.ZodLiteral<19>, z.ZodLiteral<20>]>, z.ZodUnion<readonly [z.ZodBoolean, z.ZodNumber, z.ZodNumber, z.ZodString, z.ZodCustom<Uint8Array<ArrayBufferLike>, Uint8Array<ArrayBufferLike>>, z.ZodArray<z.ZodBoolean>, z.ZodArray<z.ZodString>, z.ZodArray<z.ZodNumber>, z.ZodArray<z.ZodNumber>]>], null>;
+//# sourceMappingURL=schemas.d.ts.map

package/dist/lib/types/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../src/lib/types/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,6BAA6B;AAC7B,eAAO,MAAM,eAAe,aAAa,CAAC;AAC1C,eAAO,MAAM,aAAa,aAAwB,CAAC;AAEnD,kDAAkD;AAClD,eAAO,MAAM,aAAa,uNAYxB,CAAC;AAEH,wGAAwG;AACxG,eAAO,MAAM,gBAAgB,mcAoB3B,CAAC;AAEH,sDAAsD;AACtD,eAAO,MAAM,qBAAqB;;;;iBAMtB,CAAC;AAEb,6CAA6C;AAC7C,eAAO,MAAM,WAAW;;;;;;;;;iBAKtB,CAAC;AAEH,0DAA0D;AAC1D,eAAO,MAAM,yBAAyB;;;;;iBAO1B,CAAC;AAEb,yDAAyD;AACzD,eAAO,MAAM,0BAA0B;;;;;;;;;iBAKrC,CAAC;AAEH,kEAAkE;AAClE,eAAO,MAAM,4BAA4B;;iBAEvC,CAAC;AAEH,uEAAuE;AACvE,eAAO,MAAM,gCAAgC;;;;;;;iBAG3C,CAAC;AAEH,kEAAkE;AAClE,eAAO,MAAM,4BAA4B;;;;;;;;;iBAIvC,CAAC;AAEH,oEAAoE;AACpE,eAAO,MAAM,8BAA8B;;iBAEzC,CAAC;AAEH,iEAAiE;AACjE,eAAO,MAAM,2BAA2B;;;;;;;;;;iBAEtC,CAAC;AAEH,mEAAmE;AACnE,eAAO,MAAM,6BAA6B;;;iBAGxC,CAAC;AAEH,mEAAmE;AACnE,eAAO,MAAM,6BAA6B;;;;;;;;iBAIxC,CAAC;AAEH,uDAAuD;AACvD,eAAO,MAAM,oBAAoB;;;;;;;;;;;;iBAG/B,CAAC;AAEH,0DAA0D;AAC1D,eAAO,MAAM,sBAAsB;;;;;iBAGjC,CAAC;AAEH,6DAA6D;AAC7D,eAAO,MAAM,0BAA0B;;;;;;;;;;iBAGrC,CAAC;AAEH,yDAAyD;AACzD,eAAO,MAAM,sBAAsB;;;;;;;;;;;;iBAGjC,CAAC;AAEH,4DAA4D;AAC5D,eAAO,MAAM,wBAAwB;;;;;iBAGnC,CAAC;AAEH,yDAAyD;AACzD,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;iBAGhC,CAAC;AAEH,2DAA2D;AAC3D,eAAO,MAAM,uBAAuB;;;;;;iBAGlC,CAAC;AAEH,0DAA0D;AAC1D,eAAO,MAAM,uBAAuB;;;;;;;;;;;iBAGlC,CAAC;AAEH,0DAA0D;AAC1D,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;8BAWzB,CAAC;AAEF,gDAAgD;AAChD,eAAO,MAAM,kBAAkB,wPAU7B,CAAC;AAEH,yDAAyD;AACzD,eAAO,MAAM,aAAa,siBAKxB,CAAC"}

package/dist/lib/types/types.d.ts

@@ -0,0 +1,66 @@
+import { z } from 'zod';
+import type { typeStringSchema, announceMessageSchema, msgPackSchema, msgPackValueSchema, propertiesMessageSchema, publishMessageSchema, setPropertiesMessageSchema, subscribeMessageSchema, subscriptionOptionsSchema, topicPropertiesSchema, unannounceMessageSchema, unpublishMessageSchema, unsubscribeMessageSchema, typeNumSchema } from './schemas';
+export type TypeString = z.infer<typeof typeStringSchema>;
+export type TypeNum = z.infer<typeof typeNumSchema>;
+export type NetworkTablesTypeInfo = [TypeNum, TypeString];
+export type PublishMessage = z.infer<typeof publishMessageSchema>;
+export type UnpublishMessage = z.infer<typeof unpublishMessageSchema>;
+export type SetPropertiesMessage = z.infer<typeof setPropertiesMessageSchema>;
+export type SubscribeMessage = z.infer<typeof subscribeMessageSchema>;
+export type SubscribeOptions = z.infer<typeof subscriptionOptionsSchema> & {
+    /**
+     * If true, invoke the callback once with the current value after registering.
+     * This is a client-side option and is not sent to the NT server.
+     */
+    immediateNotify?: boolean;
+};
+export type UnsubscribeMessage = z.infer<typeof unsubscribeMessageSchema>;
+export type AnnounceMessage = z.infer<typeof announceMessageSchema>;
+export type UnannounceMessage = z.infer<typeof unannounceMessageSchema>;
+export type PropertiesMessage = z.infer<typeof propertiesMessageSchema>;
+export type Message = PublishMessage | UnpublishMessage | SetPropertiesMessage | SubscribeMessage | UnsubscribeMessage | AnnounceMessage | UnannounceMessage | PropertiesMessage;
+export type PublishMessageParams = PublishMessage['params'];
+export type UnpublishMessageParams = UnpublishMessage['params'];
+export type SetPropertiesMessageParams = SetPropertiesMessage['params'];
+export type SubscribeMessageParams = SubscribeMessage['params'];
+export type UnsubscribeMessageParams = UnsubscribeMessage['params'];
+export type AnnounceMessageParams = AnnounceMessage['params'];
+export type UnannounceMessageParams = UnannounceMessage['params'];
+export type PropertiesMessageParams = PropertiesMessage['params'];
+export type NetworkTablesTypes = z.infer<typeof msgPackValueSchema>;
+export type BinaryMessage = z.infer<typeof msgPackSchema>;
+export type TopicProperties = z.infer<typeof topicPropertiesSchema>;
+export declare class NetworkTablesTypeInfos {
+    static readonly kBoolean: NetworkTablesTypeInfo;
+    static readonly kDouble: NetworkTablesTypeInfo;
+    static readonly kInteger: NetworkTablesTypeInfo;
+    static readonly kFloat: NetworkTablesTypeInfo;
+    static readonly kString: NetworkTablesTypeInfo;
+    static readonly kJson: [4, "json"];
+    static readonly kUint8Array: NetworkTablesTypeInfo;
+    static readonly kRPC: NetworkTablesTypeInfo;
+    static readonly kMsgpack: NetworkTablesTypeInfo;
+    static readonly kProtobuf: NetworkTablesTypeInfo;
+    /** Type info for struct schema topics (/.schema/struct:TypeName). Wire type 5 (raw bytes), type string 'structschema'. */
+    static readonly kStructSchema: NetworkTablesTypeInfo;
+    static readonly kBooleanArray: NetworkTablesTypeInfo;
+    static readonly kDoubleArray: NetworkTablesTypeInfo;
+    static readonly kIntegerArray: NetworkTablesTypeInfo;
+    static readonly kFloatArray: NetworkTablesTypeInfo;
+    static readonly kStringArray: NetworkTablesTypeInfo;
+    /**
+     * Validates and parses a value based on the expected NetworkTables type information.
+     * @param expectedTypeInfo - The expected type information from `NetworkTablesTypeInfo`.
+     * @param value - The value to validate and parse.
+     * @returns The parsed value, matching the expected type.
+     * @throws Will throw an error if the value does not match the expected type or if parsing fails.
+     */
+    static validateData(expectedTypeInfo: NetworkTablesTypeInfo, value: NetworkTablesTypes): NetworkTablesTypes;
+}
+export interface BinaryMessageData {
+    topicId: number;
+    serverTime: number;
+    typeNum: TypeNum;
+    value: NetworkTablesTypes;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/lib/types/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/lib/types/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,KAAK,EACV,gBAAgB,EAChB,qBAAqB,EACrB,aAAa,EACb,kBAAkB,EAClB,uBAAuB,EACvB,oBAAoB,EACpB,0BAA0B,EAC1B,sBAAsB,EACtB,yBAAyB,EACzB,qBAAqB,EACrB,uBAAuB,EACvB,sBAAsB,EACtB,wBAAwB,EACxB,aAAa,EACd,MAAM,WAAW,CAAC;AAEnB,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAC1D,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AACpD,MAAM,MAAM,qBAAqB,GAAG,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;AAE1D,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AACtE,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAC9E,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AACtE,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,GAAG;IACzE;;;OAGG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B,CAAC;AACF,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAC1E,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACpE,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AACxE,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE,MAAM,MAAM,OAAO,GACf,cAAc,GACd,gBAAgB,GAChB,oBAAoB,GACpB,gBAAgB,GAChB,kBAAkB,GAClB,eAAe,GACf,iBAAiB,GACjB,iBAAiB,CAAC;AAEtB,MAAM,MAAM,oBAAoB,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;AAC5D,MAAM,MAAM,sBAAsB,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;AAChE,MAAM,MAAM,0BAA0B,GAAG,oBAAoB,CAAC,QAAQ,CAAC,CAAC;AACxE,MAAM,MAAM,sBAAsB,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;AAChE,MAAM,MAAM,wBAAwB,GAAG,kBAAkB,CAAC,QAAQ,CAAC,CAAC;AACpE,MAAM,MAAM,qBAAqB,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC;AAC9D,MAAM,MAAM,uBAAuB,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAC;AAClE,MAAM,MAAM,uBAAuB,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAC;AAElE,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AACpE,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAC1D,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,qBAAa,sBAAsB;IACjC,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,qBAAqB,CAAkB;IACjE,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,qBAAqB,CAAiB;IAC/D,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,qBAAqB,CAAc;IAC7D,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,qBAAqB,CAAgB;IAC7D,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,qBAAqB,CAAiB;IAC/D,MAAM,CAAC,QAAQ,CAAC,KAAK,cAAwD;IAC7E,MAAM,CAAC,QAAQ,CAAC,WAAW,EAAE,qBAAqB,CAAc;IAChE,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAAc;IACzD,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,qBAAqB,CAAkB;IACjE,MAAM,CAAC,QAAQ,CAAC,SAAS,EAAE,qBAAqB,CAAmB;IACnE,0HAA0H;IAC1H,MAAM,CAAC,QAAQ,CAAC,aAAa,EAAE,qBAAqB,CAAuB;IAC3E,MAAM,CAAC,QAAQ,CAAC,aAAa,EAAE,qBAAqB,CAAqB;IACzE,MAAM,CAAC,QAAQ,CAAC,YAAY,EAAE,qBAAqB,CAAoB;IACvE,MAAM,CAAC,QAAQ,CAAC,aAAa,EAAE,qBAAqB,CAAiB;IACrE,MAAM,CAAC,QAAQ,CAAC,WAAW,EAAE,qBAAqB,CAAmB;IACrE,MAAM,CAAC,QAAQ,CAAC,YAAY,EAAE,qBAAqB,CAAoB;IAEvE;;;;;;OAMG;IACH,MAAM,CAAC,YAAY,CAAC,gBAAgB,EAAE,qBAAqB,EAAE,KAAK,EAAE,kBAAkB,GAAG,kBAAkB;CAsF5G;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,kBAAkB,CAAC;CAC3B"}

package/dist/lib/util/logger.d.ts

@@ -0,0 +1,60 @@
+import { Logger, type ILogObj } from 'tslog';
+/**
+ * Log levels available for configuration.
+ * These map to tslog's log levels:
+ * - TRACE = 1 (tslog's trace)
+ * - DEBUG = 2 (tslog's debug)
+ * - INFO = 3 (tslog's info)
+ * - WARN = 4 (tslog's warn)
+ * - ERROR = 5 (tslog's error)
+ * - FATAL = 6 (tslog's fatal)
+ * - SILENT = 99 (disable all logging, not a tslog level)
+ */
+export declare enum LogLevel {
+    /** Very detailed debugging information (maps to tslog's trace level 1) */
+    TRACE = 1,
+    /** Detailed debugging information (maps to tslog's debug level 2) */
+    DEBUG = 2,
+    /** General informational messages (maps to tslog's info level 3) */
+    INFO = 3,
+    /** Warning messages (maps to tslog's warn level 4) */
+    WARN = 4,
+    /** Error messages (maps to tslog's error level 5) */
+    ERROR = 5,
+    /** Fatal error messages (maps to tslog's fatal level 6) */
+    FATAL = 6,
+    /** Disable all logging (uses 99, not a tslog level) */
+    SILENT = 99
+}
+/**
+ * Module names for granular logging control.
+ */
+export type LoggerModule = 'socket' | 'messenger' | 'pubsub' | 'default';
+/**
+ * Gets or creates a logger instance for a specific module.
+ * @param module - The module name.
+ * @returns A logger instance configured for the module.
+ */
+export declare function getLogger(module?: LoggerModule): Logger<ILogObj>;
+/**
+ * Sets the log level for all loggers.
+ * @param level - The log level to set.
+ */
+export declare function setLogLevel(level: LogLevel): void;
+/**
+ * Sets the log level for a specific module.
+ * @param module - The module name.
+ * @param level - The log level to set.
+ */
+export declare function setModuleLogLevel(module: LoggerModule, level: LogLevel): void;
+/**
+ * Gets the current log level for a specific module.
+ * @param module - The module name.
+ * @returns The current log level.
+ */
+export declare function getModuleLogLevel(module?: LoggerModule): LogLevel;
+export declare const socketLogger: Logger<ILogObj>;
+export declare const messengerLogger: Logger<ILogObj>;
+export declare const pubsubLogger: Logger<ILogObj>;
+export declare const defaultLogger: Logger<ILogObj>;
+//# sourceMappingURL=logger.d.ts.map

package/dist/lib/util/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../src/lib/util/logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,KAAK,OAAO,EAAE,MAAM,OAAO,CAAC;AAE7C;;;;;;;;;;GAUG;AACH,oBAAY,QAAQ;IAClB,0EAA0E;IAC1E,KAAK,IAAI;IACT,qEAAqE;IACrE,KAAK,IAAI;IACT,oEAAoE;IACpE,IAAI,IAAI;IACR,sDAAsD;IACtD,IAAI,IAAI;IACR,qDAAqD;IACrD,KAAK,IAAI;IACT,2DAA2D;IAC3D,KAAK,IAAI;IACT,uDAAuD;IACvD,MAAM,KAAK;CACZ;AAED;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAC;AA2BzE;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,MAAM,GAAE,YAAwB,GAAG,MAAM,CAAC,OAAO,CAAC,CAS3E;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,CAYjD;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,QAAQ,GAAG,IAAI,CAS7E;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,GAAE,YAAwB,GAAG,QAAQ,CAe5E;AAwBD,eAAO,MAAM,YAAY,iBAA8B,CAAC;AACxD,eAAO,MAAM,eAAe,iBAAiC,CAAC;AAC9D,eAAO,MAAM,YAAY,iBAA8B,CAAC;AACxD,eAAO,MAAM,aAAa,iBAA+B,CAAC"}

package/dist/lib/util/util.d.ts

@@ -0,0 +1,68 @@
+import type { BinaryMessage, NetworkTablesTypeInfo, NetworkTablesTypes } from '../types/types';
+/** Robot controller used to resolve a team number to a hostname. */
+export type RobotPlatform = 'roborio' | 'systemcore';
+/** SystemCore mDNS name (WPILib `SetServerFixed`). Use as a URI, not as a team mapping. */
+export declare const SYSTEMCORE_MDNS_HOST = "robot.local";
+/**
+ * Field/radio IPv4 for a team (`10.TE.AM.2`), matching WPILib `SetServerTeam`.
+ * Team 973 → `10.9.73.2`.
+ */
+export declare function getTeamIpAddress(team: number): string;
+/**
+ * Hostname used for a team-number connection.
+ * RoboRIO (default): `roborio-{team}-frc.local`.
+ * SystemCore: `10.TE.AM.2` (WPILib `SetServerTeam`). Use {@link SYSTEMCORE_MDNS_HOST} as a URI for `robot.local`.
+ */
+export declare function getRobotAddress(team: number, platform?: RobotPlatform): string;
+export type ParsedRobotAddress = {
+    platform: 'roborio';
+    team: number;
+} | {
+    platform: 'systemcore';
+    team: number;
+} | {
+    platform: null;
+    team: null;
+};
+/** Detects a RoboRIO mDNS name or SystemCore team IP. Other hosts return `{ platform: null, team: null }`. */
+export declare function parseRobotAddress(host: string): ParsedRobotAddress;
+/**
+ * Class for holding utility functions.
+ */
+export declare class Util {
+    /**
+     * Get the DOM time in microseconds.
+     * @returns The current microseconds of the DOM.
+     */
+    static getMicros(): number;
+    /**
+     * Given a number, determine if it is a double
+     * @param x - A number.
+     * @returns Whether it is a double.
+     */
+    static isDouble(x: number): boolean;
+    /**
+     * Create a binary message from a topic.
+     * @param pubuid - The topic's publisher UID.
+     * @param timestamp - The timestamp of the message, matching the server.
+     * @param data - The data.
+     * @param typeInfo - The type info.
+     * @returns The binary message.
+     */
+    static createBinaryMessage(pubuid: number, timestamp: number, data: NetworkTablesTypes, typeInfo: NetworkTablesTypeInfo): BinaryMessage;
+    /**
+     * Create a server URL for connecting to the robot.
+     * @param uri - The URI of the robot.
+     * @param port - The port of NT server on the robot.
+     * @returns The server URL with a unique client ID.
+     */
+    static createServerUrl(uri: string, port: number): string;
+    /**
+     * Get the hostname of a robot for a team number.
+     * @param team - The team number.
+     * @param platform - RoboRIO mDNS (default) or SystemCore team IP.
+     * @returns The hostname or IPv4 address.
+     */
+    static getRobotAddress(team: number, platform?: RobotPlatform): string;
+}
+//# sourceMappingURL=util.d.ts.map

package/dist/lib/util/util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../../../src/lib/util/util.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAE/F,oEAAoE;AACpE,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,YAAY,CAAC;AAErD,2FAA2F;AAC3F,eAAO,MAAM,oBAAoB,gBAAgB,CAAC;AAQlD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAMrD;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,GAAE,aAAyB,GAAG,MAAM,CAKzF;AAED,MAAM,MAAM,kBAAkB,GAC5B;IAAE,QAAQ,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,QAAQ,EAAE,YAAY,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,QAAQ,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,IAAI,CAAA;CAAE,CAAC;AAEpH,8GAA8G;AAC9G,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,CAiBlE;AAED;;GAEG;AACH,qBAAa,IAAI;IACf;;;OAGG;IACH,MAAM,CAAC,SAAS;IAIhB;;;;OAIG;IACH,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,MAAM;IAQzB;;;;;;;OAOG;IACH,MAAM,CAAC,mBAAmB,CACxB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,kBAAkB,EACxB,QAAQ,EAAE,qBAAqB,GAC9B,aAAa;IAIhB;;;;;OAKG;IACH,MAAM,CAAC,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM;IAIzD;;;;;OAKG;IACH,MAAM,CAAC,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,GAAE,aAAyB,GAAG,MAAM;CAGlF"}