@twin.org/standards-dataspace-protocol 0.0.3-next.6 → 0.0.3-next.60

package/docs/examples.md

@@ -1 +1,44 @@
-# @twin.org/standards-dataspace-protocol - Examples
+# Standards Dataspace Protocol Examples
+
+These snippets show how to prepare payloads for conformance checks and register protocol data types for processing flows.
+
+## DataspaceProtocolHelper
+
+```typescript
+import type { IValidationFailure } from '@twin.org/core';
+import type { IJsonLdNodeObject } from '@twin.org/data-json-ld';
+import {
+  DataspaceProtocolHelper,
+  DataspaceProtocolTransferProcessTypes
+} from '@twin.org/standards-dataspace-protocol';
+
+const payload: IJsonLdNodeObject = {
+  '@context': 'https://w3id.org/dspace/2025/1/context.json',
+  '@type': DataspaceProtocolTransferProcessTypes.TransferProcess,
+  state: 'STARTED'
+};
+
+const normalised = await DataspaceProtocolHelper.normalize(payload);
+const validationFailures = await DataspaceProtocolHelper.validate(normalised);
+
+console.log(validationFailures.length); // 0
+```
+
+## Data Types
+
+```typescript
+import {
+  CatalogDataTypes,
+  ContractNegotiationDataTypes,
+  DataspaceProtocolDataTypes,
+  TransferProcessDataTypes
+} from '@twin.org/standards-dataspace-protocol';
+
+DataspaceProtocolDataTypes.registerRedirects();
+DataspaceProtocolDataTypes.registerTypes();
+CatalogDataTypes.registerTypes();
+ContractNegotiationDataTypes.registerTypes();
+TransferProcessDataTypes.registerTypes();
+
+console.log(typeof DataspaceProtocolDataTypes.registerTypes === 'function'); // true
+```

package/docs/reference/classes/CatalogDataTypes.md

@@ -14,7 +14,7 @@ Handle all the catalog data types for Dataspace Protocol.
 
 ## Methods
 
-### registerTypes()
+### registerTypes() {#registertypes}
 
 > `static` **registerTypes**(): `void`
 

package/docs/reference/classes/ContractNegotiationDataTypes.md

@@ -14,7 +14,7 @@ Handle all the contract negotiation data types for Dataspace Protocol.
 
 ## Methods
 
-### registerTypes()
+### registerTypes() {#registertypes}
 
 > `static` **registerTypes**(): `void`
 

package/docs/reference/classes/DataspaceProtocolDataTypes.md

@@ -14,7 +14,7 @@ Handle all the data types for Dataspace Protocol.
 
 ## Methods
 
-### registerRedirects()
+### registerRedirects() {#registerredirects}
 
 > `static` **registerRedirects**(): `void`
 
@@ -26,7 +26,7 @@ Register the JSON-LD Redirects.
 
 ***
 
-### registerTypes()
+### registerTypes() {#registertypes}
 
 > `static` **registerTypes**(): `void`
 

package/docs/reference/classes/DataspaceProtocolHelper.md

@@ -0,0 +1,57 @@
+# Abstract Class: DataspaceProtocolHelper
+
+Dataspace protocol helper.
+
+## Constructors
+
+### Constructor
+
+> **new DataspaceProtocolHelper**(): `DataspaceProtocolHelper`
+
+#### Returns
+
+`DataspaceProtocolHelper`
+
+## Methods
+
+### validate() {#validate}
+
+> `static` **validate**(`object`): `Promise`\<`IValidationFailure`[]\>
+
+Checks whether the object passed as parameter is conformant to the DS Protocol definitions.
+
+#### Parameters
+
+##### object
+
+`IJsonLdNodeObject`
+
+The object to check
+
+#### Returns
+
+`Promise`\<`IValidationFailure`[]\>
+
+An array of validation failures, empty if the object is conformant
+
+***
+
+### normalize() {#normalize}
+
+> `static` **normalize**(`object`): `Promise`\<`IJsonLdNodeObject`\>
+
+Normalizes the input object making it compliant with the DS Protocol specifications.
+
+#### Parameters
+
+##### object
+
+`IJsonLdNodeObject`
+
+The input object.
+
+#### Returns
+
+`Promise`\<`IJsonLdNodeObject`\>
+
+The input object normalized.

package/docs/reference/classes/TransferProcessDataTypes.md

@@ -14,7 +14,7 @@ Handle all the transfer process data types for Dataspace Protocol.
 
 ## Methods
 
