node-opcua-alias-name-server 2.176.0

package/dist/install_alias_names.js

@@ -0,0 +1,146 @@
+"use strict";
+/**
+ * @module node-opcua-alias-name-server
+ *
+ * Install OPC 10000-17 AliasName support on a Server.
+ *
+ * Every node-opcua Server that loads the standard nodeset already exposes
+ * `Aliases`, `TagVariables` and `Topics`, each carrying a MANDATORY `FindAlias`
+ * Method that is bound to nothing. A conformance tester therefore sees the SDK
+ * advertise the AliasName feature and then fail its only required Method. This
+ * binds them.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ALIAS_SERVER_CAPABILITY_ID = exports.DEFAULT_MAX_RESULTS = void 0;
+exports.defaultCategoryProvider = defaultCategoryProvider;
+exports.advertiseAliasCapability = advertiseAliasCapability;
+exports.installAliasNames = installAliasNames;
+exports.installAliasNamesOnAddressSpace = installAliasNamesOnAddressSpace;
+const address_space_alias_store_js_1 = require("./address_space_alias_store.js");
+const alias_hierarchy_js_1 = require("./alias_hierarchy.js");
+const bind_alias_category_js_1 = require("./bind_alias_category.js");
+const last_change_js_1 = require("./last_change.js");
+const well_known_js_1 = require("./well_known.js");
+Object.defineProperty(exports, "DEFAULT_MAX_RESULTS", { enumerable: true, get: function () { return well_known_js_1.DEFAULT_MAX_RESULTS; } });
+/**
+ * The default provider: every `AliasNameCategoryType` instance at or below
+ * `Aliases`, plus any roots named in `additionalCategoryRoots`.
+ *
+ * `additionalCategoryRoots` is expressed through this rather than as a parallel
+ * mechanism, so a custom provider can reuse it — `defaultCategoryProvider(roots)`
+ * composes with whatever else the Server knows about.
+ */
+function defaultCategoryProvider(additionalRoots) {
+    return (addressSpace) => (0, alias_hierarchy_js_1.collectAllCategories)(addressSpace, additionalRoots);
+}
+/**
+ * The `ALIAS` ServerCapability identifier (OPC 10000-12 Annex D Table D.1).
+ *
+ * Part 17's prose writes it `Alias`; Part 12 Annex D is the normative source and
+ * writes `ALIAS`, matched case-insensitively.
+ */
+exports.ALIAS_SERVER_CAPABILITY_ID = "ALIAS";
+/** The placeholder node-opcua uses for "no capabilities declared". */
+const NO_CAPABILITY_PLACEHOLDER = "NA";
+/**
+ * Add `ALIAS` to a Server's Annex D capability list, in place.
+ *
+ * Idempotent, case-insensitive, and replaces the `NA` placeholder rather than
+ * producing the meaningless `["NA", "ALIAS"]`.
+ *
+ * @returns true when the list was changed.
+ */
+function advertiseAliasCapability(capabilities) {
+    if (capabilities.some((c) => c.toUpperCase() === exports.ALIAS_SERVER_CAPABILITY_ID)) {
+        return false;
+    }
+    // "NA" means "none"; it cannot coexist with a real capability
+    const placeholderIndex = capabilities.findIndex((c) => c.toUpperCase() === NO_CAPABILITY_PLACEHOLDER);
+    if (placeholderIndex >= 0) {
+        capabilities.splice(placeholderIndex, 1);
+    }
+    capabilities.push(exports.ALIAS_SERVER_CAPABILITY_ID);
+    return true;
+}
+/**
+ * Install AliasName support on a Server.
+ *
+ * Call it **between `initialize()` and `start()`**: the address space exists
+ * from `initialize()`, and the `ALIAS` capability has to be in place before
+ * `start()` performs the mDNS/LDS registration that reads it.
+ *
+ * ```ts
+ * await server.initialize();
+ * await installAliasNames(server);
+ * await server.start();
+ * ```
+ */
+async function installAliasNames(server, options) {
+    const addressSpace = server.engine.addressSpace;
+    if (!addressSpace) {
+        throw new Error("installAliasNames: address space is not available. Call this after server.initialize().");
+    }
+    const result = await installAliasNamesOnAddressSpace(addressSpace, options);
+    // Declaring the capability is part of installing the feature, not a separate
+    // thing to remember: a Server that omits it is never discovered, silently.
+    if ((options?.advertiseCapability ?? true) && server.capabilitiesForMDNS) {
+        advertiseAliasCapability(server.capabilitiesForMDNS);
+    }
+    return result;
+}
+/**
+ * Install AliasName support directly on an address space.
+ *
+ * The two-tier form used elsewhere in the SDK: this one needs no Server, so it
+ * can be driven from a test or from a tool that only has an address space.
+ */
+async function installAliasNamesOnAddressSpace(addressSpace, options) {
+    const already = (0, bind_alias_category_js_1.getInstalledAliasNames)(addressSpace);
+    if (already) {
+        return { ...already, installed: false };
+    }
+    const aliasesRoot = addressSpace.findNode(well_known_js_1.WellKnownCategories.Aliases);
+    if (!aliasesRoot) {
+        throw new Error("installAliasNames: the Aliases Object (i=23470) is not in the address space. " +
+            "Load the standard nodeset (Opc.Ua.NodeSet2.xml) first.");
+    }
+    const store = options?.store ?? new address_space_alias_store_js_1.AddressSpaceAliasStore(addressSpace, { likeOptions: options?.likeOptions });
+    const lastChange = new last_change_js_1.LastChangeTracker(addressSpace, {
+        persistencePath: options?.persistencePath,
+        now: options?.nowVersionTime
+    });
+    const bindingOptions = {
+        store,
+        maxResults: options?.maxResults ?? well_known_js_1.DEFAULT_MAX_RESULTS,
+        verbose: options?.verbose ?? true,
+        comparator: options?.comparator,
+        isReadAllowed: options?.isReadAllowed,
+        isWriteAllowed: options?.isWriteAllowed,
+        lastChangeProperty: options?.lastChangeOnAllCategories ?? true,
+        configurationMethods: options?.configurationMethods ?? false,
+        onChanged: (categoryNodeId) => lastChange.touch(categoryNodeId).then(() => undefined)
+    };
+    const provider = options?.categoryProvider ?? defaultCategoryProvider(options?.additionalCategoryRoots);
+    const categories = await provider(addressSpace);
+    // one binding path, shared with bindAliasCategory, so a category created
+    // after installation cannot end up bound differently
+    for (const category of categories) {
+        (0, bind_alias_category_js_1.bindAliasCategory)(addressSpace, category, bindingOptions);
+    }
+    const installed = {
+        store,
+        categories: categories.map((c) => c.nodeId),
+        bindingOptions,
+        lastChange
+    };
+    // Recorded before restore, so anything the restore triggers can already find
+    // the tracker on the address space.
+    (0, bind_alias_category_js_1.setInstalledAliasNames)(addressSpace, installed);
+    // Bring persisted values back and publish them, including the zeros for
+    // categories that have never changed - a Property with no value at all reads
+    // as Bad_WaitingForInitialData rather than "nothing has happened yet".
+    await lastChange.restore();
+    lastChange.publishAll(installed.categories);
+    return { ...installed, installed: true };
+}
+//# sourceMappingURL=install_alias_names.js.map

