@twin.org/standards-dataspace-protocol 0.0.3-next.3 → 0.0.3-next.5

package/dist/types/models/transferProcess/ITransferRequestMessage.d.ts

@@ -0,0 +1,39 @@
+import type { DataspaceProtocolContextType } from "../dataspaceProtocolContextType.js";
+import type { IDataAddress } from "./IDataAddress.js";
+import type { TransferProcessTypes } from "./transferProcessTypes.js";
+/**
+ * Interface for Dataspace Protocol Transfer Messages.
+ * https://eclipse-dataspace-protocol-base.github.io/DataspaceProtocol/#transfer-request-message
+ */
+export interface ITransferRequestMessage {
+    /**
+     * LD Context
+     */
+    "@context": DataspaceProtocolContextType;
+    /**
+     * LD Type
+     */
+    "@type": typeof TransferProcessTypes.TransferRequestMessage;
+    /**
+     * MUST refer to an existing Agreement between the Consumer and Provider.
+     */
+    agreementId: string;
+    /**
+     * MUST be a URI indicating where messages to the Consumer SHOULD be sent.
+     */
+    callbackAddress: string;
+    /**
+     * MUST refer to the transfer identifier of the Consumer side.
+     */
+    consumerPid: string;
+    /**
+     * The format property is a format specified by a Distribution for the Dataset associated with the Agreement.
+     * This is generally obtained from the Provider's Catalog.
+     */
+    format: string;
+    /**
+     * If defined MUST contain a transport-specific set of properties for pushing the data.
+     * It MAY include an endpoint, a temporary authorization via the endpointProperties property - depending on the endpointType.
+     */
+    dataAddress?: IDataAddress;
+}

package/dist/types/models/transferProcess/ITransferStartMessage.d.ts

@@ -0,0 +1,30 @@
+import type { DataspaceProtocolContextType } from "../dataspaceProtocolContextType.js";
+import type { IDataAddress } from "./IDataAddress.js";
+import type { TransferProcessTypes } from "./transferProcessTypes.js";
+/**
+ * Interface for Dataspace Protocol Transfer Messages.
+ * https://eclipse-dataspace-protocol-base.github.io/DataspaceProtocol/#transfer-start-message
+ */
+export interface ITransferStartMessage {
+    /**
+     * LD Context
+     */
+    "@context": DataspaceProtocolContextType;
+    /**
+     * LD Type
+     */
+    "@type": typeof TransferProcessTypes.TransferStartMessage;
+    /**
+     * MUST refer to the transfer identifier of the Consumer side.
+     */
+    consumerPid: string;
+    /**
+     * MUST refer to the transfer identifier of the Provider side.
+     */
+    providerPid: string;
+    /**
+     * MUST be provided if the current transfer is a pull transfer and
+     * contains a transport-specific endpoint address for obtaining the data.
+     */
+    dataAddress?: IDataAddress;
+}

package/dist/types/models/transferProcess/ITransferSuspensionMessage.d.ts

@@ -0,0 +1,32 @@
+import type { DataspaceProtocolContextType } from "../dataspaceProtocolContextType.js";
+import type { TransferProcessTypes } from "./transferProcessTypes.js";
+/**
+ * Interface for Dataspace Protocol Transfer Messages.
+ * https://eclipse-dataspace-protocol-base.github.io/DataspaceProtocol/#transfer-suspension-message
+ */
+export interface ITransferSuspensionMessage {
+    /**
+     * LD Context
+     */
+    "@context": DataspaceProtocolContextType;
+    /**
+     * LD Type
+     */
+    "@type": typeof TransferProcessTypes.TransferSuspensionMessage;
+    /**
+     * MUST refer to the transfer identifier of the Consumer side.
+     */
+    consumerPid: string;
+    /**
+     * MUST refer to the transfer identifier of the Provider side.
+     */
+    providerPid: string;
+    /**
+     * The suspension code.
+     */
+    code?: string;
+    /**
+     * The suspension reason(s).
+     */
+    reason?: any[];
+}

package/dist/types/models/transferProcess/ITransferTerminationMessage.d.ts

