@twin.org/standards-dataspace-protocol 0.0.3-next.54 → 0.0.3-next.56

package/dist/es/schemas/DataspaceProtocolDatasetBase.json

@@ -0,0 +1,342 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "https://schema.twindev.org/dataspace-protocol/DataspaceProtocolDatasetBase",
+    "title": "DataspaceProtocolDatasetBase",
+    "description": "Dataset interface compliant with Eclipse Data Space Protocol.\n\nThis interface extends IDataset and enforces DS Protocol-specific requirements\nby overriding properties with more specific types and constraints.\n\n**Requirements per DS Protocol:**\n- `@id` MUST be present for dataset identification (REQUIRED)\n- `odrl:hasPolicy` MUST be present as an array of ODRL Offers (REQUIRED)\n- Array MUST contain at least one IOdrlOffer\n- Each Offer MUST have `@type`: \"Offer\"\n- Each Offer MUST have `@id`\n- `dcat:distribution` MUST be present (REQUIRED)\n\n**Type System Design:**\n- W3C DCAT spec defines `odrl:hasPolicy` as optional singular `IOdrlPolicy`\n- DS Protocol requires it as a REQUIRED array of `IOdrlOffer`\n- Interface extension allows TypeScript to override inherited property types\n- Standards packages (@twin.org/standards-w3c-*) follow W3C specs exactly\n- DS Protocol-specific constraints are defined here\n\n**Future Compatibility:**\n- Currently only one Offer per dataset is supported\n- Array structure allows future support for multiple offers",
+    "type": "object",
+    "properties": {
+        "@type": {
+            "const": "Dataset",
+            "description": "The type identifier for the dataset.\nREQUIRED per Eclipse Data Space Protocol."
+        },
+        "@id": {
+            "type": "string",
+            "description": "Unique identifier for the dataset.\nREQUIRED per Eclipse Data Space Protocol."
+        },
+        "hasPolicy": {
+            "anyOf": [
+                {
+                    "$ref": "https://schema.twindev.org/dataspace-protocol/DataspaceProtocolOfferBase"
+                },
+                {
+                    "type": "array",
+                    "items": {
+                        "$ref": "https://schema.twindev.org/dataspace-protocol/DataspaceProtocolOfferBase"
+                    }
+                }
+            ],
+            "description": "Array of ODRL policies (Offers) as required by DS Protocol.\n\nREQUIRED per Eclipse Data Space Protocol spec.\nMust contain at least one IOdrlOffer.\nCurrently only single offer is supported, but array structure\nallows for future multi-offer support."
+        },
+        "distribution": {
+            "anyOf": [
+                {
+                    "$ref": "https://schema.twindev.org/dataspace-protocol/DataspaceProtocolDistributionBase"
+                },
+                {
+                    "type": "array",
+                    "items": {
+                        "$ref": "https://schema.twindev.org/dataspace-protocol/DataspaceProtocolDistributionBase"
+                    }
+                }
+            ],
+            "description": "Distribution of the dataset.\nREQUIRED per Eclipse Data Space Protocol."
+        }
+    },
+    "required": [
+        "@type",
+        "@id",
+        "hasPolicy",
+        "distribution"
+    ],
+    "allOf": [
+        {
+            "description": "Base interface for DCAT Dataset without JSON-LD context.\nThis is the context-free variant of IDcatDataset, intended for embedding\ndataset objects inline within other objects where the context is provided by the enclosing document.",
+            "type": "object",
+            "properties": {
+                "@id": {
+                    "type": "string",
+                    "description": "The unique identifier for the resource.",
+                    "$comment": "Inherited from DcatResourceBase"
+                },
+                "dcterms:title": {
+                    "anyOf": [
+                        {
+                            "type": "string"
+                        },
+                        {
+                            "type": "array",
+                            "items": {
+                                "type": "string"
+                            }
+                        }
+                    ],
+                    "description": "A name given to the resource.",
+                    "$comment": "Inherited from DcatResourceBase"
+                },
+                "dcterms:description": {
+                    "anyOf": [
+                        {
+                            "type": "string"
+                        },
+                        {
+                            "type": "array",
+                            "items": {
+                                "type": "string"
+                            }
+                        }
+                    ],
+                    "description": "A free-text account of the resource.",
+                    "$comment": "Inherited from DcatResourceBase"
+                },
+                "dcterms:identifier": {
+                    "anyOf": [
+                        {
+                            "type": "string"
+                        },
+                        {
+                            "type": "array",
+                            "items": {
+                                "type": "string"
+                            }
+                        }
+                    ],
+                    "description": "A unique identifier of the resource.",
+                    "$comment": "Inherited from DcatResourceBase"
+                },
+                "dcterms:issued": {
+                    "type": "string",
+                    "description": "Date of formal issuance (publication) of the resource.",
+                    "format": "date-time",
+                    "$comment": "Inherited from DcatResourceBase"
+                },
+                "dcterms:modified": {
+                    "type": "string",
+                    "description": "Most recent date on which the resource was changed, updated or modified.",
+                    "format": "date-time",
+                    "$comment": "Inherited from DcatResourceBase"
+                },
+                "dcterms:language": {
+                    "anyOf": [
+                        {
+                            "type": "string"
+                        },
+                        {
+                            "type": "array",
+                            "items": {
+                                "type": "string"
+                            }
+                        }
+                    ],
+                    "description": "A language of the resource.",
+                    "$comment": "Inherited from DcatResourceBase"
+                },
+                "dcterms:publisher": {
+                    "anyOf": [
+                        {
+                            "$ref": "https://schema.twindev.org/dataspace-protocol/FoafAgentWithAliases"
+                        },
+                        {
+                            "type": "string"
+                        }
+                    ],
+                    "description": "An entity responsible for making the resource available.",
+                    "$comment": "Inherited from DcatResourceBase"
+                },
+                "dcterms:creator": {
+                    "anyOf": [
+                        {
+                            "$ref": "https://schema.twindev.org/dataspace-protocol/FoafAgentWithAliases"
+                        },
+                        {
+                            "type": "string"
+                        }
+                    ],
+                    "description": "An entity responsible for producing the resource.",
+                    "$comment": "Inherited from DcatResourceBase"
+                },
+                "dcterms:accessRights": {
+                    "anyOf": [
+                        {
+                            "$ref": "https://schema.twindev.org/json-ld/JsonLdNodeObject"
+                        },
+                        {
+                            "type": "string"
+                        }
+                    ],
+                    "description": "Information about who can access the resource or an indication of its security status.",
+                    "$comment": "Inherited from DcatResourceBase"
+                },
+                "dcterms:license": {
+                    "anyOf": [
+                        {
+                            "$ref": "https://schema.twindev.org/json-ld/JsonLdNodeObject"
+                        },
+                        {
+                            "type": "string"
+                        }
+                    ],
+                    "description": "A legal document under which the resource is made available.",
+                    "$comment": "Inherited from DcatResourceBase"
+                },
+                "dcterms:rights": {
+                    "anyOf": [
+                        {
+                            "$ref": "https://schema.twindev.org/json-ld/JsonLdNodeObject"
+                        },
+                        {
+                            "type": "string"
+                        }
+                    ],
+                    "description": "Information about rights held in and over the resource.",
+                    "$comment": "Inherited from DcatResourceBase"
+                },
+                "dcterms:conformsTo": {
+                    "anyOf": [
+                        {
+                            "type": "string"
+                        },
+                        {
+                            "type": "array",
+                            "items": {
+                                "type": "string"
+                            }
+                        }
+                    ],
+                    "description": "An established standard to which the resource conforms.",
+                    "$comment": "Inherited from DcatResourceBase"
+                },
+                "dcterms:type": {
+                    "type": "string",
+                    "description": "The nature or genre of the resource.",
+                    "$comment": "Inherited from DcatResourceBase"
+                },
+                "dcat:contactPoint": {
+                    "anyOf": [
+                        {
+                            "$ref": "https://schema.twindev.org/json-ld/JsonLdNodeObject"
+                        },
+                        {
+                            "type": "string"
+                        }
+                    ],
+                    "description": "Relevant contact information for the catalogued resource.",
+                    "$comment": "Inherited from DcatResourceBase"
+                },
+                "dcat:keyword": {
+                    "anyOf": [
+                        {
+                            "type": "string"
+                        },
+                        {
+                            "type": "array",
+                            "items": {
+                                "type": "string"
+                            }
+                        }
+                    ],
+                    "description": "A keyword or tag describing the resource.",
+                    "$comment": "Inherited from DcatResourceBase"
+                },
+                "dcat:theme": {
+                    "anyOf": [
+                        {
+                            "type": "string"
+                        },
+                        {
+                            "type": "array",
+                            "items": {
+                                "type": "string"
+                            }
+                        }
+                    ],
+                    "description": "A main category of the resource. A resource can have multiple themes.",
+                    "$comment": "Inherited from DcatResourceBase"
+                },
+                "dcat:landingPage": {
+                    "anyOf": [
+                        {
+                            "type": "string"
+                        },
+                        {
+                            "type": "array",
+                            "items": {
+                                "type": "string"
+                            }
+                        }
+                    ],
+                    "description": "A Web page that can be navigated to gain access to the resource.",
+                    "$comment": "Inherited from DcatResourceBase"
+                },
+                "dcat:qualifiedRelation": {
+                    "anyOf": [
+                        {
+                            "$ref": "https://schema.twindev.org/dataspace-protocol/DcatRelationship"
+                        },
+                        {
+                            "type": "string"
+                        }
+                    ],
+                    "description": "Link to a description of a relationship with another resource.",
+                    "$comment": "Inherited from DcatResourceBase"
+                },
+                "dcterms:accrualPeriodicity": {
+                    "type": "string",
+                    "description": "The frequency at which the dataset is published.",
+                    "$comment": "Inherited from DcatDatasetBase"
+                },
+                "dcat:inSeries": {
+                    "type": "string",
+                    "description": "A dataset series of which the dataset is part.",
+                    "$comment": "Inherited from DcatDatasetBase"
+                },
+                "dcterms:spatial": {
+                    "anyOf": [
+                        {
+                            "$ref": "https://schema.twindev.org/json-ld/JsonLdNodeObject"
+                        },
+                        {
+                            "type": "string"
+                        },
+                        {
+                            "type": "array",
+                            "items": {
+                                "type": "string"
+                            }
+                        }
+                    ],
+                    "description": "The geographical area covered by the dataset.",
+                    "$comment": "Inherited from DcatDatasetBase"
+                },
+                "dcat:spatialResolutionInMeters": {
+                    "type": "number",
+                    "description": "Minimum spatial separation resolvable in a dataset, measured in meters.",
+                    "$comment": "Inherited from DcatDatasetBase"
+                },
+                "dcterms:temporal": {
+                    "$ref": "https://schema.twindev.org/dataspace-protocol/DublinCorePeriodOfTime",
+                    "description": "The temporal period that the dataset covers.",
+                    "$comment": "Inherited from DcatDatasetBase"
+                },
+                "dcat:temporalResolution": {
+                    "type": "string",
+                    "description": "Minimum time period resolvable in the dataset.",
+                    "format": "duration",
+                    "$comment": "Inherited from DcatDatasetBase"
+                },
+                "prov:wasGeneratedBy": {
+                    "anyOf": [
+                        {
+                            "$ref": "https://schema.twindev.org/json-ld/JsonLdNodeObject"
+                        },
+                        {
+                            "type": "string"
+                        }
+                    ],
+                    "description": "An activity that generated, or provides the business context for, the creation of the dataset.",
+                    "$comment": "Inherited from DcatDatasetBase"
+                }
+            },
+            "$comment": "Inlined utility base type DcatDatasetBase so utility transformations can operate on concrete properties instead of a $ref."
+        }
+    ]
+}

