@twin.org/dataspace-models 0.0.3-next.26 → 0.0.3-next.27

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

@@ -22,10 +22,16 @@ export interface IDataspaceApp extends IComponent {
      */
     activitiesHandled(): IActivityQuery[];
     /**
-     * The datasets handled by the App.
-     * @returns The Dataspace Protocol compliant datasets handled by the App.
+     * Optional override called by the Control Plane when publishing a stored dataset for this app.
+     * The Control Plane always calls `populateDefaults` (e.g. `dcterms:publisher`)
+     * on every dataset returned here, so apps don't need to populate publisher themselves.
+     * @param payload The user-stored dataset payload.
+     * @param tenantId The owning tenant for this dataset. Empty string on
+     * single-tenant nodes (no `TWIN_TENANT_ENABLED`).
+     * @returns One or more datasets to publish to the catalogue. System-stamped
+     * fields like `dcterms:publisher` may be omitted — the Control Plane fills them in.
      */
-    datasetsHandled(): Promise<IDataspaceProtocolDataset[]>;
+    datasetsHandled?(payload: IDataspaceProtocolDataset, tenantId: string): Promise<IDataspaceProtocolDataset[]>;
     /**
      * The types of queries supported.
      * @returns The types of queries supported by the Dataspace App to retrieve data.

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

@@ -0,0 +1,26 @@
+import type { IDataspaceProtocolDataset } from "@twin.org/standards-dataspace-protocol";
+/**
+ * Stored dataset record returned by the Control Plane's dataset CRUD surface.
+ */
+export interface IDataspaceAppDataset {
+    /**
+     * The stored dataset id (matches the dataset's JSON-LD `@id`).
+     */
+    id: string;
+    /**
+     * The dataspace app this dataset belongs to.
+     */
+    appId: string;
+    /**
+     * The dataset payload.
+     */
+    dataset: IDataspaceProtocolDataset;
+    /**
+     * Creation timestamp (ISO string).
+     */
+    dateCreated: string;
+    /**
+     * Last-modified timestamp (ISO string).
+     */
+    dateModified: string;
+}

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

@@ -1,5 +1,6 @@
 import type { IComponent } from "@twin.org/core";
-import type { IDataspaceProtocolContractNegotiation, IDataspaceProtocolContractNegotiationError, IDataspaceProtocolTransferCompletionMessage, IDataspaceProtocolTransferError, IDataspaceProtocolTransferProcess, IDataspaceProtocolTransferRequestMessage, IDataspaceProtocolTransferStartMessage, IDataspaceProtocolTransferSuspensionMessage, IDataspaceProtocolTransferTerminationMessage } from "@twin.org/standards-dataspace-protocol";
+import type { IDataspaceProtocolContractNegotiation, IDataspaceProtocolContractNegotiationError, IDataspaceProtocolDataset, IDataspaceProtocolTransferCompletionMessage, IDataspaceProtocolTransferError, IDataspaceProtocolTransferProcess, IDataspaceProtocolTransferRequestMessage, IDataspaceProtocolTransferStartMessage, IDataspaceProtocolTransferSuspensionMessage, IDataspaceProtocolTransferTerminationMessage } from "@twin.org/standards-dataspace-protocol";
+import type { IDataspaceAppDataset } from "./IDataspaceAppDataset.js";
 import type { INegotiationCallback } from "./INegotiationCallback.js";
 /**
  * Dataspace Control Plane Component interface.
@@ -177,4 +178,44 @@ export interface IDataspaceControlPlaneComponent extends IComponent {
      * @returns Transfer Process (DSP compliant) with current state, or TransferError if the operation fails.
      */
     getTransferProcess(pid: string, trustPayload: unknown): Promise<IDataspaceProtocolTransferProcess | IDataspaceProtocolTransferError>;
+    /**
+     * Register an app dataset for a dataspace app, owned by the calling tenant.
+     * @param id Optional explicit id. If omitted, derived from `dataset["@id"]`
+     * or generated.
+     * @param appId The dataspace app this dataset belongs to (matches
+     * `DataspaceAppFactory` registration name).
+     * @param dataset The dataset payload (may omit system-stamped fields).
+     * @returns The resolved dataset id.
+     */
+    createAppDataset(id: string | undefined, appId: string, dataset: IDataspaceProtocolDataset): Promise<string>;
+    /**
+     * Get an app dataset record owned by the calling tenant.
+     * @param id The stored app dataset id.
+     * @returns The stored app dataset record.
+     */
+    getAppDataset(id: string): Promise<IDataspaceAppDataset>;
+    /**
+     * List the app datasets owned by the calling tenant.
+     * @param cursor Optional pagination cursor.
+     * @param limit Optional maximum number of entries to return.
+     * @returns The stored app datasets and the next-page cursor if more exist.
+     */
+    listAppDatasets(cursor?: string, limit?: number): Promise<{
+        entities: IDataspaceAppDataset[];
+        cursor?: string;
+    }>;
+    /**
+     * Update an app dataset record owned by the calling tenant.
+     * @param id The stored app dataset id.
+     * @param appId The dataspace app this dataset belongs to.
+     * @param dataset The dataset payload.
+     * @returns Nothing.
+     */
+    updateAppDataset(id: string, appId: string, dataset: IDataspaceProtocolDataset): Promise<void>;
+    /**
+     * Delete an app dataset record owned by the calling tenant.
+     * @param id The stored app dataset id.
+     * @returns Nothing.
+     */
+    deleteAppDataset(id: string): Promise<void>;
 }

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

