@twin.org/standards-dataspace-protocol 0.0.3-next.53 → 0.0.3-next.55

package/dist/es/schemas/DataspaceProtocolContractNegotiationTerminationMessage.json

@@ -1,61 +1,15 @@
 {
     "$schema": "https://json-schema.org/draft/2020-12/schema",
     "$id": "https://schema.twindev.org/dataspace-protocol/DataspaceProtocolContractNegotiationTerminationMessage",
-    "description": "Interface for Dataspace Protocol Contract Negotiation Termination Messages. https://eclipse-dataspace-protocol-base.github.io/DataspaceProtocol/2025-1/#contract-negotiation-termination-message",
+    "title": "DataspaceProtocolContractNegotiationTerminationMessage",
+    "description": "Interface for Dataspace Protocol Contract Negotiation Termination Messages.\nhttps://eclipse-dataspace-protocol-base.github.io/DataspaceProtocol/2025-1/#contract-negotiation-termination-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": "ContractNegotiationTerminationMessage",
             "description": "The type of the message."
         },

package/dist/es/schemas/DataspaceProtocolContractOfferMessage.json

@@ -1,61 +1,15 @@
 {
     "$schema": "https://json-schema.org/draft/2020-12/schema",
     "$id": "https://schema.twindev.org/dataspace-protocol/DataspaceProtocolContractOfferMessage",
-    "description": "Interface for Dataspace Protocol Contract Offer Messages. https://eclipse-dataspace-protocol-base.github.io/DataspaceProtocol/2025-1/#contract-offer-message",
+    "title": "DataspaceProtocolContractOfferMessage",
+    "description": "Interface for Dataspace Protocol Contract Offer Messages.\nhttps://eclipse-dataspace-protocol-base.github.io/DataspaceProtocol/2025-1/#contract-offer-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": "ContractOfferMessage",
             "description": "The type of the message."
         },
@@ -68,7 +22,7 @@
             "description": "The consumer id for the contract."
         },
         "offer": {
-            "$ref": "https://schema.twindev.org/dataspace-protocol/DataspaceProtocolOfferNoContext",
+            "$ref": "https://schema.twindev.org/dataspace-protocol/DataspaceProtocolOfferBase",
             "description": "The offer being requested."
         },
         "callbackAddress": {

package/dist/es/schemas/DataspaceProtocolContractRequestMessage.json

@@ -1,61 +1,15 @@
 {
     "$schema": "https://json-schema.org/draft/2020-12/schema",
     "$id": "https://schema.twindev.org/dataspace-protocol/DataspaceProtocolContractRequestMessage",
-    "description": "Interface for Dataspace Protocol Contract Request Messages. https://eclipse-dataspace-protocol-base.github.io/DataspaceProtocol/2025-1/#contract-request-message",
+    "title": "DataspaceProtocolContractRequestMessage",
+    "description": "Interface for Dataspace Protocol Contract Request Messages.\nhttps://eclipse-dataspace-protocol-base.github.io/DataspaceProtocol/2025-1/#contract-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": "ContractRequestMessage",
             "description": "The type of the message."
         },
@@ -68,7 +22,7 @@
             "description": "The consumer id for the contract."
         },
         "offer": {
-            "$ref": "https://schema.twindev.org/dataspace-protocol/DataspaceProtocolOfferNoContext",
+            "$ref": "https://schema.twindev.org/dataspace-protocol/DataspaceProtocolOfferBase",
             "description": "The offer being requested."
         },
         "callbackAddress": {

package/dist/es/schemas/DataspaceProtocolDataAddress.json

@@ -1,11 +1,11 @@
 {
     "$schema": "https://json-schema.org/draft/2020-12/schema",
     "$id": "https://schema.twindev.org/dataspace-protocol/DataspaceProtocolDataAddress",
-    "description": "Interface for Dataspace Protocol Transfer Messages. https://eclipse-dataspace-protocol-base.github.io/DataspaceProtocol/#lower-level-types",
+    "title": "DataspaceProtocolDataAddress",
+    "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": "DataAddress",
             "description": "LD Type"
         },

package/dist/es/schemas/DataspaceProtocolDataService.json

@@ -0,0 +1,21 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "https://schema.twindev.org/dataspace-protocol/DataspaceProtocolDataService",
+    "title": "DataspaceProtocolDataService",
+    "description": "Data Service interface compliant with Eclipse Data Space Protocol.\n\nThis interface extends IDataService 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- endpointURL MUST be present (REQUIRED)\n\n**Type System Design:**\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",
+    "type": "object",
+    "properties": {
+        "@context": {
+            "$ref": "https://schema.twindev.org/dataspace-protocol/DataspaceProtocolContextType",
+            "description": "LD Context. Required per Eclipse Data Space Protocol."
+        }
+    },
+    "required": [
+        "@context"
+    ],
+    "allOf": [
+        {
+            "$ref": "https://schema.twindev.org/dataspace-protocol/DataspaceProtocolDataServiceBase"
+        }
+    ]
+}

