@twin.org/dataspace-control-plane-service 0.9.0 → 0.9.1-next.10

package/dist/types/handlers/httpDataPullTransferHandler.d.ts

@@ -0,0 +1,63 @@
+import type { IDataspaceDataPlaneComponent } from "@twin.org/dataspace-models";
+import type { DataspaceProtocolTransferProcessStateType, IDataspaceProtocolDataAddress } from "@twin.org/standards-dataspace-protocol";
+import type { ITransferHandler } from "../models/ITransferHandler.js";
+import type { ITransferHandlerPrepareContext } from "../models/ITransferHandlerPrepareContext.js";
+import type { ITransferHandlerStartContext } from "../models/ITransferHandlerStartContext.js";
+/**
+ * Transfer handler for HttpData-PULL format.
+ * Consumer queries the provider's data endpoint using a bearer token supplied in the
+ * TransferStartMessage dataAddress. No data-plane push subscription is involved.
+ */
+export declare class HttpDataPullTransferHandler implements ITransferHandler {
+    /**
+     * Runtime name for the class.
+     */
+    static readonly CLASS_NAME: string;
+    /**
+     * Returns the class name of the component.
+     * @returns The class name of the component.
+     */
+    className(): string;
+    /**
+     * PULL consumers do not supply a dataAddress — the provider generates one on start.
+     * @param ctx Prepare context (unused for PULL).
+     * @returns undefined.
+     */
+    buildConsumerDataAddress(ctx: ITransferHandlerPrepareContext): IDataspaceProtocolDataAddress | undefined;
+    /**
+     * Build the provider's data endpoint and bearer token for the TransferStartMessage.
+     * @param ctx Start context containing entity, trust component, and path configuration.
+     * @returns The dataAddress carrying the query endpoint and bearer token.
+     * @throws GeneralError When dataPlanePath is not configured or providerIdentity is missing.
+     */
+    buildProviderStartDataAddress(ctx: ITransferHandlerStartContext): Promise<IDataspaceProtocolDataAddress | undefined>;
+    /**
+     * No-op: PULL transfers require no push subscription.
+     * @param dataPlaneComponent The data plane component instance.
+     * @param consumerPid The consumer process ID.
+     * @param previousState The state before the STARTED transition.
+     * @returns A promise that resolves immediately.
+     */
+    onProviderStart(dataPlaneComponent: IDataspaceDataPlaneComponent, consumerPid: string, previousState: DataspaceProtocolTransferProcessStateType): Promise<void>;
+    /**
+     * No-op: PULL transfers have no push subscription to tear down.
+     * @param dataPlaneComponent The data plane component instance.
+     * @param consumerPid The consumer process ID.
+     * @returns A promise that resolves immediately.
+     */
+    onComplete(dataPlaneComponent: IDataspaceDataPlaneComponent, consumerPid: string): Promise<void>;
+    /**
+     * No-op: PULL transfers have no push subscription to suspend.
+     * @param dataPlaneComponent The data plane component instance.
+     * @param consumerPid The consumer process ID.
+     * @returns A promise that resolves immediately.
+     */
+    onSuspend(dataPlaneComponent: IDataspaceDataPlaneComponent, consumerPid: string): Promise<void>;
+    /**
+     * No-op: PULL transfers have no push subscription to tear down.
+     * @param dataPlaneComponent The data plane component instance.
+     * @param consumerPid The consumer process ID.
+     * @returns A promise that resolves immediately.
+     */
+    onTerminate(dataPlaneComponent: IDataspaceDataPlaneComponent, consumerPid: string): Promise<void>;
+}

package/dist/types/handlers/httpDataPushTransferHandler.d.ts

