node-opcua-address-space 2.180.0 → 2.181.1

package/dist/api/pseudo_session.js

@@ -0,0 +1,308 @@
+"use strict";
+/**
+ * @module node-opcua-address-space
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PseudoSession = void 0;
+exports.innerBrowse = innerBrowse;
+exports.innerBrowseNext = innerBrowseNext;
+const node_util_1 = require("node:util");
+const node_opcua_assert_1 = require("node-opcua-assert");
+const node_opcua_basic_types_1 = require("node-opcua-basic-types");
+const node_opcua_data_model_1 = require("node-opcua-data-model");
+const node_opcua_data_value_1 = require("node-opcua-data-value");
+const node_opcua_debug_1 = require("node-opcua-debug");
+const node_opcua_nodeid_1 = require("node-opcua-nodeid");
+const node_opcua_pseudo_session_1 = require("node-opcua-pseudo-session");
+const node_opcua_service_browse_1 = require("node-opcua-service-browse");
+const node_opcua_service_call_1 = require("node-opcua-service-call");
+const node_opcua_status_code_1 = require("node-opcua-status-code");
+const continuation_point_manager_js_1 = require("./continuation_points/continuation_point_manager.js");
+const call_helpers_js_1 = require("./helpers/call_helpers.js");
+const session_context_js_1 = require("./session_context.js");
+const errorLog = (0, node_opcua_debug_1.make_errorLog)("PseudoSession");
+function coerceBrowseDescription(browseDescription) {
+    if (typeof browseDescription === "string") {
+        return coerceBrowseDescription({
+            nodeId: (0, node_opcua_nodeid_1.resolveNodeId)(browseDescription)
+        });
+    }
+    else if (browseDescription instanceof node_opcua_service_browse_1.BrowseDescription) {
+        return browseDescription;
+    }
+    else {
+        return new node_opcua_service_browse_1.BrowseDescription(browseDescription);
+    }
+}
+function innerBrowse(engine, nodesToBrowse, callback) {
+    engine.browseAll(nodesToBrowse, (err, results) => {
+        if (err || !results) {
+            return callback?.(err);
+        }
+        // handle continuation points
+        results = results.map((result, _index) => {
+            (0, node_opcua_assert_1.assert)(!result.continuationPoint);
+            // c8 ignore next
+            if (!engine.continuationPointManager) {
+                return new node_opcua_service_browse_1.BrowseResult({ statusCode: node_opcua_status_code_1.StatusCodes.BadNoContinuationPoints });
+            }
+            if (engine.continuationPointManager.hasReachedMaximum(engine.maxBrowseContinuationPoints)) {
+                return new node_opcua_service_browse_1.BrowseResult({ statusCode: node_opcua_status_code_1.StatusCodes.BadNoContinuationPoints });
+            }
+            const truncatedResult = engine.continuationPointManager.registerReferences(engine.requestedMaxReferencesPerNode, result.references || [], { continuationPoint: null });
+            let { statusCode } = truncatedResult;
+            const { continuationPoint, values } = truncatedResult;
+            (0, node_opcua_assert_1.assert)(statusCode.isGood() || statusCode.equals(node_opcua_status_code_1.StatusCodes.GoodNoData));
+            statusCode = result.statusCode;
+            return new node_opcua_service_browse_1.BrowseResult({
+                statusCode,
+                continuationPoint,
+                references: values
+            });
+        });
+        callback?.(null, results);
+    });
+}
+function innerBrowseNext(engine, continuationPoints, releaseContinuationPoints, callback) {
+    const results = continuationPoints
+        .map((continuationPoint, _index) => {
+        return engine.continuationPointManager.getNextReferences(0, {
+            continuationPoint,
+            releaseContinuationPoints
+        });
+    })
+        .map((r) => new node_opcua_service_browse_1.BrowseResult({
+        statusCode: r.statusCode,
+        continuationPoint: r.continuationPoint,
+        references: r.values
+    }));
+    callback?.(null, results);
+}
+const $addressSpace = Symbol("addressSpace");
+const $context = Symbol("context");
+/**
+ * Pseudo session is an helper object that exposes the same async methods
+ * than the ClientSession. It can be used on a server address space.
+ *
+ * Code reused !
+ * The primary benefit of this object  is that its makes advanced OPCUA
+ * operations that uses browse, translate, read, write etc similar
+ * whether we work inside a server or through a client session.
+ *
+ */
+class PseudoSession {
+    requestedMaxReferencesPerNode = 0;
+    maxBrowseContinuationPoints = 0; // 0=no limits
+    _sessionId = new node_opcua_nodeid_1.NodeId(node_opcua_nodeid_1.NodeIdType.GUID, (0, node_opcua_basic_types_1.randomGuid)());
+    [$addressSpace];
+    continuationPointManager;
+    [$context];
+    constructor(addressSpace, context) {
+        this[$addressSpace] = addressSpace;
+        this[$context] = context || session_context_js_1.SessionContext.defaultContext;
+        this.continuationPointManager = new continuation_point_manager_js_1.ContinuationPointManager();
+    }
+    getSessionId() {
+        return this._sessionId;
+    }
+    browse(nodesToBrowse, callback
+    // biome-ignore lint/suspicious/noConfusingVoidType: implementation must satisfy both the void (callback) and Promise<T> (thenify-wrapped) overloads; biome's suggested undefined-in-union fix breaks the "not all code paths return a value" check
+    ) {
+        const isArray = Array.isArray(nodesToBrowse);
+        if (!isArray) {
+            const callbackSingle = callback;
+            this.browse([nodesToBrowse], (err, results) => {
+                callbackSingle?.(err, results ? results[0] : undefined);
+            });
+            return;
+        }
+        const callbackArray = callback;
+        const browseAll = (nodesToBrowse, callack) => {
+            const results = [];
+            for (const browseDescription of nodesToBrowse) {
+                browseDescription.referenceTypeId = (0, node_opcua_nodeid_1.resolveNodeId)(browseDescription.referenceTypeId || node_opcua_nodeid_1.NodeId.nullNodeId);
+                const _browseDescription = coerceBrowseDescription(browseDescription);
+                const nodeId = (0, node_opcua_nodeid_1.resolveNodeId)(_browseDescription.nodeId);
+                const r = this[$addressSpace].browseSingleNode(nodeId, _browseDescription, this[$context]);
+                results.push(r);
+            }
+            callack?.(null, results);
+        };
+        setImmediate(() => {
+            innerBrowse({
+                browseAll,
+                context: this[$context],
+                continuationPointManager: this.continuationPointManager,
+                requestedMaxReferencesPerNode: this.requestedMaxReferencesPerNode,
+                maxBrowseContinuationPoints: this.maxBrowseContinuationPoints
+            }, nodesToBrowse, callbackArray);
+        });
+    }
+    read(nodesToRead, callback
+    // biome-ignore lint/suspicious/noConfusingVoidType: implementation must satisfy both the void (callback) and Promise<T> (thenify-wrapped) overloads; biome's suggested undefined-in-union fix breaks the "not all code paths return a value" check
+    ) {
+        const isArray = Array.isArray(nodesToRead);
+        if (!isArray) {
+            nodesToRead = [nodesToRead];
+        }
+        const _nodesToRead = nodesToRead;
+        const context = this[$context];
+        const readV = async (nodeToRead) => {
+            if (!nodeToRead.nodeId) {
+                return new node_opcua_data_value_1.DataValue({ statusCode: node_opcua_status_code_1.StatusCodes.BadNodeIdUnknown });
+            }
+            const obj = this[$addressSpace].findNode(nodeToRead.nodeId);
+            if (!obj) {
+                return new node_opcua_data_value_1.DataValue({ statusCode: node_opcua_status_code_1.StatusCodes.BadNodeIdUnknown });
+            }
+            // refresh the variable value if the attribute to read is the Value attribute
+            if (obj.nodeClass === node_opcua_data_model_1.NodeClass.Variable && nodeToRead.attributeId === node_opcua_data_model_1.AttributeIds.Value) {
+                return await obj.readValueAsync(context);
+            }
+            (0, node_opcua_assert_1.assert)(!!nodeToRead.nodeId, "expecting a nodeId");
+            if (!nodeToRead.attributeId) {
+                throw new Error("expecting a attributeId");
+            }
+            const attributeId = nodeToRead.attributeId;
+            const indexRange = nodeToRead.indexRange;
+            const dataEncoding = nodeToRead.dataEncoding;
+            const dataValue = obj.readAttribute(context, attributeId, indexRange, dataEncoding);
+            return dataValue;
+        };
+        Promise.all(_nodesToRead.map(async (nodeToRead) => await readV(nodeToRead)))
+            .then((dataValues) => {
+            if (isArray) {
+                callback?.(null, dataValues);
+            }
+            else {
+                callback?.(null, dataValues[0]);
+            }
+        })
+            .catch((err) => callback?.(err));
+    }
+    browseNext(continuationPoints, releaseContinuationPoints, callback
+    // biome-ignore lint/suspicious/noConfusingVoidType: implementation must satisfy both the void (callback) and Promise<T> (thenify-wrapped) overloads; biome's suggested undefined-in-union fix breaks the "not all code paths return a value" check
+    ) {
+        setImmediate(() => {
+            if (continuationPoints instanceof Buffer) {
+                const callbackSingle = callback;
+                this.browseNext([continuationPoints], releaseContinuationPoints, (err, _results) => {
+                    if (err) {
+                        callbackSingle?.(err);
+                        return;
+                    }
+                    callbackSingle?.(null, _results?.[0]);
+                });
+                return;
+            }
+            innerBrowseNext({ continuationPointManager: this.continuationPointManager }, continuationPoints, releaseContinuationPoints, callback);
+        });
+    }
+    call(methodsToCall, callback
+    // biome-ignore lint/suspicious/noConfusingVoidType: implementation must satisfy both the void (callback) and Promise<T> (thenify-wrapped) overloads; biome's suggested undefined-in-union fix breaks the "not all code paths return a value" check
+    ) {
+        const isArray = Array.isArray(methodsToCall);
+        if (!isArray) {
+            methodsToCall = [methodsToCall];
+        }
+        Promise.all(methodsToCall.map(async (methodToCall) => {
+            const callMethodRequest = new node_opcua_service_call_1.CallMethodRequest(methodToCall);
+            try {
+                const result = await (0, call_helpers_js_1.callMethodHelper)(this[$context], this[$addressSpace], callMethodRequest);
+                return new node_opcua_service_call_1.CallMethodResult(result);
+            }
+            catch (err) {
+                errorLog("Internal Error = ", err);
+                return new node_opcua_service_call_1.CallMethodResult({
+                    statusCode: node_opcua_status_code_1.StatusCodes.BadInternalError
+                });
+            }
+        }))
+            .then((callMethodResults) => {
+            if (isArray) {
+                callback?.(null, callMethodResults);
+            }
+            else {
+                callback?.(null, callMethodResults[0]);
+            }
+        })
+            .catch((err) => {
+            callback?.(err);
+        });
+    }
+    getArgumentDefinition(methodId, callback
+    // biome-ignore lint/suspicious/noConfusingVoidType: implementation must satisfy both the void (callback) and Promise<T> (thenify-wrapped) overloads; biome's suggested undefined-in-union fix breaks the "not all code paths return a value" check
+    ) {
+        (0, node_opcua_pseudo_session_1.getArgumentDefinitionHelper)(this, methodId)
+            .then((result) => {
+            callback?.(null, result);
+        })
+            .catch((err) => {
+            callback?.(err);
+        });
+    }
+    translateBrowsePath(browsePaths, callback
+    // biome-ignore lint/suspicious/noConfusingVoidType: implementation must satisfy both the void (callback) and Promise<T> (thenify-wrapped) overloads; biome's suggested undefined-in-union fix breaks the "not all code paths return a value" check
+    ) {
+        const isArray = Array.isArray(browsePaths);
+        if (!isArray) {
+            browsePaths = [browsePaths];
+        }
+        const browsePathResults = browsePaths.map((browsePath) => {
+            return this[$addressSpace].browsePath(browsePath);
+        });
+        if (isArray) {
+            callback?.(null, browsePathResults);
+        }
+        else {
+            callback?.(null, browsePathResults[0]);
+        }
+    }
+    write(nodesToWrite, callback
+    // biome-ignore lint/suspicious/noConfusingVoidType: implementation must satisfy both the void (callback) and Promise<T> (thenify-wrapped) overloads; biome's suggested undefined-in-union fix breaks the "not all code paths return a value" check
+    ) {
+        const isArray = Array.isArray(nodesToWrite);
+        const _nodesToWrite = !isArray ? [nodesToWrite] : nodesToWrite;
+        const context = this[$context];
+        setImmediate(() => {
+            const statusCodesPromises = _nodesToWrite.map((nodeToWrite) => {
+                (0, node_opcua_assert_1.assert)(!!nodeToWrite.attributeId, "expecting a attributeId");
+                if (!nodeToWrite.nodeId) {
+                    return node_opcua_status_code_1.StatusCodes.BadNodeIdUnknown;
+                }
+                const obj = this[$addressSpace].findNode(nodeToWrite.nodeId);
+                if (!obj) {
+                    return node_opcua_status_code_1.StatusCodes.BadNodeIdUnknown;
+                }
+                try {
+                    return (0, node_util_1.promisify)(obj.writeAttribute).call(obj, context, nodeToWrite);
+                }
+                catch (_err) {
+                    return node_opcua_status_code_1.StatusCodes.BadInternalError;
+                }
+            });
+            Promise.all(statusCodesPromises)
+                .then((statusCodes) => {
+                if (isArray) {
+                    callback?.(null, statusCodes);
+                }
+                else {
+                    callback?.(null, statusCodes[0]);
+                }
+            })
+                .catch((err) => {
+                callback?.(err);
+            });
+        });
+    }
+}
+exports.PseudoSession = PseudoSession;
+const thenify_ex_1 = require("thenify-ex");
+PseudoSession.prototype.read = (0, thenify_ex_1.withCallback)(PseudoSession.prototype.read);
+PseudoSession.prototype.write = (0, thenify_ex_1.withCallback)(PseudoSession.prototype.write);
+PseudoSession.prototype.browse = (0, thenify_ex_1.withCallback)(PseudoSession.prototype.browse);
+PseudoSession.prototype.browseNext = (0, thenify_ex_1.withCallback)(PseudoSession.prototype.browseNext);
+PseudoSession.prototype.getArgumentDefinition = (0, thenify_ex_1.withCallback)(PseudoSession.prototype.getArgumentDefinition);
+PseudoSession.prototype.call = (0, thenify_ex_1.withCallback)(PseudoSession.prototype.call);
+PseudoSession.prototype.translateBrowsePath = (0, thenify_ex_1.withCallback)(PseudoSession.prototype.translateBrowsePath);
+//# sourceMappingURL=pseudo_session.js.map

