@twin.org/dataspace-test-app 0.0.3-next.15

package/README.md

@@ -0,0 +1,21 @@
+# Dataspace Test App
+
+Dataspace test app.
+
+## Installation
+
+```shell
+npm install @twin.org/dataspace-test-app
+```
+
+## Examples
+
+Usage of the APIs is shown in the examples [docs/examples.md](docs/examples.md)
+
+## Reference
+
+Detailed reference documentation for the API can be found in [docs/reference/index.md](docs/reference/index.md)
+
+## Changelog
+
+The changes between each version can be found in [docs/changelog.md](docs/changelog.md)

package/dist/es/ITestAppConstructorOptions.js

@@ -0,0 +1,4 @@
+// Copyright 2025 IOTA Stiftung.
+// SPDX-License-Identifier: Apache-2.0.
+export {};
+//# sourceMappingURL=ITestAppConstructorOptions.js.map

package/dist/es/ITestAppConstructorOptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ITestAppConstructorOptions.js","sourceRoot":"","sources":["../../src/ITestAppConstructorOptions.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,uCAAuC","sourcesContent":["// Copyright 2025 IOTA Stiftung.\n// SPDX-License-Identifier: Apache-2.0.\n\n/**\n * Test App Constructor options.\n */\nexport interface ITestAppConstructorOptions {\n\t/**\n\t * Logging component type.\n\t * @default logging\n\t */\n\tloggingComponentType?: string;\n}\n"]}

package/dist/es/extension.js

@@ -0,0 +1,65 @@
+import { DataspaceAppFactory } from "@twin.org/dataspace-models";
+import { EngineTypeHelper } from "@twin.org/engine-types";
+import { TestDataspaceDataPlaneApp } from "./testDataspaceDataPlaneApp.js";
+/**
+ * Initialise the  extension.
+ * @param envVars The environment variables for the node.
+ * @param nodeEngineConfig The node engine config.
+ */
+export async function extensionInitialise(envVars, nodeEngineConfig) {
+    nodeEngineConfig.types.testAppComponent = [
+        {
+            type: "service",
+            options: {}
+        }
+    ];
+}
+/**
+ * Initialise the engine for the extension.
+ * @param engineCore The engine core instance.
+ */
+export async function extensionInitialiseEngine(engineCore) {
+    engineCore.addTypeInitialiser("testAppComponent", "@twin.org/dataspace-test-app", "testAppInitialiser");
+}
+/**
+ * Initialise the engine server for the extension.
+ * @param engineCore The engine core instance.
+ * @param engineServer The engine server instance.
+ */
+export async function extensionInitialiseEngineServer(engineCore, engineServer) {
+    engineServer.addRestRouteGenerator("testAppComponent", "@twin.org/dataspace-test-app", "generateRestRoutes");
+}
+/**
+ * Test Dataspace Data Plane App initializer.
+ * @param engineCore The engine core.
+ * @param context The context for the engine.
+ * @param instanceConfig The instance config.
+ * @param instanceConfig.options The instance config options.
+ * @param instanceConfig.type The instance type.
+ * @returns The instance created and the factory for it.
+ */
+export function testAppInitialiser(engineCore, context, instanceConfig) {
+    let instanceTypeName;
+    let createComponent;
+    if (instanceConfig.type === "service") {
+        createComponent = (createConfig) => new TestDataspaceDataPlaneApp(EngineTypeHelper.mergeConfig({
+            loggingComponentType: engineCore.getRegisteredInstanceType("loggingComponent")
+        }, createConfig.options));
+        instanceTypeName = TestDataspaceDataPlaneApp.APP_ID;
+    }
+    return {
+        instanceTypeName,
+        factory: DataspaceAppFactory,
+        createComponent: createComponent
+    };
+}
+/**
+ * Generate the rest routes for the component.
+ * @param baseRouteName The base route name.
+ * @param componentName The component name.
+ * @returns The rest routes.
+ */
+export function generateRestRoutes(baseRouteName, componentName) {
+    return [];
+}
+//# sourceMappingURL=extension.js.map

