@adcops/autocore-react 3.1.1 → 3.3.5

package/dist/hooks/adsHooks.js

@@ -1 +1 @@
-import{useContext,useRef,useEffect,useCallback}from"react";import{EventEmitterContext}from"../core/EventEmitterContext";function sleep(e){return new Promise(t=>setTimeout(t,e))}export const useAdsRegisterSymbols=(e,t,n={})=>{const{invoke:r,subscribe:s,unsubscribe:o,isConnected:u}=useContext(EventEmitterContext),c=useRef([]),a=useRef(!0);return useEffect(()=>{a.current=!0;const i=async()=>{for(const[o,u]of Object.entries(t))try{const t=n[o]?{symbol_name:u,options:n[o]}:{symbol_name:u};await r("ADS","register_symbol",t);const i=s(`ADS/${u}`,t=>{if(a.current){const n=e[o];n&&n(t.value)}});c.current.push(i)}catch(e){}await r("ADS","refresh",{})};if(u())i();else{let e=s("HUB/connected",()=>{i(),o(e)});c.current.push(e)}return()=>{a.current=!1,c.current.forEach(e=>o(e)),c.current=[]}},[]),null};export function useAdsWriteValue(e){const{invoke:t}=useContext(EventEmitterContext);return async n=>{try{await t("ADS","write_value",{symbol_name:e,value:n})}catch(e){}}}export function useAdsWriteScaledValue(e,t,n){const{invoke:r}=useContext(EventEmitterContext);return useCallback(async s=>{const o=(s-n)/t;try{await r("ADS","write_value",{symbol_name:e,value:o})}catch(e){}},[e,t,n,r])}export function useAdsTapValue(e){const{invoke:t}=useContext(EventEmitterContext),n="write_value";return async()=>{try{await t("ADS",n,{symbol_name:e,value:!0}),await sleep(300),await t("ADS",n,{symbol_name:e,value:!1})}catch(e){}}}
+import{useContext,useRef,useEffect,useCallback}from"react";import{EventEmitterContext}from"../core/EventEmitterContext";import{MessageType}from"../hub/CommandMessage";function sleep(e){return new Promise(t=>setTimeout(t,e))}export const useAdsRegisterSymbols=(e,t,n={})=>{const{invoke:s,subscribe:r,unsubscribe:o,isConnected:c}=useContext(EventEmitterContext),u=useRef([]),a=useRef(!0);return useEffect(()=>{a.current=!0;const i=async()=>{for(const[o,c]of Object.entries(t))try{const t=n[o]?{symbol_name:c,options:n[o]}:{symbol_name:c};await s("ADS.register_symbol",MessageType.Request,t);const i=r(`ADS/${c}`,t=>{if(a.current){const n=e[o];n&&n(t.value)}});u.current.push(i)}catch(e){}await s("ADS.refresh",MessageType.Request,{})};if(c())i();else{let e=r("HUB/connected",()=>{i(),o(e)});u.current.push(e)}return()=>{a.current=!1,u.current.forEach(e=>o(e)),u.current=[]}},[]),null};export function useAdsWriteValue(e){const{write:t}=useContext(EventEmitterContext);return async n=>{try{await t(`ADS.${e}`,n)}catch(e){}}}export function useAdsWriteScaledValue(e,t,n){const{write:s}=useContext(EventEmitterContext);return useCallback(async r=>{const o=(r-n)/t;try{await s(`ADS.${e}`,o)}catch(e){}},[e,t,n,s])}export function useAdsTapValue(e){const{write:t}=useContext(EventEmitterContext);return async()=>{try{const n=`ADS.${e}`;await t(n,!0),await sleep(300),await t(n,!1)}catch(e){}}}

package/dist/hooks/commandHooks.d.ts

@@ -65,7 +65,7 @@ export declare const useRegisterSymbols: (domain: string, setters: Record<string
  *   );
  * };
  */
-export declare function useWriteValue(domain: string, symbolName: string, fname?: string): (value: object | boolean | number | string) => Promise<void>;
+export declare function useWriteValue(domain: string, symbolName: string): (value: object | boolean | number | string) => Promise<void>;
 /**
  * useWriteScaledValue is a custom React hook that enables writing scaled numerical values to the autocore backend system.
  * It applies a specified scale and offset to a numeric value before sending it over the websocket connection.
@@ -114,7 +114,7 @@ export declare function useWriteValue(domain: string, symbolName: string, fname?
  * converts it to millimeters using the current `scale`, and writes the result to a backend symbol. The `scale` and `offset` can be adjusted
  * dynamically if needed, for instance, based on user selection or other external configurations.
  */
-export declare function useWriteScaledValue(domain: string, symbolName: string, scale: number, offset: number, fname?: string): (value: number) => Promise<void>;
+export declare function useWriteScaledValue(domain: string, symbolName: string, scale: number, offset: number): (value: number) => Promise<void>;
 /**
  * Custom hook to send a "tap" action, which sends true followed by false after a short delay,
  * to a specified symbol in the backend. This is used to simulate a button tap or momentary switch.
@@ -142,5 +142,5 @@ export declare function useWriteScaledValue(domain: string, symbolName: string,
  * };
  * ```
  */
-export declare function useTapValue(domain: string, symbolName: string, fname?: string): () => Promise<void>;
+export declare function useTapValue(domain: string, symbolName: string): () => Promise<void>;
 //# sourceMappingURL=commandHooks.d.ts.map

package/dist/hooks/commandHooks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"commandHooks.d.ts","sourceRoot":"","sources":["../../src/hooks/commandHooks.tsx"],"names":[],"mappings":"AA6BA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,eAAO,MAAM,kBAAkB,GAC3B,QAAS,MAAM,EACf,SAAS,MAAM,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,IAAI,CAAC,EAC7C,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,UAAS,MAAM,CAAC,MAAM,EAAE,EAAE,CAAM,SAiEnC,CAAC;AAGF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAG,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,GAAG,MAAsB,IAI/E,OAAO,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,mBAO1D;AAOD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAG,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,GAAG,MAAsB,WAGjG,MAAM,mBAa1C;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAG,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,GAAG,MAAsB,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAYpH"}
+{"version":3,"file":"commandHooks.d.ts","sourceRoot":"","sources":["../../src/hooks/commandHooks.tsx"],"names":[],"mappings":"AA8BA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,eAAO,MAAM,kBAAkB,GAC3B,QAAS,MAAM,EACf,SAAS,MAAM,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,IAAI,CAAC,EAC7C,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,UAAS,MAAM,CAAC,MAAM,EAAE,EAAE,CAAM,SAgEnC,CAAC;AAGF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,IAI9C,OAAO,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,mBAQ1D;AAOD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,WAGhE,MAAM,mBAc1C;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAcnF"}

