@twin.org/data-json-ld 0.0.2-next.3 → 0.0.3-next.1

package/dist/es/schemas/JsonLdIndexMap.json

@@ -0,0 +1,19 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "https://schema.twindev.org/json-ld/JsonLdIndexMap",
+    "description": "An index map allows keys that have no semantic meaning, but should be preserved regardless, to be used in JSON-LD documents.",
+    "type": "object",
+    "additionalProperties": {
+        "anyOf": [
+            {
+                "$ref": "https://schema.twindev.org/json-ld/JsonLdIndexMapItem"
+            },
+            {
+                "type": "array",
+                "items": {
+                    "$ref": "https://schema.twindev.org/json-ld/JsonLdIndexMapItem"
+                }
+            }
+        ]
+    }
+}

package/dist/es/schemas/JsonLdIndexMapItem.json

@@ -0,0 +1,31 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "https://schema.twindev.org/json-ld/JsonLdIndexMapItem",
+    "description": "The items that can be stored in an index map.",
+    "anyOf": [
+        {
+            "type": "null"
+        },
+        {
+            "type": "boolean"
+        },
+        {
+            "type": "number"
+        },
+        {
+            "type": "string"
+        },
+        {
+            "$ref": "https://schema.twindev.org/json-ld/JsonLdNodeObject"
+        },
+        {
+            "$ref": "https://schema.twindev.org/json-ld/JsonLdValueObject"
+        },
+        {
+            "$ref": "https://schema.twindev.org/json-ld/JsonLdListObject"
+        },
+        {
+            "$ref": "https://schema.twindev.org/json-ld/JsonLdSetObject"
+        }
+    ]
+}

package/dist/es/schemas/JsonLdJsonArray.json

@@ -0,0 +1,9 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "https://schema.twindev.org/json-ld/JsonLdJsonArray",
+    "description": "JSON Type for array.",
+    "type": "array",
+    "items": {
+        "$ref": "https://schema.twindev.org/json-ld/JsonLdJsonValue"
+    }
+}

package/dist/es/schemas/JsonLdJsonObject.json

@@ -0,0 +1,16 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "https://schema.twindev.org/json-ld/JsonLdJsonObject",
+    "description": "JSON Type for object.",
+    "type": "object",
+    "additionalProperties": {
+        "anyOf": [
+            {
+                "$ref": "https://schema.twindev.org/json-ld/JsonLdJsonValue"
+            },
+            {
+                "not": {}
+            }
+        ]
+    }
+}

package/dist/es/schemas/JsonLdJsonPrimitive.json

@@ -0,0 +1,11 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "https://schema.twindev.org/json-ld/JsonLdJsonPrimitive",
+    "description": "JSON Primitive.",
+    "type": [
+        "string",
+        "number",
+        "boolean",
+        "null"
+    ]
+}

package/dist/es/schemas/JsonLdJsonValue.json

@@ -0,0 +1,16 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "https://schema.twindev.org/json-ld/JsonLdJsonValue",
+    "description": "JSON Value.",
+    "anyOf": [
+        {
+            "$ref": "https://schema.twindev.org/json-ld/JsonLdJsonPrimitive"
+        },
+        {
+            "$ref": "https://schema.twindev.org/json-ld/JsonLdJsonArray"
+        },
+        {
+            "$ref": "https://schema.twindev.org/json-ld/JsonLdJsonObject"
+        }
+    ]
+}

package/dist/es/schemas/JsonLdLanguageMap.json

@@ -0,0 +1,22 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "https://schema.twindev.org/json-ld/JsonLdLanguageMap",
+    "description": "A language map is used to associate a language with a value in a way that allows easy programmatic access.",
+    "type": "object",
+    "additionalProperties": {
+        "anyOf": [
+            {
+                "type": "null"
+            },
+            {
+                "type": "string"
+            },
+            {
+                "type": "array",
+                "items": {
+                    "type": "string"
+                }
+            }
+        ]
+    }
+}

package/dist/es/schemas/JsonLdListObject.json

@@ -0,0 +1,28 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "https://schema.twindev.org/json-ld/JsonLdListObject",
+    "description": "A list represents an ordered set of values.",
+    "type": "object",
+    "properties": {
+        "@list": {
+            "anyOf": [
+                {
+                    "$ref": "https://schema.twindev.org/json-ld/JsonLdListOrSetItem"
+                },
+                {
+                    "type": "array",
+                    "items": {
+                        "$ref": "https://schema.twindev.org/json-ld/JsonLdListOrSetItem"
+                    }
+                }
+            ]
+        },
+        "@index": {
+            "type": "string"
+        }
+    },
+    "required": [
+        "@list"
+    ],
+    "additionalProperties": false
+}