package/dist/es/extension.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension.js","sourceRoot":"","sources":["../../src/extension.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAQjE,OAAO,EAAsB,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE9E,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAE3E;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACxC,OAAiC,EACjC,gBAAmC;IAEnC,gBAAgB,CAAC,KAAK,CAAC,gBAAgB,GAAG;QACzC;YACC,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,EAAE;SACX;KACD,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAAC,UAAuB;IACtE,UAAU,CAAC,kBAAkB,CAC5B,kBAAkB,EAClB,8BAA8B,EAC9B,oBAAoB,CACpB,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,+BAA+B,CACpD,UAAuB,EACvB,YAA2B;IAE3B,YAAY,CAAC,qBAAqB,CACjC,kBAAkB,EAClB,8BAA8B,EAC9B,oBAAoB,CACpB,CAAC;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,kBAAkB,CACjC,UAAsC,EACtC,OAA2B,EAC3B,cAAwE;IAExE,IAAI,gBAAoC,CAAC;IACzC,IAAI,eAAe,CAAC;IAEpB,IAAI,cAAc,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QACvC,eAAe,GAAG,CAAC,YAAmC,EAAE,EAAE,CACzD,IAAI,yBAAyB,CAC5B,gBAAgB,CAAC,WAAW,CAC3B;YACC,oBAAoB,EAAE,UAAU,CAAC,yBAAyB,CAAC,kBAAkB,CAAC;SAC9E,EACD,YAAY,CAAC,OAAO,CACpB,CACD,CAAC;QACH,gBAAgB,GAAG,yBAAyB,CAAC,MAAM,CAAC;IACrD,CAAC;IAED,OAAO;QACN,gBAAgB;QAChB,OAAO,EAAE,mBAAmB;QAC5B,eAAe,EAAE,eAAsE;KACvF,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,aAAqB,EAAE,aAAqB;IAC9E,OAAO,EAAE,CAAC;AACX,CAAC","sourcesContent":["// Copyright 2025 IOTA Stiftung.\n// SPDX-License-Identifier: Apache-2.0.\nimport type { IRestRoute } from \"@twin.org/api-models\";\nimport type { IComponent } from \"@twin.org/core\";\nimport { DataspaceAppFactory } from \"@twin.org/dataspace-models\";\nimport type {\n\tEngineTypeInitialiserReturn,\n\tIEngineCore,\n\tIEngineCoreConfig,\n\tIEngineCoreContext,\n\tIEngineServer\n} from \"@twin.org/engine-models\";\nimport { type IEngineConfig, EngineTypeHelper } from \"@twin.org/engine-types\";\nimport type { ITestAppConstructorOptions } from \"./ITestAppConstructorOptions.js\";\nimport { TestDataspaceDataPlaneApp } from \"./testDataspaceDataPlaneApp.js\";\n\n/**\n * Initialise the  extension.\n * @param envVars The environment variables for the node.\n * @param nodeEngineConfig The node engine config.\n */\nexport async function extensionInitialise(\n\tenvVars: { [id: string]: string },\n\tnodeEngineConfig: IEngineCoreConfig\n): Promise<void> {\n\tnodeEngineConfig.types.testAppComponent = [\n\t\t{\n\t\t\ttype: \"service\",\n\t\t\toptions: {}\n\t\t}\n\t];\n}\n\n/**\n * Initialise the engine for the extension.\n * @param engineCore The engine core instance.\n */\nexport async function extensionInitialiseEngine(engineCore: IEngineCore): Promise<void> {\n\tengineCore.addTypeInitialiser(\n\t\t\"testAppComponent\",\n\t\t\"@twin.org/dataspace-test-app\",\n\t\t\"testAppInitialiser\"\n\t);\n}\n\n/**\n * Initialise the engine server for the extension.\n * @param engineCore The engine core instance.\n * @param engineServer The engine server instance.\n */\nexport async function extensionInitialiseEngineServer(\n\tengineCore: IEngineCore,\n\tengineServer: IEngineServer\n): Promise<void> {\n\tengineServer.addRestRouteGenerator(\n\t\t\"testAppComponent\",\n\t\t\"@twin.org/dataspace-test-app\",\n\t\t\"generateRestRoutes\"\n\t);\n}\n\n/**\n * Test Dataspace Data Plane App initializer.\n * @param engineCore The engine core.\n * @param context The context for the engine.\n * @param instanceConfig The instance config.\n * @param instanceConfig.options The instance config options.\n * @param instanceConfig.type The instance type.\n * @returns The instance created and the factory for it.\n */\nexport function testAppInitialiser(\n\tengineCore: IEngineCore<IEngineConfig>,\n\tcontext: IEngineCoreContext,\n\tinstanceConfig: { type: \"service\"; options: ITestAppConstructorOptions }\n): EngineTypeInitialiserReturn<typeof instanceConfig, typeof DataspaceAppFactory> {\n\tlet instanceTypeName: string | undefined;\n\tlet createComponent;\n\n\tif (instanceConfig.type === \"service\") {\n\t\tcreateComponent = (createConfig: typeof instanceConfig) =>\n\t\t\tnew TestDataspaceDataPlaneApp(\n\t\t\t\tEngineTypeHelper.mergeConfig<ITestAppConstructorOptions>(\n\t\t\t\t\t{\n\t\t\t\t\t\tloggingComponentType: engineCore.getRegisteredInstanceType(\"loggingComponent\")\n\t\t\t\t\t},\n\t\t\t\t\tcreateConfig.options\n\t\t\t\t)\n\t\t\t);\n\t\tinstanceTypeName = TestDataspaceDataPlaneApp.APP_ID;\n\t}\n\n\treturn {\n\t\tinstanceTypeName,\n\t\tfactory: DataspaceAppFactory,\n\t\tcreateComponent: createComponent as (createConfig: typeof instanceConfig) => IComponent\n\t};\n}\n\n/**\n * Generate the rest routes for the component.\n * @param baseRouteName The base route name.\n * @param componentName The component name.\n * @returns The rest routes.\n */\nexport function generateRestRoutes(baseRouteName: string, componentName: string): IRestRoute[] {\n\treturn [];\n}\n"]}

package/dist/es/index.js

@@ -0,0 +1,6 @@
+// Copyright 2025 IOTA Stiftung.
+// SPDX-License-Identifier: Apache-2.0.
+export * from "./extension.js";
+export * from "./ITestAppConstructorOptions.js";
+export * from "./testDataspaceDataPlaneApp.js";
+//# sourceMappingURL=index.js.map

package/dist/es/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,uCAAuC;AACvC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iCAAiC,CAAC;AAChD,cAAc,gCAAgC,CAAC","sourcesContent":["// Copyright 2025 IOTA Stiftung.\n// SPDX-License-Identifier: Apache-2.0.\nexport * from \"./extension.js\";\nexport * from \"./ITestAppConstructorOptions.js\";\nexport * from \"./testDataspaceDataPlaneApp.js\";\n"]}

package/dist/es/testDataspaceDataPlaneApp.js