package/dist/api/pseudo_session.js.map

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

package/dist/api/session_context.d.ts

@@ -0,0 +1,242 @@
+/**
+ * @module node-opcua-address-space
+ */
+/** biome-ignore-all lint/style/useLiteralEnumMembers: still needed */
+import type { BaseNode, IAddressSpace, ISessionBase, ISessionContext, UAObject, UAObjectType } from "node-opcua-address-space-base";
+import { ObjectIds } from "node-opcua-constants";
+import { type Certificate } from "node-opcua-crypto/web";
+import { AccessRestrictionsFlag, PermissionFlag, type QualifiedNameLike } from "node-opcua-data-model";
+import type { PreciseClock } from "node-opcua-date-time";
+import { NodeId, type NodeIdLike } from "node-opcua-nodeid";
+import { AnonymousIdentityToken, MessageSecurityMode, PermissionType, type RolePermissionType, UserNameIdentityToken, X509IdentityToken } from "node-opcua-types";
+export type { RolePermissionTypeOptions } from "node-opcua-types";
+export { PermissionType, RolePermissionType } from "node-opcua-types";
+export type AnyUserIdentityToken = UserNameIdentityToken | AnonymousIdentityToken | X509IdentityToken;
+import { WellKnownRoles } from "node-opcua-constants";
+export { WellKnownRoles } from "node-opcua-constants";
+/** @deprecated Use WellKnownRoles instead */
+export declare const WellKnownRolesNodeId: {
+    readonly Anonymous: ObjectIds.WellKnownRole_Anonymous;
+    readonly AuthenticatedUser: ObjectIds.WellKnownRole_AuthenticatedUser;
+    readonly ConfigureAdmin: ObjectIds.WellKnownRole_ConfigureAdmin;
+    readonly Engineer: ObjectIds.WellKnownRole_Engineer;
+    readonly Observer: ObjectIds.WellKnownRole_Observer;
+    readonly Operator: ObjectIds.WellKnownRole_Operator;
+    readonly SecurityAdmin: ObjectIds.WellKnownRole_SecurityAdmin;
+    readonly Supervisor: ObjectIds.WellKnownRole_Supervisor;
+};
+/**
+ * OPC Unified Architecture, Part 3 13 Release 1.04
+ * 4.8.2 Well Known Roles
+ * All Servers should support the well-known Roles which are defined in Table 2. The NodeIds
+ * for the well-known Roles are defined in Part 6.
+ * Table 2 – Well-Known Roles
+ * BrowseName           Suggested Permissions
+ *
+ * Anonymous            The Role has very limited access for use when a Session has anonymous credentials.
+ * AuthenticatedUser    The Role has limited access for use when a Session has valid non-anonymous credentials
+ *                      but has not been explicitly granted access to a Role.
+ * Observer             The Role is allowed to browse, read live data, read historical data/events or subscribe to data/events.
+ * Operator             The Role is allowed to browse, read live data, read historical data/events or subscribe to data/events.
+ *                      In addition, the Session is allowed to write some live data and call some Methods.
+ * Engineer             The Role is allowed to browse, read/write configuration data, read historical data/events,
+ *                      call Methods or subscribe to data/events.
+ * Supervisor           The Role is allowed to browse, read live data, read historical data/events, call Methods or
+ *                      subscribe to data/events.
+ * ConfigureAdmin       The Role is allowed to change the non-security related config
+ * SecurityAdmin	    The Role is allowed to change security related settings.
+ */
+export type WellKnownRolesSemiColumnSeparated = string;
+export interface IUserManager {
+    /**
+     * retrieve the roles of the given user
+     *  @returns semicolon separated list of roles
+     */
+    getUserRoles?: (user: string) => NodeId[];
+}
+/**
+ * A temporary override for role resolution.
+ *
+ * When set on the server, `getUserRoles` is called
+ * **before** the default `userManager`. Returning
+ * a `NodeId[]` overrides the roles; returning `null`
+ * falls through to the default resolution.
+ */
+export interface IRolePolicyOverride {
+    getUserRoles(username: string): NodeId[] | null;
+}
+/**
+ * Session attributes a resolver may use to evaluate application/endpoint
+ * restrictions on a Role (OPC 10000-18 §4.4.1).
+ */
+export interface IRoleResolutionContext {
+    /** ApplicationUri from the Client certificate, if any. */
+    applicationUri?: string | null;
+    /** SecureChannel security mode. */
+    securityMode?: MessageSecurityMode;
+    /** SecureChannel security policy URI. */
+    securityPolicyUri?: string;
+    /** Endpoint URL used by the Session, if known. */
+    endpointUrl?: string;
+}
+/**
+ * Pluggable role resolver (OPC 10000-18 §4.4).
+ *
+ * Receives the full UserIdentityToken so implementations can match by
+ * Thumbprint, X509Subject, UserName, etc., plus an optional resolution context
+ * to enforce application/endpoint restrictions. Registered on
+ * IServerBase.roleResolvers by packages like node-opcua-role-set-server.
+ */
+export interface IRoleResolver {
+    resolveRoles(userIdentityToken: AnyUserIdentityToken, context?: IRoleResolutionContext): NodeId[];
+}
+/**
+ * What to do when a permission cannot be resolved for a Session — either because no Role
+ * could be attached to its identity, or because neither the node nor its namespace declares
+ * any RolePermissions.
+ *
+ *  - `"allow"` : grant every permission. This is what node-opcua has always done, and what
+ *                the vast majority of address spaces need, since almost no server declares
+ *                RolePermissions on its own nodes.
+ *  - `"deny"`  : grant nothing. Fail-closed, for products that drive access entirely from
+ *                declared policy. Expect to set DefaultRolePermissions on every namespace,
+ *                otherwise the address space becomes unreadable.
+ *
+ * Note that this governs *Sessions only*. A SessionContext with no Session at all is an
+ * in-process caller (SessionContext.defaultContext, PseudoSession) and stays permissive
+ * whatever this is set to — see {@link SessionContext.getPermissions}.
+ */
+export type UnresolvedPermissionPolicy = "allow" | "deny";
+export interface IServerBase {
+    userManager?: IUserManager;
+    rolePolicyOverride?: IRolePolicyOverride | null;
+    /** Additional role resolvers (identity stores, LDAP, etc.) */
+    roleResolvers?: IRoleResolver[];
+    /**
+     * how to treat a permission that could not be resolved for a Session.
+     * @default "allow"
+     */
+    unresolvedPermissionPolicy?: UnresolvedPermissionPolicy;
+}
+export interface SessionContextOptions {
+    session?: ISessionBase;
+    object?: UAObject | UAObjectType;
+    server?: IServerBase;
+}
+/**
+ * A Role, designated either by its NodeId or by its BrowseName.
+ *
+ * Roles outside namespace 0 (the GDS Roles, or any Role added with AddRole) have
+ * NodeIds that depend on the order in which nodesets were loaded, so naming them is
+ * more robust than hard coding `ns=1;i=1661`. Resolving a BrowseName requires an
+ * address space, since the RoleSet is where the answer lives.
+ *
+ * A QualifiedName whose namespaceIndex is left undefined matches in any namespace,
+ * as long as the BrowseName is unambiguous.
+ */
+export type RoleIdLike = NodeIdLike | QualifiedNameLike;
+/**
+ * build the list of Role NodeIds a user is granted, from any of the accepted spellings:
+ *
+ * ```ts
+ * makeRoles(WellKnownRoles.Observer);                        // a well known Role
+ * makeRoles("Observer;Operator");                            // semicolon separated names
+ * makeRoles("ns=1;i=1661");                                  // an explicit NodeId
+ * makeRoles(["Observer", "ns=1;i=1661"]);                    // mixed
+ * makeRoles("1:DiscoveryAdmin", addressSpace);               // BrowseName, namespace index
+ * makeRoles("DiscoveryAdmin", addressSpace);                 // BrowseName, any namespace
+ * makeRoles([{ name: "DiscoveryAdmin" }], addressSpace);     // idem, as a QualifiedName
+ * // when the namespace is known by its URI rather than by its index:
+ * makeRoles([{ namespaceIndex: addressSpace.getNamespaceIndex(gdsUri), name: "DiscoveryAdmin" }], addressSpace);
+ * ```
+ *
+ * @param roleIds  the Roles to resolve
+ * @param addressSpace  required only to resolve a Role by BrowseName, since that
+ *                      lookup goes through the RoleSet
+ */
+export declare function makeRoles(roleIds: RoleIdLike[] | string | WellKnownRoles, addressSpace?: IAddressSpace): NodeId[];
+export declare class SessionContext implements ISessionContext {
+    static defaultContext: SessionContext;
+    object: UAObject | UAObjectType | undefined;
+    currentTime?: PreciseClock;
+    continuationPoints: Buffer[];
+    readonly session?: ISessionBase;
+    readonly server?: IServerBase;
+    constructor(options?: SessionContextOptions);
+    /**
+     * The client's application-instance certificate,
+     * or `null` if no secure channel is available.
+     */
+    get clientCertificate(): Certificate | null;
+    /**
+     * The application URI extracted from the client
+     * certificate's SubjectAltName, or `null` if
+     * no certificate is available.
+     */
+    get clientApplicationUri(): string | null;
+    /** The URL of the Endpoint the Session was created on, or `null` if unknown. */
+    get endpointUrl(): string | null;
+    toJSON(): Record<string, string | null>;
+    toString(): string;
+    getUserName(): string;
+    /**
+     * getCurrentUserRoles
+     *
+     * guest   => anonymous user (unauthenticated)
+     * default => default authenticated user
+     *
+     */
+    getCurrentUserRoles(): NodeId[];
+    getApplicableRolePermissions(node: BaseNode): RolePermissionType[] | null;
+    /**
+     * true when this context carries no Session at all.
+     *
+     * That is an in-process caller — SessionContext.defaultContext, or a PseudoSession
+     * driving the address space from inside the server — not a remote one. Such a caller
+     * has already passed whatever authorization its own entry point applies, and the
+     * address space is not the place to second-guess it, so it is always granted every
+     * permission. This is deliberate, and distinct from a remote Session whose identity
+     * merely failed to resolve to a Role: that case is governed by
+     * IServerBase.unresolvedPermissionPolicy.
+     */
+    private get isInProcessCaller();
+    /** what an unresolved permission means for this context: everything, or nothing */
+    private get unresolvedPermissions();
+    /**
+     * the Roles to evaluate permissions against: the ones the user resolved to, plus the
+     * Anonymous Role, which every Session stands on.
+     *
+     * Opc.Ua.NodeSet2.xml names exactly five Roles across its 854 RolePermission entries —
+     * Anonymous, SecurityAdmin, ConfigureAdmin and the two SecurityKeyServer ones — and
+     * never AuthenticatedUser, Observer, Operator, Engineer or Supervisor. Its 195 Anonymous
+     * entries (Browse, Browse|Read, Browse|Call) are therefore not a privilege reserved for
+     * unauthenticated Sessions; they are the floor granted to everyone. Read literally, an
+     * authenticated user would be unable to browse the Server Object at all, and would have
+     * strictly less access than an anonymous one.
+     *
+     * Adding the Anonymous Role here can only widen a permission set, never narrow it, and
+     * only ever to what an unauthenticated Session already has — so it cannot grant anything
+     * an attacker could not obtain by simply not authenticating. It leaves
+     * getCurrentUserRoles() alone: the identity a Session reports stays truthful, only the
+     * permission evaluation gains the baseline.
+     */
+    private getRolesForPermissionEvaluation;
+    getPermissions(node: BaseNode): PermissionFlag;
+    getAccessRestrictions(node: BaseNode): AccessRestrictionsFlag;
+    /**
+     *
+     * @param node
+     * @returns true if the browse is denied (access is restricted)
+     */
+    isBrowseAccessRestricted(node: BaseNode): boolean;
+    /**
+     *
+     * @param node
+     * @returns true  if the context is access restricted
+     */
+    isAccessRestricted(node: BaseNode): boolean;
+    /**
+     */
+    checkPermission(node: BaseNode, requestedPermission: PermissionType): boolean;
+    currentUserHasRole(role: NodeIdLike): boolean;
+}

