node-opcua-service-filter 2.183.0 → 2.184.0

package/dist/on_address_space/index.js

@@ -1,19 +1,3 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./extract_event_fields.js"), exports);
-__exportStar(require("./filter_context_on_address_space.js"), exports);
+export * from "./extract_event_fields.js";
+export * from "./filter_context_on_address_space.js";
 //# sourceMappingURL=index.js.map

package/dist/on_address_space/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../source/on_address_space/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,4DAA0C;AAC1C,uEAAqD"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../source/on_address_space/index.ts"],"names":[],"mappings":"AAAA,cAAc,2BAA2B,CAAC;AAC1C,cAAc,sCAAsC,CAAC"}

package/dist/resolve_operand.d.ts

@@ -1,4 +1,18 @@
 import { AttributeOperand, SimpleAttributeOperand } from "node-opcua-types";
 import { Variant } from "node-opcua-variant";
 import type { FilterContext } from "./filter_context.js";
+/**
+ * OPC 10000-4 7.4.4.5: a SimpleAttributeOperand with an empty browsePath denotes the instance of
+ * typeDefinitionId itself, not "nothing to do". A ConditionId operand (typeDefinitionId
+ * ConditionType or a subtype, attributeId NodeId, empty browsePath) resolves to the event's own
+ * condition instance NodeId - this is what every Alarms and Conditions client sends, in both the
+ * select clause (delivery, via extractEventField) and the where clause (evaluation, via
+ * resolveOperand below). FEAT-58 taught the select-clause validation this; both consumers share
+ * this one resolution so they never drift apart again.
+ *
+ * Returns undefined when the operand does not match this shape, so the caller falls back to its
+ * normal browsePath resolution.
+ */
+export declare function resolveConditionIdOperand(context: FilterContext, operand: SimpleAttributeOperand): Variant | undefined;
 export declare function resolveOperand(context: FilterContext, operand: SimpleAttributeOperand | AttributeOperand): Variant;
+//# sourceMappingURL=resolve_operand.d.ts.map

package/dist/resolve_operand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve_operand.d.ts","sourceRoot":"","sources":["../source/resolve_operand.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAC5E,OAAO,EAAY,OAAO,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAOzD;;;;;;;;;;;GAWG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,sBAAsB,GAAG,OAAO,GAAG,SAAS,CA+BtH;AAYD,wBAAgB,cAAc,CAAC,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,sBAAsB,GAAG,gBAAgB,GAAG,OAAO,CAiClH"}

package/dist/resolve_operand.js