package/dist/es/schemas/JsonLdListOrSetItem.json

@@ -0,0 +1,25 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "https://schema.twindev.org/json-ld/JsonLdListOrSetItem",
+    "description": "A list or set item can be a null, boolean, number, string, node object, or value object.",
+    "anyOf": [
+        {
+            "type": "null"
+        },
+        {
+            "type": "boolean"
+        },
+        {
+            "type": "number"
+        },
+        {
+            "type": "string"
+        },
+        {
+            "$ref": "https://schema.twindev.org/json-ld/JsonLdNodeObject"
+        },
+        {
+            "$ref": "https://schema.twindev.org/json-ld/JsonLdValueObject"
+        }
+    ]
+}

package/dist/es/schemas/JsonLdNodeObject.json

@@ -0,0 +1,100 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "https://schema.twindev.org/json-ld/JsonLdNodeObject",
+    "description": "A node object represents zero or more properties of a node in the graph serialized by the JSON-LD document.",
+    "type": "object",
+    "additionalProperties": {
+        "anyOf": [
+            {
+                "$ref": "https://schema.twindev.org/json-ld/JsonLdNodePrimitive"
+            },
+            {
+                "$ref": "https://schema.twindev.org/json-ld/JsonLdLanguageMap"
+            },
+            {
+                "$ref": "https://schema.twindev.org/json-ld/JsonLdIndexMap"
+            },
+            {
+                "$ref": "https://schema.twindev.org/json-ld/JsonLdIncludedBlock"
+            },
+            {
+                "$ref": "https://schema.twindev.org/json-ld/JsonLdIdMap"
+            },
+            {
+                "$ref": "https://schema.twindev.org/json-ld/JsonLdTypeMap"
+            },
+            {
+                "type": "array"
+            }
+        ]
+    },
+    "properties": {
+        "@context": {
+            "$ref": "https://schema.twindev.org/json-ld/JsonLdContextDefinitionRoot"
+        },
+        "@id": {
+            "anyOf": [
+                {
+                    "type": "string"
+                },
+                {
+                    "type": "array",
+                    "items": {
+                        "type": "string"
+                    }
+                }
+            ]
+        },
+        "@included": {
+            "$ref": "https://schema.twindev.org/json-ld/JsonLdIncludedBlock"
+        },
+        "@graph": {
+            "anyOf": [
+                {
+                    "$ref": "https://schema.twindev.org/json-ld/JsonLdNodeObject"
+                },
+                {
+                    "type": "array",
+                    "items": {
+                        "$ref": "https://schema.twindev.org/json-ld/JsonLdNodeObject"
+                    }
+                }
+            ]
+        },
+        "@nest": {
+            "anyOf": [
+                {
+                    "$ref": "https://schema.twindev.org/json-ld/JsonLdJsonObject"
+                },
+                {
+                    "type": "array",
+                    "items": {
+                        "$ref": "https://schema.twindev.org/json-ld/JsonLdJsonObject"
+                    }
+                }
+            ]
+        },
+        "@type": {
+            "anyOf": [
+                {
+                    "type": "string"
+                },
+                {
+                    "type": "array",
+                    "items": {
+                        "type": "string"
+                    }
+                }
+            ]
+        },
+        "@reverse": {
+            "type": "object",
+            "additionalProperties": {
+                "type": "string"
+            }
+        },
+        "@index": {
+            "type": "string"
+        }
+    }
+}

package/dist/es/schemas/JsonLdNodePrimitive.json

@@ -0,0 +1,34 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "https://schema.twindev.org/json-ld/JsonLdNodePrimitive",
+    "description": "A node primitive is a JSON-LD value which is not one of the defined NodeObject properties.",
+    "anyOf": [
+        {
+            "type": "null"
+        },
+        {
+            "type": "boolean"
+        },
+        {
+            "type": "number"
+        },
+        {
+            "type": "string"
+        },
+        {
+            "$ref": "https://schema.twindev.org/json-ld/JsonLdNodeObject"
+        },
+        {
+            "$ref": "https://schema.twindev.org/json-ld/JsonLdGraphObject"
+        },
+        {
+            "$ref": "https://schema.twindev.org/json-ld/JsonLdValueObject"
+        },
+        {
+            "$ref": "https://schema.twindev.org/json-ld/JsonLdListObject"
+        },
+        {
+            "$ref": "https://schema.twindev.org/json-ld/JsonLdSetObject"
+        }
+    ]
+}

package/dist/es/schemas/JsonLdObject.json

