node-opcua-uanodeset-rdf 2.182.0

package/dist/from_session.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Collecting an `RdfModel` over a session.
+ *
+ * This is what makes a server exportable when its nodeset file is not available, which for a
+ * vendor's own companion specification is often the only way to get the model into a graph store
+ * at all.
+ *
+ * It is not the equal of `addressSpaceToRdfModel`, and the differences are not bugs to be fixed
+ * later. OPC UA has no service that lists the nodes of a namespace, so the model is whatever a
+ * crawl from Root reaches; `SymbolicName` is NodeSet2 metadata rather than an attribute, so it is
+ * simply gone; and `NamespaceMetadataType` carries no list of required models, so the ontology
+ * node has no `owl:imports` unless the caller supplies one. "What a session cannot tell you" in
+ * `VOCABULARY.md` is the full list.
+ */
+import { type IBasicSessionBrowseAsyncMultiple, type IBasicSessionBrowseNextAsyncMultiple, type IBasicSessionReadAsyncMultiple } from "node-opcua-pseudo-session";
+import type { RdfModel } from "./model.js";
+/**
+ * what collecting a model asks of a session, written out rather than named.
+ *
+ * Three services and no more: browse, follow the continuation point a browse hands back, and read
+ * attributes. Anything satisfying that will do, and both things that do are useful here: a
+ * `ClientSession` against a real server, and a `PseudoSession` over an address space. Spelling the
+ * intersection out is also what keeps `create`, `close`, subscriptions and the rest of a session's
+ * surface out of the contract, so a caller can pass something far smaller than a session.
+ */
+export type RdfSession = IBasicSessionBrowseAsyncMultiple & IBasicSessionBrowseNextAsyncMultiple & IBasicSessionReadAsyncMultiple;
+/** the model a namespace of a server describes, as far as a session can see it */
+export declare function sessionToRdfModel(session: RdfSession, modelUri?: string): Promise<RdfModel>;

package/dist/from_session.js

