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

package/dist/es/entities/pushSubscription.js

@@ -0,0 +1,83 @@
+// Copyright 2025 IOTA Stiftung.
+// SPDX-License-Identifier: Apache-2.0.
+import { entity, property, SortDirection } from "@twin.org/entity";
+/**
+ * Persists a push subscription. One row per active push transfer.
+ * Primary key = consumerPid (same as TransferProcess).
+ */
+let PushSubscription = class PushSubscription {
+    consumerPid;
+    providerPid;
+    /**
+     * ID of the Follow activity that created this subscription.
+     * Used by Undo to reference it on teardown.
+     */
+    followActivityId;
+    datasetId;
+    /**
+     * The tenant that owns this subscription, captured from the request context at
+     * write time. Optional — single-tenant nodes (no `TWIN_TENANT_ENABLED`) register
+     * subscriptions without a tenant context. The encrypted tenant token is also baked
+     * into `consumerEndpoint` so cross-node push deliveries route to the right tenant.
+     */
+    tenantId;
+    consumerEndpoint;
+    consumerAuthToken;
+    /**
+     * When true deliveries are skipped (transfer SUSPENDED).
+     * When false deliveries are flowing normally.
+     */
+    paused;
+    dateCreated;
+    /**
+     * Last-modified timestamp. Updated on suspend/resume (when `paused` flips) and on
+     * any subscription mutation. Matches the codebase convention of pairing `dateCreated`
+     * with `dateModified` on entities whose state mutates.
+     */
+    dateModified;
+};
+__decorate([
+    property({ type: "string", isPrimary: true }),
+    __metadata("design:type", String)
+], PushSubscription.prototype, "consumerPid", void 0);
+__decorate([
+    property({ type: "string" }),
+    __metadata("design:type", String)
+], PushSubscription.prototype, "providerPid", void 0);
+__decorate([
+    property({ type: "string" }),
+    __metadata("design:type", String)
+], PushSubscription.prototype, "followActivityId", void 0);
+__decorate([
+    property({ type: "string" }),
+    __metadata("design:type", String)
+], PushSubscription.prototype, "datasetId", void 0);
+__decorate([
+    property({ type: "string", optional: true }),
+    __metadata("design:type", String)
+], PushSubscription.prototype, "tenantId", void 0);
+__decorate([
+    property({ type: "string" }),
+    __metadata("design:type", String)
+], PushSubscription.prototype, "consumerEndpoint", void 0);
+__decorate([
+    property({ type: "string", optional: true }),
+    __metadata("design:type", String)
+], PushSubscription.prototype, "consumerAuthToken", void 0);
+__decorate([
+    property({ type: "boolean" }),
+    __metadata("design:type", Boolean)
+], PushSubscription.prototype, "paused", void 0);
+__decorate([
+    property({ type: "string", format: "date-time", sortDirection: SortDirection.Descending }),
+    __metadata("design:type", String)
+], PushSubscription.prototype, "dateCreated", void 0);
+__decorate([
+    property({ type: "string", format: "date-time" }),
+    __metadata("design:type", String)
+], PushSubscription.prototype, "dateModified", void 0);
+PushSubscription = __decorate([
+    entity()
+], PushSubscription);
+export { PushSubscription };
+//# sourceMappingURL=pushSubscription.js.map

