@2702rebels/ntcore 1.0.0 → 1.0.1

package/dist/index.d.mts

@@ -6,26 +6,26 @@
  */
 type TopicProperties = Record<string, unknown> & {
   /**
-   * **Persistent flag**
-   *
-   * If `true`, the last set value will be periodically saved to persistent storage on the server
-   * and be restored during server startup. Topics with this property set to `true` will not
-   * be deleted by the server when the last publisher stops publishing.
-   */
+       * **Persistent flag**
+       *
+       * If `true`, the last set value will be periodically saved to persistent storage on the server
+       * and be restored during server startup. Topics with this property set to `true` will not
+       * be deleted by the server when the last publisher stops publishing.
+       */
   persistent?: boolean;
   /**
-   * **Retained flag**
-   *
-   * Topics with this property set to `true` will not be deleted by the server when
-   * the last publisher stops publishing.
-   */
+       * **Retained flag**
+       *
+       * Topics with this property set to `true` will not be deleted by the server when
+       * the last publisher stops publishing.
+       */
   retained?: boolean;
   /**
-   * **Cached flag**
-   *
-   * If `false`, the server and clients will not store the value of the topic.
-   * This means that only value updates will be available for the topic.
-   */
+       * **Cached flag**
+       *
+       * If `false`, the server and clients will not store the value of the topic.
+       * This means that only value updates will be available for the topic.
+       */
   cached?: boolean;
 };
 /**
@@ -33,34 +33,34 @@ type TopicProperties = Record<string, unknown> & {
  */
 type SubscriptionOptions = Record<string, unknown> & {
   /**
-   * **Periodic sweep time (in seconds)**
-   *
-   * How frequently the server should send changes. The server may send more frequently than this
-   * (e.g. use a combined minimum period for all values) or apply a restricted range to this value
-   * The default if unspecified is 100 ms (same as NT 3.0).
-   */
+       * **Periodic sweep time (in seconds)**
+       *
+       * How frequently the server should send changes. The server may send more frequently than this
+       * (e.g. use a combined minimum period for all values) or apply a restricted range to this value
+       * The default if unspecified is 100 ms (same as NT 3.0).
+       */
   periodic?: number;
   /**
-   * **All changes flag**
-   *
-   * If `true`, the server should send all value changes over the wire. If `false`, only
-   * the most recent value is sent (same as NT 3.0 behavior). If not specified, defaults to `false`.
-   */
+       * **All changes flag**
+       *
+       * If `true`, the server should send all value changes over the wire. If `false`, only
+       * the most recent value is sent (same as NT 3.0 behavior). If not specified, defaults to `false`.
+       */
   all?: boolean;
   /**
-   * **No value changes flag**
-   *
-   * If `true`, the server should not send any value changes over the wire regardless of other options.
-   * This is useful for only getting topic announcements. If `false`, value changes are sent in accordance
-   * with other options. If not specified, defaults to `false`.
-   */
+       * **No value changes flag**
+       *
+       * If `true`, the server should not send any value changes over the wire regardless of other options.
+       * This is useful for only getting topic announcements. If `false`, value changes are sent in accordance
+       * with other options. If not specified, defaults to `false`.
+       */
   topicsonly?: boolean;
   /**
-   * **Prefix flag**
-   *
-   * If `true`, any topic starting with the name in the subscription topics list is subscribed to,
-   * not just exact matches. If not specified, defaults to `false`.
-   */
+       * **Prefix flag**
+       *
+       * If `true`, any topic starting with the name in the subscription topics list is subscribed to,
+       * not just exact matches. If not specified, defaults to `false`.
+       */
   prefix?: boolean;
 };
 //#endregion
@@ -102,12 +102,13 @@ declare class NT4Topic {
   removeRetainedValue(): void;
   /** Resets retained value timestamp except for "weak" default value. */
   resetRetainedTimestamp(): void;
+  /** Determines whether topic can accept the specified value. */
+  canAccept(value: unknown): boolean;
   /** Topic type code. For internal use only. */
   readonly typeCode: number;
 }
 //#endregion
 //#region src/NT4Spec.d.ts
