@twin.org/dataspace-models 0.0.3-next.28 → 0.0.3-next.30

package/dist/es/entities/transferProcess.js

@@ -53,6 +53,13 @@ let TransferProcess = class TransferProcess {
      * Callback address for Consumer notifications.
      */
     callbackAddress;
+    /**
+     * The tenant that owns this transfer process, captured from the request context
+     * at write time. Optional — single-tenant nodes (no `TWIN_TENANT_ENABLED`) register
+     * transfers without a tenant context. Persisted so async push delivery tasks and
+     * setTimeout-delayed state transitions can re-enter the right tenant context.
+     */
+    tenantId;
     /**
      * Creation timestamp (ISO string format).
      */
@@ -114,6 +121,10 @@ __decorate([
     property({ type: "string", optional: true }),
     __metadata("design:type", String)
 ], TransferProcess.prototype, "callbackAddress", void 0);
+__decorate([
+    property({ type: "string", optional: true }),
+    __metadata("design:type", String)
+], TransferProcess.prototype, "tenantId", void 0);
 __decorate([
     property({ type: "string", format: "date-time", sortDirection: SortDirection.Descending }),
     __metadata("design:type", String)

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

@@ -1 +1 @@
-{"version":3,"file":"transferProcess.js","sourceRoot":"","sources":["../../../src/entities/transferProcess.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,uCAAuC;AACvC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAOnE;;;GAGG;AAEI,IAAM,eAAe,GAArB,MAAM,eAAe;IAC3B;;;OAGG;IAEI,WAAW,CAAU;IAE5B;;OAEG;IAEI,EAAE,CAAU;IAEnB;;;OAGG;IAEI,WAAW,CAAU;IAE5B;;OAEG;IAEI,WAAW,CAAU;IAE5B;;;OAGG;IAEI,KAAK,CAA6C;IAEzD;;OAEG;IAEI,SAAS,CAAU;IAE1B;;OAEG;IAEI,OAAO,CAAU;IAExB;;OAEG;IAEI,gBAAgB,CAAU;IAEjC;;OAEG;IAEI,gBAAgB,CAAU;IAEjC;;OAEG;IAEI,MAAM,CAAU;IAEvB;;OAEG;IAEI,eAAe,CAAU;IAEhC;;OAEG;IAEI,WAAW,CAAU;IAE5B;;OAEG;IAEI,YAAY,CAAU;IAE7B;;OAEG;IAEI,QAAQ,CAA8B;IAE7C;;OAEG;IAEI,WAAW,CAAiC;CACnD,CAAA;AAvFO;IADN,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;;oDAClB;AAMrB;IADN,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;;2CACV;AAOZ;IADN,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;;oDACpB;AAMrB;IADN,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;;oDACD;AAOrB;IADN,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;;8CAC4B;AAMlD;IADN,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;;kDACH;AAMnB;IADN,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;;gDACL;AAMjB;IADN,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;yDACZ;AAM1B;IADN,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;yDACZ;AAM1B;IADN,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;+CACtB;AAMhB;IADN,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;wDACb;AAMzB;IADN,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,aAAa,EAAE,aAAa,CAAC,UAAU,EAAE,CAAC;;oDAC/D;AAMrB;IADN,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;;qDACrB;AAMtB;IADN,QAAQ,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;iDACf;AAMtC;IADN,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;oDACV;AA5FvC,eAAe;IAD3B,MAAM,EAAE;GACI,eAAe,CA6F3B","sourcesContent":["// Copyright 2025 IOTA Stiftung.\n// SPDX-License-Identifier: Apache-2.0.\nimport { entity, property, SortDirection } from \"@twin.org/entity\";\nimport type {\n\tDataspaceProtocolTransferProcessStateType,\n\tIDataspaceProtocolDataAddress,\n\tIDataspaceProtocolPolicy\n} from \"@twin.org/standards-dataspace-protocol\";\n\n/**\n * Transfer Process for shared storage between Control Plane and Data Plane.\n * This entity is the persistent representation of ITransferProcess.\n */\n@entity()\nexport class TransferProcess {\n\t/**\n\t * The consumer PID is the primary key.\n\t * Used for direct lookup by consumerPid.\n\t */\n\t@property({ type: \"string\", isPrimary: true })\n\tpublic consumerPid!: string;\n\n\t/**\n\t * Internal UUID for storage (secondary key for providerPid lookup).\n\t */\n\t@property({ type: \"string\" })\n\tpublic id!: string;\n\n\t/**\n\t * Provider Process ID from the DSP protocol.\n\t * Indexed for lookup by providerPid.\n\t */\n\t@property({ type: \"string\", isSecondary: true })\n\tpublic providerPid!: string;\n\n\t/**\n\t * Agreement ID linking to the rights-management Agreement.\n\t */\n\t@property({ type: \"string\" })\n\tpublic agreementId!: string;\n\n\t/**\n\t * Transfer Process state from the DSP protocol.\n\t * One of: REQUESTED, STARTED, COMPLETED, SUSPENDED, TERMINATED.\n\t */\n\t@property({ type: \"string\" })\n\tpublic state!: DataspaceProtocolTransferProcessStateType;\n\n\t/**\n\t * Dataset ID for DSC resolution.\n\t */\n\t@property({ type: \"string\" })\n\tpublic datasetId!: string;\n\n\t/**\n\t * Offer ID from the original Catalog offer.\n\t */\n\t@property({ type: \"string\" })\n\tpublic offerId!: string;\n\n\t/**\n\t * Consumer identity (DID or URI).\n\t */\n\t@property({ type: \"string\", optional: true })\n\tpublic consumerIdentity?: string;\n\n\t/**\n\t * Provider identity (DID or URI).\n\t */\n\t@property({ type: \"string\", optional: true })\n\tpublic providerIdentity?: string;\n\n\t/**\n\t * Data format from the Dataset Distribution.\n\t */\n\t@property({ type: \"string\", optional: true })\n\tpublic format?: string;\n\n\t/**\n\t * Callback address for Consumer notifications.\n\t */\n\t@property({ type: \"string\", optional: true })\n\tpublic callbackAddress?: string;\n\n\t/**\n\t * Creation timestamp (ISO string format).\n\t */\n\t@property({ type: \"string\", format: \"date-time\", sortDirection: SortDirection.Descending })\n\tpublic dateCreated!: string;\n\n\t/**\n\t * Last update timestamp (ISO string format).\n\t */\n\t@property({ type: \"string\", format: \"date-time\" })\n\tpublic dateModified!: string;\n\n\t/**\n\t * Policies from the Agreement (stored as JSON).\n\t */\n\t@property({ type: \"array\", format: \"json\", optional: true })\n\tpublic policies?: IDataspaceProtocolPolicy[];\n\n\t/**\n\t * Data address for push mode transfers (stored as JSON).\n\t */\n\t@property({ type: \"object\", format: \"json\", optional: true })\n\tpublic dataAddress?: IDataspaceProtocolDataAddress;\n}\n"]}
+{"version":3,"file":"transferProcess.js","sourceRoot":"","sources":["../../../src/entities/transferProcess.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,uCAAuC;AACvC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAOnE;;;GAGG;AAEI,IAAM,eAAe,GAArB,MAAM,eAAe;IAC3B;;;OAGG;IAEI,WAAW,CAAU;IAE5B;;OAEG;IAEI,EAAE,CAAU;IAEnB;;;OAGG;IAEI,WAAW,CAAU;IAE5B;;OAEG;IAEI,WAAW,CAAU;IAE5B;;;OAGG;IAEI,KAAK,CAA6C;IAEzD;;OAEG;IAEI,SAAS,CAAU;IAE1B;;OAEG;IAEI,OAAO,CAAU;IAExB;;OAEG;IAEI,gBAAgB,CAAU;IAEjC;;OAEG;IAEI,gBAAgB,CAAU;IAEjC;;OAEG;IAEI,MAAM,CAAU;IAEvB;;OAEG;IAEI,eAAe,CAAU;IAEhC;;;;;OAKG;IAEI,QAAQ,CAAU;IAEzB;;OAEG;IAEI,WAAW,CAAU;IAE5B;;OAEG;IAEI,YAAY,CAAU;IAE7B;;OAEG;IAEI,QAAQ,CAA8B;IAE7C;;OAEG;IAEI,WAAW,CAAiC;CACnD,CAAA;AAhGO;IADN,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;;oDAClB;AAMrB;IADN,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;;2CACV;AAOZ;IADN,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;;oDACpB;AAMrB;IADN,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;;oDACD;AAOrB;IADN,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;;8CAC4B;AAMlD;IADN,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;;kDACH;AAMnB;IADN,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;;gDACL;AAMjB;IADN,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;yDACZ;AAM1B;IADN,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;yDACZ;AAM1B;IADN,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;+CACtB;AAMhB;IADN,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;wDACb;AASzB;IADN,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;iDACpB;AAMlB;IADN,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,aAAa,EAAE,aAAa,CAAC,UAAU,EAAE,CAAC;;oDAC/D;AAMrB;IADN,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;;qDACrB;AAMtB;IADN,QAAQ,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;iDACf;AAMtC;IADN,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;oDACV;AArGvC,eAAe;IAD3B,MAAM,EAAE;GACI,eAAe,CAsG3B","sourcesContent":["// Copyright 2025 IOTA Stiftung.\n// SPDX-License-Identifier: Apache-2.0.\nimport { entity, property, SortDirection } from \"@twin.org/entity\";\nimport type {\n\tDataspaceProtocolTransferProcessStateType,\n\tIDataspaceProtocolDataAddress,\n\tIDataspaceProtocolPolicy\n} from \"@twin.org/standards-dataspace-protocol\";\n\n/**\n * Transfer Process for shared storage between Control Plane and Data Plane.\n * This entity is the persistent representation of ITransferProcess.\n */\n@entity()\nexport class TransferProcess {\n\t/**\n\t * The consumer PID is the primary key.\n\t * Used for direct lookup by consumerPid.\n\t */\n\t@property({ type: \"string\", isPrimary: true })\n\tpublic consumerPid!: string;\n\n\t/**\n\t * Internal UUID for storage (secondary key for providerPid lookup).\n\t */\n\t@property({ type: \"string\" })\n\tpublic id!: string;\n\n\t/**\n\t * Provider Process ID from the DSP protocol.\n\t * Indexed for lookup by providerPid.\n\t */\n\t@property({ type: \"string\", isSecondary: true })\n\tpublic providerPid!: string;\n\n\t/**\n\t * Agreement ID linking to the rights-management Agreement.\n\t */\n\t@property({ type: \"string\" })\n\tpublic agreementId!: string;\n\n\t/**\n\t * Transfer Process state from the DSP protocol.\n\t * One of: REQUESTED, STARTED, COMPLETED, SUSPENDED, TERMINATED.\n\t */\n\t@property({ type: \"string\" })\n\tpublic state!: DataspaceProtocolTransferProcessStateType;\n\n\t/**\n\t * Dataset ID for DSC resolution.\n\t */\n\t@property({ type: \"string\" })\n\tpublic datasetId!: string;\n\n\t/**\n\t * Offer ID from the original Catalog offer.\n\t */\n\t@property({ type: \"string\" })\n\tpublic offerId!: string;\n\n\t/**\n\t * Consumer identity (DID or URI).\n\t */\n\t@property({ type: \"string\", optional: true })\n\tpublic consumerIdentity?: string;\n\n\t/**\n\t * Provider identity (DID or URI).\n\t */\n\t@property({ type: \"string\", optional: true })\n\tpublic providerIdentity?: string;\n\n\t/**\n\t * Data format from the Dataset Distribution.\n\t */\n\t@property({ type: \"string\", optional: true })\n\tpublic format?: string;\n\n\t/**\n\t * Callback address for Consumer notifications.\n\t */\n\t@property({ type: \"string\", optional: true })\n\tpublic callbackAddress?: string;\n\n\t/**\n\t * The tenant that owns this transfer process, captured from the request context\n\t * at write time. Optional — single-tenant nodes (no `TWIN_TENANT_ENABLED`) register\n\t * transfers without a tenant context. Persisted so async push delivery tasks and\n\t * setTimeout-delayed state transitions can re-enter the right tenant context.\n\t */\n\t@property({ type: \"string\", optional: true })\n\tpublic tenantId?: string;\n\n\t/**\n\t * Creation timestamp (ISO string format).\n\t */\n\t@property({ type: \"string\", format: \"date-time\", sortDirection: SortDirection.Descending })\n\tpublic dateCreated!: string;\n\n\t/**\n\t * Last update timestamp (ISO string format).\n\t */\n\t@property({ type: \"string\", format: \"date-time\" })\n\tpublic dateModified!: string;\n\n\t/**\n\t * Policies from the Agreement (stored as JSON).\n\t */\n\t@property({ type: \"array\", format: \"json\", optional: true })\n\tpublic policies?: IDataspaceProtocolPolicy[];\n\n\t/**\n\t * Data address for push mode transfers (stored as JSON).\n\t */\n\t@property({ type: \"object\", format: \"json\", optional: true })\n\tpublic dataAddress?: IDataspaceProtocolDataAddress;\n}\n"]}

package/dist/es/index.js

@@ -22,6 +22,8 @@ export * from "./dataTypes/dataspaceDataTypes.js";
 // App exports
 export * from "./factories/dataspaceAppFactory.js";
 export * from "./models/app/IDataspaceApp.js";
+export * from "./models/app/IFollowActivity.js";
+export * from "./models/app/IUndoActivity.js";
 export * from "./models/app/IProcessingGroupOptions.js";
 // Other exports
 export * from "./models/activityProcessingStatus.js";
@@ -72,4 +74,7 @@ export * from "./models/IDataAssetItemListResult.js";
 export * from "./models/IEntitySet.js";
 export * from "./models/IExecutionPayload.js";
 export * from "./models/IFilteringQuery.js";
+export * from "./models/IPushDeliveryPayload.js";
+// Utility exports
+export * from "./utils/jsonLdUtils.js";
 //# sourceMappingURL=index.js.map

package/dist/es/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,uCAAuC;AAEvC,iBAAiB;AACjB,cAAc,mCAAmC,CAAC;AAClD,cAAc,+BAA+B,CAAC;AAE9C,wBAAwB;AACxB,cAAc,uDAAuD,CAAC;AACtE,cAAc,+CAA+C,CAAC;AAC9D,cAAc,0DAA0D,CAAC;AACzE,cAAc,kEAAkE,CAAC;AACjF,cAAc,+CAA+C,CAAC;AAC9D,cAAc,2CAA2C,CAAC;AAC1D,cAAc,2CAA2C,CAAC;AAC1D,cAAc,8CAA8C,CAAC;AAE7D,qBAAqB;AACrB,cAAc,oDAAoD,CAAC;AAEnE,cAAc,+BAA+B,CAAC;AAC9C,cAAc,qCAAqC,CAAC;AACpD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,gCAAgC,CAAC;AAE/C,cAAc,mCAAmC,CAAC;AAElD,cAAc;AACd,cAAc,oCAAoC,CAAC;AACnD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,yCAAyC,CAAC;AAExD,gBAAgB;AAChB,cAAc,sCAAsC,CAAC;AACrD,cAAc,6CAA6C,CAAC;AAC5D,cAAc,8CAA8C,CAAC;AAC7D,cAAc,uDAAuD,CAAC;AACtE,cAAc,2CAA2C,CAAC;AAC1D,cAAc,8CAA8C,CAAC;AAC7D,cAAc,+CAA+C,CAAC;AAC9D,cAAc,4CAA4C,CAAC;AAC3D,cAAc,8CAA8C,CAAC;AAC7D,cAAc,wCAAwC,CAAC;AAEvD,wDAAwD;AACxD,cAAc,uDAAuD,CAAC;AACtE,cAAc,wDAAwD,CAAC;AACvE,cAAc,uDAAuD,CAAC;AACtE,cAAc,oDAAoD,CAAC;AACnE,cAAc,qDAAqD,CAAC;AACpE,cAAc,qDAAqD,CAAC;AACpE,cAAc,sDAAsD,CAAC;AACrE,cAAc,uDAAuD,CAAC;AACtE,cAAc,uDAAuD,CAAC;AACtE,cAAc,wDAAwD,CAAC;AACvE,cAAc,yDAAyD,CAAC;AACxE,cAAc,0DAA0D,CAAC;AACzE,cAAc,sDAAsD,CAAC;AACrE,cAAc,uDAAuD,CAAC;AACtE,cAAc,oDAAoD,CAAC;AACnE,cAAc,qDAAqD,CAAC;AACpE,cAAc,sDAAsD,CAAC;AACrE,cAAc,uDAAuD,CAAC;AACtE,cAAc,wDAAwD,CAAC;AACvE,cAAc,yDAAyD,CAAC;AAExE,cAAc,gCAAgC,CAAC;AAC/C,cAAc,iCAAiC,CAAC;AAChD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,2CAA2C,CAAC;AAC1D,cAAc,iCAAiC,CAAC;AAChD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,wCAAwC,CAAC;AACvD,cAAc,iCAAiC,CAAC;AAChD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,4CAA4C,CAAC;AAC3D,cAAc,2BAA2B,CAAC;AAC1C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,sCAAsC,CAAC;AACrD,cAAc,wBAAwB,CAAC;AACvC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,6BAA6B,CAAC","sourcesContent":["// Copyright 2025 IOTA Stiftung.\n// SPDX-License-Identifier: Apache-2.0.\n\n// Entity exports\nexport * from \"./entities/dataspaceAppDataset.js\";\nexport * from \"./entities/transferProcess.js\";\n\n// Control Plane exports\nexport * from \"./models/controlPlane/api/ITransferContextResponse.js\";\nexport * from \"./models/controlPlane/IDataspaceAppDataset.js\";\nexport * from \"./models/controlPlane/IDataspaceControlPlaneComponent.js\";\nexport * from \"./models/controlPlane/IDataspaceControlPlaneResolverComponent.js\";\nexport * from \"./models/controlPlane/INegotiationCallback.js\";\nexport * from \"./models/controlPlane/ITransferContext.js\";\nexport * from \"./models/controlPlane/ITransferProcess.js\";\nexport * from \"./models/controlPlane/transferProcessRole.js\";\n\n// Data Plane exports\nexport * from \"./models/dataPlane/IDataspaceDataPlaneComponent.js\";\n\nexport * from \"./models/dataspaceContexts.js\";\nexport * from \"./models/dataspaceTransferFormat.js\";\nexport * from \"./models/dataspaceTypes.js\";\nexport * from \"./models/IDataspaceActivity.js\";\n\nexport * from \"./dataTypes/dataspaceDataTypes.js\";\n\n// App exports\nexport * from \"./factories/dataspaceAppFactory.js\";\nexport * from \"./models/app/IDataspaceApp.js\";\nexport * from \"./models/app/IProcessingGroupOptions.js\";\n\n// Other exports\nexport * from \"./models/activityProcessingStatus.js\";\nexport * from \"./models/api/IActivityLogEntryGetRequest.js\";\nexport * from \"./models/api/IActivityLogEntryGetResponse.js\";\nexport * from \"./models/api/IActivityLogStatusNotificationPayload.js\";\nexport * from \"./models/api/IActivityLogStatusRequest.js\";\nexport * from \"./models/api/IActivityStreamNotifyRequest.js\";\nexport * from \"./models/api/IActivityStreamNotifyResponse.js\";\nexport * from \"./models/api/IDataAssetEntitiesResponse.js\";\nexport * from \"./models/api/IDataAssetGetEntitiesRequest.js\";\nexport * from \"./models/api/IDataAssetQueryRequest.js\";\n\n// Control Plane API exports - Transfer Process Protocol\nexport * from \"./models/api/controlPlane/IAppDatasetCreateRequest.js\";\nexport * from \"./models/api/controlPlane/IAppDatasetCreateResponse.js\";\nexport * from \"./models/api/controlPlane/IAppDatasetDeleteRequest.js\";\nexport * from \"./models/api/controlPlane/IAppDatasetGetRequest.js\";\nexport * from \"./models/api/controlPlane/IAppDatasetGetResponse.js\";\nexport * from \"./models/api/controlPlane/IAppDatasetListRequest.js\";\nexport * from \"./models/api/controlPlane/IAppDatasetListResponse.js\";\nexport * from \"./models/api/controlPlane/IAppDatasetUpdateRequest.js\";\nexport * from \"./models/api/controlPlane/ICompleteTransferRequest.js\";\nexport * from \"./models/api/controlPlane/ICompleteTransferResponse.js\";\nexport * from \"./models/api/controlPlane/IGetTransferProcessRequest.js\";\nexport * from \"./models/api/controlPlane/IGetTransferProcessResponse.js\";\nexport * from \"./models/api/controlPlane/IRequestTransferRequest.js\";\nexport * from \"./models/api/controlPlane/IRequestTransferResponse.js\";\nexport * from \"./models/api/controlPlane/IStartTransferRequest.js\";\nexport * from \"./models/api/controlPlane/IStartTransferResponse.js\";\nexport * from \"./models/api/controlPlane/ISuspendTransferRequest.js\";\nexport * from \"./models/api/controlPlane/ISuspendTransferResponse.js\";\nexport * from \"./models/api/controlPlane/ITerminateTransferRequest.js\";\nexport * from \"./models/api/controlPlane/ITerminateTransferResponse.js\";\n\nexport * from \"./models/activityTaskStatus.js\";\nexport * from \"./models/app/dataRequestType.js\";\nexport * from \"./models/app/IActivityQuery.js\";\nexport * from \"./models/app/IDataAssetEntitiesRequest.js\";\nexport * from \"./models/app/IDataAssetQuery.js\";\nexport * from \"./models/app/IDataRequest.js\";\nexport * from \"./models/app/IQueryDataAssetRequest.js\";\nexport * from \"./models/IActivityLogDetails.js\";\nexport * from \"./models/IActivityLogEntry.js\";\nexport * from \"./models/IActivityLogStatusNotification.js\";\nexport * from \"./models/IActivityTask.js\";\nexport * from \"./models/IActivityTaskEntry.js\";\nexport * from \"./models/IDataAssetItemList.js\";\nexport * from \"./models/IDataAssetItemListResult.js\";\nexport * from \"./models/IEntitySet.js\";\nexport * from \"./models/IExecutionPayload.js\";\nexport * from \"./models/IFilteringQuery.js\";\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,uCAAuC;AAEvC,iBAAiB;AACjB,cAAc,mCAAmC,CAAC;AAClD,cAAc,+BAA+B,CAAC;AAE9C,wBAAwB;AACxB,cAAc,uDAAuD,CAAC;AACtE,cAAc,+CAA+C,CAAC;AAC9D,cAAc,0DAA0D,CAAC;AACzE,cAAc,kEAAkE,CAAC;AACjF,cAAc,+CAA+C,CAAC;AAC9D,cAAc,2CAA2C,CAAC;AAC1D,cAAc,2CAA2C,CAAC;AAC1D,cAAc,8CAA8C,CAAC;AAE7D,qBAAqB;AACrB,cAAc,oDAAoD,CAAC;AAEnE,cAAc,+BAA+B,CAAC;AAC9C,cAAc,qCAAqC,CAAC;AACpD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,gCAAgC,CAAC;AAE/C,cAAc,mCAAmC,CAAC;AAElD,cAAc;AACd,cAAc,oCAAoC,CAAC;AACnD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,iCAAiC,CAAC;AAChD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,yCAAyC,CAAC;AAExD,gBAAgB;AAChB,cAAc,sCAAsC,CAAC;AACrD,cAAc,6CAA6C,CAAC;AAC5D,cAAc,8CAA8C,CAAC;AAC7D,cAAc,uDAAuD,CAAC;AACtE,cAAc,2CAA2C,CAAC;AAC1D,cAAc,8CAA8C,CAAC;AAC7D,cAAc,+CAA+C,CAAC;AAC9D,cAAc,4CAA4C,CAAC;AAC3D,cAAc,8CAA8C,CAAC;AAC7D,cAAc,wCAAwC,CAAC;AAEvD,wDAAwD;AACxD,cAAc,uDAAuD,CAAC;AACtE,cAAc,wDAAwD,CAAC;AACvE,cAAc,uDAAuD,CAAC;AACtE,cAAc,oDAAoD,CAAC;AACnE,cAAc,qDAAqD,CAAC;AACpE,cAAc,qDAAqD,CAAC;AACpE,cAAc,sDAAsD,CAAC;AACrE,cAAc,uDAAuD,CAAC;AACtE,cAAc,uDAAuD,CAAC;AACtE,cAAc,wDAAwD,CAAC;AACvE,cAAc,yDAAyD,CAAC;AACxE,cAAc,0DAA0D,CAAC;AACzE,cAAc,sDAAsD,CAAC;AACrE,cAAc,uDAAuD,CAAC;AACtE,cAAc,oDAAoD,CAAC;AACnE,cAAc,qDAAqD,CAAC;AACpE,cAAc,sDAAsD,CAAC;AACrE,cAAc,uDAAuD,CAAC;AACtE,cAAc,wDAAwD,CAAC;AACvE,cAAc,yDAAyD,CAAC;AAExE,cAAc,gCAAgC,CAAC;AAC/C,cAAc,iCAAiC,CAAC;AAChD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,2CAA2C,CAAC;AAC1D,cAAc,iCAAiC,CAAC;AAChD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,wCAAwC,CAAC;AACvD,cAAc,iCAAiC,CAAC;AAChD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,4CAA4C,CAAC;AAC3D,cAAc,2BAA2B,CAAC;AAC1C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,sCAAsC,CAAC;AACrD,cAAc,wBAAwB,CAAC;AACvC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,kCAAkC,CAAC;AAEjD,kBAAkB;AAClB,cAAc,wBAAwB,CAAC","sourcesContent":["// Copyright 2025 IOTA Stiftung.\n// SPDX-License-Identifier: Apache-2.0.\n\n// Entity exports\nexport * from \"./entities/dataspaceAppDataset.js\";\nexport * from \"./entities/transferProcess.js\";\n\n// Control Plane exports\nexport * from \"./models/controlPlane/api/ITransferContextResponse.js\";\nexport * from \"./models/controlPlane/IDataspaceAppDataset.js\";\nexport * from \"./models/controlPlane/IDataspaceControlPlaneComponent.js\";\nexport * from \"./models/controlPlane/IDataspaceControlPlaneResolverComponent.js\";\nexport * from \"./models/controlPlane/INegotiationCallback.js\";\nexport * from \"./models/controlPlane/ITransferContext.js\";\nexport * from \"./models/controlPlane/ITransferProcess.js\";\nexport * from \"./models/controlPlane/transferProcessRole.js\";\n\n// Data Plane exports\nexport * from \"./models/dataPlane/IDataspaceDataPlaneComponent.js\";\n\nexport * from \"./models/dataspaceContexts.js\";\nexport * from \"./models/dataspaceTransferFormat.js\";\nexport * from \"./models/dataspaceTypes.js\";\nexport * from \"./models/IDataspaceActivity.js\";\n\nexport * from \"./dataTypes/dataspaceDataTypes.js\";\n\n// App exports\nexport * from \"./factories/dataspaceAppFactory.js\";\nexport * from \"./models/app/IDataspaceApp.js\";\nexport * from \"./models/app/IFollowActivity.js\";\nexport * from \"./models/app/IUndoActivity.js\";\nexport * from \"./models/app/IProcessingGroupOptions.js\";\n\n// Other exports\nexport * from \"./models/activityProcessingStatus.js\";\nexport * from \"./models/api/IActivityLogEntryGetRequest.js\";\nexport * from \"./models/api/IActivityLogEntryGetResponse.js\";\nexport * from \"./models/api/IActivityLogStatusNotificationPayload.js\";\nexport * from \"./models/api/IActivityLogStatusRequest.js\";\nexport * from \"./models/api/IActivityStreamNotifyRequest.js\";\nexport * from \"./models/api/IActivityStreamNotifyResponse.js\";\nexport * from \"./models/api/IDataAssetEntitiesResponse.js\";\nexport * from \"./models/api/IDataAssetGetEntitiesRequest.js\";\nexport * from \"./models/api/IDataAssetQueryRequest.js\";\n\n// Control Plane API exports - Transfer Process Protocol\nexport * from \"./models/api/controlPlane/IAppDatasetCreateRequest.js\";\nexport * from \"./models/api/controlPlane/IAppDatasetCreateResponse.js\";\nexport * from \"./models/api/controlPlane/IAppDatasetDeleteRequest.js\";\nexport * from \"./models/api/controlPlane/IAppDatasetGetRequest.js\";\nexport * from \"./models/api/controlPlane/IAppDatasetGetResponse.js\";\nexport * from \"./models/api/controlPlane/IAppDatasetListRequest.js\";\nexport * from \"./models/api/controlPlane/IAppDatasetListResponse.js\";\nexport * from \"./models/api/controlPlane/IAppDatasetUpdateRequest.js\";\nexport * from \"./models/api/controlPlane/ICompleteTransferRequest.js\";\nexport * from \"./models/api/controlPlane/ICompleteTransferResponse.js\";\nexport * from \"./models/api/controlPlane/IGetTransferProcessRequest.js\";\nexport * from \"./models/api/controlPlane/IGetTransferProcessResponse.js\";\nexport * from \"./models/api/controlPlane/IRequestTransferRequest.js\";\nexport * from \"./models/api/controlPlane/IRequestTransferResponse.js\";\nexport * from \"./models/api/controlPlane/IStartTransferRequest.js\";\nexport * from \"./models/api/controlPlane/IStartTransferResponse.js\";\nexport * from \"./models/api/controlPlane/ISuspendTransferRequest.js\";\nexport * from \"./models/api/controlPlane/ISuspendTransferResponse.js\";\nexport * from \"./models/api/controlPlane/ITerminateTransferRequest.js\";\nexport * from \"./models/api/controlPlane/ITerminateTransferResponse.js\";\n\nexport * from \"./models/activityTaskStatus.js\";\nexport * from \"./models/app/dataRequestType.js\";\nexport * from \"./models/app/IActivityQuery.js\";\nexport * from \"./models/app/IDataAssetEntitiesRequest.js\";\nexport * from \"./models/app/IDataAssetQuery.js\";\nexport * from \"./models/app/IDataRequest.js\";\nexport * from \"./models/app/IQueryDataAssetRequest.js\";\nexport * from \"./models/IActivityLogDetails.js\";\nexport * from \"./models/IActivityLogEntry.js\";\nexport * from \"./models/IActivityLogStatusNotification.js\";\nexport * from \"./models/IActivityTask.js\";\nexport * from \"./models/IActivityTaskEntry.js\";\nexport * from \"./models/IDataAssetItemList.js\";\nexport * from \"./models/IDataAssetItemListResult.js\";\nexport * from \"./models/IEntitySet.js\";\nexport * from \"./models/IExecutionPayload.js\";\nexport * from \"./models/IFilteringQuery.js\";\nexport * from \"./models/IPushDeliveryPayload.js\";\n\n// Utility exports\nexport * from \"./utils/jsonLdUtils.js\";\n"]}

package/dist/es/models/IPushDeliveryPayload.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=IPushDeliveryPayload.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"IPushDeliveryPayload.js","sourceRoot":"","sources":["../../../src/models/IPushDeliveryPayload.ts"],"names":[],"mappings":"","sourcesContent":["// Copyright 2026 IOTA Stiftung.\n// SPDX-License-Identifier: Apache-2.0.\nimport type { IJsonLdNodeObject } from \"@twin.org/data-json-ld\";\nimport type { IDataspaceProtocolAgreement } from \"@twin.org/standards-dataspace-protocol\";\n\n/**\n * Payload handed to pushDeliveryRunner via a Background Task.\n * Contains everything the runner needs to POST one Activity Streams\n * object to a consumer's /inbox without touching entity storage.\n */\nexport interface IPushDeliveryPayload {\n\t/**\n\t * The consumer process ID identifying the transfer.\n\t */\n\tconsumerPid: string;\n\n\t/**\n\t * The provider process ID identifying the transfer.\n\t */\n\tproviderPid: string;\n\n\t/**\n\t * PID to set as Activity.generator. Always equals providerPid since\n\t * processOutboxActivity is only invoked for consumer-initiated push,\n\t * where the provider is the data sender.\n\t */\n\tgeneratorPid: string;\n\n\t/**\n\t * The consumer's inbox endpoint URL to POST the activity to.\n\t */\n\tconsumerEndpoint: string;\n\n\t/**\n\t * Optional Bearer token for authenticating the push request.\n\t */\n\tconsumerAuthToken?: string;\n\n\t/**\n\t * The ODRL agreement governing the data transfer.\n\t */\n\tagreement: IDataspaceProtocolAgreement;\n\n\t/**\n\t * The JSON-LD data payload to deliver to the consumer.\n\t */\n\tdata: IJsonLdNodeObject;\n\n\t/**\n\t * The JSON-LD @type of the data entity being delivered.\n\t */\n\tentityType: string;\n\n\t/**\n\t * The tenant that owns this push delivery, captured at schedule time from the active\n\t * `ContextIdStore` context (typically from the subscription's `tenantId` field).\n\t * The runner re-establishes this tenant context via `ContextIdStore.run` before invoking\n\t * tenant-scoped operations (PEP, trust signing, vault lookups). Optional — single-tenant\n\t * nodes operate without a tenant context.\n\t */\n\ttenantId?: string;\n\n\t/**\n\t * Timeout (ms) for the push delivery HTTP POST. Packaged at schedule time from service config.\n\t * @default 30000\n\t */\n\tpushTimeoutMs?: number;\n\n\t/**\n\t * Max HTTP retry attempts for this delivery. Packaged at schedule time from service config.\n\t * @default 3\n\t */\n\tpushRetryCount?: number;\n\t/**\n\t * Base retry delay (ms) for this delivery. Packaged at schedule time from service config.\n\t * @default 1000\n\t */\n\tpushRetryBaseDelayMs?: number;\n}\n"]}

package/dist/es/models/api/IActivityStreamNotifyRequest.js.map

@@ -1 +1 @@
-{"version":3,"file":"IActivityStreamNotifyRequest.js","sourceRoot":"","sources":["../../../../src/models/api/IActivityStreamNotifyRequest.ts"],"names":[],"mappings":"","sourcesContent":["// Copyright 2025 IOTA Stiftung.\n// SPDX-License-Identifier: Apache-2.0.\nimport type { IActivityStreamsActivity } from \"@twin.org/standards-w3c-activity-streams\";\n\n/**\n * Activity Stream Notify Request.\n */\nexport interface IActivityStreamNotifyRequest {\n\t/**\n\t * The Activity sent to the Stream.\n\t */\n\tbody: IActivityStreamsActivity;\n}\n"]}
+{"version":3,"file":"IActivityStreamNotifyRequest.js","sourceRoot":"","sources":["../../../../src/models/api/IActivityStreamNotifyRequest.ts"],"names":[],"mappings":"","sourcesContent":["// Copyright 2025 IOTA Stiftung.\n// SPDX-License-Identifier: Apache-2.0.\nimport type { IActivityStreamsActivity } from \"@twin.org/standards-w3c-activity-streams\";\nimport type { HeaderTypes } from \"@twin.org/web\";\n\n/**\n * Activity Stream Notify Request.\n */\nexport interface IActivityStreamNotifyRequest {\n\t/**\n\t * The headers which can be used for authentication (e.g. Bearer token for cross-node push).\n\t */\n\theaders?: {\n\t\t[HeaderTypes.Authorization]?: string;\n\t};\n\n\t/**\n\t * The Activity sent to the Stream.\n\t */\n\tbody: IActivityStreamsActivity;\n}\n"]}

package/dist/es/models/api/IActivityStreamNotifyResponse.js.map

@@ -1 +1 @@
-{"version":3,"file":"IActivityStreamNotifyResponse.js","sourceRoot":"","sources":["../../../../src/models/api/IActivityStreamNotifyResponse.ts"],"names":[],"mappings":"","sourcesContent":["// Copyright 2025 IOTA Stiftung.\n// SPDX-License-Identifier: Apache-2.0.\nimport type { HeaderTypes, HttpStatusCode } from \"@twin.org/web\";\nimport type { IActivityLogEntry } from \"../IActivityLogEntry.js\";\n\n/**\n * Activity Stream Notify Response.\n */\nexport interface IActivityStreamNotifyResponse {\n\t/**\n\t * The status code indicating the result of the notification processing. It can be either:\n\t * - `201 Created` if the notification was processed inline and a new activity log entry was created.\n\t * - `102 Processing` if the notification was accepted for processing but has not been completed yet.\n\t */\n\tstatusCode: typeof HttpStatusCode.created | typeof HttpStatusCode.processing;\n\n\t/**\n\t * Optional headers.\n\t */\n\theaders?: {\n\t\t[HeaderTypes.Location]?: string;\n\t};\n\n\t/**\n\t * The Activity log entry if the notification was processed inline.\n\t */\n\tbody?: IActivityLogEntry;\n}\n"]}
+{"version":3,"file":"IActivityStreamNotifyResponse.js","sourceRoot":"","sources":["../../../../src/models/api/IActivityStreamNotifyResponse.ts"],"names":[],"mappings":"","sourcesContent":["// Copyright 2025 IOTA Stiftung.\n// SPDX-License-Identifier: Apache-2.0.\nimport type { HeaderTypes, HttpStatusCode } from \"@twin.org/web\";\nimport type { IActivityLogEntry } from \"../IActivityLogEntry.js\";\n\n/**\n * Activity Stream Notify Response.\n */\nexport interface IActivityStreamNotifyResponse {\n\t/**\n\t * The status code indicating the result of the notification processing. It can be either:\n\t * - `201 Created` if the notification was processed inline and a new activity log entry was created.\n\t * - `202 Accepted` if the notification was accepted for async processing but has not been completed yet.\n\t */\n\tstatusCode: typeof HttpStatusCode.created | typeof HttpStatusCode.accepted;\n\n\t/**\n\t * Optional headers.\n\t */\n\theaders?: {\n\t\t[HeaderTypes.Location]?: string;\n\t};\n\n\t/**\n\t * The Activity log entry if the notification was processed inline.\n\t */\n\tbody?: IActivityLogEntry;\n}\n"]}

package/dist/es/models/app/IDataspaceApp.js.map

@@ -1 +1 @@
-{"version":3,"file":"IDataspaceApp.js","sourceRoot":"","sources":["../../../../src/models/app/IDataspaceApp.ts"],"names":[],"mappings":"","sourcesContent":["// Copyright 2025 IOTA Stiftung.\n// SPDX-License-Identifier: Apache-2.0.\nimport type { IComponent } from \"@twin.org/core\";\nimport type { IJsonLdDocument } from \"@twin.org/data-json-ld\";\nimport type { IDataspaceProtocolDataset } from \"@twin.org/standards-dataspace-protocol\";\nimport type { IActivityQuery } from \"./IActivityQuery.js\";\nimport type { IDataRequest } from \"./IDataRequest.js\";\nimport type { IDataspaceActivity } from \"../IDataspaceActivity.js\";\nimport type { IProcessingGroupOptions } from \"./IProcessingGroupOptions.js\";\n\n/**\n * Interface describes a Dataspace App.\n */\nexport interface IDataspaceApp extends IComponent {\n\t/**\n\t * The settings for the processing groups for tasks.\n\t * @returns The options for each process group.\n\t */\n\tprocessingGroups?(): { [id: string]: IProcessingGroupOptions };\n\n\t/**\n\t * The activities handled by the App.\n\t * @returns A query that describes the set of activities handled by the App.\n\t */\n\tactivitiesHandled(): IActivityQuery[];\n\n\t/**\n\t * Optional override called by the Control Plane when publishing a stored dataset for this app.\n\t * The Control Plane always calls `populateDefaults` (e.g. `dcterms:publisher`)\n\t * on every dataset returned here, so apps don't need to populate publisher themselves.\n\t * @param payload The user-stored dataset payload.\n\t * @param tenantId The owning tenant for this dataset. Empty string on\n\t * single-tenant nodes (no `TWIN_TENANT_ENABLED`).\n\t * @returns One or more datasets to publish to the catalogue. System-stamped\n\t * fields like `dcterms:publisher` may be omitted — the Control Plane fills them in.\n\t */\n\tdatasetsHandled?(\n\t\tpayload: IDataspaceProtocolDataset,\n\t\ttenantId: string\n\t): Promise<IDataspaceProtocolDataset[]>;\n\n\t/**\n\t * The types of queries supported.\n\t * @returns The types of queries supported by the Dataspace App to retrieve data.\n\t */\n\tsupportedQueryTypes(): string[];\n\n\t/**\n\t * Handles an Activity and report about results through the Dataspace Data Plane Callback\n\t * @param activity The Activity to be handled\n\t * @returns The result of executing the Activity.\n\t */\n\thandleActivity?<T>(activity: IDataspaceActivity): Promise<T>;\n\n\t/**\n\t * Handles a Data Request.\n\t * @param dataRequest The data request.\n\t * @param cursor Cursor that points to the next item in the result set.\n\t * @param limit Maximum number of entries retrieved or to be retrieved.\n\t * @returns Data as JSON-Ld.\n\t */\n\thandleDataRequest?(\n\t\tdataRequest: IDataRequest,\n\t\tcursor?: string,\n\t\tlimit?: number\n\t): Promise<{ data: IJsonLdDocument; cursor?: string }>;\n}\n"]}
+{"version":3,"file":"IDataspaceApp.js","sourceRoot":"","sources":["../../../../src/models/app/IDataspaceApp.ts"],"names":[],"mappings":"","sourcesContent":["// Copyright 2025 IOTA Stiftung.\n// SPDX-License-Identifier: Apache-2.0.\nimport type { IComponent } from \"@twin.org/core\";\nimport type { IJsonLdDocument } from \"@twin.org/data-json-ld\";\nimport type { IDataspaceProtocolDataset } from \"@twin.org/standards-dataspace-protocol\";\nimport type { IActivityQuery } from \"./IActivityQuery.js\";\nimport type { IDataRequest } from \"./IDataRequest.js\";\nimport type { IFollowActivity } from \"./IFollowActivity.js\";\nimport type { IUndoActivity } from \"./IUndoActivity.js\";\nimport type { IDataspaceActivity } from \"../IDataspaceActivity.js\";\nimport type { IProcessingGroupOptions } from \"./IProcessingGroupOptions.js\";\n\n/**\n * Interface describes a Dataspace App.\n */\nexport interface IDataspaceApp extends IComponent {\n\t/**\n\t * The settings for the processing groups for tasks.\n\t * @returns The options for each process group.\n\t */\n\tprocessingGroups?(): { [id: string]: IProcessingGroupOptions };\n\n\t/**\n\t * The activities handled by the App.\n\t * @returns A query that describes the set of activities handled by the App.\n\t */\n\tactivitiesHandled(): IActivityQuery[];\n\n\t/**\n\t * Optional override called by the Control Plane when publishing a stored dataset for this app.\n\t * The Control Plane always calls `populateDefaults` (e.g. `dcterms:publisher`)\n\t * on every dataset returned here, so apps don't need to populate publisher themselves.\n\t * @param payload The user-stored dataset payload.\n\t * @param tenantId The owning tenant for this dataset. Empty string on\n\t * single-tenant nodes (no `TWIN_TENANT_ENABLED`).\n\t * @returns One or more datasets to publish to the catalogue. System-stamped\n\t * fields like `dcterms:publisher` may be omitted — the Control Plane fills them in.\n\t */\n\tdatasetsHandled?(\n\t\tpayload: IDataspaceProtocolDataset,\n\t\ttenantId: string\n\t): Promise<IDataspaceProtocolDataset[]>;\n\n\t/**\n\t * The types of queries supported.\n\t * @returns The types of queries supported by the Dataspace App to retrieve data.\n\t */\n\tsupportedQueryTypes(): string[];\n\n\t/**\n\t * Handles an Activity and report about results through the Dataspace Data Plane Callback\n\t * @param activity The Activity to be handled\n\t * @returns The result of executing the Activity.\n\t */\n\thandleActivity?<T>(activity: IDataspaceActivity): Promise<T>;\n\n\t/**\n\t * Handles a Data Request.\n\t * @param dataRequest The data request.\n\t * @param cursor Cursor that points to the next item in the result set.\n\t * @param limit Maximum number of entries retrieved or to be retrieved.\n\t * @returns Data as JSON-Ld.\n\t */\n\thandleDataRequest?(\n\t\tdataRequest: IDataRequest,\n\t\tcursor?: string,\n\t\tlimit?: number\n\t): Promise<{ data: IJsonLdDocument; cursor?: string }>;\n\n\t/**\n\t * Subscribe the app to produce data for a follower. Called by the\n\t * DS Connector after a push transfer enters STARTED state.\n\t * @param followActivity The Follow activity describing the follower + filter.\n\t * @returns Promise that resolves when the subscription is set up.\n\t */\n\tsubscribeToData?(followActivity: IFollowActivity): Promise<void>;\n\n\t/**\n\t * Undo a previous subscription. Called on transfer complete/terminate.\n\t * @param undoActivity The Undo activity referencing the original Follow.\n\t * @returns Promise that resolves when the subscription is torn down.\n\t */\n\tunsubscribeToData?(undoActivity: IUndoActivity): Promise<void>;\n}\n"]}

package/dist/es/models/app/IFollowActivity.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=IFollowActivity.js.map

package/dist/es/models/app/IFollowActivity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IFollowActivity.js","sourceRoot":"","sources":["../../../../src/models/app/IFollowActivity.ts"],"names":[],"mappings":"","sourcesContent":["// Copyright 2025 IOTA Stiftung.\n// SPDX-License-Identifier: Apache-2.0.\nimport type { IJsonLdNodeObject } from \"@twin.org/data-json-ld\";\nimport type {\n\tActivityStreamsTypes,\n\tIActivityStreamsActivity\n} from \"@twin.org/standards-w3c-activity-streams\";\n\n/**\n * ActivityPub Follow activity used by the DS Connector to subscribe\n * an app to a data source. The app treats this as \"start producing\n * data for this consumer.\"\n *\n * generator = consumerPid (URN) of the follower\n * actor     = DID of the follower's organization\n * object    = TransferProcess reference, optionally with a filter expressed as JSON-LD\n */\nexport interface IFollowActivity extends IActivityStreamsActivity {\n\t/**\n\t * The activity type, always \"Follow\".\n\t */\n\ttype: typeof ActivityStreamsTypes.Follow;\n\n\t/**\n\t * The consumerPid URN identifying the follower's transfer process.\n\t */\n\tgenerator: string;\n\n\t/**\n\t * The DID of the follower's organization.\n\t */\n\tactor: string;\n\n\t/**\n\t * The TransferProcess reference, optionally with a filter expressed as JSON-LD.\n\t */\n\tobject: string | IJsonLdNodeObject;\n}\n"]}

package/dist/es/models/app/IUndoActivity.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=IUndoActivity.js.map

package/dist/es/models/app/IUndoActivity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IUndoActivity.js","sourceRoot":"","sources":["../../../../src/models/app/IUndoActivity.ts"],"names":[],"mappings":"","sourcesContent":["// Copyright 2026 IOTA Stiftung.\n// SPDX-License-Identifier: Apache-2.0.\nimport type {\n\tActivityStreamsTypes,\n\tIActivityStreamsActivity\n} from \"@twin.org/standards-w3c-activity-streams\";\n\n/**\n * ActivityPub Undo activity used by the DS Connector to unsubscribe\n * an app from a data source. The object MUST reference the `@id` of\n * a previously issued Follow activity.\n */\nexport interface IUndoActivity extends IActivityStreamsActivity {\n\t/**\n\t * The activity type, always \"Undo\".\n\t */\n\ttype: typeof ActivityStreamsTypes.Undo;\n\n\t/**\n\t * The consumerPid URN identifying the transfer process being unsubscribed.\n\t */\n\tgenerator: string;\n\n\t/**\n\t * The DID of the unsubscribing organization.\n\t */\n\tactor: string;\n\n\t/**\n\t * The `@id` of the Follow activity being undone.\n\t */\n\tobject: string;\n}\n"]}

package/dist/es/models/controlPlane/ITransferContext.js.map

@@ -1 +1 @@
-{"version":3,"file":"ITransferContext.js","sourceRoot":"","sources":["../../../../src/models/controlPlane/ITransferContext.ts"],"names":[],"mappings":"","sourcesContent":["// Copyright 2025 IOTA Stiftung.\n// SPDX-License-Identifier: Apache-2.0.\nimport type {\n\tDataspaceProtocolTransferProcessStateType,\n\tIDataspaceProtocolAgreement,\n\tIDataspaceProtocolDataAddress\n} from \"@twin.org/standards-dataspace-protocol\";\n\n/**\n * Transfer Context data structure.\n * Contains all information needed by DSC to execute queries.\n * This is NOT part of the DSP protocol - it's a TWIN internal API\n * used by dataspace-control-plane to resolve consumerPid to datasetId and policies.\n */\nexport interface ITransferContext {\n\t/**\n\t * Consumer Process ID.\n\t */\n\tconsumerPid: string;\n\n\t/**\n\t * Provider Process ID.\n\t */\n\tproviderPid: string;\n\n\t/**\n\t * Agreement associated with this Transfer Process.\n\t * Contains permissions, obligations, and prohibitions that DSC uses for runtime policy enforcement.\n\t */\n\tagreement: IDataspaceProtocolAgreement;\n\n\t/**\n\t * Dataset ID - what the DSC needs to execute the query.\n\t * Convenience field extracted from agreement.target for quick access.\n\t */\n\tdatasetId: string;\n\n\t/**\n\t * Offer ID.\n\t */\n\tofferId: string;\n\n\t/**\n\t * Current Transfer Process state.\n\t * DSC should only allow queries if state is STARTED.\n\t */\n\tstate: DataspaceProtocolTransferProcessStateType;\n\n\t/**\n\t * Consumer identity (for auditing).\n\t */\n\tconsumerIdentity?: string;\n\n\t/**\n\t * Provider identity (for auditing).\n\t * Extracted from Agreement's assigner field.\n\t */\n\tproviderIdentity?: string;\n\n\t/**\n\t * Data address for push mode transfers.\n\t * Contains endpoint information where data should be pushed (for Activity Stream push mode).\n\t * Only present when format is Http-Push-Activity-Stream-Format or Http-Post-Activity-Stream-Format.\n\t */\n\tdataAddress?: IDataspaceProtocolDataAddress;\n}\n"]}
+{"version":3,"file":"ITransferContext.js","sourceRoot":"","sources":["../../../../src/models/controlPlane/ITransferContext.ts"],"names":[],"mappings":"","sourcesContent":["// Copyright 2025 IOTA Stiftung.\n// SPDX-License-Identifier: Apache-2.0.\nimport type {\n\tDataspaceProtocolTransferProcessStateType,\n\tIDataspaceProtocolAgreement,\n\tIDataspaceProtocolDataAddress\n} from \"@twin.org/standards-dataspace-protocol\";\n\n/**\n * Transfer Context data structure.\n * Contains all information needed by DSC to execute queries.\n * This is NOT part of the DSP protocol - it's a TWIN internal API\n * used by dataspace-control-plane to resolve consumerPid to datasetId and policies.\n */\nexport interface ITransferContext {\n\t/**\n\t * Consumer Process ID.\n\t */\n\tconsumerPid: string;\n\n\t/**\n\t * Provider Process ID.\n\t */\n\tproviderPid: string;\n\n\t/**\n\t * Agreement associated with this Transfer Process.\n\t * Contains permissions, obligations, and prohibitions that DSC uses for runtime policy enforcement.\n\t */\n\tagreement: IDataspaceProtocolAgreement;\n\n\t/**\n\t * Dataset ID - what the DSC needs to execute the query.\n\t * Convenience field extracted from agreement.target for quick access.\n\t */\n\tdatasetId: string;\n\n\t/**\n\t * Offer ID.\n\t */\n\tofferId: string;\n\n\t/**\n\t * Current Transfer Process state.\n\t * DSC should only allow queries if state is STARTED.\n\t */\n\tstate: DataspaceProtocolTransferProcessStateType;\n\n\t/**\n\t * Consumer identity (for auditing).\n\t */\n\tconsumerIdentity?: string;\n\n\t/**\n\t * Provider identity (for auditing).\n\t * Extracted from Agreement's assigner field.\n\t */\n\tproviderIdentity?: string;\n\n\t/**\n\t * Data address for consumer-initiated push transfers (HttpProxy-PUSH).\n\t * Contains the consumer's /inbox endpoint as supplied in the TransferRequestMessage.\n\t * Absent for PULL (HttpProxy-PULL) and provider-initiated push (HttpProxy-POST),\n\t * where the consumer deliberately omits a dataAddress.\n\t */\n\tdataAddress?: IDataspaceProtocolDataAddress;\n}\n"]}

package/dist/es/models/controlPlane/ITransferProcess.js.map

@@ -1 +1 @@
-{"version":3,"file":"ITransferProcess.js","sourceRoot":"","sources":["../../../../src/models/controlPlane/ITransferProcess.ts"],"names":[],"mappings":"","sourcesContent":["// Copyright 2025 IOTA Stiftung.\n// SPDX-License-Identifier: Apache-2.0.\nimport type {\n\tDataspaceProtocolTransferProcessStateType,\n\tIDataspaceProtocolDataAddress,\n\tIDataspaceProtocolPolicy\n} from \"@twin.org/standards-dataspace-protocol\";\n\n/**\n * Transfer Process for internal storage.\n * Combines DSP protocol fields with internal TWIN fields.\n * This is NOT the DSP wire format (use ITransferProcess from standards for that).\n */\nexport interface ITransferProcess {\n\t/**\n\t * Internal UUID (primary key for entity storage).\n\t */\n\tid: string;\n\n\t// === DSP Protocol fields (public) ===\n\n\t/**\n\t * Consumer Process ID from the DSP protocol.\n\t * Refers to the transfer identifier on the Consumer side.\n\t */\n\tconsumerPid: string;\n\n\t/**\n\t * Provider Process ID from the DSP protocol.\n\t * Refers to the transfer identifier on the Provider side.\n\t */\n\tproviderPid: string;\n\n\t/**\n\t * Transfer Process state from the DSP protocol.\n\t * One of: REQUESTED, STARTED, COMPLETED, SUSPENDED, TERMINATED.\n\t */\n\tstate: DataspaceProtocolTransferProcessStateType;\n\n\t// === Internal TWIN fields (NOT in DSP protocol) ===\n\n\t/**\n\t * Agreement ID linking to the rights-management Agreement.\n\t * Used to resolve policies and permissions.\n\t */\n\tagreementId: string;\n\n\t/**\n\t * Dataset ID for DSC resolution.\n\t * Identifies the dataset being transferred.\n\t */\n\tdatasetId: string;\n\n\t/**\n\t * Offer ID from the original Catalog offer.\n\t */\n\tofferId: string;\n\n\t/**\n\t * Policies from the Agreement.\n\t * Used by DSC for runtime policy enforcement.\n\t */\n\tpolicies?: IDataspaceProtocolPolicy[];\n\n\t/**\n\t * Consumer identity (DID or URI).\n\t * Used for auditing and access control.\n\t */\n\tconsumerIdentity?: string;\n\n\t/**\n\t * Provider identity (DID or URI).\n\t * Used for auditing.\n\t */\n\tproviderIdentity?: string;\n\n\t/**\n\t * Callback address for Consumer notifications.\n\t * URI where messages to the Consumer should be sent.\n\t */\n\tcallbackAddress?: string;\n\n\t/**\n\t * Data format from the Dataset Distribution.\n\t * Specified by a Distribution for the Dataset associated with the Agreement.\n\t */\n\tformat?: string;\n\n\t/**\n\t * Data address for push mode transfers.\n\t * Contains endpoint information where data should be pushed (for Activity Stream push mode).\n\t * Only present when format is Http-Push-Activity-Stream-Format or Http-Post-Activity-Stream-Format.\n\t */\n\tdataAddress?: IDataspaceProtocolDataAddress;\n\n\t/**\n\t * Creation timestamp.\n\t */\n\tdateCreated: Date;\n\n\t/**\n\t * Last update timestamp.\n\t */\n\tdateModified: Date;\n}\n"]}
+{"version":3,"file":"ITransferProcess.js","sourceRoot":"","sources":["../../../../src/models/controlPlane/ITransferProcess.ts"],"names":[],"mappings":"","sourcesContent":["// Copyright 2025 IOTA Stiftung.\n// SPDX-License-Identifier: Apache-2.0.\nimport type {\n\tDataspaceProtocolTransferProcessStateType,\n\tIDataspaceProtocolDataAddress,\n\tIDataspaceProtocolPolicy\n} from \"@twin.org/standards-dataspace-protocol\";\n\n/**\n * Transfer Process for internal storage.\n * Combines DSP protocol fields with internal TWIN fields.\n * This is NOT the DSP wire format (use ITransferProcess from standards for that).\n */\nexport interface ITransferProcess {\n\t/**\n\t * Internal UUID (primary key for entity storage).\n\t */\n\tid: string;\n\n\t// === DSP Protocol fields (public) ===\n\n\t/**\n\t * Consumer Process ID from the DSP protocol.\n\t * Refers to the transfer identifier on the Consumer side.\n\t */\n\tconsumerPid: string;\n\n\t/**\n\t * Provider Process ID from the DSP protocol.\n\t * Refers to the transfer identifier on the Provider side.\n\t */\n\tproviderPid: string;\n\n\t/**\n\t * Transfer Process state from the DSP protocol.\n\t * One of: REQUESTED, STARTED, COMPLETED, SUSPENDED, TERMINATED.\n\t */\n\tstate: DataspaceProtocolTransferProcessStateType;\n\n\t// === Internal TWIN fields (NOT in DSP protocol) ===\n\n\t/**\n\t * Agreement ID linking to the rights-management Agreement.\n\t * Used to resolve policies and permissions.\n\t */\n\tagreementId: string;\n\n\t/**\n\t * Dataset ID for DSC resolution.\n\t * Identifies the dataset being transferred.\n\t */\n\tdatasetId: string;\n\n\t/**\n\t * Offer ID from the original Catalog offer.\n\t */\n\tofferId: string;\n\n\t/**\n\t * Policies from the Agreement.\n\t * Used by DSC for runtime policy enforcement.\n\t */\n\tpolicies?: IDataspaceProtocolPolicy[];\n\n\t/**\n\t * Consumer identity (DID or URI).\n\t * Used for auditing and access control.\n\t */\n\tconsumerIdentity?: string;\n\n\t/**\n\t * Provider identity (DID or URI).\n\t * Used for auditing.\n\t */\n\tproviderIdentity?: string;\n\n\t/**\n\t * Callback address for Consumer notifications.\n\t * URI where messages to the Consumer should be sent.\n\t */\n\tcallbackAddress?: string;\n\n\t/**\n\t * The tenant that owns this transfer process, captured at write time so async\n\t * delivery tasks and delayed state transitions can re-enter the right tenant context.\n\t * Optional — single-tenant nodes operate without a tenant context.\n\t */\n\ttenantId?: string;\n\n\t/**\n\t * Data format from the Dataset Distribution.\n\t * Specified by a Distribution for the Dataset associated with the Agreement.\n\t */\n\tformat?: string;\n\n\t/**\n\t * Data address for consumer-initiated push transfers (HttpProxy-PUSH).\n\t * Contains the consumer's /inbox endpoint as supplied in the TransferRequestMessage.\n\t * Absent for PULL (HttpProxy-PULL) and provider-initiated push (HttpProxy-POST),\n\t * where the consumer deliberately omits a dataAddress.\n\t */\n\tdataAddress?: IDataspaceProtocolDataAddress;\n\n\t/**\n\t * Creation timestamp.\n\t */\n\tdateCreated: Date;\n\n\t/**\n\t * Last update timestamp.\n\t */\n\tdateModified: Date;\n}\n"]}

package/dist/es/models/dataPlane/IDataspaceDataPlaneComponent.js.map

@@ -1 +1 @@
-{"version":3,"file":"IDataspaceDataPlaneComponent.js","sourceRoot":"","sources":["../../../../src/models/dataPlane/IDataspaceDataPlaneComponent.ts"],"names":[],"mappings":"","sourcesContent":["// Copyright 2025 IOTA Stiftung.\n// SPDX-License-Identifier: Apache-2.0.\nimport type { IComponent } from \"@twin.org/core\";\nimport type { IJsonLdContextDefinitionElement } from \"@twin.org/data-json-ld\";\nimport type { IActivityStreamsActivity } from \"@twin.org/standards-w3c-activity-streams\";\nimport type { IActivityLogEntry } from \"../IActivityLogEntry.js\";\nimport type { IActivityLogStatusNotification } from \"../IActivityLogStatusNotification.js\";\nimport type { IDataAssetItemListResult } from \"../IDataAssetItemListResult.js\";\nimport type { IEntitySet } from \"../IEntitySet.js\";\nimport type { IFilteringQuery } from \"../IFilteringQuery.js\";\n\n/**\n * Dataspace Data Plane component interface.\n * Implements the Data Plane functionality for the Eclipse Dataspace Protocol.\n */\nexport interface IDataspaceDataPlaneComponent extends IComponent {\n\t/**\n\t * Notify an Activity to the Dataspace Data Plane Activity Stream.\n\t * @param activity The Activity notified.\n\t * @returns The activity's entry.\n\t */\n\tnotifyActivity(activity: IActivityStreamsActivity): Promise<string | IActivityLogEntry>;\n\n\t/**\n\t * Subscribes to the activity log.\n\t * @param callback The callback to be called when Activity Log is called.\n\t * @param subscriptionId The subscription Id.\n\t * @returns The subscription Id.\n\t */\n\tsubscribeToActivityLog(\n\t\tcallback: (notification: IActivityLogStatusNotification) => Promise<void>,\n\t\tsubscriptionId?: string\n\t): Promise<string>;\n\n\t/**\n\t * Unsubscribes to the activity log.\n\t * @param subscriptionId The subscription Id.\n\t * @returns The subscription Id.\n\t */\n\tunSubscribeToActivityLog(subscriptionId: string): Promise<void>;\n\n\t/**\n\t * Returns Activity Log Entry which contains the Activity processing details.\n\t * @param logEntryId The Id of the Activity Log Entry (a URI).\n\t * @returns the Activity Log Entry with the processing details.\n\t * @throws NotFoundError if activity log entry is not known.\n\t */\n\tgetActivityLogEntry(logEntryId: string): Promise<IActivityLogEntry>;\n\n\t/**\n\t * Get Data Asset entities. Allows to retrieve entities by their type or id.\n\t * @param entitySet The set of entities to be retrieved.\n\t * @param entitySet.jsonLdContext The JSON-LD Context to be used to expand the referred entityType.\n\t * @param consumerPid The consumer Process ID from the DSP Transfer Process.\n\t * Used to resolve datasetId from the Transfer Process.\n\t * @param cursor Pagination details - cursor.\n\t * @param limit Pagination details - max number of entities.\n\t * @param trustPayload Trust payload to verify the requesters identity.\n\t * @returns The item list and optional cursor for pagination via Link headers.\n\t */\n\tgetDataAssetEntities(\n\t\tentitySet: IEntitySet & {\n\t\t\tjsonLdContext?: IJsonLdContextDefinitionElement[];\n\t\t},\n\t\tconsumerPid: string,\n\t\tcursor?: string,\n\t\tlimit?: number,\n\t\ttrustPayload?: unknown\n\t): Promise<IDataAssetItemListResult>;\n\n\t/**\n\t * Queries a data asset controlled by this Dataspace App.\n\t * @param consumerPid The consumer Process ID from the DSP Transfer Process.\n\t * Used to resolve datasetId from the Transfer Process.\n\t * @param query The filtering query.\n\t * @param cursor Pagination details - cursor.\n\t * @param limit Pagination details - max number of entities.\n\t * @param trustPayload Trust payload to verify the requesters identity.\n\t * @returns The item list and optional cursor for pagination via Link headers.\n\t */\n\tqueryDataAsset(\n\t\tconsumerPid: string,\n\t\tquery: IFilteringQuery,\n\t\tcursor?: string,\n\t\tlimit?: number,\n\t\ttrustPayload?: unknown\n\t): Promise<IDataAssetItemListResult>;\n}\n"]}
+{"version":3,"file":"IDataspaceDataPlaneComponent.js","sourceRoot":"","sources":["../../../../src/models/dataPlane/IDataspaceDataPlaneComponent.ts"],"names":[],"mappings":"","sourcesContent":["// Copyright 2025 IOTA Stiftung.\n// SPDX-License-Identifier: Apache-2.0.\nimport type { IComponent } from \"@twin.org/core\";\nimport type { IJsonLdContextDefinitionElement } from \"@twin.org/data-json-ld\";\nimport type { IActivityStreamsActivity } from \"@twin.org/standards-w3c-activity-streams\";\nimport type { IActivityLogEntry } from \"../IActivityLogEntry.js\";\nimport type { IActivityLogStatusNotification } from \"../IActivityLogStatusNotification.js\";\nimport type { IDataAssetItemListResult } from \"../IDataAssetItemListResult.js\";\nimport type { IEntitySet } from \"../IEntitySet.js\";\nimport type { IFilteringQuery } from \"../IFilteringQuery.js\";\n\n/**\n * Dataspace Data Plane component interface.\n * Implements the Data Plane functionality for the Eclipse Dataspace Protocol.\n */\nexport interface IDataspaceDataPlaneComponent extends IComponent {\n\t/**\n\t * Notify an Activity to the Dataspace Data Plane Activity Stream.\n\t * @param activity The Activity notified.\n\t * @param trustPayload Optional trust payload to verify the requester's identity.\n\t * @returns The activity's entry.\n\t */\n\tnotifyActivity(\n\t\tactivity: IActivityStreamsActivity,\n\t\ttrustPayload?: unknown\n\t): Promise<string | IActivityLogEntry>;\n\n\t/**\n\t * Subscribes to the activity log.\n\t * @param callback The callback to be called when Activity Log is called.\n\t * @param subscriptionId The subscription Id.\n\t * @returns The subscription Id.\n\t */\n\tsubscribeToActivityLog(\n\t\tcallback: (notification: IActivityLogStatusNotification) => Promise<void>,\n\t\tsubscriptionId?: string\n\t): Promise<string>;\n\n\t/**\n\t * Unsubscribes to the activity log.\n\t * @param subscriptionId The subscription Id.\n\t * @returns The subscription Id.\n\t */\n\tunSubscribeToActivityLog(subscriptionId: string): Promise<void>;\n\n\t/**\n\t * Returns Activity Log Entry which contains the Activity processing details.\n\t * @param logEntryId The Id of the Activity Log Entry (a URI).\n\t * @returns the Activity Log Entry with the processing details.\n\t * @throws NotFoundError if activity log entry is not known.\n\t */\n\tgetActivityLogEntry(logEntryId: string): Promise<IActivityLogEntry>;\n\n\t/**\n\t * Get Data Asset entities. Allows to retrieve entities by their type or id.\n\t * @param entitySet The set of entities to be retrieved.\n\t * @param entitySet.jsonLdContext The JSON-LD Context to be used to expand the referred entityType.\n\t * @param consumerPid The consumer Process ID from the DSP Transfer Process.\n\t * Used to resolve datasetId from the Transfer Process.\n\t * @param cursor Pagination details - cursor.\n\t * @param limit Pagination details - max number of entities.\n\t * @param trustPayload Trust payload to verify the requesters identity.\n\t * @returns The item list and optional cursor for pagination via Link headers.\n\t */\n\tgetDataAssetEntities(\n\t\tentitySet: IEntitySet & {\n\t\t\tjsonLdContext?: IJsonLdContextDefinitionElement[];\n\t\t},\n\t\tconsumerPid: string,\n\t\tcursor?: string,\n\t\tlimit?: number,\n\t\ttrustPayload?: unknown\n\t): Promise<IDataAssetItemListResult>;\n\n\t/**\n\t * Queries a data asset controlled by this Dataspace App.\n\t * @param consumerPid The consumer Process ID from the DSP Transfer Process.\n\t * Used to resolve datasetId from the Transfer Process.\n\t * @param query The filtering query.\n\t * @param cursor Pagination details - cursor.\n\t * @param limit Pagination details - max number of entities.\n\t * @param trustPayload Trust payload to verify the requesters identity.\n\t * @returns The item list and optional cursor for pagination via Link headers.\n\t */\n\tqueryDataAsset(\n\t\tconsumerPid: string,\n\t\tquery: IFilteringQuery,\n\t\tcursor?: string,\n\t\tlimit?: number,\n\t\ttrustPayload?: unknown\n\t): Promise<IDataAssetItemListResult>;\n\n\t/**\n\t * Set up a push subscription after a transfer enters STARTED from REQUESTED.\n\t * Reads the TransferProcess, builds an IFollowActivity, calls the app's\n\t * subscribeToData, and persists a PushSubscription entity.\n\t * @param consumerPid The consumer process ID identifying the transfer.\n\t * @returns Promise that resolves when the subscription is created.\n\t */\n\tsetupPushSubscription(consumerPid: string): Promise<void>;\n\n\t/**\n\t * Pause deliveries for a push subscription. The subscription entity stays\n\t * alive with status=Paused. No app unsubscribe call.\n\t * @param consumerPid The consumer process ID identifying the transfer.\n\t * @returns Promise that resolves when the subscription is paused.\n\t */\n\tsuspendPushSubscription(consumerPid: string): Promise<void>;\n\n\t/**\n\t * Resume deliveries after a SUSPENDED → STARTED transition. Flips status\n\t * back to Active. No app subscribeToData call.\n\t * @param consumerPid The consumer process ID identifying the transfer.\n\t * @returns Promise that resolves when the subscription is resumed.\n\t */\n\tresumePushSubscription(consumerPid: string): Promise<void>;\n\n\t/**\n\t * Tear down a push subscription. Builds an IUndoActivity, calls the app's\n\t * unsubscribeToData, and deletes the PushSubscription entity.\n\t * @param consumerPid The consumer process ID identifying the transfer.\n\t * @returns Promise that resolves when the subscription is torn down.\n\t */\n\tteardownPushSubscription(consumerPid: string): Promise<void>;\n\n\t/**\n\t * Called by the app when new data is available for a follower.\n\t * The activity's `to` attribute contains the consumerPid URN. This method\n\t * looks up the matching PushSubscription, validates transfer state, and\n\t * schedules a Background Task that POSTs the activity to the consumer.\n\t * @param activity The outbound activity carrying the data payload.\n\t * @returns Promise that resolves when the delivery task is scheduled.\n\t */\n\tprocessOutboxActivity(activity: IActivityStreamsActivity): Promise<void>;\n}\n"]}

package/dist/es/utils/jsonLdUtils.js

@@ -0,0 +1,20 @@
+// Copyright 2025 IOTA Stiftung.
+// SPDX-License-Identifier: Apache-2.0.
+import { ObjectHelper } from "@twin.org/core";
+/**
+ * Get a JSON-LD id.
+ * @param object The object to get the id from.
+ * @returns The JSON-LD id.
+ */
+export function getJsonLdId(object) {
+    return ObjectHelper.extractProperty(object, ["@id", "id"], false);
+}
+/**
+ * Get a JSON-LD type.
+ * @param object The object to get the type from.
+ * @returns The JSON-LD type.
+ */
+export function getJsonLdType(object) {
+    return ObjectHelper.extractProperty(object, ["@type", "type"], false);
+}
+//# sourceMappingURL=jsonLdUtils.js.map

package/dist/es/utils/jsonLdUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonLdUtils.js","sourceRoot":"","sources":["../../../src/utils/jsonLdUtils.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,uCAAuC;AACvC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,MAAe;IAC1C,OAAO,YAAY,CAAC,eAAe,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,KAAK,CAAC,CAAC;AACnE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,MAAe;IAC5C,OAAO,YAAY,CAAC,eAAe,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,EAAE,KAAK,CAAC,CAAC;AACvE,CAAC","sourcesContent":["// Copyright 2025 IOTA Stiftung.\n// SPDX-License-Identifier: Apache-2.0.\nimport { ObjectHelper } from \"@twin.org/core\";\n\n/**\n * Get a JSON-LD id.\n * @param object The object to get the id from.\n * @returns The JSON-LD id.\n */\nexport function getJsonLdId(object: unknown): string | undefined {\n\treturn ObjectHelper.extractProperty(object, [\"@id\", \"id\"], false);\n}\n\n/**\n * Get a JSON-LD type.\n * @param object The object to get the type from.\n * @returns The JSON-LD type.\n */\nexport function getJsonLdType(object: unknown): string | undefined {\n\treturn ObjectHelper.extractProperty(object, [\"@type\", \"type\"], false);\n}\n"]}

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

@@ -51,6 +51,13 @@ export declare class TransferProcess {
      * Callback address for Consumer notifications.
      */
     callbackAddress?: string;
+    /**
+     * The tenant that owns this transfer process, captured from the request context
+     * at write time. Optional — single-tenant nodes (no `TWIN_TENANT_ENABLED`) register
+     * transfers without a tenant context. Persisted so async push delivery tasks and
+     * setTimeout-delayed state transitions can re-enter the right tenant context.
+     */
+    tenantId?: string;
     /**
      * Creation timestamp (ISO string format).
      */

package/dist/types/index.d.ts

@@ -16,6 +16,8 @@ export * from "./models/IDataspaceActivity.js";
 export * from "./dataTypes/dataspaceDataTypes.js";
 export * from "./factories/dataspaceAppFactory.js";
 export * from "./models/app/IDataspaceApp.js";
+export * from "./models/app/IFollowActivity.js";
+export * from "./models/app/IUndoActivity.js";
 export * from "./models/app/IProcessingGroupOptions.js";
 export * from "./models/activityProcessingStatus.js";
 export * from "./models/api/IActivityLogEntryGetRequest.js";
@@ -64,3 +66,5 @@ export * from "./models/IDataAssetItemListResult.js";
 export * from "./models/IEntitySet.js";
 export * from "./models/IExecutionPayload.js";
 export * from "./models/IFilteringQuery.js";
+export * from "./models/IPushDeliveryPayload.js";
+export * from "./utils/jsonLdUtils.js";

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

@@ -0,0 +1,66 @@
+import type { IJsonLdNodeObject } from "@twin.org/data-json-ld";
+import type { IDataspaceProtocolAgreement } from "@twin.org/standards-dataspace-protocol";
+/**
+ * Payload handed to pushDeliveryRunner via a Background Task.
+ * Contains everything the runner needs to POST one Activity Streams
+ * object to a consumer's /inbox without touching entity storage.
+ */
+export interface IPushDeliveryPayload {
+    /**
+     * The consumer process ID identifying the transfer.
+     */
+    consumerPid: string;
+    /**
+     * The provider process ID identifying the transfer.
+     */
+    providerPid: string;
+    /**
+     * PID to set as Activity.generator. Always equals providerPid since
+     * processOutboxActivity is only invoked for consumer-initiated push,
+     * where the provider is the data sender.
+     */
+    generatorPid: string;
+    /**
+     * The consumer's inbox endpoint URL to POST the activity to.
+     */
+    consumerEndpoint: string;
+    /**
+     * Optional Bearer token for authenticating the push request.
+     */
+    consumerAuthToken?: string;
+    /**
+     * The ODRL agreement governing the data transfer.
+     */
+    agreement: IDataspaceProtocolAgreement;
+    /**
+     * The JSON-LD data payload to deliver to the consumer.
+     */
+    data: IJsonLdNodeObject;
+    /**
+     * The JSON-LD @type of the data entity being delivered.
+     */
+    entityType: string;
+    /**
+     * The tenant that owns this push delivery, captured at schedule time from the active
+     * `ContextIdStore` context (typically from the subscription's `tenantId` field).
+     * The runner re-establishes this tenant context via `ContextIdStore.run` before invoking
+     * tenant-scoped operations (PEP, trust signing, vault lookups). Optional — single-tenant
+     * nodes operate without a tenant context.
+     */
+    tenantId?: string;
+    /**
+     * Timeout (ms) for the push delivery HTTP POST. Packaged at schedule time from service config.
+     * @default 30000
+     */
+    pushTimeoutMs?: number;
+    /**
+     * Max HTTP retry attempts for this delivery. Packaged at schedule time from service config.
+     * @default 3
+     */
+    pushRetryCount?: number;
+    /**
+     * Base retry delay (ms) for this delivery. Packaged at schedule time from service config.
+     * @default 1000
+     */
+    pushRetryBaseDelayMs?: number;
+}

package/dist/types/models/api/IActivityStreamNotifyRequest.d.ts

@@ -1,8 +1,15 @@
 import type { IActivityStreamsActivity } from "@twin.org/standards-w3c-activity-streams";
+import type { HeaderTypes } from "@twin.org/web";
 /**
  * Activity Stream Notify Request.
  */
 export interface IActivityStreamNotifyRequest {
+    /**
+     * The headers which can be used for authentication (e.g. Bearer token for cross-node push).
+     */
+    headers?: {
+        [HeaderTypes.Authorization]?: string;
+    };
     /**
      * The Activity sent to the Stream.
      */

package/dist/types/models/api/IActivityStreamNotifyResponse.d.ts

@@ -7,9 +7,9 @@ export interface IActivityStreamNotifyResponse {
     /**
      * The status code indicating the result of the notification processing. It can be either:
      * - `201 Created` if the notification was processed inline and a new activity log entry was created.
-     * - `102 Processing` if the notification was accepted for processing but has not been completed yet.
+     * - `202 Accepted` if the notification was accepted for async processing but has not been completed yet.
      */
-    statusCode: typeof HttpStatusCode.created | typeof HttpStatusCode.processing;
+    statusCode: typeof HttpStatusCode.created | typeof HttpStatusCode.accepted;
     /**
      * Optional headers.
      */

package/dist/types/models/app/IDataspaceApp.d.ts

@@ -3,6 +3,8 @@ import type { IJsonLdDocument } from "@twin.org/data-json-ld";
 import type { IDataspaceProtocolDataset } from "@twin.org/standards-dataspace-protocol";
 import type { IActivityQuery } from "./IActivityQuery.js";
 import type { IDataRequest } from "./IDataRequest.js";
+import type { IFollowActivity } from "./IFollowActivity.js";
+import type { IUndoActivity } from "./IUndoActivity.js";
 import type { IDataspaceActivity } from "../IDataspaceActivity.js";
 import type { IProcessingGroupOptions } from "./IProcessingGroupOptions.js";
 /**
@@ -54,4 +56,17 @@ export interface IDataspaceApp extends IComponent {
         data: IJsonLdDocument;
         cursor?: string;
     }>;
+    /**
+     * Subscribe the app to produce data for a follower. Called by the
+     * DS Connector after a push transfer enters STARTED state.
+     * @param followActivity The Follow activity describing the follower + filter.
+     * @returns Promise that resolves when the subscription is set up.
+     */
+    subscribeToData?(followActivity: IFollowActivity): Promise<void>;
+    /**
+     * Undo a previous subscription. Called on transfer complete/terminate.
+     * @param undoActivity The Undo activity referencing the original Follow.
+     * @returns Promise that resolves when the subscription is torn down.
+     */
+    unsubscribeToData?(undoActivity: IUndoActivity): Promise<void>;
 }

package/dist/types/models/app/IFollowActivity.d.ts

@@ -0,0 +1,29 @@
+import type { IJsonLdNodeObject } from "@twin.org/data-json-ld";
+import type { ActivityStreamsTypes, IActivityStreamsActivity } from "@twin.org/standards-w3c-activity-streams";
+/**
+ * ActivityPub Follow activity used by the DS Connector to subscribe
+ * an app to a data source. The app treats this as "start producing
+ * data for this consumer."
+ *
+ * generator = consumerPid (URN) of the follower
+ * actor     = DID of the follower's organization
+ * object    = TransferProcess reference, optionally with a filter expressed as JSON-LD
+ */
+export interface IFollowActivity extends IActivityStreamsActivity {
+    /**
+     * The activity type, always "Follow".
+     */
+    type: typeof ActivityStreamsTypes.Follow;
+    /**
+     * The consumerPid URN identifying the follower's transfer process.
+     */
+    generator: string;
+    /**
+     * The DID of the follower's organization.
+     */
+    actor: string;
+    /**
+     * The TransferProcess reference, optionally with a filter expressed as JSON-LD.
+     */
+    object: string | IJsonLdNodeObject;
+}

package/dist/types/models/app/IUndoActivity.d.ts

@@ -0,0 +1,24 @@
+import type { ActivityStreamsTypes, IActivityStreamsActivity } from "@twin.org/standards-w3c-activity-streams";
+/**
+ * ActivityPub Undo activity used by the DS Connector to unsubscribe
+ * an app from a data source. The object MUST reference the `@id` of
+ * a previously issued Follow activity.
+ */
+export interface IUndoActivity extends IActivityStreamsActivity {
+    /**
+     * The activity type, always "Undo".
+     */
+    type: typeof ActivityStreamsTypes.Undo;
+    /**
+     * The consumerPid URN identifying the transfer process being unsubscribed.
+     */
+    generator: string;
+    /**
+     * The DID of the unsubscribing organization.
+     */
+    actor: string;
+    /**
+     * The `@id` of the Follow activity being undone.
+     */
+    object: string;
+}

package/dist/types/models/controlPlane/ITransferContext.d.ts

@@ -43,9 +43,10 @@ export interface ITransferContext {
      */
     providerIdentity?: string;
     /**
-     * Data address for push mode transfers.
-     * Contains endpoint information where data should be pushed (for Activity Stream push mode).
-     * Only present when format is Http-Push-Activity-Stream-Format or Http-Post-Activity-Stream-Format.
+     * Data address for consumer-initiated push transfers (HttpProxy-PUSH).
+     * Contains the consumer's /inbox endpoint as supplied in the TransferRequestMessage.
+     * Absent for PULL (HttpProxy-PULL) and provider-initiated push (HttpProxy-POST),
+     * where the consumer deliberately omits a dataAddress.
      */
     dataAddress?: IDataspaceProtocolDataAddress;
 }

package/dist/types/models/controlPlane/ITransferProcess.d.ts

@@ -58,15 +58,22 @@ export interface ITransferProcess {
      * URI where messages to the Consumer should be sent.
      */
     callbackAddress?: string;
+    /**
+     * The tenant that owns this transfer process, captured at write time so async
+     * delivery tasks and delayed state transitions can re-enter the right tenant context.
+     * Optional — single-tenant nodes operate without a tenant context.
+     */
+    tenantId?: string;
     /**
      * Data format from the Dataset Distribution.
      * Specified by a Distribution for the Dataset associated with the Agreement.
      */
     format?: string;
     /**
-     * Data address for push mode transfers.
-     * Contains endpoint information where data should be pushed (for Activity Stream push mode).
-     * Only present when format is Http-Push-Activity-Stream-Format or Http-Post-Activity-Stream-Format.
+     * Data address for consumer-initiated push transfers (HttpProxy-PUSH).
+     * Contains the consumer's /inbox endpoint as supplied in the TransferRequestMessage.
+     * Absent for PULL (HttpProxy-PULL) and provider-initiated push (HttpProxy-POST),
+     * where the consumer deliberately omits a dataAddress.
      */
     dataAddress?: IDataspaceProtocolDataAddress;
     /**

package/dist/types/models/dataPlane/IDataspaceDataPlaneComponent.d.ts

@@ -14,9 +14,10 @@ export interface IDataspaceDataPlaneComponent extends IComponent {
     /**
      * Notify an Activity to the Dataspace Data Plane Activity Stream.
      * @param activity The Activity notified.
+     * @param trustPayload Optional trust payload to verify the requester's identity.
      * @returns The activity's 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.
@@ -62,4 +63,42 @@ export interface IDataspaceDataPlaneComponent extends IComponent {
      * @returns The item list and optional cursor for pagination via Link headers.
      */
     queryDataAsset(consumerPid: string, query: IFilteringQuery, cursor?: string, limit?: number, trustPayload?: unknown): Promise<IDataAssetItemListResult>;
+    /**
+     * 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.
+     * @returns Promise that resolves when the subscription is created.
+     */
+    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.
+     * @returns Promise that resolves when the subscription is paused.
+     */
+    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.
+     * @returns Promise that resolves when the subscription is resumed.
+     */
+    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.
+     * @returns Promise that resolves when the subscription is torn down.
+     */
+    teardownPushSubscription(consumerPid: string): Promise<void>;
+    /**
+     * Called by the app when new data is available for a follower.
+     * The activity's `to` attribute contains the consumerPid URN. This method
+     * looks up the matching PushSubscription, validates transfer state, and
+     * schedules a Background Task that POSTs the activity to the consumer.
+     * @param activity The outbound activity carrying the data payload.
+     * @returns Promise that resolves when the delivery task is scheduled.
+     */
+    processOutboxActivity(activity: IActivityStreamsActivity): Promise<void>;
 }

package/dist/types/utils/jsonLdUtils.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Get a JSON-LD id.
+ * @param object The object to get the id from.
+ * @returns The JSON-LD id.
+ */
+export declare function getJsonLdId(object: unknown): string | undefined;
+/**
+ * Get a JSON-LD type.
+ * @param object The object to get the type from.
+ * @returns The JSON-LD type.
+ */
+export declare function getJsonLdType(object: unknown): string | undefined;

package/docs/changelog.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## [0.0.3-next.30](https://github.com/iotaledger/twin-dataspace/compare/dataspace-models-v0.0.3-next.29...dataspace-models-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))
+
+## [0.0.3-next.29](https://github.com/iotaledger/twin-dataspace/compare/dataspace-models-v0.0.3-next.28...dataspace-models-v0.0.3-next.29) (2026-05-20)
+
+
+### Miscellaneous Chores
+
+* **dataspace-models:** Synchronize repo versions
+
 ## [0.0.3-next.28](https://github.com/iotaledger/twin-dataspace/compare/dataspace-models-v0.0.3-next.27...dataspace-models-v0.0.3-next.28) (2026-05-12)
 
 

package/docs/reference/classes/TransferProcess.md

@@ -106,6 +106,17 @@ Callback address for Consumer notifications.
 
 ***
 
+### tenantId? {#tenantid}
+
+> `optional` **tenantId?**: `string`
+
+The tenant that owns this transfer process, captured from the request context
+at write time. Optional — single-tenant nodes (no `TWIN_TENANT_ENABLED`) register
+transfers without a tenant context. Persisted so async push delivery tasks and
+setTimeout-delayed state transitions can re-enter the right tenant context.
+
+***
+
 ### dateCreated {#datecreated}
 
 > **dateCreated**: `string`

package/docs/reference/functions/getJsonLdId.md

@@ -0,0 +1,19 @@
+# Function: getJsonLdId()
+
+> **getJsonLdId**(`object`): `string` \| `undefined`
+
+Get a JSON-LD id.
+
+## Parameters
+
+### object
+
+`unknown`
+
+The object to get the id from.
+
+## Returns
+
+`string` \| `undefined`
+
+The JSON-LD id.

package/docs/reference/functions/getJsonLdType.md

@@ -0,0 +1,19 @@
+# Function: getJsonLdType()
+
+> **getJsonLdType**(`object`): `string` \| `undefined`
+
+Get a JSON-LD type.
+
+## Parameters
+
+### object
+
+`unknown`
+
+The object to get the type from.
+
+## Returns
+
+`string` \| `undefined`
+
+The JSON-LD type.

package/docs/reference/index.md

@@ -19,6 +19,7 @@
 - [IEntitySet](interfaces/IEntitySet.md)
 - [IExecutionPayload](interfaces/IExecutionPayload.md)
 - [IFilteringQuery](interfaces/IFilteringQuery.md)
+- [IPushDeliveryPayload](interfaces/IPushDeliveryPayload.md)
 - [IActivityLogEntryGetRequest](interfaces/IActivityLogEntryGetRequest.md)
 - [IActivityLogEntryGetResponse](interfaces/IActivityLogEntryGetResponse.md)
 - [IActivityLogStatusNotificationPayload](interfaces/IActivityLogStatusNotificationPayload.md)
@@ -52,8 +53,10 @@
 - [IDataAssetEntitiesRequest](interfaces/IDataAssetEntitiesRequest.md)
 - [IDataAssetQuery](interfaces/IDataAssetQuery.md)
 - [IDataspaceApp](interfaces/IDataspaceApp.md)
+- [IFollowActivity](interfaces/IFollowActivity.md)
 - [IProcessingGroupOptions](interfaces/IProcessingGroupOptions.md)
 - [IQueryDataAssetRequest](interfaces/IQueryDataAssetRequest.md)
+- [IUndoActivity](interfaces/IUndoActivity.md)
 - [IDataspaceAppDataset](interfaces/IDataspaceAppDataset.md)
 - [IDataspaceControlPlaneComponent](interfaces/IDataspaceControlPlaneComponent.md)
 - [IDataspaceControlPlaneResolverComponent](interfaces/IDataspaceControlPlaneResolverComponent.md)
@@ -84,3 +87,8 @@
 - [DataspaceContexts](variables/DataspaceContexts.md)
 - [DataspaceTransferFormat](variables/DataspaceTransferFormat.md)
 - [DataspaceTypes](variables/DataspaceTypes.md)
+
+## Functions
+
+- [getJsonLdId](functions/getJsonLdId.md)
+- [getJsonLdType](functions/getJsonLdType.md)

package/docs/reference/interfaces/IActivityStreamNotifyRequest.md

@@ -4,6 +4,18 @@ Activity Stream Notify Request.
 
 ## Properties
 
+### headers? {#headers}
+
+> `optional` **headers?**: `object`
+
+The headers which can be used for authentication (e.g. Bearer token for cross-node push).
+
+#### authorization?
+
+> `optional` **authorization?**: `string`
+
+***
+
 ### body {#body}
 
 > **body**: `IActivityStreamsActivity`

package/docs/reference/interfaces/IActivityStreamNotifyResponse.md

@@ -6,11 +6,11 @@ Activity Stream Notify Response.
 
 ### statusCode {#statuscode}
 
-> **statusCode**: `102` \| `201`
+> **statusCode**: `201` \| `202`
 
 The status code indicating the result of the notification processing. It can be either:
 - `201 Created` if the notification was processed inline and a new activity log entry was created.
-- `102 Processing` if the notification was accepted for processing but has not been completed yet.
+- `202 Accepted` if the notification was accepted for async processing but has not been completed yet.
 
 ***
 

package/docs/reference/interfaces/IDataspaceApp.md

@@ -141,3 +141,48 @@ Maximum number of entries retrieved or to be retrieved.
 `Promise`\<\{ `data`: `IJsonLdDocument`; `cursor?`: `string`; \}\>
 
 Data as JSON-Ld.
+
+***
+
+### subscribeToData()? {#subscribetodata}
+
+> `optional` **subscribeToData**(`followActivity`): `Promise`\<`void`\>
+
+Subscribe the app to produce data for a follower. Called by the
+DS Connector after a push transfer enters STARTED state.
+
+#### Parameters
+
+##### followActivity
+
+[`IFollowActivity`](IFollowActivity.md)
+
+The Follow activity describing the follower + filter.
+
+#### Returns
+
+`Promise`\<`void`\>
+
+Promise that resolves when the subscription is set up.
+
+***
+
+### unsubscribeToData()? {#unsubscribetodata}
+
+> `optional` **unsubscribeToData**(`undoActivity`): `Promise`\<`void`\>
+
+Undo a previous subscription. Called on transfer complete/terminate.
+
+#### Parameters
+
+##### undoActivity
+
+[`IUndoActivity`](IUndoActivity.md)
+
+The Undo activity referencing the original Follow.
+
+#### Returns
+
+`Promise`\<`void`\>
+
+Promise that resolves when the subscription is torn down.

package/docs/reference/interfaces/IDataspaceDataPlaneComponent.md

@@ -11,7 +11,7 @@ Implements the Data Plane functionality for the Eclipse Dataspace Protocol.
 
 ### notifyActivity() {#notifyactivity}
 
-> **notifyActivity**(`activity`): `Promise`\<`string` \| [`IActivityLogEntry`](IActivityLogEntry.md)\>
+> **notifyActivity**(`activity`, `trustPayload?`): `Promise`\<`string` \| [`IActivityLogEntry`](IActivityLogEntry.md)\>
 
 Notify an Activity to the Dataspace Data Plane Activity Stream.
 
@@ -23,6 +23,12 @@ Notify an Activity to the Dataspace Data Plane Activity Stream.
 
 The Activity notified.
 
+##### trustPayload?
+
+`unknown`
+
+Optional trust payload to verify the requester's identity.
+
 #### Returns
 
 `Promise`\<`string` \| [`IActivityLogEntry`](IActivityLogEntry.md)\>
@@ -198,3 +204,121 @@ Trust payload to verify the requesters identity.
 `Promise`\<[`IDataAssetItemListResult`](IDataAssetItemListResult.md)\>
 
 The item list and optional cursor for pagination via Link headers.
+
+***
+
+### 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`\>
+
+Promise that resolves when the subscription is created.
+
+***
+
+### 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`\>
+
+Promise that resolves when the subscription is paused.
+
+***
+
+### 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`\>
+
+Promise that resolves when the subscription is resumed.
+
+***
+
+### 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`\>
+
+Promise that resolves when the subscription is torn down.
+
+***
+
+### processOutboxActivity() {#processoutboxactivity}
+
+> **processOutboxActivity**(`activity`): `Promise`\<`void`\>
+
+Called by the app when new data is available for a follower.
+The activity's `to` attribute contains the consumerPid URN. This method
+looks up the matching PushSubscription, validates transfer state, and
+schedules a Background Task that POSTs the activity to the consumer.
+
+#### Parameters
+
+##### activity
+
+`IActivityStreamsActivity`
+
+The outbound activity carrying the data payload.
+
+#### Returns
+
+`Promise`\<`void`\>
+
+Promise that resolves when the delivery task is scheduled.

package/docs/reference/interfaces/IFollowActivity.md

@@ -0,0 +1,61 @@
+# Interface: IFollowActivity
+
+ActivityPub Follow activity used by the DS Connector to subscribe
+an app to a data source. The app treats this as "start producing
+data for this consumer."
+
+generator = consumerPid (URN) of the follower
+actor     = DID of the follower's organization
+object    = TransferProcess reference, optionally with a filter expressed as JSON-LD
+
+## Extends
+
+- `IActivityStreamsActivity`
+
+## Properties
+
+### type {#type}
+
+> **type**: `"Follow"`
+
+The activity type, always "Follow".
+
+#### Overrides
+
+`IActivityStreamsActivity.type`
+
+***
+
+### generator {#generator}
+
+> **generator**: `string`
+
+The consumerPid URN identifying the follower's transfer process.
+
+#### Overrides
+
+`IActivityStreamsActivity.generator`
+
+***
+
+### actor {#actor}
+
+> **actor**: `string`
+
+The DID of the follower's organization.
+
+#### Overrides
+
+`IActivityStreamsActivity.actor`
+
+***
+
+### object {#object}
+
+> **object**: `string` \| `IJsonLdNodeObject`
+
+The TransferProcess reference, optionally with a filter expressed as JSON-LD.
+
+#### Overrides
+
+`IActivityStreamsActivity.object`

package/docs/reference/interfaces/IPushDeliveryPayload.md

@@ -0,0 +1,125 @@
+# Interface: IPushDeliveryPayload
+
+Payload handed to pushDeliveryRunner via a Background Task.
+Contains everything the runner needs to POST one Activity Streams
+object to a consumer's /inbox without touching entity storage.
+
+## Properties
+
+### consumerPid {#consumerpid}
+
+> **consumerPid**: `string`
+
+The consumer process ID identifying the transfer.
+
+***
+
+### providerPid {#providerpid}
+
+> **providerPid**: `string`
+
+The provider process ID identifying the transfer.
+
+***
+
+### generatorPid {#generatorpid}
+
+> **generatorPid**: `string`
+
+PID to set as Activity.generator. Always equals providerPid since
+processOutboxActivity is only invoked for consumer-initiated push,
+where the provider is the data sender.
+
+***
+
+### consumerEndpoint {#consumerendpoint}
+
+> **consumerEndpoint**: `string`
+
+The consumer's inbox endpoint URL to POST the activity to.
+
+***
+
+### consumerAuthToken? {#consumerauthtoken}
+
+> `optional` **consumerAuthToken?**: `string`
+
+Optional Bearer token for authenticating the push request.
+
+***
+
+### agreement {#agreement}
+
+> **agreement**: `IDataspaceProtocolAgreement`
+
+The ODRL agreement governing the data transfer.
+
+***
+
+### data {#data}
+
+> **data**: `IJsonLdNodeObject`
+
+The JSON-LD data payload to deliver to the consumer.
+
+***
+
+### entityType {#entitytype}
+
+> **entityType**: `string`
+
+The JSON-LD
+
+***
+
+### tenantId? {#tenantid}
+
+> `optional` **tenantId?**: `string`
+
+The tenant that owns this push delivery, captured at schedule time from the active
+`ContextIdStore` context (typically from the subscription's `tenantId` field).
+The runner re-establishes this tenant context via `ContextIdStore.run` before invoking
+tenant-scoped operations (PEP, trust signing, vault lookups). Optional — single-tenant
+nodes operate without a tenant context.
+
+***
+
+### pushTimeoutMs? {#pushtimeoutms}
+
+> `optional` **pushTimeoutMs?**: `number`
+
+Timeout (ms) for the push delivery HTTP POST. Packaged at schedule time from service config.
+
+#### Default
+
+```ts
+30000
+```
+
+***
+
+### pushRetryCount? {#pushretrycount}
+
+> `optional` **pushRetryCount?**: `number`
+
+Max HTTP retry attempts for this delivery. Packaged at schedule time from service config.
+
+#### Default
+
+```ts
+3
+```
+
+***
+
+### pushRetryBaseDelayMs? {#pushretrybasedelayms}
+
+> `optional` **pushRetryBaseDelayMs?**: `number`
+
+Base retry delay (ms) for this delivery. Packaged at schedule time from service config.
+
+#### Default
+
+```ts
+1000
+```

package/docs/reference/interfaces/ITransferContext.md

@@ -79,6 +79,7 @@ Extracted from Agreement's assigner field.
 
 > `optional` **dataAddress?**: `IDataspaceProtocolDataAddress`
 
-Data address for push mode transfers.
-Contains endpoint information where data should be pushed (for Activity Stream push mode).
-Only present when format is Http-Push-Activity-Stream-Format or Http-Post-Activity-Stream-Format.
+Data address for consumer-initiated push transfers (HttpProxy-PUSH).
+Contains the consumer's /inbox endpoint as supplied in the TransferRequestMessage.
+Absent for PULL (HttpProxy-PULL) and provider-initiated push (HttpProxy-POST),
+where the consumer deliberately omits a dataAddress.

package/docs/reference/interfaces/ITransferProcess.md

@@ -103,6 +103,16 @@ URI where messages to the Consumer should be sent.
 
 ***
 
+### tenantId? {#tenantid}
+
+> `optional` **tenantId?**: `string`
+
+The tenant that owns this transfer process, captured at write time so async
+delivery tasks and delayed state transitions can re-enter the right tenant context.
+Optional — single-tenant nodes operate without a tenant context.
+
+***
+
 ### format? {#format}
 
 > `optional` **format?**: `string`
@@ -116,9 +126,10 @@ Specified by a Distribution for the Dataset associated with the Agreement.
 
 > `optional` **dataAddress?**: `IDataspaceProtocolDataAddress`
 
-Data address for push mode transfers.
-Contains endpoint information where data should be pushed (for Activity Stream push mode).
-Only present when format is Http-Push-Activity-Stream-Format or Http-Post-Activity-Stream-Format.
+Data address for consumer-initiated push transfers (HttpProxy-PUSH).
+Contains the consumer's /inbox endpoint as supplied in the TransferRequestMessage.
+Absent for PULL (HttpProxy-PULL) and provider-initiated push (HttpProxy-POST),
+where the consumer deliberately omits a dataAddress.
 
 ***
 

package/docs/reference/interfaces/IUndoActivity.md

@@ -0,0 +1,57 @@
+# Interface: IUndoActivity
+
+ActivityPub Undo activity used by the DS Connector to unsubscribe
+an app from a data source. The object MUST reference the `@id` of
+a previously issued Follow activity.
+
+## Extends
+
+- `IActivityStreamsActivity`
+
+## Properties
+
+### type {#type}
+
+> **type**: `"Undo"`
+
+The activity type, always "Undo".
+
+#### Overrides
+
+`IActivityStreamsActivity.type`
+
+***
+
+### generator {#generator}
+
+> **generator**: `string`
+
+The consumerPid URN identifying the transfer process being unsubscribed.
+
+#### Overrides
+
+`IActivityStreamsActivity.generator`
+
+***
+
+### actor {#actor}
+
+> **actor**: `string`
+
+The DID of the unsubscribing organization.
+
+#### Overrides
+
+`IActivityStreamsActivity.actor`
+
+***
+
+### object {#object}
+
+> **object**: `string`
+
+The `@id` of the Follow activity being undone.
+
+#### Overrides
+
+`IActivityStreamsActivity.object`

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@twin.org/dataspace-models",
-	"version": "0.0.3-next.28",
+	"version": "0.0.3-next.30",
 	"description": "Defines shared entities, interfaces, and data types used by control plane and data plane components.",
 	"repository": {
 		"type": "git",