@@ -0,0 +1,293 @@
+"use strict";
+/**
+ * Collecting an `RdfModel` over a session.
+ *
+ * This is what makes a server exportable when its nodeset file is not available, which for a
+ * vendor's own companion specification is often the only way to get the model into a graph store
+ * at all.
+ *
+ * It is not the equal of `addressSpaceToRdfModel`, and the differences are not bugs to be fixed
+ * later. OPC UA has no service that lists the nodes of a namespace, so the model is whatever a
+ * crawl from Root reaches; `SymbolicName` is NodeSet2 metadata rather than an attribute, so it is
+ * simply gone; and `NamespaceMetadataType` carries no list of required models, so the ontology
+ * node has no `owl:imports` unless the caller supplies one. "What a session cannot tell you" in
+ * `VOCABULARY.md` is the full list.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sessionToRdfModel = sessionToRdfModel;
+const node_opcua_data_model_1 = require("node-opcua-data-model");
+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");
+/** `Root`, where a crawl has to start, since nothing lists the nodes of a namespace */
+const ROOT = (0, node_opcua_nodeid_1.resolveNodeId)("RootFolder");
+/** `Server_NamespaceArray` */
+const NAMESPACE_ARRAY = (0, node_opcua_nodeid_1.resolveNodeId)("Server_NamespaceArray");
+/** `Server_Namespaces`, the folder of `NamespaceMetadataType` objects */
+const NAMESPACES_FOLDER = (0, node_opcua_nodeid_1.coerceNodeId)("i=11715");
+/** `References`, so one browse per node covers every relation in both directions */
+const REFERENCES = (0, node_opcua_nodeid_1.resolveNodeId)("References");
+/** BrowseName, NodeClass and TypeDefinition of each target, which is all the mapper needs to name it */
+const RESULT_MASK = 0x3f;
+/**
+ * how many nodes to read attributes for at once.
+ *
+ * `browseAll` reads the server's own browse limits, but nothing here reads `MaxNodesPerRead`:
+ * honouring a server's operation limits belongs in a client that specialises in it, not in a
+ * bare exporter. This is a figure every server in practice accepts.
+ */
+const READ_CHUNK = 100;
+function stubOf(reference) {
+    return {
+        nodeId: reference.nodeId,
+        nodeClass: reference.nodeClass,
+        browseName: reference.browseName,
+        references: []
+    };
+}
+/** the namespace array, which is the only thing that turns a uri into the index NodeIds use */
+async function readNamespaceArray(session) {
+    const [dataValue] = await session.read([{ nodeId: NAMESPACE_ARRAY, attributeId: node_opcua_data_model_1.AttributeIds.Value }]);
+    const value = dataValue?.value?.value;
+    if (!value?.length) {
+        throw new Error("the server does not expose Server_NamespaceArray, so no namespace can be named");
+    }
+    return [...value];
+}
+/**
+ * every node a crawl from Root reaches, with the references of those in the target namespace.
+ *
+ * References are kept only for the target namespace because they are all the mapper reads: for
+ * any other node it asks for a name. That also bounds memory on a server whose base namespace is
+ * far larger than the model being exported.
+ */
+async function crawl(session, targetIndex) {
+    const known = new Map();
+    const nodes = [];
+    const rootReference = { nodeId: ROOT, nodeClass: node_opcua_data_model_1.NodeClass.Object, browseName: new node_opcua_data_model_1.QualifiedName({ name: "Root" }) };
+    known.set(ROOT.toString(), { ...rootReference, references: [] });
+    let frontier = [ROOT];
+    const visited = new Set([ROOT.toString()]);
+    while (frontier.length) {
+        const results = await (0, node_opcua_pseudo_session_1.browseAll)(session, frontier.map((nodeId) => ({
+            nodeId,
+            browseDirection: node_opcua_service_browse_1.BrowseDirection.Both,
+            referenceTypeId: REFERENCES,
+            includeSubtypes: true,
+            nodeClassMask: 0,
+            resultMask: RESULT_MASK
+        })));
+        const next = [];
+        for (let index = 0; index < frontier.length; index++) {
+            const from = frontier[index];
+            const references = results[index]?.references ?? [];
+            const owner = known.get(from.toString());
+            for (const reference of references) {
+                const key = reference.nodeId.toString();
+                if (!known.has(key))
+                    known.set(key, stubOf(reference));
+                if (owner && from.namespace === targetIndex) {
+                    owner.references.push({
+                        referenceTypeId: reference.referenceTypeId,
+                        isForward: reference.isForward,
+                        targetId: reference.nodeId
+                    });
+                }
+                if (!visited.has(key) && reference.isForward) {
+                    visited.add(key);
+                    next.push(reference.nodeId);
+                }
+            }
+            if (owner && from.namespace === targetIndex) {
+                nodes.push(owner);
+                // a node's own type definition is the target of its forward HasTypeDefinition
+                // edge. ReferenceDescription.typeDefinition is the *target's* type, not this
+                // node's, and reading it as this node's silently retypes half the model.
+                const typeDefinition = references.find((reference) => reference.isForward && isHasTypeDefinition(reference))?.nodeId;
+                if (typeDefinition)
+                    owner.typeDefinition = typeDefinition;
+                const supertype = references.find((reference) => !reference.isForward && isHasSubtype(reference));
+                if (supertype)
+                    owner.subtypeOf = supertype.nodeId;
+            }
+        }
+        frontier = next;
+    }
+    return { nodes, known };
+}
+const HAS_SUBTYPE = (0, node_opcua_nodeid_1.resolveNodeId)("HasSubtype");
+const HAS_TYPE_DEFINITION = (0, node_opcua_nodeid_1.resolveNodeId)("HasTypeDefinition");
+const isHasSubtype = (reference) => reference.referenceTypeId.toString() === HAS_SUBTYPE.toString();
+const isHasTypeDefinition = (reference) => reference.referenceTypeId.toString() === HAS_TYPE_DEFINITION.toString();
+/**
+ * the reference-type hierarchy, which `isHierarchical` walks and a stub does not carry.
+ *
+ * Reference types are few, and almost all of them belong to the base namespace, so this is a
+ * handful of browses however large the model is.
+ */
+async function fillReferenceTypeChains(session, known) {
+    const pending = () => [...known.values()].filter((node) => node.nodeClass === node_opcua_data_model_1.NodeClass.ReferenceType && node.subtypeOf === undefined);
+    let batch = pending();
+    const asked = new Set();
+    while (batch.length) {
+        const fresh = batch.filter((node) => !asked.has(node.nodeId.toString()));
+        if (!fresh.length)
+            return;
+        for (const node of fresh)
+            asked.add(node.nodeId.toString());
+        const results = await (0, node_opcua_pseudo_session_1.browseAll)(session, fresh.map((node) => ({
+            nodeId: node.nodeId,
+            browseDirection: node_opcua_service_browse_1.BrowseDirection.Inverse,
+            referenceTypeId: HAS_SUBTYPE,
+            includeSubtypes: false,
+            nodeClassMask: 0,
+            resultMask: RESULT_MASK
+        })));
+        for (let index = 0; index < fresh.length; index++) {
+            const reference = results[index]?.references?.[0];
+            if (!reference)
+                continue;
+            fresh[index].subtypeOf = reference.nodeId;
+            const key = reference.nodeId.toString();
+            if (!known.has(key))
+                known.set(key, stubOf(reference));
+        }
+        batch = pending();
+    }
+}
+/** the attributes a node carries that no browse reports */
+async function readAttributes(session, nodes) {
+    const wanted = [];
+    for (const node of nodes) {
+        wanted.push({ node, attributeId: node_opcua_data_model_1.AttributeIds.Description });
+        if (node.nodeClass === node_opcua_data_model_1.NodeClass.Variable || node.nodeClass === node_opcua_data_model_1.NodeClass.VariableType) {
+            wanted.push({ node, attributeId: node_opcua_data_model_1.AttributeIds.DataType });
+            wanted.push({ node, attributeId: node_opcua_data_model_1.AttributeIds.ValueRank });
+            wanted.push({ node, attributeId: node_opcua_data_model_1.AttributeIds.ArrayDimensions });
+            wanted.push({ node, attributeId: node_opcua_data_model_1.AttributeIds.Value });
+        }
+        if (node.nodeClass === node_opcua_data_model_1.NodeClass.ReferenceType) {
+            wanted.push({ node, attributeId: node_opcua_data_model_1.AttributeIds.Symmetric });
+            wanted.push({ node, attributeId: node_opcua_data_model_1.AttributeIds.InverseName });
+        }
+    }
+    for (let start = 0; start < wanted.length; start += READ_CHUNK) {
+        const chunk = wanted.slice(start, start + READ_CHUNK);
+        const dataValues = await session.read(chunk.map(({ node, attributeId }) => ({ nodeId: node.nodeId, attributeId })));
+        for (let index = 0; index < chunk.length; index++) {
+            const dataValue = dataValues[index];
+            if (!dataValue?.statusCode.isGood())
+                continue;
+            const { node, attributeId } = chunk[index];
+            const value = dataValue.value?.value;
+            switch (attributeId) {
+                case node_opcua_data_model_1.AttributeIds.Description:
+                    if (value instanceof node_opcua_data_model_1.LocalizedText && value.text)
+                        node.description = value;
+                    break;
+                case node_opcua_data_model_1.AttributeIds.DataType:
+                    if (value)
+                        node.dataType = value;
+                    break;
+                case node_opcua_data_model_1.AttributeIds.ValueRank:
+                    if (typeof value === "number")
+                        node.valueRank = value;
+                    break;
+                case node_opcua_data_model_1.AttributeIds.ArrayDimensions:
+                    if (value)
+                        node.arrayDimensions = Array.from(value);
+                    break;
+                case node_opcua_data_model_1.AttributeIds.Value:
+                    if (dataValue.value)
+                        node.value = dataValue.value;
+                    break;
+                case node_opcua_data_model_1.AttributeIds.Symmetric:
+                    node.symmetric = !!value;
+                    break;
+                case node_opcua_data_model_1.AttributeIds.InverseName:
+                    if (value instanceof node_opcua_data_model_1.LocalizedText && value.text)
+                        node.inverseName = value;
+                    break;
+                default:
+                    break;
+            }
+        }
+    }
+}
+/**
+ * the version and publication date a `NamespaceMetadataType` object states.
+ *
+ * There is no `RequiredModels` here to read: the type does not have one. That is why a
+ * session-sourced ontology node carries no `owl:imports`.
+ */
+async function readNamespaceMetadata(session, namespaceUri) {
+    try {
+        const folder = await (0, node_opcua_pseudo_session_1.browseAll)(session, {
+            nodeId: NAMESPACES_FOLDER,
+            browseDirection: node_opcua_service_browse_1.BrowseDirection.Forward,
+            referenceTypeId: REFERENCES,
+            includeSubtypes: true,
+            nodeClassMask: 0,
+            resultMask: RESULT_MASK
+        });
+        const entry = folder.references?.find((reference) => reference.browseName.name === namespaceUri);
+        if (!entry)
+            return {};
+        const properties = await (0, node_opcua_pseudo_session_1.browseAll)(session, {
+            nodeId: entry.nodeId,
+            browseDirection: node_opcua_service_browse_1.BrowseDirection.Forward,
+            referenceTypeId: REFERENCES,
+            includeSubtypes: true,
+            nodeClassMask: 0,
+            resultMask: RESULT_MASK
+        });
+        const find = (name) => properties.references?.find((reference) => reference.browseName.name === name)?.nodeId;
+        const versionId = find("NamespaceVersion");
+        const publicationId = find("NamespacePublicationDate");
+        if (!versionId && !publicationId)
+            return {};
+        const dataValues = await session.read([versionId, publicationId]
+            .filter((nodeId) => !!nodeId)
+            .map((nodeId) => ({ nodeId, attributeId: node_opcua_data_model_1.AttributeIds.Value })));
+        const out = {};
+        let cursor = 0;
+        if (versionId) {
+            const value = dataValues[cursor++]?.value?.value;
+            if (typeof value === "string" && value)
+                out.version = value;
+        }
+        if (publicationId) {
+            const value = dataValues[cursor]?.value?.value;
+            if (value instanceof Date)
+                out.publicationDate = value;
+        }
+        return out;
+    }
+    catch {
+        // a server without Server/Namespaces states no version, which is not an error for an export
+        return {};
+    }
+}
+/** the model a namespace of a server describes, as far as a session can see it */
+async function sessionToRdfModel(session, modelUri) {
+    const namespaceUris = await readNamespaceArray(session);
+    const targetIndex = modelUri ? namespaceUris.indexOf(modelUri) : namespaceUris.length - 1;
+    if (targetIndex < 0) {
+        throw new Error(`the server holds no namespace ${modelUri}`);
+    }
+    const namespaceUri = namespaceUris[targetIndex];
+    const { nodes, known } = await crawl(session, targetIndex);
+    await fillReferenceTypeChains(session, known);
+    await readAttributes(session, nodes);
+    const metadata = await readNamespaceMetadata(session, namespaceUri);
+    // a crawl reaches nodes in the order the hierarchy happens to lay them out, which is not an
+    // order anyone chose. Sorting makes two exports of the same server comparable.
+    nodes.sort((a, b) => a.nodeId.toString().localeCompare(b.nodeId.toString()));
+    return {
+        namespaceUris,
+        target: { index: targetIndex, namespaceUri, version: metadata.version, publicationDate: metadata.publicationDate },
+        nodes,
+        resolve: (nodeId) => known.get(nodeId.toString())
+    };
+}
+//# sourceMappingURL=from_session.js.map