@@ -0,0 +1,76 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "https://schema.twindev.org/json-ld/JsonLdObject",
+    "description": "An object represents the pre-defined properties of the node object in the graph serialized by the JSON-LD document.",
+    "type": "object",
+    "properties": {
+        "@context": {
+            "$ref": "https://schema.twindev.org/json-ld/JsonLdContextDefinitionRoot"
+        },
+        "@id": {
+            "anyOf": [
+                {
+                    "type": "string"
+                },
+                {
+                    "type": "array",
+                    "items": {
+                        "type": "string"
+                    }
+                }
+            ]
+        },
+        "@included": {
+            "$ref": "https://schema.twindev.org/json-ld/JsonLdIncludedBlock"
+        },
+        "@graph": {
+            "anyOf": [
+                {
+                    "$ref": "https://schema.twindev.org/json-ld/JsonLdNodeObject"
+                },
+                {
+                    "type": "array",
+                    "items": {
+                        "$ref": "https://schema.twindev.org/json-ld/JsonLdNodeObject"
+                    }
+                }
+            ]
+        },
+        "@nest": {
+            "anyOf": [
+                {
+                    "$ref": "https://schema.twindev.org/json-ld/JsonLdJsonObject"
+                },
+                {
+                    "type": "array",
+                    "items": {
+                        "$ref": "https://schema.twindev.org/json-ld/JsonLdJsonObject"
+                    }
+                }
+            ]
+        },
+        "@type": {
+            "anyOf": [
+                {
+                    "type": "string"
+                },
+                {
+                    "type": "array",
+                    "items": {
+                        "type": "string"
+                    }
+                }
+            ]
+        },
+        "@reverse": {
+            "type": "object",
+            "additionalProperties": {
+                "type": "string"
+            }
+        },
+        "@index": {
+            "type": "string"
+        }
+    },
+    "additionalProperties": false
+}

package/dist/es/schemas/JsonLdSetObject.json

@@ -0,0 +1,28 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "https://schema.twindev.org/json-ld/JsonLdSetObject",
+    "description": "A set represents an unordered set of values.",
+    "type": "object",
+    "properties": {
+        "@set": {
+            "anyOf": [
+                {
+                    "$ref": "https://schema.twindev.org/json-ld/JsonLdListOrSetItem"
+                },
+                {
+                    "type": "array",
+                    "items": {
+                        "$ref": "https://schema.twindev.org/json-ld/JsonLdListOrSetItem"
+                    }
+                }
+            ]
+        },
+        "@index": {
+            "type": "string"
+        }
+    },
+    "required": [
+        "@set"
+    ],
+    "additionalProperties": false
+}

package/dist/es/schemas/JsonLdTypeMap.json

@@ -0,0 +1,16 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "https://schema.twindev.org/json-ld/JsonLdTypeMap",
+    "description": "A type map is used to associate an IRI with a value that allows easy programmatic access.",
+    "type": "object",
+    "additionalProperties": {
+        "anyOf": [
+            {
+                "type": "string"
+            },
+            {
+                "$ref": "https://schema.twindev.org/json-ld/JsonLdNodeObject"
+            }
+        ]
+    }
+}

package/dist/es/schemas/JsonLdValueObject.json

@@ -0,0 +1,113 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "https://schema.twindev.org/json-ld/JsonLdValueObject",
+    "description": "A value object is used to explicitly associate a type or a language with a value to create a typed value or a language-tagged string and possibly associate a base direction.",
+    "anyOf": [
+        {
+            "type": "object",
+            "additionalProperties": false,
+            "properties": {
+                "@value": {
+                    "type": [
+                        "null",
+                        "boolean",
+                        "number",
+                        "string"
+                    ]
+                },
+                "@language": {
+                    "type": "string"
+                },
+                "@direction": {
+                    "type": [
+                        "string",
+                        "null"
+                    ],
+                    "enum": [
+                        "ltr",
+                        "rtl",
+                        null
+                    ]
+                },
+                "@index": {
+                    "type": "string"
+                },
+                "@context": {
+                    "$ref": "https://schema.twindev.org/json-ld/JsonLdContextDefinitionRoot"
+                }
+            },
+            "required": [
+                "@value"
+            ]
+        },
+        {
+            "type": "object",
+            "additionalProperties": false,
+            "properties": {
+                "@value": {
+                    "type": [
+                        "null",
+                        "boolean",
+                        "number",
+                        "string"
+                    ]
+                },
+                "@type": {
+                    "type": "string"
+                },
+                "@index": {
+                    "type": "string"
+                },
+                "@context": {
+                    "$ref": "https://schema.twindev.org/json-ld/JsonLdContextDefinitionRoot"
+                }
+            },
+            "required": [
+                "@type",
+                "@value"
+            ]
+        },
+        {
+            "type": "object",
+            "additionalProperties": false,
+            "properties": {
+                "@value": {
+                    "anyOf": [
+                        {
+                            "type": "null"
+                        },
+                        {
+                            "type": "boolean"
+                        },
+                        {
+                            "type": "number"
+                        },
+                        {
+                            "type": "string"
+                        },
+                        {
+                            "$ref": "https://schema.twindev.org/json-ld/JsonLdJsonObject"
+                        },
+                        {
+                            "$ref": "https://schema.twindev.org/json-ld/JsonLdJsonArray"
+                        }
+                    ]
+                },
+                "@type": {
+                    "type": "string",
+                    "const": "@json"
+                },
+                "@index": {
+                    "type": "string"
+                },
+                "@context": {
+                    "$ref": "https://schema.twindev.org/json-ld/JsonLdContextDefinitionRoot"
+                }
+            },
+            "required": [
+                "@type",
+                "@value"
+            ]
+        }
+    ]
+}

