abb-rws-client 0.2.0 → 0.7.1

package/dist/index.d.ts

@@ -1,10 +1,37 @@
 /**
  * abb-rws-client — public API
  *
- * Typed HTTP/WebSocket client for ABB IRC5 robot controllers (RWS 1.0, RobotWare 6.x only).
- * Not compatible with RWS 2.0 / RobotWare 7.x / OmniCore.
+ * Typed HTTP/WebSocket client for ABB robot controllers, covering BOTH RWS protocols:
+ *   - RWS 1.0 — IRC5 / RobotWare 6.x   → use `RwsClient` (HTTP Digest, JSON via ?json=1)
+ *   - RWS 2.0 — OmniCore / RobotWare 7.x → use `RwsClient2` (HTTP Basic, XHTML;v=2.0)
+ *
+ * Don't know which protocol the controller speaks? Use `createClient(host)` —
+ * it probes the WWW-Authenticate header and returns the right one.
+ *
+ * For polymorphic code that wants a single type across both protocols, use
+ * the `IRWSAdapter` interface and the `RWS1Adapter` / `RWS2Adapter` wrappers
+ * — or the `createAdapter(host)` helper.
+ *
+ * Higher-level helpers:
+ *   - `RobotManager` — connection lifecycle, polling, WS subscriptions, port discovery
+ *   - `MultiRobotManager` — multi-controller orchestration
+ *   - `XhtmlParser` — RWS 2.0 response parser (exported for advanced users)
+ *   - `setLogger(impl)` — install your own logging backend
  */
 export { RwsClient } from './RwsClient.js';
+export { RwsClient2 } from './RwsClient2.js';
+export { RWS1Adapter } from './RWS1Adapter.js';
+export { RWS2Adapter } from './RWS2Adapter.js';
+export type { IRWSAdapter } from './IRWSAdapter.js';
+export { RobotManager } from './RobotManager.js';
+export type { RobotState, ChangeHandler, ProbeResult, DiscoveredController, ErrorListener } from './RobotManager.js';
+export { MultiRobotManager } from './MultiRobotManager.js';
+export type { RobotConfig } from './MultiRobotManager.js';
+export { createClient, createAdapter, probeHost, probeProtocol } from './detect.js';
+export type { AnyClient, Protocol, ConnectOptions, ProbeResult as DetectProbeResult } from './detect.js';
+export { XhtmlParser } from './XhtmlParser.js';
+export { setLogger } from './Logger.js';
+export type { Logger } from './Logger.js';
 export { RwsError } from './types.js';