@@ -0,0 +1,32 @@
+import type { DataspaceProtocolContextType } from "../dataspaceProtocolContextType.js";
+import type { TransferProcessTypes } from "./transferProcessTypes.js";
+/**
+ * Interface for Dataspace Protocol Transfer Messages.
+ * https://eclipse-dataspace-protocol-base.github.io/DataspaceProtocol/#transfer-termination-message
+ */
+export interface ITransferTerminationMessage {
+    /**
+     * LD Context
+     */
+    "@context": DataspaceProtocolContextType;
+    /**
+     * LD Type
+     */
+    "@type": typeof TransferProcessTypes.TransferTerminationMessage;
+    /**
+     * MUST refer to the transfer identifier of the Consumer side.
+     */
+    consumerPid: string;
+    /**
+     * MUST refer to the transfer identifier of the Provider side.
+     */
+    providerPid: string;
+    /**
+     * The termination code.
+     */
+    code?: string;
+    /**
+     * The termination reason(s).
+     */
+    reason?: any[];
+}

package/dist/types/models/transferProcess/transferProcessTypes.d.ts

@@ -0,0 +1,46 @@
+/**
+ * The types for Dataspace Protocol Transfer Process.
+ * https://eclipse-dataspace-protocol-base.github.io/DataspaceProtocol/2025-1-err1/#message-types-1
+ */
+export declare const TransferProcessTypes: {
+    /**
+     * Transfer Request Message.
+     */
+    TransferRequestMessage: string;
+    /**
+     * Transfer Start Message.
+     */
+    TransferStartMessage: string;
+    /**
+     * Transfer Suspension Message.
+     */
+    TransferSuspensionMessage: string;
+    /**
+     * Transfer Completion Message.
+     */
+    TransferCompletionMessage: string;
+    /**
+     * Transfer Termination Message.
+     */
+    TransferTerminationMessage: string;
+    /**
+     * Data Address
+     */
+    DataAddress: string;
+    /**
+     * Endpoint property.
+     */
+    EndpointProperty: string;
+    /**
+     * Transfer Process
+     */
+    TransferProcess: string;
+    /**
+     * Transfer Error.
+     */
+    TransferError: string;
+};
+/**
+ * The types for Dataspace Protocol Transfer.
+ */
+export type TransferProcessTypes = (typeof TransferProcessTypes)[keyof typeof TransferProcessTypes];

package/dist/types/models/transferProcess/types/transferProcessStateType.d.ts

@@ -0,0 +1,30 @@
+/**
+ * The states for Dataspace Protocol Transfer Process.
+ * https://eclipse-dataspace-protocol-base.github.io/DataspaceProtocol/2025-1-err1/#ack-transfer-process
+ */
+export declare const TransferProcessStateType: {
+    /**
+     * Completed
+     */
+    COMPLETED: string;
+    /**
+     * Requested
+     */
+    REQUESTED: string;
+    /**
+     * Started
+     */
+    STARTED: string;
+    /**
+     * Suspended
+     */
+    SUSPENDED: string;
+    /**
+     * Terminated
+     */
+    TERMINATED: string;
+};
+/**
+ * The types for Dataspace Protocol Transfer.
+ */
+export type TransferProcessStateType = (typeof TransferProcessStateType)[keyof typeof TransferProcessStateType];

package/docs/changelog.md

@@ -1,5 +1,40 @@
 # Changelog
 
