node-opcua-address-space-base 2.173.0 → 2.174.0

package/dist/proofOfConcept.d.ts

@@ -0,0 +1,72 @@
+import { NodeClass } from "node-opcua-data-model";
+interface IEventData {
+    source: string;
+}
+interface DataValue {
+    value: number;
+}
+interface NumericRange {
+    start: number;
+    end: number;
+}
+export interface BaseNodeEvents {
+    dispose: () => void;
+    event: (attribute: IEventData) => void;
+}
+export interface UAObjectEvents extends BaseNodeEvents {
+    Value_changed: (attribute: DataValue) => void;
+    DisplayName_changed: (attribute: DataValue) => void;
+    Description_changed: (attribute: DataValue) => void;
+    BrowseName_changed: (attribute: DataValue) => void;
+    RolePermissions_changed: (attribute: DataValue) => void;
+    AccessRestrictions_changed: (attribute: DataValue) => void;
+}
+export type ListenerSignature<L> = {
+    [E in keyof L]: (...args: any[]) => any;
+};
+export interface ITypedEventEmitter<T extends ListenerSignature<T>> {
+    on<K extends keyof T>(event: K, listener: T[K]): this;
+    once<K extends keyof T>(event: K, listener: T[K]): this;
+    emit<K extends keyof T>(event: K, ...args: Parameters<T[K]>): this;
+    off<K extends keyof T>(event: K, listener: T[K]): this;
+}
+export declare class TypedEventEmitter<T extends ListenerSignature<T>> implements ITypedEventEmitter<T> {
+    private emitter;
+    on<K extends keyof T>(event: K, listener: T[K]): this;
+    once<K extends keyof T>(event: K, listener: T[K]): this;
+    emit<K extends keyof T>(event: K, ...args: Parameters<T[K]>): this;
+    off<K extends keyof T>(event: K, listener: T[K]): this;
+}
+interface IAddressSpace {
+    str: string;
+}
+export interface BaseNode<T extends BaseNodeEvents & ListenerSignature<T> = BaseNodeEvents> extends ITypedEventEmitter<T> {
+    readonly nodeClass?: NodeClass;
+    get addressSpace(): IAddressSpace;
+}
+export declare abstract class BaseNodeImpl<T extends BaseNodeEvents & ListenerSignature<T> = BaseNodeEvents> extends TypedEventEmitter<T> implements BaseNode<T> {
+    get addressSpace(): IAddressSpace;
+    private _addressSpace;
+}
+export interface UAObject<T extends UAObjectEvents & ListenerSignature<T> = UAObjectEvents> extends BaseNode<T> {
+    nodeClass: NodeClass.Object;
+    someUAObjectMethod(): void;
+}
+export declare class UAObjectImpl<T extends UAObjectEvents & ListenerSignature<T> = UAObjectEvents> extends BaseNodeImpl<T> implements UAObject<T> {
+    nodeClass: NodeClass.Object;
+    someUAObjectMethod(): void;
+}
+export interface UAVariableEvents extends BaseNodeEvents {
+    value_changed: (newDataValue: DataValue, index_range?: NumericRange | null) => void;
+    semantic_changed: () => void;
+    trucmuch: (newDataValue: DataValue, index_range?: NumericRange | null) => void;
+}
+export interface UAVariable<T extends UAVariableEvents & ListenerSignature<T> = UAVariableEvents> extends BaseNode<T> {
+    nodeClass: NodeClass.Variable;
+    someUAVariableMethod(): void;
+}
+export declare class UAVariableImpl<T extends UAVariableEvents & ListenerSignature<T> = UAVariableEvents> extends BaseNodeImpl<T> implements UAVariable<T> {
+    nodeClass: NodeClass.Variable;
+    someUAVariableMethod(): void;
+}
+export {};

package/dist/proofOfConcept.js