-export type { RwsClientOptions, RwsErrorCode, ControllerState, OperationMode, ExecutionState, JointTarget, RobTarget, Signal, RapidTask, SubscriptionResource, SubscriptionEvent, } from './types.js';
+export type { RwsClientOptions, RwsErrorCode, ControllerState, OperationMode, ExecutionState, ExecutionInfo, ExecutionCycle, JointTarget, RobTarget, CartesianFull, Signal, RapidTask, IoNetwork, IoDevice, SystemInfo, ControllerIdentity, ControllerClock, ElogMessage, FileEntry, MastershipDomain, CollisionDetectionState, RapidSymbolProperties, RapidSymbolInfo, RapidSymbolSearchParams, UiInstruction, RestartMode, SubscriptionResource, SubscriptionEvent, } from './types.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC,YAAY,EACV,gBAAgB,EAChB,YAAY,EACZ,eAAe,EACf,aAAa,EACb,cAAc,EACd,WAAW,EACX,SAAS,EACT,MAAM,EACN,SAAS,EACT,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAG7C,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,YAAY,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAGpD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,WAAW,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACrH,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,YAAY,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAG1D,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACpF,YAAY,EAAE,SAAS,EAAE,QAAQ,EAAE,cAAc,EAAE,WAAW,IAAI,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAGzG,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,YAAY,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAG1C,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAGtC,YAAY,EACV,gBAAgB,EAChB,YAAY,EACZ,eAAe,EACf,aAAa,EACb,cAAc,EACd,aAAa,EACb,cAAc,EACd,WAAW,EACX,SAAS,EACT,aAAa,EACb,MAAM,EACN,SAAS,EACT,SAAS,EACT,QAAQ,EACR,UAAU,EACV,kBAAkB,EAClB,eAAe,EACf,WAAW,EACX,SAAS,EACT,gBAAgB,EAChB,uBAAuB,EACvB,qBAAqB,EACrB,eAAe,EACf,uBAAuB,EACvB,aAAa,EACb,WAAW,EACX,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -1,9 +1,37 @@
 /**
  * abb-rws-client — public API
  *
- * Typed HTTP/WebSocket client for ABB IRC5 robot controllers (RWS 1.0, RobotWare 6.x only).
- * Not compatible with RWS 2.0 / RobotWare 7.x / OmniCore.
+ * Typed HTTP/WebSocket client for ABB robot controllers, covering BOTH RWS protocols:
+ *   - RWS 1.0 — IRC5 / RobotWare 6.x   → use `RwsClient` (HTTP Digest, JSON via ?json=1)
+ *   - RWS 2.0 — OmniCore / RobotWare 7.x → use `RwsClient2` (HTTP Basic, XHTML;v=2.0)
+ *
+ * Don't know which protocol the controller speaks? Use `createClient(host)` —
+ * it probes the WWW-Authenticate header and returns the right one.
+ *
+ * For polymorphic code that wants a single type across both protocols, use
+ * the `IRWSAdapter` interface and the `RWS1Adapter` / `RWS2Adapter` wrappers
+ * — or the `createAdapter(host)` helper.
+ *
+ * Higher-level helpers:
+ *   - `RobotManager` — connection lifecycle, polling, WS subscriptions, port discovery
+ *   - `MultiRobotManager` — multi-controller orchestration
+ *   - `XhtmlParser` — RWS 2.0 response parser (exported for advanced users)
+ *   - `setLogger(impl)` — install your own logging backend
  */
+// Protocol clients
 export { RwsClient } from './RwsClient.js';
+export { RwsClient2 } from './RwsClient2.js';
+// Unified-interface adapters
+export { RWS1Adapter } from './RWS1Adapter.js';
+export { RWS2Adapter } from './RWS2Adapter.js';
+// High-level managers
+export { RobotManager } from './RobotManager.js';
+export { MultiRobotManager } from './MultiRobotManager.js';
+// Auto-detection helpers
+export { createClient, createAdapter, probeHost, probeProtocol } from './detect.js';
+// Helpers
+export { XhtmlParser } from './XhtmlParser.js';
+export { setLogger } from './Logger.js';
+// Errors
 export { RwsError } from './types.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,mBAAmB;AACnB,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,6BAA6B;AAC7B,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAG/C,sBAAsB;AACtB,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAG3D,yBAAyB;AACzB,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAGpF,UAAU;AACV,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAGxC,SAAS;AACT,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC"}

package/dist/types.d.ts

@@ -1,6 +1,12 @@
 export type ControllerState = 'init' | 'motoroff' | 'motoron' | 'guardstop' | 'emergencystop' | 'emergencystopreset' | 'sysfail';
 export type OperationMode = 'AUTO' | 'MANR' | 'MANF';
 export type ExecutionState = 'running' | 'stopped';