package/dist/es/schemas/DataspaceProtocolDataServiceBase.json

@@ -0,0 +1,285 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "https://schema.twindev.org/dataspace-protocol/DataspaceProtocolDataServiceBase",
+    "title": "DataspaceProtocolDataServiceBase",
+    "description": "Data Service interface compliant with Eclipse Data Space Protocol.\n\nThis interface extends IDataService 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- endpointURL MUST be present (REQUIRED)\n\n**Type System Design:**\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",
+    "type": "object",
+    "properties": {
+        "@type": {
+            "const": "DataService",
+            "description": "The type identifier for the Data Service.\nREQUIRED per Eclipse Data Space Protocol."
+        },
+        "@id": {
+            "type": "string",
+            "description": "Unique identifier for the dataset.\nREQUIRED per Eclipse Data Space Protocol."
+        },
+        "endpointURL": {
+            "type": "string",
+            "description": "Endpoint URL."
+        },
+        "servesDataset": {
+            "anyOf": [
+                {
+                    "$ref": "https://schema.twindev.org/dataspace-protocol/DataspaceProtocolDatasetBase"
+                },
+                {
+                    "type": "array",
+                    "items": {
+                        "$ref": "https://schema.twindev.org/dataspace-protocol/DataspaceProtocolDatasetBase"
+                    }
+                }
+            ],
+            "description": "Datasets served."
+        }
+    },
+    "required": [
+        "@type",
+        "@id",
+        "endpointURL"
+    ],
+    "allOf": [
+        {
+            "description": "Base interface for DCAT Data Service without JSON-LD context.\nThis is the context-free variant of IDcatDataService, intended for embedding\ndata service 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"
+                },
+                "odrl:hasPolicy": {
+                    "$ref": "https://schema.twindev.org/w3c-odrl/OdrlPolicy",
+                    "description": "An ODRL conformant policy expressing the rights associated with the resource.",
+                    "$comment": "Inherited from DcatResourceBase"
+                },
+                "dcat:endpointDescription": {
+                    "type": "string",
+                    "description": "A description of the services available via the end-points, including their\noperations, parameters, etc.",
+                    "$comment": "Inherited from DcatDataServiceBase"
+                }
+            },
+            "$comment": "Inlined utility base type DcatDataServiceBase so utility transformations can operate on concrete properties instead of a $ref."
+        }
+    ]
+}

package/dist/es/schemas/DataspaceProtocolDataset.json

@@ -1,11 +1,21 @@
 {
-    "$schema": "https://json-schema.org/draft/2019-09/schema",
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
     "$id": "https://schema.twindev.org/dataspace-protocol/DataspaceProtocolDataset",
-    "description": "Dataset compliant with Eclipse Data Space Protocol. Validates only DS Protocol-specific requirements while allowing all optional DCAT properties.",
     "title": "DataspaceProtocolDataset",
+    "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": {
+        "@context": {
+            "$ref": "https://schema.twindev.org/dataspace-protocol/DataspaceProtocolContextType",
+            "description": "LD Context. Required per Eclipse Data Space Protocol."
+        }
+    },
+    "required": [
+        "@context"
+    ],
     "allOf": [
         {
-            "$ref": "https://w3id.org/dspace/2025/1/catalog/dataset-schema.json"
+            "$ref": "https://schema.twindev.org/dataspace-protocol/DataspaceProtocolDatasetBase"
         }
     ]
 }