@twin.org/dataspace-test-app 0.0.3-next.18 → 0.0.3-next.20

package/README.md

@@ -1,6 +1,8 @@
 # Dataspace Test App
 
-Dataspace test app.
+This package provides a sample dataspace app for local integration tests and development workflows. It gives a practical baseline for dataset handling, activity processing, and data request execution.
+
+It is useful for validating service wiring and behaviour without building a custom app implementation first.
 
 ## Installation
 

package/docs/changelog.md

@@ -1,5 +1,33 @@
 # Changelog
 
+## [0.0.3-next.20](https://github.com/twinfoundation/dataspace/compare/dataspace-test-app-v0.0.3-next.19...dataspace-test-app-v0.0.3-next.20) (2026-03-17)
+
+
+### Miscellaneous Chores
+
+* **dataspace-test-app:** Synchronize repo versions
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/dataspace-models bumped from 0.0.3-next.19 to 0.0.3-next.20
+
+## [0.0.3-next.19](https://github.com/twinfoundation/dataspace/compare/dataspace-test-app-v0.0.3-next.18...dataspace-test-app-v0.0.3-next.19) (2026-03-12)
+
+
+### Miscellaneous Chores
+
+* **dataspace-test-app:** Synchronize repo versions
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/dataspace-models bumped from 0.0.3-next.18 to 0.0.3-next.19
+
 ## [0.0.3-next.18](https://github.com/twinfoundation/dataspace/compare/dataspace-test-app-v0.0.3-next.17...dataspace-test-app-v0.0.3-next.18) (2026-03-09)
 
 

package/docs/examples.md

@@ -1 +1,77 @@
-# @twin.org/dataspace-test-app - Examples
+# Test App Examples
+
+Use these snippets to prototype datasets, activity handling, and query responses in an application implementation.
+
+## TestDataspaceDataPlaneApp
+
+```typescript
+import { TestDataspaceDataPlaneApp } from '@twin.org/dataspace-test-app';
+
+const app = new TestDataspaceDataPlaneApp({ loggingComponentType: 'logging' });
+
+console.log(app.className()); // TestDataspaceDataPlaneApp
+await app.start();
+```
+
+```typescript
+import { TestDataspaceDataPlaneApp } from '@twin.org/dataspace-test-app';
+
+const app = new TestDataspaceDataPlaneApp();
+
+const datasets = await app.datasetsHandled();
+const supportedQueryTypes = app.supportedQueryTypes();
+const activities = app.activitiesHandled();
+
+console.log(datasets.length); // 1
+console.log(supportedQueryTypes[0]); // TestQueryType
+console.log(activities[0].objectType); // https://vocabulary.uncefact.org/Consignment
+```
+
+```typescript
+import { TestDataspaceDataPlaneApp } from '@twin.org/dataspace-test-app';
+import type { IDataspaceActivity } from '@twin.org/dataspace-models';
+
+const app = new TestDataspaceDataPlaneApp();
+
+const activity: IDataspaceActivity = {
+  '@context': 'https://www.w3.org/ns/activitystreams',
+  id: 'urn:activity:3001',
+  type: 'Create',
+  object: 'urn:ucr:24PLP051219453I002610799053311'
+};
+
+const activityResult = await app.handleActivity<string>(activity);
+console.log(activityResult); // 1234
+```
+
+```typescript
+import { DataRequestType, type IDataRequest } from '@twin.org/dataspace-models';
+import { TestDataspaceDataPlaneApp } from '@twin.org/dataspace-test-app';
+
+const app = new TestDataspaceDataPlaneApp();
+
+const entityRequest: IDataRequest = {
+  type: DataRequestType.DataAssetEntities,
+  entitySet: {
+    entityType: 'https://vocabulary.uncefact.org/Consignment',
+    entityId: ['urn:ucr:24PLP051219453I002610799053311']
+  }
+};
+
+const entityResponse = await app.handleDataRequest(entityRequest, undefined, 10);
+console.log(Array.isArray(entityResponse.data)); // false
+
+const queryRequest: IDataRequest = {
+  type: DataRequestType.QueryDataAsset,
+  query: {
+    query: {
+      destinationCountry: {
+        equals: 'unece:CountryId#GB'
+      }
+    }
+  }
+};
+
+const queryResponse = await app.handleDataRequest(queryRequest, undefined, 10);
+console.log(Array.isArray(queryResponse.data)); // true
+```

