@adcops/autocore-react 3.1.1 → 3.3.5

package/dist/hub/HubTauri.d.ts

@@ -1,75 +1,35 @@
 import { HubBase } from './HubBase';
-import type { CommandMessageResult } from "./CommandMessage";
+import type { CommandMessage } from "./CommandMessage";
+import { MessageType } from "./CommandMessage";
 /**
  * Hub for integrating with the Tauri backend.
  *
- * The tauri backend is expected to broadcast messages on the event
+ * The Tauri backend is expected to broadcast messages on the event
  * name: 'autocore://broadcast_event'
  *
  * This hub will capture those messages and dispatch them globally to any
  * listeners in the web app.
  *
+ * ## Usage Examples
  *
- * Example: Listen to an event 'xarm-position':
- * ```
- * const {subscribe, unsubscribe} = useContext(EventEmitterContext);
- * useEffect(() => {
- *         const unsubscripeMp = subscribe('xarm-position', (value) => {
- *            // The rust backend sent a JSON object of 3D position values.
- *            setX(value.x);
- *            setY(value.y);
- *            setZ(value.z);
- *            setA(value.roll);
- *            setB(value.yaw);
- *            setC(value.pitch);
- *        });
- *
- *    return () => {
- *        unsubscribe(unsubscripeMp);
- *    }
+ * ```typescript
+ * const { hub } = useContext(EventEmitterContext);
  *
- * }, [] );
+ * // Read a value
+ * const result = await hub.read("ads.plc1.gio.bControlPowerOk");
  *
- * ```
+ * // Write a value
+ * await hub.write("ads.plc1.gio.nSetpoint", 100);
  *
- * The hub should also be used for invoking events in the Tauri backend.
- * This example will call the function "update_count" in the rust backend, passing
- * the expected argument "count".
- * ```
- * const {invoke} = useContext(EventEmitterContext);
- * const incrementCount = () => {
- *    count += 1;
- *    invoke('update_count', {"count": count});
- * };
+ * // Subscribe to changes
+ * await hub.subscribe("modbus.holding_registers.5");
  * ```
  *
- * Of course, like any class derived from HubBase, the hub can be used to publish and subscribe to
- * topics in the front-end, without need of interacting with the Tauri backed.
+ * The hub can also publish/subscribe to frontend-only events:
  *
+ * ```typescript
+ * hub.publish("ui/panel-opened", { panelId: "settings" });
  * ```
- * const {dispatch, subscribe, unsubscribe} = useContext(EventEmitterContext);
- * const [controlPower, setControlPower] = useState(false);
- * useEffect(() => {
- *      const unsubscribeControlPower = subscribe('value-simulator-bBit1', (value) => {
- *          setControlPower(value);
- *      });
- *
- *
- *      return () => {
- *           unsubscribe(unsubscribeControlPower);
- *      }
- * }, [] );
- *
- * const onPbPressed = () => {
- *      let count = 1;
- *      dispatch({
- *          topic: "my-awesome-topic",
- *          payload: count
- *      });
- * }
- *
- * ```
- *
  */
 export declare class HubTauri extends HubBase {
     /**
@@ -77,12 +37,16 @@ export declare class HubTauri extends HubBase {
      */
     constructor();
     /**
-     * Invoke a method in the rust backend.
+     * Send a message to the Tauri backend.
+     *
+     * The topic and messageType are passed to a generic Tauri command handler
+     * that routes the request appropriately.
      *
-     * @param fname method name
-     * @param payload Optional data payload
-     * @returns The return value of the backend method.
+     * @param topic The FQDN of the resource (e.g., "ads.plc1.gio.bControlPowerOk")
+     * @param messageType The action to perform (Read, Write, Subscribe, etc.)
+     * @param payload Optional data payload (e.g., value to write)
+     * @returns Promise<CommandMessage> The response from the backend
      */
-    invoke(domain: string, fname: string, payload?: object | undefined): Promise<CommandMessageResult>;
+    invoke(topic: string, messageType: MessageType, payload?: object): Promise<CommandMessage>;
 }
 //# sourceMappingURL=HubTauri.d.ts.map