package/dist/api/session_context.js.map

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

package/dist/api/set_namespace_meta_data.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"set_namespace_meta_data.js","sourceRoot":"","sources":["../../api/set_namespace_meta_data.ts"],"names":[],"mappings":";;AAQA,oDAiEC;AAvED,2DAAyE;AAEzE,SAAS,aAAa,CAAC,YAAoB;IACvC,OAAO,YAAY,CAAC;AACxB,CAAC;AAED,SAAgB,oBAAoB,CAAC,SAAqB;IACtD,wBAAwB;IACxB,MAAM,YAAY,GAAG,SAAS,CAAC,YAAY,CAAC;IAC5C,MAAM,qBAAqB,GAAG,YAAY,CAAC,cAAc,CAAC,uBAAuB,CAAC,CAAC;IACnF,MAAM,UAAU,GAAG,YAAY,CAAC,UAAU,CAAC,OAAO,CAAC,MAAM,CAAC,cAAc,CAAC,YAAY,CAAa,CAAC;IAEnG,oBAAoB;IACpB,IAAI,CAAC,UAAU,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;IAC3E,CAAC;IACD,oBAAoB;IACpB,IAAI,CAAC,qBAAqB,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;IACzD,CAAC;IAED,MAAM,UAAU,GAAG,aAAa,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;IAEzD,MAAM,gBAAgB,GAAG,UAAU,CAAC,kBAAkB,CAAC,UAAU,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC;IAEpF,oBAAoB;IACpB,IAAI,gBAAgB,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CAAC,2CAA2C,UAAU,EAAE,CAAC,CAAC;IAC7E,CAAC;IACD,MAAM,QAAQ,GAAG,qBAAqB,CAAC,WAAW,CAAC;QAC/C,UAAU,EAAE,UAAU;QACtB,WAAW,EAAE,UAAU;QACvB,SAAS,EAAE;YACP,wBAAwB;YACxB,2BAA2B;YAC3B,4BAA4B;YAC5B,kBAAkB;SACrB;KACJ,CAAwB,CAAC;IAE1B,gEAAgE;IAChE,MAAM,YAAY,GAAG,QAAQ,CAAC,cAAc,CAAC,cAAc,CAAe,CAAC;IAC3E,YAAY,CAAC,kBAAkB,CAAC,EAAE,QAAQ,EAAE,6BAAQ,CAAC,MAAM,EAAE,KAAK,EAAE,SAAS,CAAC,YAAY,EAAE,CAAC,CAAC;IAE9F,MAAM,wBAAwB,GAAG,QAAQ,CAAC,wBAAwB,CAAC;IACnE,wBAAwB,CAAC,kBAAkB,CAAC,EAAE,QAAQ,EAAE,6BAAQ,CAAC,QAAQ,EAAE,KAAK,EAAE,IAAI,IAAI,EAAE,EAAE,CAAC,CAAC;IAEhG,MAAM,gBAAgB,GAAG,QAAQ,CAAC,gBAAgB,CAAC;IACnD,gBAAgB,CAAC,kBAAkB,CAAC,EAAE,QAAQ,EAAE,6BAAQ,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;IAEnF,QAAQ,CAAC,yBAAyB,EAAE,YAAY,CAC5C;QACI,GAAG,EAAE,GAAG,EAAE,CACN,IAAI,4BAAO,CAAC;YACR,QAAQ,EAAE,6BAAQ,CAAC,MAAM;YACzB,KAAK,EAAE,SAAS,CAAC,4BAA4B,EAAE;SAClD,CAAC;KACT,EACD,IAAI,CACP,CAAC;IACF,QAAQ,CAAC,sBAAsB,EAAE,YAAY,CACzC;QACI,GAAG,EAAE,GAAG,EAAE,CACN,IAAI,4BAAO,CAAC;YACR,QAAQ,EAAE,6BAAQ,CAAC,eAAe;YAClC,SAAS,EAAE,qCAAgB,CAAC,KAAK;YACjC,KAAK,EAAE,SAAS,CAAC,yBAAyB,EAAE;SAC/C,CAAC;KACT,EACD,IAAI,CACP,CAAC;AACN,CAAC"}