-### registerTypes()
+### registerTypes() {#registertypes}
 
 > `static` **registerTypes**(): `void`
 

package/docs/reference/index.md

@@ -6,47 +6,65 @@
 - [ContractNegotiationDataTypes](classes/ContractNegotiationDataTypes.md)
 - [DataspaceProtocolDataTypes](classes/DataspaceProtocolDataTypes.md)
 - [TransferProcessDataTypes](classes/TransferProcessDataTypes.md)
+- [DataspaceProtocolHelper](classes/DataspaceProtocolHelper.md)
 
 ## Interfaces
 
-- [ICatalogError](interfaces/ICatalogError.md)
-- [ICatalogRequestMessage](interfaces/ICatalogRequestMessage.md)
-- [IDatasetRequestMessage](interfaces/IDatasetRequestMessage.md)
-- [IContractAgreementMessage](interfaces/IContractAgreementMessage.md)
-- [IContractAgreementVerificationMessage](interfaces/IContractAgreementVerificationMessage.md)
-- [IContractNegotiation](interfaces/IContractNegotiation.md)
-- [IContractNegotiationError](interfaces/IContractNegotiationError.md)
-- [IContractNegotiationEventMessage](interfaces/IContractNegotiationEventMessage.md)
-- [IContractNegotiationTerminationMessage](interfaces/IContractNegotiationTerminationMessage.md)
-- [IContractOfferMessage](interfaces/IContractOfferMessage.md)
-- [IContractRequestMessage](interfaces/IContractRequestMessage.md)
-- [IDataAddress](interfaces/IDataAddress.md)
-- [IEndpointProperty](interfaces/IEndpointProperty.md)
-- [ITransferCompletionMessage](interfaces/ITransferCompletionMessage.md)
-- [ITransferError](interfaces/ITransferError.md)
-- [ITransferProcess](interfaces/ITransferProcess.md)
-- [ITransferRequestMessage](interfaces/ITransferRequestMessage.md)
-- [ITransferStartMessage](interfaces/ITransferStartMessage.md)
-- [ITransferSuspensionMessage](interfaces/ITransferSuspensionMessage.md)
-- [ITransferTerminationMessage](interfaces/ITransferTerminationMessage.md)
+- [IDataspaceProtocolCatalogError](interfaces/IDataspaceProtocolCatalogError.md)
+- [IDataspaceProtocolCatalogRequestMessage](interfaces/IDataspaceProtocolCatalogRequestMessage.md)
+- [IDataspaceProtocolDatasetRequestMessage](interfaces/IDataspaceProtocolDatasetRequestMessage.md)
+- [IDataspaceProtocolContractAgreementMessage](interfaces/IDataspaceProtocolContractAgreementMessage.md)
+- [IDataspaceProtocolContractAgreementVerificationMessage](interfaces/IDataspaceProtocolContractAgreementVerificationMessage.md)
+- [IDataspaceProtocolContractNegotiation](interfaces/IDataspaceProtocolContractNegotiation.md)
+- [IDataspaceProtocolContractNegotiationError](interfaces/IDataspaceProtocolContractNegotiationError.md)
+- [IDataspaceProtocolContractNegotiationEventMessage](interfaces/IDataspaceProtocolContractNegotiationEventMessage.md)
+- [IDataspaceProtocolContractNegotiationTerminationMessage](interfaces/IDataspaceProtocolContractNegotiationTerminationMessage.md)
+- [IDataspaceProtocolContractOfferMessage](interfaces/IDataspaceProtocolContractOfferMessage.md)
+- [IDataspaceProtocolContractRequestMessage](interfaces/IDataspaceProtocolContractRequestMessage.md)
+- [IDataspaceProtocolCatalog](interfaces/IDataspaceProtocolCatalog.md)
+- [IDataspaceProtocolCatalogBase](interfaces/IDataspaceProtocolCatalogBase.md)
+- [IDataspaceProtocolDataService](interfaces/IDataspaceProtocolDataService.md)
+- [IDataspaceProtocolDataServiceBase](interfaces/IDataspaceProtocolDataServiceBase.md)
+- [IDataspaceProtocolDataset](interfaces/IDataspaceProtocolDataset.md)
+- [IDataspaceProtocolDatasetBase](interfaces/IDataspaceProtocolDatasetBase.md)
+- [IDataspaceProtocolDistribution](interfaces/IDataspaceProtocolDistribution.md)
+- [IDataspaceProtocolDistributionBase](interfaces/IDataspaceProtocolDistributionBase.md)
+- [IDataspaceProtocolAgreement](interfaces/IDataspaceProtocolAgreement.md)
+- [IDataspaceProtocolOffer](interfaces/IDataspaceProtocolOffer.md)
+- [IDataspaceProtocolOfferBase](interfaces/IDataspaceProtocolOfferBase.md)
+- [IDataspaceProtocolPolicy](interfaces/IDataspaceProtocolPolicy.md)
+- [IDataspaceProtocolSet](interfaces/IDataspaceProtocolSet.md)
+- [IDataspaceProtocolDataAddress](interfaces/IDataspaceProtocolDataAddress.md)
+- [IDataspaceProtocolEndpointProperty](interfaces/IDataspaceProtocolEndpointProperty.md)
+- [IDataspaceProtocolTransferCompletionMessage](interfaces/IDataspaceProtocolTransferCompletionMessage.md)
+- [IDataspaceProtocolTransferError](interfaces/IDataspaceProtocolTransferError.md)
+- [IDataspaceProtocolTransferProcess](interfaces/IDataspaceProtocolTransferProcess.md)
+- [IDataspaceProtocolTransferRequestMessage](interfaces/IDataspaceProtocolTransferRequestMessage.md)
+- [IDataspaceProtocolTransferStartMessage](interfaces/IDataspaceProtocolTransferStartMessage.md)
+- [IDataspaceProtocolTransferSuspensionMessage](interfaces/IDataspaceProtocolTransferSuspensionMessage.md)
+- [IDataspaceProtocolTransferTerminationMessage](interfaces/IDataspaceProtocolTransferTerminationMessage.md)
 
 ## Type Aliases
 
