@twin.org/dataspace-control-plane-service 0.0.3-next.47 → 0.0.3-next.49

package/dist/es/models/IDataspaceControlPlaneServiceConfig.js.map

@@ -1 +1 @@
-{"version":3,"file":"IDataspaceControlPlaneServiceConfig.js","sourceRoot":"","sources":["../../../src/models/IDataspaceControlPlaneServiceConfig.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,uCAAuC","sourcesContent":["// Copyright 2025 IOTA Stiftung.\n// SPDX-License-Identifier: Apache-2.0.\n\n/**\n * Dataspace Control Plane service configuration.\n */\nexport interface IDataspaceControlPlaneServiceConfig {\n\t/**\n\t * Override the default trust generator type for token generation.\n\t * If not specified, the default trust generator configured in the trust component will be used.\n\t */\n\toverrideTrustGeneratorType?: string;\n\n\t/**\n\t * Data plane endpoint path for PULL transfers (path only, not full URL).\n\t * Will be combined with the public origin from the hosting component.\n\t *\n\t * REQUIRED if PULL transfers are supported.\n\t * If not specified, PULL transfers will not be available.\n\t *\n\t * Example: \"data-plane/data\" or \"api/data-plane/data\"\n\t */\n\tdataPlanePath?: string;\n\n\t/**\n\t * Control plane callback mount path (path only). Combined with this node's public origin to form the\n\t * consumer callbackAddress a provider POSTs DSP transfer messages back to (e.g.\n\t * `<origin>/<callbackPath>/transfers/:pid/start`), with `?organization=` appended for tenant routing.\n\t *\n\t * Example: \"dataspace\" or \"api/dataspace\".\n\t */\n\tcallbackPath?: string;\n}\n"]}
+{"version":3,"file":"IDataspaceControlPlaneServiceConfig.js","sourceRoot":"","sources":["../../../src/models/IDataspaceControlPlaneServiceConfig.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,uCAAuC","sourcesContent":["// Copyright 2025 IOTA Stiftung.\n// SPDX-License-Identifier: Apache-2.0.\n\n/**\n * Dataspace Control Plane service configuration.\n */\nexport interface IDataspaceControlPlaneServiceConfig {\n\t/**\n\t * Override the default trust generator type for token generation.\n\t * If not specified, the default trust generator configured in the trust component will be used.\n\t */\n\toverrideTrustGeneratorType?: string;\n\n\t/**\n\t * Data plane endpoint path for PULL transfers (path only, not full URL).\n\t * Will be combined with the public origin.\n\t *\n\t * REQUIRED if PULL transfers are supported.\n\t * If not specified, PULL transfers will not be available.\n\t *\n\t * Example: \"data-plane/data\" or \"api/data-plane/data\"\n\t */\n\tdataPlanePath?: string;\n\n\t/**\n\t * Control plane callback mount path (path only). Combined with this node's public origin to form the\n\t * consumer callbackAddress a provider POSTs DSP transfer messages back to (e.g.\n\t * `<origin>/<callbackPath>/transfers/:pid/start`), with `?organization=` appended for tenant routing.\n\t *\n\t * Example: \"dataspace\" or \"api/dataspace\".\n\t */\n\tcallbackPath?: string;\n}\n"]}

package/dist/es/models/IDataspaceControlPlaneServiceConstructorOptions.js.map

@@ -1 +1 @@
-{"version":3,"file":"IDataspaceControlPlaneServiceConstructorOptions.js","sourceRoot":"","sources":["../../../src/models/IDataspaceControlPlaneServiceConstructorOptions.ts"],"names":[],"mappings":"","sourcesContent":["// Copyright 2025 IOTA Stiftung.\n// SPDX-License-Identifier: Apache-2.0.\nimport type { IDataspaceControlPlaneServiceConfig } from \"./IDataspaceControlPlaneServiceConfig.js\";\n\n/**\n * Dataspace Control Plane service constructor options.\n */\nexport interface IDataspaceControlPlaneServiceConstructorOptions {\n\t/**\n\t * Policy Administration Point component type.\n\t * Used for Agreement lookup and validation during Transfer Process initiation.\n\t * @default policy-administration-point\n\t */\n\tpolicyAdministrationPointComponentType?: string;\n\n\t/**\n\t * Policy Negotiation Point component type.\n\t * Used for contract negotiation to create agreements before transfer processes.\n\t * @default policy-negotiation-point\n\t */\n\tpolicyNegotiationPointComponentType?: string;\n\n\t/**\n\t * Policy Negotiation Admin Point component type.\n\t * Used for querying negotiation history.\n\t * @default policy-negotiation-admin-point\n\t */\n\tpolicyNegotiationAdminPointComponentType?: string;\n\n\t/**\n\t * Federated Catalogue component type.\n\t * Used for dataset validation during Transfer Process initiation.\n\t * Validates that Agreements reference valid catalog datasets.\n\t * @default federated-catalogue\n\t */\n\tfederatedCatalogueComponentType?: string;\n\n\t/**\n\t * Logging component type.\n\t */\n\tloggingComponentType?: string;\n\n\t/**\n\t * Identity component type (for token signing/verification).\n\t * @default identity\n\t */\n\tidentityComponentType?: string;\n\n\t/**\n\t * Identity Authentication component type (for token validation).\n\t * @default identity-authentication\n\t */\n\tidentityAuthenticationComponentType?: string;\n\n\t/**\n\t * Trust component type for trust verification.\n\t * Used to verify JWT/VC tokens and extract identity information.\n\t * @default trust\n\t */\n\ttrustComponentType?: string;\n\n\t/**\n\t * Entity storage type for Transfer Process entities.\n\t * Used to persist transfer state for the consumerPid flow.\n\t * Must match the Data Plane's transferProcessEntityStorageType for shared storage.\n\t * @default transfer-process\n\t */\n\ttransferProcessEntityStorageType?: string;\n\n\t/**\n\t * Entity storage type for Dataspace App Dataset entities.\n\t * @default dataspace-app-dataset\n\t */\n\tdataspaceAppDatasetEntityStorageType?: string;\n\n\t/**\n\t * Task scheduler component type for periodic cleanup of stalled negotiations.\n\t * @default task-scheduler\n\t */\n\ttaskSchedulerComponentType?: string;\n\n\t/**\n\t * Data Plane component type, used to invoke push subscription lifecycle methods.\n\t * @default dataspace-data-plane\n\t */\n\tdataPlaneComponentType?: string;\n\n\t/**\n\t * Remote control plane component type used to make outbound DSP transfer requests.\n\t * Created dynamically via ComponentFactory.create() with the provider endpoint as config.\n\t * @default dataspace-control-plane-rest-client\n\t */\n\tremoteControlPlaneComponentType?: string;\n\n\t/**\n\t * Platform component type, used to retrieve public origin for constructing data plane URLs.\n\t * @default platform\n\t */\n\tplatformComponentType?: string;\n\n\t/**\n\t * The configuration of the Dataspace Control Plane Service.\n\t */\n\tconfig?: IDataspaceControlPlaneServiceConfig;\n}\n"]}
+{"version":3,"file":"IDataspaceControlPlaneServiceConstructorOptions.js","sourceRoot":"","sources":["../../../src/models/IDataspaceControlPlaneServiceConstructorOptions.ts"],"names":[],"mappings":"","sourcesContent":["// Copyright 2025 IOTA Stiftung.\n// SPDX-License-Identifier: Apache-2.0.\nimport type { IDataspaceControlPlaneServiceConfig } from \"./IDataspaceControlPlaneServiceConfig.js\";\n\n/**\n * Dataspace Control Plane service constructor options.\n */\nexport interface IDataspaceControlPlaneServiceConstructorOptions {\n\t/**\n\t * Policy Administration Point component type.\n\t * Used for Agreement lookup and validation during Transfer Process initiation.\n\t * @default policy-administration-point\n\t */\n\tpolicyAdministrationPointComponentType?: string;\n\n\t/**\n\t * Policy Negotiation Point component type.\n\t * Used for contract negotiation to create agreements before transfer processes.\n\t * @default policy-negotiation-point\n\t */\n\tpolicyNegotiationPointComponentType?: string;\n\n\t/**\n\t * Policy Negotiation Admin Point component type.\n\t * Used for querying negotiation history.\n\t * @default policy-negotiation-admin-point\n\t */\n\tpolicyNegotiationAdminPointComponentType?: string;\n\n\t/**\n\t * Federated Catalogue component type.\n\t * Used for dataset validation during Transfer Process initiation.\n\t * Validates that Agreements reference valid catalog datasets.\n\t * @default federated-catalogue\n\t */\n\tfederatedCatalogueComponentType?: string;\n\n\t/**\n\t * Logging component type.\n\t */\n\tloggingComponentType?: string;\n\n\t/**\n\t * Identity component type (for token signing/verification).\n\t * @default identity\n\t */\n\tidentityComponentType?: string;\n\n\t/**\n\t * Identity Authentication component type (for token validation).\n\t * @default identity-authentication\n\t */\n\tidentityAuthenticationComponentType?: string;\n\n\t/**\n\t * Trust component type for trust verification.\n\t * Used to verify JWT/VC tokens and extract identity information.\n\t * @default trust\n\t */\n\ttrustComponentType?: string;\n\n\t/**\n\t * Entity storage type for Transfer Process entities.\n\t * Used to persist transfer state for the consumerPid flow.\n\t * Must match the Data Plane's transferProcessEntityStorageType for shared storage.\n\t * @default transfer-process\n\t */\n\ttransferProcessEntityStorageType?: string;\n\n\t/**\n\t * Entity storage type for Dataspace App Dataset entities.\n\t * @default dataspace-app-dataset\n\t */\n\tdataspaceAppDatasetEntityStorageType?: string;\n\n\t/**\n\t * Task scheduler component type for periodic cleanup of stalled negotiations.\n\t * @default task-scheduler\n\t */\n\ttaskSchedulerComponentType?: string;\n\n\t/**\n\t * Data Plane component type, used to invoke push subscription lifecycle methods.\n\t * @default dataspace-data-plane\n\t */\n\tdataPlaneComponentType?: string;\n\n\t/**\n\t * Remote control plane component type used to make outbound DSP transfer requests.\n\t * Created dynamically via ComponentFactory.create() with the provider endpoint as config.\n\t * @default dataspace-control-plane-rest-client\n\t */\n\tremoteControlPlaneComponentType?: string;\n\n\t/**\n\t * Platform component type, used to retrieve public origin for constructing data plane URLs.\n\t * @default platform\n\t */\n\tplatformComponentType?: string;\n\n\t/**\n\t * The component type for the optional telemetry component used for metrics, defaults to no telemetry.\n\t */\n\ttelemetryComponentType?: string;\n\n\t/**\n\t * The configuration of the Dataspace Control Plane Service.\n\t */\n\tconfig?: IDataspaceControlPlaneServiceConfig;\n}\n"]}

package/dist/types/dataspaceControlPlaneService.d.ts

@@ -1,4 +1,4 @@
-import { type IDataspaceControlPlaneComponent, type IDataspaceControlPlaneResolverComponent, type INegotiationCallback, type ITransferCallback, type IDataspaceAppDataset, type ITransferContext } from "@twin.org/dataspace-models";
+import { type IDataspaceAppDataset, type IDataspaceControlPlaneComponent, type IDataspaceControlPlaneResolverComponent, type INegotiationCallback, type ITransferCallback, type ITransferContext } from "@twin.org/dataspace-models";
 import { type IDataspaceProtocolContractNegotiation, type IDataspaceProtocolContractNegotiationError, type IDataspaceProtocolDataset, type IDataspaceProtocolTransferCompletionMessage, type IDataspaceProtocolTransferError, type IDataspaceProtocolTransferProcess, type IDataspaceProtocolTransferRequestMessage, type IDataspaceProtocolTransferStartMessage, type IDataspaceProtocolTransferSuspensionMessage, type IDataspaceProtocolTransferTerminationMessage } from "@twin.org/standards-dataspace-protocol";
 import type { IDataspaceControlPlaneServiceConstructorOptions } from "./models/IDataspaceControlPlaneServiceConstructorOptions.js";
 /**
@@ -63,18 +63,16 @@ export declare class DataspaceControlPlaneService implements IDataspaceControlPl
      * Request a Transfer Process.
      * Creates a new Transfer Process in REQUESTED state.
      * @param request Transfer request message (DSP compliant).
-     * @param publicOrigin The public origin of this provider node, resolved by the REST route from the
-     * hosting component; used to build the data-plane endpoint when auto-starting.
      * @param options Request options.
      * @param options.autoStart When true, the provider immediately starts the requested transfer (scheduled
      * on the next tick); when omitted/false the provider start must be triggered explicitly.
-     * @param trustPayload Trust payload containing authorization information (Base64-encoded token).
+     * @param trustPayload Trust payload containing authorization information.
      * @returns Transfer Process (DSP compliant) with state REQUESTED, or TransferError if the operation fails.
      *
      * Role Performed: Provider
      * Called by: Consumer when it wants to request a new Transfer Process
      */
-    requestTransfer(request: IDataspaceProtocolTransferRequestMessage, publicOrigin: string, options: {
+    requestTransfer(request: IDataspaceProtocolTransferRequestMessage, options: {
         autoStart?: boolean;
     } | undefined, trustPayload: unknown): Promise<IDataspaceProtocolTransferProcess | IDataspaceProtocolTransferError>;
     /**
@@ -83,7 +81,6 @@ export declare class DataspaceControlPlaneService implements IDataspaceControlPl
      * and (only if the provider accepts) persists a local TransferProcess in REQUESTED state.
      * @param agreementId The finalized agreement ID from contract negotiation.
      * @param providerEndpoint The provider's DSP control plane base URL.
-     * @param publicOrigin The public origin URL of this control plane (used as callbackAddress).
      * @param format The transfer format (e.g. "HttpData-PULL", "HttpData-PUSH").
      * @param trustPayload Trust payload for authenticating this call.
      * @returns The consumerPid of the newly created TransferProcess.
@@ -96,20 +93,19 @@ export declare class DataspaceControlPlaneService implements IDataspaceControlPl
      * registration ignores the runtime `endpoint` arg and silently POSTs to its
      * static endpoint instead.
      */
-    prepareTransfer(agreementId: string, providerEndpoint: string, publicOrigin: string, format: string, trustPayload: unknown): Promise<{
+    prepareTransfer(agreementId: string, providerEndpoint: string, format: string, trustPayload: unknown): Promise<{
         consumerPid: string;
     }>;
     /**
      * Start a Transfer Process.
      * Transitions Transfer Process from REQUESTED to STARTED state or resumes from SUSPENDED state.
      * @param message Transfer start message (DSP compliant).
-     * @param publicOrigin The public origin URL of this service.
-     * @param trustPayload Trust payload containing authorization information (Base64-encoded token).
+     * @param trustPayload Trust payload containing authorization information.
      * @returns Transfer Start Message (DSP compliant) with dataAddress for PULL transfers, or TransferError if the operation fails.
      *
      * Role Performed: Provider / Consumer
      */
-    startTransfer(message: IDataspaceProtocolTransferStartMessage, publicOrigin: string, trustPayload: unknown): Promise<IDataspaceProtocolTransferStartMessage | IDataspaceProtocolTransferError>;
+    startTransfer(message: IDataspaceProtocolTransferStartMessage, trustPayload: unknown): Promise<IDataspaceProtocolTransferStartMessage | IDataspaceProtocolTransferError>;
     /**
      * Start a Transfer Process as the Provider.
      * Builds a TransferStartMessage for a transfer already accepted by this node (REQUESTED, or
@@ -119,36 +115,35 @@ export declare class DataspaceControlPlaneService implements IDataspaceControlPl
      * the provider, builds the dataAddress for PULL, persists STARTED, and delivers to the consumer).
      * This is the provider-side mirror of prepareTransfer.
      * @param pid The Process ID (consumerPid or providerPid) identifying the transfer to start.
-     * @param publicOrigin The public origin URL of this provider node (used to build the data plane endpoint for PULL transfers).
      * @param trustPayload Trust payload proving the caller is the provider.
      * @returns Transfer Start Message (DSP compliant) with dataAddress for PULL transfers, or TransferError if the operation fails.
      */
-    transferStarted(pid: string, publicOrigin: string, trustPayload: unknown): Promise<IDataspaceProtocolTransferStartMessage | IDataspaceProtocolTransferError>;
+    transferStarted(pid: string, trustPayload: unknown): Promise<IDataspaceProtocolTransferStartMessage | IDataspaceProtocolTransferError>;
     /**
      * Complete a Transfer Process.
      * @param message Transfer completion message (DSP compliant).
-     * @param trustPayload Trust payload containing authorization information (Base64-encoded token).
+     * @param trustPayload Trust payload containing authorization information.
      * @returns Transfer Process (DSP compliant) with state COMPLETED, or TransferError if the operation fails.
      */
     completeTransfer(message: IDataspaceProtocolTransferCompletionMessage, trustPayload: unknown): Promise<IDataspaceProtocolTransferProcess | IDataspaceProtocolTransferError>;
     /**
      * Suspend a Transfer Process.
      * @param message Transfer suspension message (DSP compliant).
-     * @param trustPayload Trust payload containing authorization information (Base64-encoded token).
+     * @param trustPayload Trust payload containing authorization information.
      * @returns Transfer Process (DSP compliant) with state SUSPENDED, or TransferError if the operation fails.
      */
     suspendTransfer(message: IDataspaceProtocolTransferSuspensionMessage, trustPayload: unknown): Promise<IDataspaceProtocolTransferProcess | IDataspaceProtocolTransferError>;
     /**
      * Terminate a Transfer Process.
      * @param message Transfer termination message (DSP compliant).
-     * @param trustPayload Trust payload containing authorization information (Base64-encoded token).
+     * @param trustPayload Trust payload containing authorization information.
      * @returns Transfer Process (DSP compliant) with state TERMINATED, or TransferError if the operation fails.
      */
     terminateTransfer(message: IDataspaceProtocolTransferTerminationMessage, trustPayload: unknown): Promise<IDataspaceProtocolTransferProcess | IDataspaceProtocolTransferError>;
     /**
      * Get Transfer Process state.
      * @param pid Process ID (consumerPid or providerPid).
-     * @param trustPayload Trust payload containing authorization information (Base64-encoded token).
+     * @param trustPayload Trust payload containing authorization information.
      * @returns Transfer Process (DSP compliant) with current state, or TransferError if the operation fails.
      */
     getTransferProcess(pid: string, trustPayload: unknown): Promise<IDataspaceProtocolTransferProcess | IDataspaceProtocolTransferError>;
@@ -160,11 +155,10 @@ export declare class DataspaceControlPlaneService implements IDataspaceControlPl
      * @param datasetId The dataset ID from the provider's catalog.
      * @param offerId The offer ID from the provider's catalog.
      * @param providerEndpoint The provider's contract negotiation endpoint URL.
-     * @param publicOrigin The public origin URL of this control plane (for callbacks).
      * @param trustPayload The trust payload for authentication.
      * @returns The negotiation ID. Use the registered callback for completion notification.
      */
-    negotiateAgreement(datasetId: string, offerId: string, providerEndpoint: string, publicOrigin: string, trustPayload: unknown): Promise<{
+    negotiateAgreement(datasetId: string, offerId: string, providerEndpoint: string, trustPayload: unknown): Promise<{
         negotiationId: string;
     }>;
     /**
@@ -194,14 +188,14 @@ export declare class DataspaceControlPlaneService implements IDataspaceControlPl
     /**
      * Resolve consumerPid to Transfer Context.
      * @param consumerPid Consumer Process ID.
-     * @param trustPayload Trust payload containing authorization information (Base64-encoded token).
+     * @param trustPayload Trust payload containing authorization information.
      * @returns Transfer Context with Agreement, datasetId, and Transfer Process metadata.
      */
     resolveConsumerPid(consumerPid: string, trustPayload: unknown): Promise<ITransferContext>;
     /**
      * Resolve providerPid to Transfer Context.
      * @param providerPid Provider Process ID.
-     * @param trustPayload Trust payload containing authorization information (Base64-encoded token).
+     * @param trustPayload Trust payload containing authorization information.
      * @returns Transfer Context with Agreement, datasetId, and Transfer Process metadata.
      */
     resolveProviderPid(providerPid: string, trustPayload: unknown): Promise<ITransferContext>;

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

@@ -9,7 +9,7 @@ export interface IDataspaceControlPlaneServiceConfig {
     overrideTrustGeneratorType?: string;
     /**
      * Data plane endpoint path for PULL transfers (path only, not full URL).
-     * Will be combined with the public origin from the hosting component.
+     * Will be combined with the public origin.
      *
      * REQUIRED if PULL transfers are supported.
      * If not specified, PULL transfers will not be available.

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

@@ -81,6 +81,10 @@ export interface IDataspaceControlPlaneServiceConstructorOptions {
      * @default platform
      */
     platformComponentType?: string;
+    /**
+     * The component type for the optional telemetry component used for metrics, defaults to no telemetry.
+     */
+    telemetryComponentType?: string;
     /**
      * The configuration of the Dataspace Control Plane Service.
      */

package/docs/changelog.md

@@ -1,5 +1,34 @@
 # Changelog
 
+## [0.0.3-next.49](https://github.com/iotaledger/twin-dataspace/compare/dataspace-control-plane-service-v0.0.3-next.48...dataspace-control-plane-service-v0.0.3-next.49) (2026-06-19)
+
+
+### Features
+
+* 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))
+* remove datasetsHandled method from apps ([9fdc950](https://github.com/iotaledger/twin-dataspace/commit/9fdc95018d38ab49c4a1094642be2ee83ee0e4cd))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/dataspace-models bumped from 0.0.3-next.48 to 0.0.3-next.49
+
+## [0.0.3-next.48](https://github.com/iotaledger/twin-dataspace/compare/dataspace-control-plane-service-v0.0.3-next.47...dataspace-control-plane-service-v0.0.3-next.48) (2026-06-18)
+
+
+### Features
+
+* remove hosting component ([#209](https://github.com/iotaledger/twin-dataspace/issues/209)) ([5e19328](https://github.com/iotaledger/twin-dataspace/commit/5e1932823aa8a0f88f559f096610b9df1f3b8615))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/dataspace-models bumped from 0.0.3-next.47 to 0.0.3-next.48
+
 ## [0.0.3-next.47](https://github.com/iotaledger/twin-dataspace/compare/dataspace-control-plane-service-v0.0.3-next.46...dataspace-control-plane-service-v0.0.3-next.47) (2026-06-17)
 
 

package/docs/reference/classes/DataspaceControlPlaneService.md

@@ -223,7 +223,7 @@ A promise that resolves when the cleanup task has been removed.
 
 ### requestTransfer() {#requesttransfer}
 
-> **requestTransfer**(`request`, `publicOrigin`, `options`, `trustPayload`): `Promise`\<`IDataspaceProtocolTransferError` \| `IDataspaceProtocolTransferProcess`\>
+> **requestTransfer**(`request`, `options`, `trustPayload`): `Promise`\<`IDataspaceProtocolTransferError` \| `IDataspaceProtocolTransferProcess`\>
 
 Request a Transfer Process.
 Creates a new Transfer Process in REQUESTED state.
@@ -236,13 +236,6 @@ Creates a new Transfer Process in REQUESTED state.
 
 Transfer request message (DSP compliant).
 
-##### publicOrigin
-
-`string`
-
-The public origin of this provider node, resolved by the REST route from the
-hosting component; used to build the data-plane endpoint when auto-starting.
-
 ##### options
 
 \{ `autoStart?`: `boolean`; \} \| `undefined`
@@ -289,7 +282,7 @@ Called by: Consumer when it wants to request a new Transfer Process
 
 ### prepareTransfer() {#preparetransfer}
 
-> **prepareTransfer**(`agreementId`, `providerEndpoint`, `publicOrigin`, `format`, `trustPayload`): `Promise`\<\{ `consumerPid`: `string`; \}\>
+> **prepareTransfer**(`agreementId`, `providerEndpoint`, `format`, `trustPayload`): `Promise`\<\{ `consumerPid`: `string`; \}\>
 
 Prepare a data transfer as a Consumer.
 Generates a consumerPid, POSTs a TransferRequestMessage to the provider's DSP endpoint,
@@ -309,12 +302,6 @@ The finalized agreement ID from contract negotiation.
 
 The provider's DSP control plane base URL.
 
-##### publicOrigin
-
-`string`
-
-The public origin URL of this control plane (used as callbackAddress).
-
 ##### format
 
 `string`
@@ -349,7 +336,7 @@ static endpoint instead.
 
 ### startTransfer() {#starttransfer}
 
-> **startTransfer**(`message`, `publicOrigin`, `trustPayload`): `Promise`\<`IDataspaceProtocolTransferError` \| `IDataspaceProtocolTransferStartMessage`\>
+> **startTransfer**(`message`, `trustPayload`): `Promise`\<`IDataspaceProtocolTransferError` \| `IDataspaceProtocolTransferStartMessage`\>
 
 Start a Transfer Process.
 Transitions Transfer Process from REQUESTED to STARTED state or resumes from SUSPENDED state.
@@ -362,12 +349,6 @@ Transitions Transfer Process from REQUESTED to STARTED state or resumes from SUS
 
 Transfer start message (DSP compliant).
 
-##### publicOrigin
-
-`string`
-
-The public origin URL of this service.
-
 ##### trustPayload
 
 `unknown`
@@ -390,7 +371,7 @@ Role Performed: Provider / Consumer
 
 ### transferStarted() {#transferstarted}
 
-> **transferStarted**(`pid`, `publicOrigin`, `trustPayload`): `Promise`\<`IDataspaceProtocolTransferError` \| `IDataspaceProtocolTransferStartMessage`\>
+> **transferStarted**(`pid`, `trustPayload`): `Promise`\<`IDataspaceProtocolTransferError` \| `IDataspaceProtocolTransferStartMessage`\>
 
 Start a Transfer Process as the Provider.
 Builds a TransferStartMessage for a transfer already accepted by this node (REQUESTED, or
@@ -408,12 +389,6 @@ This is the provider-side mirror of prepareTransfer.
 
 The Process ID (consumerPid or providerPid) identifying the transfer to start.
 
-##### publicOrigin
-
-`string`
-
-The public origin URL of this provider node (used to build the data plane endpoint for PULL transfers).
-
 ##### trustPayload
 
 `unknown`
@@ -562,7 +537,7 @@ Transfer Process (DSP compliant) with current state, or TransferError if the ope
 
 ### negotiateAgreement() {#negotiateagreement}
 
-> **negotiateAgreement**(`datasetId`, `offerId`, `providerEndpoint`, `publicOrigin`, `trustPayload`): `Promise`\<\{ `negotiationId`: `string`; \}\>
+> **negotiateAgreement**(`datasetId`, `offerId`, `providerEndpoint`, `trustPayload`): `Promise`\<\{ `negotiationId`: `string`; \}\>
 
 Negotiate a contract agreement with a provider.
 Returns immediately with a negotiationId. The caller is notified
@@ -588,12 +563,6 @@ The offer ID from the provider's catalog.
 
 The provider's contract negotiation endpoint URL.
 
-##### publicOrigin
-
-`string`
-
-The public origin URL of this control plane (for callbacks).
-
 ##### trustPayload
 
 `unknown`

package/docs/reference/interfaces/IDataspaceControlPlaneServiceConfig.md

@@ -18,7 +18,7 @@ If not specified, the default trust generator configured in the trust component
 > `optional` **dataPlanePath?**: `string`
 
 Data plane endpoint path for PULL transfers (path only, not full URL).
-Will be combined with the public origin from the hosting component.
+Will be combined with the public origin.
 
 REQUIRED if PULL transfers are supported.
 If not specified, PULL transfers will not be available.

package/docs/reference/interfaces/IDataspaceControlPlaneServiceConstructorOptions.md

@@ -203,6 +203,14 @@ platform
 
 ***
 
+### telemetryComponentType? {#telemetrycomponenttype}
+
+> `optional` **telemetryComponentType?**: `string`
+
+The component type for the optional telemetry component used for metrics, defaults to no telemetry.
+
+***
+
 ### config? {#config}
 
 > `optional` **config?**: [`IDataspaceControlPlaneServiceConfig`](IDataspaceControlPlaneServiceConfig.md)

package/locales/en.json

@@ -71,7 +71,7 @@
 			"invalidTransferSuspensionMessage": "Transfer Suspension Message does not conform to Dataspace Protocol specification",
 			"invalidTransferTerminationMessage": "Transfer Termination Message does not conform to Dataspace Protocol specification",
 			"agreementLookupFailed": "Failed to lookup Agreement: {agreementId}",
-			"agreementNotFound": "Agreement not found",
+			"agreementNotFound": "Agreement not found \"{notFoundId}\"",
 			"agreementMissingTarget": "Agreement is missing target (dataset): {agreementId}",
 			"agreementMultipleTargetsNotSupported": "Agreement has multiple targets which is not supported. Only single target Agreements are allowed: {agreementId}, target count: {targetCount}",
 			"agreementTargetMissingUid": "Agreement target object is missing required \"uid\" property: {agreementId}",

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@twin.org/dataspace-control-plane-service",
-	"version": "0.0.3-next.47",
+	"version": "0.0.3-next.49",
 	"description": "Implements agreement negotiation and transfer process lifecycle management for control plane operations.",
 	"repository": {
 		"type": "git",
@@ -19,7 +19,7 @@
 		"@twin.org/context": "next",
 		"@twin.org/core": "next",
 		"@twin.org/crypto": "next",
-		"@twin.org/dataspace-models": "0.0.3-next.47",
+		"@twin.org/dataspace-models": "0.0.3-next.49",
 		"@twin.org/entity": "next",
 		"@twin.org/entity-storage-models": "next",
 		"@twin.org/federated-catalogue-models": "next",
@@ -28,6 +28,7 @@
 		"@twin.org/rights-management-models": "next",
 		"@twin.org/standards-dataspace-protocol": "next",
 		"@twin.org/standards-w3c-odrl": "next",
+		"@twin.org/telemetry-models": "next",
 		"@twin.org/trust-models": "next",
 		"@twin.org/vault-models": "next"
 	},