@twin.org/dataspace-app-runner 0.0.3-next.17 → 0.0.3-next.19

package/README.md

@@ -1,6 +1,8 @@
 # Dataspace App Runner
 
-Dataspace app runner task.
+This package runs dataspace app activity handlers in background execution contexts. It is intended for workloads where app logic should execute asynchronously while preserving runtime context and engine state.
+
+By isolating execution concerns, it helps services schedule and process activity workloads consistently.
 
 ## Installation
 

package/docs/changelog.md

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

package/docs/examples.md

@@ -1 +1,40 @@
-# @twin.org/dataspace-app-runner - Examples
+# App Runner Examples
+
+Use these snippets to run application logic in background workers while preserving context and engine state.
+
+## App Runner Functions
+
+```typescript
+import { appRunnerStart, appRunner, appRunnerEnd } from '@twin.org/dataspace-app-runner';
+import type { IExecutionPayload } from '@twin.org/dataspace-models';
+import type { IEngineCoreClone } from '@twin.org/engine-models';
+
+declare const engineCloneData: IEngineCoreClone;
+declare const payload: IExecutionPayload;
+
+await appRunnerStart(engineCloneData);
+const result = await appRunner(engineCloneData, payload);
+console.log(result); // 1234
+await appRunnerEnd();
+```
+
+```typescript
+import { appRunner } from '@twin.org/dataspace-app-runner';
+import type { IExecutionPayload } from '@twin.org/dataspace-models';
+import type { IEngineCoreClone } from '@twin.org/engine-models';
+
+declare const engineCloneData: IEngineCoreClone;
+
+const payload: IExecutionPayload = {
+  executorApp: 'https://twin.example.org/app1',
+  activityLogEntryId: 'urn:activity-log:001',
+  activity: {
+    '@context': 'https://www.w3.org/ns/activitystreams',
+    type: 'Create',
+    id: 'urn:activity:1'
+  }
+};
+
+const result = await appRunner(engineCloneData, payload);
+console.log(typeof result); // string
+```

package/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "@twin.org/dataspace-app-runner",
-	"version": "0.0.3-next.17",
-	"description": "Dataspace App Runner",
+	"version": "0.0.3-next.19",
+	"description": "Runs dataspace app activity handlers in background execution contexts.",
 	"repository": {
 		"type": "git",
 		"url": "git+https://github.com/twinfoundation/dataspace.git",
@@ -16,7 +16,7 @@
 	"dependencies": {
 		"@twin.org/context": "next",
 		"@twin.org/core": "next",
-		"@twin.org/dataspace-models": "0.0.3-next.17",
+		"@twin.org/dataspace-models": "0.0.3-next.19",
 		"@twin.org/engine-models": "next",
 		"@twin.org/logging-models": "next",
 		"@twin.org/nameof": "next",