-
 /**
  * Supported data types mapped to protocol identifiers.
  *
@@ -135,57 +136,56 @@ type DataType = keyof typeof DataTypeCodes;
 //#region src/NT4Client.d.ts
 type NT4ClientConnectionState = "disconnected" | "connecting" | "connected";
 type NT4ClientOptions = {
-  /** Indicates that secure channel should be used. */
-  secure?: boolean;
+  /** Indicates that secure channel should be used. */secure?: boolean;
   /**
-   * Invoked when the client connects.
-   */
+       * Invoked when the client connects.
+       */
   onConnect?: () => void;
   /**
-   * Invoked when the client disconnects.
-   */
+       * Invoked when the client disconnects.
+       */
   onDisconnect?: () => void;
   /**
-   * Invoked when new topic is announced by the server.
-   *
-   * @param topic topic announced
-   */
+       * Invoked when new topic is announced by the server.
+       *
+       * @param topic topic announced
+       */
   onTopicAnnounced?: (topic: NT4Topic) => void;
   /**
-   * Invoked when a topic is removed by the server.
-   *
-   * @param topic topic removed
-   */
+       * Invoked when a topic is removed by the server.
+       *
+       * @param topic topic removed
+       */
   onTopicRemoved?: (topic: NT4Topic) => void;
   /**
-   * Invoked when a topic properties are updated by the server.
-   *
-   * @param topic topic updated
-   */
+       * Invoked when a topic properties are updated by the server.
+       *
+       * @param topic topic updated
+       */
   onTopicUpdated?: (topic: NT4Topic) => void;
   /**
-   * Invoked when the topic receives new data.
-   *
-   * @param topic topic receiving data
-   * @param value value received
-   * @param timestamp server timestamp in microseconds
-   */
+       * Invoked when the topic receives new data.
+       *
+       * @param topic topic receiving data
+       * @param value value received
+       * @param timestamp server timestamp in microseconds
+       */
   onDataReceived?: (topic: NT4Topic, value: unknown, timestamp: number) => void;
   /**
-   * Retry policy that accepts the current number of connection attempts
-   * and returns the timeout in milliseconds or -1 to abort.
-   *
-   * @param attempts number of subsequent connection attempts
-   * @returns timeout in milliseconds or -1 to abort
-   */
+       * Retry policy that accepts the current number of connection attempts
+       * and returns the timeout in milliseconds or -1 to abort.
+       *
+       * @param attempts number of subsequent connection attempts
+       * @returns timeout in milliseconds or -1 to abort
+       */
   retryPolicy?: (attempts: number) => number;
   /**
-   * Overrides default timeout for ping-pong packets.
-   *
-   * Defaults:
-   * - NT 4.0: 3000 milliseconds
-   * - NT 4.1: 1000 milliseconds
-   */
+       * Overrides default timeout for ping-pong packets.
+       *
+       * Defaults:
+       * - NT 4.0: 3000 milliseconds
+       * - NT 4.1: 1000 milliseconds
+       */
   pingTimeoutMilliseconds?: number;
 };
 /**
@@ -251,14 +251,14 @@ declare class NT4Client {
   /** Sends data frame to update topic value. */
   private sendValueCore;
   /**
-   * Sends RTT measurement binary frame.
-   * Uses RTT channel if available, falls back to data channel in NT4.0.
-   */
+       * Sends RTT measurement binary frame.
+       * Uses RTT channel if available, falls back to data channel in NT4.0.
+       */
   private sendRTT;
   /**
-   * Determines whether connection times out if no message has been received
-   * within the timeout interval since the last pong.
-   */
+       * Determines whether connection times out if no message has been received
+       * within the timeout interval since the last pong.
+       */
   private checkTimeout;
   /** Generates random UID. */
   private generateUID;