package/docs/reference/classes/TestDataspaceDataPlaneApp.md

@@ -28,7 +28,7 @@ The constructor options.
 
 ## Properties
 
-### APP\_ID
+### APP\_ID {#app_id}
 
 > `readonly` `static` **APP\_ID**: `"https://twin.example.org/app1"` = `"https://twin.example.org/app1"`
 
@@ -36,7 +36,7 @@ App Name.
 
 ***
 
-### CLASS\_NAME
+### CLASS\_NAME {#class_name}
 
 > `readonly` `static` **CLASS\_NAME**: `string`
 
@@ -44,7 +44,7 @@ Runtime name for the class.
 
 ## Methods
 
-### className()
+### className() {#classname}
 
 > **className**(): `string`
 
@@ -62,7 +62,7 @@ The class name of the component.
 
 ***
 
-### datasetsHandled()
+### datasetsHandled() {#datasetshandled}
 
 > **datasetsHandled**(): `Promise`\<`IDataspaceProtocolDataset`[]\>
 
@@ -80,7 +80,7 @@ Dataspace Protocol compliant datasets
 
 ***
 
-### supportedQueryTypes()
+### supportedQueryTypes() {#supportedquerytypes}
 
 > **supportedQueryTypes**(): `string`[]
 
@@ -98,7 +98,7 @@ Types.
 
 ***
 
-### start()
+### start() {#start}
 
 > **start**(`nodeLoggingComponentType?`): `Promise`\<`void`\>
 
@@ -122,7 +122,7 @@ the logging component type of such a node.
 
 ***
 
-### activitiesHandled()
+### activitiesHandled() {#activitieshandled}
 
 > **activitiesHandled**(): `IActivityQuery`[]
 
@@ -140,7 +140,7 @@ The activities handled by the App.
 
 ***
 
-### handleActivity()
+### handleActivity() {#handleactivity}
 
 > **handleActivity**\<`T`\>(`activity`): `Promise`\<`T`\>
 
@@ -172,7 +172,7 @@ Activity processing result
 
 ***
 
-### handleDataRequest()
+### handleDataRequest() {#handledatarequest}
 
 > **handleDataRequest**(`dataRequest`, `cursor?`, `limit?`): `Promise`\<\{ `data`: `IJsonLdDocument`; `cursor?`: `string`; \}\>
 

package/docs/reference/interfaces/ITestAppConstructorOptions.md

@@ -4,14 +4,8 @@ Test App Constructor options.
 
 ## Properties
 
-### loggingComponentType?
+### loggingComponentType? {#loggingcomponenttype}
 
 > `optional` **loggingComponentType**: `string`
 
 Logging component type.
-
-#### Default
-
-```ts
-logging
-```

package/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "@twin.org/dataspace-test-app",
-	"version": "0.0.3-next.18",
-	"description": "Dataspace Test App",
+	"version": "0.0.3-next.20",
+	"description": "Provides a sample dataspace app for local integration tests and development workflows.",
 	"repository": {
 		"type": "git",
 		"url": "git+https://github.com/twinfoundation/dataspace.git",
@@ -18,7 +18,7 @@
 		"@twin.org/context": "next",
 		"@twin.org/core": "next",
 		"@twin.org/data-core": "next",
-		"@twin.org/dataspace-models": "0.0.3-next.18",
+		"@twin.org/dataspace-models": "0.0.3-next.20",
 		"@twin.org/engine-models": "next",
 		"@twin.org/engine-types": "next",
 		"@twin.org/logging-models": "next",