@twin.org/dataspace-data-plane-service 0.0.3-next.28 → 0.0.3-next.30

package/docs/reference/interfaces/IDataspaceDataPlaneServiceConfig.md

@@ -43,3 +43,60 @@ The number of times to retry failed tasks, defaults to forever.
 ```ts
 undefined.
 ```
+
+***
+
+### pushRetryCount? {#pushretrycount}
+
+> `optional` **pushRetryCount?**: `number`
+
+Max HTTP retry attempts per push delivery task execution.
+
+#### Default
+
+```ts
+3
+```
+
+***
+
+### pushRetryBaseDelayMs? {#pushretrybasedelayms}
+
+> `optional` **pushRetryBaseDelayMs?**: `number`
+
+Base delay (ms) for exponential backoff between push HTTP retries.
+Effective delay = baseDelayMs * 2^attempt.
+
+#### Default
+
+```ts
+1000
+```
+
+***
+
+### pushTimeoutMs? {#pushtimeoutms}
+
+> `optional` **pushTimeoutMs?**: `number`
+
+Timeout (ms) for each push delivery HTTP POST request.
+
+#### Default
+
+```ts
+30000
+```
+
+***
+
+### pushSubscriptionCleanupIntervalMs? {#pushsubscriptioncleanupintervalms}
+
+> `optional` **pushSubscriptionCleanupIntervalMs?**: `number`
+
+Interval (ms) between orphaned PushSubscription cleanup scans.
+
+#### Default
+
+```ts
+3600000 (1 hour)
+```

package/docs/reference/interfaces/IDataspaceDataPlaneServiceConstructorOptions.md

@@ -89,6 +89,20 @@ transfer-process
 
 ***
 
+### pushSubscriptionEntityStorageType? {#pushsubscriptionentitystoragetype}
+
+> `optional` **pushSubscriptionEntityStorageType?**: `string`
+
+The entity storage type for PushSubscription entities.
+
+#### Default
+
+```ts
+push-subscription
+```
+
+***
+
 ### dataspaceAppDatasetEntityStorageType? {#dataspaceappdatasetentitystoragetype}
 
 > `optional` **dataspaceAppDatasetEntityStorageType?**: `string`

package/locales/en.json

@@ -13,16 +13,34 @@
 			"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",
+			"transferMissingDataAddress": "Transfer Process is missing a valid push dataAddress endpoint (consumerPid: {consumerPid})",
+			"pushSubscriptionMissingTenantToken": "Push subscription setup rejected: consumer endpoint does not carry an `x-enc-tenant-token` query parameter (consumerPid: {consumerPid}, endpoint: {endpoint}). On multi-tenant publishers the consumer must bake its tenant token before sending the dataAddress.",
+			"pushSubscriptionStorageNotRegistered": "Push-mode transfer requires push-subscription storage to be registered (entity-storage key: \"push-subscription\"). This deployment was configured without it — register the storage to enable push, or use pull-mode transfers only.",
 			"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"
+			"missingHandleActivity": "Handler App \"{dataspaceAppId}\" does not export a \"handleActivity\" function",
+			"pushSubscriptionNotFound": "Push subscription not found for consumerPid \"{notFoundId}\"",
+			"pushActivityNotAuthorized": "Unauthorized push activity — no matching STARTED transfer found for the activity generator",
+			"processOutboxActivityMultipleTo": "processOutboxActivity does not support multiple recipients — activity.to contains {count} values, expected exactly one consumerPid",
+			"pushSubscriptionCompensationFailed": "Compensating unsubscribeToData failed after push-subscription storage write failed (consumerPid: {consumerPid}, providerPid: {providerPid}) — app may be left with a dangling Follow until orphan cleanup runs"
 		}
 	},
 	"info": {
 		"dataspaceDataPlaneService": {
 			"scheduledTask": "\"{taskId}\": Task scheduled for Dataspace App \"{dataspaceAppId}\" (isRetry: {isRetry})",
-			"policyObligationTriggered": "Policy obligation triggered for agreement \"{agreementId}\": action=\"{action}\", target=\"{target}\""
+			"policyObligationTriggered": "Policy obligation triggered for agreement \"{agreementId}\": action=\"{action}\", target=\"{target}\"",
+			"pushSubscriptionCreated": "Push subscription created (consumerPid: {consumerPid}, providerPid: {providerPid})",
+			"pushSubscriptionSuspended": "Push subscription suspended (consumerPid: {consumerPid})",
+			"pushSubscriptionResumed": "Push subscription resumed (consumerPid: {consumerPid})",
+			"pushSubscriptionTornDown": "Push subscription torn down (consumerPid: {consumerPid}, providerPid: {providerPid})",
+			"pushDeliveryTaskScheduled": "Push delivery task scheduled (taskId: {taskId}, consumerPid: {consumerPid})"
+		}
+	},
+	"warn": {
+		"dataspaceDataPlaneService": {
+			"pushSubscriptionNotFoundOnTeardown": "Push subscription not found for consumerPid \"{consumerPid}\" during teardown — treating as no-op",
+			"pushSubscriptionNotFoundForActivity": "Push subscription not found for outbound activity (consumerPid: {consumerPid})"
 		}
 	},
 	"debug": {
@@ -33,7 +51,9 @@
 			"engineCloneStart": "'start' method has been called from an engine clone. No task scheduler created",
 			"cleanUpOngoing": "There is an ongoing clean up of activity logs. Skipping",
 			"activityLogCleanedUp": "Activity Log has been cleaned up. \"{numRecordsDeleted}\" records deleted",
-			"replacingFailedTasks": "Retrying apps \"{appsToRetry}\" (successful: \"{successfulApps}\") for activity \"{activityLogEntryId}\""
+			"pushSubscriptionsCleanedUp": "Orphaned push subscriptions cleaned up. \"{numDeleted}\" records deleted",
+			"replacingFailedTasks": "Retrying apps \"{appsToRetry}\" (successful: \"{successfulApps}\") for activity \"{activityLogEntryId}\"",
+			"pushDeliverySkippedPaused": "Push delivery skipped — subscription is paused (consumerPid: {consumerPid})"
 		},
 		"dataspaceDataPlaneSocketRoutes": {
 			"activityLogStatusConnected": "Web Socket Connected: Socket Id: \"{socketId}\"",

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@twin.org/dataspace-data-plane-service",
-	"version": "0.0.3-next.28",
+	"version": "0.0.3-next.30",
 	"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.28",
-		"@twin.org/dataspace-models": "0.0.3-next.28",
+		"@twin.org/dataspace-app-runner": "0.0.3-next.30",
+		"@twin.org/dataspace-models": "0.0.3-next.30",
 		"@twin.org/engine-models": "next",
 		"@twin.org/entity": "next",
 		"@twin.org/entity-storage-models": "next",