@@ -1,15 +1,56 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.resolveOperand = resolveOperand;
-const node_opcua_data_model_1 = require("node-opcua-data-model");
-const node_opcua_debug_1 = require("node-opcua-debug");
-const node_opcua_service_translate_browse_path_1 = require("node-opcua-service-translate-browse-path");
-const node_opcua_status_code_1 = require("node-opcua-status-code");
-const node_opcua_types_1 = require("node-opcua-types");
-const node_opcua_variant_1 = require("node-opcua-variant");
-const warningLog = (0, node_opcua_debug_1.make_warningLog)("FILTER");
-const debugLog = (0, node_opcua_debug_1.make_debugLog)("FILTER");
-const doDebug = (0, node_opcua_debug_1.checkDebugFlag)("FILTER");
+import { AttributeIds, NodeClass } from "node-opcua-data-model";
+import { checkDebugFlag, make_debugLog, make_warningLog } from "node-opcua-debug";
+import { resolveNodeId, sameNodeId } from "node-opcua-nodeid";
+import { constructBrowsePathFromQualifiedName } from "node-opcua-service-translate-browse-path";
+import { StatusCodes } from "node-opcua-status-code";
+import { AttributeOperand, SimpleAttributeOperand } from "node-opcua-types";
+import { DataType, Variant } from "node-opcua-variant";
+const warningLog = make_warningLog("FILTER");
+const debugLog = make_debugLog("FILTER");
+const doDebug = checkDebugFlag("FILTER");
+const conditionTypeNodeId = resolveNodeId("ConditionType");
+/**
+ * OPC 10000-4 7.4.4.5: a SimpleAttributeOperand with an empty browsePath denotes the instance of
+ * typeDefinitionId itself, not "nothing to do". A ConditionId operand (typeDefinitionId
+ * ConditionType or a subtype, attributeId NodeId, empty browsePath) resolves to the event's own
+ * condition instance NodeId - this is what every Alarms and Conditions client sends, in both the
+ * select clause (delivery, via extractEventField) and the where clause (evaluation, via
+ * resolveOperand below). FEAT-58 taught the select-clause validation this; both consumers share
+ * this one resolution so they never drift apart again.
+ *
+ * Returns undefined when the operand does not match this shape, so the caller falls back to its
+ * normal browsePath resolution.
+ */
+export function resolveConditionIdOperand(context, operand) {
+    if (operand.browsePath && operand.browsePath.length > 0) {
+        return undefined;
+    }
+    if (operand.attributeId !== AttributeIds.NodeId) {
+        return undefined;
+    }
+    // "ns=0;i=2782" => ConditionType
+    // "ns=0;i=2041" => BaseEventType
+    if (!sameNodeId(operand.typeDefinitionId, conditionTypeNodeId)) {
+        // not a ConditionType
+        // but could be on of its derived type. for instance ns=0;i=2881 => AcknowledgeableConditionType
+        if (!context.isSubtypeOf(operand.typeDefinitionId, conditionTypeNodeId)) {
+            warningLog(" ", operand.typeDefinitionId.toString());
+            warningLog(`this case is not handled yet : selectClause.typeDefinitionId = ${operand.typeDefinitionId.toString()}`);
+            warningLog(operand.toString());
+            return new Variant({ dataType: DataType.NodeId, value: context.eventSource });
+        }
+    }
+    const eventSourceTypeDefinition = context.getTypeDefinition(context.eventSource);
+    if (!eventSourceTypeDefinition) {
+        // eventSource is a EventType class
+        return new Variant();
+    }
+    if (!context.isSubtypeOf(eventSourceTypeDefinition, conditionTypeNodeId)) {
+        return new Variant();
+    }
+    // Yeh : our EventType is a Condition Type !
+    return new Variant({ dataType: DataType.NodeId, value: context.eventSource });
+}
 // export function readOperand(context: FilterContext, operand: SimpleAttributeOperand): Variant {
 //     // navigate to the innerNode specified by the browsePath [ QualifiedName]
 //     const browsePath = constructBrowsePathFromQualifiedName({ nodeId: context.eventSource }, operand.browsePath);
@@ -19,29 +60,33 @@ const doDebug = (0, node_opcua_debug_1.checkDebugFlag)("FILTER");
 //     }
 //     return context.readNodeValue(targetNode);
 // }
