node-opcua-alias-name-server 2.176.0

package/dist/bind_alias_category.js

@@ -0,0 +1,417 @@
+"use strict";
+/**
+ * @module node-opcua-alias-name-server
+ *
+ * Binding the Methods of a single `AliasNameCategoryType` instance, and creating
+ * new categories at runtime.
+ *
+ * This is the one binding path. `installAliasNamesOnAddressSpace` calls
+ * {@link bindAliasCategory} in its loop rather than doing the work itself, so a
+ * category created after installation cannot end up bound differently from one
+ * that was there at install time — or, worse, not bound at all. An unbound
+ * MANDATORY `FindAlias` is the exact defect this package exists to remove, and
+ * it should not be able to reappear at runtime.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.INSTALLED = void 0;
+exports.bindAliasCategory = bindAliasCategory;
+exports.ensureLastChangeProperty = ensureLastChangeProperty;
+exports.addAliasCategory = addAliasCategory;
+exports.removeAliasCategory = removeAliasCategory;
+exports.findMethodByDeclaration = findMethodByDeclaration;
+exports.ensureOptionalMethod = ensureOptionalMethod;
+exports.getInstalledAliasNames = getInstalledAliasNames;
+exports.setInstalledAliasNames = setInstalledAliasNames;
+const node_opcua_data_model_1 = require("node-opcua-data-model");
+const node_opcua_nodeid_1 = require("node-opcua-nodeid");
+const node_opcua_variant_1 = require("node-opcua-variant");
+const bind_configuration_methods_js_1 = require("./bind_configuration_methods.js");
+const bind_find_alias_js_1 = require("./bind_find_alias.js");
+const last_change_js_1 = require("./last_change.js");
+const well_known_js_1 = require("./well_known.js");
+/**
+ * Bind `FindAlias` — and, when `verbose`, `FindAliasVerbose` — on one
+ * `AliasNameCategoryType` instance.
+ *
+ * Safe to call on a category that is already bound: `bindMethod` replaces the
+ * handler, and the optional Method is only added when it is missing.
+ *
+ * Use this for a category created after `installAliasNames` has run. The options
+ * that installation used are on {@link InstallAliasNamesResult.bindingOptions},
+ * so a caller does not have to reassemble them and risk binding a late category
+ * with a different store or a different result cap.
+ */
+function bindAliasCategory(addressSpace, category, options) {
+    const findAlias = findMethodByDeclaration(category, well_known_js_1.MethodDeclarations.FindAlias, "FindAlias");
+    findAlias?.bindMethod((0, bind_find_alias_js_1.makeFindAliasHandler)(options, false));
+    if (options.verbose ?? true) {
+        const verbose = ensureOptionalMethod(addressSpace, category, "FindAliasVerbose");
+        verbose?.bindMethod((0, bind_find_alias_js_1.makeFindAliasHandler)(options, true));
+    }
+    if (options.lastChangeProperty ?? true) {
+        ensureLastChangeProperty(addressSpace, category);
+    }
+    // The write surface only appears when asked for (clause 6.3.4 / 6.3.5 are
+    // both Optional), and even then every call is denied unless isWriteAllowed
+    // says otherwise.
+    if (options.configurationMethods) {
+        const configurationOptions = {
+            store: options.store,
+            isWriteAllowed: options.isWriteAllowed,
+            onChanged: options.onChanged
+        };
+        const add = ensureOptionalMethod(addressSpace, category, "AddAliasesToCategory");
+        add?.bindMethod((0, bind_configuration_methods_js_1.makeAddAliasesToCategoryHandler)(configurationOptions));
+        const remove = ensureOptionalMethod(addressSpace, category, "DeleteAliasesFromCategory");
+        remove?.bindMethod((0, bind_configuration_methods_js_1.makeDeleteAliasesFromCategoryHandler)(configurationOptions));
+    }
+}
+/**
+ * The default NodeId for a new category: a **string** NodeId spelling out its
+ * path under `Aliases`, for instance `ns=1;s=Aliases/TagVariables/Unit200`.
+ *
+ * The obvious alternative — letting the namespace assign the next free numeric
+ * id — is wrong here for two reasons.
+ *
+ * It is **not stable across restarts**. The counter depends on how many other
+ * Nodes were created first, so adding one unrelated Variable to a Server shifts
+ * every category's NodeId. That silently breaks `LastChange` persistence, which
+ * keys on the category NodeId: the restored values no longer match any
+ * category, `LastChange` reads 0, and clause 6.3.1 then requires every connected
+ * Client to clear a cache that was perfectly valid. A Server-side change with a
+ * purely remote symptom.
+ *
+ * It is also **not diagnosable**. `ns=1;i=1010` in a log or a
+ * `FindAliasVerbose` result says nothing; `ns=1;s=Aliases/TagVariables/Unit200`
+ * says which category it is without a lookup.
+ *
+ * The path is unique because two categories cannot share a parent and a
+ * BrowseName, and it is derived from the same information every run, so it is
+ * the same NodeId every run.
+ */
+function defaultCategoryNodeId(parent, browseName, namespaceIndex) {
+    const path = [...categoryPathOf(parent), browseName].join("/");
+    return new node_opcua_nodeid_1.NodeId(node_opcua_nodeid_1.NodeIdType.STRING, path, namespaceIndex);
+}
+/**
+ * The BrowseNames from the `Aliases` root down to `category`, inclusive.
+ *
+ * Falls back to the category's own BrowseName when it is not under the root,
+ * which keeps the id derivable for a category modelled outside the standard
+ * hierarchy.
+ */
+function categoryPathOf(category) {
+    const segments = [];
+    const seen = new Set();
+    let current = category;
+    while (current) {
+        const key = current.nodeId.toString();
+        if (seen.has(key)) {
+            break;
+        }
+        seen.add(key);
+        segments.unshift(current.browseName.name ?? key);
+        if (key === well_known_js_1.WellKnownCategories.Aliases.toString()) {
+            break;
+        }
+        const parents = current.findReferencesExAsObject("HierarchicalReferences", node_opcua_data_model_1.BrowseDirection.Inverse);
+        const next = parents.find((p) => p.nodeClass === node_opcua_data_model_1.NodeClass.Object);
+        current = next ? next : null;
+    }
+    return segments;
+}
+/**
+ * Ensure a category has a `LastChange` Property.
+ *
+ * `LastChange` is Optional on `AliasNameCategoryType` and the shipped nodeset
+ * instantiates it only on the `Aliases` root, which clause 9.2 makes mandatory.
+ * Adding it to every category is conformant — Optional means may, not must not —
+ * and it is what makes the clause 6.3.1 rollup observable: without it, a Client
+ * watching one branch has nothing to watch.
+ */
+function ensureLastChangeProperty(addressSpace, category) {
+    const existing = category.getPropertyByName(last_change_js_1.LAST_CHANGE_BROWSE_NAME);
+    if (existing) {
+        return existing;
+    }
+    const namespace = addressSpace.getNamespace(category.nodeId.namespace === 0 ? addressSpace.getOwnNamespace().index : category.nodeId.namespace);
+    return namespace.addVariable({
+        propertyOf: category,
+        browseName: last_change_js_1.LAST_CHANGE_BROWSE_NAME,
+        // VersionTime (i=20998) is a UInt32 subtype, not a DateTime
+        dataType: well_known_js_1.VERSION_TIME_DATA_TYPE,
+        minimumSamplingInterval: 1000,
+        value: { dataType: node_opcua_variant_1.DataType.UInt32, value: 0 }
+    });
+}
+/**
+ * Create a vendor `AliasNameCategoryType` instance under `parent` **and bind it**.
+ *
+ * Creating one by hand means instantiating the type, wiring the `Organizes`
+ * reference and then remembering to bind — and a category whose `FindAlias` is
+ * unbound fails conformance silently. This does all three.
+ *
+ * When `installAliasNames` has already run on this address space, the binding
+ * options it used are reused unless overridden, so a category added at runtime
+ * behaves exactly like one that was present at install time. Pass a `store`
+ * explicitly if installation has not run yet.
+ */
+function addAliasCategory(addressSpace, parent, browseName, options) {
+    const parentNode = coerceCategoryNode(addressSpace, parent);
+    const categoryType = resolveCategoryType(addressSpace, options?.categoryType);
+    const namespace = addressSpace.getNamespace(options?.namespaceIndex ?? addressSpace.getOwnNamespace().index);
+    const nodeId = options?.nodeId ?? defaultCategoryNodeId(parentNode, browseName, namespace.index);
+    if (addressSpace.findNode(nodeId)) {
+        throw new Error(`addAliasCategory: ${nodeId.toString()} already exists. A category's default NodeId is derived from its ` +
+            "path under Aliases, so this means a category of the same name already exists under the same parent.");
+    }
+    const category = categoryType.instantiate({
+        browseName: { name: browseName, namespaceIndex: namespace.index },
+        nodeId,
+        organizedBy: parentNode,
+        namespace
+    });
+    if (options?.rolePermissions) {
+        // instantiate() does not take them, so they are applied after
+        category.setRolePermissions(options.rolePermissions);
+    }
+    const bindingOptions = resolveBindingOptions(addressSpace, options);
+    if (bindingOptions) {
+        bindAliasCategory(addressSpace, category, bindingOptions);
+    }
+    // clause 6.3.1: "The last time an AliasNameCategory was added or deleted"
+    notifyCategoryChanged(addressSpace, parentNode.nodeId);
+    return category;
+}
+/**
+ * Resolve the ObjectType to instantiate, defaulting to `AliasNameCategoryType`.
+ *
+ * A subtype is accepted: discovery matches on "is this an instance of
+ * AliasNameCategoryType *or a subtype*", and binding looks the Methods up by
+ * MethodDeclarationId, so neither cares which exact type was used.
+ */
+function resolveCategoryType(addressSpace, categoryType) {
+    const base = addressSpace.findObjectType(well_known_js_1.ALIAS_NAME_CATEGORY_TYPE);
+    if (!base) {
+        throw new Error("addAliasCategory: AliasNameCategoryType (i=23456) is not in the address space");
+    }
+    if (!categoryType) {
+        return base;
+    }
+    const resolved = categoryType instanceof node_opcua_nodeid_1.NodeId ? addressSpace.findObjectType(categoryType) : categoryType;
+    if (!resolved) {
+        throw new Error(`addAliasCategory: unknown ObjectType ${String(categoryType)}`);
+    }
+    if (resolved.nodeId.value !== base.nodeId.value && !resolved.isSubtypeOf(base)) {
+        throw new Error(`addAliasCategory: ${resolved.browseName.toString()} is not AliasNameCategoryType or a subtype of it`);
+    }
+    return resolved;
+}
+/**
+ * Remove a category, and decide what happens to what it Organizes.
+ *
+ * The specification does not say, so the rule is stated here rather than left to
+ * whatever `deleteNode` happens to do:
+ *
+ * - **`reparent`** (the default) moves the category's aliases and subcategories
+ *   to its parent before deleting it. Nothing disappears, so a Client that had
+ *   resolved an alias keeps resolving it — the alias Object keeps its NodeId,
+ *   and clause 6.2 makes a NodeId change mean "this is a different alias".
+ * - **`cascade`** deletes them with it. Correct when the category *is* the
+ *   thing being retired, such as a tenant being removed.
+ *
+ * Refuses to remove one of the three well-known categories, which clause 9
+ * requires a Server to have.
+ *
+ * @returns the aliases and subcategories that were re-parented, or deleted.
+ */
+function removeAliasCategory(addressSpace, category, options) {
+    const node = coerceCategoryNode(addressSpace, category);
+    for (const wellKnown of Object.values(well_known_js_1.WellKnownCategories)) {
+        if (wellKnown.value === node.nodeId.value && wellKnown.namespace === node.nodeId.namespace) {
+            throw new Error(`removeAliasCategory: ${node.browseName.toString()} is a well-known category that ` +
+                "OPC 10000-17 clause 9 requires the Server to have");
+        }
+    }
+    const parents = node.findReferencesExAsObject("HierarchicalReferences", node_opcua_data_model_1.BrowseDirection.Inverse);
+    // Organizes only, not every hierarchical reference. A category's Methods are
+    // HasComponent children that belong to it and must go with it; re-parenting
+    // those would leave the parent with a second FindAlias.
+    const childReferences = node.findReferencesEx("Organizes", node_opcua_data_model_1.BrowseDirection.Forward);
+    const orphans = options?.orphans ?? "reparent";
+    const moved = [];
+    const deleted = [];
+    if (orphans === "reparent") {
+        const parent = parents[0];
+        if (!parent) {
+            throw new Error(`removeAliasCategory: ${node.browseName.toString()} has no parent to re-parent its contents to; ` +
+                'pass { orphans: "cascade" } to delete them instead');
+        }
+        for (const reference of childReferences) {
+            parent.addReference({ referenceType: reference.referenceType, nodeId: reference.nodeId });
+            // Detach before deleting: deleteNode cascades through Organizes, so
+            // a child still referenced here would be deleted along with the
+            // category despite having just been re-parented.
+            node.removeReference({ referenceType: reference.referenceType, nodeId: reference.nodeId });
+            moved.push(reference.nodeId);
+        }
+    }
+    else {
+        for (const reference of childReferences) {
+            deleted.push(reference.nodeId);
+        }
+    }
+    // whatever is still attached goes with it
+    addressSpace.deleteNode(node.nodeId);
+    // clause 6.3.1: a category was deleted
+    for (const parent of parents) {
+        notifyCategoryChanged(addressSpace, parent.nodeId);
+    }
+    return { moved, deleted };
+}
+/**
+ * Tell the installed `LastChange` tracker that a category's contents changed.
+ *
+ * Fire and forget: the Property is written synchronously and only the
+ * persistence write is async, so a failure to persist must not fail the
+ * caller's structural change.
+ */
+function notifyCategoryChanged(addressSpace, categoryNodeId) {
+    const installed = getInstalledAliasNames(addressSpace);
+    void installed?.lastChange?.touch(categoryNodeId);
+}
+/**
+ * Merge explicit options over whatever installation recorded, or return null
+ * when there is nothing to bind with.
+ */
+function resolveBindingOptions(addressSpace, options) {
+    const installed = getInstalledAliasNames(addressSpace);
+    const inherited = installed?.bindingOptions;
+    const store = options?.store ?? inherited?.store;
+    if (!store) {
+        // nothing to bind against yet; installAliasNames will pick this category
+        // up when it runs, since it is Organized below its parent
+        return null;
+    }
+    // Inherit by spreading rather than by listing fields. Cherry-picking meant
+    // every new binding option had to be remembered here too, and forgetting one
+    // let a category created at runtime diverge from an installed one - silently,
+    // and in whichever direction was least safe.
+    const merged = {
+        ...inherited,
+        store,
+        maxResults: options?.maxResults ?? inherited?.maxResults ?? well_known_js_1.DEFAULT_MAX_RESULTS
+    };
+    // Only keys the caller actually supplied override the inherited value; an
+    // absent key must not read as "false".
+    for (const key of Object.keys(options ?? {})) {
+        const value = options?.[key];
+        if (value === undefined ||
+            key === "namespaceIndex" ||
+            key === "nodeId" ||
+            key === "categoryType" ||
+            key === "rolePermissions") {
+            continue;
+        }
+        Object.assign(merged, { [key]: value });
+    }
+    return merged;
+}
+/** Accept a category node or its NodeId. */
+function coerceCategoryNode(addressSpace, node) {
+    if (!(node instanceof node_opcua_nodeid_1.NodeId)) {
+        return node;
+    }
+    const found = addressSpace.findNode(node);
+    if (!found || found.nodeClass !== node_opcua_data_model_1.NodeClass.Object) {
+        throw new Error(`addAliasCategory: ${node.toString()} is not an Object in this address space`);
+    }
+    return found;
+}
+/**
+ * Find a Method on a category by its MethodDeclarationId, falling back to the
+ * BrowseName.
+ *
+ * The declaration id is the reliable key: a Server may publish the Method under
+ * a localised DisplayName, and the BrowseName is only unique within the
+ * namespace. The fallback covers instances built in code, which do not always
+ * carry a `methodDeclarationId`.
+ */
+function findMethodByDeclaration(category, declarationId, browseName) {
+    for (const component of category.getComponents()) {
+        if (component.nodeClass !== node_opcua_data_model_1.NodeClass.Method) {
+            continue;
+        }
+        const method = component;
+        if (method.methodDeclarationId && method.methodDeclarationId.value === declarationId.value) {
+            return method;
+        }
+        if (method.browseName.name === browseName) {
+            return method;
+        }
+    }
+    return null;
+}
+/**
+ * Ensure an optional Method exists on a category, adding it when the nodeset
+ * only declared it on the type.
+ *
+ * The shipped `Opc.Ua.NodeSet2.xml` declares `FindAliasVerbose`,
+ * `AddAliasesToCategory` and `DeleteAliasesFromCategory` on
+ * `AliasNameCategoryType` but instantiates none of them on `Aliases`,
+ * `TagVariables` or `Topics`. Upstream nonetheless reserves fixed NodeIds for
+ * those instances, so where one exists it is used in preference to a
+ * server-assigned id; an aggregating Server then sees the NodeId it expects.
+ */
+function ensureOptionalMethod(addressSpace, category, name) {
+    const declarationId = well_known_js_1.MethodDeclarations[name];
+    const existing = findMethodByDeclaration(category, declarationId, name);
+    if (existing) {
+        return existing;
+    }
+    const declaration = addressSpace.findNode(declarationId);
+    if (!declaration || declaration.nodeClass !== node_opcua_data_model_1.NodeClass.Method) {
+        // an address space whose nodeset predates the optional Methods
+        return null;
+    }
+    const reservedNodeId = reservedMethodNodeId(category.nodeId, name);
+    // a reserved id already taken by something else means the address space is
+    // not what we think it is; fall back to a server-assigned id rather than
+    // colliding
+    const nodeId = reservedNodeId && !addressSpace.findNode(reservedNodeId) ? reservedNodeId : undefined;
+    return declaration.clone({
+        namespace: addressSpace.getNamespace(category.nodeId.namespace),
+        nodeId,
+        componentOf: category,
+        methodDeclarationId: declarationId
+    });
+}
+/** The NodeId OPC 10000-17 reserves for an optional Method on a well-known category. */
+function reservedMethodNodeId(categoryNodeId, name) {
+    for (const [key, wellKnownId] of Object.entries(well_known_js_1.WellKnownCategories)) {
+        if (wellKnownId.value === categoryNodeId.value && wellKnownId.namespace === categoryNodeId.namespace) {
+            return well_known_js_1.WellKnownOptionalMethods[key][name];
+        }
+    }
+    return undefined;
+}
+/**
+ * Marks an address space as already carrying AliasName bindings, so a second
+ * `installAliasNames` is a no-op rather than a double binding.
+ */
+exports.INSTALLED = Symbol.for("node-opcua-alias-name-server.installed");
+/**
+ * What `installAliasNames` recorded on this address space, or undefined if it
+ * has not run.
+ *
+ * Exposed so a caller can rebind a late category with exactly the options
+ * installation used, without having to keep the install result around.
+ */
+function getInstalledAliasNames(addressSpace) {
+    return addressSpace[exports.INSTALLED];
+}
+/** Record the installation on the address space. */
+function setInstalledAliasNames(addressSpace, value) {
+    addressSpace[exports.INSTALLED] = value;
+}
+//# sourceMappingURL=bind_alias_category.js.map

