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

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,19 @@
 # Changelog
 
+## [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/interfaces/ITestAppConstructorOptions.md

@@ -9,9 +9,3 @@ Test App Constructor options.
 > `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.19",
+	"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.19",
 		"@twin.org/engine-models": "next",
 		"@twin.org/engine-types": "next",
 		"@twin.org/logging-models": "next",