@@ -0,0 +1,191 @@
+// Copyright 2025 IOTA Stiftung.
+// SPDX-License-Identifier: Apache-2.0.
+import { ContextIdHelper, ContextIdKeys, ContextIdStore } from "@twin.org/context";
+import { ComponentFactory, Guards } from "@twin.org/core";
+import { DataTypeHandlerFactory } from "@twin.org/data-core";
+import { DataRequestType } from "@twin.org/dataspace-models";
+import { DataspaceProtocolContexts } from "@twin.org/standards-dataspace-protocol";
+import { DublinCoreContexts } from "@twin.org/standards-dublin-core";
+// Dummy Data
+const id = "urn:ucr:24PLP051219453I002610799053311";
+const entities = [
+    {
+        "@context": "https://vocabulary.uncefact.org/unece-context-D23B.jsonld",
+        type: "Consignment",
+        id,
+        destinationCountry: {
+            type: "Country",
+            countryId: "unece:CountryId#GB"
+        }
+    },
+    {
+        "@context": "https://vocabulary.uncefact.org/unece-context-D23B.jsonld",
+        type: "Document",
+        id: "urn:document:a3456fddaa56",
+        documentTypeCode: "unece:DocumentCodeList#853"
+    }
+];
+/**
+ * Test App Activity Handler.
+ */
+export class TestDataspaceDataPlaneApp {
+    /**
+     * App Name.
+     */
+    static APP_ID = "https://twin.example.org/app1";
+    /**
+     * Runtime name for the class.
+     */
+    static CLASS_NAME = "TestDataspaceDataPlaneApp";
+    /**
+     * Logging component.
+     * @internal
+     */
+    _logging;
+    /**
+     * Node Identity
+     * @internal
+     */
+    _nodeId;
+    /**
+     * Create a new instance of TestDataspaceDataPlaneApp.
+     * @param options The constructor options.
+     */
+    constructor(options) {
+        this._logging = ComponentFactory.getIfExists(options?.loggingComponentType ?? "logging");
+    }
+    /**
+     * Returns the class name of the component.
+     * @returns The class name of the component.
+     */
+    className() {
+        return TestDataspaceDataPlaneApp.CLASS_NAME;
+    }
+    /**
+     * Datasets handled by the App.
+     * @returns Dataspace Protocol compliant datasets
+     */
+    async datasetsHandled() {
+        const contextIds = await ContextIdStore.getContextIds();
+        const organizationId = contextIds?.[ContextIdKeys.Organization] ?? contextIds?.[ContextIdKeys.Node] ?? "";
+        return [
+            {
+                "@context": [
+                    DataspaceProtocolContexts.Context,
+                    {
+                        dcterms: DublinCoreContexts.NamespaceTerms
+                    }
+                ],
+                "@id": "https://twin.example.org/data-service-1",
+                "@type": "Dataset",
+                "dcterms:publisher": organizationId,
+                hasPolicy: [
+                    {
+                        "@type": "Offer",
+                        uid: "urn:uuid:test-policy-offer-1",
+                        assigner: organizationId,
+                        permission: [
+                            {
+                                action: "read"
+                            }
+                        ]
+                    }
+                ],
+                distribution: {
+                    "@id": "https://twin.example.org/distribution-1",
+                    "@type": "Distribution",
+                    accessService: "https://twin.example.org/data-service-1",
+                    format: "Http-Pull-Query-Format"
+                },
+                "dcterms:type": "https://vocabulary.uncefact.org/Consignment"
+            }
+        ];
+    }
+    /**
+     * Supported query types.
+     * @returns Types.
+     */
+    supportedQueryTypes() {
+        return ["TestQueryType"];
+    }
+    /**
+     * Start method.
+     * @param nodeLoggingComponentType the logging component type of such a node.
+     */
+    async start(nodeLoggingComponentType) {
+        const contextIds = await ContextIdStore.getContextIds();
+        ContextIdHelper.guard(contextIds, ContextIdKeys.Node);
+        this._nodeId = contextIds[ContextIdKeys.Node];
+        DataTypeHandlerFactory.register("https://twin.example.org/MyCreate", () => ({
+            namespace: "https://twin.example.org/",
+            type: "MyCreate",
+            defaultValue: {},
+            jsonSchema: async () => ({
+                type: "object"
+            })
+        }));
+        DataTypeHandlerFactory.register("https://vocabulary.uncefact.org/Consignment", () => ({
+            namespace: "https://vocabulary.uncefact.org/",
+            type: "Consignment",
+            defaultValue: {},
+            jsonSchema: async () => ({
+                type: "object"
+            })
+        }));
+    }
+    /**
+     * The activities handled by the App.
+     * @returns The activities handled by the App.
+     */
+    activitiesHandled() {
+        return [{ objectType: "https://vocabulary.uncefact.org/Consignment" }];
+    }
+    /**
+     * Handle Activity.
+     * @param activity Activity
+     * @returns Activity processing result
+     */
+    async handleActivity(activity) {
+        Guards.object(TestDataspaceDataPlaneApp.CLASS_NAME, "activity", activity);
+        await this._logging?.log({
+            level: "info",
+            source: TestDataspaceDataPlaneApp.CLASS_NAME,
+            message: `App Called: ${TestDataspaceDataPlaneApp.APP_ID}`
+        });
+        await this._logging?.log({
+            level: "info",
+            source: TestDataspaceDataPlaneApp.CLASS_NAME,
+            message: `Node Identity: ${this._nodeId ?? ""}`
+        });
+        await new Promise(resolve => setTimeout(resolve, 500));
+        return "1234";
+    }
+    /**
+     * Handles the Data Request.
+     * @param dataRequest The data request
+     * @param cursor Cursor that points to the next item in the result set.
+     * @param limit Maximum number of entries retrieved or to be retrieved.
+     * @returns the Data.
+     */
+    async handleDataRequest(dataRequest, cursor, limit) {
+        Guards.object(TestDataspaceDataPlaneApp.CLASS_NAME, "dataRequest", dataRequest);
+        switch (dataRequest.type) {
+            case DataRequestType.DataAssetEntities: {
+                if (dataRequest.entitySet.entityType === "https://vocabulary.uncefact.org/Consignment") {
+                    return {
+                        data: [entities[0]]
+                    };
+                }
+                if (dataRequest.entitySet.entityId?.includes(id)) {
+                    return {
+                        data: entities[0]
+                    };
+                }
+                return { data: [] };
+            }
+            case DataRequestType.QueryDataAsset:
+                return { data: entities };
+        }
+    }
+}
+//# sourceMappingURL=testDataspaceDataPlaneApp.js.map