package/dist/bind_alias_category.js.map

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

package/dist/bind_configuration_methods.d.ts

@@ -0,0 +1,44 @@
+/**
+ * @module node-opcua-alias-name-server
+ *
+ * `AddAliasesToCategory` (clause 6.3.4) and `DeleteAliasesFromCategory`
+ * (clause 6.3.5) — the *AliasName Configuration Support* facet, CU 5874.
+ *
+ * Both report **per item**: the Method itself succeeds and an `ErrorCodes` array
+ * parallel to `AliasNames` says what happened to each one. A single bad entry
+ * does not fail the call, which is why the store interface returns
+ * `StatusCode[]` rather than throwing.
+ */
+import type { ISessionContext, UAMethod } from "node-opcua-address-space-base";
+import type { IAliasStore } from "node-opcua-alias-name-common";
+import { type NodeId } from "node-opcua-nodeid";
+import type { CallMethodResultOptions } from "node-opcua-service-call";
+import { type Variant } from "node-opcua-variant";
+export interface ConfigurationBindingOptions {
+    /** The store that performs the mutation. Must implement `add` / `delete`. */
+    store: IAliasStore;
+    /**
+     * Write gate (clause 6.3.4 Table 11 / 6.3.5 Table 15). **Defaults to denying
+     * everyone** — the write surface is the one place a permissive default would
+     * be a security defect rather than a convenience.
+     */
+    isWriteAllowed?: (context: ISessionContext, categoryNodeId: NodeId) => boolean | Promise<boolean>;
+    /** Called after a successful mutation so `LastChange` can move. */
+    onChanged?: (categoryNodeId: NodeId) => void | Promise<void>;
+}
+/**
+ * Handler for `AddAliasesToCategory` (clause 6.3.4).
+ *
+ * Table 11 governs the *call*: `Bad_InvalidArgument` when an argument is the
+ * wrong type, when the arrays other than `TargetServers` differ in length, or
+ * when all arrays are empty. Table 10 governs each *item*.
+ */
+export declare function makeAddAliasesToCategoryHandler(options: ConfigurationBindingOptions): (this: UAMethod, inputArguments: Variant[], context: ISessionContext) => Promise<CallMethodResultOptions>;
+/**
+ * Handler for `DeleteAliasesFromCategory` (clause 6.3.5).
+ *
+ * Table 15 governs the call: unlike Add, **every** array must be the same
+ * length — "the size of the arrays for all arguments is not the same", with no
+ * exception, because there is no `TargetServers` here.
+ */
+export declare function makeDeleteAliasesFromCategoryHandler(options: ConfigurationBindingOptions): (this: UAMethod, inputArguments: Variant[], context: ISessionContext) => Promise<CallMethodResultOptions>;