package/dist/install_alias_names.js.map

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

package/dist/last_change.d.ts

@@ -0,0 +1,87 @@
+/**
+ * @module node-opcua-alias-name-server
+ *
+ * `LastChange` (OPC 10000-17 clause 6.3.1).
+ *
+ * A `VersionTime` — **a UInt32 count of seconds since 2000-01-01T00:00:00Z, not
+ * a DateTime**. Every other "last changed" Property in the SDK is a DateTime and
+ * the name gives no hint, which is what makes this the easiest thing here to get
+ * wrong.
+ *
+ * Clause 6.3.1 lists three things that move it:
+ *
+ * - an AliasName was added to or deleted from the category,
+ * - an AliasNameCategory was added or deleted,
+ * - the referenced Nodes of an AliasName in the category changed.
+ *
+ * and one rule that makes it a tree rather than a set of independent counters:
+ * *"For AliasNameCategoryType instances that are nested, the value of LastChange
+ * shall always be the latest VersionTime of all Organized AliasNames and
+ * AliasNameCategories."* So a change deep in the hierarchy moves every ancestor
+ * up to the root.
+ *
+ * ## One second of resolution
+ *
+ * Two changes inside the same second are indistinguishable — the value simply
+ * does not move. A Client must therefore treat an **equal** `LastChange` as
+ * "re-browse to be sure" rather than "nothing changed"; only a value *older*
+ * than the cached one carries the strong meaning clause 6.3.1 gives it, namely
+ * clear the cache. This is a property of `VersionTime`, not of this
+ * implementation, and there is nothing a Server can do about it.
+ */
+import type { IAddressSpace } from "node-opcua-address-space-base";
+import type { NodeId } from "node-opcua-nodeid";
+/** BrowseName of the Property, per clause 6.3.1 Table 2. */
+export declare const LAST_CHANGE_BROWSE_NAME = "LastChange";
+export interface LastChangeTrackerOptions {
+    /** File backing the persisted values. Omit to keep them in memory only. */
+    persistencePath?: string;
+    /**
+     * Supplies "now" as a VersionTime. Injectable so a test can pin it; a
+     * one-second resolution is otherwise painful to assert against.
+     */
+    now?: () => number;
+}
+/**
+ * Keeps every category's `LastChange` Property correct, including the rollup to
+ * ancestors, and persists the values across restart.
+ */
+export declare class LastChangeTracker {
+    private readonly addressSpace;
+    private readonly persistencePath?;
+    private readonly now;
+    /** Category NodeId string to VersionTime. */
+    private readonly values;
+    /** Serialises saves so two rapid changes cannot interleave their writes. */
+    private savingChain;
+    constructor(addressSpace: IAddressSpace, options?: LastChangeTrackerOptions);
+    /** The `VersionTime` currently recorded for a category. */
+    get(categoryNodeId: NodeId): number;
+    /**
+     * Record that a category changed, and roll the change up to every ancestor.
+     *
+     * Ancestors are walked at write time rather than computed at read time, so
+     * the Property a Client subscribes to actually carries the value — a
+     * rollup that existed only inside the Server would be invisible on the
+     * wire, which is the whole point of the Property.
+     */
+    touch(categoryNodeId: NodeId, versionTime?: number): Promise<number>;
+    /** Restore persisted values and publish them to the address space. */
+    restore(): Promise<void>;
+    /** Publish the current value of every known category, including zeros. */
+    publishAll(categoryNodeIds: NodeId[]): void;
+    /** Snapshot for persistence or inspection. */
+    snapshot(): Record<string, number>;
+    /** Persist, if a path was given. Saves are serialised, never concurrent. */
+    save(): Promise<void>;
+    /** Write the value onto the category's `LastChange` Property, if it has one. */
+    private writeProperty;
+    /**
+     * The category itself, then every `AliasNameCategoryType` ancestor up to and
+     * including the `Aliases` root.
+     *
+     * Cycle-safe: an address space that nests categories in a loop would
+     * otherwise hang the Method call that triggered the change.
+     */
+    private selfAndAncestors;
+}