package/dist/es/testDataspaceDataPlaneApp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"testDataspaceDataPlaneApp.js","sourceRoot":"","sources":["../../src/testDataspaceDataPlaneApp.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright 2025 IOTA Stiftung.\n// SPDX-License-Identifier: Apache-2.0.\nimport { ContextIdHelper, ContextIdKeys, ContextIdStore } from \"@twin.org/context\";\nimport { ComponentFactory, Guards } from \"@twin.org/core\";\nimport { DataTypeHandlerFactory } from \"@twin.org/data-core\";\nimport type { IJsonLdDocument } from \"@twin.org/data-json-ld\";\nimport {\n\tDataRequestType,\n\ttype IActivityQuery,\n\ttype IDataRequest,\n\ttype IDataspaceApp\n} from \"@twin.org/dataspace-models\";\nimport type { ILoggingComponent } from \"@twin.org/logging-models\";\nimport { nameof } from \"@twin.org/nameof\";\nimport {\n\tDataspaceProtocolContexts,\n\ttype IDataspaceProtocolDataset\n} from \"@twin.org/standards-dataspace-protocol\";\nimport { DublinCoreContexts } from \"@twin.org/standards-dublin-core\";\nimport type { IActivityStreamsActivity } from \"@twin.org/standards-w3c-activity-streams\";\nimport type { ITestAppConstructorOptions } from \"./ITestAppConstructorOptions.js\";\n\n// Dummy Data\nconst id = \"urn:ucr:24PLP051219453I002610799053311\";\nconst entities = [\n\t{\n\t\t\"@context\": \"https://vocabulary.uncefact.org/unece-context-D23B.jsonld\",\n\t\ttype: \"Consignment\",\n\t\tid,\n\t\tdestinationCountry: {\n\t\t\ttype: \"Country\",\n\t\t\tcountryId: \"unece:CountryId#GB\"\n\t\t}\n\t},\n\t{\n\t\t\"@context\": \"https://vocabulary.uncefact.org/unece-context-D23B.jsonld\",\n\t\ttype: \"Document\",\n\t\tid: \"urn:document:a3456fddaa56\",\n\t\tdocumentTypeCode: \"unece:DocumentCodeList#853\"\n\t}\n];\n\n/**\n * Test App Activity Handler.\n */\nexport class TestDataspaceDataPlaneApp implements IDataspaceApp {\n\t/**\n\t * App Name.\n\t */\n\tpublic static readonly APP_ID = \"https://twin.example.org/app1\";\n\n\t/**\n\t * Runtime name for the class.\n\t */\n\tpublic static readonly CLASS_NAME: string = nameof<TestDataspaceDataPlaneApp>();\n\n\t/**\n\t * Logging component.\n\t * @internal\n\t */\n\tprivate readonly _logging?: ILoggingComponent;\n\n\t/**\n\t * Node Identity\n\t * @internal\n\t */\n\tprivate _nodeId?: string;\n\n\t/**\n\t * Create a new instance of TestDataspaceDataPlaneApp.\n\t * @param options The constructor options.\n\t */\n\tconstructor(options?: ITestAppConstructorOptions) {\n\t\tthis._logging = ComponentFactory.getIfExists<ILoggingComponent>(\n\t\t\toptions?.loggingComponentType ?? \"logging\"\n\t\t);\n\t}\n\n\t/**\n\t * Returns the class name of the component.\n\t * @returns The class name of the component.\n\t */\n\tpublic className(): string {\n\t\treturn TestDataspaceDataPlaneApp.CLASS_NAME;\n\t}\n\n\t/**\n\t * Datasets handled by the App.\n\t * @returns Dataspace Protocol compliant datasets\n\t */\n\tpublic async datasetsHandled(): Promise<IDataspaceProtocolDataset[]> {\n\t\tconst contextIds = await ContextIdStore.getContextIds();\n\t\tconst organizationId =\n\t\t\tcontextIds?.[ContextIdKeys.Organization] ?? contextIds?.[ContextIdKeys.Node] ?? \"\";\n\t\treturn [\n\t\t\t{\n\t\t\t\t\"@context\": [\n\t\t\t\t\tDataspaceProtocolContexts.Context,\n\t\t\t\t\t{\n\t\t\t\t\t\tdcterms: DublinCoreContexts.NamespaceTerms\n\t\t\t\t\t}\n\t\t\t\t],\n\t\t\t\t\"@id\": \"https://twin.example.org/data-service-1\",\n\t\t\t\t\"@type\": \"Dataset\",\n\t\t\t\t\"dcterms:publisher\": organizationId,\n\t\t\t\thasPolicy: [\n\t\t\t\t\t{\n\t\t\t\t\t\t\"@type\": \"Offer\",\n\t\t\t\t\t\tuid: \"urn:uuid:test-policy-offer-1\",\n\t\t\t\t\t\tassigner: organizationId,\n\t\t\t\t\t\tpermission: [\n\t\t\t\t\t\t\t{\n\t\t\t\t\t\t\t\taction: \"read\"\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t]\n\t\t\t\t\t}\n\t\t\t\t],\n\t\t\t\tdistribution: {\n\t\t\t\t\t\"@id\": \"https://twin.example.org/distribution-1\",\n\t\t\t\t\t\"@type\": \"Distribution\",\n\t\t\t\t\taccessService: \"https://twin.example.org/data-service-1\",\n\t\t\t\t\tformat: \"Http-Pull-Query-Format\"\n\t\t\t\t},\n\t\t\t\t\"dcterms:type\": \"https://vocabulary.uncefact.org/Consignment\"\n\t\t\t}\n\t\t];\n\t}\n\n\t/**\n\t * Supported query types.\n\t * @returns Types.\n\t */\n\tpublic supportedQueryTypes(): string[] {\n\t\treturn [\"TestQueryType\"];\n\t}\n\n\t/**\n\t * Start method.\n\t * @param nodeLoggingComponentType the logging component type of such a node.\n\t */\n\tpublic async start(nodeLoggingComponentType?: string): Promise<void> {\n\t\tconst contextIds = await ContextIdStore.getContextIds();\n\t\tContextIdHelper.guard(contextIds, ContextIdKeys.Node);\n\t\tthis._nodeId = contextIds[ContextIdKeys.Node];\n\n\t\tDataTypeHandlerFactory.register(\"https://twin.example.org/MyCreate\", () => ({\n\t\t\tnamespace: \"https://twin.example.org/\",\n\t\t\ttype: \"MyCreate\",\n\t\t\tdefaultValue: {},\n\t\t\tjsonSchema: async () => ({\n\t\t\t\ttype: \"object\"\n\t\t\t})\n\t\t}));\n\n\t\tDataTypeHandlerFactory.register(\"https://vocabulary.uncefact.org/Consignment\", () => ({\n\t\t\tnamespace: \"https://vocabulary.uncefact.org/\",\n\t\t\ttype: \"Consignment\",\n\t\t\tdefaultValue: {},\n\t\t\tjsonSchema: async () => ({\n\t\t\t\ttype: \"object\"\n\t\t\t})\n\t\t}));\n\t}\n\n\t/**\n\t * The activities handled by the App.\n\t * @returns The activities handled by the App.\n\t */\n\tpublic activitiesHandled(): IActivityQuery[] {\n\t\treturn [{ objectType: \"https://vocabulary.uncefact.org/Consignment\" }];\n\t}\n\n\t/**\n\t * Handle Activity.\n\t * @param activity Activity\n\t * @returns Activity processing result\n\t */\n\tpublic async handleActivity<T>(activity: IActivityStreamsActivity): Promise<T> {\n\t\tGuards.object<IActivityStreamsActivity>(\n\t\t\tTestDataspaceDataPlaneApp.CLASS_NAME,\n\t\t\tnameof(activity),\n\t\t\tactivity\n\t\t);\n\n\t\tawait this._logging?.log({\n\t\t\tlevel: \"info\",\n\t\t\tsource: TestDataspaceDataPlaneApp.CLASS_NAME,\n\t\t\tmessage: `App Called: ${TestDataspaceDataPlaneApp.APP_ID}`\n\t\t});\n\n\t\tawait this._logging?.log({\n\t\t\tlevel: \"info\",\n\t\t\tsource: TestDataspaceDataPlaneApp.CLASS_NAME,\n\t\t\tmessage: `Node Identity: ${this._nodeId ?? \"\"}`\n\t\t});\n\n\t\tawait new Promise(resolve => setTimeout(resolve, 500));\n\t\treturn \"1234\" as T;\n\t}\n\n\t/**\n\t * Handles the Data Request.\n\t * @param dataRequest The data request\n\t * @param cursor Cursor that points to the next item in the result set.\n\t * @param limit Maximum number of entries retrieved or to be retrieved.\n\t * @returns the Data.\n\t */\n\tpublic async handleDataRequest(\n\t\tdataRequest: IDataRequest,\n\t\tcursor?: string,\n\t\tlimit?: number\n\t): Promise<{ data: IJsonLdDocument; cursor?: string }> {\n\t\tGuards.object<IDataRequest>(\n\t\t\tTestDataspaceDataPlaneApp.CLASS_NAME,\n\t\t\tnameof(dataRequest),\n\t\t\tdataRequest\n\t\t);\n\n\t\tswitch (dataRequest.type) {\n\t\t\tcase DataRequestType.DataAssetEntities: {\n\t\t\t\tif (dataRequest.entitySet.entityType === \"https://vocabulary.uncefact.org/Consignment\") {\n\t\t\t\t\treturn {\n\t\t\t\t\t\tdata: [entities[0]]\n\t\t\t\t\t};\n\t\t\t\t}\n\n\t\t\t\tif (dataRequest.entitySet.entityId?.includes(id)) {\n\t\t\t\t\treturn {\n\t\t\t\t\t\tdata: entities[0]\n\t\t\t\t\t};\n\t\t\t\t}\n\t\t\t\treturn { data: [] };\n\t\t\t}\n\n\t\t\tcase DataRequestType.QueryDataAsset:\n\t\t\t\treturn { data: entities };\n\t\t}\n\t}\n}\n"]}

