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

package/dist/es/schemas/DataspaceProtocolPolicy.json

@@ -1,219 +1,231 @@
 {
     "$schema": "https://json-schema.org/draft/2020-12/schema",
     "$id": "https://schema.twindev.org/dataspace-protocol/DataspaceProtocolPolicy",
+    "title": "DataspaceProtocolPolicy",
     "description": "Policy interface compliant with Eclipse Data Space Protocol.\n\nExtends IOdrlPolicy with DS Protocol-specific constraints:\n- `@id` is REQUIRED (used as the primary policy identifier in DS Protocol)\n- `@context` is omitted (inherited from the parent Dataset/Distribution)",
     "type": "object",
     "properties": {
-        "@context": {
-            "$ref": "https://schema.twindev.org/w3c-odrl/OdrlContextType",
-            "description": "The context for the policy. Must include \"https://www.w3.org/ns/odrl.jsonld\""
-        },
-        "@type": {
-            "$ref": "https://schema.twindev.org/w3c-odrl/PolicyType",
-            "description": "The type of policy. Must be one of: \"Set\", \"Offer\", \"Agreement\""
-        },
-        "profile": {
-            "anyOf": [
-                {
-                    "type": "string"
-                },
-                {
-                    "type": "array",
-                    "items": {
-                        "type": "string"
-                    }
-                }
-            ],
-            "description": "The profile(s) this policy conforms to. IRIs identifying the ODRL Profile(s)."
-        },
-        "assigner": {
-            "anyOf": [
-                {
-                    "type": "string"
-                },
-                {
-                    "$ref": "https://schema.twindev.org/w3c-odrl/OdrlParty"
-                },
-                {
-                    "$ref": "https://schema.twindev.org/w3c-odrl/OdrlPartyCollection"
-                },
-                {
-                    "type": "array",
-                    "items": {
-                        "anyOf": [
-                            {
+        "@id": {
+            "type": "string",
+            "description": "Unique identifier for the policy."
+        }
+    },
+    "required": [
+        "@id"
+    ],
+    "allOf": [
+        {
+            "description": "Interface representing an ODRL Policy.\nhttps://www.w3.org/TR/odrl-model/#policy",
+            "type": "object",
+            "properties": {
+                "@context": {
+                    "$ref": "https://schema.twindev.org/w3c-odrl/OdrlContextType",
+                    "description": "The context for the policy.\nMust include \"https://www.w3.org/ns/odrl.jsonld\""
+                },
+                "@type": {
+                    "$ref": "https://schema.twindev.org/w3c-odrl/OdrlPolicyType",
+                    "description": "The type of policy.\nMust be one of: \"Set\", \"Offer\", \"Agreement\""
+                },
+                "profile": {
+                    "anyOf": [
+                        {
+                            "type": "string"
+                        },
+                        {
+                            "type": "array",
+                            "items": {
                                 "type": "string"
-                            },
-                            {
-                                "$ref": "https://schema.twindev.org/w3c-odrl/OdrlParty"
-                            },
-                            {
-                                "$ref": "https://schema.twindev.org/w3c-odrl/OdrlPartyCollection"
                             }
-                        ]
-                    }
-                }
-            ],
-            "description": "The assigner of the policy. Applies to all rules unless overridden at rule level."
-        },
-        "assignee": {
-            "anyOf": [
-                {
-                    "type": "string"
-                },
-                {
-                    "$ref": "https://schema.twindev.org/w3c-odrl/OdrlParty"
-                },
-                {
-                    "$ref": "https://schema.twindev.org/w3c-odrl/OdrlPartyCollection"
-                },
-                {
-                    "type": "array",
-                    "items": {
-                        "anyOf": [
-                            {
-                                "type": "string"
-                            },
-                            {
-                                "$ref": "https://schema.twindev.org/w3c-odrl/OdrlParty"
-                            },
-                            {
-                                "$ref": "https://schema.twindev.org/w3c-odrl/OdrlPartyCollection"
+                        }
+                    ],
+                    "description": "The profile(s) this policy conforms to.\nIRIs identifying the ODRL Profile(s)."
+                },
+                "assigner": {
+                    "anyOf": [
+                        {
+                            "type": "string"
+                        },
+                        {
+                            "$ref": "https://schema.twindev.org/w3c-odrl/OdrlParty"
+                        },
+                        {
+                            "$ref": "https://schema.twindev.org/w3c-odrl/OdrlPartyCollection"
+                        },
+                        {
+                            "type": "array",
+                            "items": {
+                                "anyOf": [
+                                    {
+                                        "type": "string"
+                                    },
+                                    {
+                                        "$ref": "https://schema.twindev.org/w3c-odrl/OdrlParty"
+                                    },
+                                    {
+                                        "$ref": "https://schema.twindev.org/w3c-odrl/OdrlPartyCollection"
+                                    }
+                                ]
                             }
-                        ]
-                    }
-                }
-            ],
-            "description": "The assignee of the policy. Applies to all rules unless overridden at rule level."
-        },
-        "target": {
-            "anyOf": [
-                {
-                    "type": "string"
-                },
-                {
-                    "$ref": "https://schema.twindev.org/w3c-odrl/OdrlAsset"
-                },
-                {
-                    "$ref": "https://schema.twindev.org/w3c-odrl/OdrlAssetCollection"
-                },
-                {
-                    "type": "array",
-                    "items": {
-                        "anyOf": [
-                            {
-                                "type": "string"
-                            },
-                            {
-                                "$ref": "https://schema.twindev.org/w3c-odrl/OdrlAsset"
-                            },
-                            {
-                                "$ref": "https://schema.twindev.org/w3c-odrl/OdrlAssetCollection"
+                        }
+                    ],
+                    "description": "The assigner of the policy.\nApplies to all rules unless overridden at rule level."
+                },
+                "assignee": {
+                    "anyOf": [
+                        {
+                            "type": "string"
+                        },
+                        {
+                            "$ref": "https://schema.twindev.org/w3c-odrl/OdrlParty"
+                        },
+                        {
+                            "$ref": "https://schema.twindev.org/w3c-odrl/OdrlPartyCollection"
+                        },
+                        {
+                            "type": "array",
+                            "items": {
+                                "anyOf": [
+                                    {
+                                        "type": "string"
+                                    },
+                                    {
+                                        "$ref": "https://schema.twindev.org/w3c-odrl/OdrlParty"
+                                    },
+                                    {
+                                        "$ref": "https://schema.twindev.org/w3c-odrl/OdrlPartyCollection"
+                                    }
+                                ]
                             }
-                        ]
-                    }
-                }
-            ],
-            "description": "The target asset for the rule."
-        },
-        "action": {
-            "anyOf": [
-                {
-                    "$ref": "https://schema.twindev.org/w3c-odrl/ActionType"
-                },
-                {
-                    "type": "string"
-                },
-                {
-                    "$ref": "https://schema.twindev.org/w3c-odrl/OdrlAction"
-                },
-                {
-                    "type": "array",
-                    "items": {
-                        "anyOf": [
-                            {
-                                "$ref": "https://schema.twindev.org/w3c-odrl/ActionType"
-                            },
-                            {
+                        }
+                    ],
+                    "description": "The assignee of the policy.\nApplies to all rules unless overridden at rule level."
+                },
+                "target": {
+                    "anyOf": [
+                        {
+                            "type": "string"
+                        },
+                        {
+                            "$ref": "https://schema.twindev.org/w3c-odrl/OdrlAsset"
+                        },
+                        {
+                            "$ref": "https://schema.twindev.org/w3c-odrl/OdrlAssetCollection"
+                        },
+                        {
+                            "type": "array",
+                            "items": {
+                                "anyOf": [
+                                    {
+                                        "type": "string"
+                                    },
+                                    {
+                                        "$ref": "https://schema.twindev.org/w3c-odrl/OdrlAsset"
+                                    },
+                                    {
+                                        "$ref": "https://schema.twindev.org/w3c-odrl/OdrlAssetCollection"
+                                    }
+                                ]
+                            }
+                        }
+                    ],
+                    "description": "The target asset for the rule."
+                },
+                "action": {
+                    "anyOf": [
+                        {
+                            "$ref": "https://schema.twindev.org/w3c-odrl/OdrlActionType"
+                        },
+                        {
+                            "type": "string"
+                        },
+                        {
+                            "$ref": "https://schema.twindev.org/w3c-odrl/OdrlAction"
+                        },
+                        {
+                            "type": "array",
+                            "items": {
+                                "anyOf": [
+                                    {
+                                        "$ref": "https://schema.twindev.org/w3c-odrl/OdrlActionType"
+                                    },
+                                    {
+                                        "type": "string"
+                                    },
+                                    {
+                                        "$ref": "https://schema.twindev.org/w3c-odrl/OdrlAction"
+                                    }
+                                ]
+                            }
+                        }
+                    ],
+                    "description": "The action associated with the rule."
+                },
+                "inheritFrom": {
+                    "anyOf": [
+                        {
+                            "type": "string"
+                        },
+                        {
+                            "type": "array",
+                            "items": {
                                 "type": "string"
-                            },
-                            {
-                                "$ref": "https://schema.twindev.org/w3c-odrl/OdrlAction"
                             }
-                        ]
-                    }
-                }
-            ],
-            "description": "The action associated with the rule."
-        },
-        "inheritFrom": {
-            "anyOf": [
-                {
-                    "type": "string"
-                },
-                {
-                    "type": "array",
-                    "items": {
-                        "type": "string"
-                    }
-                }
-            ],
-            "description": "The parent policy(ies) this policy inherits from. IRIs identifying the parent Policy(ies)."
-        },
-        "conflict": {
-            "$ref": "https://schema.twindev.org/w3c-odrl/ConflictStrategyType",
-            "description": "The conflict resolution strategy.\n- perm: Permissions override Prohibitions\n- prohibit: Prohibitions override Permissions\n- invalid: Policy is void if conflicts exist (default)"
-        },
-        "permission": {
-            "anyOf": [
-                {
-                    "$ref": "https://schema.twindev.org/w3c-odrl/OdrlPermission"
-                },
-                {
-                    "type": "array",
-                    "items": {
-                        "$ref": "https://schema.twindev.org/w3c-odrl/OdrlPermission"
-                    }
-                }
-            ],
-            "description": "The permissions in the policy. At least one of permission, prohibition, or obligation must be present."
-        },
-        "prohibition": {
-            "anyOf": [
-                {
-                    "$ref": "https://schema.twindev.org/w3c-odrl/OdrlProhibition"
-                },
-                {
-                    "type": "array",
-                    "items": {
-                        "$ref": "https://schema.twindev.org/w3c-odrl/OdrlProhibition"
-                    }
-                }
-            ],
-            "description": "The prohibitions in the policy. At least one of permission, prohibition, or obligation must be present."
-        },
-        "obligation": {
-            "anyOf": [
-                {
-                    "$ref": "https://schema.twindev.org/w3c-odrl/OdrlDuty"
-                },
-                {
-                    "type": "array",
-                    "items": {
-                        "$ref": "https://schema.twindev.org/w3c-odrl/OdrlDuty"
-                    }
+                        }
+                    ],
+                    "description": "The parent policy(ies) this policy inherits from.\nIRIs identifying the parent Policy(ies)."
+                },
+                "conflict": {
+                    "$ref": "https://schema.twindev.org/w3c-odrl/OdrlConflictStrategyType",
+                    "description": "The conflict resolution strategy.\n- perm: Permissions override Prohibitions\n- prohibit: Prohibitions override Permissions\n- invalid: Policy is void if conflicts exist (default)"
+                },
+                "permission": {
+                    "anyOf": [
+                        {
+                            "$ref": "https://schema.twindev.org/w3c-odrl/OdrlPermission"
+                        },
+                        {
+                            "type": "array",
+                            "items": {
+                                "$ref": "https://schema.twindev.org/w3c-odrl/OdrlPermission"
+                            }
+                        }
+                    ],
+                    "description": "The permissions in the policy.\nAt least one of permission, prohibition, or obligation must be present."
+                },
+                "prohibition": {
+                    "anyOf": [
+                        {
+                            "$ref": "https://schema.twindev.org/w3c-odrl/OdrlProhibition"
+                        },
+                        {
+                            "type": "array",
+                            "items": {
+                                "$ref": "https://schema.twindev.org/w3c-odrl/OdrlProhibition"
+                            }
+                        }
+                    ],
+                    "description": "The prohibitions in the policy.\nAt least one of permission, prohibition, or obligation must be present."
+                },
+                "obligation": {
+                    "anyOf": [
+                        {
+                            "$ref": "https://schema.twindev.org/w3c-odrl/OdrlDuty"
+                        },
+                        {
+                            "type": "array",
+                            "items": {
+                                "$ref": "https://schema.twindev.org/w3c-odrl/OdrlDuty"
+                            }
+                        }
+                    ],
+                    "description": "The obligations in the policy.\nAt least one of permission, prohibition, or obligation must be present."
                 }
+            },
+            "required": [
+                "@context",
+                "@type"
             ],
-            "description": "The obligations in the policy. At least one of permission, prohibition, or obligation must be present."
-        },
-        "@id": {
-            "type": "string",
-            "description": "Unique identifier for the policy."
+            "$comment": "Inlined utility base type OdrlPolicy so utility transformations can operate on concrete properties instead of a $ref."
         }
-    },
-    "required": [
-        "@context",
-        "@id",
-        "@type"
     ]
 }