@@ -0,0 +1,69 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UAVariableImpl = exports.UAObjectImpl = exports.BaseNodeImpl = exports.TypedEventEmitter = void 0;
+const node_events_1 = require("node:events");
+const node_opcua_data_model_1 = require("node-opcua-data-model");
+class TypedEventEmitter {
+    emitter = new node_events_1.EventEmitter();
+    on(event, listener) {
+        this.emitter.on(event, listener);
+        return this;
+    }
+    once(event, listener) {
+        this.emitter.once(event, listener);
+        return this;
+    }
+    emit(event, ...args) {
+        this.emitter.emit(event, ...args);
+        return this;
+    }
+    off(event, listener) {
+        this.emitter.off(event, listener);
+        return this;
+    }
+}
+exports.TypedEventEmitter = TypedEventEmitter;
+class BaseNodeImpl extends TypedEventEmitter {
+    get addressSpace() {
+        return this._addressSpace;
+    }
+    _addressSpace = { str: "example" };
+}
+exports.BaseNodeImpl = BaseNodeImpl;
+class UAObjectImpl extends BaseNodeImpl {
+    nodeClass = node_opcua_data_model_1.NodeClass.Object;
+    someUAObjectMethod() {
+        // ...
+    }
+}
+exports.UAObjectImpl = UAObjectImpl;
+class UAVariableImpl extends BaseNodeImpl {
+    nodeClass = node_opcua_data_model_1.NodeClass.Variable;
+    someUAVariableMethod() {
+        // ...
+        this.emit("trucmuch", { value: 42 });
+    }
+}
+exports.UAVariableImpl = UAVariableImpl;
+const a = new UAVariableImpl();
+a.on("trucmuch", (dataValue) => {
+    console.log("trucmuch changed", dataValue.value);
+});
+a.emit("trucmuch", { value: 42 });
+function onNodeFunc(node) {
+    node.on("event", () => { });
+}
+function main() {
+    const uaObject = new UAObjectImpl();
+    uaObject.on("RolePermissions_changed", (dataValue) => {
+        console.log("RolePermissions changed", dataValue.value);
+    });
+    const uaVariable = new UAVariableImpl();
+    uaVariable.on("trucmuch", (dataValue, _indexRange) => {
+        console.log("trucmuch changed", dataValue.value);
+    });
+    onNodeFunc(uaObject);
+    onNodeFunc(uaVariable);
+}
+main();
+//# sourceMappingURL=proofOfConcept.js.map