@@ -0,0 +1,68 @@
+import type { IDataspaceDataPlaneComponent } from "@twin.org/dataspace-models";
+import { DataspaceProtocolTransferProcessStateType } from "@twin.org/standards-dataspace-protocol";
+import type { IDataspaceProtocolDataAddress } from "@twin.org/standards-dataspace-protocol";
+import type { ITransferHandler } from "../models/ITransferHandler.js";
+import type { ITransferHandlerPrepareContext } from "../models/ITransferHandlerPrepareContext.js";
+import type { ITransferHandlerStartContext } from "../models/ITransferHandlerStartContext.js";
+/**
+ * Transfer handler for HttpData-PUSH format (consumer-initiated push).
+ * The consumer supplies its /inbox endpoint in the TransferRequestMessage dataAddress.
+ * The provider pushes ActivityStreams objects to that endpoint, and returns its own
+ * /inbox in the TransferStartMessage so the consumer can route data notifications.
+ */
+export declare class HttpDataPushTransferHandler implements ITransferHandler {
+    /**
+     * Runtime name for the class.
+     */
+    static readonly CLASS_NAME: string;
+    /**
+     * Returns the class name of the component.
+     * @returns The class name of the component.
+     */
+    className(): string;
+    /**
+     * Build the consumer's /inbox dataAddress for the TransferRequestMessage.
+     * @param ctx Prepare context containing path and organization identity.
+     * @returns The consumer's ActivityStream inbox dataAddress.
+     * @throws GeneralError When dataPlanePath is not configured.
+     */
+    buildConsumerDataAddress(ctx: ITransferHandlerPrepareContext): IDataspaceProtocolDataAddress | undefined;
+    /**
+     * Validate the consumer's dataAddress and build the provider's /inbox endpoint
+     * for the TransferStartMessage. No bearer token is included — the consumer authenticates
+     * via the DSP protocol trust payload on the push POST.
+     * @param ctx Start context containing entity and path configuration.
+     * @returns The provider's ActivityStream inbox dataAddress.
+     * @throws GeneralError When the consumer dataAddress is invalid or dataPlanePath is not configured.
+     */
+    buildProviderStartDataAddress(ctx: ITransferHandlerStartContext): Promise<IDataspaceProtocolDataAddress | undefined>;
+    /**
+     * Set up (or resume) the data-plane push subscription after state is persisted to STARTED.
+     * @param dataPlaneComponent The data plane component instance.
+     * @param consumerPid The consumer process ID.
+     * @param previousState The state before the STARTED transition.
+     * @returns A promise that resolves when the subscription is established.
+     */
+    onProviderStart(dataPlaneComponent: IDataspaceDataPlaneComponent, consumerPid: string, previousState: DataspaceProtocolTransferProcessStateType): Promise<void>;
+    /**
+     * Tear down the push subscription when the transfer completes.
+     * @param dataPlaneComponent The data plane component instance.
+     * @param consumerPid The consumer process ID.
+     * @returns A promise that resolves when the subscription is torn down.
+     */
+    onComplete(dataPlaneComponent: IDataspaceDataPlaneComponent, consumerPid: string): Promise<void>;
+    /**
+     * Suspend the push subscription when the transfer is suspended.
+     * @param dataPlaneComponent The data plane component instance.
+     * @param consumerPid The consumer process ID.
+     * @returns A promise that resolves when the subscription is suspended.
+     */
+    onSuspend(dataPlaneComponent: IDataspaceDataPlaneComponent, consumerPid: string): Promise<void>;
+    /**
+     * Tear down the push subscription when the transfer terminates.
+     * @param dataPlaneComponent The data plane component instance.
+     * @param consumerPid The consumer process ID.
+     * @returns A promise that resolves when the subscription is torn down.
+     */
+    onTerminate(dataPlaneComponent: IDataspaceDataPlaneComponent, consumerPid: string): Promise<void>;
+}

package/dist/types/index.d.ts

@@ -1,9 +1,16 @@
 export * from "./dataspaceControlPlanePolicyRequester.js";
 export * from "./dataspaceControlPlaneRoutes.js";
 export * from "./dataspaceControlPlaneService.js";