@@ -0,0 +1,28 @@
+/**
+ * TWIN transfer format identifiers used in TransferRequestMessage.format.
+ * Follows the Eclipse EDC canonical pattern: <DestinationType-FlowType>.
+ * See RFC-007 Data Transfer Profile.
+ */
+export declare const DataspaceTransferFormat: {
+    /**
+     * PULL mode: consumer queries data via a bearer-token-protected endpoint.
+     * Data flows: Consumer GET provider endpoint (with token).
+     */
+    readonly HttpProxyPull: "HttpProxy-PULL";
+    /**
+     * Consumer-initiated PUSH mode: consumer supplies their /inbox endpoint in the
+     * TransferRequestMessage. Provider pushes ActivityStreams objects to that endpoint.
+     * Data flows: Provider POST to consumer's /inbox.
+     */
+    readonly HttpProxyPush: "HttpProxy-PUSH";
+    /**
+     * Provider-initiated PUSH mode (inverted flow): consumer supplies no dataAddress.
+     * Provider returns its own /inbox URL + signed JWT. Consumer then posts data there.
+     * Data flows: Consumer POST to provider's /inbox.
+     */
+    readonly HttpProxyPost: "HttpProxy-POST";
+};
+/**
+ * Type for the DataspaceTransferFormat const values.
+ */
+export type DataspaceTransferFormat = (typeof DataspaceTransferFormat)[keyof typeof DataspaceTransferFormat];

package/docs/changelog.md

@@ -1,245 +1,253 @@
 # Changelog
 
-## [0.0.3-next.26](https://github.com/twinfoundation/dataspace/compare/dataspace-models-v0.0.3-next.25...dataspace-models-v0.0.3-next.26) (2026-04-14)
+## [0.0.3-next.27](https://github.com/iotaledger/twin-dataspace/compare/dataspace-models-v0.0.3-next.26...dataspace-models-v0.0.3-next.27) (2026-05-08)
 
 
 ### Features
 