package/dist/es/schemas/DataspaceProtocolDatasetRequestMessage.json

@@ -1,61 +1,15 @@
 {
     "$schema": "https://json-schema.org/draft/2020-12/schema",
     "$id": "https://schema.twindev.org/dataspace-protocol/DataspaceProtocolDatasetRequestMessage",
-    "description": "Interface for Dataspace Protocol Dataset Request Messages. https://eclipse-dataspace-protocol-base.github.io/DataspaceProtocol/2025-1/#dataset-request-message",
+    "title": "DataspaceProtocolDatasetRequestMessage",
+    "description": "Interface for Dataspace Protocol Dataset Request Messages.\nhttps://eclipse-dataspace-protocol-base.github.io/DataspaceProtocol/2025-1/#dataset-request-message",
     "type": "object",
     "properties": {
         "@context": {
-            "description": "The Dataspace Protocol JSON-LD context type.",
-            "anyOf": [
-                {
-                    "type": "string",
-                    "const": "https://w3id.org/dspace/2025/1/context.jsonld"
-                },
-                {
-                    "type": "array",
-                    "items": {
-                        "type": "string",
-                        "const": "https://w3id.org/dspace/2025/1/context.jsonld"
-                    },
-                    "minItems": 1,
-                    "maxItems": 1
-                },
-                {
-                    "type": "array",
-                    "minItems": 2,
-                    "prefixItems": [
-                        {
-                            "type": "string",
-                            "const": "https://w3id.org/dspace/2025/1/context.jsonld"
-                        },
-                        {
-                            "$ref": "https://schema.twindev.org/json-ld/JsonLdContextDefinitionElement"
-                        }
-                    ],
-                    "items": {
-                        "$ref": "https://schema.twindev.org/json-ld/JsonLdContextDefinitionElement"
-                    }
-                },
-                {
-                    "type": "array",
-                    "minItems": 2,
-                    "prefixItems": [
-                        {
-                            "$ref": "https://schema.twindev.org/json-ld/JsonLdContextDefinitionElement"
-                        },
-                        {
-                            "type": "string",
-                            "const": "https://w3id.org/dspace/2025/1/context.jsonld"
-                        }
-                    ],
-                    "items": {
-                        "$ref": "https://schema.twindev.org/json-ld/JsonLdContextDefinitionElement"
-                    }
-                }
-            ]
+            "$ref": "https://schema.twindev.org/dataspace-protocol/DataspaceProtocolContextType",
+            "description": "The JSON-LD context."
         },
         "@type": {
-            "type": "string",
             "const": "DatasetRequestMessage",
             "description": "The type of the message."
         },

package/dist/es/schemas/DataspaceProtocolDistribution.json

@@ -0,0 +1,26 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "https://schema.twindev.org/dataspace-protocol/DataspaceProtocolDistribution",
+    "title": "DataspaceProtocolDistribution",
+    "description": "Distribution interface compliant with Eclipse Data Space Protocol.\n\nThis interface extends IDistribution and enforces DS Protocol-specific requirements\nby overriding properties with more specific types and constraints.\n\n**Requirements per DS Protocol:**\n- `@id` MUST be present for dataset identification (REQUIRED)\n- `odrl:hasPolicy` MIGHT be present as an array of ODRL Offers (OPTIONAL)\n- Array MUST contain at least one IOdrlOffer\n- Each Offer MUST have `@type`: \"Offer\"\n- `format` is REQUIRED.\n\n**Type System Design:**\n- W3C DCAT spec defines `odrl:hasPolicy` as optional singular `IOdrlPolicy`\n- DS Protocol requires it as a REQUIRED array of `IOdrlOffer`\n- Interface extension allows TypeScript to override inherited property types\n- Standards packages (@twin.org/standards-w3c-*) follow W3C specs exactly\n- DS Protocol-specific constraints are defined here\n\n**Future Compatibility:**\n- Currently only one Offer per dataset is supported\n- Array structure allows future support for multiple offers",
+    "type": "object",
+    "properties": {
+        "@context": {
+            "$ref": "https://schema.twindev.org/dataspace-protocol/DataspaceProtocolContextType",
+            "description": "LD Context. Required per Eclipse Data Space Protocol."
+        },
+        "@id": {
+            "type": "string",
+            "description": "Unique identifier for the distribution.\nREQUIRED on standalone Distribution objects per Eclipse Data Space Protocol."
+        }
+    },
+    "required": [
+        "@context",
+        "@id"
+    ],
+    "allOf": [
+        {
+            "$ref": "https://schema.twindev.org/dataspace-protocol/DataspaceProtocolDistributionBase"
+        }
+    ]
+}

package/dist/es/schemas/DataspaceProtocolDistributionBase.json

@@ -0,0 +1,170 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "https://schema.twindev.org/dataspace-protocol/DataspaceProtocolDistributionBase",
+    "title": "DataspaceProtocolDistributionBase",
+    "description": "Distribution interface compliant with Eclipse Data Space Protocol.\n\nThis interface extends IDistribution and enforces DS Protocol-specific requirements\nby overriding properties with more specific types and constraints.\n\n**Requirements per DS Protocol:**\n- `@id` MUST be present for dataset identification (REQUIRED)\n- `odrl:hasPolicy` MIGHT be present as an array of ODRL Offers (OPTIONAL)\n- Array MUST contain at least one IOdrlOffer\n- Each Offer MUST have `@type`: \"Offer\"\n- `format` is REQUIRED.\n\n**Type System Design:**\n- W3C DCAT spec defines `odrl:hasPolicy` as optional singular `IOdrlPolicy`\n- DS Protocol requires it as a REQUIRED array of `IOdrlOffer`\n- Interface extension allows TypeScript to override inherited property types\n- Standards packages (@twin.org/standards-w3c-*) follow W3C specs exactly\n- DS Protocol-specific constraints are defined here\n\n**Future Compatibility:**\n- Currently only one Offer per dataset is supported\n- Array structure allows future support for multiple offers",
+    "type": "object",
+    "properties": {
+        "@type": {
+            "const": "Distribution",
+            "description": "The type identifier for the Distribution.\nREQUIRED per Eclipse Data Space Protocol."
+        },
+        "@id": {
+            "type": "string",
+            "description": "Unique identifier for the distribution.\nOPTIONAL for embedded distributions (may use JSON-LD blank nodes).\nREQUIRED on standalone Distribution objects per Eclipse Data Space Protocol."
+        },
+        "hasPolicy": {
+            "anyOf": [
+                {
+                    "$ref": "https://schema.twindev.org/dataspace-protocol/DataspaceProtocolOfferBase"
+                },
+                {
+                    "type": "array",
+                    "items": {
+                        "$ref": "https://schema.twindev.org/dataspace-protocol/DataspaceProtocolOfferBase"
+                    }
+                }
+            ],
+            "description": "Array of ODRL policies (Offers) as required by DS Protocol.\n\nREQUIRED per Eclipse Data Space Protocol spec.\nMust contain at least one IOdrlOffer.\nCurrently only single offer is supported, but array structure\nallows for future multi-offer support."
+        },
+        "accessService": {
+            "anyOf": [
+                {
+                    "type": "string"
+                },
+                {
+                    "$ref": "https://schema.twindev.org/dataspace-protocol/DataspaceProtocolDataServiceBase"
+                }
+            ],
+            "description": "Access service.\nIt can be a URI pointing to an access service or inline the access service itself."
+        },
+        "format": {
+            "type": "string",
+            "description": "Distribution format.\nREQUIRED per Eclipse Data Space Protocol."
+        }
+    },
+    "required": [
+        "@type",
+        "accessService",
+        "format"
+    ],
+    "allOf": [
+        {
+            "description": "Base interface for DCAT Distribution without JSON-LD context.\nThis is the context-free variant of IDcatDistribution, intended for embedding\ndistribution objects inline within datasets where the context is provided by the enclosing document.",
+            "type": "object",
+            "properties": {
+                "@id": {
+                    "type": "string",
+                    "description": "The unique identifier for the distribution object."
+                },
+                "dcterms:title": {
+                    "anyOf": [
+                        {
+                            "type": "string"
+                        },
+                        {
+                            "type": "array",
+                            "items": {
+                                "type": "string"
+                            }
+                        }
+                    ],
+                    "description": "A name given to the distribution."
+                },
+                "dcterms:description": {
+                    "anyOf": [
+                        {
+                            "type": "string"
+                        },
+                        {
+                            "type": "array",
+                            "items": {
+                                "type": "string"
+                            }
+                        }
+                    ],
+                    "description": "A free-text account of the distribution."
+                },
+                "dcterms:issued": {
+                    "type": "string",
+                    "description": "Date of formal issuance of the distribution.",
+                    "format": "date-time"
+                },
+                "dcterms:modified": {
+                    "type": "string",
+                    "description": "Most recent date on which the distribution was changed, updated or modified.",
+                    "format": "date-time"
+                },
+                "dcterms:license": {
+                    "type": "string",
+                    "description": "A legal document under which the distribution is made available."
+                },
+                "dcterms:accessRights": {
+                    "type": "string",
+                    "description": "Information about who can access the distribution."
+                },
+                "dcterms:rights": {
+                    "type": "string",
+                    "description": "Information about rights held in and over the distribution."
+                },
+                "dcat:accessURL": {
+                    "type": "string",
+                    "description": "A URL of the resource that gives access to a distribution of the dataset."
+                },
+                "dcat:accessService": {
+                    "type": "string",
+                    "description": "A data service that gives access to the distribution."
+                },
+                "dcat:downloadURL": {
+                    "type": "string",
+                    "description": "The URL of the downloadable file in a given format."
+                },
+                "dcat:byteSize": {
+                    "type": "number",
+                    "description": "The size of the distribution in bytes.",
+                    "minimum": 0
+                },
+                "dcat:spatialResolutionInMeters": {
+                    "type": "number",
+                    "description": "The minimum spatial separation resolvable in a distribution, measured in meters."
+                },
+                "dcat:temporalResolution": {
+                    "type": "string",
+                    "description": "Minimum time period resolvable in the distribution.",
+                    "format": "duration"
+                },
+                "dcterms:conformsTo": {
+                    "anyOf": [
+                        {
+                            "type": "string"
+                        },
+                        {
+                            "type": "array",
+                            "items": {
+                                "type": "string"
+                            }
+                        }
+                    ],
+                    "description": "An established standard to which the distribution conforms."
+                },
+                "dcat:mediaType": {
+                    "type": "string",
+                    "description": "The media type of the distribution as defined by IANA."
+                },
+                "dcat:compressFormat": {
+                    "type": "string",
+                    "description": "The compression format of the distribution."
+                },
+                "dcat:packageFormat": {
+                    "type": "string",
+                    "description": "The package format of the distribution."
+                },
+                "spdx:checksum": {
+                    "type": "string",
+                    "description": "The checksum property provides a mechanism to verify the data integrity."
+                }
+            },
+            "$comment": "Inlined utility base type DcatDistributionBase so utility transformations can operate on concrete properties instead of a $ref."
+        }
+    ]
+}

package/dist/es/schemas/DataspaceProtocolEndpointProperty.json

@@ -1,11 +1,11 @@
 {
     "$schema": "https://json-schema.org/draft/2020-12/schema",
     "$id": "https://schema.twindev.org/dataspace-protocol/DataspaceProtocolEndpointProperty",
-    "description": "Interface for Dataspace Protocol Transfer Messages. https://eclipse-dataspace-protocol-base.github.io/DataspaceProtocol/#lower-level-types",
+    "title": "DataspaceProtocolEndpointProperty",
+    "description": "Interface for Dataspace Protocol Transfer Messages.\nhttps://eclipse-dataspace-protocol-base.github.io/DataspaceProtocol/#lower-level-types",
     "type": "object",
     "properties": {
         "@type": {
-            "type": "string",
             "const": "EndpointProperty",
             "description": "LD Type."
         },