package/dist/es/entities/pushSubscription.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pushSubscription.js","sourceRoot":"","sources":["../../../src/entities/pushSubscription.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,uCAAuC;AACvC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEnE;;;GAGG;AAEI,IAAM,gBAAgB,GAAtB,MAAM,gBAAgB;IAErB,WAAW,CAAU;IAGrB,WAAW,CAAU;IAE5B;;;OAGG;IAEI,gBAAgB,CAAU;IAG1B,SAAS,CAAU;IAE1B;;;;;OAKG;IAEI,QAAQ,CAAU;IAGlB,gBAAgB,CAAU;IAG1B,iBAAiB,CAAU;IAElC;;;OAGG;IAEI,MAAM,CAAW;IAGjB,WAAW,CAAU;IAE5B;;;;OAIG;IAEI,YAAY,CAAU;CAC7B,CAAA;AA/CO;IADN,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;;qDAClB;AAGrB;IADN,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;;qDACD;AAOrB;IADN,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;;0DACI;AAG1B;IADN,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;;mDACH;AASnB;IADN,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;kDACpB;AAGlB;IADN,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;;0DACI;AAG1B;IADN,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;2DACX;AAO3B;IADN,QAAQ,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;;gDACN;AAGjB;IADN,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,aAAa,EAAE,aAAa,CAAC,UAAU,EAAE,CAAC;;qDAC/D;AAQrB;IADN,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;;sDACrB;AAhDjB,gBAAgB;IAD5B,MAAM,EAAE;GACI,gBAAgB,CAiD5B","sourcesContent":["// Copyright 2025 IOTA Stiftung.\n// SPDX-License-Identifier: Apache-2.0.\nimport { entity, property, SortDirection } from \"@twin.org/entity\";\n\n/**\n * Persists a push subscription. One row per active push transfer.\n * Primary key = consumerPid (same as TransferProcess).\n */\n@entity()\nexport class PushSubscription {\n\t@property({ type: \"string\", isPrimary: true })\n\tpublic consumerPid!: string;\n\n\t@property({ type: \"string\" })\n\tpublic providerPid!: string;\n\n\t/**\n\t * ID of the Follow activity that created this subscription.\n\t * Used by Undo to reference it on teardown.\n\t */\n\t@property({ type: \"string\" })\n\tpublic followActivityId!: string;\n\n\t@property({ type: \"string\" })\n\tpublic datasetId!: string;\n\n\t/**\n\t * The tenant that owns this subscription, captured from the request context at\n\t * write time. Optional — single-tenant nodes (no `TWIN_TENANT_ENABLED`) register\n\t * subscriptions without a tenant context. The encrypted tenant token is also baked\n\t * into `consumerEndpoint` so cross-node push deliveries route to the right tenant.\n\t */\n\t@property({ type: \"string\", optional: true })\n\tpublic tenantId?: string;\n\n\t@property({ type: \"string\" })\n\tpublic consumerEndpoint!: string;\n\n\t@property({ type: \"string\", optional: true })\n\tpublic consumerAuthToken?: string;\n\n\t/**\n\t * When true deliveries are skipped (transfer SUSPENDED).\n\t * When false deliveries are flowing normally.\n\t */\n\t@property({ type: \"boolean\" })\n\tpublic paused!: boolean;\n\n\t@property({ type: \"string\", format: \"date-time\", sortDirection: SortDirection.Descending })\n\tpublic dateCreated!: string;\n\n\t/**\n\t * Last-modified timestamp. Updated on suspend/resume (when `paused` flips) and on\n\t * any subscription mutation. Matches the codebase convention of pairing `dateCreated`\n\t * with `dateModified` on entities whose state mutates.\n\t */\n\t@property({ type: \"string\", format: \"date-time\" })\n\tpublic dateModified!: string;\n}\n"]}

package/dist/es/index.js

@@ -5,6 +5,7 @@ export * from "./dataspaceDataPlaneSocketRoutes.js";
 export * from "./dataspaceDataPlaneService.js";
 export * from "./entities/activityLogDetails.js";
 export * from "./entities/activityTask.js";
+export * from "./entities/pushSubscription.js";
 export * from "./models/IDataspaceDataPlaneServiceConfig.js";
 export * from "./models/IDataspaceDataPlaneServiceConstructorOptions.js";
 export * from "./restEntryPoints.js";

package/dist/es/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,uCAAuC;AACvC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,qCAAqC,CAAC;AACpD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,kCAAkC,CAAC;AACjD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,8CAA8C,CAAC;AAC7D,cAAc,0DAA0D,CAAC;AACzE,cAAc,sBAAsB,CAAC;AACrC,cAAc,aAAa,CAAC;AAC5B,cAAc,wBAAwB,CAAC","sourcesContent":["// Copyright 2025 IOTA Stiftung.\n// SPDX-License-Identifier: Apache-2.0.\nexport * from \"./dataspaceDataPlaneRoutes.js\";\nexport * from \"./dataspaceDataPlaneSocketRoutes.js\";\nexport * from \"./dataspaceDataPlaneService.js\";\nexport * from \"./entities/activityLogDetails.js\";\nexport * from \"./entities/activityTask.js\";\nexport * from \"./models/IDataspaceDataPlaneServiceConfig.js\";\nexport * from \"./models/IDataspaceDataPlaneServiceConstructorOptions.js\";\nexport * from \"./restEntryPoints.js\";\nexport * from \"./schema.js\";\nexport * from \"./socketEntryPoints.js\";\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,uCAAuC;AACvC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,qCAAqC,CAAC;AACpD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,kCAAkC,CAAC;AACjD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,8CAA8C,CAAC;AAC7D,cAAc,0DAA0D,CAAC;AACzE,cAAc,sBAAsB,CAAC;AACrC,cAAc,aAAa,CAAC;AAC5B,cAAc,wBAAwB,CAAC","sourcesContent":["// Copyright 2025 IOTA Stiftung.\n// SPDX-License-Identifier: Apache-2.0.\nexport * from \"./dataspaceDataPlaneRoutes.js\";\nexport * from \"./dataspaceDataPlaneSocketRoutes.js\";\nexport * from \"./dataspaceDataPlaneService.js\";\nexport * from \"./entities/activityLogDetails.js\";\nexport * from \"./entities/activityTask.js\";\nexport * from \"./entities/pushSubscription.js\";\nexport * from \"./models/IDataspaceDataPlaneServiceConfig.js\";\nexport * from \"./models/IDataspaceDataPlaneServiceConstructorOptions.js\";\nexport * from \"./restEntryPoints.js\";\nexport * from \"./schema.js\";\nexport * from \"./socketEntryPoints.js\";\n"]}

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

