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

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

@@ -66,7 +66,7 @@ export declare class DataspaceControlPlaneService implements IDataspaceControlPl
      * @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
@@ -100,7 +100,7 @@ export declare class DataspaceControlPlaneService implements IDataspaceControlPl
      * 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 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
@@ -122,28 +122,28 @@ export declare class DataspaceControlPlaneService implements IDataspaceControlPl
     /**
      * 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>;
@@ -188,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/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,20 @@
 # 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)
 
 

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.48",
+	"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.48",
+		"@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"
 	},