package/dist/from_session.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,30 @@
+/**
+ * An OPC UA information model as JSON-LD, for loading into a SPARQL store.
+ *
+ * This is unlike the Annex I formats in every way that matters, which is why it lives in a
+ * package of its own.
+ *
+ * It is **not in the specification**. OPC 10000-6 Annex I runs I.1 to I.24 and has no RDF
+ * section. The vocabulary belongs to the reference implementation, whose `rdf_prototype.md` no
+ * longer describes what it emits, so its output is the specification. What we reverse-engineered
+ * is written down in `VOCABULARY.md` beside this file.
+ *
+ * It is **one-way**. There is no reader, so none of the checks that make the Annex I formats
+ * trustworthy apply: no round trip, no fixpoint, no digest equivalence. A diff against the
+ * reference implementation is the only oracle, which is why matching it exactly matters more here
+ * than for a format that can be checked against itself.
+ *
+ * There are two ways in, and each has an entry point of its own so that neither drags in what
+ * only the other needs:
+ *
+ * - `node-opcua-uanodeset-rdf/address-space` is the complete source, and the one to prefer where
+ *   the model was loaded from its NodeSet2 document.
+ * - `node-opcua-uanodeset-rdf/session` works against a server whose nodeset file you do not have,
+ *   which is the only way to get a vendor's model into a graph store at all. It never mentions
+ *   `node-opcua-address-space`, so a client application does not load it.
+ *
+ * This module is both, for callers that want both.
+ */
+export * from "./address_space.js";
+export { type RdfSession, sessionToRdfModel } from "./from_session.js";
+export { sessionToJsonLd, sessionToJsonLdText } from "./session.js";