@@ -1 +1 @@
-{"version":3,"file":"IDataspaceDataPlaneServiceConfig.js","sourceRoot":"","sources":["../../../src/models/IDataspaceDataPlaneServiceConfig.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,uCAAuC","sourcesContent":["// Copyright 2025 IOTA Stiftung.\n// SPDX-License-Identifier: Apache-2.0.\n\n/**\n * Dataspace Data Plane service configuration\n */\nexport interface IDataspaceDataPlaneServiceConfig {\n\t/**\n\t * The amount of time in minutes to retain activity log entries until removal, set to -1 to keep forever.\n\t * @default 10\n\t */\n\tretainActivityLogsFor?: number;\n\n\t/**\n\t * The interval in minutes in between activity log clean ups. -1 indicates no clean up shall be done.\n\t * @default 60 minutes\n\t */\n\tactivityLogsCleanUpInterval?: number;\n\n\t/**\n\t * The number of times to retry failed tasks, defaults to forever.\n\t * @default undefined.\n\t */\n\tretryCount?: number;\n}\n"]}
+{"version":3,"file":"IDataspaceDataPlaneServiceConfig.js","sourceRoot":"","sources":["../../../src/models/IDataspaceDataPlaneServiceConfig.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,uCAAuC","sourcesContent":["// Copyright 2025 IOTA Stiftung.\n// SPDX-License-Identifier: Apache-2.0.\n\n/**\n * Dataspace Data Plane service configuration\n */\nexport interface IDataspaceDataPlaneServiceConfig {\n\t/**\n\t * The amount of time in minutes to retain activity log entries until removal, set to -1 to keep forever.\n\t * @default 10\n\t */\n\tretainActivityLogsFor?: number;\n\n\t/**\n\t * The interval in minutes in between activity log clean ups. -1 indicates no clean up shall be done.\n\t * @default 60 minutes\n\t */\n\tactivityLogsCleanUpInterval?: number;\n\n\t/**\n\t * The number of times to retry failed tasks, defaults to forever.\n\t * @default undefined.\n\t */\n\tretryCount?: number;\n\n\t/**\n\t * Max HTTP retry attempts per push delivery task execution.\n\t * @default 3\n\t */\n\tpushRetryCount?: number;\n\n\t/**\n\t * Base delay (ms) for exponential backoff between push HTTP retries.\n\t * Effective delay = baseDelayMs * 2^attempt.\n\t * @default 1000\n\t */\n\tpushRetryBaseDelayMs?: number;\n\n\t/**\n\t * Timeout (ms) for each push delivery HTTP POST request.\n\t * @default 30000\n\t */\n\tpushTimeoutMs?: number;\n\n\t/**\n\t * Interval (ms) between orphaned PushSubscription cleanup scans.\n\t * @default 3600000 (1 hour)\n\t */\n\tpushSubscriptionCleanupIntervalMs?: number;\n}\n"]}

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

@@ -1 +1 @@
-{"version":3,"file":"IDataspaceDataPlaneServiceConstructorOptions.js","sourceRoot":"","sources":["../../../src/models/IDataspaceDataPlaneServiceConstructorOptions.ts"],"names":[],"mappings":"","sourcesContent":["// Copyright 2025 IOTA Stiftung.\n// SPDX-License-Identifier: Apache-2.0.\nimport type { IDataspaceDataPlaneServiceConfig } from \"./IDataspaceDataPlaneServiceConfig.js\";\n\n/**\n * Dataspace Data Plane service options\n */\nexport interface IDataspaceDataPlaneServiceConstructorOptions {\n\t/**\n\t * Logging component type.\n\t * @default logging\n\t */\n\tloggingComponentType?: string;\n\n\t/**\n\t * Background task component.\n\t * @default background-task\n\t */\n\tbackgroundTaskComponentType?: string;\n\n\t/**\n\t * Task Scheduler Component Type.\n\t * @default task-scheduler\n\t */\n\ttaskSchedulerComponentType?: string;\n\n\t/**\n\t * The entity storage for activity log details.\n\t * @default activity-log-details\n\t */\n\tactivityLogEntityStorageType?: string;\n\n\t/**\n\t * The entity storage for the association between Activities and Tasks.\n\t * @default activity-task\n\t */\n\tactivityTaskEntityStorageType?: string;\n\n\t/**\n\t * The entity storage type for Transfer Process entities.\n\t * Used to read Transfer Process state from shared storage.\n\t * @default transfer-process\n\t */\n\ttransferProcessEntityStorageType?: string;\n\n\t/**\n\t * The entity storage type for Dataspace App Dataset entities.\n\t * @default dataspace-app-dataset\n\t */\n\tdataspaceAppDatasetEntityStorageType?: string;\n\n\t/**\n\t * The keys to use from the context ids to cleanup partitions.\n\t */\n\tpartitionContextIds?: string[];\n\n\t/**\n\t * Trust component type.\n\t * @default trust\n\t */\n\ttrustComponentType?: string;\n\n\t/**\n\t * Policy enforcement point component type for ODRL policy enforcement.\n\t * @default policy-enforcement-point-service\n\t */\n\tpepComponentType?: string;\n\n\t/**\n\t * Tenant admin component type.\n\t * @default tenant-admin\n\t */\n\ttenantAdminType?: string;\n\n\t/**\n\t * The configuration of the Dataspace Data Plane Service.\n\t */\n\tconfig?: IDataspaceDataPlaneServiceConfig;\n}\n"]}
+{"version":3,"file":"IDataspaceDataPlaneServiceConstructorOptions.js","sourceRoot":"","sources":["../../../src/models/IDataspaceDataPlaneServiceConstructorOptions.ts"],"names":[],"mappings":"","sourcesContent":["// Copyright 2025 IOTA Stiftung.\n// SPDX-License-Identifier: Apache-2.0.\nimport type { IDataspaceDataPlaneServiceConfig } from \"./IDataspaceDataPlaneServiceConfig.js\";\n\n/**\n * Dataspace Data Plane service options\n */\nexport interface IDataspaceDataPlaneServiceConstructorOptions {\n\t/**\n\t * Logging component type.\n\t * @default logging\n\t */\n\tloggingComponentType?: string;\n\n\t/**\n\t * Background task component.\n\t * @default background-task\n\t */\n\tbackgroundTaskComponentType?: string;\n\n\t/**\n\t * Task Scheduler Component Type.\n\t * @default task-scheduler\n\t */\n\ttaskSchedulerComponentType?: string;\n\n\t/**\n\t * The entity storage for activity log details.\n\t * @default activity-log-details\n\t */\n\tactivityLogEntityStorageType?: string;\n\n\t/**\n\t * The entity storage for the association between Activities and Tasks.\n\t * @default activity-task\n\t */\n\tactivityTaskEntityStorageType?: string;\n\n\t/**\n\t * The entity storage type for Transfer Process entities.\n\t * Used to read Transfer Process state from shared storage.\n\t * @default transfer-process\n\t */\n\ttransferProcessEntityStorageType?: string;\n\n\t/**\n\t * The entity storage type for PushSubscription entities.\n\t * @default push-subscription\n\t */\n\tpushSubscriptionEntityStorageType?: string;\n\n\t/**\n\t * The entity storage type for Dataspace App Dataset entities.\n\t * @default dataspace-app-dataset\n\t */\n\tdataspaceAppDatasetEntityStorageType?: string;\n\n\t/**\n\t * The keys to use from the context ids to cleanup partitions.\n\t */\n\tpartitionContextIds?: string[];\n\n\t/**\n\t * Trust component type.\n\t * @default trust\n\t */\n\ttrustComponentType?: string;\n\n\t/**\n\t * Policy enforcement point component type for ODRL policy enforcement.\n\t * @default policy-enforcement-point-service\n\t */\n\tpepComponentType?: string;\n\n\t/**\n\t * Tenant admin component type.\n\t * @default tenant-admin\n\t */\n\ttenantAdminType?: string;\n\n\t/**\n\t * The configuration of the Dataspace Data Plane Service.\n\t */\n\tconfig?: IDataspaceDataPlaneServiceConfig;\n}\n"]}

package/dist/es/schema.js

@@ -3,11 +3,13 @@
 import { EntitySchemaFactory, EntitySchemaHelper } from "@twin.org/entity";
 import { ActivityLogDetails } from "./entities/activityLogDetails.js";
 import { ActivityTask } from "./entities/activityTask.js";
+import { PushSubscription } from "./entities/pushSubscription.js";
 /**
  * Inits schemas.
  */
 export function initSchema() {
     EntitySchemaFactory.register("ActivityLogDetails", () => EntitySchemaHelper.getSchema(ActivityLogDetails));
     EntitySchemaFactory.register("ActivityTask", () => EntitySchemaHelper.getSchema(ActivityTask));
+    EntitySchemaFactory.register("PushSubscription", () => EntitySchemaHelper.getSchema(PushSubscription));
 }
 //# sourceMappingURL=schema.js.map

package/dist/es/schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/schema.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,uCAAuC;AACvC,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAE3E,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAE1D;;GAEG;AACH,MAAM,UAAU,UAAU;IACzB,mBAAmB,CAAC,QAAQ,uBAA+B,GAAG,EAAE,CAC/D,kBAAkB,CAAC,SAAS,CAAC,kBAAkB,CAAC,CAChD,CAAC;IAEF,mBAAmB,CAAC,QAAQ,iBAAyB,GAAG,EAAE,CACzD,kBAAkB,CAAC,SAAS,CAAC,YAAY,CAAC,CAC1C,CAAC;AACH,CAAC","sourcesContent":["// Copyright 2025 IOTA Stiftung.\n// SPDX-License-Identifier: Apache-2.0.\nimport { EntitySchemaFactory, EntitySchemaHelper } from \"@twin.org/entity\";\nimport { nameof } from \"@twin.org/nameof\";\nimport { ActivityLogDetails } from \"./entities/activityLogDetails.js\";\nimport { ActivityTask } from \"./entities/activityTask.js\";\n\n/**\n * Inits schemas.\n */\nexport function initSchema(): void {\n\tEntitySchemaFactory.register(nameof<ActivityLogDetails>(), () =>\n\t\tEntitySchemaHelper.getSchema(ActivityLogDetails)\n\t);\n\n\tEntitySchemaFactory.register(nameof<ActivityTask>(), () =>\n\t\tEntitySchemaHelper.getSchema(ActivityTask)\n\t);\n}\n"]}
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/schema.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,uCAAuC;AACvC,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAE3E,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAElE;;GAEG;AACH,MAAM,UAAU,UAAU;IACzB,mBAAmB,CAAC,QAAQ,uBAA+B,GAAG,EAAE,CAC/D,kBAAkB,CAAC,SAAS,CAAC,kBAAkB,CAAC,CAChD,CAAC;IAEF,mBAAmB,CAAC,QAAQ,iBAAyB,GAAG,EAAE,CACzD,kBAAkB,CAAC,SAAS,CAAC,YAAY,CAAC,CAC1C,CAAC;IAEF,mBAAmB,CAAC,QAAQ,qBAA6B,GAAG,EAAE,CAC7D,kBAAkB,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAC9C,CAAC;AACH,CAAC","sourcesContent":["// Copyright 2025 IOTA Stiftung.\n// SPDX-License-Identifier: Apache-2.0.\nimport { EntitySchemaFactory, EntitySchemaHelper } from \"@twin.org/entity\";\nimport { nameof } from \"@twin.org/nameof\";\nimport { ActivityLogDetails } from \"./entities/activityLogDetails.js\";\nimport { ActivityTask } from \"./entities/activityTask.js\";\nimport { PushSubscription } from \"./entities/pushSubscription.js\";\n\n/**\n * Inits schemas.\n */\nexport function initSchema(): void {\n\tEntitySchemaFactory.register(nameof<ActivityLogDetails>(), () =>\n\t\tEntitySchemaHelper.getSchema(ActivityLogDetails)\n\t);\n\n\tEntitySchemaFactory.register(nameof<ActivityTask>(), () =>\n\t\tEntitySchemaHelper.getSchema(ActivityTask)\n\t);\n\n\tEntitySchemaFactory.register(nameof<PushSubscription>(), () =>\n\t\tEntitySchemaHelper.getSchema(PushSubscription)\n\t);\n}\n"]}

package/dist/types/dataspaceDataPlaneService.d.ts

@@ -1,6 +1,6 @@
 import { type IJsonLdContextDefinitionElement } from "@twin.org/data-json-ld";
 import { type IActivityLogEntry, type IActivityLogStatusNotification, type IDataAssetItemListResult, type IDataspaceDataPlaneComponent, type IEntitySet, type IFilteringQuery, type ITransferContext } from "@twin.org/dataspace-models";
-import type { IActivityStreamsActivity } from "@twin.org/standards-w3c-activity-streams";
+import { type IActivityStreamsActivity } from "@twin.org/standards-w3c-activity-streams";
 import type { IDataspaceDataPlaneServiceConstructorOptions } from "./models/IDataspaceDataPlaneServiceConstructorOptions.js";
 /**
  * Dataspace Data Plane Service.
@@ -10,6 +10,10 @@ export declare class DataspaceDataPlaneService implements IDataspaceDataPlaneCom
      * Runtime name for the class.
      */
     static readonly CLASS_NAME: string;
+    /**
+     * Background task type identifier for push delivery tasks.
+     */
+    static readonly PUSH_DELIVERY_TASK_TYPE = "push-delivery";
     /**
      * Create a new instance of DataspaceDataPlane.
      * @param options The options for the data plane.
@@ -28,9 +32,10 @@ export declare class DataspaceDataPlaneService implements IDataspaceDataPlaneCom
     /**
      * Notify an Activity.
      * @param activity The Activity notified.
+     * @param trustPayload Optional trust payload to verify the requester's identity.
      * @returns The activity's id or entry.
      */
-    notifyActivity(activity: IActivityStreamsActivity): Promise<string | IActivityLogEntry>;
+    notifyActivity(activity: IActivityStreamsActivity, trustPayload?: unknown): Promise<string | IActivityLogEntry>;
     /**
      * Subscribes to the activity log.
      * @param callback The callback to be called when Activity Log is called.
@@ -87,4 +92,34 @@ export declare class DataspaceDataPlaneService implements IDataspaceDataPlaneCom
      * @throws GeneralError if transfer is not in STARTED state.
      */
     validateTransfer(consumerPid: string, trustPayload: unknown): Promise<ITransferContext>;
+    /**
+     * Set up a push subscription after a transfer enters STARTED from REQUESTED.
+     * Reads the TransferProcess, builds an IFollowActivity, calls the app's
+     * subscribeToData, and persists a PushSubscription entity.
+     * @param consumerPid The consumer process ID identifying the transfer.
+     */
+    setupPushSubscription(consumerPid: string): Promise<void>;
+    /**
+     * Pause deliveries for a push subscription. The subscription entity stays
+     * alive with status=Paused. No app unsubscribe call.
+     * @param consumerPid The consumer process ID identifying the transfer.
+     */
+    suspendPushSubscription(consumerPid: string): Promise<void>;
+    /**
+     * Resume deliveries after a SUSPENDED → STARTED transition. Flips status
+     * back to Active. No app subscribeToData call.
+     * @param consumerPid The consumer process ID identifying the transfer.
+     */
+    resumePushSubscription(consumerPid: string): Promise<void>;
+    /**
+     * Tear down a push subscription. Builds an IUndoActivity, calls the app's
+     * unsubscribeToData, and deletes the PushSubscription entity.
+     * @param consumerPid The consumer process ID identifying the transfer.
+     */
+    teardownPushSubscription(consumerPid: string): Promise<void>;
+    /**
+     * Schedule a push delivery when the app has new outbound data.
+     * @param activity The outbound activity carrying the data payload.
+     */
+    processOutboxActivity(activity: IActivityStreamsActivity): Promise<void>;
 }

package/dist/types/entities/pushSubscription.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Persists a push subscription. One row per active push transfer.
+ * Primary key = consumerPid (same as TransferProcess).
+ */
+export declare class PushSubscription {
+    consumerPid: string;
+    providerPid: string;
+    /**
+     * ID of the Follow activity that created this subscription.
+     * Used by Undo to reference it on teardown.
+     */
+    followActivityId: string;
+    datasetId: string;
+    /**
+     * The tenant that owns this subscription, captured from the request context at
+     * write time. Optional — single-tenant nodes (no `TWIN_TENANT_ENABLED`) register
+     * subscriptions without a tenant context. The encrypted tenant token is also baked
+     * into `consumerEndpoint` so cross-node push deliveries route to the right tenant.
+     */
+    tenantId?: string;
+    consumerEndpoint: string;
+    consumerAuthToken?: string;
+    /**
+     * When true deliveries are skipped (transfer SUSPENDED).
+     * When false deliveries are flowing normally.
+     */
+    paused: boolean;
+    dateCreated: string;
+    /**
+     * Last-modified timestamp. Updated on suspend/resume (when `paused` flips) and on
+     * any subscription mutation. Matches the codebase convention of pairing `dateCreated`
+     * with `dateModified` on entities whose state mutates.
+     */
+    dateModified: string;
+}

package/dist/types/index.d.ts

@@ -3,6 +3,7 @@ export * from "./dataspaceDataPlaneSocketRoutes.js";
 export * from "./dataspaceDataPlaneService.js";
 export * from "./entities/activityLogDetails.js";
 export * from "./entities/activityTask.js";
+export * from "./entities/pushSubscription.js";
 export * from "./models/IDataspaceDataPlaneServiceConfig.js";
 export * from "./models/IDataspaceDataPlaneServiceConstructorOptions.js";
 export * from "./restEntryPoints.js";

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

@@ -17,4 +17,25 @@ export interface IDataspaceDataPlaneServiceConfig {
      * @default undefined.
      */
     retryCount?: number;
+    /**
+     * Max HTTP retry attempts per push delivery task execution.
+     * @default 3
+     */
+    pushRetryCount?: number;
+    /**
+     * Base delay (ms) for exponential backoff between push HTTP retries.
+     * Effective delay = baseDelayMs * 2^attempt.
+     * @default 1000
+     */
+    pushRetryBaseDelayMs?: number;
+    /**
+     * Timeout (ms) for each push delivery HTTP POST request.
+     * @default 30000
+     */
+    pushTimeoutMs?: number;
+    /**
+     * Interval (ms) between orphaned PushSubscription cleanup scans.
+     * @default 3600000 (1 hour)
+     */
+    pushSubscriptionCleanupIntervalMs?: number;
 }

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

@@ -34,6 +34,11 @@ export interface IDataspaceDataPlaneServiceConstructorOptions {
      * @default transfer-process
      */
     transferProcessEntityStorageType?: string;
+    /**
+     * The entity storage type for PushSubscription entities.
+     * @default push-subscription
+     */
+    pushSubscriptionEntityStorageType?: string;
     /**
      * The entity storage type for Dataspace App Dataset entities.
      * @default dataspace-app-dataset

package/docs/changelog.md

@@ -1,5 +1,39 @@
 # Changelog
 
+## [0.0.3-next.30](https://github.com/iotaledger/twin-dataspace/compare/dataspace-data-plane-service-v0.0.3-next.29...dataspace-data-plane-service-v0.0.3-next.30) (2026-05-26)
+
+
+### Features
+
+* implement DSP push transfer mode ([#109](https://github.com/iotaledger/twin-dataspace/issues/109)) ([71f5fee](https://github.com/iotaledger/twin-dataspace/commit/71f5feec1d92dfec8ed6899c951809818e1bf2a3))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/dataspace-app-runner bumped from 0.0.3-next.29 to 0.0.3-next.30
+    * @twin.org/dataspace-models bumped from 0.0.3-next.29 to 0.0.3-next.30
+  * devDependencies
+    * @twin.org/dataspace-test-app bumped from 0.0.3-next.29 to 0.0.3-next.30
+
+## [0.0.3-next.29](https://github.com/iotaledger/twin-dataspace/compare/dataspace-data-plane-service-v0.0.3-next.28...dataspace-data-plane-service-v0.0.3-next.29) (2026-05-20)
+
+
+### Features
+
+* update dependencies ([55cb41c](https://github.com/iotaledger/twin-dataspace/commit/55cb41c1d0ce7ebddcce41c60fe944650bcf0499))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/dataspace-app-runner bumped from 0.0.3-next.28 to 0.0.3-next.29
+    * @twin.org/dataspace-models bumped from 0.0.3-next.28 to 0.0.3-next.29
+  * devDependencies
+    * @twin.org/dataspace-test-app bumped from 0.0.3-next.28 to 0.0.3-next.29
+
 ## [0.0.3-next.28](https://github.com/iotaledger/twin-dataspace/compare/dataspace-data-plane-service-v0.0.3-next.27...dataspace-data-plane-service-v0.0.3-next.28) (2026-05-12)
 
 

package/docs/open-api/spec.json

@@ -21,16 +21,22 @@
 		}
 	],
 	"paths": {
-		"/dataspace-data-plane/notify": {
+		"/dataspace-data-plane/inbox": {
 			"post": {
 				"operationId": "activityStreamNotify",
 				"summary": "Notify of a new Activity",
 				"tags": [
 					"Dataspace Data Plane"
 				],
-				"security": [
+				"parameters": [
 					{
-						"jwtBearerAuthScheme": []
+						"name": "authorization",
+						"in": "header",
+						"required": true,
+						"schema": {
+							"type": "string"
+						},
+						"style": "simple"
 					}
 				],
 				"requestBody": {
@@ -93,24 +99,6 @@
 							}
 						}
 					},
-					"401": {
-						"description": "You are not authorized to use the API or no credentials were supplied, see the content for more details.",
-						"content": {
-							"application/json": {
-								"schema": {
-									"$ref": "#/components/schemas/Error"
-								},
-								"examples": {
-									"exampleResponse": {
-										"value": {
-											"name": "UnauthorizedError",
-											"message": "errorMessage"
-										}
-									}
-								}
-							}
-						}
-					},
 					"422": {
 						"description": "The server cannot process the request, see the content for more details.",
 						"content": {

package/docs/reference/classes/DataspaceDataPlaneService.md

@@ -34,6 +34,14 @@ The options for the data plane.
 
 Runtime name for the class.
 
+***
+
+### PUSH\_DELIVERY\_TASK\_TYPE {#push_delivery_task_type}
+
+> `readonly` `static` **PUSH\_DELIVERY\_TASK\_TYPE**: `"push-delivery"` = `"push-delivery"`
+
+Background task type identifier for push delivery tasks.
+
 ## Methods
 
 ### className() {#classname}
@@ -80,7 +88,7 @@ The node logging component type.
 
 ### notifyActivity() {#notifyactivity}
 
-> **notifyActivity**(`activity`): `Promise`\<`string` \| `IActivityLogEntry`\>
+> **notifyActivity**(`activity`, `trustPayload?`): `Promise`\<`string` \| `IActivityLogEntry`\>
 
 Notify an Activity.
 
@@ -92,6 +100,12 @@ Notify an Activity.
 
 The Activity notified.
 
+##### trustPayload?
+
+`unknown`
+
+Optional trust payload to verify the requester's identity.
+
 #### Returns
 
 `Promise`\<`string` \| `IActivityLogEntry`\>
@@ -334,3 +348,128 @@ UnauthorizedError if trust verification fails.
 #### Throws
 
 GeneralError if transfer is not in STARTED state.
+
+***
+
+### setupPushSubscription() {#setuppushsubscription}
+
+> **setupPushSubscription**(`consumerPid`): `Promise`\<`void`\>
+
+Set up a push subscription after a transfer enters STARTED from REQUESTED.
+Reads the TransferProcess, builds an IFollowActivity, calls the app's
+subscribeToData, and persists a PushSubscription entity.
+
+#### Parameters
+
+##### consumerPid
+
+`string`
+
+The consumer process ID identifying the transfer.
+
+#### Returns
+
+`Promise`\<`void`\>
+
+#### Implementation of
+
+`IDataspaceDataPlaneComponent.setupPushSubscription`
+
+***
+
+### suspendPushSubscription() {#suspendpushsubscription}
+
+> **suspendPushSubscription**(`consumerPid`): `Promise`\<`void`\>
+
+Pause deliveries for a push subscription. The subscription entity stays
+alive with status=Paused. No app unsubscribe call.
+
+#### Parameters
+
+##### consumerPid
+
+`string`
+
+The consumer process ID identifying the transfer.
+
+#### Returns
+
+`Promise`\<`void`\>
+
+#### Implementation of
+
+`IDataspaceDataPlaneComponent.suspendPushSubscription`
+
+***
+
+### resumePushSubscription() {#resumepushsubscription}
+
+> **resumePushSubscription**(`consumerPid`): `Promise`\<`void`\>
+
+Resume deliveries after a SUSPENDED → STARTED transition. Flips status
+back to Active. No app subscribeToData call.
+
+#### Parameters
+
+##### consumerPid
+
+`string`
+
+The consumer process ID identifying the transfer.
+
+#### Returns
+
+`Promise`\<`void`\>
+
+#### Implementation of
+
+`IDataspaceDataPlaneComponent.resumePushSubscription`
+
+***
+
+### teardownPushSubscription() {#teardownpushsubscription}
+
+> **teardownPushSubscription**(`consumerPid`): `Promise`\<`void`\>
+
+Tear down a push subscription. Builds an IUndoActivity, calls the app's
+unsubscribeToData, and deletes the PushSubscription entity.
+
+#### Parameters
+
+##### consumerPid
+
+`string`
+
+The consumer process ID identifying the transfer.
+
+#### Returns
+
+`Promise`\<`void`\>
+
+#### Implementation of
+
+`IDataspaceDataPlaneComponent.teardownPushSubscription`
+
+***
+
+### processOutboxActivity() {#processoutboxactivity}
+
+> **processOutboxActivity**(`activity`): `Promise`\<`void`\>
+
+Schedule a push delivery when the app has new outbound data.
+
+#### Parameters
+
+##### activity
+
+`IActivityStreamsActivity`
+
+The outbound activity carrying the data payload.
+
+#### Returns
+
+`Promise`\<`void`\>
+
+#### Implementation of
+
+`IDataspaceDataPlaneComponent.processOutboxActivity`

package/docs/reference/classes/PushSubscription.md

@@ -0,0 +1,89 @@
+# Class: PushSubscription
+
+Persists a push subscription. One row per active push transfer.
+Primary key = consumerPid (same as TransferProcess).
+
+## Constructors
+
+### Constructor
+
+> **new PushSubscription**(): `PushSubscription`
+
+#### Returns
+
+`PushSubscription`
+
+## Properties
+
+### consumerPid {#consumerpid}
+
+> **consumerPid**: `string`
+
+***
+
+### providerPid {#providerpid}
+
+> **providerPid**: `string`
+
+***
+
+### followActivityId {#followactivityid}
+
+> **followActivityId**: `string`
+
+ID of the Follow activity that created this subscription.
+Used by Undo to reference it on teardown.
+
+***
+
+### datasetId {#datasetid}
+
+> **datasetId**: `string`
+
+***
+
+### tenantId? {#tenantid}
+
+> `optional` **tenantId?**: `string`
+
+The tenant that owns this subscription, captured from the request context at
+write time. Optional — single-tenant nodes (no `TWIN_TENANT_ENABLED`) register
+subscriptions without a tenant context. The encrypted tenant token is also baked
+into `consumerEndpoint` so cross-node push deliveries route to the right tenant.
+
+***
+
+### consumerEndpoint {#consumerendpoint}
+
+> **consumerEndpoint**: `string`
+
+***
+
+### consumerAuthToken? {#consumerauthtoken}
+
+> `optional` **consumerAuthToken?**: `string`
+
+***
+
+### paused {#paused}
+
+> **paused**: `boolean`
+
+When true deliveries are skipped (transfer SUSPENDED).
+When false deliveries are flowing normally.
+
+***
+
+### dateCreated {#datecreated}
+
+> **dateCreated**: `string`
+
+***
+
+### dateModified {#datemodified}
+
+> **dateModified**: `string`
+
+Last-modified timestamp. Updated on suspend/resume (when `paused` flips) and on
+any subscription mutation. Matches the codebase convention of pairing `dateCreated`
+with `dateModified` on entities whose state mutates.

package/docs/reference/index.md

@@ -5,6 +5,7 @@
 - [DataspaceDataPlaneService](classes/DataspaceDataPlaneService.md)
 - [ActivityLogDetails](classes/ActivityLogDetails.md)
 - [ActivityTask](classes/ActivityTask.md)
+- [PushSubscription](classes/PushSubscription.md)
 
 ## Interfaces