@twin.org/dataspace-models 0.9.2-next.1 → 0.9.2-next.11

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

@@ -1 +1 @@
-{"version":3,"file":"dataspaceControlPlaneMetrics.js","sourceRoot":"","sources":["../../../../src/models/controlPlane/dataspaceControlPlaneMetrics.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,uCAAuC;AACvC,OAAO,EAAyB,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAC/E,OAAO,EAAE,8BAA8B,EAAE,MAAM,qCAAqC,CAAC;AAErF;;GAEG;AACH,gEAAgE;AAChE,MAAM,CAAC,MAAM,4BAA4B,GAAuB;IAC/D;QACC,EAAE,EAAE,8BAA8B,CAAC,kBAAkB;QACrD,KAAK,EAAE,qBAAqB;QAC5B,IAAI,EAAE,UAAU,CAAC,OAAO;KACxB;IACD;QACC,EAAE,EAAE,8BAA8B,CAAC,iBAAiB;QACpD,KAAK,EAAE,oBAAoB;QAC3B,IAAI,EAAE,UAAU,CAAC,OAAO;KACxB;IACD;QACC,EAAE,EAAE,8BAA8B,CAAC,gBAAgB;QACnD,KAAK,EAAE,mBAAmB;QAC1B,IAAI,EAAE,UAAU,CAAC,OAAO;KACxB;IACD;QACC,EAAE,EAAE,8BAA8B,CAAC,kBAAkB;QACrD,KAAK,EAAE,qBAAqB;QAC5B,IAAI,EAAE,UAAU,CAAC,OAAO;KACxB;IACD;QACC,EAAE,EAAE,8BAA8B,CAAC,kBAAkB;QACrD,KAAK,EAAE,qBAAqB;QAC5B,IAAI,EAAE,UAAU,CAAC,OAAO;KACxB;IACD;QACC,EAAE,EAAE,8BAA8B,CAAC,mBAAmB;QACtD,KAAK,EAAE,sBAAsB;QAC7B,IAAI,EAAE,UAAU,CAAC,OAAO;KACxB;IACD;QACC,EAAE,EAAE,8BAA8B,CAAC,qBAAqB;QACxD,KAAK,EAAE,wBAAwB;QAC/B,IAAI,EAAE,UAAU,CAAC,OAAO;KACxB;IACD;QACC,EAAE,EAAE,8BAA8B,CAAC,kBAAkB;QACrD,KAAK,EAAE,sBAAsB;QAC7B,IAAI,EAAE,UAAU,CAAC,OAAO;KACxB;IACD;QACC,EAAE,EAAE,8BAA8B,CAAC,kBAAkB;QACrD,KAAK,EAAE,sBAAsB;QAC7B,IAAI,EAAE,UAAU,CAAC,OAAO;KACxB;IACD;QACC,EAAE,EAAE,8BAA8B,CAAC,kBAAkB;QACrD,KAAK,EAAE,sBAAsB;QAC7B,IAAI,EAAE,UAAU,CAAC,OAAO;KACxB;CACD,CAAC","sourcesContent":["// Copyright 2025 IOTA Stiftung.\n// SPDX-License-Identifier: Apache-2.0.\nimport { type ITelemetryMetric, MetricType } from \"@twin.org/telemetry-models\";\nimport { DataspaceControlPlaneMetricIds } from \"./dataspaceControlPlaneMetricIds.js\";\n\n/**\n * Metrics registered by the dataspace control plane service.\n */\n// eslint-disable-next-line @typescript-eslint/naming-convention\nexport const DataspaceControlPlaneMetrics: ITelemetryMetric[] = [\n\t{\n\t\tid: DataspaceControlPlaneMetricIds.TransfersRequested,\n\t\tlabel: \"Transfers requested\",\n\t\ttype: MetricType.Counter\n\t},\n\t{\n\t\tid: DataspaceControlPlaneMetricIds.TransfersPrepared,\n\t\tlabel: \"Transfers prepared\",\n\t\ttype: MetricType.Counter\n\t},\n\t{\n\t\tid: DataspaceControlPlaneMetricIds.TransfersStarted,\n\t\tlabel: \"Transfers started\",\n\t\ttype: MetricType.Counter\n\t},\n\t{\n\t\tid: DataspaceControlPlaneMetricIds.TransfersCompleted,\n\t\tlabel: \"Transfers completed\",\n\t\ttype: MetricType.Counter\n\t},\n\t{\n\t\tid: DataspaceControlPlaneMetricIds.TransfersSuspended,\n\t\tlabel: \"Transfers suspended\",\n\t\ttype: MetricType.Counter\n\t},\n\t{\n\t\tid: DataspaceControlPlaneMetricIds.TransfersTerminated,\n\t\tlabel: \"Transfers terminated\",\n\t\ttype: MetricType.Counter\n\t},\n\t{\n\t\tid: DataspaceControlPlaneMetricIds.NegotiationsInitiated,\n\t\tlabel: \"Negotiations initiated\",\n\t\ttype: MetricType.Counter\n\t},\n\t{\n\t\tid: DataspaceControlPlaneMetricIds.AppDatasetsCreated,\n\t\tlabel: \"App datasets created\",\n\t\ttype: MetricType.Counter\n\t},\n\t{\n\t\tid: DataspaceControlPlaneMetricIds.AppDatasetsUpdated,\n\t\tlabel: \"App datasets updated\",\n\t\ttype: MetricType.Counter\n\t},\n\t{\n\t\tid: DataspaceControlPlaneMetricIds.AppDatasetsDeleted,\n\t\tlabel: \"App datasets deleted\",\n\t\ttype: MetricType.Counter\n\t}\n];\n"]}
+{"version":3,"file":"dataspaceControlPlaneMetrics.js","sourceRoot":"","sources":["../../../../src/models/controlPlane/dataspaceControlPlaneMetrics.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,uCAAuC;AACvC,OAAO,EAAyB,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAC/E,OAAO,EAAE,8BAA8B,EAAE,MAAM,qCAAqC,CAAC;AAErF;;GAEG;AACH,gEAAgE;AAChE,MAAM,CAAC,MAAM,4BAA4B,GAAuB;IAC/D;QACC,EAAE,EAAE,8BAA8B,CAAC,kBAAkB;QACrD,KAAK,EAAE,qBAAqB;QAC5B,IAAI,EAAE,UAAU,CAAC,OAAO;KACxB;IACD;QACC,EAAE,EAAE,8BAA8B,CAAC,iBAAiB;QACpD,KAAK,EAAE,oBAAoB;QAC3B,IAAI,EAAE,UAAU,CAAC,OAAO;KACxB;IACD;QACC,EAAE,EAAE,8BAA8B,CAAC,gBAAgB;QACnD,KAAK,EAAE,mBAAmB;QAC1B,IAAI,EAAE,UAAU,CAAC,OAAO;KACxB;IACD;QACC,EAAE,EAAE,8BAA8B,CAAC,kBAAkB;QACrD,KAAK,EAAE,qBAAqB;QAC5B,IAAI,EAAE,UAAU,CAAC,OAAO;KACxB;IACD;QACC,EAAE,EAAE,8BAA8B,CAAC,kBAAkB;QACrD,KAAK,EAAE,qBAAqB;QAC5B,IAAI,EAAE,UAAU,CAAC,OAAO;KACxB;IACD;QACC,EAAE,EAAE,8BAA8B,CAAC,mBAAmB;QACtD,KAAK,EAAE,sBAAsB;QAC7B,IAAI,EAAE,UAAU,CAAC,OAAO;KACxB;IACD;QACC,EAAE,EAAE,8BAA8B,CAAC,qBAAqB;QACxD,KAAK,EAAE,wBAAwB;QAC/B,IAAI,EAAE,UAAU,CAAC,OAAO;KACxB;IACD;QACC,EAAE,EAAE,8BAA8B,CAAC,kBAAkB;QACrD,KAAK,EAAE,sBAAsB;QAC7B,IAAI,EAAE,UAAU,CAAC,OAAO;KACxB;IACD;QACC,EAAE,EAAE,8BAA8B,CAAC,kBAAkB;QACrD,KAAK,EAAE,sBAAsB;QAC7B,IAAI,EAAE,UAAU,CAAC,OAAO;KACxB;IACD;QACC,EAAE,EAAE,8BAA8B,CAAC,kBAAkB;QACrD,KAAK,EAAE,sBAAsB;QAC7B,IAAI,EAAE,UAAU,CAAC,OAAO;KACxB;IACD;QACC,EAAE,EAAE,8BAA8B,CAAC,eAAe;QAClD,KAAK,EAAE,iCAAiC;QACxC,IAAI,EAAE,UAAU,CAAC,OAAO;KACxB;CACD,CAAC","sourcesContent":["// Copyright 2025 IOTA Stiftung.\n// SPDX-License-Identifier: Apache-2.0.\nimport { type ITelemetryMetric, MetricType } from \"@twin.org/telemetry-models\";\nimport { DataspaceControlPlaneMetricIds } from \"./dataspaceControlPlaneMetricIds.js\";\n\n/**\n * Metrics registered by the dataspace control plane service.\n */\n// eslint-disable-next-line @typescript-eslint/naming-convention\nexport const DataspaceControlPlaneMetrics: ITelemetryMetric[] = [\n\t{\n\t\tid: DataspaceControlPlaneMetricIds.TransfersRequested,\n\t\tlabel: \"Transfers requested\",\n\t\ttype: MetricType.Counter\n\t},\n\t{\n\t\tid: DataspaceControlPlaneMetricIds.TransfersPrepared,\n\t\tlabel: \"Transfers prepared\",\n\t\ttype: MetricType.Counter\n\t},\n\t{\n\t\tid: DataspaceControlPlaneMetricIds.TransfersStarted,\n\t\tlabel: \"Transfers started\",\n\t\ttype: MetricType.Counter\n\t},\n\t{\n\t\tid: DataspaceControlPlaneMetricIds.TransfersCompleted,\n\t\tlabel: \"Transfers completed\",\n\t\ttype: MetricType.Counter\n\t},\n\t{\n\t\tid: DataspaceControlPlaneMetricIds.TransfersSuspended,\n\t\tlabel: \"Transfers suspended\",\n\t\ttype: MetricType.Counter\n\t},\n\t{\n\t\tid: DataspaceControlPlaneMetricIds.TransfersTerminated,\n\t\tlabel: \"Transfers terminated\",\n\t\ttype: MetricType.Counter\n\t},\n\t{\n\t\tid: DataspaceControlPlaneMetricIds.NegotiationsInitiated,\n\t\tlabel: \"Negotiations initiated\",\n\t\ttype: MetricType.Counter\n\t},\n\t{\n\t\tid: DataspaceControlPlaneMetricIds.AppDatasetsCreated,\n\t\tlabel: \"App datasets created\",\n\t\ttype: MetricType.Counter\n\t},\n\t{\n\t\tid: DataspaceControlPlaneMetricIds.AppDatasetsUpdated,\n\t\tlabel: \"App datasets updated\",\n\t\ttype: MetricType.Counter\n\t},\n\t{\n\t\tid: DataspaceControlPlaneMetricIds.AppDatasetsDeleted,\n\t\tlabel: \"App datasets deleted\",\n\t\ttype: MetricType.Counter\n\t},\n\t{\n\t\tid: DataspaceControlPlaneMetricIds.AgreementsSwept,\n\t\tlabel: \"Agreements removed by the sweep\",\n\t\ttype: MetricType.Counter\n\t}\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 * @param trustPayload Trust payload to verify the requesters 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 from the activity log.\n\t * @param subscriptionId The subscription Id to remove.\n\t * @returns A promise that resolves when the subscription has been removed.\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 * @param trustPayload Trust payload to verify the requester's identity.\n\t * @returns the Activity Log Entry with the processing details.\n\t * @throws NotFoundError if activity log entry is not known.\n\t * @throws UnauthorizedError if trustPayload is absent or the verified identity is not the entry generator.\n\t */\n\tgetActivityLogEntry(logEntryId: string, trustPayload?: unknown): 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"]}
+{"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 Trust payload to verify the requesters 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 from the activity log.\n\t * @param subscriptionId The subscription Id to remove.\n\t * @returns A promise that resolves when the subscription has been removed.\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 * @param trustPayload Trust payload to verify the requester's identity.\n\t * @returns the Activity Log Entry with the processing details.\n\t * @throws NotFoundError if activity log entry is not known.\n\t * @throws UnauthorizedError if trustPayload is absent or the verified identity is not authorised for the entry.\n\t */\n\tgetActivityLogEntry(logEntryId: string, trustPayload?: unknown): 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/types/entities/dataspaceAppDataset.d.ts

@@ -12,7 +12,7 @@ export declare class DataspaceAppDataset {
     organizationIdentity: string;
     /**
      * The tenant that owns this dataset, captured from the request context at
-     * write time. Optional — single-tenant nodes (no `TWIN_TENANT_ENABLED`)
+     * write time. Optional - single-tenant nodes (no `TWIN_TENANT_ENABLED`)
      * register datasets without a tenant context.
      */
     tenantId?: string;

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

@@ -12,7 +12,7 @@ export declare class DataspaceAppDatasetV0 {
     organizationIdentity: string;
     /**
      * The tenant that owns this dataset, captured from the request context at
-     * write time. Optional — single-tenant nodes (no `TWIN_TENANT_ENABLED`)
+     * write time. Optional - single-tenant nodes (no `TWIN_TENANT_ENABLED`)
      * register datasets without a tenant context.
      */
     tenantId?: string;

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

@@ -1,4 +1,3 @@
-import type { IRightsManagementPolicy } from "@twin.org/rights-management-models";
 import type { DataspaceProtocolTransferProcessStateType, IDataspaceProtocolDataAddress } from "@twin.org/standards-dataspace-protocol";
 import type { TransferProcessRole } from "../models/controlPlane/transferProcessRole.js";
 /**
@@ -7,14 +6,15 @@ import type { TransferProcessRole } from "../models/controlPlane/transferProcess
  */
 export declare class TransferProcess {
     /**
-     * The consumer PID is the primary key.
-     * Used for direct lookup by consumerPid.
+     * Internal id, the primary key. Both role records of a self transfer share consumerPid and
+     * providerPid, so only the internal id is collision-free within one partition.
      */
-    consumerPid: string;
+    id: string;
     /**
-     * Internal UUID for storage (secondary key for providerPid lookup).
+     * Consumer Process ID from the DSP protocol.
+     * Indexed for lookup by consumerPid.
      */
-    id: string;
+    consumerPid: string;
     /**
      * Provider Process ID from the DSP protocol.
      * Indexed for lookup by providerPid.
@@ -47,8 +47,8 @@ export declare class TransferProcess {
     providerIdentity?: string;
     /**
      * This node's role in the transfer, captured at write time so state transitions and async delivery
-     * can tell which party we are without inferring it from the matched PID (consumerPid is the primary
-     * key on both nodes). Optional for back-compat with records written before this field existed.
+     * can tell which party we are without inferring it from the matched PID (a self transfer stores two
+     * records sharing both pids). Optional for back-compat with records written before this field existed.
      */
     localRole?: TransferProcessRole;
     /**
@@ -71,10 +71,6 @@ export declare class TransferProcess {
      * Last update timestamp (ISO string format).
      */
     dateModified: string;
-    /**
-     * Policies from the Agreement (stored as JSON).
-     */
-    policies?: IRightsManagementPolicy[];
     /**
      * Data address for the transfer (stored as JSON): the consumer's inbox for PUSH, or the
      * provider-built address persisted at start for PULL/POST; may expire while STARTED.

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

@@ -0,0 +1,83 @@
+import type { IRightsManagementPolicy } from "@twin.org/rights-management-models";
+import type { DataspaceProtocolTransferProcessStateType, IDataspaceProtocolDataAddress } from "@twin.org/standards-dataspace-protocol";
+import type { TransferProcessRole } from "../models/controlPlane/transferProcessRole.js";
+/**
+ * Transfer Process for shared storage between Control Plane and Data Plane, version 0.
+ * Keyed on consumerPid; superseded by the version keyed on the internal id.
+ */
+export declare class TransferProcessV0 {
+    /**
+     * The consumer PID is the primary key.
+     * Used for direct lookup by consumerPid.
+     */
+    consumerPid: string;
+    /**
+     * Internal UUID for storage (secondary key for providerPid lookup).
+     */
+    id: string;
+    /**
+     * Provider Process ID from the DSP protocol.
+     * Indexed for lookup by providerPid.
+     */
+    providerPid: string;
+    /**
+     * Agreement ID linking to the rights-management Agreement.
+     */
+    agreementId: string;
+    /**
+     * Transfer Process state from the DSP protocol.
+     * One of: REQUESTED, STARTED, COMPLETED, SUSPENDED, TERMINATED.
+     */
+    state: DataspaceProtocolTransferProcessStateType;
+    /**
+     * Dataset ID for DSC resolution.
+     */
+    datasetId: string;
+    /**
+     * Offer ID from the original Catalog offer.
+     */
+    offerId: string;
+    /**
+     * Consumer identity (DID or URI).
+     */
+    consumerIdentity?: string;
+    /**
+     * Provider identity (DID or URI).
+     */
+    providerIdentity?: string;
+    /**
+     * This node's role in the transfer, captured at write time so state transitions and async delivery
+     * can tell which party we are without inferring it from the matched PID (consumerPid is the primary
+     * key on both nodes). Optional for back-compat with records written before this field existed.
+     */
+    localRole?: TransferProcessRole;
+    /**
+     * Data format from the Dataset Distribution.
+     */
+    format?: string;
+    /**
+     * Callback address for Consumer notifications.
+     */
+    callbackAddress?: string;
+    /**
+     * The organization that owns this transfer process, captured from the request context at write time.
+     */
+    organizationIdentity: string;
+    /**
+     * Creation timestamp (ISO string format).
+     */
+    dateCreated: string;
+    /**
+     * Last update timestamp (ISO string format).
+     */
+    dateModified: string;
+    /**
+     * Policies from the Agreement (stored as JSON).
+     */
+    policies?: IRightsManagementPolicy[];
+    /**
+     * Data address for the transfer (stored as JSON): the consumer's inbox for PUSH, or the
+     * provider-built address persisted at start for PULL/POST; may expire while STARTED.
+     */
+    dataAddress?: IDataspaceProtocolDataAddress;
+}

package/dist/types/index.d.ts

@@ -1,6 +1,7 @@
 export * from "./entities/dataspaceAppDataset.js";
 export * from "./entities/dataspaceAppDatasetV0.js";
 export * from "./entities/transferProcess.js";
+export * from "./entities/transferProcessV0.js";
 export * from "./entities/transferRetrieval.js";
 export * from "./models/controlPlane/api/ITransferContextResponse.js";
 export * from "./models/controlPlane/dataspaceControlPlaneMetricIds.js";

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

@@ -44,7 +44,7 @@ export interface IPushDeliveryPayload {
      * 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
+     * tenant-scoped operations (PEP, trust signing, vault lookups). Optional - single-tenant
      * nodes operate without a tenant context.
      */
     tenantId?: string;

package/dist/types/models/api/controlPlane/IAppDatasetCreateRequest.d.ts

@@ -3,7 +3,7 @@ import type { IDataspaceProtocolDataset } from "@twin.org/standards-dataspace-pr
  * API request to register an app dataset.
  *
  * The owning `tenantId` is captured automatically from the request's tenant
- * context — callers do not supply it.
+ * context - callers do not supply it.
  */
 export interface IAppDatasetCreateRequest {
     /**
@@ -24,7 +24,7 @@ export interface IAppDatasetCreateRequest {
         appId: string;
         /**
          * The dataset payload. System-stamped fields like `dcterms:publisher`
-         * may be omitted — the Control Plane fills them in at publish time.
+         * may be omitted - the Control Plane fills them in at publish time.
          */
         dataset: IDataspaceProtocolDataset;
         /**

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

@@ -41,7 +41,7 @@ export interface IDataspaceControlPlaneComponent extends IComponent {
      * notified via the registered INegotiationCallback when the negotiation completes.
      * The negotiation follows DSP state machine: REQUESTED → OFFERED → AGREED → VERIFIED → FINALIZED.
      *
-     * The REST client does not support this method and throws a not supported error —
+     * The REST client does not support this method and throws a not supported error -
      * use ComponentFactory.get() for the in-process service.
      *
      * DSP Spec: https://eclipse-dataspace-protocol-base.github.io/DataspaceProtocol/2025-1/#negotiation-protocol
@@ -99,7 +99,7 @@ export interface IDataspaceControlPlaneComponent extends IComponent {
      * consumer-initiated transfer changes state (STARTED, COMPLETED, SUSPENDED,
      * TERMINATED).
      *
-     * The REST client does not support this method and throws a not supported error —
+     * The REST client does not support this method and throws a not supported error -
      * use ComponentFactory.get() for the in-process service.
      * @param key A unique key identifying this callback registration.
      * @param callback The callback interface to register.
@@ -124,7 +124,7 @@ export interface IDataspaceControlPlaneComponent extends IComponent {
      * via the registered ITransferCallback. The transfer moves to STARTED when the
      * provider POSTs a TransferStartMessage back to this node's callback address.
      *
-     * The REST client does not support this method and throws a not supported error —
+     * The REST client does not support this method and throws a not supported error -
      * use ComponentFactory.get() for the in-process service.
      *
      * @param agreementId The finalized agreement ID (from contract negotiation).

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

@@ -21,11 +21,13 @@ export interface INegotiationCallback {
     }): Promise<void>;
     /**
      * Called when the negotiation finalizes.
-     * @param negotiationId The negotiation ID, or undefined for implicit-trust agreements.
+     * @param negotiationId The negotiation ID, or undefined for implicit-trust or agreement-reuse paths.
      * @param agreementId The agreement ID (from agreement.uid).
+     * @param offerId The offer ID that triggered the negotiation; present when negotiationId is undefined so
+     * callers with concurrent negotiations can discriminate which finalization belongs to them.
      * @returns Nothing.
      */
-    onFinalized(negotiationId: string | undefined, agreementId: string): Promise<void>;
+    onFinalized(negotiationId: string | undefined, agreementId: string, offerId?: string): Promise<void>;
     /**
      * Called when the negotiation fails (terminated or stalled).
      * @param negotiationId The negotiation ID.

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

@@ -1,4 +1,3 @@
-import type { IRightsManagementPolicy } from "@twin.org/rights-management-models";
 import type { DataspaceProtocolTransferProcessStateType, IDataspaceProtocolDataAddress } from "@twin.org/standards-dataspace-protocol";
 import type { TransferProcessRole } from "./transferProcessRole.js";
 /**
@@ -28,7 +27,6 @@ export interface ITransferProcess {
     state: DataspaceProtocolTransferProcessStateType;
     /**
      * Agreement ID linking to the rights-management Agreement.
-     * Used to resolve policies and permissions.
      */
     agreementId: string;
     /**
@@ -40,11 +38,6 @@ export interface ITransferProcess {
      * Offer ID from the original Catalog offer.
      */
     offerId: string;
-    /**
-     * Policies from the Agreement.
-     * Used by DSC for runtime policy enforcement.
-     */
-    policies?: IRightsManagementPolicy[];
     /**
      * Consumer identity (DID or URI).
      * Used for auditing and access control.

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

@@ -42,6 +42,10 @@ export declare const DataspaceControlPlaneMetricIds: {
      * Number of app datasets deleted.
      */
     readonly AppDatasetsDeleted: "dcp_app_datasets_deleted";
+    /**
+     * Number of agreements removed by the agreement sweep.
+     */
+    readonly AgreementsSwept: "dcp_agreements_swept";
 };
 /**
  * Metric IDs for the dataspace control plane service.

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

@@ -37,7 +37,7 @@ export interface IDataspaceDataPlaneComponent extends IComponent {
      * @param trustPayload Trust payload to verify the requester's identity.
      * @returns the Activity Log Entry with the processing details.
      * @throws NotFoundError if activity log entry is not known.
-     * @throws UnauthorizedError if trustPayload is absent or the verified identity is not the entry generator.
+     * @throws UnauthorizedError if trustPayload is absent or the verified identity is not authorised for the entry.
      */
     getActivityLogEntry(logEntryId: string, trustPayload?: unknown): Promise<IActivityLogEntry>;
     /**

package/docs/changelog.md

@@ -1,5 +1,75 @@
 # Changelog
 
+## [0.9.2-next.11](https://github.com/iotaledger/twin-dataspace/compare/dataspace-models-v0.9.2-next.10...dataspace-models-v0.9.2-next.11) (2026-08-23)
+
+
+### Features
+
+* add correlation callbacks ([#354](https://github.com/iotaledger/twin-dataspace/issues/354)) ([d362fb6](https://github.com/iotaledger/twin-dataspace/commit/d362fb6b0816a62f72a77478d78fb3959a437b3c))
+
+## [0.9.2-next.10](https://github.com/iotaledger/twin-dataspace/compare/dataspace-models-v0.9.2-next.9...dataspace-models-v0.9.2-next.10) (2026-08-16)
+
+
+### Features
+
+* add unused agreement sweep to the control plane ([#344](https://github.com/iotaledger/twin-dataspace/issues/344)) ([8633642](https://github.com/iotaledger/twin-dataspace/commit/86336424ced7aeab3259c78373447074f4140e90))
+
+## [0.9.2-next.9](https://github.com/iotaledger/twin-dataspace/compare/dataspace-models-v0.9.2-next.8...dataspace-models-v0.9.2-next.9) (2026-08-13)
+
+
+### Bug Fixes
+
+* get activity log auth ([#343](https://github.com/iotaledger/twin-dataspace/issues/343)) ([9514679](https://github.com/iotaledger/twin-dataspace/commit/95146790ccf7b54fd5dce923af64fdaa607ca555))
+
+## [0.9.2-next.8](https://github.com/iotaledger/twin-dataspace/compare/dataspace-models-v0.9.2-next.7...dataspace-models-v0.9.2-next.8) (2026-08-11)
+
+
+### Features
+
+* transfer process remove inline agreement ([#340](https://github.com/iotaledger/twin-dataspace/issues/340)) ([332eaf6](https://github.com/iotaledger/twin-dataspace/commit/332eaf67e5cf0b13545d013d107658b232ae32ff))
+
+## [0.9.2-next.7](https://github.com/iotaledger/twin-dataspace/compare/dataspace-models-v0.9.2-next.6...dataspace-models-v0.9.2-next.7) (2026-08-10)
+
+
+### Miscellaneous Chores
+
+* **dataspace-models:** Synchronize repo versions
+
+## [0.9.2-next.6](https://github.com/iotaledger/twin-dataspace/compare/dataspace-models-v0.9.2-next.5...dataspace-models-v0.9.2-next.6) (2026-08-10)
+
+
+### Miscellaneous Chores
+
+* **dataspace-models:** Synchronize repo versions
+
+## [0.9.2-next.5](https://github.com/iotaledger/twin-dataspace/compare/dataspace-models-v0.9.2-next.4...dataspace-models-v0.9.2-next.5) (2026-08-07)
+
+
+### Features
+
+* linting and dependency update ([adf8ee0](https://github.com/iotaledger/twin-dataspace/commit/adf8ee04f657f22fb051978591749a4cf19d67a1))
+
+## [0.9.2-next.4](https://github.com/iotaledger/twin-dataspace/compare/dataspace-models-v0.9.2-next.3...dataspace-models-v0.9.2-next.4) (2026-08-03)
+
+
+### Miscellaneous Chores
+
+* **dataspace-models:** Synchronize repo versions
+
+## [0.9.2-next.3](https://github.com/iotaledger/twin-dataspace/compare/dataspace-models-v0.9.2-next.2...dataspace-models-v0.9.2-next.3) (2026-07-31)
+
+
+### Bug Fixes
+
+* keep one TransferProcess record per role in self transfers ([#321](https://github.com/iotaledger/twin-dataspace/issues/321)) ([91ccc87](https://github.com/iotaledger/twin-dataspace/commit/91ccc87e47d94c6a015e3f974f0dd4cf680c4603))
+
+## [0.9.2-next.2](https://github.com/iotaledger/twin-dataspace/compare/dataspace-models-v0.9.2-next.1...dataspace-models-v0.9.2-next.2) (2026-07-30)
+
+
+### Miscellaneous Chores
+
+* **dataspace-models:** Synchronize repo versions
+
 ## [0.9.2-next.1](https://github.com/iotaledger/twin-dataspace/compare/dataspace-models-v0.9.2-next.0...dataspace-models-v0.9.2-next.1) (2026-07-28)
 
 

package/docs/reference/classes/DataspaceAppDataset.md

@@ -35,7 +35,7 @@ The identity of the organization that owns this entity.
 > `optional` **tenantId?**: `string`
 
 The tenant that owns this dataset, captured from the request context at
-write time. Optional — single-tenant nodes (no `TWIN_TENANT_ENABLED`)
+write time. Optional - single-tenant nodes (no `TWIN_TENANT_ENABLED`)
 register datasets without a tenant context.
 
 ***

package/docs/reference/classes/DataspaceAppDatasetV0.md

@@ -35,7 +35,7 @@ The identity of the organization that owns this entity.
 > `optional` **tenantId?**: `string`
 
 The tenant that owns this dataset, captured from the request context at
-write time. Optional — single-tenant nodes (no `TWIN_TENANT_ENABLED`)
+write time. Optional - single-tenant nodes (no `TWIN_TENANT_ENABLED`)
 register datasets without a tenant context.
 
 ***

package/docs/reference/classes/TransferProcess.md

@@ -15,20 +15,21 @@ This entity is the persistent representation of ITransferProcess.
 
 ## Properties
 
-### consumerPid {#consumerpid}
+### id {#id}
 
-> **consumerPid**: `string`
+> **id**: `string`
 
-The consumer PID is the primary key.
-Used for direct lookup by consumerPid.
+Internal id, the primary key. Both role records of a self transfer share consumerPid and
+providerPid, so only the internal id is collision-free within one partition.
 
 ***
 
-### id {#id}
+### consumerPid {#consumerpid}
 
-> **id**: `string`
+> **consumerPid**: `string`
 
-Internal UUID for storage (secondary key for providerPid lookup).
+Consumer Process ID from the DSP protocol.
+Indexed for lookup by consumerPid.
 
 ***
 
@@ -95,8 +96,8 @@ Provider identity (DID or URI).
 > `optional` **localRole?**: [`TransferProcessRole`](../type-aliases/TransferProcessRole.md)
 
 This node's role in the transfer, captured at write time so state transitions and async delivery
-can tell which party we are without inferring it from the matched PID (consumerPid is the primary
-key on both nodes). Optional for back-compat with records written before this field existed.
+can tell which party we are without inferring it from the matched PID (a self transfer stores two
+records sharing both pids). Optional for back-compat with records written before this field existed.
 
 ***
 
@@ -140,14 +141,6 @@ Last update timestamp (ISO string format).
 
 ***
 
-### policies? {#policies}
-
-> `optional` **policies?**: `IRightsManagementPolicy`[]
-
-Policies from the Agreement (stored as JSON).
-
-***
-
 ### dataAddress? {#dataaddress}
 
 > `optional` **dataAddress?**: `IDataspaceProtocolDataAddress`

package/docs/reference/classes/TransferProcessV0.md

@@ -0,0 +1,156 @@
+# Class: TransferProcessV0
+
+Transfer Process for shared storage between Control Plane and Data Plane, version 0.
+Keyed on consumerPid; superseded by the version keyed on the internal id.
+
+## Constructors
+
+### Constructor
+
+> **new TransferProcessV0**(): `TransferProcessV0`
+
+#### Returns
+
+`TransferProcessV0`
+
+## Properties
+
+### consumerPid {#consumerpid}
+
+> **consumerPid**: `string`
+
+The consumer PID is the primary key.
+Used for direct lookup by consumerPid.
+
+***
+
+### id {#id}
+
+> **id**: `string`
+
+Internal UUID for storage (secondary key for providerPid lookup).
+
+***
+
+### providerPid {#providerpid}
+
+> **providerPid**: `string`
+
+Provider Process ID from the DSP protocol.
+Indexed for lookup by providerPid.
+
+***
+
+### agreementId {#agreementid}
+
+> **agreementId**: `string`
+
+Agreement ID linking to the rights-management Agreement.
+
+***
+
+### state {#state}
+
+> **state**: `DataspaceProtocolTransferProcessStateType`
+
+Transfer Process state from the DSP protocol.
+One of: REQUESTED, STARTED, COMPLETED, SUSPENDED, TERMINATED.
+
+***
+
+### datasetId {#datasetid}
+
+> **datasetId**: `string`
+
+Dataset ID for DSC resolution.
+
+***
+
+### offerId {#offerid}
+
+> **offerId**: `string`
+
+Offer ID from the original Catalog offer.
+
+***
+
+### consumerIdentity? {#consumeridentity}
+
+> `optional` **consumerIdentity?**: `string`
+
+Consumer identity (DID or URI).
+
+***
+
+### providerIdentity? {#provideridentity}
+
+> `optional` **providerIdentity?**: `string`
+
+Provider identity (DID or URI).
+
+***
+
+### localRole? {#localrole}
+
+> `optional` **localRole?**: [`TransferProcessRole`](../type-aliases/TransferProcessRole.md)
+
+This node's role in the transfer, captured at write time so state transitions and async delivery
+can tell which party we are without inferring it from the matched PID (consumerPid is the primary
+key on both nodes). Optional for back-compat with records written before this field existed.
+
+***
+
+### format? {#format}
+
+> `optional` **format?**: `string`
+
+Data format from the Dataset Distribution.
+
+***
+
+### callbackAddress? {#callbackaddress}
+
+> `optional` **callbackAddress?**: `string`
+
+Callback address for Consumer notifications.
+
+***
+
+### organizationIdentity {#organizationidentity}
+
+> **organizationIdentity**: `string`
+
+The organization that owns this transfer process, captured from the request context at write time.
+
+***
+
+### dateCreated {#datecreated}
+
+> **dateCreated**: `string`
+
+Creation timestamp (ISO string format).
+
+***
+
+### dateModified {#datemodified}
+
+> **dateModified**: `string`
+
+Last update timestamp (ISO string format).
+
+***
+
+### policies? {#policies}
+
+> `optional` **policies?**: `IRightsManagementPolicy`[]
+
+Policies from the Agreement (stored as JSON).
+
+***
+
+### dataAddress? {#dataaddress}
+
+> `optional` **dataAddress?**: `IDataspaceProtocolDataAddress`
+
+Data address for the transfer (stored as JSON): the consumer's inbox for PUSH, or the
+provider-built address persisted at start for PULL/POST; may expire while STARTED.

package/docs/reference/index.md

@@ -6,6 +6,7 @@
 - [DataspaceAppDataset](classes/DataspaceAppDataset.md)
 - [DataspaceAppDatasetV0](classes/DataspaceAppDatasetV0.md)
 - [TransferProcess](classes/TransferProcess.md)
+- [TransferProcessV0](classes/TransferProcessV0.md)
 - [TransferRetrieval](classes/TransferRetrieval.md)
 
 ## Interfaces