package/dist/api/ua_addin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ua_addin.js","sourceRoot":"","sources":["../../api/ua_addin.ts"],"names":[],"mappings":";;AAeA,4CAkBC;AAED,oEAqBC;AAvDD,mEAAkD;AAClD,iEAAwG;AAaxG,SAAgB,gBAAgB,CAAC,UAAwB,EAAE,OAAgC;IACvF,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;IACxC,kDAAkD;IAClD,MAAM,yBAAyB,GAAG,UAAU,CAAC,iBAAiB,CAAC,2BAA2B,CAAC,CAAC;IAC5F,IAAI,CAAC,yBAAyB,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,2DAA2D,CAAC,CAAC;IACjF,CAAC;IAED,MAAM,UAAU,GAAG,IAAA,2CAAmB,EAAC,WAAW,IAAK,yBAAyB,CAAC,SAAS,EAAE,CAAC,KAAK,CAAC,KAAuB,CAAC,CAAC;IAC5H,MAAM,KAAK,GAAG,UAAU,CAAC,WAAW,CAAC;QACjC,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,UAAU,CAAC,SAAS;QACpD,UAAU,EAAE,UAAU;QACtB,aAAa,EAAE,OAAO,CAAC,aAAa;QACpC,sBAAsB,EAAE,OAAO,CAAC,sBAAsB;QACtD,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,MAAM,EAAE,OAAO,CAAC,MAAM;KACzB,CAAC,CAAC;IACH,OAAO,KAAK,CAAC;AACjB,CAAC;AAED,SAAgB,4BAA4B,CACxC,UAAwB,EACxB,iBAAyC;IAEzC,MAAM,UAAU,GAAG,UAAU,CAAC,SAAS,CAAC;IACxC,IAAI,OAAO,iBAAiB,KAAK,QAAQ,EAAE,CAAC;QACxC,iBAAiB,GAAG,IAAA,2CAAmB,EAAC,EAAE,IAAI,EAAE,iBAAiB,EAAE,cAAc,EAAE,UAAU,CAAC,KAAK,EAAE,CAAC,CAAC;IAC3G,CAAC;IAED,MAAM,UAAU,GAAG,UAAU,CAAC,WAAW,CAAC;QACtC,UAAU,EAAE,IAAA,2CAAmB,EAAC,EAAE,IAAI,EAAE,2BAA2B,EAAE,cAAc,EAAE,CAAC,EAAE,CAAC;QACzF,UAAU,EAAE,UAAU;QACtB,cAAc,EAAE,cAAc;QAC9B,QAAQ,EAAE,iCAAQ,CAAC,aAAa;QAChC,KAAK,EAAE;YACH,QAAQ,EAAE,iCAAQ,CAAC,aAAa;YAChC,KAAK,EAAE,iBAAiB;SAC3B;QACD,aAAa,EAAE,IAAI,CAAC,uDAAuD;KAC9E,CAAC,CAAC;IACH,OAAO,UAAgE,CAAC;AAC5E,CAAC"}