-function resolveOperand(context, operand) {
-    if (operand instanceof node_opcua_types_1.SimpleAttributeOperand) {
-        const browsePath = (0, node_opcua_service_translate_browse_path_1.constructBrowsePathFromQualifiedName)({ nodeId: context.eventSource }, operand.browsePath);
+export function resolveOperand(context, operand) {
+    if (operand instanceof SimpleAttributeOperand) {
+        const conditionIdValue = resolveConditionIdOperand(context, operand);
+        if (conditionIdValue) {
+            return conditionIdValue;
+        }
+        const browsePath = constructBrowsePathFromQualifiedName({ nodeId: context.eventSource }, operand.browsePath);
         const target = context.browsePath(browsePath);
         if (!target) {
-            return new node_opcua_variant_1.Variant({ dataType: node_opcua_variant_1.DataType.Null });
+            return new Variant({ dataType: DataType.Null });
             // return new Variant({ dataType: DataType.StatusCode, value: StatusCodes.BadNodeIdUnknown });
         }
         const nodeClass = context.getNodeClass(target);
-        if (nodeClass !== node_opcua_data_model_1.NodeClass.Variable) {
+        if (nodeClass !== NodeClass.Variable) {
             doDebug &&
-                debugLog("resolveOperand: cannot find variable here but got nodeClass", node_opcua_data_model_1.NodeClass[nodeClass], browsePath.toString());
-            return new node_opcua_variant_1.Variant({ dataType: node_opcua_variant_1.DataType.StatusCode, value: node_opcua_status_code_1.StatusCodes.BadNodeClassInvalid });
+                debugLog("resolveOperand: cannot find variable here but got nodeClass", NodeClass[nodeClass], browsePath.toString());
+            return new Variant({ dataType: DataType.StatusCode, value: StatusCodes.BadNodeClassInvalid });
         }
         const value = context.readNodeValue(target);
         return value;
     }
     else {
-        if (!(operand instanceof node_opcua_types_1.AttributeOperand)) {
+        if (!(operand instanceof AttributeOperand)) {
             throw new Error("expecting an AttributeOperand");
         }
         warningLog("AttributeOperand is not yet implemented");
-        return new node_opcua_variant_1.Variant({ dataType: node_opcua_variant_1.DataType.Null });
+        return new Variant({ dataType: DataType.Null });
     }
 }
 //# sourceMappingURL=resolve_operand.js.map

package/dist/resolve_operand.js.map

@@ -1 +1 @@
-{"version":3,"file":"resolve_operand.js","sourceRoot":"","sources":["../source/resolve_operand.ts"],"names":[],"mappings":";;AAuBA,wCA4BC;AAnDD,iEAAkD;AAClD,uDAAkF;AAElF,uGAAgG;AAChG,mEAAqD;AACrD,uDAA4E;AAC5E,2DAAuD;AAGvD,MAAM,UAAU,GAAG,IAAA,kCAAe,EAAC,QAAQ,CAAC,CAAC;AAC7C,MAAM,QAAQ,GAAG,IAAA,gCAAa,EAAC,QAAQ,CAAC,CAAC;AACzC,MAAM,OAAO,GAAG,IAAA,iCAAc,EAAC,QAAQ,CAAC,CAAC;AAEzC,kGAAkG;AAClG,gFAAgF;AAChF,oHAAoH;AACpH,yDAAyD;AACzD,yBAAyB;AACzB,2DAA2D;AAC3D,QAAQ;AACR,gDAAgD;AAChD,IAAI;AAEJ,SAAgB,cAAc,CAAC,OAAsB,EAAE,OAAkD;IACrG,IAAI,OAAO,YAAY,yCAAsB,EAAE,CAAC;QAC5C,MAAM,UAAU,GAAG,IAAA,+EAAoC,EAAC,EAAE,MAAM,EAAE,OAAO,CAAC,WAAW,EAAE,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;QAE7G,MAAM,MAAM,GAAkB,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;QAC7D,IAAI,CAAC,MAAM,EAAE,CAAC;YACV,OAAO,IAAI,4BAAO,CAAC,EAAE,QAAQ,EAAE,6BAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;YAChD,8FAA8F;QAClG,CAAC;QACD,MAAM,SAAS,GAAG,OAAO,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;QAC/C,IAAI,SAAS,KAAK,iCAAS,CAAC,QAAQ,EAAE,CAAC;YACnC,OAAO;gBACH,QAAQ,CACJ,6DAA6D,EAC7D,iCAAS,CAAC,SAAS,CAAC,EACpB,UAAU,CAAC,QAAQ,EAAE,CACxB,CAAC;YACN,OAAO,IAAI,4BAAO,CAAC,EAAE,QAAQ,EAAE,6BAAQ,CAAC,UAAU,EAAE,KAAK,EAAE,oCAAW,CAAC,mBAAmB,EAAE,CAAC,CAAC;QAClG,CAAC;QACD,MAAM,KAAK,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;QAC5C,OAAO,KAAK,CAAC;IACjB,CAAC;SAAM,CAAC;QACJ,IAAI,CAAC,CAAC,OAAO,YAAY,mCAAgB,CAAC,EAAE,CAAC;YACzC,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;QACrD,CAAC;QACD,UAAU,CAAC,yCAAyC,CAAC,CAAC;QACtD,OAAO,IAAI,4BAAO,CAAC,EAAE,QAAQ,EAAE,6BAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;IACpD,CAAC;AACL,CAAC"}
+{"version":3,"file":"resolve_operand.js","sourceRoot":"","sources":["../source/resolve_operand.ts"],"names":[],"mappings":"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"}

package/dist/tools_event_filter.d.ts

@@ -18,3 +18,4 @@ export declare function constructSelectClause(arrayOfNames: string | string[] |
  *
  */
 export declare function constructEventFilter(arrayOfNames: (QualifiedNameOptions | string)[][] | (QualifiedNameOptions | string)[] | QualifiedNameOptions | string[] | string, whereClause?: ContentFilterOptions | ContentFilterElement): EventFilter;
+//# sourceMappingURL=tools_event_filter.d.ts.map

package/dist/tools_event_filter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools_event_filter.d.ts","sourceRoot":"","sources":["../source/tools_event_filter.ts"],"names":[],"mappings":"AAIA,OAAO,EAAqC,KAAK,aAAa,EAAE,KAAK,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAEzH,OAAO,EAAiB,oBAAoB,EAAE,KAAK,oBAAoB,EAAE,WAAW,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAUnI,wBAAgB,yBAAyB,CACrC,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,oBAAoB,GAAG,CAAC,oBAAoB,GAAG,MAAM,CAAC,EAAE,GAChF,aAAa,EAAE,CAMjB;AACD,wBAAgB,qBAAqB,CACjC,YAAY,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,oBAAoB,GAAG,CAAC,oBAAoB,GAAG,MAAM,CAAC,EAAE,GAAG,CAAC,oBAAoB,GAAG,MAAM,CAAC,EAAE,EAAE,GACjI,sBAAsB,EAAE,CA+C1B;AACD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,oBAAoB,CAChC,YAAY,EACN,CAAC,oBAAoB,GAAG,MAAM,CAAC,EAAE,EAAE,GACnC,CAAC,oBAAoB,GAAG,MAAM,CAAC,EAAE,GACjC,oBAAoB,GACpB,MAAM,EAAE,GACR,MAAM,EACZ,WAAW,CAAC,EAAE,oBAAoB,GAAG,oBAAoB,GAC1D,WAAW,CAWb"}

package/dist/tools_event_filter.js

@@ -1,23 +1,18 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.constructSimpleBrowsePath = constructSimpleBrowsePath;
-exports.constructSelectClause = constructSelectClause;
-exports.constructEventFilter = constructEventFilter;
 /**
  * @module node-opcua-service-filter
  */
-const node_opcua_constants_1 = require("node-opcua-constants");
-const node_opcua_data_model_1 = require("node-opcua-data-model");
-const imports_js_1 = require("./imports.js");
+import { ObjectTypeIds } from "node-opcua-constants";
+import { AttributeIds, coerceQualifiedName } from "node-opcua-data-model";
+import { ContentFilter, ContentFilterElement, EventFilter, SimpleAttributeOperand } from "./imports.js";
 function coerceQualifiedName2(a) {
     if (typeof a === "string")
-        return (0, node_opcua_data_model_1.coerceQualifiedName)(a);
+        return coerceQualifiedName(a);
     a.namespaceIndex = a.namespaceIndex || 0; // need a namespaceIndex
-    return (0, node_opcua_data_model_1.coerceQualifiedName)(a);
+    return coerceQualifiedName(a);
 }
 // A bare QualifiedNameOptions is accepted, and always was: the last line coerces a
 // single non-array value. Only the signature said otherwise.
-function constructSimpleBrowsePath(a) {
+export function constructSimpleBrowsePath(a) {
     if (typeof a === "string") {
         return constructSimpleBrowsePath(a.split("."));
     }
@@ -25,7 +20,7 @@ function constructSimpleBrowsePath(a) {
         return a.map(coerceQualifiedName2);
     return [coerceQualifiedName2(a)];
 }
-function constructSelectClause(arrayOfNames) {
+export function constructSelectClause(arrayOfNames) {
     if (!Array.isArray(arrayOfNames)) {
         return constructSelectClause([arrayOfNames]);
     }
@@ -53,19 +48,19 @@ function constructSelectClause(arrayOfNames) {
             //  browsePath[]  QualifiedName empty
             //  attributeId   IntegerId     Id of the NodeId Attribute
             //
-            return new imports_js_1.SimpleAttributeOperand({
-                attributeId: node_opcua_data_model_1.AttributeIds.NodeId,
+            return new SimpleAttributeOperand({
+                attributeId: AttributeIds.NodeId,
                 browsePath: null,
                 indexRange: undefined, //  NumericRange
-                typeDefinitionId: node_opcua_constants_1.ObjectTypeIds.ConditionType // i=2782
+                typeDefinitionId: ObjectTypeIds.ConditionType // i=2782
             });
         }
         else
-            return new imports_js_1.SimpleAttributeOperand({
-                attributeId: node_opcua_data_model_1.AttributeIds.Value,
+            return new SimpleAttributeOperand({
+                attributeId: AttributeIds.Value,
                 browsePath,
                 indexRange: undefined, //  NumericRange
-                typeDefinitionId: node_opcua_constants_1.ObjectTypeIds.BaseEventType // i=2041
+                typeDefinitionId: ObjectTypeIds.BaseEventType // i=2041
             });
     });
     return selectClauses;
@@ -85,12 +80,12 @@ function constructSelectClause(arrayOfNames) {
  *     constructEventFilter([ ["SourceName",{namespaceIndex:2 , "MyData"} ]]);
  *
  */
-function constructEventFilter(arrayOfNames, whereClause) {
+export function constructEventFilter(arrayOfNames, whereClause) {
     const selectClauses = constructSelectClause(arrayOfNames);
-    if (whereClause instanceof imports_js_1.ContentFilterElement) {
-        whereClause = new imports_js_1.ContentFilter({ elements: [whereClause] });
+    if (whereClause instanceof ContentFilterElement) {
+        whereClause = new ContentFilter({ elements: [whereClause] });
     }
-    const filter = new imports_js_1.EventFilter({
+    const filter = new EventFilter({
         selectClauses,
         whereClause
     });

package/dist/tools_event_filter.js.map

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

package/package.json

@@ -1,6 +1,7 @@
 {
     "name": "node-opcua-service-filter",
-    "version": "2.183.0",
+    "type": "module",
+    "version": "2.184.0",
     "description": "pure nodejs OPCUA SDK - module service-filter",
     "main": "./dist/index.js",
     "types": "./dist/index.d.ts",
@@ -14,23 +15,23 @@
         "node": ">=22.13.0"
     },
     "dependencies": {
-        "node-opcua-address-space-base": "2.183.0",
-        "node-opcua-assert": "2.183.0",
-        "node-opcua-basic-types": "2.183.0",
-        "node-opcua-constants": "2.183.0",
-        "node-opcua-data-model": "2.183.0",
-        "node-opcua-data-value": "2.183.0",
-        "node-opcua-debug": "2.183.0",
-        "node-opcua-extension-object": "2.183.0",
-        "node-opcua-nodeid": "2.183.0",
-        "node-opcua-service-translate-browse-path": "2.183.0",
-        "node-opcua-status-code": "2.183.0",
-        "node-opcua-types": "2.183.0",
-        "node-opcua-variant": "2.183.0"
+        "node-opcua-address-space-base": "2.184.0",
+        "node-opcua-assert": "2.184.0",
+        "node-opcua-basic-types": "2.184.0",
+        "node-opcua-constants": "2.184.0",
+        "node-opcua-data-model": "2.184.0",
+        "node-opcua-data-value": "2.184.0",
+        "node-opcua-debug": "2.184.0",
+        "node-opcua-extension-object": "2.184.0",
+        "node-opcua-nodeid": "2.184.0",
+        "node-opcua-service-translate-browse-path": "2.184.0",
+        "node-opcua-status-code": "2.184.0",
+        "node-opcua-types": "2.184.0",
+        "node-opcua-variant": "2.184.0"
     },
     "devDependencies": {
-        "node-opcua-numeric-range": "2.183.0",
-        "node-opcua-packet-analyzer": "2.183.0"
+        "node-opcua-numeric-range": "2.184.0",
+        "node-opcua-packet-analyzer": "2.184.0"
     },
     "author": "Etienne Rossignon",
     "license": "MIT",
@@ -47,7 +48,7 @@
         "internet of things"
     ],
     "homepage": "http://node-opcua.github.io/",
-    "gitHead": "d9a9af54d162f0fbb8d287e168aaeeda2d5c38b7",
+    "gitHead": "441a5c63e3a4202eb8de8597acac77a3a49248b7",
     "files": [
         "dist",
         "source"

package/source/check_event_clause.ts

@@ -22,7 +22,7 @@ export function checkSelectClause(parentNode: BaseNode, selectClause: SimpleAttr
     //
     const addressSpace = parentNode.addressSpace;
 
-    // c8 ignore next
+    /* c8 ignore next */
     if (selectClause.typeDefinitionId.isEmpty()) {
         return StatusCodes.Good;
     }
@@ -34,11 +34,20 @@ export function checkSelectClause(parentNode: BaseNode, selectClause: SimpleAttr
     }
     // ... and that node must be an ObjectType (an EventType)
     if (eventTypeNode.nodeClass !== NodeClass.ObjectType) {
-        // c8 ignore next
+        /* c8 ignore next */
         doDebug && debugLog(" checkSelectClause", eventTypeNode.toString());
         return StatusCodes.BadTypeMismatch;
     }
 
+    // OPC 10000-4 7.4.4.5: an empty browsePath does not mean "nothing to do" here - it denotes the
+    // instance of typeDefinitionId itself (e.g. the ConditionId of an Alarms and Conditions event).
+    // typeDefinitionId has already been checked above to resolve to an existing EventType, so the
+    // operand is valid and must be reported Good; it is extractEventField's job, at delivery time, to
+    // resolve it against the actual event instance.
+    if (!selectClause.browsePath || selectClause.browsePath.length === 0) {
+        return StatusCodes.Good;
+    }
+
     // navigate to the innerNode specified by the browsePath [ QualifiedName]
     const browsePath = constructBrowsePathFromQualifiedName(eventTypeNode, selectClause.browsePath);
     const browsePathResult = addressSpace.browsePath(browsePath);

package/source/check_where_clause.ts

@@ -89,12 +89,12 @@ function evaluateOperand<TIn, T>(
 }
 
 function checkOfType(filterContext: FilterContext, ofType: ExtensionObject | null): boolean {
-    // c8 ignore next
+    /* c8 ignore next */
     if (!ofType || !(ofType instanceof LiteralOperand)) {
         warningLog("checkOfType : unsupported case ! ofType is not a LiteralOperand , ofType = ", ofType?.toString());
         return false;
     }
-    // c8 ignore next
+    /* c8 ignore next */
     if (ofType.value.dataType !== DataType.NodeId) {
         warningLog(`invalid operand type (expecting NodeId); got ${DataType[ofType.value.dataType]}`);
         return false;

package/source/extract_event_field.ts

@@ -1,14 +1,8 @@
 import { assert } from "node-opcua-assert";
-import { AttributeIds } from "node-opcua-data-model";
-import { make_warningLog } from "node-opcua-debug";
-import { resolveNodeId, sameNodeId } from "node-opcua-nodeid";
 import { SimpleAttributeOperand } from "node-opcua-types";
-import { DataType, Variant } from "node-opcua-variant";
+import type { Variant } from "node-opcua-variant";
 import type { FilterContext } from "./filter_context.js";
-import { resolveOperand } from "./resolve_operand.js";
-
-const warningLog = make_warningLog("FILTER");
-const conditionTypeNodeId = resolveNodeId("ConditionType");
+import { resolveConditionIdOperand, resolveOperand } from "./resolve_operand.js";
 
 /**
  *
@@ -19,31 +13,11 @@ export function extractEventField(context: FilterContext, operand: SimpleAttribu
 
     operand.browsePath = operand.browsePath || [];
 
-    if (operand.browsePath.length === 0 && operand.attributeId === AttributeIds.NodeId) {
-        // "ns=0;i=2782" => ConditionType
-        // "ns=0;i=2041" => BaseEventType
-        if (!sameNodeId(operand.typeDefinitionId, conditionTypeNodeId)) {
-            // not a ConditionType
-            // but could be on of its derived type. for instance ns=0;i=2881 => AcknowledgeableConditionType
-            if (!context.isSubtypeOf(operand.typeDefinitionId, conditionTypeNodeId)) {
-                warningLog(" ", operand.typeDefinitionId.toString());
-                warningLog(`this case is not handled yet : selectClause.typeDefinitionId = ${operand.typeDefinitionId.toString()}`);
-                warningLog(operand.toString());
-                return new Variant({ dataType: DataType.NodeId, value: context.eventSource });
-            }
-        }
-
-        const eventSourceTypeDefinition = context.getTypeDefinition(context.eventSource);
-        if (!eventSourceTypeDefinition) {
-            // eventSource is a EventType class
-            return new Variant();
-        }
-
-        if (!context.isSubtypeOf(eventSourceTypeDefinition, conditionTypeNodeId)) {
-            return new Variant();
-        }
-        // Yeh : our EventType is a Condition Type !
-        return new Variant({ dataType: DataType.NodeId, value: context.eventSource });
+    // the ConditionId shape (empty browsePath, attributeId NodeId) is resolved the same way here
+    // (delivery) and in resolveOperand (where-clause evaluation) - see resolveConditionIdOperand.
+    const conditionIdValue = resolveConditionIdOperand(context, operand);
+    if (conditionIdValue) {
+        return conditionIdValue;
     }
     return resolveOperand(context, operand);
 }

package/source/resolve_operand.ts

@@ -1,6 +1,6 @@
-import { NodeClass } from "node-opcua-data-model";
+import { AttributeIds, NodeClass } from "node-opcua-data-model";
 import { checkDebugFlag, make_debugLog, make_warningLog } from "node-opcua-debug";
-import type { NodeId } from "node-opcua-nodeid";
+import { type NodeId, resolveNodeId, sameNodeId } from "node-opcua-nodeid";
 import { constructBrowsePathFromQualifiedName } from "node-opcua-service-translate-browse-path";
 import { StatusCodes } from "node-opcua-status-code";
 import { AttributeOperand, SimpleAttributeOperand } from "node-opcua-types";
@@ -10,6 +10,52 @@ import type { FilterContext } from "./filter_context.js";
 const warningLog = make_warningLog("FILTER");
 const debugLog = make_debugLog("FILTER");
 const doDebug = checkDebugFlag("FILTER");
+const conditionTypeNodeId = resolveNodeId("ConditionType");
+
+/**
+ * OPC 10000-4 7.4.4.5: a SimpleAttributeOperand with an empty browsePath denotes the instance of
+ * typeDefinitionId itself, not "nothing to do". A ConditionId operand (typeDefinitionId
+ * ConditionType or a subtype, attributeId NodeId, empty browsePath) resolves to the event's own
+ * condition instance NodeId - this is what every Alarms and Conditions client sends, in both the
+ * select clause (delivery, via extractEventField) and the where clause (evaluation, via
+ * resolveOperand below). FEAT-58 taught the select-clause validation this; both consumers share
+ * this one resolution so they never drift apart again.
+ *
+ * Returns undefined when the operand does not match this shape, so the caller falls back to its
+ * normal browsePath resolution.
+ */
+export function resolveConditionIdOperand(context: FilterContext, operand: SimpleAttributeOperand): Variant | undefined {
+    if (operand.browsePath && operand.browsePath.length > 0) {
+        return undefined;
+    }
+    if (operand.attributeId !== AttributeIds.NodeId) {
+        return undefined;
+    }
+    // "ns=0;i=2782" => ConditionType
+    // "ns=0;i=2041" => BaseEventType
+    if (!sameNodeId(operand.typeDefinitionId, conditionTypeNodeId)) {
+        // not a ConditionType
+        // but could be on of its derived type. for instance ns=0;i=2881 => AcknowledgeableConditionType
+        if (!context.isSubtypeOf(operand.typeDefinitionId, conditionTypeNodeId)) {
+            warningLog(" ", operand.typeDefinitionId.toString());
+            warningLog(`this case is not handled yet : selectClause.typeDefinitionId = ${operand.typeDefinitionId.toString()}`);
+            warningLog(operand.toString());
+            return new Variant({ dataType: DataType.NodeId, value: context.eventSource });
+        }
+    }
+
+    const eventSourceTypeDefinition = context.getTypeDefinition(context.eventSource);
+    if (!eventSourceTypeDefinition) {
+        // eventSource is a EventType class
+        return new Variant();
+    }
+
+    if (!context.isSubtypeOf(eventSourceTypeDefinition, conditionTypeNodeId)) {
+        return new Variant();
+    }
+    // Yeh : our EventType is a Condition Type !
+    return new Variant({ dataType: DataType.NodeId, value: context.eventSource });
+}
 
 // export function readOperand(context: FilterContext, operand: SimpleAttributeOperand): Variant {
 //     // navigate to the innerNode specified by the browsePath [ QualifiedName]
@@ -23,6 +69,11 @@ const doDebug = checkDebugFlag("FILTER");
 
 export function resolveOperand(context: FilterContext, operand: SimpleAttributeOperand | AttributeOperand): Variant {
     if (operand instanceof SimpleAttributeOperand) {
+        const conditionIdValue = resolveConditionIdOperand(context, operand);
+        if (conditionIdValue) {
+            return conditionIdValue;
+        }
+
         const browsePath = constructBrowsePathFromQualifiedName({ nodeId: context.eventSource }, operand.browsePath);
 
         const target: NodeId | null = context.browsePath(browsePath);