-- [CatalogTypes](type-aliases/CatalogTypes.md)
-- [ContractNegotiationTypes](type-aliases/ContractNegotiationTypes.md)
-- [ContractNegotiationEventType](type-aliases/ContractNegotiationEventType.md)
-- [ContractNegotiationStateType](type-aliases/ContractNegotiationStateType.md)
+- [DataspaceProtocolCatalogTypes](type-aliases/DataspaceProtocolCatalogTypes.md)
+- [DataspaceProtocolContractNegotiationTypes](type-aliases/DataspaceProtocolContractNegotiationTypes.md)
+- [DataspaceProtocolContractNegotiationEventType](type-aliases/DataspaceProtocolContractNegotiationEventType.md)
+- [DataspaceProtocolContractNegotiationStateType](type-aliases/DataspaceProtocolContractNegotiationStateType.md)
 - [DataspaceProtocolContextType](type-aliases/DataspaceProtocolContextType.md)
 - [DataspaceProtocolContexts](type-aliases/DataspaceProtocolContexts.md)
-- [TransferProcessTypes](type-aliases/TransferProcessTypes.md)
-- [TransferProcessStateType](type-aliases/TransferProcessStateType.md)
+- [DataspaceProtocolTransferProcessTypes](type-aliases/DataspaceProtocolTransferProcessTypes.md)
+- [DataspaceProtocolEndpointType](type-aliases/DataspaceProtocolEndpointType.md)
+- [DataspaceProtocolTransferFormat](type-aliases/DataspaceProtocolTransferFormat.md)
+- [DataspaceProtocolTransferProcessStateType](type-aliases/DataspaceProtocolTransferProcessStateType.md)
 
 ## Variables
 
-- [CatalogTypes](variables/CatalogTypes.md)
-- [ContractNegotiationTypes](variables/ContractNegotiationTypes.md)
-- [ContractNegotiationEventType](variables/ContractNegotiationEventType.md)
-- [ContractNegotiationStateType](variables/ContractNegotiationStateType.md)
+- [DataspaceProtocolCatalogTypes](variables/DataspaceProtocolCatalogTypes.md)
+- [DataspaceProtocolContractNegotiationTypes](variables/DataspaceProtocolContractNegotiationTypes.md)
+- [DataspaceProtocolContractNegotiationEventType](variables/DataspaceProtocolContractNegotiationEventType.md)
+- [DataspaceProtocolContractNegotiationStateType](variables/DataspaceProtocolContractNegotiationStateType.md)
 - [DataspaceProtocolContexts](variables/DataspaceProtocolContexts.md)