package/dist/types/ITestAppConstructorOptions.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Test App Constructor options.
+ */
+export interface ITestAppConstructorOptions {
+    /**
+     * Logging component type.
+     * @default logging
+     */
+    loggingComponentType?: string;
+}

package/dist/types/extension.d.ts

@@ -0,0 +1,44 @@
+import type { IRestRoute } from "@twin.org/api-models";
+import { DataspaceAppFactory } from "@twin.org/dataspace-models";
+import type { EngineTypeInitialiserReturn, IEngineCore, IEngineCoreConfig, IEngineCoreContext, IEngineServer } from "@twin.org/engine-models";
+import { type IEngineConfig } from "@twin.org/engine-types";
+import type { ITestAppConstructorOptions } from "./ITestAppConstructorOptions.js";
+/**
+ * Initialise the  extension.
+ * @param envVars The environment variables for the node.
+ * @param nodeEngineConfig The node engine config.
+ */
+export declare function extensionInitialise(envVars: {
+    [id: string]: string;
+}, nodeEngineConfig: IEngineCoreConfig): Promise<void>;
+/**
+ * Initialise the engine for the extension.
+ * @param engineCore The engine core instance.
+ */
+export declare function extensionInitialiseEngine(engineCore: IEngineCore): Promise<void>;
+/**
+ * Initialise the engine server for the extension.
+ * @param engineCore The engine core instance.
+ * @param engineServer The engine server instance.
+ */
+export declare function extensionInitialiseEngineServer(engineCore: IEngineCore, engineServer: IEngineServer): Promise<void>;
+/**
+ * Test Dataspace Data Plane App initializer.
+ * @param engineCore The engine core.
+ * @param context The context for the engine.
+ * @param instanceConfig The instance config.
+ * @param instanceConfig.options The instance config options.
+ * @param instanceConfig.type The instance type.
+ * @returns The instance created and the factory for it.
+ */
+export declare function testAppInitialiser(engineCore: IEngineCore<IEngineConfig>, context: IEngineCoreContext, instanceConfig: {
+    type: "service";
+    options: ITestAppConstructorOptions;
+}): EngineTypeInitialiserReturn<typeof instanceConfig, typeof DataspaceAppFactory>;
+/**
+ * Generate the rest routes for the component.
+ * @param baseRouteName The base route name.
+ * @param componentName The component name.
+ * @returns The rest routes.
+ */
+export declare function generateRestRoutes(baseRouteName: string, componentName: string): IRestRoute[];

package/dist/types/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./extension.js";
+export * from "./ITestAppConstructorOptions.js";
+export * from "./testDataspaceDataPlaneApp.js";

package/dist/types/testDataspaceDataPlaneApp.d.ts