package/dist/proofOfConcept.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"proofOfConcept.js","sourceRoot":"","sources":["../source/proofOfConcept.ts"],"names":[],"mappings":";;;AAAA,6CAA2C;AAC3C,iEAAkD;AAyClD,MAAa,iBAAiB;IAClB,OAAO,GAAG,IAAI,0BAAY,EAAE,CAAC;IAErC,EAAE,CAAoB,KAAQ,EAAE,QAAc;QAC1C,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,KAAe,EAAE,QAAiB,CAAC,CAAC;QACpD,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,IAAI,CAAoB,KAAQ,EAAE,QAAc;QAC5C,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAe,EAAE,QAAiB,CAAC,CAAC;QACtD,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,IAAI,CAAoB,KAAQ,EAAE,GAAG,IAAsB;QACvD,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAe,EAAE,GAAG,IAAI,CAAC,CAAC;QAC5C,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,GAAG,CAAoB,KAAQ,EAAE,QAAc;QAC3C,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAe,EAAE,QAAiB,CAAC,CAAC;QACrD,OAAO,IAAI,CAAC;IAChB,CAAC;CACJ;AAtBD,8CAsBC;AAYD,MAAsB,YAClB,SAAQ,iBAAoB;IAG5B,IAAI,YAAY;QACZ,OAAO,IAAI,CAAC,aAAa,CAAC;IAC9B,CAAC;IAEO,aAAa,GAAkB,EAAE,GAAG,EAAE,SAAS,EAAE,CAAC;CAC7D;AATD,oCASC;AAYD,MAAa,YACT,SAAQ,YAAe;IAGvB,SAAS,GAAqB,iCAAS,CAAC,MAAM,CAAC;IAE/C,kBAAkB;QACd,MAAM;IACV,CAAC;CACJ;AATD,oCASC;AAYD,MAAa,cACT,SAAQ,YAAe;IAGvB,SAAS,GAAuB,iCAAS,CAAC,QAAQ,CAAC;IACnD,oBAAoB;QAChB,MAAM;QACL,IAAuB,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;IAC7D,CAAC;CACJ;AATD,wCASC;AAED,MAAM,CAAC,GAAG,IAAI,cAAc,EAAE,CAAC;AAC/B,CAAC,CAAC,EAAE,CAAC,UAAU,EAAE,CAAC,SAAS,EAAE,EAAE;IAC3B,OAAO,CAAC,GAAG,CAAC,kBAAkB,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC;AACrD,CAAC,CAAC,CAAC;AACH,CAAC,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;AAElC,SAAS,UAAU,CAAC,IAAc;IAC9B,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;AAC/B,CAAC;AAED,SAAS,IAAI;IACT,MAAM,QAAQ,GAAG,IAAI,YAAY,EAAE,CAAC;IAEpC,QAAQ,CAAC,EAAE,CAAC,yBAAyB,EAAE,CAAC,SAAS,EAAE,EAAE;QACjD,OAAO,CAAC,GAAG,CAAC,yBAAyB,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC;IAC5D,CAAC,CAAC,CAAC;IAEH,MAAM,UAAU,GAAe,IAAI,cAAc,EAAE,CAAC;IAEpD,UAAU,CAAC,EAAE,CAAC,UAAU,EAAE,CAAC,SAAS,EAAE,WAAW,EAAE,EAAE;QACjD,OAAO,CAAC,GAAG,CAAC,kBAAkB,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC;IACrD,CAAC,CAAC,CAAC;IAEH,UAAU,CAAC,QAAQ,CAAC,CAAC;IACrB,UAAU,CAAC,UAAU,CAAC,CAAC;AAC3B,CAAC;AACD,IAAI,EAAE,CAAC"}

package/dist/session_context.d.ts

@@ -39,6 +39,8 @@ export interface ISessionBase {
     channel?: IChannelBase;
     getSessionId(): NodeId;
     continuationPointManager: IContinuationPointManager;
+    /** The URL of the Endpoint the Session was created on, if known. */
+    getEndpointUrl?(): string | undefined;
 }
 export interface ContinuationPointData {
     dataValues: DataValue[];
@@ -73,6 +75,8 @@ export interface ISessionContext {
      * unavailable.
      */
     readonly clientApplicationUri: string | null;
+    /** The URL of the Endpoint the Session was created on, or `null` if unknown. */
+    readonly endpointUrl: string | null;
     /**
      * Returns a JSON representation of the context
      */

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "node-opcua-address-space-base",
-    "version": "2.173.0",
+    "version": "2.174.0",
     "description": "pure nodejs OPCUA SDK - module address-space-base",
     "main": "./dist/index.js",
     "types": "./dist/index.d.ts",
@@ -18,20 +18,20 @@
     },
     "dependencies": {
         "node-opcua-assert": "2.164.0",
-        "node-opcua-basic-types": "2.173.0",
-        "node-opcua-constants": "2.157.0",
+        "node-opcua-basic-types": "2.174.0",
+        "node-opcua-constants": "2.174.0",
         "node-opcua-crypto": "5.3.6",
-        "node-opcua-data-model": "2.173.0",
-        "node-opcua-data-value": "2.173.0",
-        "node-opcua-date-time": "2.173.0",
+        "node-opcua-data-model": "2.174.0",
+        "node-opcua-data-value": "2.174.0",
+        "node-opcua-date-time": "2.174.0",
         "node-opcua-debug": "2.172.0",
-        "node-opcua-extension-object": "2.173.0",
-        "node-opcua-nodeid": "2.173.0",
-        "node-opcua-numeric-range": "2.173.0",
-        "node-opcua-schemas": "2.173.0",
+        "node-opcua-extension-object": "2.174.0",
+        "node-opcua-nodeid": "2.174.0",
+        "node-opcua-numeric-range": "2.174.0",
+        "node-opcua-schemas": "2.174.0",
         "node-opcua-status-code": "2.173.0",
-        "node-opcua-types": "2.173.0",
-        "node-opcua-variant": "2.173.0"
+        "node-opcua-types": "2.174.0",
+        "node-opcua-variant": "2.174.0"
     },
     "author": "Etienne Rossignon",
     "license": "MIT",
@@ -48,7 +48,7 @@
         "internet of things"
     ],
     "homepage": "http://node-opcua.github.io/",
