@twin.org/dataspace-data-plane-service 0.0.3-next.24 → 0.0.3-next.26

package/docs/open-api/spec.json

@@ -62,8 +62,15 @@
 					}
 				},
 				"responses": {
-					"201": {
-						"description": "The rest request ended in created response."
+					"200": {
+						"description": "Activity Stream Notify Response.",
+						"content": {
+							"application/json": {
+								"schema": {
+									"$ref": "#/components/schemas/ActivityLogEntry"
+								}
+							}
+						}
 					},
 					"400": {
 						"description": "The server cannot process the request, see the content for more details.",
@@ -184,15 +191,13 @@
 											"dateModified": "2025-08-12T12:00:00Z",
 											"generator": "did:iota:testnet:123456",
 											"status": "pending",
-											"pendingTasks": [
+											"tasks": [
 												{
 													"taskId": "urn:x-task-id:45678",
-													"dataspaceAppId": "https://my-app.example.org/app1"
+													"dataspaceAppId": "https://my-app.example.org/app1",
+													"status": "pending"
 												}
-											],
-											"runningTasks": [],
-											"finalizedTasks": [],
-											"inErrorTasks": []
+											]
 										}
 									}
 								}
@@ -531,23 +536,6 @@
 	},
 	"components": {
 		"schemas": {
-			"ActivityLogDates": {
-				"description": "Activity log dates.",
-				"type": "object",
-				"properties": {
-					"startDate": {
-						"type": "string",
-						"description": "Task processing start timestamp"
-					},
-					"endDate": {
-						"type": "string",
-						"description": "Task processing end timestamp"
-					}
-				},
-				"required": [
-					"startDate"
-				]
-			},
 			"ActivityLogDetails": {
 				"description": "The details related to the processing of an Activity",
 				"type": "object",
@@ -571,10 +559,6 @@
 					"dateModified": {
 						"type": "string",
 						"description": "The last update date of this object."
-					},
-					"retryCount": {
-						"type": "number",
-						"description": "Number of times this activity has been retried."
 					}
 				},
 				"required": [
@@ -591,71 +575,12 @@
 					"status": {
 						"$ref": "#/components/schemas/ActivityProcessingStatus"
 					},
-					"pendingTasks": {
+					"tasks": {
 						"type": "array",
 						"items": {
-							"$ref": "#/components/schemas/TaskApp"
+							"$ref": "#/components/schemas/ActivityTaskEntry"
 						},
-						"description": "The pending tasks that have to be run to process the Activity."
-					},
-					"runningTasks": {
-						"type": "array",
-						"items": {
-							"type": "object",
-							"allOf": [
-								{
-									"$ref": "#/components/schemas/TaskApp"
-								},
-								{
-									"$ref": "#/components/schemas/ActivityLogDates"
-								}
-							]
-						},
-						"description": "The running tasks that are processing the Activity."
-					},
-					"finalizedTasks": {
-						"type": "array",
-						"items": {
-							"type": "object",
-							"properties": {
-								"result": {
-									"type": "string",
-									"description": "The task result."
-								}
-							},
-							"required": [
-								"result"
-							],
-							"allOf": [
-								{
-									"$ref": "#/components/schemas/TaskApp"
-								},
-								{
-									"$ref": "#/components/schemas/ActivityLogDates"
-								}
-							]
-						},
-						"description": "The tasks that have already finalized."
-					},
-					"inErrorTasks": {
-						"type": "array",
-						"items": {
-							"type": "object",
-							"properties": {
-								"error": {
-									"$ref": "#/components/schemas/Error"
-								}
-							},
-							"required": [
-								"error"
-							],
-							"allOf": [
-								{
-									"$ref": "#/components/schemas/TaskApp"
-								}
-							]
-						},
-						"description": "The tasks that are in error."
+						"description": "The tasks that have to be run to process the Activity."
 					}
 				},
 				"required": [
@@ -692,6 +617,67 @@
 					}
 				]
 			},
+			"ActivityTaskEntry": {
+				"description": "Denotes a task associated with a Dataspace App",
+				"type": "object",
+				"properties": {
+					"taskId": {
+						"type": "string",
+						"description": "Task Id."
+					},
+					"dataspaceAppId": {
+						"type": "string",
+						"description": "Dataspace App Id."
+					},
+					"status": {
+						"$ref": "#/components/schemas/ActivityTaskStatus"
+					},
+					"processingGroupId": {
+						"type": "string",
+						"description": "Processing Group Id."
+					},
+					"startDate": {
+						"type": "string",
+						"description": "Task processing start timestamp"
+					},
+					"endDate": {
+						"type": "string",
+						"description": "Task processing end timestamp"
+					},
+					"result": {
+						"description": "The result of the task processing, if completed."
+					},
+					"error": {
+						"$ref": "#/components/schemas/Error"
+					}
+				},
+				"required": [
+					"taskId",
+					"dataspaceAppId",
+					"status"
+				]
+			},
+			"ActivityTaskStatus": {
+				"description": "Activity task statuses.",
+				"anyOf": [
+					{
+						"const": "pending",
+						"description": "Pending."
+					},
+					{
+						"const": "processing",
+						"description": "Processing."
+					},
+					{
+						"const": "success",
+						"description": "Success."
+					},
+					{
+						"const": "failed",
+						"description": "Failed."
+					}
+				]
+			},
 			"DataAssetItemList": {
 				"description": "Interface describing a list of entities that are within a Data Asset.\nPagination is handled via HTTP Link headers.",
 				"type": "object",
@@ -792,24 +778,6 @@
 					"type",
 					"q"
 				]
-			},
-			"TaskApp": {
-				"description": "Denotes a task associated with a Dataspace App",
-				"type": "object",
-				"properties": {
-					"taskId": {
-						"type": "string",
-						"description": "Task Id."
-					},
-					"dataspaceAppId": {
-						"type": "string",
-						"description": "Dataspace App Id."
-					}
-				},
-				"required": [
-					"taskId",
-					"dataspaceAppId"
-				]
 			}
 		},
 		"securitySchemes": {

package/docs/reference/classes/ActivityLogDetails.md

@@ -59,11 +59,3 @@ The last update date.
 > `optional` **retainUntil?**: `number`
 
 The timestamp of when to retain the entry until.
-
-***
-
-### retryCount? {#retrycount}
-
-> `optional` **retryCount?**: `number`
-
-Number of times this activity has been retried.

package/docs/reference/classes/ActivityTask.md

@@ -24,6 +24,6 @@ The entry Id.
 
 ### associatedTasks {#associatedtasks}
 
-> **associatedTasks**: `ITaskApp`[]
+> **associatedTasks**: `IActivityTaskEntry`[]
 
 The tasks.

package/docs/reference/classes/DataspaceDataPlaneService.md

@@ -80,7 +80,7 @@ The node logging component type.
 
 ### notifyActivity() {#notifyactivity}
 
-> **notifyActivity**(`activity`): `Promise`\<`string`\>
+> **notifyActivity**(`activity`): `Promise`\<`string` \| `IActivityLogEntry`\>
 
 Notify an Activity.
 
@@ -94,9 +94,9 @@ The Activity notified.
 
 #### Returns
 
-`Promise`\<`string`\>
+`Promise`\<`string` \| `IActivityLogEntry`\>
 
-The Activity's Log Entry identifier.
+The activity's id or entry.
 
 #### Implementation of
 

package/docs/reference/functions/activityStreamNotify.md

@@ -1,6 +1,6 @@
 # Function: activityStreamNotify()
 
-> **activityStreamNotify**(`baseRouteName`, `httpRequestContext`, `factoryServiceName`, `request`): `Promise`\<`ICreatedResponse`\>
+> **activityStreamNotify**(`baseRouteName`, `httpRequestContext`, `factoryServiceName`, `request`): `Promise`\<`IActivityStreamNotifyResponse`\>
 
 Notify a new Activity to the Dataspace Data Plane Activity Stream.
 
@@ -32,6 +32,6 @@ The request.
 
 ## Returns
 
-`Promise`\<`ICreatedResponse`\>
+`Promise`\<`IActivityStreamNotifyResponse`\>
 
 The response object with additional http response properties.

package/docs/reference/interfaces/IDataspaceDataPlaneServiceConfig.md

@@ -29,3 +29,17 @@ The interval in minutes in between activity log clean ups. -1 indicates no clean
 ```ts
 60 minutes
 ```
+
+***
+
+### retryCount? {#retrycount}
+
+> `optional` **retryCount?**: `number`
+
+The number of times to retry failed tasks, defaults to forever.
+
+#### Default
+
+```ts
+undefined.
+```

package/docs/reference/interfaces/IDataspaceDataPlaneServiceConstructorOptions.md

@@ -125,6 +125,20 @@ policy-enforcement-point-service
 
 ***
 
+### tenantAdminType? {#tenantadmintype}
+
+> `optional` **tenantAdminType?**: `string`
+
+Tenant admin component type.
+
+#### Default
+
+```ts
+tenant-admin
+```
+
+***
+
 ### config? {#config}
 
 > `optional` **config?**: [`IDataspaceDataPlaneServiceConfig`](IDataspaceDataPlaneServiceConfig.md)

package/locales/en.json

@@ -6,7 +6,6 @@
 			"activityStillProcessing": "Activity is still being processed",
 			"noFailedTasksToRetry": "Activity has error status but no failed tasks to retry",
 			"invalidActivityGeneratorIdentity": "Invalid activity. No identity specified either on 'generator' or 'actor'",
-			"unknownActivityLogEntryId": "Unknown Activity Log Entry Id \"{activityLogEntryId}\"",
 			"tooManyAppsRegistered": "There are several DS Apps registered for Dataset \"{datasetId}\"",
 			"noAppRegistered": "There are no DS Apps registered for Dataset \"{datasetId}\"",
 			"notExpandableType": "Entity type \"{type}\" cannot be expanded",
@@ -14,7 +13,10 @@
 			"transferProcessNotFound": "Transfer Process not found for consumerPid \"{notFoundId}\"",
 			"transferNotInStartedState": "Transfer Process is not in STARTED state. Current state: \"{currentState}\"",
 			"transferMissingDatasetId": "Transfer Process is missing datasetId",
-			"schemaNotFound": "Schema \"{schemaId}\" not found"
+			"schemaNotFound": "Schema \"{schemaId}\" not found",
+			"cleanupFailed": "Error occurred during cleanup of activity logs",
+			"invalidProcessingGroupId": "Invalid processing group id \"{processingGroupId}\" specified in activity query",
+			"missingHandleActivity": "Handler App \"{dataspaceAppId}\" does not export a \"handleActivity\" function"
 		}
 	},
 	"info": {

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@twin.org/dataspace-data-plane-service",
-	"version": "0.0.3-next.24",
+	"version": "0.0.3-next.26",
 	"description": "Processes activities and data requests while enforcing transfer and policy constraints in the data plane.",
 	"repository": {
 		"type": "git",
@@ -21,8 +21,8 @@
 		"@twin.org/crypto": "next",
 		"@twin.org/data-core": "next",
 		"@twin.org/data-json-ld": "next",
-		"@twin.org/dataspace-app-runner": "0.0.3-next.24",
-		"@twin.org/dataspace-models": "0.0.3-next.24",
+		"@twin.org/dataspace-app-runner": "0.0.3-next.26",
+		"@twin.org/dataspace-models": "0.0.3-next.26",
 		"@twin.org/engine-models": "next",
 		"@twin.org/entity": "next",
 		"@twin.org/entity-storage-models": "next",