package/dist/last_change.js

@@ -0,0 +1,174 @@
+"use strict";
+/**
+ * @module node-opcua-alias-name-server
+ *
+ * `LastChange` (OPC 10000-17 clause 6.3.1).
+ *
+ * A `VersionTime` — **a UInt32 count of seconds since 2000-01-01T00:00:00Z, not
+ * a DateTime**. Every other "last changed" Property in the SDK is a DateTime and
+ * the name gives no hint, which is what makes this the easiest thing here to get
+ * wrong.
+ *
+ * Clause 6.3.1 lists three things that move it:
+ *
+ * - an AliasName was added to or deleted from the category,
+ * - an AliasNameCategory was added or deleted,
+ * - the referenced Nodes of an AliasName in the category changed.
+ *
+ * and one rule that makes it a tree rather than a set of independent counters:
+ * *"For AliasNameCategoryType instances that are nested, the value of LastChange
+ * shall always be the latest VersionTime of all Organized AliasNames and
+ * AliasNameCategories."* So a change deep in the hierarchy moves every ancestor
+ * up to the root.
+ *
+ * ## One second of resolution
+ *
+ * Two changes inside the same second are indistinguishable — the value simply
+ * does not move. A Client must therefore treat an **equal** `LastChange` as
+ * "re-browse to be sure" rather than "nothing changed"; only a value *older*
+ * than the cached one carries the strong meaning clause 6.3.1 gives it, namely
+ * clear the cache. This is a property of `VersionTime`, not of this
+ * implementation, and there is nothing a Server can do about it.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LastChangeTracker = exports.LAST_CHANGE_BROWSE_NAME = void 0;
+const node_opcua_alias_name_common_1 = require("node-opcua-alias-name-common");
+const node_opcua_data_model_1 = require("node-opcua-data-model");
+const node_opcua_variant_1 = require("node-opcua-variant");
+const alias_name_archive_js_1 = require("./alias_name_archive.js");
+const well_known_js_1 = require("./well_known.js");
+/** BrowseName of the Property, per clause 6.3.1 Table 2. */
+exports.LAST_CHANGE_BROWSE_NAME = "LastChange";
+/**
+ * Keeps every category's `LastChange` Property correct, including the rollup to
+ * ancestors, and persists the values across restart.
+ */
+class LastChangeTracker {
+    addressSpace;
+    persistencePath;
+    now;
+    /** Category NodeId string to VersionTime. */
+    values = new Map();
+    /** Serialises saves so two rapid changes cannot interleave their writes. */
+    savingChain = Promise.resolve();
+    constructor(addressSpace, options) {
+        this.addressSpace = addressSpace;
+        this.persistencePath = options?.persistencePath;
+        this.now = options?.now ?? node_opcua_alias_name_common_1.nowVersionTime;
+    }
+    /** The `VersionTime` currently recorded for a category. */
+    get(categoryNodeId) {
+        return this.values.get(categoryNodeId.toString()) ?? 0;
+    }
+    /**
+     * Record that a category changed, and roll the change up to every ancestor.
+     *
+     * Ancestors are walked at write time rather than computed at read time, so
+     * the Property a Client subscribes to actually carries the value — a
+     * rollup that existed only inside the Server would be invisible on the
+     * wire, which is the whole point of the Property.
+     */
+    async touch(categoryNodeId, versionTime) {
+        const value = versionTime ?? this.now();
+        for (const nodeId of this.selfAndAncestors(categoryNodeId)) {
+            const key = nodeId.toString();
+            this.values.set(key, (0, node_opcua_alias_name_common_1.maxVersionTime)(this.values.get(key) ?? 0, value));
+            this.writeProperty(nodeId);
+        }
+        await this.save();
+        return value;
+    }
+    /** Restore persisted values and publish them to the address space. */
+    async restore() {
+        if (this.persistencePath) {
+            const archive = await (0, alias_name_archive_js_1.readAliasNameArchive)(this.persistencePath);
+            if (archive) {
+                for (const [key, value] of Object.entries(archive.lastChange)) {
+                    this.values.set(key, value);
+                }
+            }
+        }
+        for (const key of this.values.keys()) {
+            const node = this.addressSpace.findNode(key);
+            if (node) {
+                this.writeProperty(node.nodeId);
+            }
+        }
+    }
+    /** Publish the current value of every known category, including zeros. */
+    publishAll(categoryNodeIds) {
+        for (const nodeId of categoryNodeIds) {
+            this.writeProperty(nodeId);
+        }
+    }
+    /** Snapshot for persistence or inspection. */
+    snapshot() {
+        return Object.fromEntries(this.values.entries());
+    }
+    /** Persist, if a path was given. Saves are serialised, never concurrent. */
+    async save() {
+        if (!this.persistencePath) {
+            return;
+        }
+        const path = this.persistencePath;
+        const archive = { version: alias_name_archive_js_1.ALIAS_NAME_ARCHIVE_VERSION, lastChange: this.snapshot() };
+        this.savingChain = this.savingChain.then(() => (0, alias_name_archive_js_1.writeAliasNameArchive)(path, archive));
+        await this.savingChain;
+    }
+    /** Write the value onto the category's `LastChange` Property, if it has one. */
+    writeProperty(categoryNodeId) {
+        const node = this.addressSpace.findNode(categoryNodeId);
+        if (!node || node.nodeClass !== node_opcua_data_model_1.NodeClass.Object) {
+            return;
+        }
+        const property = node.getPropertyByName(exports.LAST_CHANGE_BROWSE_NAME);
+        if (!property) {
+            // LastChange is Optional on AliasNameCategoryType; a category
+            // without one simply does not publish its version
+            return;
+        }
+        // VersionTime (i=20998) is a UInt32 subtype - not a DateTime
+        property.setValueFromSource({
+            dataType: node_opcua_variant_1.DataType.UInt32,
+            value: this.values.get(categoryNodeId.toString()) ?? 0
+        });
+    }
+    /**
+     * The category itself, then every `AliasNameCategoryType` ancestor up to and
+     * including the `Aliases` root.
+     *
+     * Cycle-safe: an address space that nests categories in a loop would
+     * otherwise hang the Method call that triggered the change.
+     */
+    selfAndAncestors(categoryNodeId) {
+        const result = [];
+        const seen = new Set();
+        const visit = (nodeId) => {
+            const key = nodeId.toString();
+            if (seen.has(key)) {
+                return;
+            }
+            seen.add(key);
+            result.push(nodeId);
+            const node = this.addressSpace.findNode(nodeId);
+            if (!node) {
+                return;
+            }
+            for (const parent of node.findReferencesExAsObject("HierarchicalReferences", node_opcua_data_model_1.BrowseDirection.Inverse)) {
+                if (parent.nodeClass === node_opcua_data_model_1.NodeClass.Object) {
+                    visit(parent.nodeId);
+                }
+            }
+        };
+        visit(categoryNodeId);
+        // the root is always included even when the category was reached by a
+        // path that does not pass through it
+        const rootKey = well_known_js_1.WellKnownCategories.Aliases.toString();
+        if (!seen.has(rootKey) && this.addressSpace.findNode(well_known_js_1.WellKnownCategories.Aliases)) {
+            result.push(well_known_js_1.WellKnownCategories.Aliases);
+        }
+        return result;
+    }
+}
+exports.LastChangeTracker = LastChangeTracker;
+//# sourceMappingURL=last_change.js.map