+## [0.0.3-next.5](https://github.com/twinfoundation/standards/compare/standards-dataspace-protocol-v0.0.3-next.4...standards-dataspace-protocol-v0.0.3-next.5) (2025-11-28)
+
+
+### Features
+
+* ds protocol - data transfer ([#77](https://github.com/twinfoundation/standards/issues/77)) ([1bf0375](https://github.com/twinfoundation/standards/commit/1bf03750c74daaa0eb133b03927a0f40eb27a1e3))
+
+
+### Bug Fixes
+
+* filter is array in catalog request (please merge after [#77](https://github.com/twinfoundation/standards/issues/77)) ([#78](https://github.com/twinfoundation/standards/issues/78)) ([72a234c](https://github.com/twinfoundation/standards/commit/72a234c6620466ac4a5aded677af7590ccf94077))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/standards-w3c-dcat bumped from 0.0.3-next.4 to 0.0.3-next.5
+    * @twin.org/standards-w3c-odrl bumped from 0.0.3-next.4 to 0.0.3-next.5
+
+## [0.0.3-next.4](https://github.com/twinfoundation/standards/compare/standards-dataspace-protocol-v0.0.3-next.3...standards-dataspace-protocol-v0.0.3-next.4) (2025-11-18)
+
+
+### Features
+
+* implement Dataspace Protocol Objects ([#73](https://github.com/twinfoundation/standards/issues/73)) ([2505495](https://github.com/twinfoundation/standards/commit/2505495c03b54a6606a775d7f2211308372c7cc6))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/standards-w3c-dcat bumped from 0.0.3-next.3 to 0.0.3-next.4
+    * @twin.org/standards-w3c-odrl bumped from 0.0.3-next.3 to 0.0.3-next.4
+
 ## [0.0.3-next.3](https://github.com/twinfoundation/standards/compare/standards-dataspace-protocol-v0.0.3-next.2...standards-dataspace-protocol-v0.0.3-next.3) (2025-11-18)
 
 

package/docs/reference/classes/CatalogDataTypes.md

@@ -0,0 +1,25 @@
+# Class: CatalogDataTypes
+
+Handle all the catalog data types for Dataspace Protocol.
+
+## Constructors
+
+### Constructor
+
+> **new CatalogDataTypes**(): `CatalogDataTypes`
+
+#### Returns
+
+`CatalogDataTypes`
+
+## Methods
+
+### registerTypes()
+
+> `static` **registerTypes**(): `void`
+
+Register all the data types.
+
+#### Returns
+
+`void`

package/docs/reference/classes/ContractNegotiationDataTypes.md

@@ -1,6 +1,6 @@
 # Class: ContractNegotiationDataTypes
 
-Handle all the data types for Dataspace Protocol Contract Negotiation.
+Handle all the contract negotiation data types for Dataspace Protocol.
 
 ## Constructors
 
@@ -14,18 +14,6 @@ Handle all the data types for Dataspace Protocol Contract Negotiation.
 
 ## Methods
 
-### registerRedirects()
-
-> `static` **registerRedirects**(): `void`
-
-Register the JSON-LD Redirects.
-
-#### Returns
-
-`void`
-
-***
-
 ### registerTypes()
 
 > `static` **registerTypes**(): `void`

package/docs/reference/classes/DataspaceProtocolDataTypes.md

@@ -0,0 +1,37 @@
+# Class: DataspaceProtocolDataTypes
+
+Handle all the data types for Dataspace Protocol.
+
+## Constructors
+
+### Constructor
+
+> **new DataspaceProtocolDataTypes**(): `DataspaceProtocolDataTypes`
+
+#### Returns
+
+`DataspaceProtocolDataTypes`
+
+## Methods
+
+### registerRedirects()
+
+> `static` **registerRedirects**(): `void`
+
+Register the JSON-LD Redirects.
+
+#### Returns
+
+`void`
+
+***
+
+### registerTypes()
+
+> `static` **registerTypes**(): `void`
+
+Register all the data types.
+
+#### Returns
+
+`void`

package/docs/reference/classes/TransferProcessDataTypes.md

@@ -0,0 +1,25 @@
+# Class: TransferProcessDataTypes
+
+Handle all the transfer process data types for Dataspace Protocol.
+
+## Constructors
+
+### Constructor
+
+> **new TransferProcessDataTypes**(): `TransferProcessDataTypes`
+
+#### Returns
+
+`TransferProcessDataTypes`
+
+## Methods
+
+### registerTypes()
+
+> `static` **registerTypes**(): `void`
+
+Register all the data types.
+
+#### Returns
+
+`void`

package/docs/reference/index.md

@@ -2,10 +2,16 @@
 
 ## Classes
 
+- [CatalogDataTypes](classes/CatalogDataTypes.md)
 - [ContractNegotiationDataTypes](classes/ContractNegotiationDataTypes.md)
+- [DataspaceProtocolDataTypes](classes/DataspaceProtocolDataTypes.md)
+- [TransferProcessDataTypes](classes/TransferProcessDataTypes.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)
@@ -14,18 +20,33 @@
 - [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)
 
 ## Type Aliases
 
-- [ContractNegotiationContextType](type-aliases/ContractNegotiationContextType.md)
-- [ContractNegotiationContexts](type-aliases/ContractNegotiationContexts.md)
+- [CatalogTypes](type-aliases/CatalogTypes.md)
 - [ContractNegotiationTypes](type-aliases/ContractNegotiationTypes.md)
 - [ContractNegotiationEventType](type-aliases/ContractNegotiationEventType.md)
 - [ContractNegotiationStateType](type-aliases/ContractNegotiationStateType.md)
+- [DataspaceProtocolContextType](type-aliases/DataspaceProtocolContextType.md)
+- [DataspaceProtocolContexts](type-aliases/DataspaceProtocolContexts.md)
+- [TransferProcessTypes](type-aliases/TransferProcessTypes.md)
+- [TransferProcessStateType](type-aliases/TransferProcessStateType.md)
 
 ## Variables
 
-- [ContractNegotiationContexts](variables/ContractNegotiationContexts.md)
+- [CatalogTypes](variables/CatalogTypes.md)
 - [ContractNegotiationTypes](variables/ContractNegotiationTypes.md)
 - [ContractNegotiationEventType](variables/ContractNegotiationEventType.md)
 - [ContractNegotiationStateType](variables/ContractNegotiationStateType.md)
+- [DataspaceProtocolContexts](variables/DataspaceProtocolContexts.md)
+- [TransferProcessTypes](variables/TransferProcessTypes.md)
+- [TransferProcessStateType](variables/TransferProcessStateType.md)

package/docs/reference/interfaces/ICatalogError.md

@@ -0,0 +1,36 @@
+# Interface: ICatalogError
+
+Interface for Dataspace Protocol Catalog Error.
+https://eclipse-dataspace-protocol-base.github.io/DataspaceProtocol/2025-1/#error-catalog-error
+
+## Properties
+
+### @context
+
+> **@context**: [`DataspaceProtocolContextType`](../type-aliases/DataspaceProtocolContextType.md)
+
+The JSON-LD context.
+
+***
+
+### @type
+
+> **@type**: `"CatalogError"`
+
+The type of the message.
+
+***
+
+### code
+
+> **code**: `string`
+
+The error code.
+
+***
+
+### reason?
+
+> `optional` **reason**: `any`[]
+
+The error reason(s).

package/docs/reference/interfaces/ICatalogRequestMessage.md

@@ -0,0 +1,28 @@
+# Interface: ICatalogRequestMessage
+
+Interface for Dataspace Protocol Catalog Request Messages.
+https://eclipse-dataspace-protocol-base.github.io/DataspaceProtocol/2025-1/#catalog-request-message
+
+## Properties
+
+### @context
+
+> **@context**: [`DataspaceProtocolContextType`](../type-aliases/DataspaceProtocolContextType.md)
+
+The JSON-LD context.
+
+***
+
+### @type
+
+> **@type**: `"CatalogRequestMessage"`
+
+The type of the message.
+
+***
+
+### filter?
+
+> `optional` **filter**: `unknown`[]
+
+An implementation-specific query or filter expression.

package/docs/reference/interfaces/IContractAgreementMessage.md

@@ -7,7 +7,7 @@ https://eclipse-dataspace-protocol-base.github.io/DataspaceProtocol/2025-1/#cont
 
 ### @context
 
-> **@context**: [`ContractNegotiationContextType`](../type-aliases/ContractNegotiationContextType.md)
+> **@context**: [`DataspaceProtocolContextType`](../type-aliases/DataspaceProtocolContextType.md)
 
 The JSON-LD context.
 

package/docs/reference/interfaces/IContractAgreementVerificationMessage.md

@@ -7,7 +7,7 @@ https://eclipse-dataspace-protocol-base.github.io/DataspaceProtocol/2025-1/#cont
 
 ### @context
 
-> **@context**: [`ContractNegotiationContextType`](../type-aliases/ContractNegotiationContextType.md)
+> **@context**: [`DataspaceProtocolContextType`](../type-aliases/DataspaceProtocolContextType.md)
 
 The JSON-LD context.
 

package/docs/reference/interfaces/IContractNegotiation.md

@@ -7,7 +7,7 @@ https://eclipse-dataspace-protocol-base.github.io/DataspaceProtocol/2025-1/#ack-
 
 ### @context
 
-> **@context**: [`ContractNegotiationContextType`](../type-aliases/ContractNegotiationContextType.md)
+> **@context**: [`DataspaceProtocolContextType`](../type-aliases/DataspaceProtocolContextType.md)
 
 The JSON-LD context.
 

package/docs/reference/interfaces/IContractNegotiationError.md

@@ -7,7 +7,7 @@ https://eclipse-dataspace-protocol-base.github.io/DataspaceProtocol/2025-1/#erro
 
 ### @context
 
-> **@context**: [`ContractNegotiationContextType`](../type-aliases/ContractNegotiationContextType.md)
+> **@context**: [`DataspaceProtocolContextType`](../type-aliases/DataspaceProtocolContextType.md)
 
 The JSON-LD context.
 
@@ -47,30 +47,6 @@ The error code.
 
 ### reason?
 
-> `optional` **reason**: `object`[]
+> `optional` **reason**: `any`[]
 
 The error reason(s).
-
-#### @value
-
-> **@value**: `string`
-
-#### @language?
-
-> `optional` **@language**: `string`
-
-***
-
-### description?
-
-> `optional` **description**: `object`[]
-
-The error description(s).
-
-#### @value
-
-> **@value**: `string`
-
-#### @language?
-
-> `optional` **@language**: `string`

package/docs/reference/interfaces/IContractNegotiationEventMessage.md

@@ -7,7 +7,7 @@ https://eclipse-dataspace-protocol-base.github.io/DataspaceProtocol/2025-1/#cont
 
 ### @context
 
-> **@context**: [`ContractNegotiationContextType`](../type-aliases/ContractNegotiationContextType.md)
+> **@context**: [`DataspaceProtocolContextType`](../type-aliases/DataspaceProtocolContextType.md)
 
 The JSON-LD context.
 

package/docs/reference/interfaces/IContractNegotiationTerminationMessage.md

@@ -7,7 +7,7 @@ https://eclipse-dataspace-protocol-base.github.io/DataspaceProtocol/2025-1/#cont
 
 ### @context
 
-> **@context**: [`ContractNegotiationContextType`](../type-aliases/ContractNegotiationContextType.md)
+> **@context**: [`DataspaceProtocolContextType`](../type-aliases/DataspaceProtocolContextType.md)
 
 The JSON-LD context.
 

package/docs/reference/interfaces/IContractOfferMessage.md

@@ -7,7 +7,7 @@ https://eclipse-dataspace-protocol-base.github.io/DataspaceProtocol/2025-1/#cont
 
 ### @context
 
-> **@context**: [`ContractNegotiationContextType`](../type-aliases/ContractNegotiationContextType.md)
+> **@context**: [`DataspaceProtocolContextType`](../type-aliases/DataspaceProtocolContextType.md)
 
 The JSON-LD context.
 

package/docs/reference/interfaces/IContractRequestMessage.md

@@ -7,7 +7,7 @@ https://eclipse-dataspace-protocol-base.github.io/DataspaceProtocol/2025-1/#cont
 
 ### @context
 
-> **@context**: [`ContractNegotiationContextType`](../type-aliases/ContractNegotiationContextType.md)
+> **@context**: [`DataspaceProtocolContextType`](../type-aliases/DataspaceProtocolContextType.md)
 
 The JSON-LD context.
 

package/docs/reference/interfaces/IDataAddress.md

@@ -0,0 +1,36 @@
+# Interface: IDataAddress
+
+Interface for Dataspace Protocol Transfer Messages.
+https://eclipse-dataspace-protocol-base.github.io/DataspaceProtocol/#lower-level-types
+
+## Properties
+
+### @type
+
+> **@type**: `string`
+
+LD Type
+
+***
+
+### endpointType
+
+> **endpointType**: `string`
+
+The type of endpoint of this data address.
+
+***
+
+### endpoint?
+
+> `optional` **endpoint**: `string`
+
+The endpoint of the data address
+
+***
+
+### endpointProperties?
+
+> `optional` **endpointProperties**: [`IEndpointProperty`](IEndpointProperty.md)[]
+
+Properties associated to the endpoint which might depend on the endpoint type.

package/docs/reference/interfaces/IDatasetRequestMessage.md

@@ -0,0 +1,28 @@
+# Interface: IDatasetRequestMessage
+
+Interface for Dataspace Protocol Dataset Request Messages.
+https://eclipse-dataspace-protocol-base.github.io/DataspaceProtocol/2025-1/#dataset-request-message
+
+## Properties
+
+### @context
+
+> **@context**: [`DataspaceProtocolContextType`](../type-aliases/DataspaceProtocolContextType.md)
+
+The JSON-LD context.
+
+***
+
+### @type
+
+> **@type**: `"DatasetRequestMessage"`
+
+The type of the message.
+
+***
+
+### dataset
+
+> **dataset**: `string`
+
+The identifier of the dataset.