-    "gitHead": "4aa6634e2e1e14e223fa46a632438295be12744c",
+    "gitHead": "011657a3a4805ad106df7381c24ed84e2a18d8f1",
     "files": [
         "dist",
         "source"

package/source/proofOfConcept.ts

@@ -0,0 +1,156 @@
+import { EventEmitter } from "node:events";
+import { NodeClass } from "node-opcua-data-model";
+
+interface IEventData {
+    source: string;
+}
+interface DataValue {
+    value: number;
+}
+interface NumericRange {
+    start: number;
+    end: number;
+}
+export interface BaseNodeEvents {
+    dispose: () => void;
+    event: (attribute: IEventData) => void;
+}
+
+export interface UAObjectEvents extends BaseNodeEvents {
+    Value_changed: (attribute: DataValue) => void;
+    DisplayName_changed: (attribute: DataValue) => void;
+    Description_changed: (attribute: DataValue) => void;
+    BrowseName_changed: (attribute: DataValue) => void;
+    RolePermissions_changed: (attribute: DataValue) => void;
+    AccessRestrictions_changed: (attribute: DataValue) => void;
+}
+
+// Self-referential constraint: every property of L must be a function.
+// Lets us drop the broken `T[K] extends (...) => ...` conditionals while
+// preserving exact callback signatures (named params, optional args) for IntelliSense.
+export type ListenerSignature<L> = {
+    // biome-ignore lint/suspicious/noExplicitAny: any is required to bypass function-parameter contravariance; using unknown breaks T[K] assignability
+    [E in keyof L]: (...args: any[]) => any;
+};
+
+export interface ITypedEventEmitter<T extends ListenerSignature<T>> {
+    on<K extends keyof T>(event: K, listener: T[K]): this;
+    once<K extends keyof T>(event: K, listener: T[K]): this;
+    emit<K extends keyof T>(event: K, ...args: Parameters<T[K]>): this;
+    off<K extends keyof T>(event: K, listener: T[K]): this;
+}
+
+export class TypedEventEmitter<T extends ListenerSignature<T>> implements ITypedEventEmitter<T> {
+    private emitter = new EventEmitter();
+
+    on<K extends keyof T>(event: K, listener: T[K]): this {
+        this.emitter.on(event as string, listener as never);
+        return this;
+    }
+
+    once<K extends keyof T>(event: K, listener: T[K]): this {
+        this.emitter.once(event as string, listener as never);
+        return this;
+    }
+
+    emit<K extends keyof T>(event: K, ...args: Parameters<T[K]>): this {
+        this.emitter.emit(event as string, ...args);
+        return this;
+    }
+
+    off<K extends keyof T>(event: K, listener: T[K]): this {
+        this.emitter.off(event as string, listener as never);
+        return this;
+    }
+}
+
+// import { BaseNodeEvents } from './BaseNodeEvents';
+// import { ITypedEventEmitter, TypedEventEmitter } from './TypedEventEmitter';
+interface IAddressSpace {
+    str: string;
+}
+export interface BaseNode<T extends BaseNodeEvents & ListenerSignature<T> = BaseNodeEvents> extends ITypedEventEmitter<T> {
+    readonly nodeClass?: NodeClass;
+    get addressSpace(): IAddressSpace;
+}
+
+export abstract class BaseNodeImpl<T extends BaseNodeEvents & ListenerSignature<T> = BaseNodeEvents>
+    extends TypedEventEmitter<T>
+    implements BaseNode<T>
+{
+    get addressSpace(): IAddressSpace {
+        return this._addressSpace;
+    }
+
+    private _addressSpace: IAddressSpace = { str: "example" };
+}
+
+//
+
+// import { BaseNode, IBaseNode } from "./BaseNode";
+// import { BaseNodeEvents, UAObjectEvents } from "./BaseNodeEvents";
+
+export interface UAObject<T extends UAObjectEvents & ListenerSignature<T> = UAObjectEvents> extends BaseNode<T> {
+    nodeClass: NodeClass.Object;
+    someUAObjectMethod(): void;
+}
+
+export class UAObjectImpl<T extends UAObjectEvents & ListenerSignature<T> = UAObjectEvents>
+    extends BaseNodeImpl<T>
+    implements UAObject<T>
+{
+    nodeClass: NodeClass.Object = NodeClass.Object;
+
+    someUAObjectMethod(): void {
+        // ...
+    }
+}
+
+export interface UAVariableEvents extends BaseNodeEvents {
+    value_changed: (newDataValue: DataValue, index_range?: NumericRange | null) => void;
+    semantic_changed: () => void;
+    trucmuch: (newDataValue: DataValue, index_range?: NumericRange | null) => void;
+}
+export interface UAVariable<T extends UAVariableEvents & ListenerSignature<T> = UAVariableEvents> extends BaseNode<T> {
+    nodeClass: NodeClass.Variable;
+    someUAVariableMethod(): void;
+}
+
+export class UAVariableImpl<T extends UAVariableEvents & ListenerSignature<T> = UAVariableEvents>
+    extends BaseNodeImpl<T>
+    implements UAVariable<T>
+{
+    nodeClass: NodeClass.Variable = NodeClass.Variable;
+    someUAVariableMethod(): void {
+        // ...
+        (this as UAVariableImpl).emit("trucmuch", { value: 42 });
+    }
+}
+
+const a = new UAVariableImpl();
+a.on("trucmuch", (dataValue) => {
+    console.log("trucmuch changed", dataValue.value);
+});
+a.emit("trucmuch", { value: 42 });
+
+function onNodeFunc(node: BaseNode) {
+    node.on("event", () => {});
+}
+
+function main() {
+    const uaObject = new UAObjectImpl();
+
+    uaObject.on("RolePermissions_changed", (dataValue) => {
+        console.log("RolePermissions changed", dataValue.value);
+    });
+
+    const uaVariable: UAVariable = new UAVariableImpl();
+
+    uaVariable.on("trucmuch", (dataValue, _indexRange) => {
+        console.log("trucmuch changed", dataValue.value);
+    });
+
+    onNodeFunc(uaObject);
+    onNodeFunc(uaVariable);
+}
+main();

package/source/session_context.ts

@@ -58,6 +58,8 @@ export interface ISessionBase {
     channel?: IChannelBase;
     getSessionId(): NodeId; // session NodeID
     continuationPointManager: IContinuationPointManager;
+    /** The URL of the Endpoint the Session was created on, if known. */
+    getEndpointUrl?(): string | undefined;
 }
 export interface ContinuationPointData {
     dataValues: DataValue[];
@@ -103,6 +105,9 @@ export interface ISessionContext {
      */
     readonly clientApplicationUri: string | null;
 
+    /** The URL of the Endpoint the Session was created on, or `null` if unknown. */
+    readonly endpointUrl: string | null;
+
     /**
      * Returns a JSON representation of the context
      */