package/dist/last_change.js.map

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

package/dist/well_known.d.ts

@@ -0,0 +1,88 @@
+/**
+ * @module node-opcua-alias-name-server
+ *
+ * The fixed NodeIds of OPC 10000-17.
+ *
+ * Every well-known instance is resolved **by NodeId**, never by walking
+ * BrowseNames. Clause 9.1 gives these Objects static NodeIds precisely so they
+ * can be found without browsing, and a BrowseName walk would break on a Server
+ * that publishes the hierarchy under a localised DisplayName or that has a
+ * vendor Object of the same BrowseName elsewhere.
+ */
+import { type NodeId } from "node-opcua-nodeid";
+/**
+ * Default result cap; beyond it a call answers `Bad_ResponseTooLarge`
+ * (clause 6.3.2 Table 4).
+ *
+ * Lives here rather than in `install_alias_names` so that `bind_alias_category`
+ * can use it without the two importing each other.
+ */
+export declare const DEFAULT_MAX_RESULTS = 1000;
+/** `AliasNameType` ObjectType (clause 6.2). */
+export declare const ALIAS_NAME_TYPE: NodeId;
+/** `AliasNameCategoryType` ObjectType (clause 6.3). */
+export declare const ALIAS_NAME_CATEGORY_TYPE: NodeId;
+/** `VersionTime` DataType (OPC 10000-4 clause 7.43) - a UInt32 subtype. */
+export declare const VERSION_TIME_DATA_TYPE: NodeId;
+/** `AliasFor` ReferenceType (clause 8.2); the default link to a target Node. */
+export declare const ALIAS_FOR: NodeId;
+/** `PublishedDataSetType` (OPC 10000-14), the target type `Topics` restricts to. */
+export declare const PUBLISHED_DATA_SET_TYPE: NodeId;
+/** The three well-known category instances of clauses 9.2, 9.3 and 9.4. */
+export declare const WellKnownCategories: {
+    /** `Aliases`, the root of the hierarchy (clause 9.2). */
+    readonly Aliases: NodeId;
+    /** `TagVariables`; targets restricted to Variables (clause 9.3). */
+    readonly TagVariables: NodeId;
+    /** `Topics`; targets restricted to PublishedDataSetType (clause 9.4). */
+    readonly Topics: NodeId;
+};
+/** `LastChange` on each well-known category (clause 6.3.1). */
+export declare const WellKnownLastChange: {
+    readonly Aliases: NodeId;
+    readonly TagVariables: NodeId;
+    readonly Topics: NodeId;
+};
+/** The Method declarations on `AliasNameCategoryType`. */
+export declare const MethodDeclarations: {
+    readonly FindAlias: NodeId;
+    readonly FindAliasVerbose: NodeId;
+    readonly AddAliasesToCategory: NodeId;
+    readonly DeleteAliasesFromCategory: NodeId;
+};
+/**
+ * The NodeIds OPC 10000-17 reserves for the *optional* Methods on the three
+ * well-known categories.
+ *
+ * The shipped `Opc.Ua.NodeSet2.xml` declares these Methods on
+ * `AliasNameCategoryType` but does not instantiate them on `Aliases`,
+ * `TagVariables` or `Topics` — yet upstream still assigns them fixed NodeIds.
+ * When installation adds them it uses these rather than server-assigned ones,
+ * so an aggregating Server sees the standard NodeId it expects.
+ */
+export declare const WellKnownOptionalMethods: {
+    readonly Aliases: {
+        readonly FindAliasVerbose: NodeId;
+        readonly AddAliasesToCategory: NodeId;
+        readonly DeleteAliasesFromCategory: NodeId;
+    };
+    readonly TagVariables: {
+        readonly FindAliasVerbose: NodeId;
+        readonly AddAliasesToCategory: NodeId;
+        readonly DeleteAliasesFromCategory: NodeId;
+    };
+    readonly Topics: {
+        readonly FindAliasVerbose: NodeId;
+        readonly AddAliasesToCategory: NodeId;
+        readonly DeleteAliasesFromCategory: NodeId;
+    };
+};
+/**
+ * The `ALIAS` ServerCapability identifier (OPC 10000-12 Annex D Table D.1).
+ *
+ * A Server that does not advertise this will never be found by anything looking
+ * for alias-capable Servers, and nothing reports that failure. Part 17's prose
+ * writes it `Alias`; Part 12 Annex D is the normative source and writes `ALIAS`,
+ * matched case-insensitively.
+ */
+export declare const ALIAS_SERVER_CAPABILITY = "ALIAS";