@@ -0,0 +1,65 @@
+import type { IJsonLdDocument } from "@twin.org/data-json-ld";
+import { type IActivityQuery, type IDataRequest, type IDataspaceApp } from "@twin.org/dataspace-models";
+import { type IDataspaceProtocolDataset } from "@twin.org/standards-dataspace-protocol";
+import type { IActivityStreamsActivity } from "@twin.org/standards-w3c-activity-streams";
+import type { ITestAppConstructorOptions } from "./ITestAppConstructorOptions.js";
+/**
+ * Test App Activity Handler.
+ */
+export declare class TestDataspaceDataPlaneApp implements IDataspaceApp {
+    /**
+     * App Name.
+     */
+    static readonly APP_ID = "https://twin.example.org/app1";
+    /**
+     * Runtime name for the class.
+     */
+    static readonly CLASS_NAME: string;
+    /**
+     * Create a new instance of TestDataspaceDataPlaneApp.
+     * @param options The constructor options.
+     */
+    constructor(options?: ITestAppConstructorOptions);
+    /**
+     * Returns the class name of the component.
+     * @returns The class name of the component.
+     */
+    className(): string;
+    /**
+     * Datasets handled by the App.
+     * @returns Dataspace Protocol compliant datasets
+     */
+    datasetsHandled(): Promise<IDataspaceProtocolDataset[]>;
+    /**
+     * Supported query types.
+     * @returns Types.
+     */
+    supportedQueryTypes(): string[];
+    /**
+     * Start method.
+     * @param nodeLoggingComponentType the logging component type of such a node.
+     */
+    start(nodeLoggingComponentType?: string): Promise<void>;
+    /**
+     * The activities handled by the App.
+     * @returns The activities handled by the App.
+     */
+    activitiesHandled(): IActivityQuery[];
+    /**
+     * Handle Activity.
+     * @param activity Activity
+     * @returns Activity processing result
+     */
+    handleActivity<T>(activity: IActivityStreamsActivity): Promise<T>;
+    /**
+     * Handles the Data Request.
+     * @param dataRequest The data request
+     * @param cursor Cursor that points to the next item in the result set.
+     * @param limit Maximum number of entries retrieved or to be retrieved.
+     * @returns the Data.
+     */
+    handleDataRequest(dataRequest: IDataRequest, cursor?: string, limit?: number): Promise<{
+        data: IJsonLdDocument;
+        cursor?: string;
+    }>;
+}

package/docs/changelog.md