package/dist/hooks/commandHooks.js

@@ -1 +1 @@
-import{useContext,useRef,useEffect,useCallback}from"react";import{EventEmitterContext}from"../core/EventEmitterContext";function sleep(e){return new Promise(t=>setTimeout(t,e))}export const useRegisterSymbols=(e,t,n,r={})=>{const{subscribe:o,unsubscribe:u,isConnected:s,invoke:c}=useContext(EventEmitterContext),a=useRef([]),i=useRef(!0);return useEffect(()=>{i.current=!0;const r=async()=>{for(const[r,u]of Object.entries(n))try{const n=o(`${e}/${u}`,e=>{if(i.current){const n=t[r];n&&n(e.value)}});a.current.push(n),await c(e,"refresh",{topic:`${u}`})}catch(e){}};if(s())r();else{let e=o("HUB/connected",()=>{setTimeout(()=>{r(),u(e)},500)});a.current.push(e)}return()=>{i.current=!1,a.current.forEach(e=>u(e)),a.current=[]}},[]),null};export function useWriteValue(e,t,n="write_value"){const{invoke:r}=useContext(EventEmitterContext);return async o=>{try{await r(e,n,{topic:t,value:o})}catch(e){}}}export function useWriteScaledValue(e,t,n,r,o="write_value"){const{invoke:u}=useContext(EventEmitterContext);return useCallback(async s=>{const c=(s-r)/n;try{await u(e,o,{symbol_name:t,value:c})}catch(e){}},[t,n,r,u])}export function useTapValue(e,t,n="write_value"){const{invoke:r}=useContext(EventEmitterContext);return async()=>{try{await r(e,n,{symbol_name:t,value:!0}),await sleep(300),await r(e,n,{symbol_name:t,value:!1})}catch(e){}}}
+import{useContext,useRef,useEffect,useCallback}from"react";import{EventEmitterContext}from"../core/EventEmitterContext";import{MessageType}from"../hub/CommandMessage";function sleep(e){return new Promise(t=>setTimeout(t,e))}export const useRegisterSymbols=(e,t,n,r={})=>{const{subscribe:s,unsubscribe:c,isConnected:o,invoke:u}=useContext(EventEmitterContext),a=useRef([]),i=useRef(!0);return useEffect(()=>{i.current=!0;const r=async()=>{for(const[r,c]of Object.entries(n))try{const n=s(`${e}/${c}`,e=>{if(i.current){const n=t[r];n&&n(e.value)}});a.current.push(n),await u(`${e}.${c}`,MessageType.Request,{action:"refresh"})}catch(e){}};if(o())r();else{let e=s("HUB/connected",()=>{setTimeout(()=>{r(),c(e)},500)});a.current.push(e)}return()=>{i.current=!1,a.current.forEach(e=>c(e)),a.current=[]}},[]),null};export function useWriteValue(e,t){const{write:n}=useContext(EventEmitterContext);return async r=>{try{await n(`${e}.${t}`,r)}catch(e){}}}export function useWriteScaledValue(e,t,n,r){const{write:s}=useContext(EventEmitterContext);return useCallback(async c=>{const o=(c-r)/n;try{await s(`${e}.${t}`,o)}catch(e){}},[e,t,n,r,s])}export function useTapValue(e,t){const{write:n}=useContext(EventEmitterContext);return async()=>{try{const r=`${e}.${t}`;await n(r,!0),await sleep(300),await n(r,!1)}catch(e){}}}

package/dist/hooks/useAutoCoreTag.js

@@ -1 +1 @@
-import{useCallback,useContext,useMemo}from"react";export function makeAutoCoreTagHooks(e,a){return{useAutoCoreTag:t=>{const{values:s,rawValues:u,isLoading:o,write:r,tap:n}=useContext(e),l=(e=>a.find(a=>a.tagName===e))(t);if(!l)throw new Error(`useAutoCoreTag: unknown tagName '${String(t)}'`);const i=useCallback(e=>r(t,e),[r,t]),c=useCallback(()=>n?.(t),[n,t]);return{value:s[t],rawValue:u[t],write:i,tap:c,isLoading:o}},useAutoCoreTags:a=>{const{values:t,rawValues:s,isLoading:u,write:o}=useContext(e);return{values:useMemo(()=>Object.fromEntries(a.map(e=>[e,t[e]])),[t,a]),rawValues:useMemo(()=>Object.fromEntries(a.map(e=>[e,s[e]])),[s,a]),write:useCallback(async(e,a)=>{await o(e,a)},[o]),isLoading:u}},useAutoCoreSelect:(a,t=[])=>{const{values:s,isLoading:u}=useContext(e);return{selected:useMemo(()=>a(s),[s,...t]),isLoading:u}},useScales:()=>{const{scales:a,updateScale:t}=useContext(e),s=useCallback(e=>a[e],[a]);return{scales:a,updateScale:t,getScale:s}}}}
+import{useCallback,useContext,useMemo}from"react";export function makeAutoCoreTagHooks(e,a){return{useAutoCoreTag:s=>{const{values:t,rawValues:u,isLoading:o,write:r,tap:n}=useContext(e),l=(e=>a.find(a=>a.fqdn===e))(s);if(!l)throw new Error(`useAutoCoreTag: unknown tagName '${String(s)}'`);const i=useCallback(e=>r(s,e),[r,s]),c=useCallback(()=>n?.(s),[n,s]);return{value:t[s],rawValue:u[s],write:i,tap:c,isLoading:o}},useAutoCoreTags:a=>{const{values:s,rawValues:t,isLoading:u,write:o}=useContext(e);return{values:useMemo(()=>Object.fromEntries(a.map(e=>[e,s[e]])),[s,a]),rawValues:useMemo(()=>Object.fromEntries(a.map(e=>[e,t[e]])),[t,a]),write:useCallback(async(e,a)=>{await o(e,a)},[o]),isLoading:u}},useAutoCoreSelect:(a,s=[])=>{const{values:t,isLoading:u}=useContext(e);return{selected:useMemo(()=>a(t),[t,...s]),isLoading:u}},useScales:()=>{const{scales:a,updateScale:s}=useContext(e),t=useCallback(e=>a[e],[a]);return{scales:a,updateScale:s,getScale:t}}}}