package/dist/well_known.js

@@ -0,0 +1,93 @@
+"use strict";
+/**
+ * @module node-opcua-alias-name-server
+ *
+ * The fixed NodeIds of OPC 10000-17.
+ *
+ * Every well-known instance is resolved **by NodeId**, never by walking
+ * BrowseNames. Clause 9.1 gives these Objects static NodeIds precisely so they
+ * can be found without browsing, and a BrowseName walk would break on a Server
+ * that publishes the hierarchy under a localised DisplayName or that has a
+ * vendor Object of the same BrowseName elsewhere.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ALIAS_SERVER_CAPABILITY = exports.WellKnownOptionalMethods = exports.MethodDeclarations = exports.WellKnownLastChange = exports.WellKnownCategories = exports.PUBLISHED_DATA_SET_TYPE = exports.ALIAS_FOR = exports.VERSION_TIME_DATA_TYPE = exports.ALIAS_NAME_CATEGORY_TYPE = exports.ALIAS_NAME_TYPE = exports.DEFAULT_MAX_RESULTS = void 0;
+const node_opcua_constants_1 = require("node-opcua-constants");
+const node_opcua_nodeid_1 = require("node-opcua-nodeid");
+/**
+ * Default result cap; beyond it a call answers `Bad_ResponseTooLarge`
+ * (clause 6.3.2 Table 4).
+ *
+ * Lives here rather than in `install_alias_names` so that `bind_alias_category`
+ * can use it without the two importing each other.
+ */
+exports.DEFAULT_MAX_RESULTS = 1000;
+/** `AliasNameType` ObjectType (clause 6.2). */
+exports.ALIAS_NAME_TYPE = (0, node_opcua_nodeid_1.resolveNodeId)(node_opcua_constants_1.ObjectTypeIds.AliasNameType);
+/** `AliasNameCategoryType` ObjectType (clause 6.3). */
+exports.ALIAS_NAME_CATEGORY_TYPE = (0, node_opcua_nodeid_1.resolveNodeId)(node_opcua_constants_1.ObjectTypeIds.AliasNameCategoryType);
+/** `VersionTime` DataType (OPC 10000-4 clause 7.43) - a UInt32 subtype. */
+exports.VERSION_TIME_DATA_TYPE = (0, node_opcua_nodeid_1.resolveNodeId)(node_opcua_constants_1.DataTypeIds.VersionTime);
+/** `AliasFor` ReferenceType (clause 8.2); the default link to a target Node. */
+exports.ALIAS_FOR = (0, node_opcua_nodeid_1.resolveNodeId)(node_opcua_constants_1.ReferenceTypeIds.AliasFor);
+/** `PublishedDataSetType` (OPC 10000-14), the target type `Topics` restricts to. */
+exports.PUBLISHED_DATA_SET_TYPE = (0, node_opcua_nodeid_1.resolveNodeId)(node_opcua_constants_1.ObjectTypeIds.PublishedDataSetType);
+/** The three well-known category instances of clauses 9.2, 9.3 and 9.4. */
+exports.WellKnownCategories = {
+    /** `Aliases`, the root of the hierarchy (clause 9.2). */
+    Aliases: (0, node_opcua_nodeid_1.resolveNodeId)(node_opcua_constants_1.ObjectIds.Aliases),
+    /** `TagVariables`; targets restricted to Variables (clause 9.3). */
+    TagVariables: (0, node_opcua_nodeid_1.resolveNodeId)(node_opcua_constants_1.ObjectIds.TagVariables),
+    /** `Topics`; targets restricted to PublishedDataSetType (clause 9.4). */
+    Topics: (0, node_opcua_nodeid_1.resolveNodeId)(node_opcua_constants_1.ObjectIds.Topics)
+};
+/** `LastChange` on each well-known category (clause 6.3.1). */
+exports.WellKnownLastChange = {
+    Aliases: (0, node_opcua_nodeid_1.resolveNodeId)(node_opcua_constants_1.VariableIds.Aliases_LastChange),
+    TagVariables: (0, node_opcua_nodeid_1.resolveNodeId)(node_opcua_constants_1.VariableIds.TagVariables_LastChange),
+    Topics: (0, node_opcua_nodeid_1.resolveNodeId)(node_opcua_constants_1.VariableIds.Topics_LastChange)
+};
+/** The Method declarations on `AliasNameCategoryType`. */
+exports.MethodDeclarations = {
+    FindAlias: (0, node_opcua_nodeid_1.resolveNodeId)(node_opcua_constants_1.MethodIds.AliasNameCategoryType_FindAlias),
+    FindAliasVerbose: (0, node_opcua_nodeid_1.resolveNodeId)(node_opcua_constants_1.MethodIds.AliasNameCategoryType_FindAliasVerbose),
+    AddAliasesToCategory: (0, node_opcua_nodeid_1.resolveNodeId)(node_opcua_constants_1.MethodIds.AliasNameCategoryType_AddAliasesToCategory),
+    DeleteAliasesFromCategory: (0, node_opcua_nodeid_1.resolveNodeId)(node_opcua_constants_1.MethodIds.AliasNameCategoryType_DeleteAliasesFromCategory)
+};
+/**
+ * The NodeIds OPC 10000-17 reserves for the *optional* Methods on the three
+ * well-known categories.
+ *
+ * The shipped `Opc.Ua.NodeSet2.xml` declares these Methods on
+ * `AliasNameCategoryType` but does not instantiate them on `Aliases`,
+ * `TagVariables` or `Topics` — yet upstream still assigns them fixed NodeIds.
+ * When installation adds them it uses these rather than server-assigned ones,
+ * so an aggregating Server sees the standard NodeId it expects.
+ */
+exports.WellKnownOptionalMethods = {
+    Aliases: {
+        FindAliasVerbose: (0, node_opcua_nodeid_1.resolveNodeId)(node_opcua_constants_1.MethodIds.Aliases_FindAliasVerbose),
+        AddAliasesToCategory: (0, node_opcua_nodeid_1.resolveNodeId)(node_opcua_constants_1.MethodIds.Aliases_AddAliasesToCategory),
+        DeleteAliasesFromCategory: (0, node_opcua_nodeid_1.resolveNodeId)(node_opcua_constants_1.MethodIds.Aliases_DeleteAliasesFromCategory)
+    },
+    TagVariables: {
+        FindAliasVerbose: (0, node_opcua_nodeid_1.resolveNodeId)(node_opcua_constants_1.MethodIds.TagVariables_FindAliasVerbose),
+        AddAliasesToCategory: (0, node_opcua_nodeid_1.resolveNodeId)(node_opcua_constants_1.MethodIds.TagVariables_AddAliasesToCategory),
+        DeleteAliasesFromCategory: (0, node_opcua_nodeid_1.resolveNodeId)(node_opcua_constants_1.MethodIds.TagVariables_DeleteAliasesFromCategory)
+    },
+    Topics: {
+        FindAliasVerbose: (0, node_opcua_nodeid_1.resolveNodeId)(node_opcua_constants_1.MethodIds.Topics_FindAliasVerbose),
+        AddAliasesToCategory: (0, node_opcua_nodeid_1.resolveNodeId)(node_opcua_constants_1.MethodIds.Topics_AddAliasesToCategory),
+        DeleteAliasesFromCategory: (0, node_opcua_nodeid_1.resolveNodeId)(node_opcua_constants_1.MethodIds.Topics_DeleteAliasesFromCategory)
+    }
+};
+/**
+ * The `ALIAS` ServerCapability identifier (OPC 10000-12 Annex D Table D.1).
+ *
+ * A Server that does not advertise this will never be found by anything looking
+ * for alias-capable Servers, and nothing reports that failure. Part 17's prose
+ * writes it `Alias`; Part 12 Annex D is the normative source and writes `ALIAS`,
+ * matched case-insensitively.
+ */
+exports.ALIAS_SERVER_CAPABILITY = "ALIAS";
+//# sourceMappingURL=well_known.js.map