package/dist/es/utils/jsonLdHelper.js

@@ -0,0 +1,79 @@
+// Copyright 2024 IOTA Stiftung.
+// SPDX-License-Identifier: Apache-2.0.
+import { ArrayHelper, Guards, Is } from "@twin.org/core";
+import { DataTypeHelper } from "@twin.org/data-core";
+import { JsonLdProcessor } from "./jsonLdProcessor.js";
+/**
+ * Class to help with JSON LD.
+ */
+export class JsonLdHelper {
+    /**
+     * The class name.
+     * @internal
+     */
+    static CLASS_NAME = "JsonLdHelper";
+    /**
+     * Validate a JSON-LD document.
+     * @param document The JSON-LD document to validate.
+     * @param validationFailures The list of validation failures to add to.
+     * @param options Optional options for validation.
+     * @param options.failOnMissingType If true, will fail validation if the data type is missing, defaults to false.
+     * @param options.validationMode The validation mode to use, defaults to either.
+     * @returns True if the document was valid.
+     */
+    static async validate(document, validationFailures, options) {
+        if (Is.array(document)) {
+            // If the document is an array of nodes, validate each node
+            for (const node of document) {
+                await JsonLdHelper.validate(node, validationFailures, options);
+            }
+        }
+        else if (Is.array(document["@graph"])) {
+            // If the graph is an array of nodes, validate each node
+            for (const node of document["@graph"]) {
+                await JsonLdHelper.validate(node, validationFailures, options);
+            }
+        }
+        else if (Is.object(document)) {
+            // Expand the document to ensure we have the full context for types
+            // As the data types in the factories are always fully qualified
+            const expandedDocs = await JsonLdProcessor.expand(document);
+            if (Is.arrayValue(expandedDocs)) {
+                for (const expandedDoc of expandedDocs) {
+                    const expandedDataTypes = ArrayHelper.fromObjectOrArray(expandedDoc["@type"]);
+                    if (Is.arrayValue(expandedDataTypes)) {
+                        for (const expandedDataType of expandedDataTypes) {
+                            await DataTypeHelper.validate("document", expandedDataType, document, validationFailures, options);
+                        }
+                    }
+                }
+            }
+        }
+        return validationFailures.length === 0;
+    }
+    /**
+     * Expand the JSON-LD document and check if it is of a specific type.
+     * @param document The JSON-LD document to check.
+     * @param type The type to check for.
+     * @returns True if the document is of the specified type.
+     */
+    static async isType(document, type) {
+        Guards.object(JsonLdHelper.CLASS_NAME, "document", document);
+        Guards.arrayValue(JsonLdHelper.CLASS_NAME, "type", type);
+        const expanded = await JsonLdProcessor.expand(document);
+        if (Is.arrayValue(expanded)) {
+            for (const item of expanded) {
+                const types = ArrayHelper.fromObjectOrArray(item["@type"]);
+                if (Is.arrayValue(types)) {
+                    // All required types must be present in this item's @type array
+                    const itemTypes = new Set(types);
+                    if (type.every(t => itemTypes.has(t))) {
+                        return true;
+                    }
+                }
+            }
+        }
+        return false;
+    }
+}
+//# sourceMappingURL=jsonLdHelper.js.map