package/dist/api/ua_interface.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.implementInterface = implementInterface;
+const node_opcua_types_1 = require("node-opcua-types");
+const _instantiate_helpers_js_1 = require("../impl/_instantiate_helpers.js");
+function implementInterface(uaNode, interfaceType, optionals, isModellingType) {
+    optionals = optionals || [];
+    const addressSpace = uaNode.addressSpace;
+    const topMost = addressSpace.findObjectType("BaseInterfaceType");
+    if (!topMost) {
+        throw new Error("cannot find BaseInterfaceType");
+    }
+    isModellingType =
+        isModellingType === undefined
+            ? uaNode.nodeClass === node_opcua_types_1.NodeClass.ObjectType || uaNode.nodeClass === node_opcua_types_1.NodeClass.VariableType
+            : isModellingType;
+    const copyAlsoModellingRules = isModellingType;
+    const copyAlsoAllOptionals = isModellingType;
+    (0, _instantiate_helpers_js_1.initialize_properties_and_components)(uaNode, topMost, interfaceType, copyAlsoModellingRules, copyAlsoAllOptionals, optionals);
+    uaNode.addReference({
+        nodeId: interfaceType,
+        referenceType: "HasInterface"
+    });
+}
+//# sourceMappingURL=ua_interface.js.map