-- [TransferProcessTypes](variables/TransferProcessTypes.md)
-- [TransferProcessStateType](variables/TransferProcessStateType.md)
+- [DataspaceProtocolTransferProcessTypes](variables/DataspaceProtocolTransferProcessTypes.md)
+- [DataspaceProtocolEndpointType](variables/DataspaceProtocolEndpointType.md)
+- [DataspaceProtocolTransferFormat](variables/DataspaceProtocolTransferFormat.md)
+- [DataspaceProtocolTransferProcessStateType](variables/DataspaceProtocolTransferProcessStateType.md)

package/docs/reference/interfaces/IDataspaceProtocolAgreement.md

@@ -0,0 +1,179 @@
+# Interface: IDataspaceProtocolAgreement
+
+Agreement interface compliant with Eclipse Data Space Protocol.
+
+Extends IOdrlAgreement with DS Protocol-specific constraints:
+- `@id` is REQUIRED (used as the primary agreement identifier in DS Protocol)
+- `@context` is omitted (inherited from the parent Dataset/Distribution)
+
+## See
+
+ - https://eclipse-dataspace-protocol-base.github.io/DataspaceProtocol/2025-1-err1/#lower-level-types
+ - IOdrlAgreement from @twin.org/standards-w3c-odrl
+
+## Extends
+
+- `Omit`\<`IOdrlAgreement`, `"uid"`\>
+
+## Properties
+
+### @id {#id}
+
+> **@id**: `string`
+
+Unique identifier for the agreement.
+
+***
+
+### @type {#type}
+
+> **@type**: `"Agreement"`
+
+The type must be "Agreement".
+
+#### Inherited from
+
+`Omit.@type`
+
+***
+
+### assigner {#assigner}
+
+> **assigner**: `string` \| `IOdrlParty`
+
+The assigner of the agreement.
+Required for Agreement policies.
+
+#### Inherited from
+
+`Omit.assigner`
+
+***
+
+### assignee {#assignee}
+
+> **assignee**: `string` \| `IOdrlParty`
+
+The assignee of the agreement.
+Required for Agreement policies.
+
+#### Inherited from
+
+`Omit.assignee`
+
+***
+
+### @context {#context}
+
+> **@context**: `OdrlContextType`
+
+The context for the policy.
+Must include "https://www.w3.org/ns/odrl.jsonld"
+
+#### Inherited from
+
+`Omit.@context`
+
+***
+
+### profile? {#profile}
+
+> `optional` **profile?**: `ObjectOrArray`\<`string`\>
+
+The profile(s) this policy conforms to.
+IRIs identifying the ODRL Profile(s).
+
+#### Inherited from
+
+`Omit.profile`
+
+***
+
+### target? {#target}
+
+> `optional` **target?**: `ObjectOrArray`\<`string` \| `IOdrlAsset` \| `IOdrlAssetCollection`\>
+
+The target asset for the rule.
+
+#### Inherited from
+
+`Omit.target`
+
+***
+
+### action? {#action}
+
+> `optional` **action?**: `ObjectOrArray`\<`string` \| `IOdrlAction`\>
+
+The action associated with the rule.
+
+#### Inherited from
+
+`Omit.action`
+
+***
+
+### inheritFrom? {#inheritfrom}
+
+> `optional` **inheritFrom?**: `ObjectOrArray`\<`string`\>
+
+The parent policy(ies) this policy inherits from.
+IRIs identifying the parent Policy(ies).
+
+#### Inherited from
+
+`Omit.inheritFrom`
+
+***
+
+### conflict? {#conflict}
+
+> `optional` **conflict?**: `OdrlConflictStrategyType`
+
+The conflict resolution strategy.
+- perm: Permissions override Prohibitions
+- prohibit: Prohibitions override Permissions
+- invalid: Policy is void if conflicts exist (default)
+
+#### Inherited from
+
+`Omit.conflict`
+
+***
+
+### permission? {#permission}
+
+> `optional` **permission?**: `ObjectOrArray`\<`IOdrlPermission`\>
+
+The permissions in the policy.
+At least one of permission, prohibition, or obligation must be present.
+
+#### Inherited from
+
+`Omit.permission`
+
+***
+
+### prohibition? {#prohibition}
+
+> `optional` **prohibition?**: `ObjectOrArray`\<`IOdrlProhibition`\>
+
+The prohibitions in the policy.
+At least one of permission, prohibition, or obligation must be present.
+
+#### Inherited from
+
+`Omit.prohibition`
+
+***
+
+### obligation? {#obligation}
+
+> `optional` **obligation?**: `ObjectOrArray`\<`IOdrlDuty`\>
+
+The obligations in the policy.
+At least one of permission, prohibition, or obligation must be present.
+
+#### Inherited from
+
+`Omit.obligation`