+export * from "./factories/transferHandlerFactory.js";
+export * from "./handlers/httpDataPostTransferHandler.js";
+export * from "./handlers/httpDataPullTransferHandler.js";
+export * from "./handlers/httpDataPushTransferHandler.js";
 export * from "./models/endpointProperties.js";
 export * from "./models/IDataspaceControlPlaneServiceConfig.js";
 export * from "./models/IDataspaceControlPlaneServiceConstructorOptions.js";
 export * from "./models/INegotiationState.js";
+export * from "./models/ITransferHandler.js";
+export * from "./models/ITransferHandlerPrepareContext.js";
+export * from "./models/ITransferHandlerStartContext.js";
 export * from "./restEntryPoints.js";
 export * from "./schema.js";

package/dist/types/models/IDataspaceControlPlaneServiceConfig.d.ts

@@ -8,13 +8,18 @@ export interface IDataspaceControlPlaneServiceConfig {
      */
     overrideTrustGeneratorType?: string;
     /**
-     * Data plane endpoint path for PULL transfers (path only, not full URL).
-     * Will be combined with the public origin.
+     * Base route path for the data plane service (path only, not full URL).
+     * Combined with the public origin to form the `dataAddress.endpoint` sent to PULL consumers
+     * and the inbox URL sent to PUSH providers.
      *
-     * REQUIRED if PULL transfers are supported.
-     * If not specified, PULL transfers will not be available.
+     * This must be the mount-point prefix of the data plane routes, NOT a specific route path.
+     * Do NOT append sub-paths such as `/entities` or `/inbox` — those are appended automatically
+     * by each transfer handler and by the data plane REST client.
      *
-     * Example: "data-plane/data" or "api/data-plane/data"
+     * REQUIRED if PULL or PUSH transfers are supported.
+     * If not specified, PULL and PUSH transfers will not be available.
+     *
+     * Example: "dataspace"
      */
     dataPlanePath?: string;
     /**

package/dist/types/models/ITransferHandler.d.ts

@@ -0,0 +1,62 @@
+import type { IComponent } from "@twin.org/core";
+import type { IDataspaceDataPlaneComponent } from "@twin.org/dataspace-models";
+import type { DataspaceProtocolTransferProcessStateType, IDataspaceProtocolDataAddress } from "@twin.org/standards-dataspace-protocol";
+import type { ITransferHandlerPrepareContext } from "./ITransferHandlerPrepareContext.js";
+import type { ITransferHandlerStartContext } from "./ITransferHandlerStartContext.js";
+/**
+ * Format-specific handler for transfer process operations.
+ * One implementation exists per DataspaceTransferFormat value; the TransferHandlerFactory
+ * returns the correct instance keyed on the format string.
+ */
+export interface ITransferHandler extends IComponent {
+    /**
+     * Optionally build a consumer dataAddress for the TransferRequestMessage.
+     * Called during prepareTransfer. Returns undefined for formats that do not
+     * require a consumer-supplied dataAddress (PULL and POST).
+     * @param ctx The prepare context.
+     * @returns The consumer dataAddress, or undefined if not required for this format.
+     */
+    buildConsumerDataAddress(ctx: ITransferHandlerPrepareContext): IDataspaceProtocolDataAddress | undefined;
+    /**
+     * Build the provider dataAddress for the TransferStartMessage.
+     * Called during startTransfer (provider role). Throws a GeneralError when
+     * required configuration (e.g. dataPlanePath) is absent.
+     * @param ctx The start context.
+     * @returns The provider dataAddress, or undefined if not applicable.
+     */
+    buildProviderStartDataAddress(ctx: ITransferHandlerStartContext): Promise<IDataspaceProtocolDataAddress | undefined>;
+    /**
+     * Post-start hook for the provider role. Called after state has been persisted
+     * to STARTED. PUSH transfers set up (or resume) the data-plane push subscription
+     * here; all other formats are no-ops.
+     * @param dataPlaneComponent The data plane component instance.
+     * @param consumerPid The consumer process ID.
+     * @param previousState The state before the STARTED transition.
+     * @returns A promise that resolves when the hook completes.
+     */
+    onProviderStart(dataPlaneComponent: IDataspaceDataPlaneComponent, consumerPid: string, previousState: DataspaceProtocolTransferProcessStateType): Promise<void>;
+    /**
+     * Called after a transfer transitions to COMPLETED.
+     * PUSH and POST tear down the push subscription; PULL is a no-op.
+     * @param dataPlaneComponent The data plane component instance.
+     * @param consumerPid The consumer process ID.
+     * @returns A promise that resolves when the hook completes.
+     */
+    onComplete(dataPlaneComponent: IDataspaceDataPlaneComponent, consumerPid: string): Promise<void>;
+    /**
+     * Called after a transfer transitions to SUSPENDED.
+     * PUSH and POST suspend the push subscription; PULL is a no-op.
+     * @param dataPlaneComponent The data plane component instance.
+     * @param consumerPid The consumer process ID.
+     * @returns A promise that resolves when the hook completes.
+     */
+    onSuspend(dataPlaneComponent: IDataspaceDataPlaneComponent, consumerPid: string): Promise<void>;
+    /**
+     * Called after a transfer transitions to TERMINATED.
+     * PUSH and POST tear down the push subscription; PULL is a no-op.
+     * @param dataPlaneComponent The data plane component instance.
+     * @param consumerPid The consumer process ID.
+     * @returns A promise that resolves when the hook completes.
+     */
+    onTerminate(dataPlaneComponent: IDataspaceDataPlaneComponent, consumerPid: string): Promise<void>;
+}

package/dist/types/models/ITransferHandlerPrepareContext.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Context supplied to buildConsumerDataAddress during prepareTransfer.
+ */
+export interface ITransferHandlerPrepareContext {
+    /**
+     * The consumer process ID.
+     */
+    consumerPid: string;
+    /**
+     * The consumer's base origin URL.
+     */
+    origin: string;
+    /**
+     * The data plane path segment, if configured.
+     */
+    dataPlanePath: string | undefined;
+    /**
+     * The organization identity resolved from the current context.
+     */
+    organizationIdentity: string;
+}

package/dist/types/models/ITransferHandlerStartContext.d.ts

@@ -0,0 +1,31 @@
+import type { ITransferProcess } from "@twin.org/dataspace-models";
+import type { ITrustComponent } from "@twin.org/trust-models";
+/**
+ * Context supplied to buildProviderStartDataAddress during startTransfer (provider role).
+ */
+export interface ITransferHandlerStartContext {
+    /**
+     * The transfer process entity.
+     */
+    entity: ITransferProcess;
+    /**
+     * The provider's public origin URL.
+     */
+    publicOrigin: string;
+    /**
+     * The data plane path segment, if configured.
+     */
+    dataPlanePath: string | undefined;
+    /**
+     * The organization identity resolved from the current context.
+     */
+    organizationIdentity: string;
+    /**
+     * The trust component for generating access tokens.
+     */
+    trustComponent: ITrustComponent;
+    /**
+     * The override trust generator type, if configured.
+     */
+    overrideTrustGeneratorType: string | undefined;
+}

package/docs/changelog.md

@@ -1,5 +1,195 @@
 # Changelog
 
+## [0.9.1-next.10](https://github.com/iotaledger/twin-dataspace/compare/dataspace-control-plane-service-v0.9.1-next.9...dataspace-control-plane-service-v0.9.1-next.10) (2026-07-20)
+
+
+### Miscellaneous Chores
+
+* **dataspace-control-plane-service:** Synchronize repo versions
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/dataspace-models bumped from 0.9.1-next.9 to 0.9.1-next.10
+
+## [0.9.1-next.9](https://github.com/iotaledger/twin-dataspace/compare/dataspace-control-plane-service-v0.9.1-next.8...dataspace-control-plane-service-v0.9.1-next.9) (2026-07-06)
+
+
+### Miscellaneous Chores
+
+* **dataspace-control-plane-service:** Synchronize repo versions
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/dataspace-models bumped from 0.9.1-next.8 to 0.9.1-next.9
+
+## [0.9.1-next.8](https://github.com/iotaledger/twin-dataspace/compare/dataspace-control-plane-service-v0.9.1-next.7...dataspace-control-plane-service-v0.9.1-next.8) (2026-07-02)
+
+
+### Bug Fixes
+
+* defer catalogue reconciliation to background on startup ([#260](https://github.com/iotaledger/twin-dataspace/issues/260)) ([0824e46](https://github.com/iotaledger/twin-dataspace/commit/0824e465f5cedc9557abad90fb4d18a524210ddd))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/dataspace-models bumped from 0.9.1-next.7 to 0.9.1-next.8
+
+## [0.9.1-next.7](https://github.com/iotaledger/twin-dataspace/compare/dataspace-control-plane-service-v0.9.1-next.6...dataspace-control-plane-service-v0.9.1-next.7) (2026-07-02)
+
+
+### Features
+
+* simplify url construction ([49986d1](https://github.com/iotaledger/twin-dataspace/commit/49986d1b67b58c0918a5744794d06baf6b6c6461))
+
+
+### Bug Fixes
+
+* data plane path is base not full url for pull ([68092ac](https://github.com/iotaledger/twin-dataspace/commit/68092acf707b6ba6679f5b75d4dc355c6629396c))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/dataspace-models bumped from 0.9.1-next.6 to 0.9.1-next.7
+
+## [0.9.1-next.6](https://github.com/iotaledger/twin-dataspace/compare/dataspace-control-plane-service-v0.9.1-next.5...dataspace-control-plane-service-v0.9.1-next.6) (2026-07-02)
+
+
+### Features
+
+* add transfer handlers ([#259](https://github.com/iotaledger/twin-dataspace/issues/259)) ([06e21b1](https://github.com/iotaledger/twin-dataspace/commit/06e21b179f548f3d93d81192b68ea710e5b9aafb))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/dataspace-models bumped from 0.9.1-next.5 to 0.9.1-next.6
+
+## [0.9.1-next.5](https://github.com/iotaledger/twin-dataspace/compare/dataspace-control-plane-service-v0.9.1-next.4...dataspace-control-plane-service-v0.9.1-next.5) (2026-06-30)
+
+
+### Features
+
+* rest enhancements ([f6dbd24](https://github.com/iotaledger/twin-dataspace/commit/f6dbd24c186a382769c97e697e54f0b6e28488a9))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/dataspace-models bumped from 0.9.1-next.4 to 0.9.1-next.5
+
+## [0.9.1-next.4](https://github.com/iotaledger/twin-dataspace/compare/dataspace-control-plane-service-v0.9.1-next.3...dataspace-control-plane-service-v0.9.1-next.4) (2026-06-29)
+
+
+### Features
+
+* enhanced rest testing ([#255](https://github.com/iotaledger/twin-dataspace/issues/255)) ([264f91e](https://github.com/iotaledger/twin-dataspace/commit/264f91ea3a6501a13da51e7accbe9035e5ac4cef))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/dataspace-models bumped from 0.9.1-next.3 to 0.9.1-next.4
+
+## [0.9.1-next.3](https://github.com/iotaledger/twin-dataspace/compare/dataspace-control-plane-service-v0.9.1-next.2...dataspace-control-plane-service-v0.9.1-next.3) (2026-06-26)
+
+
+### Features
+
+* well-known endpoint ([9ff2607](https://github.com/iotaledger/twin-dataspace/commit/9ff2607a345ee9e038a2915179a926353251e59c))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/dataspace-models bumped from 0.9.1-next.2 to 0.9.1-next.3
+
+## [0.9.1-next.2](https://github.com/iotaledger/twin-dataspace/compare/dataspace-control-plane-service-v0.9.1-next.1...dataspace-control-plane-service-v0.9.1-next.2) (2026-06-26)
+
+
+### Features
+
+* add well known versions endpoint ([#251](https://github.com/iotaledger/twin-dataspace/issues/251)) ([4b4cbe9](https://github.com/iotaledger/twin-dataspace/commit/4b4cbe91a40980481dad6e0650c1ee73c53ae360))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/dataspace-models bumped from 0.9.1-next.1 to 0.9.1-next.2
+
+## [0.9.1-next.1](https://github.com/iotaledger/twin-dataspace/compare/dataspace-control-plane-service-v0.9.1-next.0...dataspace-control-plane-service-v0.9.1-next.1) (2026-06-26)
+
+
+### Features
+
+* add consumer transfer callbacks and startDataTransfer convenience method ([#151](https://github.com/iotaledger/twin-dataspace/issues/151)) ([0ab66c3](https://github.com/iotaledger/twin-dataspace/commit/0ab66c3636fd1f98f89baca1e99764d77c6f91d9))
+* add support for the new federated catalogue trust model ([#179](https://github.com/iotaledger/twin-dataspace/issues/179)) ([0d99a93](https://github.com/iotaledger/twin-dataspace/commit/0d99a9331e259e3efe5250e390fdfb1a2f0983b1))
+* add telemetry metrics to dataspace control and data plane services ([#212](https://github.com/iotaledger/twin-dataspace/issues/212)) ([b5b0248](https://github.com/iotaledger/twin-dataspace/commit/b5b024899ed12c0f639c5d51aefa3e509753eac6))
+* add transferStarted provider method to start a data transfer ([#206](https://github.com/iotaledger/twin-dataspace/issues/206)) ([3ec2dc8](https://github.com/iotaledger/twin-dataspace/commit/3ec2dc8943c8531cd8d8e4ab07cb970ef7b11090))
+* align all config times to ms ([40238d5](https://github.com/iotaledger/twin-dataspace/commit/40238d59a2b45caedc01792b682ce7206815dfd1))
+* cross-node transfer callbacks and DataTransferManager auto-start ([#199](https://github.com/iotaledger/twin-dataspace/issues/199)) ([1089aa3](https://github.com/iotaledger/twin-dataspace/commit/1089aa344e3598e382f37a82ca03230c5cf6cacd))
+* docs update ([8b44c7a](https://github.com/iotaledger/twin-dataspace/commit/8b44c7a75afb8d377a6f606616f8a78d58439ab4))
+* endpoint encryption + getDatasetTargets multi-target fix ([#112](https://github.com/iotaledger/twin-dataspace/issues/112)) ([3288941](https://github.com/iotaledger/twin-dataspace/commit/328894113c19c7402f7d00dfa77b6a97ae40ca91))
+* implement DSP push transfer mode ([#109](https://github.com/iotaledger/twin-dataspace/issues/109)) ([71f5fee](https://github.com/iotaledger/twin-dataspace/commit/71f5feec1d92dfec8ed6899c951809818e1bf2a3))
+* improve open-api examples ([1368dbe](https://github.com/iotaledger/twin-dataspace/commit/1368dbed5c36e074b4854942304a19b9ce51e088))
+* improve open-api examples ([44f7350](https://github.com/iotaledger/twin-dataspace/commit/44f7350c625d8d6afdca88b292dd48ef03253412))
+* improve open-api examples ([f065f4b](https://github.com/iotaledger/twin-dataspace/commit/f065f4bd55540041a653ef141c4be29a83c5055e))
+* improve validation ([#82](https://github.com/iotaledger/twin-dataspace/issues/82)) ([8bfaf7b](https://github.com/iotaledger/twin-dataspace/commit/8bfaf7b830f89b63575f8a51ee96bd8ac4da02f4))
+* internalise constant ([9b9b293](https://github.com/iotaledger/twin-dataspace/commit/9b9b2933588ee70811a601bc485b5abaa12bed41))
+* local optimization ([#218](https://github.com/iotaledger/twin-dataspace/issues/218)) ([1daae6b](https://github.com/iotaledger/twin-dataspace/commit/1daae6be8be44abdbe2b4c883c35938506cdd34a))
+* organization identifiers ([#188](https://github.com/iotaledger/twin-dataspace/issues/188)) ([af643d3](https://github.com/iotaledger/twin-dataspace/commit/af643d3bb7f212d6cbb672e362a9e1bbe886d1a5))
+* provider-side transfer auto-start and negotiation/transfer timeout callbacks ([#227](https://github.com/iotaledger/twin-dataspace/issues/227)) ([619d858](https://github.com/iotaledger/twin-dataspace/commit/619d858e8d44e59744dc8a0f73e06be976932b53))
+* remove datasetsHandled method from apps ([9fdc950](https://github.com/iotaledger/twin-dataspace/commit/9fdc95018d38ab49c4a1094642be2ee83ee0e4cd))
+* remove hosting component ([#209](https://github.com/iotaledger/twin-dataspace/issues/209)) ([5e19328](https://github.com/iotaledger/twin-dataspace/commit/5e1932823aa8a0f88f559f096610b9df1f3b8615))
+* rename completed callback ([#147](https://github.com/iotaledger/twin-dataspace/issues/147)) ([f62baad](https://github.com/iotaledger/twin-dataspace/commit/f62baad0ff444e2913439b12dcd06d20c9a4f6a4))
+* resolve DSP transfer flow bugs for cross-node communication ([#76](https://github.com/iotaledger/twin-dataspace/issues/76)) ([506a45c](https://github.com/iotaledger/twin-dataspace/commit/506a45c94e63d5f958b1fc7131adfe452c3e2974))
+* shortcut implicit trust ([#215](https://github.com/iotaledger/twin-dataspace/issues/215)) ([f9bcfea](https://github.com/iotaledger/twin-dataspace/commit/f9bcfeab8f069b62017502833c108b4ee3791414))
+* skip tenant dsp transfer routes ([#97](https://github.com/iotaledger/twin-dataspace/issues/97)) ([2f1ad97](https://github.com/iotaledger/twin-dataspace/commit/2f1ad971bc50ad24bb9f68759fbd4d44527d3d02))
+* types update ([77c338e](https://github.com/iotaledger/twin-dataspace/commit/77c338e9244dcc7e3d597fdb06229513b1f13eac))
+* typescript 6 update ([340f10e](https://github.com/iotaledger/twin-dataspace/commit/340f10e4767f6285c694938944f7e044474f9aaa))
+* unification of the data exchange and the data space connector ([#57](https://github.com/iotaledger/twin-dataspace/issues/57)) ([df2644d](https://github.com/iotaledger/twin-dataspace/commit/df2644d989471e07dadd83d27bef736179e31bf4))
+* update DataspaceTransferFormat names ([2c9d424](https://github.com/iotaledger/twin-dataspace/commit/2c9d424a07b97346faa2124048c4675514d58109))
+* use inbuilt constants ([256bc03](https://github.com/iotaledger/twin-dataspace/commit/256bc0332bf439fcc16022e0b984b9035e9b0100))
+
+
+### Bug Fixes
+
+* avoid compaction of incoming activities ([#77](https://github.com/iotaledger/twin-dataspace/issues/77)) ([ff43d6a](https://github.com/iotaledger/twin-dataspace/commit/ff43d6a3e1563eb9cb185501134b2a53ae88787c))
+* defer startTransfer state mutation until dispatch succeeds ([#162](https://github.com/iotaledger/twin-dataspace/issues/162)) ([6704bbd](https://github.com/iotaledger/twin-dataspace/commit/6704bbd88c10c8b5b37b621b56cf9d8704e00a15))
+* dependency update ([fbff0dd](https://github.com/iotaledger/twin-dataspace/commit/fbff0ddae93d82bd2899001368d7a03b482ce05c))
+* docs and component init ([8557233](https://github.com/iotaledger/twin-dataspace/commit/8557233fb3b8273c5c9a5b580fb43061f8efe47c))
+* gate implicit-trust shortcut on local provider endpoint ([#221](https://github.com/iotaledger/twin-dataspace/issues/221)) ([1167c53](https://github.com/iotaledger/twin-dataspace/commit/1167c53d2a94d4672191d278fed69b4f2d607a3c))
+* handle missing target in catalogue offers during policy derivation check ([#89](https://github.com/iotaledger/twin-dataspace/issues/89)) ([a0e0dbc](https://github.com/iotaledger/twin-dataspace/commit/a0e0dbc8d9111d5d1c43e905249825e5d8d62816))
+* implement missing trust check on negotiateAgreement ([#136](https://github.com/iotaledger/twin-dataspace/issues/136)) ([a3589c2](https://github.com/iotaledger/twin-dataspace/commit/a3589c279476d5450b68ea7c2790be7e3125bfe2))
+* incorrect docs ([754aa8d](https://github.com/iotaledger/twin-dataspace/commit/754aa8d032a5dfefa69072aa460106badfa41ac9))
+* mock pnap ([35f21f8](https://github.com/iotaledger/twin-dataspace/commit/35f21f847d3fb9d2ffcb9191a18835093cd259b9))
+* persist STARTED before setupPushSubscription so data-plane read-back sees the right state ([#168](https://github.com/iotaledger/twin-dataspace/issues/168)) ([6a7c81a](https://github.com/iotaledger/twin-dataspace/commit/6a7c81a1247dcbfbec5d64958328e8b77798be0c))
+* remove inline i18n ([edde37e](https://github.com/iotaledger/twin-dataspace/commit/edde37e90ac397f253f57bc0d306b4bd0c797920))
+* return 409 Conflict on duplicate dataset creation ([#165](https://github.com/iotaledger/twin-dataspace/issues/165)) ([890a2f5](https://github.com/iotaledger/twin-dataspace/commit/890a2f59d881aed4c50f63f57cdec3a4ccfb572d))
+* use async getStore in tests ([739531e](https://github.com/iotaledger/twin-dataspace/commit/739531e1a159f728301835cd39cf06eab7a7bf4a))
+* validate dataset-id ([#138](https://github.com/iotaledger/twin-dataspace/issues/138)) ([92a6a9b](https://github.com/iotaledger/twin-dataspace/commit/92a6a9b7b82c3dd5c652a3685892f7e9156d458b))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/dataspace-models bumped from 0.9.1-next.0 to 0.9.1-next.1
+
 ## [0.9.0](https://github.com/iotaledger/twin-dataspace/compare/dataspace-control-plane-service-v0.9.0...dataspace-control-plane-service-v0.9.0) (2026-06-25)
 
 

package/docs/reference/classes/DataspaceControlPlaneService.md

@@ -851,3 +851,21 @@ A promise that resolves when the dataset has been removed from storage and the c
 #### Implementation of
 
 `IDataspaceControlPlaneComponent.deleteAppDataset`
+
+***
+
+### getProtocolVersions() {#getprotocolversions}
+
+> **getProtocolVersions**(): `Promise`\<`IDataspaceProtocolVersionResponse`\>
+
+Return the Dataspace Protocol versions supported by this connector.
+
+#### Returns
+
+`Promise`\<`IDataspaceProtocolVersionResponse`\>
+
+The protocol version response listing all supported DSP versions.
+
+#### Implementation of
+
+`IDataspaceControlPlaneComponent.getProtocolVersions`