package/dist/bind_configuration_methods.js

@@ -0,0 +1,175 @@
+"use strict";
+/**
+ * @module node-opcua-alias-name-server
+ *
+ * `AddAliasesToCategory` (clause 6.3.4) and `DeleteAliasesFromCategory`
+ * (clause 6.3.5) — the *AliasName Configuration Support* facet, CU 5874.
+ *
+ * Both report **per item**: the Method itself succeeds and an `ErrorCodes` array
+ * parallel to `AliasNames` says what happened to each one. A single bad entry
+ * does not fail the call, which is why the store interface returns
+ * `StatusCode[]` rather than throwing.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.makeAddAliasesToCategoryHandler = makeAddAliasesToCategoryHandler;
+exports.makeDeleteAliasesFromCategoryHandler = makeDeleteAliasesFromCategoryHandler;
+const node_opcua_nodeid_1 = require("node-opcua-nodeid");
+const node_opcua_status_code_1 = require("node-opcua-status-code");
+const node_opcua_variant_1 = require("node-opcua-variant");
+const well_known_js_1 = require("./well_known.js");
+/** Read a String[] argument, tolerating null for "empty". */
+function readStringArray(inputArguments, index) {
+    const value = inputArguments?.[index]?.value;
+    if (value === null || value === undefined) {
+        return [];
+    }
+    if (!Array.isArray(value)) {
+        return null;
+    }
+    return value.map((v) => (typeof v === "string" ? v : String(v)));
+}
+/** Read an ExpandedNodeId[] argument, tolerating null for "empty". */
+function readNodeIdArray(inputArguments, index) {
+    const value = inputArguments?.[index]?.value;
+    if (value === null || value === undefined) {
+        return [];
+    }
+    if (!Array.isArray(value)) {
+        return null;
+    }
+    return value;
+}
+/** Build the OutputArguments Variant for an ErrorCodes array. */
+function errorCodesResult(codes) {
+    return {
+        statusCode: node_opcua_status_code_1.StatusCodes.Good,
+        outputArguments: [
+            {
+                dataType: node_opcua_variant_1.DataType.StatusCode,
+                arrayType: node_opcua_variant_1.VariantArrayType.Array,
+                value: codes
+            }
+        ]
+    };
+}
+/**
+ * Handler for `AddAliasesToCategory` (clause 6.3.4).
+ *
+ * Table 11 governs the *call*: `Bad_InvalidArgument` when an argument is the
+ * wrong type, when the arrays other than `TargetServers` differ in length, or
+ * when all arrays are empty. Table 10 governs each *item*.
+ */
+function makeAddAliasesToCategoryHandler(options) {
+    return async function addAliasesToCategoryHandler(inputArguments, context) {
+        const category = this.parent;
+        if (!category) {
+            return { statusCode: node_opcua_status_code_1.StatusCodes.BadInternalError };
+        }
+        // clause 6.3.4 Table 11
+        if (!(await isWriteAllowed(options, context, category.nodeId))) {
+            return { statusCode: node_opcua_status_code_1.StatusCodes.BadUserAccessDenied };
+        }
+        const aliasNames = readStringArray(inputArguments, 0);
+        const targetNodes = readNodeIdArray(inputArguments, 1);
+        const targetServers = readStringArray(inputArguments, 2);
+        const targetReferenceTypeRaw = inputArguments?.[3]?.value;
+        if (aliasNames === null || targetNodes === null || targetServers === null) {
+            return { statusCode: node_opcua_status_code_1.StatusCodes.BadInvalidArgument };
+        }
+        // "the size of the arrays for all arguments except TargetServers is not
+        // the same" - TargetServers is excluded because Table 9 lets it be null
+        // or empty to mean "all local"
+        if (aliasNames.length !== targetNodes.length) {
+            return { statusCode: node_opcua_status_code_1.StatusCodes.BadInvalidArgument };
+        }
+        // "or if all arrays are empty"
+        if (aliasNames.length === 0) {
+            return { statusCode: node_opcua_status_code_1.StatusCodes.BadInvalidArgument };
+        }
+        if (targetServers.length !== 0 && targetServers.length !== aliasNames.length) {
+            return { statusCode: node_opcua_status_code_1.StatusCodes.BadInvalidArgument };
+        }
+        // Table 9: "If null, it defaults to AliasFor."
+        const referenceTypeId = targetReferenceTypeRaw instanceof node_opcua_nodeid_1.NodeId && !targetReferenceTypeRaw.isEmpty() ? targetReferenceTypeRaw : well_known_js_1.ALIAS_FOR;
+        const entries = aliasNames.map((aliasName, i) => {
+            // Table 9: "The ServerIndex in the ExpandedNodeId shall be ignored
+            // and the TargetServers Uri shall be used."
+            const serverUri = targetServers[i] ? targetServers[i] : null;
+            return {
+                aliasName,
+                referencedNodes: [targetNodes[i]],
+                serverUris: [serverUri],
+                categoryNodeId: category.nodeId,
+                referenceTypeIds: [referenceTypeId]
+            };
+        });
+        if (!options.store.add) {
+            // a read-only store: every item is unsupported, but the call itself
+            // succeeded in reporting that
+            return errorCodesResult(entries.map(() => node_opcua_status_code_1.StatusCodes.BadNotSupported));
+        }
+        const codes = await options.store.add(category.nodeId, entries);
+        if (codes.some((code) => code.isGood())) {
+            await options.onChanged?.(category.nodeId);
+        }
+        return errorCodesResult(codes);
+    };
+}
+/**
+ * Handler for `DeleteAliasesFromCategory` (clause 6.3.5).
+ *
+ * Table 15 governs the call: unlike Add, **every** array must be the same
+ * length — "the size of the arrays for all arguments is not the same", with no
+ * exception, because there is no `TargetServers` here.
+ */
+function makeDeleteAliasesFromCategoryHandler(options) {
+    return async function deleteAliasesFromCategoryHandler(inputArguments, context) {
+        const category = this.parent;
+        if (!category) {
+            return { statusCode: node_opcua_status_code_1.StatusCodes.BadInternalError };
+        }
+        if (!(await isWriteAllowed(options, context, category.nodeId))) {
+            return { statusCode: node_opcua_status_code_1.StatusCodes.BadUserAccessDenied };
+        }
+        const aliasNames = readStringArray(inputArguments, 0);
+        const targetNodes = readNodeIdArray(inputArguments, 1);
+        if (aliasNames === null || targetNodes === null) {
+            return { statusCode: node_opcua_status_code_1.StatusCodes.BadInvalidArgument };
+        }
+        if (aliasNames.length === 0) {
+            return { statusCode: node_opcua_status_code_1.StatusCodes.BadInvalidArgument };
+        }
+        // Table 13: "The length of each of the arrays shall be the same." A null
+        // TargetNodes array is the documented way to say "every target", so an
+        // empty array is accepted and expanded.
+        if (targetNodes.length !== 0 && targetNodes.length !== aliasNames.length) {
+            return { statusCode: node_opcua_status_code_1.StatusCodes.BadInvalidArgument };
+        }
+        const entries = aliasNames.map((aliasName, i) => {
+            // "If the TargetNodes array entry is null or empty, all AliasNames
+            // with the provided name are deleted from the AliasNameCategory."
+            const target = targetNodes[i];
+            const referencedNodes = target && !target.isEmpty() ? [target] : [];
+            return { aliasName, referencedNodes };
+        });
+        if (!options.store.delete) {
+            return errorCodesResult(entries.map(() => node_opcua_status_code_1.StatusCodes.BadNotSupported));
+        }
+        const codes = await options.store.delete(category.nodeId, entries);
+        if (codes.some((code) => code.isGood())) {
+            await options.onChanged?.(category.nodeId);
+        }
+        return errorCodesResult(codes);
+    };
+}
+/** The write gate, defaulting to deny. */
+async function isWriteAllowed(options, context, categoryNodeId) {
+    if (!options.isWriteAllowed) {
+        // Writing is off unless the Server says who may do it. OPC 10000-17
+        // defines no security model at all, so there is no safe default rule to
+        // fall back on - only a safe default answer.
+        return false;
+    }
+    return await options.isWriteAllowed(context, categoryNodeId);
+}
+//# sourceMappingURL=bind_configuration_methods.js.map