package/dist/es/utils/jsonLdHelper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonLdHelper.js","sourceRoot":"","sources":["../../../src/utils/jsonLdHelper.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright 2024 IOTA Stiftung.\n// SPDX-License-Identifier: Apache-2.0.\nimport { ArrayHelper, Guards, Is, type IValidationFailure } from \"@twin.org/core\";\nimport { DataTypeHelper, type ValidationMode } from \"@twin.org/data-core\";\nimport { nameof } from \"@twin.org/nameof\";\nimport { JsonLdProcessor } from \"./jsonLdProcessor.js\";\nimport type { IJsonLdDocument } from \"../models/IJsonLdDocument.js\";\nimport type { IJsonLdNodeObject } from \"../models/IJsonLdNodeObject.js\";\n\n/**\n * Class to help with JSON LD.\n */\nexport class JsonLdHelper {\n\t/**\n\t * The class name.\n\t * @internal\n\t */\n\tpublic static readonly CLASS_NAME = nameof<JsonLdHelper>();\n\n\t/**\n\t * Validate a JSON-LD document.\n\t * @param document The JSON-LD document to validate.\n\t * @param validationFailures The list of validation failures to add to.\n\t * @param options Optional options for validation.\n\t * @param options.failOnMissingType If true, will fail validation if the data type is missing, defaults to false.\n\t * @param options.validationMode The validation mode to use, defaults to either.\n\t * @returns True if the document was valid.\n\t */\n\tpublic static async validate<T extends IJsonLdDocument = IJsonLdDocument>(\n\t\tdocument: T,\n\t\tvalidationFailures: IValidationFailure[],\n\t\toptions?: {\n\t\t\tvalidationMode?: ValidationMode;\n\t\t\tfailOnMissingType?: boolean;\n\t\t}\n\t): Promise<boolean> {\n\t\tif (Is.array<IJsonLdNodeObject>(document)) {\n\t\t\t// If the document is an array of nodes, validate each node\n\t\t\tfor (const node of document) {\n\t\t\t\tawait JsonLdHelper.validate(node, validationFailures, options);\n\t\t\t}\n\t\t} else if (Is.array<IJsonLdNodeObject>(document[\"@graph\"])) {\n\t\t\t// If the graph is an array of nodes, validate each node\n\t\t\tfor (const node of document[\"@graph\"]) {\n\t\t\t\tawait JsonLdHelper.validate(node, validationFailures, options);\n\t\t\t}\n\t\t} else if (Is.object<IJsonLdNodeObject>(document)) {\n\t\t\t// Expand the document to ensure we have the full context for types\n\t\t\t// As the data types in the factories are always fully qualified\n\t\t\tconst expandedDocs = await JsonLdProcessor.expand(document);\n\t\t\tif (Is.arrayValue(expandedDocs)) {\n\t\t\t\tfor (const expandedDoc of expandedDocs) {\n\t\t\t\t\tconst expandedDataTypes = ArrayHelper.fromObjectOrArray(expandedDoc[\"@type\"]);\n\t\t\t\t\tif (Is.arrayValue(expandedDataTypes)) {\n\t\t\t\t\t\tfor (const expandedDataType of expandedDataTypes) {\n\t\t\t\t\t\t\tawait DataTypeHelper.validate(\n\t\t\t\t\t\t\t\t\"document\",\n\t\t\t\t\t\t\t\texpandedDataType,\n\t\t\t\t\t\t\t\tdocument,\n\t\t\t\t\t\t\t\tvalidationFailures,\n\t\t\t\t\t\t\t\toptions\n\t\t\t\t\t\t\t);\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\treturn validationFailures.length === 0;\n\t}\n\n\t/**\n\t * Expand the JSON-LD document and check if it is of a specific type.\n\t * @param document The JSON-LD document to check.\n\t * @param type The type to check for.\n\t * @returns True if the document is of the specified type.\n\t */\n\tpublic static async isType(document: IJsonLdDocument, type: string[]): Promise<boolean> {\n\t\tGuards.object<IJsonLdDocument>(JsonLdHelper.CLASS_NAME, nameof(document), document);\n\t\tGuards.arrayValue(JsonLdHelper.CLASS_NAME, nameof(type), type);\n\n\t\tconst expanded = await JsonLdProcessor.expand(document);\n\n\t\tif (Is.arrayValue(expanded)) {\n\t\t\tfor (const item of expanded) {\n\t\t\t\tconst types = ArrayHelper.fromObjectOrArray(item[\"@type\"]);\n\t\t\t\tif (Is.arrayValue(types)) {\n\t\t\t\t\t// All required types must be present in this item's @type array\n\t\t\t\t\tconst itemTypes = new Set(types);\n\t\t\t\t\tif (type.every(t => itemTypes.has(t))) {\n\t\t\t\t\t\treturn true;\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\treturn false;\n\t}\n}\n"]}