package/dist/hub/HubTauri.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"HubTauri.d.ts","sourceRoot":"","sources":["../../src/hub/HubTauri.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,KAAK,EAAC,oBAAoB,EAAC,MAAM,kBAAkB,CAAC;AAE3D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsEG;AACH,qBAAa,QAAS,SAAQ,OAAO;IAEjC;;OAEG;;IAgCH;;;;;;OAMG;IACH,MAAM,CAAC,MAAM,EAAG,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,oBAAoB,CAAC;CAkBtG"}
+{"version":3,"file":"HubTauri.d.ts","sourceRoot":"","sources":["../../src/hub/HubTauri.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAI/C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,qBAAa,QAAS,SAAQ,OAAO;IAEjC;;OAEG;;IA6BH;;;;;;;;;;OAUG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;CA8C7F"}

package/dist/hub/HubTauri.js

@@ -1 +1 @@
-import{HubBase}from"./HubBase";import{event,invoke}from"@tauri-apps/api";export class HubTauri extends HubBase{constructor(){super(),event.listen("autocore://broadcast_event",o=>{let e=JSON.parse(o.payload);void 0!==e.topic&&null!==e.topic&&(void 0!==e.payload&&null!==e.payload?this.publish(e.topic,e.payload):this.publish(e.topic,void 0))})}invoke(o,e,i){if(null!=i){return invoke(`${o}_${e}`,i)}return invoke(e)}}
+import{HubBase}from"./HubBase";import{invoke as tauriInvoke}from"@tauri-apps/api/core";import{listen}from"@tauri-apps/api/event";import{MessageType}from"./CommandMessage";export class HubTauri extends HubBase{constructor(){super(),this.setIsConnected(!0),listen("autocore://broadcast_event",e=>{let o=JSON.parse(e.payload);void 0!==o.topic&&null!==o.topic&&(void 0!==o.payload&&null!==o.payload?this.publish(o.topic,o.payload):this.publish(o.topic,void 0))})}invoke(e,o,s){const t={topic:e,message_type:o,...s??{}};return new Promise((o,s)=>{tauriInvoke("autocore_invoke",t).then(s=>{if(s&&"object"==typeof s&&"topic"in s)o(s);else{const t={transaction_id:0,timecode:Date.now(),topic:e,message_type:MessageType.Response,data:s,success:!0,error_message:""};o(t)}}).catch(o=>{const t={transaction_id:0,timecode:Date.now(),topic:e,message_type:MessageType.Response,data:null,success:!1,error_message:o?.toString()||"Unknown error"};s(t)})})}}

package/dist/hub/HubWebSocket.d.ts

@@ -1,34 +1,50 @@
-/** @file
+/**
+ * @module hub/HubWebSocket
  *
- * ## broadcast messages
- * The result field of CommandMessages used for broadcast must have
- * success set to true, and must contain the field "topic." The topic field, along
- * with the domain field of the CommandMessage will be combined for the topic used
- * by the websocket client.
+ * Implementation of `HubBase` using standard WebSockets.
  *
- * broadcast topic = `${CommandMessage.domain}/${CommandMessage.result["topic"]}
+ * ## Functionality
  *
- * So, to subscribe to a broadcast topic for GM.fReal that is served by the ADS client, the
- * topic will be: "ADS/GM.fReal"
+ * - **Transport**: Connects to `ws://host:port/ws/` (or `wss://`).
+ * - **Request/Response**: Correlates requests to responses using `transaction_id`.
+ * - **Broadcasts**: Handles unsolicited messages (subscriptions) and routes them via `HubBase.publish`.
+ * - **Binary Data**: Handles `FILE_DOWNLOAD` events by decoding Base64 payloads into Blobs.
+ *
+ * ## Protocol
+ *
+ * Messages are JSON-serialized `CommandMessage` objects.
+ * - **Requests**: Client sends `message_type` (Read/Write/etc) + `transaction_id`.
+ * - **Responses**: Server replies with same `transaction_id` + `success`/`data`.
+ * - **Broadcasts**: Server sends `message_type: Broadcast` + `topic` (FQDN) + `data`.
  */
 import { HubBase } from './HubBase';
-import type { CommandMessage, CommandMessageResult } from "./CommandMessage";
+import { MessageType, type CommandMessage } from "./CommandMessage";
+/**
+ * WebSocket implementation of the Hub communication layer.
+ */
 export declare class HubWebSocket extends HubBase {
     private socket;
     private requestId;
+    /**
+     * Map of pending Transaction ID -> Promise Resolvers.
+     * Used to match asynchronous WebSocket responses to their original requests.
+     */
     private pendingRequests;
     /**
-     * Constructor. Creates and attempts to make the Websocket connection.
+     * Initializes the WebSocket connection immediately.
      */
     constructor();
     /**
-     * Invoke a command in the remote webserver.
-     * @param domain The domain of the Servelet supplying the functionality.
-     * @param fname The name of the command to execute.
-     * @param payload The arguments of the command.
-     * @returns Promise<CommandMessageResult>
+     * Sends a command to the server via WebSocket.
+     *
+     * Wraps the operation in a Promise that resolves when the server replies
+     * with a matching `transaction_id`.
+     */
+    invoke: (topic: string, messageType: MessageType, payload?: object) => Promise<CommandMessage>;
+    /**
+     * Processes messages that are not responses to a specific request.
+     * Usually these are subscription updates (Broadcasts).
      */
-    invoke: (domain: string, fname: string, payload?: object) => Promise<CommandMessageResult>;
     handleUnsolicitedMessage: (msg: CommandMessage) => void;
     disconnect: () => void;
     protected emit: (eventName: string, payload?: object) => void;

package/dist/hub/HubWebSocket.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"HubWebSocket.d.ts","sourceRoot":"","sources":["../../src/hub/HubWebSocket.ts"],"names":[],"mappings":"AASA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,KAAK,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AA8F7E,qBAAa,YAAa,SAAQ,OAAO;IACrC,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,eAAe,CAAoC;IAE3D;;OAEG;;IAgGH;;;;;;OAMG;IACH,MAAM,GAAI,QAAQ,MAAM,EAAE,OAAO,MAAM,EAAE,UAAU,MAAM,KAAG,OAAO,CAAC,oBAAoB,CAAC,CAgBxF;IAED,wBAAwB,GAAI,KAAK,cAAc,UAiB9C;IAED,UAAU,QAAO,IAAI,CAEpB;IAED,SAAS,CAAC,IAAI,GAAI,WAAW,MAAM,EAAE,UAAU,MAAM,KAAG,IAAI,CAE3D;CACJ"}
+{"version":3,"file":"HubWebSocket.d.ts","sourceRoot":"","sources":["../../src/hub/HubWebSocket.ts"],"names":[],"mappings":"AAUA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AA+DpE;;GAEG;AACH,qBAAa,YAAa,SAAQ,OAAO;IACrC,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,SAAS,CAAK;IAEtB;;;OAGG;IACH,OAAO,CAAC,eAAe,CAAoC;IAE3D;;OAEG;;IA4FH;;;;;OAKG;IACH,MAAM,GAAI,OAAO,MAAM,EAAE,aAAa,WAAW,EAAE,UAAU,MAAM,KAAG,OAAO,CAAC,cAAc,CAAC,CAqB5F;IAED;;;OAGG;IACH,wBAAwB,GAAI,KAAK,cAAc,UAO9C;IAED,UAAU,QAAO,IAAI,CAEpB;IAED,SAAS,CAAC,IAAI,GAAI,WAAW,MAAM,EAAE,UAAU,MAAM,KAAG,IAAI,CAE3D;CACJ"}

package/dist/hub/HubWebSocket.js

@@ -1 +1 @@
-import{HubBase}from"./HubBase";function b64toBlob(e,t="application/octet-stream",s=512){const n=atob(e),o=[];for(let e=0;e<n.length;e+=s){const t=n.slice(e,e+s),r=new Array(t.length);for(let e=0;e<t.length;e++)r[e]=t.charCodeAt(e);const i=new Uint8Array(r);o.push(i.buffer)}return new Blob(o,{type:t})}function downloadBlob(e,t){const s=window.URL.createObjectURL(e),n=document.createElement("a");n.href=s,n.download=t,document.body.appendChild(n),n.click(),document.body.removeChild(n),window.URL.revokeObjectURL(s)}export class HubWebSocket extends HubBase{constructor(){super(),Object.defineProperty(this,"socket",{enumerable:!0,configurable:!0,writable:!0,value:void 0}),Object.defineProperty(this,"requestId",{enumerable:!0,configurable:!0,writable:!0,value:0}),Object.defineProperty(this,"pendingRequests",{enumerable:!0,configurable:!0,writable:!0,value:new Map}),Object.defineProperty(this,"invoke",{enumerable:!0,configurable:!0,writable:!0,value:(e,t,s)=>new Promise((n,o)=>{const r=++this.requestId;this.pendingRequests.set(r,{resolve:n,reject:o});let i={request_id:r,domain:e,fname:t,args:s,result:void 0};this.socket.send(JSON.stringify(i))})}),Object.defineProperty(this,"handleUnsolicitedMessage",{enumerable:!0,configurable:!0,writable:!0,value:e=>{if("BROADCAST"===e.fname&&e.domain.length>=1&&void 0!==e.result&&null!==e.result&&void 0!==e.result.data&&null!==e.result.data){let t=`${e.domain}/${e.result.data.topic}`;this.publish(t,e.result.data)}}}),Object.defineProperty(this,"disconnect",{enumerable:!0,configurable:!0,writable:!0,value:()=>{this.socket.close()}}),Object.defineProperty(this,"emit",{enumerable:!0,configurable:!0,writable:!0,value:(e,t)=>{this.socket.send(JSON.stringify({eventName:e,payload:t}))}});const e=window.location.hostname;let t;const s=`${"https:"===window.location.protocol?"wss://":"ws://"}${e}${t?":"+t:""}/ws/`;this.socket=new WebSocket(s);let n=this;this.socket.onopen=function(){n.publish("HUB/connected",!0),n.setIsConnected(!0)},this.socket.onmessage=e=>{const t=JSON.parse(e.data);if(t.request_id&&this.pendingRequests.has(t.request_id)){const{resolve:e,reject:s}=this.pendingRequests.get(t.request_id);if("FILE_DOWNLOAD"===t.fname&&void 0!==t.args.file_name&&null!==t.args.file_name&&t.args.file_name.length>0){let n=t.args.file_name.split("/");const o=n[n.length-1];if(t.result&&t.result.success){downloadBlob(b64toBlob(t.result.data),o),t.result.data=o,e(t.result)}else s(new Error(t.result?.error_message))}else t.result?.success?e(t.result):s(new Error(t.result?.error_message));this.pendingRequests.delete(t.request_id)}else this.handleUnsolicitedMessage(t)},this.socket.onerror=e=>{},this.socket.onclose=()=>{n.setIsConnected(!1)}}}
+import{HubBase}from"./HubBase";import{MessageType}from"./CommandMessage";import{getDebugPanel}from"./DebugPanel";function b64toBlob(e,t="application/octet-stream",s=512){const n=atob(e),o=[];for(let e=0;e<n.length;e+=s){const t=n.slice(e,e+s),a=new Array(t.length);for(let e=0;e<t.length;e++)a[e]=t.charCodeAt(e);const i=new Uint8Array(a);o.push(i.buffer)}return new Blob(o,{type:t})}function downloadBlob(e,t){const s=window.URL.createObjectURL(e),n=document.createElement("a");n.href=s,n.download=t,document.body.appendChild(n),n.click(),document.body.removeChild(n),window.URL.revokeObjectURL(s)}export class HubWebSocket extends HubBase{constructor(){super(),Object.defineProperty(this,"socket",{enumerable:!0,configurable:!0,writable:!0,value:void 0}),Object.defineProperty(this,"requestId",{enumerable:!0,configurable:!0,writable:!0,value:0}),Object.defineProperty(this,"pendingRequests",{enumerable:!0,configurable:!0,writable:!0,value:new Map}),Object.defineProperty(this,"invoke",{enumerable:!0,configurable:!0,writable:!0,value:(e,t,s)=>new Promise((n,o)=>{const a=++this.requestId;this.pendingRequests.set(a,{resolve:n,reject:o});const i={transaction_id:a,topic:e,data:s||{},timecode:Date.now(),message_type:t,success:!1,error_message:""};getDebugPanel().messageSent(MessageType[t],e,a),this.socket.send(JSON.stringify(i))})}),Object.defineProperty(this,"handleUnsolicitedMessage",{enumerable:!0,configurable:!0,writable:!0,value:e=>{e.message_type==MessageType.Broadcast&&e.topic.length>1&&this.publish(e.topic,e.data)}}),Object.defineProperty(this,"disconnect",{enumerable:!0,configurable:!0,writable:!0,value:()=>{this.socket.close()}}),Object.defineProperty(this,"emit",{enumerable:!0,configurable:!0,writable:!0,value:(e,t)=>{this.socket.send(JSON.stringify({eventName:e,payload:t}))}}),getDebugPanel().hubCreated();const e=window.location.hostname,t=window.location.port,s=`${"https:"===window.location.protocol?"wss://":"ws://"}${e}${t?":"+t:""}/ws/`;this.socket=new WebSocket(s);let n=this;this.socket.onopen=function(){getDebugPanel().wsOpened(s),n.publish("HUB/connected",!0),n.setIsConnected(!0)},this.socket.onmessage=e=>{const t=JSON.parse(e.data);if(getDebugPanel().messageReceived(MessageType[t.message_type]||String(t.message_type),t.topic,t.transaction_id),t.transaction_id&&this.pendingRequests.has(t.transaction_id)){const{resolve:e,reject:s}=this.pendingRequests.get(t.transaction_id);if("FILE_DOWNLOAD"===t.topic&&void 0!==t.data.file_name&&null!==t.data.file_name&&t.data.file_name.length>0){let n=t.data.file_name.split("/");const o=n[n.length-1];if(t.success){downloadBlob(b64toBlob(t.data),o),t.data=o,e(t)}else s(new Error(t.error_message))}else t.success?e(t):s(new Error(t.error_message));this.pendingRequests.delete(t.transaction_id)}else this.handleUnsolicitedMessage(t)},this.socket.onerror=e=>{getDebugPanel().wsError(String(e))},this.socket.onclose=e=>{n.setIsConnected(!1),getDebugPanel().wsClosed(e.code,e.reason||"No reason")}}}

package/dist/hub/debug.d.ts

@@ -0,0 +1,23 @@
+export interface DebugLogEntry {
+    timestamp: number;
+    source: string;
+    level: "info" | "warn" | "error" | "send" | "recv";
+    message: string;
+    data?: unknown;
+}
+export declare const debug: {
+    /** Log an info message */
+    info(source: string, message: string, data?: unknown): void;
+    /** Log a warning message */
+    warn(source: string, message: string, data?: unknown): void;
+    /** Log an error message */
+    error(source: string, message: string, data?: unknown): void;
+    /** Log an outgoing message (to server) */
+    send(source: string, message: string, data?: unknown): void;
+    /** Log an incoming message (from server) */
+    recv(source: string, message: string, data?: unknown): void;
+    /** Check if debug is enabled */
+    isEnabled(): boolean;
+};
+export default debug;
+//# sourceMappingURL=debug.d.ts.map

package/dist/hub/debug.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug.d.ts","sourceRoot":"","sources":["../../src/hub/debug.ts"],"names":[],"mappings":"AAiBA,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;IACnD,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAwFD,eAAO,MAAM,KAAK;IAChB,0BAA0B;iBACb,MAAM,WAAW,MAAM,SAAS,OAAO,GAAG,IAAI;IAI3D,4BAA4B;iBACf,MAAM,WAAW,MAAM,SAAS,OAAO,GAAG,IAAI;IAI3D,2BAA2B;kBACb,MAAM,WAAW,MAAM,SAAS,OAAO,GAAG,IAAI;IAI5D,0CAA0C;iBAC7B,MAAM,WAAW,MAAM,SAAS,OAAO,GAAG,IAAI;IAI3D,4CAA4C;iBAC/B,MAAM,WAAW,MAAM,SAAS,OAAO,GAAG,IAAI;IAI3D,gCAAgC;iBACnB,OAAO;CAGrB,CAAC;AAqEF,eAAe,KAAK,CAAC"}

package/dist/hub/debug.js

@@ -0,0 +1 @@
+const state={enabled:!0,logs:[],maxLogs:1e3};function formatTime(e){const t=new Date(e);return t.toTimeString().slice(0,8)+"."+String(t.getMilliseconds()).padStart(3,"0")}function formatEntry(e){return`[${formatTime(e.timestamp)}] [${e.source}] ${e.message}`}function addLog(e,t,o,s){const r={timestamp:Date.now(),source:e,level:t,message:o,data:s};if(state.logs.push(r),state.logs.length>state.maxLogs&&state.logs.shift(),state.enabled){formatEntry(r),getLogStyle(t);t}}function getLogStyle(e){switch(e){case"error":return"color: #ff4444; font-weight: bold;";case"warn":return"color: #ffaa00;";case"send":return"color: #44ff44;";case"recv":return"color: #4444ff;";default:return"color: #888888;"}}export const debug={info(e,t,o){addLog(e,"info",t,o)},warn(e,t,o){addLog(e,"warn",t,o)},error(e,t,o){addLog(e,"error",t,o)},send(e,t,o){addLog(e,"send",t,o)},recv(e,t,o){addLog(e,"recv",t,o)},isEnabled:()=>state.enabled};const consoleAPI={enable(){state.enabled=!0},disable(){state.enabled=!1},get logs(){return[...state.logs]},clear(){state.logs=[]},dump(){for(const e of state.logs){formatEntry(e);e.level}},filterBySource:e=>state.logs.filter(t=>t.source.includes(e)),filterByLevel:e=>state.logs.filter(t=>t.level===e),getMessages:()=>state.logs.filter(e=>"send"===e.level||"recv"===e.level)};"undefined"!=typeof window&&(window.__AUTOCORE_DEBUG__=consoleAPI);export default debug;

package/dist/hub/index.d.ts

@@ -2,15 +2,30 @@ import { HubBase as Hub } from './HubBase';
 import { HubTauri } from './HubTauri';
 import { HubWebSocket } from "./HubWebSocket";
 import { HubSimulate } from "./HubSimulate";
-import type { CommandMessage, CommandMessageResult } from './CommandMessage';
 /**
- * Creates a connection to the backend.
- * @returns Hub
+ * Creates or returns the singleton Hub connection to the backend.
+ *
+ * The hub type is determined automatically:
+ * - If running in Tauri: HubTauri (direct Rust IPC)
+ * - Otherwise: HubWebSocket (WebSocket to autocore-server)
+ *
+ * @returns Hub The singleton hub instance
  */
 export declare function createHub(): Hub;
+/**
+ * Returns the current hub instance, or null if not yet created.
+ * Useful for checking if a hub exists without creating one.
+ */
+export declare function getHubInstance(): Hub | null;
+/**
+ * Resets the singleton hub instance.
+ * This should only be used for testing or when intentionally reconnecting.
+ */
+export declare function resetHub(): void;
 export { HubBase as Hub } from './HubBase';
 export { HubTauri };
 export { HubWebSocket };
 export { HubSimulate };
-export type { CommandMessage, CommandMessageResult };
+export type { CommandMessage } from './CommandMessage';
+export { MessageType } from './CommandMessage';
 //# sourceMappingURL=index.d.ts.map

package/dist/hub/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hub/index.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,OAAO,IAAI,GAAG,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAC,WAAW,EAAC,MAAM,eAAe,CAAA;AACzC,OAAO,KAAK,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAK7E;;;GAGG;AACH,wBAAgB,SAAS,IAAI,GAAG,CAoC/B;AAKD,OAAO,EAAC,OAAO,IAAI,GAAG,EAAC,MAAM,WAAW,CAAC;AACzC,OAAO,EAAC,QAAQ,EAAC,CAAA;AACjB,OAAO,EAAC,YAAY,EAAC,CAAA;AACrB,OAAO,EAAC,WAAW,EAAC,CAAA;AACpB,YAAY,EAAC,cAAc,EAAE,oBAAoB,EAAC,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hub/index.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,OAAO,IAAI,GAAG,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAW5C;;;;;;;;GAQG;AACH,wBAAgB,SAAS,IAAI,GAAG,CAiB/B;AAED;;;GAGG;AACH,wBAAgB,cAAc,IAAI,GAAG,GAAG,IAAI,CAE3C;AAED;;;GAGG;AACH,wBAAgB,QAAQ,IAAI,IAAI,CAE/B;AAGD,OAAO,EAAE,OAAO,IAAI,GAAG,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,CAAC;AACpB,OAAO,EAAE,YAAY,EAAE,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,CAAC;AAGvB,YAAY,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/hub/index.js

@@ -1 +1 @@
-import{HubBase as Hub}from"./HubBase";import{HubTauri}from"./HubTauri";import{HubWebSocket}from"./HubWebSocket";import{HubSimulate}from"./HubSimulate";let hubInstance=null;export function createHub(){return hubInstance||(hubInstance=void 0!==window.__TAURI__&&null!==window.__TAURI__?new HubTauri:new HubWebSocket),hubInstance}export{HubBase as Hub}from"./HubBase";export{HubTauri};export{HubWebSocket};export{HubSimulate};
+import{HubBase as Hub}from"./HubBase";import{HubTauri}from"./HubTauri";import{HubWebSocket}from"./HubWebSocket";import{HubSimulate}from"./HubSimulate";import{getDebugPanel}from"./DebugPanel";let hubInstance=null;export function createHub(){const e=getDebugPanel();return e.log("info","createHub",`called (hasInstance: ${!!hubInstance})`),hubInstance?e.log("info","createHub","Returning existing hub instance"):"undefined"!=typeof window&&void 0!==window.__TAURI__&&null!==window.__TAURI__?(e.log("info","createHub","Creating HubTauri instance"),hubInstance=new HubTauri):(e.log("info","createHub","Creating HubWebSocket instance"),hubInstance=new HubWebSocket),hubInstance}export function getHubInstance(){return hubInstance}export function resetHub(){hubInstance=null}export{HubBase as Hub}from"./HubBase";export{HubTauri};export{HubWebSocket};export{HubSimulate};export{MessageType}from"./CommandMessage";

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@adcops/autocore-react",
-    "version": "3.1.1",
+    "version": "3.3.5",
     "description": "A React component library for industrial user interfaces.",
     "private": false,
     "type": "module",
@@ -51,7 +51,7 @@
     },
     "dependencies": {
         "@monaco-editor/react": "^4.7.0",
-        "@tauri-apps/api": "^1.6.0",
+        "@tauri-apps/api": "^2.9.1",
         "clsx": "^2.1.1",
         "numerable": "^0.3.15",
         "react-blockly": "^8.1.2",
@@ -70,8 +70,8 @@
     },
     "devDependencies": {
         "@svgr/cli": "^8.1.0",
-        "@types/react": "^18",
-        "@types/react-dom": "^18.3.7",
+        "@types/react": "^18.2.15",
+        "@types/react-dom": "^18.2.7",
         "@types/react-transition-group": "^4.4.12",
         "primereact": "^10.9.7",
         "rimraf": "^6.0.1",
@@ -95,6 +95,10 @@
         "./themes/*": {
             "import": "./dist/themes/*",
             "types": "./dist/themes/*.d.ts"
+        },
+        "./hub/*": {
+            "import": "./dist/hub/*",
+            "types": "./dist/hub/*.d.ts"
         }
     }
 }