package/dist/index.js

@@ -0,0 +1,51 @@
+"use strict";
+/**
+ * An OPC UA information model as JSON-LD, for loading into a SPARQL store.
+ *
+ * This is unlike the Annex I formats in every way that matters, which is why it lives in a
+ * package of its own.
+ *
+ * It is **not in the specification**. OPC 10000-6 Annex I runs I.1 to I.24 and has no RDF
+ * section. The vocabulary belongs to the reference implementation, whose `rdf_prototype.md` no
+ * longer describes what it emits, so its output is the specification. What we reverse-engineered
+ * is written down in `VOCABULARY.md` beside this file.
+ *
+ * It is **one-way**. There is no reader, so none of the checks that make the Annex I formats
+ * trustworthy apply: no round trip, no fixpoint, no digest equivalence. A diff against the
+ * reference implementation is the only oracle, which is why matching it exactly matters more here
+ * than for a format that can be checked against itself.
+ *
+ * There are two ways in, and each has an entry point of its own so that neither drags in what
+ * only the other needs:
+ *
+ * - `node-opcua-uanodeset-rdf/address-space` is the complete source, and the one to prefer where
+ *   the model was loaded from its NodeSet2 document.
+ * - `node-opcua-uanodeset-rdf/session` works against a server whose nodeset file you do not have,
+ *   which is the only way to get a vendor's model into a graph store at all. It never mentions
+ *   `node-opcua-address-space`, so a client application does not load it.
+ *
+ * This module is both, for callers that want both.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sessionToJsonLdText = exports.sessionToJsonLd = exports.sessionToRdfModel = void 0;
+__exportStar(require("./address_space.js"), exports);
+var from_session_js_1 = require("./from_session.js");
+Object.defineProperty(exports, "sessionToRdfModel", { enumerable: true, get: function () { return from_session_js_1.sessionToRdfModel; } });
+var session_js_1 = require("./session.js");
+Object.defineProperty(exports, "sessionToJsonLd", { enumerable: true, get: function () { return session_js_1.sessionToJsonLd; } });
+Object.defineProperty(exports, "sessionToJsonLdText", { enumerable: true, get: function () { return session_js_1.sessionToJsonLdText; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../source/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;;;;;;;;;;;;;;;;;AAEH,qDAAmC;AACnC,qDAAuE;AAA7C,oHAAA,iBAAiB,OAAA;AAC3C,2CAAoE;AAA3D,6GAAA,eAAe,OAAA;AAAE,iHAAA,mBAAmB,OAAA"}

package/dist/model.d.ts

@@ -0,0 +1,79 @@
+/**
+ * What the JSON-LD mapper needs to know about a model, and nothing more.
+ *
+ * The mapper used to read an `IAddressSpace` directly, which tied it to a source that answers
+ * synchronously and at random. A session answers asynchronously and in batches, and rewriting the
+ * mapper around `await` would have turned four passes over the nodes into thousands of round
+ * trips. So collection and mapping are separated instead: a collector fills this structure, the
+ * mapper reads it, and the mapper never awaits.
+ *
+ * The structure is deliberately close to what OPC UA can actually tell you about a node, since
+ * one of its two collectors has only Browse and Read to work with.
+ */
+import type { LocalizedText, NodeClass, QualifiedName } from "node-opcua-data-model";
+import type { NodeId } from "node-opcua-nodeid";
+import type { Variant } from "node-opcua-variant";
+/** one edge, in the direction the source states it */
+export interface RdfReference {
+    referenceTypeId: NodeId;
+    isForward: boolean;
+    targetId: NodeId;
+}
+/** a model the exporter names in its own right */
+export interface RdfModelReference {
+    modelUri: string;
+    version?: string;
+    publicationDate?: Date;
+}
+/**
+ * one node.
+ *
+ * A node the exporter merely has to *name* (a supertype in another model, say) needs only
+ * `nodeId`, `nodeClass` and `browseName`; the rest may be absent, and `references` may be empty.
+ * Only the nodes of the exported namespace are filled in completely.
+ */
+export interface RdfNode {
+    nodeId: NodeId;
+    nodeClass: NodeClass;
+    browseName: QualifiedName;
+    references: RdfReference[];
+    description?: LocalizedText;
+    /**
+     * NodeSet2 metadata, not an OPC UA attribute, so a session-sourced model never carries it.
+     * See "What a session cannot tell you" in VOCABULARY.md.
+     */
+    symbolicName?: string;
+    typeDefinition?: NodeId;
+    /** Variable and VariableType */
+    dataType?: NodeId;
+    valueRank?: number;
+    arrayDimensions?: number[] | null;
+    value?: Variant;
+    /** ReferenceType */
+    inverseName?: LocalizedText;
+    symmetric?: boolean;
+    subtypeOf?: NodeId;
+}
+/** the namespace being exported, and what the ontology node says about it */
+export interface RdfTarget {
+    index: number;
+    namespaceUri: string;
+    version?: string;
+    publicationDate?: Date;
+    requiredModels?: RdfModelReference[];
+}
+/** everything the mapper reads */
+export interface RdfModel {
+    /** index to uri, as the source's own namespace array orders it */
+    namespaceUris: string[];
+    target: RdfTarget;
+    /** the exported namespace's nodes, in the order they are written */
+    nodes: RdfNode[];
+    /**
+     * any node the mapper may have to name, including nodes of other models.
+     *
+     * An address space answers this from itself on demand; a session collector has to have
+     * fetched the answer already, which is why the return is a node rather than a promise.
+     */
+    resolve(nodeId: NodeId): RdfNode | undefined;
+}