package/dist/bind_configuration_methods.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bind_configuration_methods.js","sourceRoot":"","sources":["../source/bind_configuration_methods.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;AAoEH,0EAmEC;AASD,oFAiDC;AA7LD,yDAA4F;AAE5F,mEAAsE;AACtE,2DAA8E;AAC9E,mDAA4C;AAe5C,6DAA6D;AAC7D,SAAS,eAAe,CAAC,cAAyB,EAAE,KAAa;IAC7D,MAAM,KAAK,GAAG,cAAc,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC;IAC7C,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxC,OAAO,EAAE,CAAC;IACd,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,IAAI,CAAC;IAChB,CAAC;IACD,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACrE,CAAC;AAED,sEAAsE;AACtE,SAAS,eAAe,CAAC,cAAyB,EAAE,KAAa;IAC7D,MAAM,KAAK,GAAG,cAAc,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC;IAC7C,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxC,OAAO,EAAE,CAAC;IACd,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,IAAI,CAAC;IAChB,CAAC;IACD,OAAO,KAAyB,CAAC;AACrC,CAAC;AAED,iEAAiE;AACjE,SAAS,gBAAgB,CAAC,KAAmB;IACzC,OAAO;QACH,UAAU,EAAE,oCAAW,CAAC,IAAI;QAC5B,eAAe,EAAE;YACb;gBACI,QAAQ,EAAE,6BAAQ,CAAC,UAAU;gBAC7B,SAAS,EAAE,qCAAgB,CAAC,KAAK;gBACjC,KAAK,EAAE,KAAK;aACf;SACJ;KACJ,CAAC;AACN,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,+BAA+B,CAAC,OAAoC;IAChF,OAAO,KAAK,UAAU,2BAA2B,CAE7C,cAAyB,EACzB,OAAwB;QAExB,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAyB,CAAC;QAChD,IAAI,CAAC,QAAQ,EAAE,CAAC;YACZ,OAAO,EAAE,UAAU,EAAE,oCAAW,CAAC,gBAAgB,EAAE,CAAC;QACxD,CAAC;QAED,wBAAwB;QACxB,IAAI,CAAC,CAAC,MAAM,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;YAC7D,OAAO,EAAE,UAAU,EAAE,oCAAW,CAAC,mBAAmB,EAAE,CAAC;QAC3D,CAAC;QAED,MAAM,UAAU,GAAG,eAAe,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC;QACtD,MAAM,WAAW,GAAG,eAAe,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC;QACvD,MAAM,aAAa,GAAG,eAAe,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC;QACzD,MAAM,sBAAsB,GAAG,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC;QAE1D,IAAI,UAAU,KAAK,IAAI,IAAI,WAAW,KAAK,IAAI,IAAI,aAAa,KAAK,IAAI,EAAE,CAAC;YACxE,OAAO,EAAE,UAAU,EAAE,oCAAW,CAAC,kBAAkB,EAAE,CAAC;QAC1D,CAAC;QACD,wEAAwE;QACxE,wEAAwE;QACxE,+BAA+B;QAC/B,IAAI,UAAU,CAAC,MAAM,KAAK,WAAW,CAAC,MAAM,EAAE,CAAC;YAC3C,OAAO,EAAE,UAAU,EAAE,oCAAW,CAAC,kBAAkB,EAAE,CAAC;QAC1D,CAAC;QACD,+BAA+B;QAC/B,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1B,OAAO,EAAE,UAAU,EAAE,oCAAW,CAAC,kBAAkB,EAAE,CAAC;QAC1D,CAAC;QACD,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,IAAI,aAAa,CAAC,MAAM,KAAK,UAAU,CAAC,MAAM,EAAE,CAAC;YAC3E,OAAO,EAAE,UAAU,EAAE,oCAAW,CAAC,kBAAkB,EAAE,CAAC;QAC1D,CAAC;QAED,+CAA+C;QAC/C,MAAM,eAAe,GACjB,sBAAsB,YAAY,0BAAW,IAAI,CAAC,sBAAsB,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,yBAAS,CAAC;QAE5H,MAAM,OAAO,GAAiB,UAAU,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,CAAC,EAAE,EAAE;YAC1D,mEAAmE;YACnE,4CAA4C;YAC5C,MAAM,SAAS,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;YAC7D,OAAO;gBACH,SAAS;gBACT,eAAe,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;gBACjC,UAAU,EAAE,CAAC,SAAS,CAAC;gBACvB,cAAc,EAAE,QAAQ,CAAC,MAAM;gBAC/B,gBAAgB,EAAE,CAAC,eAAe,CAAC;aACtC,CAAC;QACN,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;YACrB,oEAAoE;YACpE,8BAA8B;YAC9B,OAAO,gBAAgB,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,oCAAW,CAAC,eAAe,CAAC,CAAC,CAAC;QAC5E,CAAC;QAED,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAChE,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC;YACtC,MAAM,OAAO,CAAC,SAAS,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QAC/C,CAAC;QACD,OAAO,gBAAgB,CAAC,KAAK,CAAC,CAAC;IACnC,CAAC,CAAC;AACN,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,oCAAoC,CAAC,OAAoC;IACrF,OAAO,KAAK,UAAU,gCAAgC,CAElD,cAAyB,EACzB,OAAwB;QAExB,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAyB,CAAC;QAChD,IAAI,CAAC,QAAQ,EAAE,CAAC;YACZ,OAAO,EAAE,UAAU,EAAE,oCAAW,CAAC,gBAAgB,EAAE,CAAC;QACxD,CAAC;QAED,IAAI,CAAC,CAAC,MAAM,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;YAC7D,OAAO,EAAE,UAAU,EAAE,oCAAW,CAAC,mBAAmB,EAAE,CAAC;QAC3D,CAAC;QAED,MAAM,UAAU,GAAG,eAAe,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC;QACtD,MAAM,WAAW,GAAG,eAAe,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC;QAEvD,IAAI,UAAU,KAAK,IAAI,IAAI,WAAW,KAAK,IAAI,EAAE,CAAC;YAC9C,OAAO,EAAE,UAAU,EAAE,oCAAW,CAAC,kBAAkB,EAAE,CAAC;QAC1D,CAAC;QACD,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1B,OAAO,EAAE,UAAU,EAAE,oCAAW,CAAC,kBAAkB,EAAE,CAAC;QAC1D,CAAC;QACD,yEAAyE;QACzE,uEAAuE;QACvE,wCAAwC;QACxC,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,IAAI,WAAW,CAAC,MAAM,KAAK,UAAU,CAAC,MAAM,EAAE,CAAC;YACvE,OAAO,EAAE,UAAU,EAAE,oCAAW,CAAC,kBAAkB,EAAE,CAAC;QAC1D,CAAC;QAED,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,CAAC,EAAE,EAAE;YAC5C,mEAAmE;YACnE,kEAAkE;YAClE,MAAM,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;YAC9B,MAAM,eAAe,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACpE,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,CAAC;QAC1C,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;YACxB,OAAO,gBAAgB,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,oCAAW,CAAC,eAAe,CAAC,CAAC,CAAC;QAC5E,CAAC;QAED,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACnE,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC;YACtC,MAAM,OAAO,CAAC,SAAS,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QAC/C,CAAC;QACD,OAAO,gBAAgB,CAAC,KAAK,CAAC,CAAC;IACnC,CAAC,CAAC;AACN,CAAC;AAED,0CAA0C;AAC1C,KAAK,UAAU,cAAc,CACzB,OAAoC,EACpC,OAAwB,EACxB,cAAsB;IAEtB,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,CAAC;QAC1B,oEAAoE;QACpE,wEAAwE;QACxE,6CAA6C;QAC7C,OAAO,KAAK,CAAC;IACjB,CAAC;IACD,OAAO,MAAM,OAAO,CAAC,cAAc,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;AACjE,CAAC"}