package/src/components/AutoCoreDevPanel.tsx

@@ -2,7 +2,7 @@
  * Copyright (C) 2025 Automated Design Corp.. All Rights Reserved.
  * Created Date: 2025-09-05 08:06:09
  * -----
- * Last Modified: 2025-09-10 11:15:10
+ * Last Modified: 2026-01-20 06:09:05
  * -----
  * 
  */
@@ -93,6 +93,9 @@ import React, { useContext, useMemo, useState, useCallback } from "react";
 import type { TagConfig } from "../core/AutoCoreTagTypes";
 import { AutoCoreTagContext } from "../core/AutoCoreTagContext";
 
+/** Extract domain (first segment) from FQDN */
+const getDomain = (fqdn: string): string => fqdn.split('.')[0];
+
 /**
  * Props for the AutoCoreDevPanel component.
  */
@@ -167,8 +170,8 @@ export const AutoCoreDevPanel: React.FC<AutoCoreDevPanelProps> = ({
 
   const rows = useMemo(() => {
     return tags.map((tag) => {
-      const display = values[tag.tagName];
-      const raw = rawValues[tag.tagName];
+      const display = values[tag.fqdn];
+      const raw = rawValues[tag.fqdn];
       const scaleName = tag.scale ?? "";
       const s = scaleName ? scales[scaleName] : undefined;
       return {
@@ -192,7 +195,7 @@ export const AutoCoreDevPanel: React.FC<AutoCoreDevPanelProps> = ({
   }, []);
 
   const commit = useCallback(async (tag: TagConfig) => {
-    const tagName = tag.tagName;
+    const tagName = tag.fqdn;
     const buf = editBuf[tagName];
 
     try {
@@ -282,15 +285,15 @@ export const AutoCoreDevPanel: React.FC<AutoCoreDevPanelProps> = ({
           </thead>
           <tbody>
             {rows.map(({ tag, display, raw, scaleName, factor, label }) => {
-              const buf = editBuf[tag.tagName] ?? "";
-              const err = errors[tag.tagName];
+              const buf = editBuf[tag.fqdn] ?? "";
+              const err = errors[tag.fqdn];
 
               return (
-                <tr key={tag.tagName}>
+                <tr key={tag.fqdn}>
                   <Td mono>{tag.tagName}</Td>
                   <Td mono>{tag.valueType}</Td>
-                  <Td mono>{tag.domain}</Td>
-                  <Td mono>{tag.symbolName}</Td>
+                  <Td mono>{getDomain(tag.fqdn)}</Td>
+                  <Td mono>{tag.fqdn}</Td>
                   <Td mono>{fmt(display)}</Td>
                   <Td mono>{fmt(raw)}</Td>
                   <Td mono>{scaleName ? `${scaleName} ×${factor ?? 1}` : "—"}</Td>
@@ -299,7 +302,7 @@ export const AutoCoreDevPanel: React.FC<AutoCoreDevPanelProps> = ({
                     <InputForTag
                       tag={tag}
                       buf={buf}
-                      setBuf={(v) => setBuf(tag.tagName, v)}
+                      setBuf={(v) => setBuf(tag.fqdn, v)}
                       onKeyDown={(e) => onKeyDownCommit(e, tag)}
                     />
                     {err && <div style={{ color: "#dc2626", marginTop: 4 }}>{err}</div>}
@@ -308,7 +311,7 @@ export const AutoCoreDevPanel: React.FC<AutoCoreDevPanelProps> = ({
                     <div style={{ display: "flex", gap: 6 }}>
                       <button onClick={() => commit(tag)}>Write</button>
                       {tag.valueType === "boolean" && (
-                        <button onClick={() => tap(tag.tagName as any)}>TAP</button>
+                        <button onClick={() => tap(tag.fqdn as any)}>TAP</button>
                       )}
                     </div>
                   </Td>

package/src/components/FileList.tsx

@@ -24,6 +24,7 @@ import { confirmPopup } from 'primereact/confirmpopup';
 import { FileUpload, type FileUploadHandlerEvent} from 'primereact/fileupload';
 
 import { EventEmitterContext } from '../core/EventEmitterContext';
+import { MessageType } from '../hub/CommandMessage';
 
 
 /**
@@ -148,7 +149,7 @@ export const FileList: React.FC<FileListProps> = ({
     const listFiles = async () => {
         try {
             const args = subdir !== undefined ? { "subdir": subdir } : {};
-            let res = await invoke(domain, "list_files", args);
+            let res = await invoke(`${domain}.list_files`, MessageType.Request, args);
 
             let items = [];
             for (let i = 0; i < res.data.length; ++i) {
@@ -179,7 +180,7 @@ export const FileList: React.FC<FileListProps> = ({
         let target = makeTargetName(file.name);
 
         try {
-            await invoke(domain, "download_file", { file_name: target });
+            await invoke(`${domain}.download_file`, MessageType.Request, { file_name: target });
             if (onSuccess)
                 onSuccess(`Downloaded file: ${file.name}`);
         } catch (error) {
@@ -199,7 +200,7 @@ export const FileList: React.FC<FileListProps> = ({
         let target = makeTargetName(file_name);
 
         try {
-            await invoke(domain, "delete_file", { file_name: target });
+            await invoke(`${domain}.delete_file`, MessageType.Request, { file_name: target });
             if (onSuccess)
                 onSuccess(`Deleted file: ${file_name}`);
 
@@ -253,7 +254,7 @@ export const FileList: React.FC<FileListProps> = ({
             const base64String = arrayBufferToBase64(arrayBuffer);            
     
             try {
-                await invoke(domain, "write_file", { file_name: target, value: base64String, options :{"base64" : true} });
+                await invoke(`${domain}.write_file`, MessageType.Request, { file_name: target, value: base64String, options: { "base64": true } });
 
                 if (onSuccess)
                     onSuccess(`Uploaded file ${file.name}`);

package/src/components/FileSelect.tsx

@@ -14,6 +14,7 @@ import { Column } from 'primereact/column';
 import { Button } from 'primereact/button';
 
 import { EventEmitterContext } from "../core/EventEmitterContext";
+import { MessageType } from '../hub/CommandMessage';
 
 type FileSelectProps = {
     domain?: string,
@@ -54,7 +55,7 @@ export const FileSelect: React.FC<FileSelectProps> = ({
                 args = subdir ? { "subdir": subdir } : {};
             }
 
-            const res = await invoke(domain, "list_files", args);
+            const res = await invoke(`${domain}.list_files`, MessageType.Request, args);
             const items = res.data.map((item: string, index: number) => ({
                 id: index + 1,
                 name: item

package/src/core/ActionMode.ts

@@ -2,7 +2,7 @@
  * Copyright (C) 2024 Automated Design Corp.. All Rights Reserved.
  * Created Date: 2024-03-12 10:28:38
  * -----
- * Last Modified: 2024-03-12 10:28:47
+ * Last Modified: 2026-01-29 09:31:30
  * -----
  * 
  */