package/dist/model.js

@@ -0,0 +1,15 @@
+"use strict";
+/**
+ * What the JSON-LD mapper needs to know about a model, and nothing more.
+ *
+ * The mapper used to read an `IAddressSpace` directly, which tied it to a source that answers
+ * synchronously and at random. A session answers asynchronously and in batches, and rewriting the
+ * mapper around `await` would have turned four passes over the nodes into thousands of round
+ * trips. So collection and mapping are separated instead: a collector fills this structure, the
+ * mapper reads it, and the mapper never awaits.
+ *
+ * The structure is deliberately close to what OPC UA can actually tell you about a node, since
+ * one of its two collectors has only Browse and Read to work with.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=model.js.map

package/dist/model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.js","sourceRoot":"","sources":["../source/model.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;GAWG"}

package/dist/session.d.ts

@@ -0,0 +1,27 @@
+/**
+ * The session entry point: `node-opcua-uanodeset-rdf/session`.
+ *
+ * Nothing reachable from here mentions `node-opcua-address-space`, at the type level or the
+ * runtime one, so a client application can export a server's model without loading the address
+ * space machinery it has no other use for. That is the whole reason this is a separate entry
+ * point rather than a second function in the root one.
+ *
+ * What a session cannot tell you is listed in `VOCABULARY.md`; the short version is that OPC UA
+ * has no service listing the nodes of a namespace, `SymbolicName` is not an attribute, and
+ * `NamespaceMetadataType` states no required models.
+ */
+import { type RdfSession } from "./from_session.js";
+import { type JsonLdOptions } from "./to_jsonld.js";
+export { type RdfSession, sessionToRdfModel } from "./from_session.js";
+export type { RdfModel, RdfModelReference, RdfNode, RdfReference, RdfTarget } from "./model.js";
+export { type JsonLdOptions, modelToJsonLd, OPCUA_NAMESPACE, prefixOfNamespace, UARDF } from "./to_jsonld.js";
+/**
+ * a namespace of a server as a JSON-LD document.
+ *
+ * The session may be a real client session, or a `PseudoSession` over an address space. The
+ * latter is what makes the two paths comparable: the same model collected two ways, where the
+ * difference is exactly what a session cannot carry.
+ */
+export declare function sessionToJsonLd(session: RdfSession, options?: JsonLdOptions): Promise<Record<string, unknown>>;
+/** a namespace of a server as a JSON-LD document, serialised */
+export declare function sessionToJsonLdText(session: RdfSession, options?: JsonLdOptions): Promise<string>;