-* add inline tasks and concurrent options ([#104](https://github.com/twinfoundation/dataspace/issues/104)) ([2227a21](https://github.com/twinfoundation/dataspace/commit/2227a212d906f58ba77850c79bb20bf2cb7195a8))
+* add dataspace transfer format ([#111](https://github.com/iotaledger/twin-dataspace/issues/111)) ([f59ff5e](https://github.com/iotaledger/twin-dataspace/commit/f59ff5ef10d261d1cebbf5c6bb0689e74a10738a))
+* endpoint encryption + getDatasetTargets multi-target fix ([#112](https://github.com/iotaledger/twin-dataspace/issues/112)) ([3288941](https://github.com/iotaledger/twin-dataspace/commit/328894113c19c7402f7d00dfa77b6a97ae40ca91))
 
-## [0.0.3-next.25](https://github.com/twinfoundation/dataspace/compare/dataspace-models-v0.0.3-next.24...dataspace-models-v0.0.3-next.25) (2026-04-10)
+## [0.0.3-next.26](https://github.com/iotaledger/twin-dataspace/compare/dataspace-models-v0.0.3-next.25...dataspace-models-v0.0.3-next.26) (2026-04-14)
+
+
+### Features
+
+* add inline tasks and concurrent options ([#104](https://github.com/iotaledger/twin-dataspace/issues/104)) ([2227a21](https://github.com/iotaledger/twin-dataspace/commit/2227a212d906f58ba77850c79bb20bf2cb7195a8))
+
+## [0.0.3-next.25](https://github.com/iotaledger/twin-dataspace/compare/dataspace-models-v0.0.3-next.24...dataspace-models-v0.0.3-next.25) (2026-04-10)
 
 
 ### Miscellaneous Chores
 
 * **dataspace-models:** Synchronize repo versions
 
-## [0.0.3-next.24](https://github.com/twinfoundation/dataspace/compare/dataspace-models-v0.0.3-next.23...dataspace-models-v0.0.3-next.24) (2026-03-31)
+## [0.0.3-next.24](https://github.com/iotaledger/twin-dataspace/compare/dataspace-models-v0.0.3-next.23...dataspace-models-v0.0.3-next.24) (2026-03-31)
 
 
 ### Miscellaneous Chores
 
 * **dataspace-models:** Synchronize repo versions
 
-## [0.0.3-next.23](https://github.com/twinfoundation/dataspace/compare/dataspace-models-v0.0.3-next.22...dataspace-models-v0.0.3-next.23) (2026-03-25)
+## [0.0.3-next.23](https://github.com/iotaledger/twin-dataspace/compare/dataspace-models-v0.0.3-next.22...dataspace-models-v0.0.3-next.23) (2026-03-25)
 
 
 ### Miscellaneous Chores
 
 * **dataspace-models:** Synchronize repo versions
 
-## [0.0.3-next.22](https://github.com/twinfoundation/dataspace/compare/dataspace-models-v0.0.3-next.21...dataspace-models-v0.0.3-next.22) (2026-03-20)
+## [0.0.3-next.22](https://github.com/iotaledger/twin-dataspace/compare/dataspace-models-v0.0.3-next.21...dataspace-models-v0.0.3-next.22) (2026-03-20)
 
 
 ### Miscellaneous Chores
 
 * **dataspace-models:** Synchronize repo versions
 
-## [0.0.3-next.21](https://github.com/twinfoundation/dataspace/compare/dataspace-models-v0.0.3-next.20...dataspace-models-v0.0.3-next.21) (2026-03-17)
+## [0.0.3-next.21](https://github.com/iotaledger/twin-dataspace/compare/dataspace-models-v0.0.3-next.20...dataspace-models-v0.0.3-next.21) (2026-03-17)
 
 
 ### Features
 
-* improve open-api examples ([1368dbe](https://github.com/twinfoundation/dataspace/commit/1368dbed5c36e074b4854942304a19b9ce51e088))
+* improve open-api examples ([1368dbe](https://github.com/iotaledger/twin-dataspace/commit/1368dbed5c36e074b4854942304a19b9ce51e088))
 
-## [0.0.3-next.20](https://github.com/twinfoundation/dataspace/compare/dataspace-models-v0.0.3-next.19...dataspace-models-v0.0.3-next.20) (2026-03-17)
+## [0.0.3-next.20](https://github.com/iotaledger/twin-dataspace/compare/dataspace-models-v0.0.3-next.19...dataspace-models-v0.0.3-next.20) (2026-03-17)
 
 
 ### Miscellaneous Chores
 
 * **dataspace-models:** Synchronize repo versions
 
-## [0.0.3-next.19](https://github.com/twinfoundation/dataspace/compare/dataspace-models-v0.0.3-next.18...dataspace-models-v0.0.3-next.19) (2026-03-12)
+## [0.0.3-next.19](https://github.com/iotaledger/twin-dataspace/compare/dataspace-models-v0.0.3-next.18...dataspace-models-v0.0.3-next.19) (2026-03-12)
 
 
 ### Features
 
-* improve validation ([#82](https://github.com/twinfoundation/dataspace/issues/82)) ([8bfaf7b](https://github.com/twinfoundation/dataspace/commit/8bfaf7b830f89b63575f8a51ee96bd8ac4da02f4))
+* improve validation ([#82](https://github.com/iotaledger/twin-dataspace/issues/82)) ([8bfaf7b](https://github.com/iotaledger/twin-dataspace/commit/8bfaf7b830f89b63575f8a51ee96bd8ac4da02f4))
 
-## [0.0.3-next.18](https://github.com/twinfoundation/dataspace/compare/dataspace-models-v0.0.3-next.17...dataspace-models-v0.0.3-next.18) (2026-03-09)
+## [0.0.3-next.18](https://github.com/iotaledger/twin-dataspace/compare/dataspace-models-v0.0.3-next.17...dataspace-models-v0.0.3-next.18) (2026-03-09)
 
 
 ### Features
 
-* resolve DSP transfer flow bugs for cross-node communication ([#76](https://github.com/twinfoundation/dataspace/issues/76)) ([506a45c](https://github.com/twinfoundation/dataspace/commit/506a45c94e63d5f958b1fc7131adfe452c3e2974))
+* resolve DSP transfer flow bugs for cross-node communication ([#76](https://github.com/iotaledger/twin-dataspace/issues/76)) ([506a45c](https://github.com/iotaledger/twin-dataspace/commit/506a45c94e63d5f958b1fc7131adfe452c3e2974))
 
-## [0.0.3-next.17](https://github.com/twinfoundation/dataspace/compare/dataspace-models-v0.0.3-next.16...dataspace-models-v0.0.3-next.17) (2026-03-06)
+## [0.0.3-next.17](https://github.com/iotaledger/twin-dataspace/compare/dataspace-models-v0.0.3-next.16...dataspace-models-v0.0.3-next.17) (2026-03-06)
 
 
 ### Features
 
-* docs update ([8b44c7a](https://github.com/twinfoundation/dataspace/commit/8b44c7a75afb8d377a6f606616f8a78d58439ab4))
-* types update ([77c338e](https://github.com/twinfoundation/dataspace/commit/77c338e9244dcc7e3d597fdb06229513b1f13eac))
+* docs update ([8b44c7a](https://github.com/iotaledger/twin-dataspace/commit/8b44c7a75afb8d377a6f606616f8a78d58439ab4))
+* types update ([77c338e](https://github.com/iotaledger/twin-dataspace/commit/77c338e9244dcc7e3d597fdb06229513b1f13eac))
 
 
 ### Bug Fixes
 
-* avoid compaction of incoming activities ([#77](https://github.com/twinfoundation/dataspace/issues/77)) ([ff43d6a](https://github.com/twinfoundation/dataspace/commit/ff43d6a3e1563eb9cb185501134b2a53ae88787c))
+* avoid compaction of incoming activities ([#77](https://github.com/iotaledger/twin-dataspace/issues/77)) ([ff43d6a](https://github.com/iotaledger/twin-dataspace/commit/ff43d6a3e1563eb9cb185501134b2a53ae88787c))
 
-## [0.0.3-next.16](https://github.com/twinfoundation/dataspace/compare/dataspace-models-v0.0.3-next.15...dataspace-models-v0.0.3-next.16) (2026-03-02)
+## [0.0.3-next.16](https://github.com/iotaledger/twin-dataspace/compare/dataspace-models-v0.0.3-next.15...dataspace-models-v0.0.3-next.16) (2026-03-02)
 
 
 ### Miscellaneous Chores
 
 * **dataspace-models:** Synchronize repo versions
 
-## [0.0.3-next.15](https://github.com/twinfoundation/dataspace/compare/dataspace-models-v0.0.3-next.14...dataspace-models-v0.0.3-next.15) (2026-03-02)
+## [0.0.3-next.15](https://github.com/iotaledger/twin-dataspace/compare/dataspace-models-v0.0.3-next.14...dataspace-models-v0.0.3-next.15) (2026-03-02)
 
 
 ### Features
 
-* unification of the data exchange and the data space connector ([#57](https://github.com/twinfoundation/dataspace/issues/57)) ([df2644d](https://github.com/twinfoundation/dataspace/commit/df2644d989471e07dadd83d27bef736179e31bf4))
+* unification of the data exchange and the data space connector ([#57](https://github.com/iotaledger/twin-dataspace/issues/57)) ([df2644d](https://github.com/iotaledger/twin-dataspace/commit/df2644d989471e07dadd83d27bef736179e31bf4))
 
-## [0.0.3-next.12](https://github.com/twinfoundation/dataspace/compare/dataspace-models-v0.0.3-next.11...dataspace-models-v0.0.3-next.12) (2026-01-22)
+## [0.0.3-next.12](https://github.com/iotaledger/twin-dataspace/compare/dataspace-models-v0.0.3-next.11...dataspace-models-v0.0.3-next.12) (2026-01-22)
 
 
 ### Features
 
-* allow retry of failed activities instead of treating as duplicates ([#53](https://github.com/twinfoundation/dataspace/issues/53)) ([363dddc](https://github.com/twinfoundation/dataspace/commit/363dddc0ba14a50cf1d6f233d17f19c6110fbd47))
+* allow retry of failed activities instead of treating as duplicates ([#53](https://github.com/iotaledger/twin-dataspace/issues/53)) ([363dddc](https://github.com/iotaledger/twin-dataspace/commit/363dddc0ba14a50cf1d6f233d17f19c6110fbd47))
 
-## [0.0.3-next.11](https://github.com/twinfoundation/dataspace/compare/dataspace-models-v0.0.3-next.10...dataspace-models-v0.0.3-next.11) (2026-01-22)
+## [0.0.3-next.11](https://github.com/iotaledger/twin-dataspace/compare/dataspace-models-v0.0.3-next.10...dataspace-models-v0.0.3-next.11) (2026-01-22)
 
 
 ### Miscellaneous Chores
 
 * **dataspace-models:** Synchronize repo versions
 
-## [0.0.3-next.10](https://github.com/twinfoundation/dataspace/compare/dataspace-models-v0.0.3-next.9...dataspace-models-v0.0.3-next.10) (2026-01-19)
+## [0.0.3-next.10](https://github.com/iotaledger/twin-dataspace/compare/dataspace-models-v0.0.3-next.9...dataspace-models-v0.0.3-next.10) (2026-01-19)
 
 
 ### Features
 
-* replace registerApp with factory pattern ([#51](https://github.com/twinfoundation/dataspace/issues/51)) ([a7ef328](https://github.com/twinfoundation/dataspace/commit/a7ef32873f5781f7b1f8aa3670f5fb612dd17018))
+* replace registerApp with factory pattern ([#51](https://github.com/iotaledger/twin-dataspace/issues/51)) ([a7ef328](https://github.com/iotaledger/twin-dataspace/commit/a7ef32873f5781f7b1f8aa3670f5fb612dd17018))
 
-## [0.0.3-next.9](https://github.com/twinfoundation/dataspace/compare/dataspace-models-v0.0.3-next.8...dataspace-models-v0.0.3-next.9) (2026-01-19)
+## [0.0.3-next.9](https://github.com/iotaledger/twin-dataspace/compare/dataspace-models-v0.0.3-next.8...dataspace-models-v0.0.3-next.9) (2026-01-19)
 
 
 ### Features
 
-* update data space connector to use trust service ([#47](https://github.com/twinfoundation/dataspace/issues/47)) ([41c5113](https://github.com/twinfoundation/dataspace/commit/41c5113512cdc477c2f9508b27dfaff84529d841))
-* update order of trustPayload parameter ([0656ddd](https://github.com/twinfoundation/dataspace/commit/0656ddd328accda0370d979a6cb5f947071e700b))
+* update data space connector to use trust service ([#47](https://github.com/iotaledger/twin-dataspace/issues/47)) ([41c5113](https://github.com/iotaledger/twin-dataspace/commit/41c5113512cdc477c2f9508b27dfaff84529d841))
+* update order of trustPayload parameter ([0656ddd](https://github.com/iotaledger/twin-dataspace/commit/0656ddd328accda0370d979a6cb5f947071e700b))
 
-## [0.0.3-next.8](https://github.com/twinfoundation/dataspace/compare/dataspace-models-v0.0.3-next.7...dataspace-models-v0.0.3-next.8) (2026-01-16)
+## [0.0.3-next.8](https://github.com/iotaledger/twin-dataspace/compare/dataspace-models-v0.0.3-next.7...dataspace-models-v0.0.3-next.8) (2026-01-16)
 
 
 ### Miscellaneous Chores
 
 * **dataspace-models:** Synchronize repo versions
 
-## [0.0.3-next.7](https://github.com/twinfoundation/dataspace/compare/dataspace-models-v0.0.3-next.6...dataspace-models-v0.0.3-next.7) (2026-01-16)
+## [0.0.3-next.7](https://github.com/iotaledger/twin-dataspace/compare/dataspace-models-v0.0.3-next.6...dataspace-models-v0.0.3-next.7) (2026-01-16)
 
 
 ### Features
 
-* implement Link headers for pagination ([#43](https://github.com/twinfoundation/dataspace/issues/43)) ([ce2a31f](https://github.com/twinfoundation/dataspace/commit/ce2a31fab1b5a1338d34b8514e96a203705c68d1))
+* implement Link headers for pagination ([#43](https://github.com/iotaledger/twin-dataspace/issues/43)) ([ce2a31f](https://github.com/iotaledger/twin-dataspace/commit/ce2a31fab1b5a1338d34b8514e96a203705c68d1))
 
-## [0.0.3-next.6](https://github.com/twinfoundation/dataspace/compare/dataspace-models-v0.0.3-next.5...dataspace-models-v0.0.3-next.6) (2026-01-15)
+## [0.0.3-next.6](https://github.com/iotaledger/twin-dataspace/compare/dataspace-models-v0.0.3-next.5...dataspace-models-v0.0.3-next.6) (2026-01-15)
 
 
 ### Features
 
-* update contexts and namespaces ([#41](https://github.com/twinfoundation/dataspace/issues/41)) ([cad79f9](https://github.com/twinfoundation/dataspace/commit/cad79f9f18c0b1bc4a4604a951c28db1d1068f5e))
+* update contexts and namespaces ([#41](https://github.com/iotaledger/twin-dataspace/issues/41)) ([cad79f9](https://github.com/iotaledger/twin-dataspace/commit/cad79f9f18c0b1bc4a4604a951c28db1d1068f5e))
 
-## [0.0.3-next.5](https://github.com/twinfoundation/dataspace/compare/dataspace-models-v0.0.3-next.4...dataspace-models-v0.0.3-next.5) (2026-01-07)
+## [0.0.3-next.5](https://github.com/iotaledger/twin-dataspace/compare/dataspace-models-v0.0.3-next.4...dataspace-models-v0.0.3-next.5) (2026-01-07)
 
 
 ### Miscellaneous Chores
 
 * **dataspace-models:** Synchronize repo versions
 
-## [0.0.3-next.4](https://github.com/twinfoundation/dataspace/compare/dataspace-models-v0.0.3-next.3...dataspace-models-v0.0.3-next.4) (2026-01-06)
+## [0.0.3-next.4](https://github.com/iotaledger/twin-dataspace/compare/dataspace-models-v0.0.3-next.3...dataspace-models-v0.0.3-next.4) (2026-01-06)
 
 
 ### Features
 
-* rfc 004 implementation ([#34](https://github.com/twinfoundation/dataspace/issues/34)) ([3920a45](https://github.com/twinfoundation/dataspace/commit/3920a456f744610885c33cb0960e0448aea71a44))
-* update standards dependencies ([8534ad7](https://github.com/twinfoundation/dataspace/commit/8534ad74b996610ed5994b5213c857989c2bf57a))
+* rfc 004 implementation ([#34](https://github.com/iotaledger/twin-dataspace/issues/34)) ([3920a45](https://github.com/iotaledger/twin-dataspace/commit/3920a456f744610885c33cb0960e0448aea71a44))
+* update standards dependencies ([8534ad7](https://github.com/iotaledger/twin-dataspace/commit/8534ad74b996610ed5994b5213c857989c2bf57a))
 
-## [0.0.3-next.3](https://github.com/twinfoundation/dataspace/compare/dataspace-models-v0.0.3-next.2...dataspace-models-v0.0.3-next.3) (2025-12-01)
+## [0.0.3-next.3](https://github.com/iotaledger/twin-dataspace/compare/dataspace-models-v0.0.3-next.2...dataspace-models-v0.0.3-next.3) (2025-12-01)
 
 
 ### Features
 
-* update background task service ([c907578](https://github.com/twinfoundation/dataspace/commit/c907578c4ff5906c62b37d788a078d99fe8a59dc))
+* update background task service ([c907578](https://github.com/iotaledger/twin-dataspace/commit/c907578c4ff5906c62b37d788a078d99fe8a59dc))
 
-## [0.0.3-next.2](https://github.com/twinfoundation/dataspace/compare/dataspace-models-v0.0.3-next.1...dataspace-models-v0.0.3-next.2) (2025-11-28)
+## [0.0.3-next.2](https://github.com/iotaledger/twin-dataspace/compare/dataspace-models-v0.0.3-next.1...dataspace-models-v0.0.3-next.2) (2025-11-28)
 
 
 ### Miscellaneous Chores
 
 * **dataspace-models:** Synchronize repo versions
 
-## [0.0.3-next.1](https://github.com/twinfoundation/dataspace/compare/dataspace-models-v0.0.3-next.0...dataspace-models-v0.0.3-next.1) (2025-11-12)
+## [0.0.3-next.1](https://github.com/iotaledger/twin-dataspace/compare/dataspace-models-v0.0.3-next.0...dataspace-models-v0.0.3-next.1) (2025-11-12)
 
 
 ### Features
 
-* add context id features ([#26](https://github.com/twinfoundation/dataspace/issues/26)) ([6429a16](https://github.com/twinfoundation/dataspace/commit/6429a160dac9499304fdfb93a9dbdce37277ca7d))
-* add rest and socket clients ([950bf70](https://github.com/twinfoundation/dataspace/commit/950bf705e6df4e709bbbe58e93968510067b9ddc))
-* add validate-locales ([c0b08a7](https://github.com/twinfoundation/dataspace/commit/c0b08a73268f9fd3eb6ac3079b49d1ab0c01f118))
-* dataspace ([#2](https://github.com/twinfoundation/dataspace/issues/2)) ([c2ac651](https://github.com/twinfoundation/dataspace/commit/c2ac651ceb6f35e46bd5eac97ac648bb1ee9dc0c))
-* eslint migration to flat config ([b84e875](https://github.com/twinfoundation/dataspace/commit/b84e87530aa249891618096ab6e072b21ff9f63a))
-* first bootstrap ([2a5bab8](https://github.com/twinfoundation/dataspace/commit/2a5bab8bc1e2313f0de4d201e842a9fe7c7bab49))
-* query interface data space connector ([#18](https://github.com/twinfoundation/dataspace/issues/18)) ([b12eca1](https://github.com/twinfoundation/dataspace/commit/b12eca124a8f46d290c168e364b7ed4bf72001d8))
-* update framework components ([4d9ca95](https://github.com/twinfoundation/dataspace/commit/4d9ca95879bd6cae9d031595292b6a872bf5b5fd))
-* use new engine extensions config ([80bdb5b](https://github.com/twinfoundation/dataspace/commit/80bdb5b298b65b5b22fa9927a0ad031cb9a3534d))
+* add context id features ([#26](https://github.com/iotaledger/twin-dataspace/issues/26)) ([6429a16](https://github.com/iotaledger/twin-dataspace/commit/6429a160dac9499304fdfb93a9dbdce37277ca7d))
+* add rest and socket clients ([950bf70](https://github.com/iotaledger/twin-dataspace/commit/950bf705e6df4e709bbbe58e93968510067b9ddc))
+* add validate-locales ([c0b08a7](https://github.com/iotaledger/twin-dataspace/commit/c0b08a73268f9fd3eb6ac3079b49d1ab0c01f118))
+* dataspace ([#2](https://github.com/iotaledger/twin-dataspace/issues/2)) ([c2ac651](https://github.com/iotaledger/twin-dataspace/commit/c2ac651ceb6f35e46bd5eac97ac648bb1ee9dc0c))
+* eslint migration to flat config ([b84e875](https://github.com/iotaledger/twin-dataspace/commit/b84e87530aa249891618096ab6e072b21ff9f63a))
+* first bootstrap ([2a5bab8](https://github.com/iotaledger/twin-dataspace/commit/2a5bab8bc1e2313f0de4d201e842a9fe7c7bab49))
+* query interface data space connector ([#18](https://github.com/iotaledger/twin-dataspace/issues/18)) ([b12eca1](https://github.com/iotaledger/twin-dataspace/commit/b12eca124a8f46d290c168e364b7ed4bf72001d8))
+* update framework components ([4d9ca95](https://github.com/iotaledger/twin-dataspace/commit/4d9ca95879bd6cae9d031595292b6a872bf5b5fd))
+* use new engine extensions config ([80bdb5b](https://github.com/iotaledger/twin-dataspace/commit/80bdb5b298b65b5b22fa9927a0ad031cb9a3534d))
 
-## [0.0.1-next.8](https://github.com/twinfoundation/dataspace/compare/dataspace-models-v0.0.1-next.7...dataspace-models-v0.0.1-next.8) (2025-10-09)
+## [0.0.1-next.8](https://github.com/iotaledger/twin-dataspace/compare/dataspace-models-v0.0.1-next.7...dataspace-models-v0.0.1-next.8) (2025-10-09)
 
 
 ### Features
 
-* add validate-locales ([c0b08a7](https://github.com/twinfoundation/dataspace/commit/c0b08a73268f9fd3eb6ac3079b49d1ab0c01f118))
+* add validate-locales ([c0b08a7](https://github.com/iotaledger/twin-dataspace/commit/c0b08a73268f9fd3eb6ac3079b49d1ab0c01f118))
 
-## [0.0.1-next.7](https://github.com/twinfoundation/dataspace/compare/dataspace-models-v0.0.1-next.6...dataspace-models-v0.0.1-next.7) (2025-10-02)
+## [0.0.1-next.7](https://github.com/iotaledger/twin-dataspace/compare/dataspace-models-v0.0.1-next.6...dataspace-models-v0.0.1-next.7) (2025-10-02)
 
 
 ### Features
 
-* use new engine extensions config ([80bdb5b](https://github.com/twinfoundation/dataspace/commit/80bdb5b298b65b5b22fa9927a0ad031cb9a3534d))
+* use new engine extensions config ([80bdb5b](https://github.com/iotaledger/twin-dataspace/commit/80bdb5b298b65b5b22fa9927a0ad031cb9a3534d))
 
-## [0.0.1-next.6](https://github.com/twinfoundation/dataspace/compare/dataspace-models-v0.0.1-next.5...dataspace-models-v0.0.1-next.6) (2025-09-29)
+## [0.0.1-next.6](https://github.com/iotaledger/twin-dataspace/compare/dataspace-models-v0.0.1-next.5...dataspace-models-v0.0.1-next.6) (2025-09-29)
 
 
 ### Miscellaneous Chores
 
 * **dataspace-models:** Synchronize repo versions
 
-## [0.0.1-next.5](https://github.com/twinfoundation/dataspace/compare/dataspace-models-v0.0.1-next.4...dataspace-models-v0.0.1-next.5) (2025-09-29)
+## [0.0.1-next.5](https://github.com/iotaledger/twin-dataspace/compare/dataspace-models-v0.0.1-next.4...dataspace-models-v0.0.1-next.5) (2025-09-29)
 
 
 ### Features
 
-* update framework components ([4d9ca95](https://github.com/twinfoundation/dataspace/commit/4d9ca95879bd6cae9d031595292b6a872bf5b5fd))
+* update framework components ([4d9ca95](https://github.com/iotaledger/twin-dataspace/commit/4d9ca95879bd6cae9d031595292b6a872bf5b5fd))
 
-## [0.0.1-next.4](https://github.com/twinfoundation/dataspace/compare/dataspace-models-v0.0.1-next.3...dataspace-models-v0.0.1-next.4) (2025-08-29)
+## [0.0.1-next.4](https://github.com/iotaledger/twin-dataspace/compare/dataspace-models-v0.0.1-next.3...dataspace-models-v0.0.1-next.4) (2025-08-29)
 
 
 ### Features
 
-* eslint migration to flat config ([b84e875](https://github.com/twinfoundation/dataspace/commit/b84e87530aa249891618096ab6e072b21ff9f63a))
+* eslint migration to flat config ([b84e875](https://github.com/iotaledger/twin-dataspace/commit/b84e87530aa249891618096ab6e072b21ff9f63a))
 
-## [0.0.1-next.3](https://github.com/twinfoundation/dataspace/compare/dataspace-models-v0.0.1-next.2...dataspace-models-v0.0.1-next.3) (2025-08-25)
+## [0.0.1-next.3](https://github.com/iotaledger/twin-dataspace/compare/dataspace-models-v0.0.1-next.2...dataspace-models-v0.0.1-next.3) (2025-08-25)
 
 
 ### Miscellaneous Chores
 
 * **dataspace-models:** Synchronize repo versions
 
-## [0.0.1-next.2](https://github.com/twinfoundation/dataspace/compare/dataspace-models-v0.0.1-next.1...dataspace-models-v0.0.1-next.2) (2025-08-25)
+## [0.0.1-next.2](https://github.com/iotaledger/twin-dataspace/compare/dataspace-models-v0.0.1-next.1...dataspace-models-v0.0.1-next.2) (2025-08-25)
 
 
 ### Features
 
-* add rest and socket clients ([950bf70](https://github.com/twinfoundation/dataspace/commit/950bf705e6df4e709bbbe58e93968510067b9ddc))
-* dataspace ([#2](https://github.com/twinfoundation/dataspace/issues/2)) ([c2ac651](https://github.com/twinfoundation/dataspace/commit/c2ac651ceb6f35e46bd5eac97ac648bb1ee9dc0c))
-* first bootstrap ([2a5bab8](https://github.com/twinfoundation/dataspace/commit/2a5bab8bc1e2313f0de4d201e842a9fe7c7bab49))
+* add rest and socket clients ([950bf70](https://github.com/iotaledger/twin-dataspace/commit/950bf705e6df4e709bbbe58e93968510067b9ddc))
+* dataspace ([#2](https://github.com/iotaledger/twin-dataspace/issues/2)) ([c2ac651](https://github.com/iotaledger/twin-dataspace/commit/c2ac651ceb6f35e46bd5eac97ac648bb1ee9dc0c))
+* first bootstrap ([2a5bab8](https://github.com/iotaledger/twin-dataspace/commit/2a5bab8bc1e2313f0de4d201e842a9fe7c7bab49))
 
-## [0.0.1-next.1](https://github.com/twinfoundation/dataspace/compare/dataspace-models-v0.0.1-next.0...dataspace-models-v0.0.1-next.1) (2025-08-25)
+## [0.0.1-next.1](https://github.com/iotaledger/twin-dataspace/compare/dataspace-models-v0.0.1-next.0...dataspace-models-v0.0.1-next.1) (2025-08-25)
 
 
 ### Features
 
-* add rest and socket clients ([950bf70](https://github.com/twinfoundation/dataspace/commit/950bf705e6df4e709bbbe58e93968510067b9ddc))
-* dataspace ([#2](https://github.com/twinfoundation/dataspace/issues/2)) ([c2ac651](https://github.com/twinfoundation/dataspace/commit/c2ac651ceb6f35e46bd5eac97ac648bb1ee9dc0c))
-* first bootstrap ([2a5bab8](https://github.com/twinfoundation/dataspace/commit/2a5bab8bc1e2313f0de4d201e842a9fe7c7bab49))
+* add rest and socket clients ([950bf70](https://github.com/iotaledger/twin-dataspace/commit/950bf705e6df4e709bbbe58e93968510067b9ddc))
+* dataspace ([#2](https://github.com/iotaledger/twin-dataspace/issues/2)) ([c2ac651](https://github.com/iotaledger/twin-dataspace/commit/c2ac651ceb6f35e46bd5eac97ac648bb1ee9dc0c))
+* first bootstrap ([2a5bab8](https://github.com/iotaledger/twin-dataspace/commit/2a5bab8bc1e2313f0de4d201e842a9fe7c7bab49))

package/docs/reference/classes/DataspaceAppDataset.md

@@ -0,0 +1,80 @@
+# Class: DataspaceAppDataset
+
+Tenant-supplied Dataset shape persisted by the Control Plane.
+
+## Constructors
+
+### Constructor
+
+> **new DataspaceAppDataset**(): `DataspaceAppDataset`
+
+#### Returns
+
+`DataspaceAppDataset`
+
+## Properties
+
+### id {#id}
+
+> **id**: `string`
+
+The unique identifier for the dataset.
+
+***
+
+### nodeIdentity {#nodeidentity}
+
+> **nodeIdentity**: `string`
+
+The identity of the node that owns this entity (required for sync).
+
+***
+
+### tenantId? {#tenantid}
+
+> `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`)
+register datasets without a tenant context, in which case federated catalogue stores
+the dataset with no `tenantId` and URL-baking is skipped.
+
+***
+
+### appId {#appid}
+
+> **appId**: `string`
+
+The dataspace app that this dataset belongs to. Matches the app's
+registered name in `DataspaceAppFactory` (typically the app's URI).
+Used as the join key when dispatching to an app's optional
+`datasetsHandled` override.
+
+***
+
+### dataset {#dataset}
+
+> **dataset**: `object`
+
+The user-controlled JSON-LD dataset payload. Stored as an
+opaque object and validated/populated at publish time.
+
+#### Index Signature
+
+\[`key`: `string`\]: `unknown`
+
+***
+
+### dateCreated {#datecreated}
+
+> **dateCreated**: `string`
+
+Creation timestamp (ISO string format).
+
+***
+
+### dateModified {#datemodified}
+
+> **dateModified**: `string`
+
+Last update timestamp (ISO string format).

package/docs/reference/index.md

@@ -3,6 +3,7 @@
 ## Classes
 
 - [DataspaceDataTypes](classes/DataspaceDataTypes.md)
+- [DataspaceAppDataset](classes/DataspaceAppDataset.md)
 - [TransferProcess](classes/TransferProcess.md)
 
 ## Interfaces
@@ -27,6 +28,14 @@
 - [IDataAssetEntitiesResponse](interfaces/IDataAssetEntitiesResponse.md)
 - [IDataAssetGetEntitiesRequest](interfaces/IDataAssetGetEntitiesRequest.md)
 - [IDataAssetQueryRequest](interfaces/IDataAssetQueryRequest.md)
+- [IAppDatasetCreateRequest](interfaces/IAppDatasetCreateRequest.md)
+- [IAppDatasetCreateResponse](interfaces/IAppDatasetCreateResponse.md)
+- [IAppDatasetDeleteRequest](interfaces/IAppDatasetDeleteRequest.md)
+- [IAppDatasetGetRequest](interfaces/IAppDatasetGetRequest.md)
+- [IAppDatasetGetResponse](interfaces/IAppDatasetGetResponse.md)
+- [IAppDatasetListRequest](interfaces/IAppDatasetListRequest.md)
+- [IAppDatasetListResponse](interfaces/IAppDatasetListResponse.md)
+- [IAppDatasetUpdateRequest](interfaces/IAppDatasetUpdateRequest.md)
 - [ICompleteTransferRequest](interfaces/ICompleteTransferRequest.md)
 - [ICompleteTransferResponse](interfaces/ICompleteTransferResponse.md)
 - [IGetTransferProcessRequest](interfaces/IGetTransferProcessRequest.md)
@@ -45,6 +54,7 @@
 - [IDataspaceApp](interfaces/IDataspaceApp.md)
 - [IProcessingGroupOptions](interfaces/IProcessingGroupOptions.md)
 - [IQueryDataAssetRequest](interfaces/IQueryDataAssetRequest.md)
+- [IDataspaceAppDataset](interfaces/IDataspaceAppDataset.md)
 - [IDataspaceControlPlaneComponent](interfaces/IDataspaceControlPlaneComponent.md)
 - [IDataspaceControlPlaneResolverComponent](interfaces/IDataspaceControlPlaneResolverComponent.md)
 - [INegotiationCallback](interfaces/INegotiationCallback.md)
@@ -61,6 +71,7 @@
 - [DataRequestType](type-aliases/DataRequestType.md)
 - [TransferProcessRole](type-aliases/TransferProcessRole.md)
 - [DataspaceContexts](type-aliases/DataspaceContexts.md)
+- [DataspaceTransferFormat](type-aliases/DataspaceTransferFormat.md)
 - [DataspaceTypes](type-aliases/DataspaceTypes.md)
 
 ## Variables
@@ -71,4 +82,5 @@
 - [DataRequestType](variables/DataRequestType.md)
 - [TransferProcessRole](variables/TransferProcessRole.md)
 - [DataspaceContexts](variables/DataspaceContexts.md)
+- [DataspaceTransferFormat](variables/DataspaceTransferFormat.md)
 - [DataspaceTypes](variables/DataspaceTypes.md)

package/docs/reference/interfaces/IAppDatasetCreateRequest.md

@@ -0,0 +1,37 @@
+# Interface: IAppDatasetCreateRequest
+
+API request to register an app dataset.
+
+The owning `tenantId` is captured automatically from the request's tenant
+context — callers do not supply it.
+
+## Properties
+
+### body {#body}
+
+> **body**: `object`
+
+The body of the request.
+
+#### id?
+
+> `optional` **id?**: `string`
+
+Optional explicit id for the stored dataset record. If omitted, the
+Control Plane derives the id from `dataset["@id"]` if present, or
+generates a UUID otherwise. The resolved id is returned via the
+`Location` response header.
+
+#### appId
+
+> **appId**: `string`
+
+The dataspace app this dataset belongs to. Matches the app's
+registered name in `DataspaceAppFactory` (typically the app's URI).
+
+#### dataset
+
+> **dataset**: `IDataspaceProtocolDataset`
+
+The dataset payload. System-stamped fields like `dcterms:publisher`
+may be omitted — the Control Plane fills them in at publish time.