package/dist/well_known.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"well_known.js","sourceRoot":"","sources":["../source/well_known.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;;AAEH,+DAAuH;AACvH,yDAA+D;AAE/D;;;;;;GAMG;AACU,QAAA,mBAAmB,GAAG,IAAI,CAAC;AAExC,+CAA+C;AAClC,QAAA,eAAe,GAAW,IAAA,iCAAa,EAAC,oCAAa,CAAC,aAAa,CAAC,CAAC;AAElF,uDAAuD;AAC1C,QAAA,wBAAwB,GAAW,IAAA,iCAAa,EAAC,oCAAa,CAAC,qBAAqB,CAAC,CAAC;AAEnG,2EAA2E;AAC9D,QAAA,sBAAsB,GAAW,IAAA,iCAAa,EAAC,kCAAW,CAAC,WAAW,CAAC,CAAC;AAErF,gFAAgF;AACnE,QAAA,SAAS,GAAW,IAAA,iCAAa,EAAC,uCAAgB,CAAC,QAAQ,CAAC,CAAC;AAE1E,oFAAoF;AACvE,QAAA,uBAAuB,GAAW,IAAA,iCAAa,EAAC,oCAAa,CAAC,oBAAoB,CAAC,CAAC;AAEjG,2EAA2E;AAC9D,QAAA,mBAAmB,GAAG;IAC/B,yDAAyD;IACzD,OAAO,EAAE,IAAA,iCAAa,EAAC,gCAAS,CAAC,OAAO,CAAC;IACzC,oEAAoE;IACpE,YAAY,EAAE,IAAA,iCAAa,EAAC,gCAAS,CAAC,YAAY,CAAC;IACnD,yEAAyE;IACzE,MAAM,EAAE,IAAA,iCAAa,EAAC,gCAAS,CAAC,MAAM,CAAC;CACjC,CAAC;AAEX,+DAA+D;AAClD,QAAA,mBAAmB,GAAG;IAC/B,OAAO,EAAE,IAAA,iCAAa,EAAC,kCAAW,CAAC,kBAAkB,CAAC;IACtD,YAAY,EAAE,IAAA,iCAAa,EAAC,kCAAW,CAAC,uBAAuB,CAAC;IAChE,MAAM,EAAE,IAAA,iCAAa,EAAC,kCAAW,CAAC,iBAAiB,CAAC;CAC9C,CAAC;AAEX,0DAA0D;AAC7C,QAAA,kBAAkB,GAAG;IAC9B,SAAS,EAAE,IAAA,iCAAa,EAAC,gCAAS,CAAC,+BAA+B,CAAC;IACnE,gBAAgB,EAAE,IAAA,iCAAa,EAAC,gCAAS,CAAC,sCAAsC,CAAC;IACjF,oBAAoB,EAAE,IAAA,iCAAa,EAAC,gCAAS,CAAC,0CAA0C,CAAC;IACzF,yBAAyB,EAAE,IAAA,iCAAa,EAAC,gCAAS,CAAC,+CAA+C,CAAC;CAC7F,CAAC;AAEX;;;;;;;;;GASG;AACU,QAAA,wBAAwB,GAAG;IACpC,OAAO,EAAE;QACL,gBAAgB,EAAE,IAAA,iCAAa,EAAC,gCAAS,CAAC,wBAAwB,CAAC;QACnE,oBAAoB,EAAE,IAAA,iCAAa,EAAC,gCAAS,CAAC,4BAA4B,CAAC;QAC3E,yBAAyB,EAAE,IAAA,iCAAa,EAAC,gCAAS,CAAC,iCAAiC,CAAC;KACxF;IACD,YAAY,EAAE;QACV,gBAAgB,EAAE,IAAA,iCAAa,EAAC,gCAAS,CAAC,6BAA6B,CAAC;QACxE,oBAAoB,EAAE,IAAA,iCAAa,EAAC,gCAAS,CAAC,iCAAiC,CAAC;QAChF,yBAAyB,EAAE,IAAA,iCAAa,EAAC,gCAAS,CAAC,sCAAsC,CAAC;KAC7F;IACD,MAAM,EAAE;QACJ,gBAAgB,EAAE,IAAA,iCAAa,EAAC,gCAAS,CAAC,uBAAuB,CAAC;QAClE,oBAAoB,EAAE,IAAA,iCAAa,EAAC,gCAAS,CAAC,2BAA2B,CAAC;QAC1E,yBAAyB,EAAE,IAAA,iCAAa,EAAC,gCAAS,CAAC,gCAAgC,CAAC;KACvF;CACK,CAAC;AAEX;;;;;;;GAOG;AACU,QAAA,uBAAuB,GAAG,OAAO,CAAC"}