@@ -0,0 +1,274 @@
+# Changelog
+
+## [0.0.3-next.15](https://github.com/twinfoundation/dataspace/compare/dataspace-test-app-v0.0.3-next.14...dataspace-test-app-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))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/dataspace-models bumped from 0.0.3-next.14 to 0.0.3-next.15
+
+## [0.0.3-next.12](https://github.com/twinfoundation/dataspace/compare/dataspace-test-app-v0.0.3-next.11...dataspace-test-app-v0.0.3-next.12) (2026-01-22)
+
+
+### 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.11 to 0.0.3-next.12
+
+## [0.0.3-next.11](https://github.com/twinfoundation/dataspace/compare/dataspace-test-app-v0.0.3-next.10...dataspace-test-app-v0.0.3-next.11) (2026-01-22)
+
+
+### Features
+
+* update contexts ([1c9a169](https://github.com/twinfoundation/dataspace/commit/1c9a169ebc44af59df890eb29dd5cb4274940ebe))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/dataspace-models bumped from 0.0.3-next.10 to 0.0.3-next.11
+
+## [0.0.3-next.10](https://github.com/twinfoundation/dataspace/compare/dataspace-test-app-v0.0.3-next.9...dataspace-test-app-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))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/dataspace-models bumped from 0.0.3-next.9 to 0.0.3-next.10
+
+## [0.0.3-next.9](https://github.com/twinfoundation/dataspace/compare/dataspace-test-app-v0.0.3-next.8...dataspace-test-app-v0.0.3-next.9) (2026-01-19)
+
+
+### 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.8 to 0.0.3-next.9
+
+## [0.0.3-next.8](https://github.com/twinfoundation/dataspace/compare/dataspace-test-app-v0.0.3-next.7...dataspace-test-app-v0.0.3-next.8) (2026-01-16)
+
+
+### 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.7 to 0.0.3-next.8
+
+## [0.0.3-next.7](https://github.com/twinfoundation/dataspace/compare/dataspace-test-app-v0.0.3-next.6...dataspace-test-app-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))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/dataspace-models bumped from 0.0.3-next.6 to 0.0.3-next.7
+
+## [0.0.3-next.6](https://github.com/twinfoundation/dataspace/compare/dataspace-test-app-v0.0.3-next.5...dataspace-test-app-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))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/dataspace-models bumped from 0.0.3-next.5 to 0.0.3-next.6
+
+## [0.0.3-next.5](https://github.com/twinfoundation/dataspace/compare/dataspace-test-app-v0.0.3-next.4...dataspace-test-app-v0.0.3-next.5) (2026-01-07)
+
+
+### 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.4 to 0.0.3-next.5
+
+## [0.0.3-next.4](https://github.com/twinfoundation/dataspace/compare/dataspace-test-app-v0.0.3-next.3...dataspace-test-app-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))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/dataspace-models bumped from 0.0.3-next.3 to 0.0.3-next.4
+
+## [0.0.3-next.3](https://github.com/twinfoundation/dataspace/compare/dataspace-test-app-v0.0.3-next.2...dataspace-test-app-v0.0.3-next.3) (2025-12-01)
+
+
+### 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.2 to 0.0.3-next.3
+
+## [0.0.3-next.2](https://github.com/twinfoundation/dataspace/compare/dataspace-test-app-v0.0.3-next.1...dataspace-test-app-v0.0.3-next.2) (2025-11-28)
+
+
+### 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.1 to 0.0.3-next.2
+
+## [0.0.3-next.1](https://github.com/twinfoundation/dataspace/compare/dataspace-test-app-v0.0.3-next.0...dataspace-test-app-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))
+* 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))
+* use new start signature ([4064d19](https://github.com/twinfoundation/dataspace/commit/4064d19676b183e7162e667a701a24c4b1f48504))
+
+
+### Bug Fixes
+
+* the Dataspace Connector App receives Node Identity ([#14](https://github.com/twinfoundation/dataspace/issues/14)) ([a71ad44](https://github.com/twinfoundation/dataspace/commit/a71ad44539d9c2b55e13d865af58eeb9eb14e4ea))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/dataspace-models bumped from 0.0.3-next.0 to 0.0.3-next.1
+
+## [0.0.1-next.8](https://github.com/twinfoundation/dataspace/compare/dataspace-test-app-v0.0.1-next.7...dataspace-test-app-v0.0.1-next.8) (2025-10-09)
+
+
+### Features
+
+* add validate-locales ([c0b08a7](https://github.com/twinfoundation/dataspace/commit/c0b08a73268f9fd3eb6ac3079b49d1ab0c01f118))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/dataspace-models bumped from 0.0.1-next.7 to 0.0.1-next.8
+
+## [0.0.1-next.7](https://github.com/twinfoundation/dataspace/compare/dataspace-test-app-v0.0.1-next.6...dataspace-test-app-v0.0.1-next.7) (2025-10-02)
+
+
+### Features
+
+* use new engine extensions config ([80bdb5b](https://github.com/twinfoundation/dataspace/commit/80bdb5b298b65b5b22fa9927a0ad031cb9a3534d))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/dataspace-models bumped from 0.0.1-next.6 to 0.0.1-next.7
+
+## [0.0.1-next.6](https://github.com/twinfoundation/dataspace/compare/dataspace-test-app-v0.0.1-next.5...dataspace-test-app-v0.0.1-next.6) (2025-09-29)
+
+
+### Features
+
+* use new start signature ([4064d19](https://github.com/twinfoundation/dataspace/commit/4064d19676b183e7162e667a701a24c4b1f48504))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/dataspace-models bumped from 0.0.1-next.5 to 0.0.1-next.6
+
+## [0.0.1-next.5](https://github.com/twinfoundation/dataspace/compare/dataspace-test-app-v0.0.1-next.4...dataspace-test-app-v0.0.1-next.5) (2025-09-29)
+
+
+### Features
+
+* update framework components ([4d9ca95](https://github.com/twinfoundation/dataspace/commit/4d9ca95879bd6cae9d031595292b6a872bf5b5fd))
+
+
+### Bug Fixes
+
+* the Dataspace Connector App receives Node Identity ([#14](https://github.com/twinfoundation/dataspace/issues/14)) ([a71ad44](https://github.com/twinfoundation/dataspace/commit/a71ad44539d9c2b55e13d865af58eeb9eb14e4ea))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/dataspace-models bumped from 0.0.1-next.4 to 0.0.1-next.5
+
+## [0.0.1-next.4](https://github.com/twinfoundation/dataspace/compare/dataspace-test-app-v0.0.1-next.3...dataspace-test-app-v0.0.1-next.4) (2025-08-29)
+
+
+### Features
+
+* eslint migration to flat config ([b84e875](https://github.com/twinfoundation/dataspace/commit/b84e87530aa249891618096ab6e072b21ff9f63a))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/dataspace-models bumped from 0.0.1-next.3 to 0.0.1-next.4
+
+## Changelog

package/docs/examples.md

@@ -0,0 +1 @@
+# @twin.org/dataspace-test-app - Examples

package/docs/reference/classes/TestDataspaceDataPlaneApp.md

@@ -0,0 +1,209 @@
+# Class: TestDataspaceDataPlaneApp
+
+Test App Activity Handler.
+
+## Implements
+
+- `IDataspaceApp`
+
+## Constructors
+
+### Constructor
+
+> **new TestDataspaceDataPlaneApp**(`options?`): `TestDataspaceDataPlaneApp`
+
+Create a new instance of TestDataspaceDataPlaneApp.
+
+#### Parameters
+
+##### options?
+
+[`ITestAppConstructorOptions`](../interfaces/ITestAppConstructorOptions.md)
+
+The constructor options.
+
+#### Returns
+
+`TestDataspaceDataPlaneApp`
+
+## Properties
+
+### APP\_ID
+
+> `readonly` `static` **APP\_ID**: `"https://twin.example.org/app1"` = `"https://twin.example.org/app1"`
+
+App Name.
+
+***
+
+### CLASS\_NAME
+
+> `readonly` `static` **CLASS\_NAME**: `string`
+
+Runtime name for the class.
+
+## Methods
+
+### className()
+
+> **className**(): `string`
+
+Returns the class name of the component.
+
+#### Returns
+
+`string`
+
+The class name of the component.
+
+#### Implementation of
+
+`IDataspaceApp.className`
+
+***
+
+### datasetsHandled()
+
+> **datasetsHandled**(): `Promise`\<`IDataspaceProtocolDataset`[]\>
+
+Datasets handled by the App.
+
+#### Returns
+
+`Promise`\<`IDataspaceProtocolDataset`[]\>
+
+Dataspace Protocol compliant datasets
+
+#### Implementation of
+
+`IDataspaceApp.datasetsHandled`
+
+***
+
+### supportedQueryTypes()
+
+> **supportedQueryTypes**(): `string`[]
+
+Supported query types.
+
+#### Returns
+
+`string`[]
+
+Types.
+
+#### Implementation of
+
+`IDataspaceApp.supportedQueryTypes`
+
+***
+
+### start()
+
+> **start**(`nodeLoggingComponentType?`): `Promise`\<`void`\>
+
+Start method.
+
+#### Parameters
+
+##### nodeLoggingComponentType?
+
+`string`
+
+the logging component type of such a node.
+
+#### Returns
+
+`Promise`\<`void`\>
+
+#### Implementation of
+
+`IDataspaceApp.start`
+
+***
+
+### activitiesHandled()
+
+> **activitiesHandled**(): `IActivityQuery`[]
+
+The activities handled by the App.
+
+#### Returns
+
+`IActivityQuery`[]
+
+The activities handled by the App.
+
+#### Implementation of
+
+`IDataspaceApp.activitiesHandled`
+
+***
+
+### handleActivity()
+
+> **handleActivity**\<`T`\>(`activity`): `Promise`\<`T`\>
+
+Handle Activity.
+
+#### Type Parameters
+
+##### T
+
+`T`
+
+#### Parameters
+
+##### activity
+
+`IActivityStreamsActivity`
+
+Activity
+
+#### Returns
+
+`Promise`\<`T`\>
+
+Activity processing result
+
+#### Implementation of
+
+`IDataspaceApp.handleActivity`
+
+***
+
+### handleDataRequest()
+
+> **handleDataRequest**(`dataRequest`, `cursor?`, `limit?`): `Promise`\<\{ `data`: `IJsonLdDocument`; `cursor?`: `string`; \}\>
+
+Handles the Data Request.
+
+#### Parameters
+
+##### dataRequest
+
+`IDataRequest`
+
+The data request
+
+##### cursor?
+
+`string`
+
+Cursor that points to the next item in the result set.
+
+##### limit?
+
+`number`
+
+Maximum number of entries retrieved or to be retrieved.
+
+#### Returns
+
+`Promise`\<\{ `data`: `IJsonLdDocument`; `cursor?`: `string`; \}\>
+
+the Data.
+
+#### Implementation of
+
+`IDataspaceApp.handleDataRequest`

package/docs/reference/functions/extensionInitialise.md

@@ -0,0 +1,21 @@
+# Function: extensionInitialise()
+
+> **extensionInitialise**(`envVars`, `nodeEngineConfig`): `Promise`\<`void`\>
+
+Initialise the  extension.
+
+## Parameters
+
+### envVars
+
+The environment variables for the node.
+
+### nodeEngineConfig
+
+`IEngineCoreConfig`
+
+The node engine config.
+
+## Returns
+
+`Promise`\<`void`\>

package/docs/reference/functions/extensionInitialiseEngine.md

@@ -0,0 +1,17 @@
+# Function: extensionInitialiseEngine()
+
+> **extensionInitialiseEngine**(`engineCore`): `Promise`\<`void`\>
+
+Initialise the engine for the extension.
+
+## Parameters
+
+### engineCore
+
+`IEngineCore`
+
+The engine core instance.
+
+## Returns
+
+`Promise`\<`void`\>

package/docs/reference/functions/extensionInitialiseEngineServer.md

@@ -0,0 +1,23 @@
+# Function: extensionInitialiseEngineServer()
+
+> **extensionInitialiseEngineServer**(`engineCore`, `engineServer`): `Promise`\<`void`\>
+
+Initialise the engine server for the extension.
+
+## Parameters
+
+### engineCore
+
+`IEngineCore`
+
+The engine core instance.
+
+### engineServer
+
+`IEngineServer`
+
+The engine server instance.
+
+## Returns
+
+`Promise`\<`void`\>

package/docs/reference/functions/generateRestRoutes.md

@@ -0,0 +1,25 @@
+# Function: generateRestRoutes()
+
+> **generateRestRoutes**(`baseRouteName`, `componentName`): `IRestRoute`\<`any`, `any`\>[]
+
+Generate the rest routes for the component.
+
+## Parameters
+
+### baseRouteName
+
+`string`
+
+The base route name.
+
+### componentName
+
+`string`
+
+The component name.
+
+## Returns
+
+`IRestRoute`\<`any`, `any`\>[]
+
+The rest routes.

package/docs/reference/functions/testAppInitialiser.md

@@ -0,0 +1,41 @@
+# Function: testAppInitialiser()
+
+> **testAppInitialiser**(`engineCore`, `context`, `instanceConfig`): `EngineTypeInitialiserReturn`\<\{ `type`: `"service"`; `options`: [`ITestAppConstructorOptions`](../interfaces/ITestAppConstructorOptions.md); \}, `Factory`\<`IDataspaceApp`\>\>
+
+Test Dataspace Data Plane App initializer.
+
+## Parameters
+
+### engineCore
+
+`IEngineCore`\<`IEngineConfig`\>
+
+The engine core.
+
+### context
+
+`IEngineCoreContext`
+
+The context for the engine.
+
+### instanceConfig
+
+The instance config.
+
+#### type
+
+`"service"`
+
+The instance type.
+
+#### options
+
+[`ITestAppConstructorOptions`](../interfaces/ITestAppConstructorOptions.md)
+
+The instance config options.
+
+## Returns
+
+`EngineTypeInitialiserReturn`\<\{ `type`: `"service"`; `options`: [`ITestAppConstructorOptions`](../interfaces/ITestAppConstructorOptions.md); \}, `Factory`\<`IDataspaceApp`\>\>
+
+The instance created and the factory for it.

package/docs/reference/index.md

@@ -0,0 +1,17 @@
+# @twin.org/dataspace-test-app
+
+## Classes
+
+- [TestDataspaceDataPlaneApp](classes/TestDataspaceDataPlaneApp.md)
+
+## Interfaces
+
+- [ITestAppConstructorOptions](interfaces/ITestAppConstructorOptions.md)
+
+## Functions
+
+- [extensionInitialise](functions/extensionInitialise.md)
+- [extensionInitialiseEngine](functions/extensionInitialiseEngine.md)
+- [extensionInitialiseEngineServer](functions/extensionInitialiseEngineServer.md)
+- [testAppInitialiser](functions/testAppInitialiser.md)
+- [generateRestRoutes](functions/generateRestRoutes.md)

package/docs/reference/interfaces/ITestAppConstructorOptions.md

@@ -0,0 +1,17 @@
+# Interface: ITestAppConstructorOptions
+
+Test App Constructor options.
+
+## Properties
+
+### loggingComponentType?
+
+> `optional` **loggingComponentType**: `string`
+
+Logging component type.
+
+#### Default
+
+```ts
+logging
+```

package/package.json

@@ -0,0 +1,60 @@
+{
+	"name": "@twin.org/dataspace-test-app",
+	"version": "0.0.3-next.15",
+	"description": "Dataspace Test App",
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/twinfoundation/dataspace.git",
+		"directory": "packages/dataspace-test-app"
+	},
+	"author": "jose.cantera@iota.org",
+	"license": "Apache-2.0",
+	"type": "module",
+	"engines": {
+		"node": ">=20.0.0"
+	},
+	"dependencies": {
+		"@twin.org/api-models": "next",
+		"@twin.org/context": "next",
+		"@twin.org/core": "next",
+		"@twin.org/data-core": "next",
+		"@twin.org/dataspace-models": "0.0.3-next.15",
+		"@twin.org/engine-models": "next",
+		"@twin.org/engine-types": "next",
+		"@twin.org/logging-models": "next",
+		"@twin.org/nameof": "next",
+		"@twin.org/standards-dataspace-protocol": "next",
+		"@twin.org/standards-dublin-core": "next",
+		"@twin.org/standards-w3c-activity-streams": "next"
+	},
+	"main": "./dist/es/index.js",
+	"types": "./dist/types/index.d.ts",
+	"exports": {
+		".": {
+			"types": "./dist/types/index.d.ts",
+			"import": "./dist/es/index.js",
+			"default": "./dist/es/index.js"
+		},
+		"./locales/*.json": "./locales/*.json"
+	},
+	"files": [
+		"dist/es",
+		"dist/types",
+		"locales",
+		"docs"
+	],
+	"keywords": [
+		"twin",
+		"trade",
+		"iota",
+		"framework",
+		"blockchain",
+		"dataspace",
+		"adapter",
+		"integration"
+	],
+	"bugs": {
+		"url": "git+https://github.com/twinfoundation/dataspace/issues"
+	},
+	"homepage": "https://twindev.org"
+}