package/dist/session.js

@@ -0,0 +1,41 @@
+"use strict";
+/**
+ * The session entry point: `node-opcua-uanodeset-rdf/session`.
+ *
+ * Nothing reachable from here mentions `node-opcua-address-space`, at the type level or the
+ * runtime one, so a client application can export a server's model without loading the address
+ * space machinery it has no other use for. That is the whole reason this is a separate entry
+ * point rather than a second function in the root one.
+ *
+ * What a session cannot tell you is listed in `VOCABULARY.md`; the short version is that OPC UA
+ * has no service listing the nodes of a namespace, `SymbolicName` is not an attribute, and
+ * `NamespaceMetadataType` states no required models.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UARDF = exports.prefixOfNamespace = exports.OPCUA_NAMESPACE = exports.modelToJsonLd = exports.sessionToRdfModel = void 0;
+exports.sessionToJsonLd = sessionToJsonLd;
+exports.sessionToJsonLdText = sessionToJsonLdText;
+const from_session_js_1 = require("./from_session.js");
+const to_jsonld_js_1 = require("./to_jsonld.js");
+var from_session_js_2 = require("./from_session.js");
+Object.defineProperty(exports, "sessionToRdfModel", { enumerable: true, get: function () { return from_session_js_2.sessionToRdfModel; } });
+var to_jsonld_js_2 = require("./to_jsonld.js");
+Object.defineProperty(exports, "modelToJsonLd", { enumerable: true, get: function () { return to_jsonld_js_2.modelToJsonLd; } });
+Object.defineProperty(exports, "OPCUA_NAMESPACE", { enumerable: true, get: function () { return to_jsonld_js_2.OPCUA_NAMESPACE; } });
+Object.defineProperty(exports, "prefixOfNamespace", { enumerable: true, get: function () { return to_jsonld_js_2.prefixOfNamespace; } });
+Object.defineProperty(exports, "UARDF", { enumerable: true, get: function () { return to_jsonld_js_2.UARDF; } });
+/**
+ * a namespace of a server as a JSON-LD document.
+ *
+ * The session may be a real client session, or a `PseudoSession` over an address space. The
+ * latter is what makes the two paths comparable: the same model collected two ways, where the
+ * difference is exactly what a session cannot carry.
+ */
+async function sessionToJsonLd(session, options = {}) {
+    return (0, to_jsonld_js_1.modelToJsonLd)(await (0, from_session_js_1.sessionToRdfModel)(session, options.modelUri), options);
+}
+/** a namespace of a server as a JSON-LD document, serialised */
+async function sessionToJsonLdText(session, options = {}) {
+    return `${JSON.stringify(await sessionToJsonLd(session, options), null, 2)}\n`;
+}
+//# sourceMappingURL=session.js.map