package/dist/hub/CommandMessage.d.ts

@@ -1,13 +1,22 @@
-export interface CommandMessageResult {
-    data: any;
-    success: boolean;
-    error_message: string;
+export declare enum MessageType {
+    NoOp = 0,
+    Response = 1,
+    Read = 2,
+    Write = 3,
+    Subscribe = 4,
+    Unsubscribe = 5,
+    Broadcast = 6,
+    Heartbeat = 7,
+    Control = 8,
+    Request = 10
 }
 export interface CommandMessage {
-    request_id: number;
-    domain: string;
-    fname: string;
-    args?: any;
-    result?: CommandMessageResult;
+    transaction_id: number;
+    timecode: number;
+    topic: string;
+    message_type: MessageType;
+    data?: any;
+    success: boolean;
+    error_message: string;
 }
 //# sourceMappingURL=CommandMessage.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"CommandMessage.d.ts","sourceRoot":"","sources":["../../src/hub/CommandMessage.ts"],"names":[],"mappings":"AAaA,MAAM,WAAW,oBAAoB;IAEjC,IAAI,EAAE,GAAG,CAAC;IAEV,OAAO,EAAG,OAAO,CAAC;IAElB,aAAa,EAAE,MAAM,CAAC;CACzB;AAID,MAAM,WAAW,cAAc;IAG3B,UAAU,EAAE,MAAM,CAAC;IAEnB,MAAM,EAAE,MAAM,CAAC;IAEf,KAAK,EAAE,MAAM,CAAC;IAEd,IAAI,CAAC,EAAE,GAAG,CAAC;IAEX,MAAM,CAAC,EAAE,oBAAoB,CAAC;CACjC"}
+{"version":3,"file":"CommandMessage.d.ts","sourceRoot":"","sources":["../../src/hub/CommandMessage.ts"],"names":[],"mappings":"AAuBA,oBAAY,WAAW;IAEnB,IAAI,IAAI;IAGR,QAAQ,IAAI;IAGZ,IAAI,IAAI;IAGR,KAAK,IAAI;IAGT,SAAS,IAAI;IAGb,WAAW,IAAI;IAGf,SAAS,IAAI;IAGb,SAAS,IAAI;IAGb,OAAO,IAAI;IAGX,OAAO,KAAK;CACf;AAMD,MAAM,WAAW,cAAc;IAG3B,cAAc,EAAE,MAAM,CAAC;IAIvB,QAAQ,EAAE,MAAM,CAAC;IAKjB,KAAK,EAAE,MAAM,CAAC;IAGd,YAAY,EAAE,WAAW,CAAC;IAK1B,IAAI,CAAC,EAAE,GAAG,CAAC;IAIX,OAAO,EAAE,OAAO,CAAC;IAGjB,aAAa,EAAE,MAAM,CAAC;CAEzB"}

package/dist/hub/CommandMessage.js

@@ -1 +1 @@
-export{};
+export var MessageType;!function(e){e[e.NoOp=0]="NoOp",e[e.Response=1]="Response",e[e.Read=2]="Read",e[e.Write=3]="Write",e[e.Subscribe=4]="Subscribe",e[e.Unsubscribe=5]="Unsubscribe",e[e.Broadcast=6]="Broadcast",e[e.Heartbeat=7]="Heartbeat",e[e.Control=8]="Control",e[e.Request=10]="Request"}(MessageType||(MessageType={}));

package/dist/hub/DebugPanel.d.ts

@@ -0,0 +1,31 @@
+interface DebugLog {
+    time: string;
+    type: "info" | "warn" | "error" | "send" | "recv";
+    source: string;
+    message: string;
+}
+declare class DebugPanel {
+    private container;
+    private logContainer;
+    private statsContainer;
+    private logs;
+    private maxLogs;
+    private stats;
+    constructor();
+    private injectPanel;
+    private setupElements;
+    private updateStats;
+    log(type: DebugLog["type"], source: string, message: string): void;
+    private renderLogs;
+    hubCreated(): void;
+    connectCalled(socketState: string): void;
+    wsOpened(url: string): void;
+    wsClosed(code: number, reason: string): void;
+    wsError(error: string): void;
+    messageSent(type: string, command: string, requestId: number): void;
+    messageReceived(type: string, command: string, requestId?: number): void;
+    updateState(state: string): void;
+}
+export declare function getDebugPanel(): DebugPanel;
+export default getDebugPanel;
+//# sourceMappingURL=DebugPanel.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DebugPanel.d.ts","sourceRoot":"","sources":["../../src/hub/DebugPanel.ts"],"names":[],"mappings":"AAWA,UAAU,QAAQ;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;IAClD,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,cAAM,UAAU;IACd,OAAO,CAAC,SAAS,CAA+B;IAChD,OAAO,CAAC,YAAY,CAA+B;IACnD,OAAO,CAAC,cAAc,CAA+B;IACrD,OAAO,CAAC,IAAI,CAAkB;IAC9B,OAAO,CAAC,OAAO,CAAO;IAGtB,OAAO,CAAC,KAAK,CASX;;IAOF,OAAO,CAAC,WAAW;IA2FnB,OAAO,CAAC,aAAa;IAiBrB,OAAO,CAAC,WAAW;IAsBnB,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAyBlE,OAAO,CAAC,UAAU;IAgBlB,UAAU,IAAI,IAAI;IAMlB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAOxC,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAO3B,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAO5C,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAM5B,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAMnE,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI;IAMxE,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;CAIjC;AAKD,wBAAgB,aAAa,IAAI,UAAU,CAO1C;AAKD,eAAe,aAAa,CAAC"}

package/dist/hub/DebugPanel.js

@@ -0,0 +1 @@
+class DebugPanel{constructor(){Object.defineProperty(this,"container",{enumerable:!0,configurable:!0,writable:!0,value:null}),Object.defineProperty(this,"logContainer",{enumerable:!0,configurable:!0,writable:!0,value:null}),Object.defineProperty(this,"statsContainer",{enumerable:!0,configurable:!0,writable:!0,value:null}),Object.defineProperty(this,"logs",{enumerable:!0,configurable:!0,writable:!0,value:[]}),Object.defineProperty(this,"maxLogs",{enumerable:!0,configurable:!0,writable:!0,value:100}),Object.defineProperty(this,"stats",{enumerable:!0,configurable:!0,writable:!0,value:{hubInstancesCreated:0,connectCalls:0,wsOpened:0,wsClosed:0,wsErrors:0,messagesSent:0,messagesReceived:0,currentState:"unknown"}}),this.injectPanel(),this.log("info","DebugPanel","Debug panel initialized")}injectPanel(){const e=document.getElementById("autocore-debug-panel");e&&e.remove(),this.container=document.createElement("div"),this.container.id="autocore-debug-panel",this.container.innerHTML='\n      <style>\n        #autocore-debug-panel {\n          position: fixed;\n          bottom: 10px;\n          right: 10px;\n          width: 400px;\n          max-height: 300px;\n          background: rgba(0, 0, 0, 0.9);\n          color: #0f0;\n          font-family: monospace;\n          font-size: 11px;\n          border: 1px solid #0f0;\n          border-radius: 4px;\n          z-index: 99999;\n          overflow: hidden;\n        }\n        #autocore-debug-panel .header {\n          background: #0f0;\n          color: #000;\n          padding: 4px 8px;\n          font-weight: bold;\n          cursor: pointer;\n          display: flex;\n          justify-content: space-between;\n        }\n        #autocore-debug-panel .stats {\n          padding: 4px 8px;\n          border-bottom: 1px solid #0f0;\n          display: grid;\n          grid-template-columns: 1fr 1fr;\n          gap: 2px;\n        }\n        #autocore-debug-panel .stats span {\n          color: #fff;\n        }\n        #autocore-debug-panel .stats .value {\n          color: #ff0;\n        }\n        #autocore-debug-panel .logs {\n          max-height: 180px;\n          overflow-y: auto;\n          padding: 4px;\n        }\n        #autocore-debug-panel .log-entry {\n          margin: 1px 0;\n          white-space: nowrap;\n          overflow: hidden;\n          text-overflow: ellipsis;\n        }\n        #autocore-debug-panel .log-entry.info { color: #888; }\n        #autocore-debug-panel .log-entry.warn { color: #fa0; }\n        #autocore-debug-panel .log-entry.error { color: #f44; }\n        #autocore-debug-panel .log-entry.send { color: #4f4; }\n        #autocore-debug-panel .log-entry.recv { color: #44f; }\n        #autocore-debug-panel .state-connected { color: #4f4 !important; }\n        #autocore-debug-panel .state-disconnected { color: #f44 !important; }\n        #autocore-debug-panel .state-connecting { color: #fa0 !important; }\n      </style>\n      <div class="header">\n        <span>AutoCore Debug</span>\n        <span id="debug-toggle">[_]</span>\n      </div>\n      <div id="debug-content">\n        <div class="stats" id="debug-stats"></div>\n        <div class="logs" id="debug-logs"></div>\n      </div>\n    ',document.body?(document.body.appendChild(this.container),this.setupElements()):document.addEventListener("DOMContentLoaded",()=>{document.body.appendChild(this.container),this.setupElements()})}setupElements(){this.statsContainer=document.getElementById("debug-stats"),this.logContainer=document.getElementById("debug-logs");const e=document.getElementById("debug-toggle"),t=document.getElementById("debug-content");e?.addEventListener("click",()=>{t&&(t.style.display="none"===t.style.display?"block":"none",e.textContent="none"===t.style.display?"[+]":"[_]")}),this.updateStats()}updateStats(){if(!this.statsContainer)return;const e="OPEN"===this.stats.currentState?"state-connected":"CONNECTING"===this.stats.currentState?"state-connecting":"state-disconnected";this.statsContainer.innerHTML=`\n      <div><span>Hub Instances:</span> <span class="value">${this.stats.hubInstancesCreated}</span></div>\n      <div><span>connect() calls:</span> <span class="value">${this.stats.connectCalls}</span></div>\n      <div><span>WS Opened:</span> <span class="value">${this.stats.wsOpened}</span></div>\n      <div><span>WS Closed:</span> <span class="value">${this.stats.wsClosed}</span></div>\n      <div><span>WS Errors:</span> <span class="value">${this.stats.wsErrors}</span></div>\n      <div><span>Msgs Sent:</span> <span class="value">${this.stats.messagesSent}</span></div>\n      <div><span>Msgs Recv:</span> <span class="value">${this.stats.messagesReceived}</span></div>\n      <div><span>WS State:</span> <span class="value ${e}">${this.stats.currentState}</span></div>\n    `}log(e,t,n){const s=(new Date).toTimeString().slice(0,8),a={time:s,type:e,source:t,message:n};this.logs.push(a),this.logs.length>this.maxLogs&&this.logs.shift();this.renderLogs()}renderLogs(){this.logContainer&&(this.logContainer.innerHTML=this.logs.slice(-50).map(e=>`<div class="log-entry ${e.type}">[${e.time}] ${e.source}: ${e.message}</div>`).join(""),this.logContainer.scrollTop=this.logContainer.scrollHeight)}hubCreated(){this.stats.hubInstancesCreated++,this.log("warn","Hub",`NEW INSTANCE CREATED (total: ${this.stats.hubInstancesCreated})`),this.updateStats()}connectCalled(e){this.stats.connectCalls++,this.stats.currentState=e,this.log("info","Hub",`connect() called (socket state: ${e})`),this.updateStats()}wsOpened(e){this.stats.wsOpened++,this.stats.currentState="OPEN",this.log("info","WS",`OPENED: ${e}`),this.updateStats()}wsClosed(e,t){this.stats.wsClosed++,this.stats.currentState="CLOSED",this.log("warn","WS",`CLOSED: code=${e}, reason=${t}`),this.updateStats()}wsError(e){this.stats.wsErrors++,this.log("error","WS",`ERROR: ${e}`),this.updateStats()}messageSent(e,t,n){this.stats.messagesSent++,this.log("send","WS",`>>> ${e}/${t} (id=${n})`),this.updateStats()}messageReceived(e,t,n){this.stats.messagesReceived++,this.log("recv","WS",`<<< ${e}/${t} (id=${n??"none"})`),this.updateStats()}updateState(e){this.stats.currentState=e,this.updateStats()}}let debugPanel=null;export function getDebugPanel(){return debugPanel||(debugPanel=new DebugPanel,window.__AUTOCORE_DEBUG_PANEL__=debugPanel),debugPanel}getDebugPanel();export default getDebugPanel;

package/dist/hub/HubBase.d.ts

@@ -1,182 +1,136 @@
 import type { EventEmitterContextType } from '../core/EventEmitterContext';
-import type { CommandMessageResult } from "./CommandMessage";
+import type { CommandMessage } from "./CommandMessage";
+import { MessageType } from "./CommandMessage";
 /**
- * Base class for the interface for the IPC to the backend,
- * which may be websockets, MQTT, the Tauri API,
- * or something else.
+ * @class HubBase
+ * @abstract
  *
- * The EventEmitterContext should generate the hub automatically.
+ * Abstract base class that defines the interface for communicating with the AutoCore backend.
+ * Implementations (like `HubWebSocket` or `HubTauri`) handle the specific transport mechanics.
  *
- * # Usage
- * The hub can be used to publish and subscribe to
- * topics in the front-end, regardless of being connected to any backend.
+ * ## Core Responsibilities
  *
- * ```
- * 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
- *      });
- * }
- *
- * ```
- * The hub should also be used for invoking events in the backend.
- * This example will call the function "update_count" in the backend, passing
- * the expected argument "count". Details of the interaction between the Hub and
- * the backend will be handled by the appropriate HubBase sub-class, and should
- * be transparent to the front end.
- *
- * ```
- * const {invoke} = useContext(EventEmitterContext);
- * const incrementCount = () => {
- *    count += 1;
- *    invoke('update_count', {"count": count});
- * };
- *
- * Subscribing to a topic is simple. The type of value received is specific
- * to the topic.
+ * 1. **Transport Abstraction**: Provides a unified API (`read`, `write`, `subscribe`) regardless of
+ *    underlying transport (WS, IPC, etc.).
+ * 2. **Topic Mapping**: Maintains a bidirectional mapping between local `tagName` (UI friendly)
+ *    and backend `FQDN` (Fully Qualified Domain Name).
+ *    - `tagName`: "motorsEnable"
+ *    - `FQDN`: "ADS.Main.bMotorsEnable"
+ * 3. **Event Dispatching**: Routes incoming messages from the backend to the `EventEmitterContext`.
  *
- * Example: Listen to an event 'xarm-position':
- * ```
- * const {subscribe, unsubscribe} = useContext(EventEmitterContext);
- * useEffect(() => {
- *         const unsubscripeMp = subscribe('xarm-position', (value) => {
- *            // The publisher 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);
- *    }
+ * ## Usage
  *
- * }, [] );
+ * The `Hub` is typically accessed via the `EventEmitterContext`:
  *
+ * ```typescript
+ * const { hub } = useContext(EventEmitterContext);
+ * await hub.write("ADS.Main.nSpeed", 500);
  * ```
- *
  */
 export declare abstract class HubBase {
+    /** Maps local tag names to backend FQDNs. */
     protected localTopicToBackendTopicMap: Map<string, string>;
+    /** Maps backend FQDNs to local tag names. */
     protected backendTopicToLocalMap: Map<string, string>;
-    protected localFNameToBackendFNameMap: Map<string, string>;
-    protected backendFNameToLocalFNameMap: Map<string, string>;
+    /** Reference to the global event emitter for dispatching incoming messages. */
     protected context: EventEmitterContextType | null;
+    /** Connection state tracker. */
     protected isConnected_: boolean;
     /**
      * Constructor
      */
     constructor();
     /**
-     * Set the EventEmitterContext for this instance of the Hub. The EventEmitterContext
-     * should handle this as part of the initialization sequence. Because React can
-     * sometimes make (and destroy) multiple copies of the EventEmitterContext, it's important
-     * that the context be stored in the instance this way so that the HubBase can properly target
-     * right context.
+     * Links this Hub instance with the React application's Event Context.
      *
-     * If this context is not sent, no events will be emitted from the backend to the front end,
-     * and global events in the interface may not work.
+     * This connection allows the Hub to "push" messages into the React app by calling `context.dispatch()`.
+     * This is called automatically by `EventEmitterProvider` on initialization.
      *
+     * @param context The React context instance.
      */
     setContext(context: EventEmitterContextType | null): void;
     /**
-     * Invoke/send a message to the back end.
-     * This does NOT get published to the front end.
+     * Sends a raw command message to the backend.
+     *
+     * @param topic The resource identifier (FQDN).
+     * @param messageType The operation to perform (Read, Write, etc.).
+     * @param payload The data payload.
+     * @returns A Promise that resolves with the server's response.
      */
-    abstract invoke(domain: string, fname: string, payload?: object): Promise<CommandMessageResult>;
+    abstract invoke(topic: string, messageType: MessageType, payload?: object): Promise<CommandMessage>;
     /**
-     * Allos the derived class to set whether the hub is connected to its source.
-     * @param s boolean
+     * Request the current value of a resource.
+     *
+     * @param topic FQDN of the resource.
      */
-    protected setIsConnected: (s: boolean) => void;
+    read(topic: string, payload?: object): Promise<CommandMessage>;
     /**
-     * Returns true if the Hub is connected to its source.
+     * Write a new value to a resource.
+     *
+     * @param topic FQDN of the resource.
+     * @param value The value to write.
      */
-    isConnected: () => boolean;
+    write(topic: string, value: any): Promise<CommandMessage>;
     /**
-     * Convenience function to invoke a command with an optional topic and optional value.
-     * This will invoke the specified command in the backend. It does not broadcast the
-     * value within the local frontend.
-     * @param domain string The domain of the command that will be invoked.
-     * @param fname string Function name
-     * @param topic string Topic
-     * @param value any data payload
+     * Subscribe to updates for a specific resource.
+     *
+     * Registers a mapping so that when the server sends updates for `topic` (FQDN),
+     * the Hub will translate it to `tagName` before dispatching to the UI.
+     *
+     * @param tagName The local alias for this resource (e.g., "position").
+     * @param topic The backend FQDN (e.g., "ADS.Main.fPos").
+     * @param payload Optional subscription parameters (rate, deadband).
      */
-    invokeTopic(domain: string, fname: string, topic: string | null, value?: any): Promise<CommandMessageResult>;
+    subscribe(tagName: string, topic: string, payload?: object): Promise<CommandMessage>;
     /**
-     * Pubish a topic throughout the web app using the
-     * Global EventEmitterContext. This will broadcast within the local frontend.
-     * This does NOT get relayed to the backend.
+     * Unsubscribe from updates.
+     *
+     * Uses the `tagName` to look up the FQDN and send the unsubscribe command.
+     * Also removes the local mapping.
+     *
+     * @param tagName The local alias to unsubscribe.
      */
-    publish(topic: string, data: any | undefined): void;
+    unsubscribe(/* topic: string,*/ tagName: string, payload?: object): Promise<CommandMessage>;
     /**
-     * Map a local topic to a topic in the backend.
-     * @param localTopic string
-     * @param backendTopic string
+     * Send a generic request (custom command).
      */
-    mapTopic(localTopic: string, backendTopic: string): void;
+    request(topic: string, payload?: object): Promise<CommandMessage>;
     /**
-     * Unmap a local topic.
-     * @param localTopic string
+     * Update internal connection state.
      */
-    unmapTopic(localTopic: string): void;
+    protected setIsConnected: (s: boolean) => void;
     /**
-     * Map a local function name, as would be sent to the invoke method, to a
-     * function name in the backend.
-     * @param localFName string
-     * @param backendFName string
+     * Check if currently connected to backend.
      */
-    mapFName(localFName: string, backendFName: string): void;
+    isConnected: () => boolean;
     /**
-     * Unmap a local function name.
-     * @param localFName string
+     * Dispatches an event to the React application.
+     *
+     * 1. Translates the `topic` (potentially an FQDN) to a local `tagName` if a mapping exists.
+     * 2. Calls `context.dispatch()` to notify local subscribers.
+     *
+     * This is the bridge between the backend transport and the frontend UI components.
+     *
+     * @param topic The topic from the message (usually FQDN).
+     * @param data The data payload.
      */
-    unmapFName(localFName: string): void;
+    publish(topic: string, data: any | undefined): void;
     /**
-     * Convert a local topic to a backend topic. If a mapping isn't
-     * registered, the local topic is returned.
-     * @param localTopic local topic name
-     * @returns string
+     * Registers a mapping between a local name and a backend FQDN.
      */
-    toBackendTopic(localTopic: string): string;
+    mapTopic(localTopic: string, backendTopic: string): void;
     /**
-     * Convert a local function name to a backend function name. If a mapping isn't
-     * registered, the local FName is returned.
-     * @param localTopic local function name
-     * @returns string
+     * Removes a mapping.
      */
-    toBackendFName(localFName: string): string;
+    unmapTopic(localTopic: string): void;
     /**
-     * Convert a backend topic to a local topic. If a mapping isn't
-     * registered, the backend topic is returned.
-     * @param backendTopic backend topic name
-     * @returns string
+     * Translates Local Name -> Backend FQDN.
      */
-    toLocalTopic(backendTopic: string): string;
+    toBackendTopic(localTopic: string): string;
     /**
-     * Convert a backend function name to a local function name. If a mapping isn't
-     * registered, the backend function name is returned.
-     * @param backendTopic backend function name
-     * @returns string
+     * Translates Backend FQDN -> Local Name.
      */
-    toLocalFName(backendTopic: string): string;
+    toLocalTopic(backendTopic: string): string;
 }
 export default HubBase;
 //# sourceMappingURL=HubBase.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"HubBase.d.ts","sourceRoot":"","sources":["../../src/hub/HubBase.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,uBAAuB,EAAC,MAAM,6BAA6B,CAAC;AAC1E,OAAO,KAAK,EAAC,oBAAoB,EAAC,MAAM,kBAAkB,CAAC;AAG3D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwEG;AACH,8BAAsB,OAAO;IAEzB,SAAS,CAAC,2BAA2B,EAAG,GAAG,CAAC,MAAM,EAAC,MAAM,CAAC,CAA4B;IACtF,SAAS,CAAC,sBAAsB,EAAG,GAAG,CAAC,MAAM,EAAC,MAAM,CAAC,CAA4B;IACjF,SAAS,CAAC,2BAA2B,EAAG,GAAG,CAAC,MAAM,EAAC,MAAM,CAAC,CAA4B;IACtF,SAAS,CAAC,2BAA2B,EAAG,GAAG,CAAC,MAAM,EAAC,MAAM,CAAC,CAA4B;IAEtF,SAAS,CAAC,OAAO,EAAG,uBAAuB,GAAG,IAAI,CAAQ;IAE1D,SAAS,CAAC,YAAY,EAAG,OAAO,CAAS;IAGzC;;OAEG;;IAKH;;;;;;;;;;OAUG;IACH,UAAU,CAAC,OAAO,EAAG,uBAAuB,GAAG,IAAI;IAInD;;;OAGG;IACH,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAG,MAAM,GAAI,OAAO,CAAC,oBAAoB,CAAC;IAGjG;;;OAGG;IACH,SAAS,CAAC,cAAc,GAAI,GAAI,OAAO,UAEtC;IAED;;OAEG;IACH,WAAW,QAAQ,OAAO,CAEzB;IAED;;;;;;;;OAQG;IACH,WAAW,CAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAG,MAAM,EAAE,KAAK,EAAG,MAAM,GAAG,IAAI,EAAE,KAAK,CAAC,EAAG,GAAG,GAAK,OAAO,CAAC,oBAAoB,CAAC;IAQlH;;;;OAIG;IACH,OAAO,CAAC,KAAK,EAAG,MAAM,EAAE,IAAI,EAAG,GAAG,GAAG,SAAS,GAAI,IAAI;IAWtD;;;;OAIG;IACH,QAAQ,CAAC,UAAU,EAAG,MAAM,EAAE,YAAY,EAAE,MAAM,GAAK,IAAI;IAK3D;;;OAGG;IACH,UAAU,CAAC,UAAU,EAAE,MAAM,GAAI,IAAI;IAYrC;;;;;OAKG;IACH,QAAQ,CAAC,UAAU,EAAG,MAAM,EAAE,YAAY,EAAE,MAAM,GAAK,IAAI;IAK3D;;;OAGG;IACH,UAAU,CAAC,UAAU,EAAE,MAAM,GAAI,IAAI;IAYrC;;;;;OAKG;IACH,cAAc,CAAC,UAAU,EAAG,MAAM,GAAI,MAAM;IAa5C;;;;;OAKG;IACH,cAAc,CAAC,UAAU,EAAG,MAAM,GAAI,MAAM;IAc5C;;;;;OAKG;IACH,YAAY,CAAC,YAAY,EAAG,MAAM,GAAI,MAAM;IAc5C;;;;;OAKG;IACH,YAAY,CAAC,YAAY,EAAG,MAAM,GAAI,MAAM;CAc/C;AAGD,eAAe,OAAO,CAAC"}
+{"version":3,"file":"HubBase.d.ts","sourceRoot":"","sources":["../../src/hub/HubBase.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AAC3E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAG/C;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,8BAAsB,OAAO;IAEzB,6CAA6C;IAC7C,SAAS,CAAC,2BAA2B,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAA6B;IAEvF,6CAA6C;IAC7C,SAAS,CAAC,sBAAsB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAA6B;IAElF,+EAA+E;IAC/E,SAAS,CAAC,OAAO,EAAE,uBAAuB,GAAG,IAAI,CAAQ;IAEzD,gCAAgC;IAChC,SAAS,CAAC,YAAY,EAAE,OAAO,CAAS;IAGxC;;OAEG;;IAKH;;;;;;;OAOG;IACH,UAAU,CAAC,OAAO,EAAE,uBAAuB,GAAG,IAAI;IAQlD;;;;;;;OAOG;IACH,QAAQ,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAMnG;;;;OAIG;IACH,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAI9D;;;;;OAKG;IACH,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,OAAO,CAAC,cAAc,CAAC;IAIzD;;;;;;;;;OASG;IACH,SAAS,CAAC,OAAO,EAAG,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAKrF;;;;;;;OAOG;IACH,WAAW,CAAE,mBAAmB,CAAC,OAAO,EAAG,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAM7F;;OAEG;IACH,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAQjE;;OAEG;IACH,SAAS,CAAC,cAAc,GAAI,GAAG,OAAO,UAErC;IAED;;OAEG;IACH,WAAW,QAAO,OAAO,CAExB;IAMD;;;;;;;;;;OAUG;IACH,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG,SAAS,GAAG,IAAI;IAcnD;;OAEG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI;IAKxD;;OAEG;IACH,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAWpC;;OAEG;IACH,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM;IAK1C;;OAEG;IACH,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM;CAI7C;AAGD,eAAe,OAAO,CAAC"}

package/dist/hub/HubBase.js

@@ -1 +1 @@
-export class HubBase{constructor(){Object.defineProperty(this,"localTopicToBackendTopicMap",{enumerable:!0,configurable:!0,writable:!0,value:new Map}),Object.defineProperty(this,"backendTopicToLocalMap",{enumerable:!0,configurable:!0,writable:!0,value:new Map}),Object.defineProperty(this,"localFNameToBackendFNameMap",{enumerable:!0,configurable:!0,writable:!0,value:new Map}),Object.defineProperty(this,"backendFNameToLocalFNameMap",{enumerable:!0,configurable:!0,writable:!0,value:new Map}),Object.defineProperty(this,"context",{enumerable:!0,configurable:!0,writable:!0,value:null}),Object.defineProperty(this,"isConnected_",{enumerable:!0,configurable:!0,writable:!0,value:!1}),Object.defineProperty(this,"setIsConnected",{enumerable:!0,configurable:!0,writable:!0,value:e=>{this.isConnected_=e}}),Object.defineProperty(this,"isConnected",{enumerable:!0,configurable:!0,writable:!0,value:()=>this.isConnected_})}setContext(e){this.context=e}invokeTopic(e,a,o,c){const t={topic:o,data:c};return this.invoke(e,a,t)}publish(e,a){const o=this.toLocalTopic(e);this.context?.dispatch({topic:o,payload:a})}mapTopic(e,a){this.localTopicToBackendTopicMap.set(e,a),this.backendTopicToLocalMap.set(a,e)}unmapTopic(e){if(this.localTopicToBackendTopicMap.has(e)){const a=this.localTopicToBackendTopicMap.get(e);this.localTopicToBackendTopicMap.delete(e),null!=a&&this.backendTopicToLocalMap.has(a)&&this.backendTopicToLocalMap.delete(a)}}mapFName(e,a){this.localFNameToBackendFNameMap.set(e,a),this.backendFNameToLocalFNameMap.set(a,e)}unmapFName(e){if(this.localFNameToBackendFNameMap.has(e)){const a=this.localFNameToBackendFNameMap.get(e);this.localFNameToBackendFNameMap.delete(e),null!=a&&this.backendFNameToLocalFNameMap.has(a)&&this.backendFNameToLocalFNameMap.delete(a)}}toBackendTopic(e){if(this.localTopicToBackendTopicMap.has(e)){const a=this.localTopicToBackendTopicMap.get(e);return null!=a?a:e}return e}toBackendFName(e){if(this.localFNameToBackendFNameMap.has(e)){const a=this.localFNameToBackendFNameMap.get(e);return null!=a?a:e}return e}toLocalTopic(e){if(this.backendTopicToLocalMap.has(e)){const a=this.backendTopicToLocalMap.get(e);return null!=a?a:e}return e}toLocalFName(e){if(this.backendFNameToLocalFNameMap.has(e)){const a=this.backendFNameToLocalFNameMap.get(e);return null!=a?a:e}return e}}export default HubBase;
+import{MessageType}from"./CommandMessage";export class HubBase{constructor(){Object.defineProperty(this,"localTopicToBackendTopicMap",{enumerable:!0,configurable:!0,writable:!0,value:new Map}),Object.defineProperty(this,"backendTopicToLocalMap",{enumerable:!0,configurable:!0,writable:!0,value:new Map}),Object.defineProperty(this,"context",{enumerable:!0,configurable:!0,writable:!0,value:null}),Object.defineProperty(this,"isConnected_",{enumerable:!0,configurable:!0,writable:!0,value:!1}),Object.defineProperty(this,"setIsConnected",{enumerable:!0,configurable:!0,writable:!0,value:e=>{this.isConnected_=e}}),Object.defineProperty(this,"isConnected",{enumerable:!0,configurable:!0,writable:!0,value:()=>this.isConnected_})}setContext(e){this.context=e}read(e,t){return this.invoke(e,MessageType.Read,t)}write(e,t){return this.invoke(e,MessageType.Write,{value:t})}subscribe(e,t,i){return this.mapTopic(e,t),this.invoke(t,MessageType.Subscribe,i)}unsubscribe(e,t){const i=this.toBackendTopic(e);return this.unmapTopic(e),this.invoke(i,MessageType.Unsubscribe,t)}request(e,t){return this.invoke(e,MessageType.Request,t)}publish(e,t){const i=this.toLocalTopic(e);this.context?.dispatch({topic:i,payload:t})}mapTopic(e,t){this.localTopicToBackendTopicMap.set(e,t),this.backendTopicToLocalMap.set(t,e)}unmapTopic(e){if(this.localTopicToBackendTopicMap.has(e)){const t=this.localTopicToBackendTopicMap.get(e);this.localTopicToBackendTopicMap.delete(e),null!=t&&this.backendTopicToLocalMap.has(t)&&this.backendTopicToLocalMap.delete(t)}}toBackendTopic(e){return this.localTopicToBackendTopicMap.get(e)??e}toLocalTopic(e){return this.backendTopicToLocalMap.get(e)??e}}export default HubBase;

package/dist/hub/HubSimulate.d.ts

@@ -1,22 +1,55 @@
 import { HubBase } from './HubBase';
-import type { CommandMessageResult } from "./CommandMessage";
+import type { CommandMessage } from "./CommandMessage";
+import { MessageType } from "./CommandMessage";
 /**
- * Hub for simulating functionality when no backend is present.
+ * Hub for simulating backend functionality when no actual backend is present.
+ *
+ * Useful for development, testing, and demos without a running autocore-server.
+ * The simulator echoes back requests as successful responses after a configurable delay.
+ *
+ * ## Usage Examples
+ *
+ * ```typescript
+ * const { hub } = useContext(EventEmitterContext);
+ *
+ * // Read returns the topic as the "value"
+ * const result = await hub.read("ads.plc1.gio.bControlPowerOk");
+ * console.log(result.data); // { value: "ads.plc1.gio.bControlPowerOk" }
+ *
+ * // Write echoes back the written value
+ * await hub.write("ads.plc1.gio.nSetpoint", 100);
+ * ```
  */
 export declare class HubSimulate extends HubBase {
+    private responseDelay;
     /**
      * Constructor
+     * @param responseDelay Simulated response delay in milliseconds (default: 20ms)
      */
-    constructor();
+    constructor(responseDelay?: number);
     /**
-     * Invoke a method in the Socket.IO backend and wait for acknowledgment.
+     * Simulate sending a message to a backend.
      *
-     * @param fname method name
+     * For Read operations, returns the topic as the value.
+     * For Write operations, echoes back the payload.
+     * For all operations, returns a successful response after the configured delay.
+     *
+     * @param topic The FQDN of the resource
+     * @param messageType The action to perform
      * @param payload Optional data payload
-     * @param timeout Timeout in milliseconds after which the promise is rejected if no response is received.
-     * @returns A Promise that resolves to the response from the backend or rejects if a timeout occurs.
+     * @returns Promise<CommandMessage> A simulated successful response
+     */
+    invoke(topic: string, messageType: MessageType, payload?: object): Promise<CommandMessage>;
+    /**
+     * Simulate a broadcast from the "backend".
+     *
+     * This is useful for testing subscription handlers.
+     *
+     * @param topic The topic to broadcast on
+     * @param data The data to broadcast
+     * @param delay Optional delay before broadcasting (default: 0ms)
      */
-    invoke(domain: string, fname: string, payload?: object, timeout?: number): Promise<CommandMessageResult>;
+    simulateBroadcast(topic: string, data: any, delay?: number): void;
 }
 export default HubSimulate;
 //# sourceMappingURL=HubSimulate.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"HubSimulate.d.ts","sourceRoot":"","sources":["../../src/hub/HubSimulate.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAC7D;;GAEG;AACH,qBAAa,WAAY,SAAQ,OAAO;IAEpC;;OAEG;;IAKH;;;;;;;OAOG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,GAAE,MAAW,GAAG,OAAO,CAAC,oBAAoB,CAAC;CAmB/G;AAED,eAAe,WAAW,CAAC"}
+{"version":3,"file":"HubSimulate.d.ts","sourceRoot":"","sources":["../../src/hub/HubSimulate.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,WAAY,SAAQ,OAAO;IAEpC,OAAO,CAAC,aAAa,CAAS;IAE9B;;;OAGG;gBACS,aAAa,GAAE,MAAW;IAMtC;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAgD1F;;;;;;;;OAQG;IACH,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,GAAE,MAAU,GAAG,IAAI;CAKvE;AAED,eAAe,WAAW,CAAC"}

package/dist/hub/HubSimulate.js

@@ -1 +1 @@
-import{HubBase}from"./HubBase";export class HubSimulate extends HubBase{constructor(){super()}invoke(e,s,r,t=20){return new Promise((e,s)=>{setTimeout(()=>{e({data:r,error_message:"",success:!0})},t)})}}export default HubSimulate;
+import{HubBase}from"./HubBase";import{MessageType}from"./CommandMessage";export class HubSimulate extends HubBase{constructor(e=20){super(),Object.defineProperty(this,"responseDelay",{enumerable:!0,configurable:!0,writable:!0,value:void 0}),this.responseDelay=e,this.setIsConnected(!0)}invoke(e,s,a){return new Promise(t=>{setTimeout(()=>{let r;switch(s){case MessageType.Read:r={value:e,simulated:!0};break;case MessageType.Write:r={written:!0,...a};break;case MessageType.Subscribe:r={subscribed:!0,topic:e};break;case MessageType.Unsubscribe:r={unsubscribed:!0,topic:e};break;default:r=a??{}}const i={transaction_id:0,timecode:Date.now(),topic:e,message_type:MessageType.Response,data:r,success:!0,error_message:""};t(i)},this.responseDelay)})}simulateBroadcast(e,s,a=0){setTimeout(()=>{this.publish(e,s)},a)}}export default HubSimulate;