package/dist/api/ua_interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ua_interface.js","sourceRoot":"","sources":["../../api/ua_interface.ts"],"names":[],"mappings":";;AAIA,gDAiCC;AApCD,uDAA6C;AAC7C,6EAAuF;AAEvF,SAAgB,kBAAkB,CAC9B,MAA6D,EAC7D,aAA2B,EAC3B,SAAoB,EACpB,eAAyB;IAEzB,SAAS,GAAG,SAAS,IAAI,EAAE,CAAC;IAE5B,MAAM,YAAY,GAAG,MAAM,CAAC,YAAY,CAAC;IACzC,MAAM,OAAO,GAAG,YAAY,CAAC,cAAc,CAAC,mBAAmB,CAAC,CAAC;IACjE,IAAI,CAAC,OAAO,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;IACrD,CAAC;IAED,eAAe;QACX,eAAe,KAAK,SAAS;YACzB,CAAC,CAAC,MAAM,CAAC,SAAS,KAAK,4BAAS,CAAC,UAAU,IAAI,MAAM,CAAC,SAAS,KAAK,4BAAS,CAAC,YAAY;YAC1F,CAAC,CAAC,eAAe,CAAC;IAE1B,MAAM,sBAAsB,GAAG,eAAe,CAAC;IAC/C,MAAM,oBAAoB,GAAG,eAAe,CAAC;IAC7C,IAAA,8DAAoC,EAChC,MAA+B,EAC/B,OAAO,EACP,aAAa,EACb,sBAAsB,EACtB,oBAAoB,EACpB,SAAS,CACZ,CAAC;IACF,MAAM,CAAC,YAAY,CAAC;QAChB,MAAM,EAAE,aAAa;QACrB,aAAa,EAAE,cAAc;KAChC,CAAC,CAAC;AACP,CAAC"}

package/dist/api/ua_root_folder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ua_root_folder.js","sourceRoot":"","sources":["../../api/ua_root_folder.ts"],"names":[],"mappings":""}