package/dist/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../source/session.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;GAWG;;;AAgBH,0CAEC;AAGD,kDAEC;AArBD,uDAAuE;AACvE,iDAAmE;AAEnE,qDAAuE;AAA7C,oHAAA,iBAAiB,OAAA;AAE3C,+CAA8G;AAAjF,6GAAA,aAAa,OAAA;AAAE,+GAAA,eAAe,OAAA;AAAE,iHAAA,iBAAiB,OAAA;AAAE,qGAAA,KAAK,OAAA;AAErF;;;;;;GAMG;AACI,KAAK,UAAU,eAAe,CAAC,OAAmB,EAAE,UAAyB,EAAE;IAClF,OAAO,IAAA,4BAAa,EAAC,MAAM,IAAA,mCAAiB,EAAC,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC,CAAC;AACtF,CAAC;AAED,gEAAgE;AACzD,KAAK,UAAU,mBAAmB,CAAC,OAAmB,EAAE,UAAyB,EAAE;IACtF,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,eAAe,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC;AACnF,CAAC"}

package/dist/to_jsonld.d.ts

@@ -0,0 +1,31 @@
+/**
+ * The vocabulary, and the mapping from a collected model to the JSON-LD document.
+ *
+ * Everything here is synchronous and reads only `RdfModel`, so the same code serves a model
+ * collected from an address space and one collected over a session. The vocabulary is the
+ * reference implementation's; `VOCABULARY.md` beside this file records what reading its output
+ * established.
+ */
+import type { RdfModel } from "./model.js";
+/** the vocabulary the reference implementation writes its own terms under */
+export declare const UARDF = "http://opcfoundation.org/rdf/uacore#";
+/** the OPC UA base namespace, always abbreviated `opcua` */
+export declare const OPCUA_NAMESPACE = "http://opcfoundation.org/UA/";
+/** the prefix a namespace uri is abbreviated to: its last non-empty segment, lowercased */
+export declare function prefixOfNamespace(uri: string): string;
+export interface JsonLdOptions {
+    /** the model to export; the default is the last namespace the address space holds */
+    modelUri?: string;
+    /**
+     * two fields of the ontology node the address space does not retain.
+     *
+     * They are written in the source document's `Models` element and dropped by the loader, so a
+     * caller that wants them in the output supplies them again.
+     */
+    model?: {
+        xmlSchemaUri?: string;
+        modelVersion?: string;
+    };
+}
+/** a collected model as a JSON-LD document */
+export declare function modelToJsonLd(model: RdfModel, options?: JsonLdOptions): Record<string, unknown>;