@@ -269,158 +269,158 @@ declare class NT4Client {
   /** Determines whether subscription with the specified identifier exists. */
   private readonly hasSubscriptionWithId;
   /**
-   * Constructs an instance of NT4Client without initiating a connection.
-   *
-   * @param serverAddress NT4 server network address
-   * @param clientId this client identifier (cannot contain '@')
-   * @param options options
-   */
+       * Constructs an instance of NT4Client without initiating a connection.
+       *
+       * @param serverAddress NT4 server network address
+       * @param clientId this client identifier (cannot contain '@')
+       * @param options options
+       */
   constructor(serverAddress: string, clientId: string, options: NT4ClientOptions);
   /**
-   * Returns NT4 server network address the client is using.
-   */
+       * Returns NT4 server network address the client is using.
+       */
   readonly serverAddress: string;
   /**
-   * Returns current connection state.
-   */
+       * Returns current connection state.
+       */
   get state(): NT4ClientConnectionState;
   /**
-   * Returns current network latency in microseconds if known.
-   */
+       * Returns current network latency in microseconds if known.
+       */
   get networkLatencyMicroseconds(): number | null;
   /**
-   * Returns server time in microseconds that is current or
-   * based on the specified client (local) time.
-   *
-   * Returns `null` if the server time offset is not established.
-   */
+       * Returns server time in microseconds that is current or
+       * based on the specified client (local) time.
+       *
+       * Returns `null` if the server time offset is not established.
+       */
   serverTimeMicroseconds(clientTimeMicroseconds?: number): number | null;
   /**
-   * Initiates the connection.
-   * Once established the connection will be automatically kept alive by reconnecting.
-   */
+       * Initiates the connection.
+       * Once established the connection will be automatically kept alive by reconnecting.
+       */
   connect(): void;
   /**
-   * Terminates the connection.
-   * The client can be reconnected manually by calling {@link connect} again.
-   */
+       * Terminates the connection.
+       * The client can be reconnected manually by calling {@link connect} again.
+       */
   disconnect(): void;
   /**
-   * Creates a new subscription.
-   *
-   * The subscription can be created regardless of connectivity state.
-   * All client subscriptions are automatically restored once connection
-   * has been established. This is also true for reconnects following
-   * loss of connectivity or deliberate disconnects.
-   *
-   * Caller can {@link unsubscribe} by passing the return value of this call or
-   * invoke {@link unsubscribeAll} to remove all existing client subscriptions.
-   *
-   * @param topics topics or prefixes to include in the subscription
-   * @param options subscription options
-   * @returns A subscription instance
-   */
+       * Creates a new subscription.
+       *
+       * The subscription can be created regardless of connectivity state.
+       * All client subscriptions are automatically restored once connection
+       * has been established. This is also true for reconnects following
+       * loss of connectivity or deliberate disconnects.
+       *
+       * Caller can {@link unsubscribe} by passing the return value of this call or
+       * invoke {@link unsubscribeAll} to remove all existing client subscriptions.
+       *
+       * @param topics topics or prefixes to include in the subscription
+       * @param options subscription options
+       * @returns A subscription instance
+       */
   subscribe(topics: Iterable<string>, options: SubscriptionOptions): NT4Subscription;
   /**
-   * Unsubscribes an existing subscription.
-   *
-   * @param arg subscription or subscription identifier
-   * @returns `true` if the subscription was successfully unsubscribed, `false` if the subscription was not found
-   */
+       * Unsubscribes an existing subscription.
+       *
+       * @param arg subscription or subscription identifier
+       * @returns `true` if the subscription was successfully unsubscribed, `false` if the subscription was not found
+       */
   unsubscribe(arg: NT4Subscription | number): boolean;
   /**
-   * Unsubscribes all existing subscriptions.
-   */
+       * Unsubscribes all existing subscriptions.
+       */
   unsubscribeAll(): void;
   /**
-   * Publishes a topic with the specified name and type.
-   *
-   * This method registers this client as a publisher for the topic.
-   * It should be called before {@link setValue} or {@link setValueAt}
-   * can be used.
-   *
-   * Publishing a topic on a disconnected client is allowed.
-   * Client will automatically register such publishers once the connection
-   * has been established and send default or retained value as appropriate.
-   *
-   * @param topic topic name
-   * @param type data type
-   * @param properties properties
-   */
+       * Publishes a topic with the specified name and type.
+       *
+       * This method registers this client as a publisher for the topic.
+       * It should be called before {@link setValue} or {@link setValueAt}
+       * can be used.
+       *
+       * Publishing a topic on a disconnected client is allowed.
+       * Client will automatically register such publishers once the connection
+       * has been established and send default or retained value as appropriate.
+       *
+       * @param topic topic name
+       * @param type data type
+       * @param properties properties
+       */
   publishTopic(topic: string, type: DataType | string, properties?: TopicProperties): NT4Topic;
   /**
-   * Un-publishes previously published topic.
-   *
-   * @param topic topic name
-   * @returns `true` if the topic was successfully unpublished, `false` if the topic was not published
-   */
+       * Un-publishes previously published topic.
+       *
+       * @param topic topic name
+       * @returns `true` if the topic was successfully unpublished, `false` if the topic was not published
+       */
   unpublishTopic(topic: string): boolean;
   /**
-   * Determines whether client already publishes the topic.
-   *
-   * @param topic topic name
-   */
+       * Determines whether client already publishes the topic.
+       *
+       * @param topic topic name
+       */
   isTopicPublished(topic: string): boolean;
   /**
-   * Sets properties for the specified topic.
-   *
-   * @param topic topic name
-   * @param properties new properties
-   */
+       * Sets properties for the specified topic.
+       *
+       * @param topic topic name
+       * @param properties new properties
+       */
   setTopicProperties(topic: string, properties: TopicProperties): void;
   /**
-   * Sets persistent flag for the topic.
-   *
-   * @param topic topic name
-   * @param value value to set
-   */
+       * Sets persistent flag for the topic.
+       *
+       * @param topic topic name
+       * @param value value to set
+       */
   setTopicPersistent(topic: string, value: boolean): void;
   /**
-   * Sets retained flag for the topic.
-   *
-   * @param topic topic name
-   * @param value value to set
-   */
+       * Sets retained flag for the topic.
+       *
+       * @param topic topic name
+       * @param value value to set
+       */
   setTopicRetained(topic: string, value: boolean): void;
   /**
-   * Sends a value to the published topic using the current time.
-   *
-   * This client must publish the topic with {@link publishTopic} first.
-   *
-   * @param topic topic name
-   * @param value value to send
-   */
+       * Sends a value to the published topic using the current time.
+       *
+       * This client must publish the topic with {@link publishTopic} first.
+       *
+       * @param topic topic name
+       * @param value value to send
+       */
   setValue(topic: string, value: unknown): void;
   /**
-   * Sends a default ("weak") value to the published topic.
-   *
-   * This client must publish the topic with {@link publishTopic} first.
-   *
-   * @param topic topic name
-   * @param value value to send
-   */
+       * Sends a default ("weak") value to the published topic.
+       *
+       * This client must publish the topic with {@link publishTopic} first.
+       *
+       * @param topic topic name
+       * @param value value to send
+       */
   setDefaultValue(topic: string, value: unknown): void;
   /**
-   * Sends a value to the published topic using the specified timestamp.
-   *
-   * This client must publish the topic with {@link publishTopic} first.
-   *
-   * @param topic topic name
-   * @param value value to send
-   * @param timestamp timestamp
-   */
+       * Sends a value to the published topic using the specified timestamp.
+       *
+       * This client must publish the topic with {@link publishTopic} first.
+       *
+       * @param topic topic name
+       * @param value value to send
+       * @param timestamp timestamp
+       */
   setValueAt(topic: string, value: unknown, timestamp: number): void;
   /**
-   * Returns current ping timeout.
-   *
-   * @returns A value in milliseconds or 0 if the timeout has not been set yet.
-   */
+       * Returns current ping timeout.
+       *
+       * @returns A value in milliseconds or 0 if the timeout has not been set yet.
+       */
   get pingTimeoutMilliseconds(): number;
   /**
-   * Sets ping timeout.
-   *
-   * @param value Timeout in milliseconds or `undefined` to use default protocol timeout value.
-   */
+       * Sets ping timeout.
+       *
+       * @param value Timeout in milliseconds or `undefined` to use default protocol timeout value.
+       */
   setPingTimeoutMilliseconds(value: number | undefined): void;
 }
 //#endregion

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../src/NT4Types.ts","../src/NT4Subscription.ts","../src/NT4Topic.ts","../src/NT4Spec.ts","../src/NT4Client.ts"],"sourcesContent":[],"mappings":";;AAKA;AA8BA;;;KA9BY,eAAA,GAAkB;ECFjB;;;;;;;;;ACGb;;;;;;;;ACiCA;AAkBA;;;;AC7CA,CAAA;AAEA;;;AAiC2B,KJZf,mBAAA,GAAsB,MIYP,CAAA,MAAA,EAAA,OAAA,CAAA,GAAA;EASA;;AAkC3B;;;;;EAomByE,QAAA,CAAA,EAAA,MAAA;EAkB/C;;;;;;;;;;;;;;;;;;;;;;;;;AJ3sB1B;AA8BY,cChCC,eAAA,CDgCqB;;;;EChCrB,SAAA,OAAA,EAKc,mBALC;EAKD;EAGD,SAAA,MAAA,EAAA,GAAA,CAAA,MAAA,CAAA;EAES,WAAA,CAAA,GAAA,EAAA,MAAA,EAAA,MAAA,EAAA,QAAA,CAAA,MAAA,CAAA,EAAA,OAAA,CAAA,EAA4B,mBAA5B;;;;ADRnC;AA8BY,cE7BC,QAAA,CF6BkB;;;;EChClB,SAAA,IAAA,EAAA,MAAe;EAKD;EAGD,SAAA,IAAA,EAAA,MAAA;EAES;EAA4B,SAAA,UAAA,ECIjC,eDJiC;EAAmB;;;;ECPrE;EAWiB,iBAAA,CAAA,EAAA,MAAA;EAWsC,WAAA,CAAA,GAAA,EAAA,MAAA,EAAA,IAAA,EAAA,MAAA,EAAA,IAAA,EAAA,MAAA,EAAA,UAAA,CAAA,EAAA,eAAA,EAAA,MAAA,CAAA,EAAA,MAAA;EAU/B;EAAe,eAAA,CAAA,UAAA,EAAf,eAAe,CAAA,EAAA,IAAA;;;;ECCvC,mBAgBH,CAAA,CAAA,EAAA,IAAA;EAEE;;;;AC7CZ;;;;AD6CA;;;;AC7CA;AAEY,cDyBC,aCzBe,EAAA;EAmBC,SAAA,OAAA,EAAA,CAAA;EAOF,SAAA,MAAA,EAAA,CAAA;EAOA,SAAA,GAAA,EAAA,CAAA;EASA,SAAA,KAAA,EAAA,CAAA;EAAQ,SAAA,MAAA,EAAA,CAAA;EAkCtB,SAAA,IAAS,EAAA,CAAA;EA+e0C,SAAA,GAAA,EAAA,CAAA;EA+C9C,SAAA,GAAA,EAAA,CAAA;EAsES,SAAA,OAAA,EAAA,CAAA;EAA2B,SAAA,QAAA,EAAA,CAAA;EAAmB,SAAA,WAAA,EAAA,EAAA;EAkB/C,SAAA,UAAA,EAAA,EAAA;EAsCiB,SAAA,OAAA,EAAA,EAAA;EAAgC,SAAA,SAAA,EAAA,EAAA;EAAe,SAAA,UAAA,EAAA,EAAA;CAoDnC;AAAe,KDjvB1D,QAAA,GCivB0D,MAAA,ODjvBlC,aCivBkC;;;KA9xB1D,wBAAA;KAEA,gBAAA;EHXC;EAKc,MAAA,CAAA,EAAA,OAAA;EAGD;;;EAEwD,SAAA,CAAA,EAAA,GAAA,GAAA,IAAA;;;;ECPrE,YAAQ,CAAA,EAAA,GAAA,GAAA,IAAA;EAWS;;;;;6BEgBD;;ADM7B;AAkBA;;;2BCjB2B;EA5Bf;AAEZ;;;;EA0C2B,cAAA,CAAA,EAAA,CAAA,KAAA,EATA,QASA,EAAA,GAAA,IAAA;EAAQ;AAkCnC;;;;;;EAsnB0B,cAAA,CAAA,EAAA,CAAA,KAAA,EAxpBC,QAwpBD,EAAA,KAAA,EAAA,OAAA,EAAA,SAAA,EAAA,MAAA,EAAA,GAAA,IAAA;EAsCiB;;;;;;;;;;;;;;;;;;;;cA5pB9B,SAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gEA+emD;;;;;;;;eA+C9C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBAsES,2BAA2B,sBAAmB;;;;;;;mBAkB/C;;;;;;;;;;;;;;;;;;;;oCAsCiB,gCAAgC,kBAAe;;;;;;;;;;;;;;;;;;;;gDAoDnC"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/NT4Types.ts","../src/NT4Subscription.ts","../src/NT4Topic.ts","../src/NT4Spec.ts","../src/NT4Client.ts"],"mappings":"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"}