+/** Full execution state including current cycle mode. */
+export interface ExecutionInfo {
+    state: ExecutionState;
+    /** Current cycle mode: 'once' | 'forever' | 'asis' | 'oncedone' */
+    cycle: string;
+}
 export interface JointTarget {
     rax_1: number;
     rax_2: number;
@@ -32,12 +38,185 @@ export interface RapidTask {
     active: boolean;
     motiontask: boolean;
 }
+/** Extended RobTarget that includes robot configuration flags returned by /cartesian */
+export interface CartesianFull extends RobTarget {
+    /** Shoulder configuration: 0 = front, -1 = back */
+    j1: number;
+    /** Elbow configuration: -1 = down, 1 = up */
+    j4: number;
+    /** Wrist configuration: -1 = flip, 1 = no flip */
+    j6: number;
+    /** External axis configuration */
+    jx: number;
+}
+export interface IoNetwork {
+    name: string;
+    /** Physical state: 'running' | 'stopped' */
+    pstate: string;
+    /** Logical state: 'started' | 'stopped' */
+    lstate: string;
+}
+export interface IoDevice {
+    name: string;
+    network: string;
+    lstate: string;
+    pstate: string;
+    address: string;
+}
+export interface SystemInfo {
+    /** Controller/system name */
+    name: string;
+    /** RobotWare version string, e.g. '6.13.0164' */
+    rwVersion: string;
+    /** System GUID */
+    sysid: string;
+    /** Timestamp when RobotWare started */
+    startTime: string;
+    /** Licensed RobotWare options */
+    options: string[];
+}
+export interface ControllerIdentity {
+    /** Controller name */
+    name: string;
+    /** Controller ID */
+    id: string;
+    /** 'Real Controller' | 'Virtual Controller' */
+    type: string;
+    /** MAC address */
+    mac: string;
+}
+export interface ElogMessage {
+    /** Sequence number */
+    seqnum: number;
+    /** Event code, e.g. 10126 */
+    code: number;
+    /** 1 = info, 2 = warning, 3 = error */
+    msgtype: number;
+    /** Timestamp string from controller */
+    timestamp: string;
+    /** Source name (subsystem that generated the event) */
+    srcName: string;
+    title: string;
+    desc: string;
+    causes: string;
+    consequences: string;
+    actions: string;
+}
+/** Controller clock date/time. */
+export interface ControllerClock {
+    /** Format: 'YYYY-MM-DD T HH:MM:SS' */
+    datetime: string;
+}
+/** Active RAPID UI instruction (e.g. TPReadNum, TPReadFK waiting for input). */
+export interface UiInstruction {
+    /** Instruction name, e.g. 'TPReadNum', 'TPReadFK' */
+    instr: string;
+    /** Event type: 'SEND' | 'POST' | 'ABORT' */
+    event: string;
+    /** Stack URL — used as {stackurl} when setting a parameter value */
+    stack: string;
+    /** Execution level: 'NORMAL' | 'TRAP' | ... */
+    execlv: string;
+    /** Message text displayed on FlexPendant */
+    msg: string;
+}
+/** A RAPID symbol found by search (abbreviated properties). */
+export interface RapidSymbolInfo {
+    /** Full symbol path, e.g. 'RAPID/T_ROB1/user/reg1' */
+    symburl: string;
+    name: string;
+    /** Symbol type: 'var' | 'per' | 'con' | 'fun' | 'prc' | etc. */
+    symtyp: string;
+    /** Data type name, e.g. 'num', 'string', 'bool', 'robtarget' */
+    dattyp: string;
+    /** Number of array dimensions (0 = scalar) */
+    ndim: number;
+    local: boolean;
+    ro: boolean;
+    taskvar: boolean;
+}
+/** Parameters for RAPID symbol search. */
+export interface RapidSymbolSearchParams {
+    /** Task name; required */
+    task: string;
+    /** Search scope: 'block' | 'scope' | 'stack' */
+    view?: 'block' | 'scope' | 'stack';
+    /** Variable filter: 'rw' | 'ro' | 'loop' | 'any' */
+    vartyp?: string;
+    /** Symbol type filter: 'var' | 'per' | 'con' | 'fun' | 'prc' | 'mod' | 'tsk' | 'any' */
+    symtyp?: string;
+    /** Data type filter, e.g. 'num', 'bool', 'robtarget' */
+    dattyp?: string;
+    /** Regex pattern for symbol name matching */
+    regexp?: string;
+    /** Whether to search recursively; default true */
+    recursive?: boolean;
+    /** URL of module/routine to search within */
+    blockurl?: string;
+}
+/** Controller restart mode. */
+export type RestartMode = 'restart' | 'istart' | 'pstart' | 'bstart';
+export interface FileEntry {
+    name: string;
+    type: 'file' | 'dir';
+    /** File size in bytes (files only) */
+    size?: number;
+    /** Creation timestamp from controller */
+    created?: string;
+    /** Last-modified timestamp from controller */
+    modified?: string;
+    /** Whether the file is read-only (files only) */
+    readonly?: boolean;
+}
+export type MastershipDomain = 'cfg' | 'motion' | 'rapid';
+/**
+ * Collision detection state returned by GET /rw/panel/coldetstate.
+ * INIT = no collision detected (normal operation).
+ * TRIGGERED = collision detected, not yet acknowledged.
+ * CONFIRMED = collision confirmed.
+ * TRIGGERED_ACK = collision acknowledged.
+ */
+export type CollisionDetectionState = 'INIT' | 'TRIGGERED' | 'CONFIRMED' | 'TRIGGERED_ACK';
+/** Execution cycle mode returned/set by /rw/rapid/execution */
+export type ExecutionCycle = 'once' | 'forever' | 'asis';
+/**
+ * RAPID symbol properties returned by GET /rw/rapid/symbol/properties/RAPID/{task}/{module}/{symbol}.
+ * symtyp: 'var' | 'per' | 'con' | 'par' | 'fun' | 'prc' | 'mod' | 'tsk' | 'any' | 'udef' | 'atm' | 'rec' | 'ali' | 'rcp'
+ */
+export interface RapidSymbolProperties {
+    /** Full symbol URL path */
+    symburl: string;
+    /** Symbol type: var/per/con/par/fun/prc/mod/tsk/any/udef/atm/rec/ali/rcp */
+    symtyp: string;
+    /** Whether the symbol has a name */
+    named: boolean;
+    /** Data type name, e.g. 'num', 'string', 'bool', 'robtarget' */
+    dattyp: string;
+    /** Number of array dimensions (0 = scalar) */
+    ndim: number;
+    /** Dimension sizes as a string, e.g. '[3]' for 3-element array */
+    dim: string;
+    /** Whether the symbol is heap-allocated */
+    heap: boolean;
+    /** Whether the symbol definition is complete (linked) */
+    linked: boolean;
+    /** Whether the symbol is module-local (not global) */
+    local: boolean;
+    /** Whether the persistent is read-only */
+    ro: boolean;
+    /** Whether the symbol is task-global (taskvar) */
+    taskvar: boolean;
+    /** Storage type: 'local' | 'task' | 'global' */
+    storage: string;
+    /** URL reference to the type symbol */
+    typurl: string;
+}
 export interface RwsClientOptions {
     /** IP address or hostname, e.g. '192.168.125.1' or '127.0.0.1' for RobotStudio */
     host: string;
     /** HTTP port; default 80 */
     port?: number;
-    /** Default 'Default User' */
+    /** Default 'Admin' */
     username?: string;
     /** Default 'robotics' */
     password?: string;
@@ -48,19 +227,27 @@ export interface RwsClientOptions {
     /** Saved -http-session- cookie value to reuse an existing controller session slot */
     sessionCookie?: string;
 }
-export type SubscriptionResource = 'execution' | 'controllerstate' | 'operationmode' | {
+export type SubscriptionResource = 'execution' | 'controllerstate' | 'operationmode' | 'speedratio' | 'coldetstate' | 'uiinstr' | {
     type: 'signal';
     name: string;
 } | {
     type: 'persvar';
     name: string;
+} | {
+    type: 'taskchange';
+    task: string;
+} | {
+    type: 'execycle';
+} | {
+    type: 'elog';
+    domain: number;
 };
 export interface SubscriptionEvent {
     resource: string;
     value: string;
     timestamp: Date;
 }
-export type RwsErrorCode = 'SESSION_EXPIRED' | 'AUTH_FAILED' | 'MOTORS_OFF' | 'MODULE_NOT_FOUND' | 'RATE_LIMITED' | 'CONTROLLER_BUSY' | 'NETWORK_ERROR' | 'PARSE_ERROR' | 'UNKNOWN';
+export type RwsErrorCode = 'SESSION_EXPIRED' | 'AUTH_FAILED' | 'MOTORS_OFF' | 'MODULE_NOT_FOUND' | 'RATE_LIMITED' | 'CONTROLLER_BUSY' | 'NETWORK_ERROR' | 'PARSE_ERROR' | 'PROTOCOL_DETECT_FAILED' | 'UNKNOWN';
 /**
  * Typed error thrown by all abb-rws-client public methods.
  * Always check `code` for programmatic error handling.

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -1,5 +1,6 @@
 // abb-rws-client — type definitions
 // Targets RWS 1.0 (RobotWare 6.x) only. Not compatible with RWS 2.0 / RobotWare 7.x / OmniCore.
+// v0.5.0 — added: UI instructions, RAPID symbol search, controller clock, execution cycle in state, task activate/deactivate, elog seqnum, subscription coldetstate/execycle/elog/uiinstr, opmode lock, controller restart
 /**
  * Typed error thrown by all abb-rws-client public methods.
  * Always check `code` for programmatic error handling.

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,oCAAoC;AACpC,gGAAgG;AA0FhG;;;GAGG;AACH,MAAM,OAAO,QAAS,SAAQ,KAAK;IACxB,IAAI,CAAe;IACnB,UAAU,CAAU;IACpB,SAAS,CAAU;IAE5B,YAAY,OAAe,EAAE,IAAkB,EAAE,UAAmB,EAAE,SAAkB;QACtF,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;QACvB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,oFAAoF;QACpF,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACpD,CAAC;CACF"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,oCAAoC;AACpC,gGAAgG;AAChG,2NAA2N;AAqS3N;;;GAGG;AACH,MAAM,OAAO,QAAS,SAAQ,KAAK;IACxB,IAAI,CAAe;IACnB,UAAU,CAAU;IACpB,SAAS,CAAU;IAE5B,YAAY,OAAe,EAAE,IAAkB,EAAE,UAAmB,EAAE,SAAkB;QACtF,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;QACvB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,oFAAoF;QACpF,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACpD,CAAC;CACF"}

package/examples/01-quickstart-auto.mjs

@@ -0,0 +1,20 @@
+// Auto-detect protocol — works for both IRC5 (RWS 1.0) and OmniCore (RWS 2.0).
+// Useful when your code has to support both controller generations.
+
+import { createClient, RwsClient2 } from 'abb-rws-client';
+
+const client = await createClient({
+  host: process.env.RWS_HOST || '127.0.0.1',
+  // username/password default to 'Admin' / 'robotics' (built-in admin account, full UAS grants)
+});
+
+console.log(`Connected via ${client instanceof RwsClient2 ? 'RWS 2.0' : 'RWS 1.0'}`);
+
+const state = await client.getControllerState();   // 'motoron' | 'motoroff' | 'init' | …
+const mode  = await client.getOperationMode();     // 'AUTO' | 'MANR' | 'MANF'
+const speed = await client.getSpeedRatio();
+const exec  = await client.getRapidExecutionState();
+
+console.log({ state, mode, speed, execstate: exec });
+
+await client.disconnect();

package/examples/02-rws1-explicit.mjs

@@ -0,0 +1,30 @@
+// Explicit RWS 1.0 client — for IRC5 controllers (RobotWare 6.x).
+// Use this when you only target RWS 1.0 and don't need protocol detection.
+
+import { RwsClient } from 'abb-rws-client';
+
+const client = new RwsClient({
+  host: process.env.RWS_HOST || '192.168.125.1',
+  port: 80,
+  username: 'Admin',
+  password: 'robotics',
+});
+
+await client.connect();
+
+// Controller / panel
+console.log('state:', await client.getControllerState());
+console.log('opmode:', await client.getOperationMode());
+
+// Motion
+console.log('joints:', await client.getJointPositions());
+console.log('cartesian:', await client.getCartesianPosition());
+
+// RAPID
+console.log('tasks:', (await client.getRapidTasks()).map(t => t.name));
+console.log('modules:', await client.listModules('T_ROB1'));
+
+// I/O
+console.log('signals (first 5):', (await client.listAllSignals(0, 5)).map(s => `${s.name}=${s.value}`));
+
+await client.disconnect();

package/examples/03-rws2-explicit.mjs

@@ -0,0 +1,26 @@
+// Explicit RWS 2.0 client — for OmniCore controllers (RobotWare 7.x).
+// Use this when you only target RWS 2.0 and don't need protocol detection.
+
+import { RwsClient2 } from 'abb-rws-client';
+
+// RWS 2.0 wants a base URL (scheme + host + port) instead of separate fields.
+// Real OmniCore: https://<host>:443     |   VC: https://127.0.0.1:5466
+const client = new RwsClient2(
+  process.env.RWS_URL || 'https://127.0.0.1:5466',
+  'Admin',
+  'robotics',
+);
+
+await client.connect();
+
+console.log('state:', await client.getControllerState());
+console.log('opmode:', await client.getOperationMode());
+console.log('joints:', await client.getJointPositions());
+console.log('tasks:', (await client.getRapidTasks()).map(t => t.name));
+
+// RWS 2.0 symbol API: suffix-style (different from RWS 1.0).
+// Read a known-good symbol from BASE module:
+const tool0 = await client.getRapidVariable('T_ROB1', 'BASE', 'tool0');
+console.log('tool0:', tool0.slice(0, 60), '…');
+
+await client.disconnect();

package/examples/04-multi-robot.mjs

@@ -0,0 +1,35 @@
+// Multi-robot orchestration — manages multiple controllers in one process.
+// The MultiRobotManager keeps one robot "active" at a time (handy for UIs)
+// while still polling state for all of them.
+
+import { MultiRobotManager } from 'abb-rws-client';
+
+const multi = MultiRobotManager.fromConfigs([
+  { id: 'irb120-cell-A', name: 'Cell A IRB120',  host: '127.0.0.1', port: 5466,  useHttps: true,  username: 'Admin', password: 'robotics' },
+  { id: 'irb1200-cell-B', name: 'Cell B IRB1200', host: '127.0.0.1', port: 80,    useHttps: false, username: 'Admin', password: 'robotics' },
+]);
+
+// Single sink for connection failures across all robots.
+multi.onError(async (msg, actions) => {
+  console.error(`[MultiRobot] ${msg} — actions: ${actions.join(', ')}`);
+  return undefined; // headless: just log, don't auto-reconnect
+});
+
+multi.onDidChange(() => {
+  const a = multi.active;
+  if (a) {
+    console.log(`[${multi.activeId}] state=${a.state.ctrlstate} mode=${a.state.opmode}`);
+  }
+});
+
+// Connect each robot independently — failures don't stop the others.
+for (const { id } of multi.entries) {
+  await multi.connectRobot(id).catch(e => console.warn(`Could not connect ${id}: ${e.message}`));
+}
+
+// Run for 30s, observing state changes, then clean shutdown.
+await new Promise(r => setTimeout(r, 30_000));
+
+for (const { id } of multi.entries) {
+  await multi.disconnectRobot(id).catch(() => {});
+}

package/examples/05-remote-control-rmmp.mjs

@@ -0,0 +1,52 @@
+// Acquire Remote Mastership Privilege (RMMP) before doing modify ops.
+//
+// Without RMMP, AUTO-mode modify operations (start RAPID, set PP, write
+// variables, etc.) return HTTP 403 even when mastership is acquired. RMMP
+// is a separate user-level grant: requesting it triggers a popup on the
+// FlexPendant; the operator taps Allow once and you have write access.
+//
+// This is what RobotStudio Online does — that's why it "just works".
+
+import { RobotManager, RWS2Adapter, RwsClient2 } from 'abb-rws-client';
+
+const client = new RwsClient2({
+  host: process.env.RWS_HOST || '127.0.0.1',
+  port: Number(process.env.RWS_PORT) || 5466,
+  username: process.env.RWS_USER || 'Admin',
+  password: process.env.RWS_PASS || 'robotics',
+});
+await client.connect();
+
+const robot = new RobotManager({ adapter: new RWS2Adapter(client) });
+await robot.start();
+
+// 1) Check current RMMP state
+let priv = await robot.getRmmpPrivilege();
+console.log(`Current RMMP: ${priv}`);
+
+// 2) If no privilege, request it. The FlexPendant pops up; operator approves.
+if (priv === 'none') {
+  console.log('Requesting RMMP — operator must approve on the FlexPendant…');
+  await robot.requestRmmp('modify');
+
+  // Poll until the operator approves (or 30s timeout)
+  for (let i = 0; i < 30; i++) {
+    await new Promise(r => setTimeout(r, 1000));
+    priv = await robot.getRmmpPrivilege();
+    if (priv === 'modify' || priv === 'exclusive') { break; }
+    process.stdout.write('.');
+  }
+  console.log();
+}
+
+if (priv === 'modify' || priv === 'exclusive') {
+  console.log(`✓ ${priv} privilege granted. Modify ops will now work in AUTO.`);
+  // Example: PP-to-Main + start
+  // await robot.resetRapid();
+  // await robot.startRapid();
+} else {
+  console.log(`✗ Operator did not grant RMMP. Cannot do modify ops.`);
+}
+
+await robot.stop();
+await client.disconnect();

package/examples/06-pull-module-source.mjs

@@ -0,0 +1,38 @@
+// Download a loaded module's RAPID source from the controller.
+//
+// This is the typical "git workflow" entry point: pull what's currently
+// running, diff against your repo, push back when ready.
+//
+// Run: RWS_HOST=192.168.125.1 node examples/06-pull-module-source.mjs MotionTest
+
+import { createClient } from 'abb-rws-client';
+import { RobotManager, RWS2Adapter } from 'abb-rws-client';
+import * as fs from 'node:fs/promises';
+
+const moduleName = process.argv[2] ?? 'user';
+
+const client = await createClient({
+  host: process.env.RWS_HOST || '127.0.0.1',
+  port: Number(process.env.RWS_PORT) || undefined,
+});
+
+// Wrap with RobotManager only if you need lifecycle features. For a one-shot
+// pull, the raw client is enough.
+const isRws2 = client.constructor.name === 'RwsClient2';
+let source;
+if (isRws2) {
+  // RwsClient2 doesn't expose getModuleSource directly — go through the adapter.
+  const robot = new RobotManager({ adapter: new RWS2Adapter(client) });
+  await robot.start();
+  source = await robot.getModuleSource('T_ROB1', moduleName);
+  await robot.stop();
+} else {
+  // RWS 1.0 has it on the client.
+  source = await client.getModuleSource?.('T_ROB1', moduleName) ?? '';
+}
+
+await fs.writeFile(`${moduleName}.mod`, source, 'utf8');
+console.log(`✓ Wrote ${moduleName}.mod (${source.length} bytes)`);
+console.log('Now: git diff, edit, git commit, push back via loadModule.');
+
+await client.disconnect();

package/package.json

@@ -1,6 +1,24 @@
 {
   "name": "abb-rws-client",
-  "version": "0.2.0",
+  "version": "0.7.1",
+  "description": "Typed TypeScript/Node.js client for ABB Robot Web Services — supports both RWS 1.0 (IRC5/RobotWare 6) and RWS 2.0 (OmniCore/RobotWare 7).",
+  "keywords": [
+    "abb",
+    "robot",
+    "rws",
+    "robot-web-services",
+    "irc5",
+    "omnicore",
+    "robotstudio",
+    "robotware",
+    "industrial-robot"
+  ],
+  "license": "MIT",
+  "homepage": "https://github.com/merajsafari/abb-rws-client",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/merajsafari/abb-rws-client.git"
+  },
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -11,24 +29,32 @@
     }
   },
   "files": [
-    "dist"
+    "dist",
+    "examples",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
   ],
+  "engines": {
+    "node": ">=18"
+  },
   "scripts": {
     "build": "tsc",
     "test": "vitest run",
     "test:watch": "vitest",
-    "lint": "eslint src"
+    "lint": "eslint src",
+    "prepublishOnly": "npm run build && npm test"
   },
   "devDependencies": {
     "@types/node": "^20.0.0",
+    "@types/ws": "^8.18.1",
     "@typescript-eslint/eslint-plugin": "^8.0.0",
     "@typescript-eslint/parser": "^8.0.0",
     "eslint": "^9.0.0",
     "typescript": "^5.4.0",
-    "vitest": "^1.6.0"
+    "vitest": "^1.6.1"
   },
   "dependencies": {
-    "abb-rws-client": "file:abb-rws-client-0.1.4.tgz",
     "ws": "^8.20.0"
   }
 }