package/dist/index.mjs

@@ -107,6 +107,23 @@ var NT4Topic = class {
 	resetRetainedTimestamp() {
 		if (this.retainedTimestamp != null && this.retainedTimestamp > 1) this.retainedTimestamp = 1;
 	}
+	/** Determines whether topic can accept the specified value. */
+	canAccept(value) {
+		switch (this.typeCode) {
+			case DataTypeCodes.boolean: return typeof value === "boolean";
+			case DataTypeCodes.double:
+			case DataTypeCodes.float: return typeof value === "number";
+			case DataTypeCodes.int: return typeof value === "number" && Number.isInteger(value);
+			case DataTypeCodes.string: return typeof value === "string";
+			case DataTypeCodes["boolean[]"]: return Array.isArray(value) && value.every((v) => typeof v === "boolean");
+			case DataTypeCodes["double[]"]:
+			case DataTypeCodes["float[]"]: return Array.isArray(value) && value.every((v) => typeof v === "number");
+			case DataTypeCodes["int[]"]: return Array.isArray(value) && value.every((v) => typeof v === "number" && Number.isInteger(v));
+			case DataTypeCodes["string[]"]: return Array.isArray(value) && value.every((v) => typeof v === "string");
+			case DataTypeCodes.json: return value !== null && (typeof value === "object" || typeof value === "string");
+			default: return true;
+		}
+	}
 	/** Topic type code. For internal use only. */
 	typeCode;
 };
@@ -783,6 +800,7 @@ var NT4Client = class NT4Client {
 	setValueAt(topic, value, timestamp) {
 		const publishedTopic = this.publishedTopics.get(topic);
 		if (!publishedTopic) throw new Error("Topic must be published first");
+		if (!publishedTopic.canAccept(value)) throw new Error("Value is not compatible with topic underlying type");
 		publishedTopic.updateRetainedValue(value, timestamp);
 		if (this.onDataReceived) {
 			const announcedTopic = this.announcedTopics.get(topic);