@twin.org/engine-server 0.0.2-next.9 → 0.0.3-next.2

package/dist/es/data/serverRestRouteGenerators.json

@@ -0,0 +1,145 @@
+[
+    {
+        "type": "informationComponent",
+        "module": "@twin.org/api-service",
+        "method": "generateRestRoutesInformation",
+        "defaultPath": ""
+    },
+    {
+        "type": "authenticationComponent",
+        "module": "@twin.org/api-auth-entity-storage-service",
+        "method": "generateRestRoutesAuthentication",
+        "defaultPath": "/authentication"
+    },
+    {
+        "type": "loggingComponent",
+        "module": "@twin.org/logging-service",
+        "method": "generateRestRoutesLogging",
+        "defaultPath": "/logging"
+    },
+    {
+        "type": "telemetryComponent",
+        "module": "@twin.org/telemetry-service",
+        "method": "generateRestRoutesTelemetry",
+        "defaultPath": "/telemetry"
+    },
+    {
+        "type": "blobStorageComponent",
+        "module": "@twin.org/blob-storage-service",
+        "method": "generateRestRoutesBlobStorage",
+        "defaultPath": "/blob"
+    },
+    {
+        "type": "identityComponent",
+        "module": "@twin.org/identity-service",
+        "method": "generateRestRoutesIdentity",
+        "defaultPath": "/identity"
+    },
+    {
+        "type": "identityResolverComponent",
+        "module": "@twin.org/identity-service",
+        "method": "generateRestRoutesIdentityResolver",
+        "defaultPath": "/identity"
+    },
+    {
+        "type": "identityProfileComponent",
+        "module": "@twin.org/identity-service",
+        "method": "generateRestRoutesIdentityProfile",
+        "defaultPath": "/identity/profile"
+    },
+    {
+        "type": "nftComponent",
+        "module": "@twin.org/nft-service",
+        "method": "generateRestRoutesNft",
+        "defaultPath": "/nft"
+    },
+    {
+        "type": "verifiableStorageComponent",
+        "module": "@twin.org/verifiable-storage-service",
+        "method": "generateRestRoutesVerifiableStorage",
+        "defaultPath": "/verifiable"
+    },
+    {
+        "type": "immutableProofComponent",
+        "module": "@twin.org/immutable-proof-service",
+        "method": "generateRestRoutesImmutableProof",
+        "defaultPath": "/immutable-proof"
+    },
+    {
+        "type": "attestationComponent",
+        "module": "@twin.org/attestation-service",
+        "method": "generateRestRoutesAttestation",
+        "defaultPath": "/attestation"
+    },
+    {
+        "type": "auditableItemGraphComponent",
+        "module": "@twin.org/auditable-item-graph-service",
+        "method": "generateRestRoutesAuditableItemGraph",
+        "defaultPath": "/aig"
+    },
+    {
+        "type": "auditableItemStreamComponent",
+        "module": "@twin.org/auditable-item-stream-service",
+        "method": "generateRestRoutesAuditableItemStream",
+        "defaultPath": "/ais"
+    },
+    {
+        "type": "entityStorageComponent",
+        "module": "@twin.org/entity-storage-service",
+        "method": "generateRestRoutesEntityStorage"
+    },
+    {
+        "type": "dataProcessingComponent",
+        "module": "@twin.org/data-processing-service",
+        "method": "generateRestRoutesDataProcessing",
+        "defaultPath": "/data-processing"
+    },
+    {
+        "type": "documentManagementComponent",
+        "module": "@twin.org/document-management-service",
+        "method": "generateRestRoutesDocumentManagement",
+        "defaultPath": "/documents"
+    },
+    {
+        "type": "rightsManagementPapComponent",
+        "module": "@twin.org/rights-management-service",
+        "method": "generateRestRoutesPolicyAdministrationPoint",
+        "defaultPath": "/rights-management"
+    },
+    {
+        "type": "rightsManagementPnpComponent",
+        "module": "@twin.org/rights-management-service",
+        "method": "generateRestRoutesPolicyNegotiationPoint",
+        "defaultPath": "/rights-management"
+    },
+    {
+        "type": "rightsManagementPnapComponent",
+        "module": "@twin.org/rights-management-service",
+        "method": "generateRestRoutesPolicyNegotiationAdminPoint",
+        "defaultPath": "/rights-management"
+    },
+    {
+        "type": "rightsManagementDapComponent",
+        "module": "@twin.org/rights-management-service",
+        "method": "generateRestRoutesDataAccessPoint",
+        "defaultPath": "/rights-management"
+    },
+    {
+        "type": "synchronisedStorageComponent",
+        "module": "@twin.org/synchronised-storage-service",
+        "method": "generateRestRoutesSynchronisedStorage",
+        "defaultPath": "/synchronised-storage"
+    },
+    {
+        "type": "federatedCatalogueComponent",
+        "module": "@twin.org/federated-catalogue-service",
+        "method": "generateRestRoutesFederatedCatalogue",
+        "defaultPath": "/federated-catalogue"
+    },
+    {
+        "type": "dataSpaceConnectorComponent",
+        "module": "@twin.org/data-space-connector-service",
+        "method": "generateRestRoutesDataSpaceConnector",
+        "defaultPath": "/data-space-connector"
+    }
+]

package/dist/es/data/serverSocketRouteGenerators.json

@@ -0,0 +1,14 @@
+[
+    {
+        "type": "eventBusComponent",
+        "module": "@twin.org/event-bus-service",
+        "method": "generateSocketRoutesEventBus",
+        "defaultPath": "event-bus"
+    },
+    {
+        "type": "dataSpaceConnectorComponent",
+        "module": "@twin.org/data-space-connector-service",
+        "method": "generateSocketRoutesDataSpaceConnector",
+        "defaultPath": "data-space-connector"
+    }
+]

package/dist/es/data/serverTypeInitialisers.json

@@ -0,0 +1,33 @@
+[
+    {
+        "type": "authenticationAdminComponent",
+        "module": "@twin.org/engine-server-types",
+        "method": "initialiseAuthenticationAdminComponent"
+    },
+    {
+        "type": "authenticationComponent",
+        "module": "@twin.org/engine-server-types",
+        "method": "initialiseAuthenticationComponent"
+    },
+    {
+        "type": "informationComponent",
+        "module": "@twin.org/engine-server-types",
+        "method": "initialiseInformationComponent",
+        "defaultRestPath": ""
+    },
+    {
+        "type": "restRouteProcessor",
+        "module": "@twin.org/engine-server-types",
+        "method": "initialiseRestRouteProcessorComponent"
+    },
+    {
+        "type": "socketRouteProcessor",
+        "module": "@twin.org/engine-server-types",
+        "method": "initialiseSocketRouteProcessorComponent"
+    },
+    {
+        "type": "mimeTypeProcessor",
+        "module": "@twin.org/engine-server-types",
+        "method": "initialiseMimeTypeProcessorComponent"
+    }
+]

package/dist/es/engineServer.js

@@ -0,0 +1,323 @@
+import { MimeTypeProcessorFactory, RestRouteProcessorFactory, SocketRouteProcessorFactory } from "@twin.org/api-models";
+import { FastifyWebServer } from "@twin.org/api-server-fastify";
+import { ContextIdStore } from "@twin.org/context";
+import { Guards, Is, StringHelper } from "@twin.org/core";
+import { RestRouteProcessorType, SocketRouteProcessorType } from "@twin.org/engine-server-types";
+import { ModuleHelper } from "@twin.org/modules";
+import serverRestRouteGenerators from "./data/serverRestRouteGenerators.json" with { type: "json" };
+import serverSocketRouteGenerators from "./data/serverSocketRouteGenerators.json" with { type: "json" };
+import serverTypeInitialisers from "./data/serverTypeInitialisers.json" with { type: "json" };
+/**
+ * Server for the engine.
+ */
+export class EngineServer {
+    /**
+     * Runtime name for the class.
+     */
+    static CLASS_NAME = "EngineServer";
+    /**
+     * The engine.
+     * @internal
+     */
+    _engineCore;
+    /**
+     * The REST route generators.
+     * @internal
+     */
+    _restRouteGenerators;
+    /**
+     * The socket route generators.
+     * @internal
+     */
+    _socketRouteGenerators;
+    /**
+     * The web server.
+     * @internal
+     */
+    _webServer;
+    /**
+     * The REST routes for the application.
+     * @internal
+     */
+    _restRoutes;
+    /**
+     * The Socket routes for the application.
+     * @internal
+     */
+    _socketRoutes;
+    /**
+     * Create a new instance of EngineServer.
+     * @param options The options for the engine.
+     * @param options.engineCore The engine core to serve from.
+     */
+    constructor(options) {
+        Guards.object(EngineServer.CLASS_NAME, "options", options);
+        Guards.object(EngineServer.CLASS_NAME, "options.engineCore", options.engineCore);
+        this._engineCore = options.engineCore;
+        this._restRouteGenerators = [];
+        this._socketRouteGenerators = [];
+        this._restRoutes = [];
+        this._socketRoutes = [];
+        const coreConfig = this._engineCore.getConfig();
+        if (!Is.arrayValue(coreConfig.types.restRouteProcessor)) {
+            coreConfig.types.restRouteProcessor = [];
+            if (!coreConfig.silent) {
+                coreConfig.types.restRouteProcessor.push({
+                    type: RestRouteProcessorType.Logging,
+                    options: {
+                        config: {
+                            includeBody: coreConfig.debug
+                        }
+                    }
+                });
+            }
+            coreConfig.types.restRouteProcessor.push({
+                type: RestRouteProcessorType.RestRoute,
+                options: {
+                    config: {
+                        includeErrorStack: coreConfig.debug
+                    }
+                }
+            });
+        }
+        if (!Is.arrayValue(coreConfig.types.socketRouteProcessor)) {
+            coreConfig.types.socketRouteProcessor = [];
+            if (!coreConfig.silent) {
+                coreConfig.types.socketRouteProcessor.push({
+                    type: SocketRouteProcessorType.Logging,
+                    options: {
+                        config: {
+                            includeBody: coreConfig.debug
+                        }
+                    }
+                });
+            }
+            coreConfig.types.socketRouteProcessor.push({
+                type: SocketRouteProcessorType.SocketRoute,
+                options: {
+                    config: {
+                        includeErrorStack: coreConfig.debug
+                    }
+                }
+            });
+        }
+        this.addServerTypeInitialisers();
+        this.addServerRestRouteGenerators();
+        this.addServerSocketRouteGenerators();
+    }
+    /**
+     * Add a REST route generator.
+     * @param type The type to add the generator for.
+     * @param module The module containing the generator.
+     * @param method The method to call on the module.
+     */
+    addRestRouteGenerator(type, module, method) {
+        Guards.stringValue(EngineServer.CLASS_NAME, "type", type);
+        Guards.stringValue(EngineServer.CLASS_NAME, "module", module);
+        Guards.stringValue(EngineServer.CLASS_NAME, "method", method);
+        const currentIndex = this._restRouteGenerators.findIndex(r => r.type === type);
+        if (currentIndex >= 0) {
+            this._restRouteGenerators[currentIndex].module = module;
+            this._restRouteGenerators[currentIndex].method = method;
+        }
+        else {
+            this._restRouteGenerators.push({
+                type,
+                module,
+                method
+            });
+        }
+    }
+    /**
+     * Add a socket route generator.
+     * @param type The type to add the generator for.
+     * @param module The module containing the generator.
+     * @param method The method to call on the module.
+     */
+    addSocketRouteGenerator(type, module, method) {
+        Guards.stringValue(EngineServer.CLASS_NAME, "type", type);
+        Guards.stringValue(EngineServer.CLASS_NAME, "module", module);
+        Guards.stringValue(EngineServer.CLASS_NAME, "method", method);
+        const currentIndex = this._socketRouteGenerators.findIndex(s => s.type === type);
+        if (currentIndex >= 0) {
+            this._socketRouteGenerators[currentIndex].module = module;
+            this._socketRouteGenerators[currentIndex].method = method;
+        }
+        else {
+            this._socketRouteGenerators.push({
+                type,
+                module,
+                method
+            });
+        }
+    }
+    /**
+     * Get the built REST routes.
+     * @returns The REST routes.
+     */
+    getRestRoutes() {
+        return this._restRoutes;
+    }
+    /**
+     * Get the built socket routes.
+     * @returns The socket routes.
+     */
+    getSocketRoutes() {
+        return this._socketRoutes;
+    }
+    /**
+     * Start the engine server.
+     * @returns True if the start was successful.
+     */
+    async start() {
+        const canContinue = await this._engineCore.start();
+        if (canContinue) {
+            await ContextIdStore.run(this._engineCore.getContextIds() ?? {}, async () => {
+                await this.startWebServer();
+            });
+        }
+        return canContinue;
+    }
+    /**
+     * Stop the engine server.
+     * @returns Nothing.
+     */
+    async stop() {
+        await ContextIdStore.run(this._engineCore.getContextIds() ?? {}, async () => {
+            if (this._webServer) {
+                await this._webServer.stop();
+                this._webServer = undefined;
+            }
+        });
+        await this._engineCore.stop();
+    }
+    /**
+     * Starts the web server.
+     * @internal
+     */
+    async startWebServer() {
+        this._restRoutes = await this.buildRestRoutes();
+        this._socketRoutes = await this.buildSocketRoutes();
+        const restRouteProcessors = RestRouteProcessorFactory.names().map(n => RestRouteProcessorFactory.get(n));
+        const socketRouteProcessors = SocketRouteProcessorFactory.names().map(n => SocketRouteProcessorFactory.get(n));
+        const mimeTypeProcessors = MimeTypeProcessorFactory.names().map(n => MimeTypeProcessorFactory.get(n));
+        const coreConfig = this._engineCore.getConfig();
+        const loggingComponentType = coreConfig.silent
+            ? undefined
+            : this._engineCore.getRegisteredInstanceType("loggingComponent");
+        this._webServer = new FastifyWebServer({
+            loggingComponentType,
+            mimeTypeProcessors
+        });
+        await this._webServer.build(restRouteProcessors, this._restRoutes, socketRouteProcessors, this._socketRoutes, coreConfig.web);
+        await this._webServer.start();
+    }
+    /**
+     * The REST routes for the application.
+     * @returns The REST routes for the application.
+     * @internal
+     */
+    async buildRestRoutes() {
+        const routes = [];
+        for (const { type, module, method } of this._restRouteGenerators) {
+            await this.initialiseRestTypeRoute(routes, type, module, method);
+        }
+        return routes;
+    }
+    /**
+     * The socket routes for the application.
+     * @returns The socket routes for the application.
+     * @internal
+     */
+    async buildSocketRoutes() {
+        const routes = [];
+        for (const { type, module, method } of this._socketRouteGenerators) {
+            await this.initialiseSocketTypeRoute(routes, type, module, method);
+        }
+        return routes;
+    }
+    /**
+     * Initialise the rest routes from connector.
+     * @param routes The routes to add to.
+     * @param typeKey The key for the default types.
+     * @param generateRoutes The function to generate the routes.
+     * @internal
+     */
+    async initialiseRestTypeRoute(routes, typeKey, module, method) {
+        const typeConfig = this._engineCore.getTypeConfig(typeKey);
+        if (Is.arrayValue(typeConfig)) {
+            const generateRoutes = await ModuleHelper.getModuleEntry(module, method);
+            for (let i = 0; i < typeConfig.length; i++) {
+                const restPath = typeConfig[i].restPath;
+                const restOptions = typeConfig[i].restOptions;
+                if (Is.string(restPath)) {
+                    const serviceType = typeConfig[i].overrideInstanceType ??
+                        this._engineCore.getRegisteredInstanceType(typeKey);
+                    if (Is.stringValue(serviceType)) {
+                        const generatedRoutes = generateRoutes(restPath, serviceType, restOptions);
+                        for (const route of generatedRoutes) {
+                            // Don't strip trailing slashes from the root path.
+                            if (Is.stringValue(route.path) && route.path.length > 1) {
+                                route.path = StringHelper.trimTrailingSlashes(route.path);
+                            }
+                        }
+                        routes.push(...generatedRoutes);
+                    }
+                }
+            }
+        }
+    }
+    /**
+     * Initialise the socket routes from connector.
+     * @param routes The routes to add to.
+     * @param typeKey The key for the default types.
+     * @param module The module containing the generator.
+     * @param method The method to call on the module.
+     * @internal
+     */
+    async initialiseSocketTypeRoute(routes, typeKey, module, method) {
+        const typeConfig = this._engineCore.getTypeConfig(typeKey);
+        if (Is.arrayValue(typeConfig)) {
+            const generateRoutes = await ModuleHelper.getModuleEntry(module, method);
+            for (let i = 0; i < typeConfig.length; i++) {
+                const socketPath = typeConfig[i].socketPath;
+                const socketOptions = typeConfig[i].socketOptions;
+                if (Is.string(socketPath)) {
+                    const serviceType = typeConfig[i].overrideInstanceType ??
+                        this._engineCore.getRegisteredInstanceType(typeKey);
+                    if (Is.stringValue(serviceType)) {
+                        routes.push(...generateRoutes(socketPath, serviceType, socketOptions));
+                    }
+                }
+            }
+        }
+    }
+    /**
+     * Add the server type initializers.
+     * @internal
+     */
+    addServerTypeInitialisers() {
+        for (const initializer of serverTypeInitialisers) {
+            this._engineCore.addTypeInitialiser(initializer.type, initializer.module, initializer.method);
+        }
+    }
+    /**
+     * Add the server REST route generators.
+     * @internal
+     */
+    addServerRestRouteGenerators() {
+        for (const generator of serverRestRouteGenerators) {
+            this.addRestRouteGenerator(generator.type, generator.module, generator.method);
+        }
+    }
+    /**
+     * Add the server socket route generators.
+     * @internal
+     */
+    addServerSocketRouteGenerators() {
+        for (const generator of serverSocketRouteGenerators) {
+            this.addSocketRouteGenerator(generator.type, generator.module, generator.method);
+        }
+    }
+}
+//# sourceMappingURL=engineServer.js.map

package/dist/es/engineServer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engineServer.js","sourceRoot":"","sources":["../../src/engineServer.ts"],"names":[],"mappings":"AAGA,OAAO,EACN,wBAAwB,EACxB,yBAAyB,EACzB,2BAA2B,EAC3B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE1D,OAAO,EACN,sBAAsB,EACtB,wBAAwB,EAExB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,OAAO,yBAAyB,MAAM,uCAAuC,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AACpG,OAAO,2BAA2B,MAAM,yCAAyC,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AACxG,OAAO,sBAAsB,MAAM,oCAAoC,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AAE9F;;GAEG;AACH,MAAM,OAAO,YAAY;IAGxB;;OAEG;IACI,MAAM,CAAU,UAAU,kBAAkC;IAEnE;;;OAGG;IACc,WAAW,CAAiB;IAE7C;;;OAGG;IACc,oBAAoB,CAIjC;IAEJ;;;OAGG;IACc,sBAAsB,CAInC;IAEJ;;;OAGG;IACK,UAAU,CAAuB;IAEzC;;;OAGG;IACK,WAAW,CAAe;IAElC;;;OAGG;IACK,aAAa,CAAiB;IAEtC;;;;OAIG;IACH,YAAY,OAAuC;QAClD,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,UAAU,aAAmB,OAAO,CAAC,CAAC;QACjE,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,UAAU,wBAA8B,OAAO,CAAC,UAAU,CAAC,CAAC;QAEvF,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;QACtC,IAAI,CAAC,oBAAoB,GAAG,EAAE,CAAC;QAC/B,IAAI,CAAC,sBAAsB,GAAG,EAAE,CAAC;QACjC,IAAI,CAAC,WAAW,GAAG,EAAE,CAAC;QACtB,IAAI,CAAC,aAAa,GAAG,EAAE,CAAC;QAExB,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,CAAC,SAAS,EAAE,CAAC;QAEhD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,KAAK,CAAC,kBAAkB,CAAC,EAAE,CAAC;YACzD,UAAU,CAAC,KAAK,CAAC,kBAAkB,GAAG,EAAE,CAAC;YAEzC,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC;gBACxB,UAAU,CAAC,KAAK,CAAC,kBAAkB,CAAC,IAAI,CAAC;oBACxC,IAAI,EAAE,sBAAsB,CAAC,OAAO;oBACpC,OAAO,EAAE;wBACR,MAAM,EAAE;4BACP,WAAW,EAAE,UAAU,CAAC,KAAK;yBAC7B;qBACD;iBACD,CAAC,CAAC;YACJ,CAAC;YACD,UAAU,CAAC,KAAK,CAAC,kBAAkB,CAAC,IAAI,CAAC;gBACxC,IAAI,EAAE,sBAAsB,CAAC,SAAS;gBACtC,OAAO,EAAE;oBACR,MAAM,EAAE;wBACP,iBAAiB,EAAE,UAAU,CAAC,KAAK;qBACnC;iBACD;aACD,CAAC,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,KAAK,CAAC,oBAAoB,CAAC,EAAE,CAAC;YAC3D,UAAU,CAAC,KAAK,CAAC,oBAAoB,GAAG,EAAE,CAAC;YAE3C,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC;gBACxB,UAAU,CAAC,KAAK,CAAC,oBAAoB,CAAC,IAAI,CAAC;oBAC1C,IAAI,EAAE,wBAAwB,CAAC,OAAO;oBACtC,OAAO,EAAE;wBACR,MAAM,EAAE;4BACP,WAAW,EAAE,UAAU,CAAC,KAAK;yBAC7B;qBACD;iBACD,CAAC,CAAC;YACJ,CAAC;YACD,UAAU,CAAC,KAAK,CAAC,oBAAoB,CAAC,IAAI,CAAC;gBAC1C,IAAI,EAAE,wBAAwB,CAAC,WAAW;gBAC1C,OAAO,EAAE;oBACR,MAAM,EAAE;wBACP,iBAAiB,EAAE,UAAU,CAAC,KAAK;qBACnC;iBACD;aACD,CAAC,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,yBAAyB,EAAE,CAAC;QACjC,IAAI,CAAC,4BAA4B,EAAE,CAAC;QACpC,IAAI,CAAC,8BAA8B,EAAE,CAAC;IACvC,CAAC;IAED;;;;;OAKG;IACI,qBAAqB,CAAC,IAAY,EAAE,MAAc,EAAE,MAAc;QACxE,MAAM,CAAC,WAAW,CAAC,YAAY,CAAC,UAAU,UAAgB,IAAI,CAAC,CAAC;QAChE,MAAM,CAAC,WAAW,CAAC,YAAY,CAAC,UAAU,YAAkB,MAAM,CAAC,CAAC;QACpE,MAAM,CAAC,WAAW,CAAC,YAAY,CAAC,UAAU,YAAkB,MAAM,CAAC,CAAC;QAEpE,MAAM,YAAY,GAAG,IAAI,CAAC,oBAAoB,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;QAC/E,IAAI,YAAY,IAAI,CAAC,EAAE,CAAC;YACvB,IAAI,CAAC,oBAAoB,CAAC,YAAY,CAAC,CAAC,MAAM,GAAG,MAAM,CAAC;YACxD,IAAI,CAAC,oBAAoB,CAAC,YAAY,CAAC,CAAC,MAAM,GAAG,MAAM,CAAC;QACzD,CAAC;aAAM,CAAC;YACP,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC;gBAC9B,IAAI;gBACJ,MAAM;gBACN,MAAM;aACN,CAAC,CAAC;QACJ,CAAC;IACF,CAAC;IAED;;;;;OAKG;IACI,uBAAuB,CAAC,IAAY,EAAE,MAAc,EAAE,MAAc;QAC1E,MAAM,CAAC,WAAW,CAAC,YAAY,CAAC,UAAU,UAAgB,IAAI,CAAC,CAAC;QAChE,MAAM,CAAC,WAAW,CAAC,YAAY,CAAC,UAAU,YAAkB,MAAM,CAAC,CAAC;QACpE,MAAM,CAAC,WAAW,CAAC,YAAY,CAAC,UAAU,YAAkB,MAAM,CAAC,CAAC;QAEpE,MAAM,YAAY,GAAG,IAAI,CAAC,sBAAsB,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;QACjF,IAAI,YAAY,IAAI,CAAC,EAAE,CAAC;YACvB,IAAI,CAAC,sBAAsB,CAAC,YAAY,CAAC,CAAC,MAAM,GAAG,MAAM,CAAC;YAC1D,IAAI,CAAC,sBAAsB,CAAC,YAAY,CAAC,CAAC,MAAM,GAAG,MAAM,CAAC;QAC3D,CAAC;aAAM,CAAC;YACP,IAAI,CAAC,sBAAsB,CAAC,IAAI,CAAC;gBAChC,IAAI;gBACJ,MAAM;gBACN,MAAM;aACN,CAAC,CAAC;QACJ,CAAC;IACF,CAAC;IAED;;;OAGG;IACI,aAAa;QACnB,OAAO,IAAI,CAAC,WAAW,CAAC;IACzB,CAAC;IAED;;;OAGG;IACI,eAAe;QACrB,OAAO,IAAI,CAAC,aAAa,CAAC;IAC3B,CAAC;IAED;;;OAGG;IACI,KAAK,CAAC,KAAK;QACjB,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC;QAEnD,IAAI,WAAW,EAAE,CAAC;YACjB,MAAM,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,aAAa,EAAE,IAAI,EAAE,EAAE,KAAK,IAAI,EAAE;gBAC3E,MAAM,IAAI,CAAC,cAAc,EAAE,CAAC;YAC7B,CAAC,CAAC,CAAC;QACJ,CAAC;QAED,OAAO,WAAW,CAAC;IACpB,CAAC;IAED;;;OAGG;IACI,KAAK,CAAC,IAAI;QAChB,MAAM,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,aAAa,EAAE,IAAI,EAAE,EAAE,KAAK,IAAI,EAAE;YAC3E,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;gBACrB,MAAM,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC;gBAC7B,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;YAC7B,CAAC;QACF,CAAC,CAAC,CAAC;QAEH,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC;IAC/B,CAAC;IAED;;;OAGG;IACK,KAAK,CAAC,cAAc;QAC3B,IAAI,CAAC,WAAW,GAAG,MAAM,IAAI,CAAC,eAAe,EAAE,CAAC;QAChD,IAAI,CAAC,aAAa,GAAG,MAAM,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACpD,MAAM,mBAAmB,GAAG,yBAAyB,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CACrE,yBAAyB,CAAC,GAAG,CAAC,CAAC,CAAC,CAChC,CAAC;QACF,MAAM,qBAAqB,GAAG,2BAA2B,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CACzE,2BAA2B,CAAC,GAAG,CAAC,CAAC,CAAC,CAClC,CAAC;QACF,MAAM,kBAAkB,GAAG,wBAAwB,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CACnE,wBAAwB,CAAC,GAAG,CAAC,CAAC,CAAC,CAC/B,CAAC;QAEF,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,CAAC,SAAS,EAAE,CAAC;QAChD,MAAM,oBAAoB,GAAG,UAAU,CAAC,MAAM;YAC7C,CAAC,CAAC,SAAS;YACX,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,yBAAyB,CAAC,kBAAkB,CAAC,CAAC;QAElE,IAAI,CAAC,UAAU,GAAG,IAAI,gBAAgB,CAAC;YACtC,oBAAoB;YACpB,kBAAkB;SAClB,CAAC,CAAC;QAEH,MAAM,IAAI,CAAC,UAAU,CAAC,KAAK,CAC1B,mBAAmB,EACnB,IAAI,CAAC,WAAW,EAChB,qBAAqB,EACrB,IAAI,CAAC,aAAa,EAClB,UAAU,CAAC,GAAG,CACd,CAAC;QACF,MAAM,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;IAC/B,CAAC;IAED;;;;OAIG;IACK,KAAK,CAAC,eAAe;QAC5B,MAAM,MAAM,GAAiB,EAAE,CAAC;QAEhC,KAAK,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,IAAI,CAAC,oBAAoB,EAAE,CAAC;YAClE,MAAM,IAAI,CAAC,uBAAuB,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;QAClE,CAAC;QAED,OAAO,MAAM,CAAC;IACf,CAAC;IAED;;;;OAIG;IACK,KAAK,CAAC,iBAAiB;QAC9B,MAAM,MAAM,GAAmB,EAAE,CAAC;QAElC,KAAK,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,IAAI,CAAC,sBAAsB,EAAE,CAAC;YACpE,MAAM,IAAI,CAAC,yBAAyB,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;QACpE,CAAC;QAED,OAAO,MAAM,CAAC;IACf,CAAC;IAED;;;;;;OAMG;IACK,KAAK,CAAC,uBAAuB,CACpC,MAAoB,EACpB,OAAe,EACf,MAAc,EACd,MAAc;QAEd,MAAM,UAAU,GAAwC,IAAI,CAAC,WAAW,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;QAEhG,IAAI,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YAC/B,MAAM,cAAc,GAAG,MAAM,YAAY,CAAC,cAAc,CAEtD,MAAM,EAAE,MAAM,CAAC,CAAC;YAElB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,UAAU,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBAC5C,MAAM,QAAQ,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;gBACxC,MAAM,WAAW,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC;gBAE9C,IAAI,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;oBACzB,MAAM,WAAW,GAChB,UAAU,CAAC,CAAC,CAAC,CAAC,oBAAoB;wBAClC,IAAI,CAAC,WAAW,CAAC,yBAAyB,CAAC,OAAO,CAAC,CAAC;oBACrD,IAAI,EAAE,CAAC,WAAW,CAAC,WAAW,CAAC,EAAE,CAAC;wBACjC,MAAM,eAAe,GAAG,cAAc,CAAC,QAAQ,EAAE,WAAW,EAAE,WAAW,CAAC,CAAC;wBAC3E,KAAK,MAAM,KAAK,IAAI,eAAe,EAAE,CAAC;4BACrC,mDAAmD;4BACnD,IAAI,EAAE,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gCACzD,KAAK,CAAC,IAAI,GAAG,YAAY,CAAC,mBAAmB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;4BAC3D,CAAC;wBACF,CAAC;wBACD,MAAM,CAAC,IAAI,CAAC,GAAG,eAAe,CAAC,CAAC;oBACjC,CAAC;gBACF,CAAC;YACF,CAAC;QACF,CAAC;IACF,CAAC;IAED;;;;;;;OAOG;IACK,KAAK,CAAC,yBAAyB,CACtC,MAAsB,EACtB,OAAe,EACf,MAAc,EACd,MAAc;QAEd,MAAM,UAAU,GAAwC,IAAI,CAAC,WAAW,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;QAEhG,IAAI,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YAC/B,MAAM,cAAc,GAAG,MAAM,YAAY,CAAC,cAAc,CAEtD,MAAM,EAAE,MAAM,CAAC,CAAC;YAElB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,UAAU,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBAC5C,MAAM,UAAU,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC;gBAC5C,MAAM,aAAa,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC;gBAClD,IAAI,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC;oBAC3B,MAAM,WAAW,GAChB,UAAU,CAAC,CAAC,CAAC,CAAC,oBAAoB;wBAClC,IAAI,CAAC,WAAW,CAAC,yBAAyB,CAAC,OAAO,CAAC,CAAC;oBACrD,IAAI,EAAE,CAAC,WAAW,CAAC,WAAW,CAAC,EAAE,CAAC;wBACjC,MAAM,CAAC,IAAI,CAAC,GAAG,cAAc,CAAC,UAAU,EAAE,WAAW,EAAE,aAAa,CAAC,CAAC,CAAC;oBACxE,CAAC;gBACF,CAAC;YACF,CAAC;QACF,CAAC;IACF,CAAC;IAED;;;OAGG;IACK,yBAAyB;QAChC,KAAK,MAAM,WAAW,IAAI,sBAAsB,EAAE,CAAC;YAClD,IAAI,CAAC,WAAW,CAAC,kBAAkB,CAAC,WAAW,CAAC,IAAI,EAAE,WAAW,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;QAC/F,CAAC;IACF,CAAC;IAED;;;OAGG;IACK,4BAA4B;QACnC,KAAK,MAAM,SAAS,IAAI,yBAAyB,EAAE,CAAC;YACnD,IAAI,CAAC,qBAAqB,CAAC,SAAS,CAAC,IAAI,EAAE,SAAS,CAAC,MAAM,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;QAChF,CAAC;IACF,CAAC;IAED;;;OAGG;IACK,8BAA8B;QACrC,KAAK,MAAM,SAAS,IAAI,2BAA2B,EAAE,CAAC;YACrD,IAAI,CAAC,uBAAuB,CAAC,SAAS,CAAC,IAAI,EAAE,SAAS,CAAC,MAAM,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;QAClF,CAAC;IACF,CAAC","sourcesContent":["// Copyright 2024 IOTA Stiftung.\n// SPDX-License-Identifier: Apache-2.0.\nimport type { IRestRoute, ISocketRoute, IWebServer } from \"@twin.org/api-models\";\nimport {\n\tMimeTypeProcessorFactory,\n\tRestRouteProcessorFactory,\n\tSocketRouteProcessorFactory\n} from \"@twin.org/api-models\";\nimport { FastifyWebServer } from \"@twin.org/api-server-fastify\";\nimport { ContextIdStore } from \"@twin.org/context\";\nimport { Guards, Is, StringHelper } from \"@twin.org/core\";\nimport type { IEngineCore, IEngineCoreTypeConfig, IEngineServer } from \"@twin.org/engine-models\";\nimport {\n\tRestRouteProcessorType,\n\tSocketRouteProcessorType,\n\ttype IEngineServerConfig\n} from \"@twin.org/engine-server-types\";\nimport { ModuleHelper } from \"@twin.org/modules\";\nimport { nameof } from \"@twin.org/nameof\";\nimport serverRestRouteGenerators from \"./data/serverRestRouteGenerators.json\" with { type: \"json\" };\nimport serverSocketRouteGenerators from \"./data/serverSocketRouteGenerators.json\" with { type: \"json\" };\nimport serverTypeInitialisers from \"./data/serverTypeInitialisers.json\" with { type: \"json\" };\n\n/**\n * Server for the engine.\n */\nexport class EngineServer<T extends IEngineServerConfig = IEngineServerConfig>\n\timplements IEngineServer\n{\n\t/**\n\t * Runtime name for the class.\n\t */\n\tpublic static readonly CLASS_NAME: string = nameof<EngineServer>();\n\n\t/**\n\t * The engine.\n\t * @internal\n\t */\n\tprivate readonly _engineCore: IEngineCore<T>;\n\n\t/**\n\t * The REST route generators.\n\t * @internal\n\t */\n\tprivate readonly _restRouteGenerators: {\n\t\ttype: string;\n\t\tmodule: string;\n\t\tmethod: string;\n\t}[];\n\n\t/**\n\t * The socket route generators.\n\t * @internal\n\t */\n\tprivate readonly _socketRouteGenerators: {\n\t\ttype: string;\n\t\tmodule: string;\n\t\tmethod: string;\n\t}[];\n\n\t/**\n\t * The web server.\n\t * @internal\n\t */\n\tprivate _webServer?: IWebServer<unknown>;\n\n\t/**\n\t * The REST routes for the application.\n\t * @internal\n\t */\n\tprivate _restRoutes: IRestRoute[];\n\n\t/**\n\t * The Socket routes for the application.\n\t * @internal\n\t */\n\tprivate _socketRoutes: ISocketRoute[];\n\n\t/**\n\t * Create a new instance of EngineServer.\n\t * @param options The options for the engine.\n\t * @param options.engineCore The engine core to serve from.\n\t */\n\tconstructor(options: { engineCore: IEngineCore<T> }) {\n\t\tGuards.object(EngineServer.CLASS_NAME, nameof(options), options);\n\t\tGuards.object(EngineServer.CLASS_NAME, nameof(options.engineCore), options.engineCore);\n\n\t\tthis._engineCore = options.engineCore;\n\t\tthis._restRouteGenerators = [];\n\t\tthis._socketRouteGenerators = [];\n\t\tthis._restRoutes = [];\n\t\tthis._socketRoutes = [];\n\n\t\tconst coreConfig = this._engineCore.getConfig();\n\n\t\tif (!Is.arrayValue(coreConfig.types.restRouteProcessor)) {\n\t\t\tcoreConfig.types.restRouteProcessor = [];\n\n\t\t\tif (!coreConfig.silent) {\n\t\t\t\tcoreConfig.types.restRouteProcessor.push({\n\t\t\t\t\ttype: RestRouteProcessorType.Logging,\n\t\t\t\t\toptions: {\n\t\t\t\t\t\tconfig: {\n\t\t\t\t\t\t\tincludeBody: coreConfig.debug\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t});\n\t\t\t}\n\t\t\tcoreConfig.types.restRouteProcessor.push({\n\t\t\t\ttype: RestRouteProcessorType.RestRoute,\n\t\t\t\toptions: {\n\t\t\t\t\tconfig: {\n\t\t\t\t\t\tincludeErrorStack: coreConfig.debug\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t});\n\t\t}\n\n\t\tif (!Is.arrayValue(coreConfig.types.socketRouteProcessor)) {\n\t\t\tcoreConfig.types.socketRouteProcessor = [];\n\n\t\t\tif (!coreConfig.silent) {\n\t\t\t\tcoreConfig.types.socketRouteProcessor.push({\n\t\t\t\t\ttype: SocketRouteProcessorType.Logging,\n\t\t\t\t\toptions: {\n\t\t\t\t\t\tconfig: {\n\t\t\t\t\t\t\tincludeBody: coreConfig.debug\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t});\n\t\t\t}\n\t\t\tcoreConfig.types.socketRouteProcessor.push({\n\t\t\t\ttype: SocketRouteProcessorType.SocketRoute,\n\t\t\t\toptions: {\n\t\t\t\t\tconfig: {\n\t\t\t\t\t\tincludeErrorStack: coreConfig.debug\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t});\n\t\t}\n\n\t\tthis.addServerTypeInitialisers();\n\t\tthis.addServerRestRouteGenerators();\n\t\tthis.addServerSocketRouteGenerators();\n\t}\n\n\t/**\n\t * Add a REST route generator.\n\t * @param type The type to add the generator for.\n\t * @param module The module containing the generator.\n\t * @param method The method to call on the module.\n\t */\n\tpublic addRestRouteGenerator(type: string, module: string, method: string): void {\n\t\tGuards.stringValue(EngineServer.CLASS_NAME, nameof(type), type);\n\t\tGuards.stringValue(EngineServer.CLASS_NAME, nameof(module), module);\n\t\tGuards.stringValue(EngineServer.CLASS_NAME, nameof(method), method);\n\n\t\tconst currentIndex = this._restRouteGenerators.findIndex(r => r.type === type);\n\t\tif (currentIndex >= 0) {\n\t\t\tthis._restRouteGenerators[currentIndex].module = module;\n\t\t\tthis._restRouteGenerators[currentIndex].method = method;\n\t\t} else {\n\t\t\tthis._restRouteGenerators.push({\n\t\t\t\ttype,\n\t\t\t\tmodule,\n\t\t\t\tmethod\n\t\t\t});\n\t\t}\n\t}\n\n\t/**\n\t * Add a socket route generator.\n\t * @param type The type to add the generator for.\n\t * @param module The module containing the generator.\n\t * @param method The method to call on the module.\n\t */\n\tpublic addSocketRouteGenerator(type: string, module: string, method: string): void {\n\t\tGuards.stringValue(EngineServer.CLASS_NAME, nameof(type), type);\n\t\tGuards.stringValue(EngineServer.CLASS_NAME, nameof(module), module);\n\t\tGuards.stringValue(EngineServer.CLASS_NAME, nameof(method), method);\n\n\t\tconst currentIndex = this._socketRouteGenerators.findIndex(s => s.type === type);\n\t\tif (currentIndex >= 0) {\n\t\t\tthis._socketRouteGenerators[currentIndex].module = module;\n\t\t\tthis._socketRouteGenerators[currentIndex].method = method;\n\t\t} else {\n\t\t\tthis._socketRouteGenerators.push({\n\t\t\t\ttype,\n\t\t\t\tmodule,\n\t\t\t\tmethod\n\t\t\t});\n\t\t}\n\t}\n\n\t/**\n\t * Get the built REST routes.\n\t * @returns The REST routes.\n\t */\n\tpublic getRestRoutes(): IRestRoute[] {\n\t\treturn this._restRoutes;\n\t}\n\n\t/**\n\t * Get the built socket routes.\n\t * @returns The socket routes.\n\t */\n\tpublic getSocketRoutes(): ISocketRoute[] {\n\t\treturn this._socketRoutes;\n\t}\n\n\t/**\n\t * Start the engine server.\n\t * @returns True if the start was successful.\n\t */\n\tpublic async start(): Promise<boolean> {\n\t\tconst canContinue = await this._engineCore.start();\n\n\t\tif (canContinue) {\n\t\t\tawait ContextIdStore.run(this._engineCore.getContextIds() ?? {}, async () => {\n\t\t\t\tawait this.startWebServer();\n\t\t\t});\n\t\t}\n\n\t\treturn canContinue;\n\t}\n\n\t/**\n\t * Stop the engine server.\n\t * @returns Nothing.\n\t */\n\tpublic async stop(): Promise<void> {\n\t\tawait ContextIdStore.run(this._engineCore.getContextIds() ?? {}, async () => {\n\t\t\tif (this._webServer) {\n\t\t\t\tawait this._webServer.stop();\n\t\t\t\tthis._webServer = undefined;\n\t\t\t}\n\t\t});\n\n\t\tawait this._engineCore.stop();\n\t}\n\n\t/**\n\t * Starts the web server.\n\t * @internal\n\t */\n\tprivate async startWebServer(): Promise<void> {\n\t\tthis._restRoutes = await this.buildRestRoutes();\n\t\tthis._socketRoutes = await this.buildSocketRoutes();\n\t\tconst restRouteProcessors = RestRouteProcessorFactory.names().map(n =>\n\t\t\tRestRouteProcessorFactory.get(n)\n\t\t);\n\t\tconst socketRouteProcessors = SocketRouteProcessorFactory.names().map(n =>\n\t\t\tSocketRouteProcessorFactory.get(n)\n\t\t);\n\t\tconst mimeTypeProcessors = MimeTypeProcessorFactory.names().map(n =>\n\t\t\tMimeTypeProcessorFactory.get(n)\n\t\t);\n\n\t\tconst coreConfig = this._engineCore.getConfig();\n\t\tconst loggingComponentType = coreConfig.silent\n\t\t\t? undefined\n\t\t\t: this._engineCore.getRegisteredInstanceType(\"loggingComponent\");\n\n\t\tthis._webServer = new FastifyWebServer({\n\t\t\tloggingComponentType,\n\t\t\tmimeTypeProcessors\n\t\t});\n\n\t\tawait this._webServer.build(\n\t\t\trestRouteProcessors,\n\t\t\tthis._restRoutes,\n\t\t\tsocketRouteProcessors,\n\t\t\tthis._socketRoutes,\n\t\t\tcoreConfig.web\n\t\t);\n\t\tawait this._webServer.start();\n\t}\n\n\t/**\n\t * The REST routes for the application.\n\t * @returns The REST routes for the application.\n\t * @internal\n\t */\n\tprivate async buildRestRoutes(): Promise<IRestRoute[]> {\n\t\tconst routes: IRestRoute[] = [];\n\n\t\tfor (const { type, module, method } of this._restRouteGenerators) {\n\t\t\tawait this.initialiseRestTypeRoute(routes, type, module, method);\n\t\t}\n\n\t\treturn routes;\n\t}\n\n\t/**\n\t * The socket routes for the application.\n\t * @returns The socket routes for the application.\n\t * @internal\n\t */\n\tprivate async buildSocketRoutes(): Promise<ISocketRoute[]> {\n\t\tconst routes: ISocketRoute[] = [];\n\n\t\tfor (const { type, module, method } of this._socketRouteGenerators) {\n\t\t\tawait this.initialiseSocketTypeRoute(routes, type, module, method);\n\t\t}\n\n\t\treturn routes;\n\t}\n\n\t/**\n\t * Initialise the rest routes from connector.\n\t * @param routes The routes to add to.\n\t * @param typeKey The key for the default types.\n\t * @param generateRoutes The function to generate the routes.\n\t * @internal\n\t */\n\tprivate async initialiseRestTypeRoute(\n\t\troutes: IRestRoute[],\n\t\ttypeKey: string,\n\t\tmodule: string,\n\t\tmethod: string\n\t): Promise<void> {\n\t\tconst typeConfig: IEngineCoreTypeConfig[] | undefined = this._engineCore.getTypeConfig(typeKey);\n\n\t\tif (Is.arrayValue(typeConfig)) {\n\t\t\tconst generateRoutes = await ModuleHelper.getModuleEntry<\n\t\t\t\t(baseRouteName: string, componentName: string, options?: unknown) => IRestRoute[]\n\t\t\t>(module, method);\n\n\t\t\tfor (let i = 0; i < typeConfig.length; i++) {\n\t\t\t\tconst restPath = typeConfig[i].restPath;\n\t\t\t\tconst restOptions = typeConfig[i].restOptions;\n\n\t\t\t\tif (Is.string(restPath)) {\n\t\t\t\t\tconst serviceType =\n\t\t\t\t\t\ttypeConfig[i].overrideInstanceType ??\n\t\t\t\t\t\tthis._engineCore.getRegisteredInstanceType(typeKey);\n\t\t\t\t\tif (Is.stringValue(serviceType)) {\n\t\t\t\t\t\tconst generatedRoutes = generateRoutes(restPath, serviceType, restOptions);\n\t\t\t\t\t\tfor (const route of generatedRoutes) {\n\t\t\t\t\t\t\t// Don't strip trailing slashes from the root path.\n\t\t\t\t\t\t\tif (Is.stringValue(route.path) && route.path.length > 1) {\n\t\t\t\t\t\t\t\troute.path = StringHelper.trimTrailingSlashes(route.path);\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t}\n\t\t\t\t\t\troutes.push(...generatedRoutes);\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t}\n\n\t/**\n\t * Initialise the socket routes from connector.\n\t * @param routes The routes to add to.\n\t * @param typeKey The key for the default types.\n\t * @param module The module containing the generator.\n\t * @param method The method to call on the module.\n\t * @internal\n\t */\n\tprivate async initialiseSocketTypeRoute(\n\t\troutes: ISocketRoute[],\n\t\ttypeKey: string,\n\t\tmodule: string,\n\t\tmethod: string\n\t): Promise<void> {\n\t\tconst typeConfig: IEngineCoreTypeConfig[] | undefined = this._engineCore.getTypeConfig(typeKey);\n\n\t\tif (Is.arrayValue(typeConfig)) {\n\t\t\tconst generateRoutes = await ModuleHelper.getModuleEntry<\n\t\t\t\t(baseRouteName: string, componentName: string, options?: unknown) => ISocketRoute[]\n\t\t\t>(module, method);\n\n\t\t\tfor (let i = 0; i < typeConfig.length; i++) {\n\t\t\t\tconst socketPath = typeConfig[i].socketPath;\n\t\t\t\tconst socketOptions = typeConfig[i].socketOptions;\n\t\t\t\tif (Is.string(socketPath)) {\n\t\t\t\t\tconst serviceType =\n\t\t\t\t\t\ttypeConfig[i].overrideInstanceType ??\n\t\t\t\t\t\tthis._engineCore.getRegisteredInstanceType(typeKey);\n\t\t\t\t\tif (Is.stringValue(serviceType)) {\n\t\t\t\t\t\troutes.push(...generateRoutes(socketPath, serviceType, socketOptions));\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t}\n\n\t/**\n\t * Add the server type initializers.\n\t * @internal\n\t */\n\tprivate addServerTypeInitialisers(): void {\n\t\tfor (const initializer of serverTypeInitialisers) {\n\t\t\tthis._engineCore.addTypeInitialiser(initializer.type, initializer.module, initializer.method);\n\t\t}\n\t}\n\n\t/**\n\t * Add the server REST route generators.\n\t * @internal\n\t */\n\tprivate addServerRestRouteGenerators(): void {\n\t\tfor (const generator of serverRestRouteGenerators) {\n\t\t\tthis.addRestRouteGenerator(generator.type, generator.module, generator.method);\n\t\t}\n\t}\n\n\t/**\n\t * Add the server socket route generators.\n\t * @internal\n\t */\n\tprivate addServerSocketRouteGenerators(): void {\n\t\tfor (const generator of serverSocketRouteGenerators) {\n\t\t\tthis.addSocketRouteGenerator(generator.type, generator.module, generator.method);\n\t\t}\n\t}\n}\n"]}

package/dist/es/index.js

@@ -0,0 +1,5 @@
+// Copyright 2024 IOTA Stiftung.
+// SPDX-License-Identifier: Apache-2.0.
+export * from "./engineServer.js";
+export * from "./utils/engineServerConfigHelper.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,mBAAmB,CAAC;AAClC,cAAc,qCAAqC,CAAC","sourcesContent":["// Copyright 2024 IOTA Stiftung.\n// SPDX-License-Identifier: Apache-2.0.\nexport * from \"./engineServer.js\";\nexport * from \"./utils/engineServerConfigHelper.js\";\n"]}

package/dist/es/utils/engineServerConfigHelper.js

@@ -0,0 +1,34 @@
+// Copyright 2024 IOTA Stiftung.
+// SPDX-License-Identifier: Apache-2.0.
+import { Is } from "@twin.org/core";
+import serverRestRouteGenerators from "../data/serverRestRouteGenerators.json" with { type: "json" };
+import serverSocketRouteGenerators from "../data/serverSocketRouteGenerators.json" with { type: "json" };
+/**
+ * Adds the rest paths to the server config if not already set.
+ * @param serverConfig The server config.
+ */
+export function addDefaultRestPaths(serverConfig) {
+    for (const routeGenerator of serverRestRouteGenerators) {
+        const types = serverConfig.types[routeGenerator.type];
+        if (Is.arrayValue(types) &&
+            !Is.stringValue(types[0].restPath) &&
+            Is.string(routeGenerator.defaultPath)) {
+            types[0].restPath = routeGenerator.defaultPath;
+        }
+    }
+}
+/**
+ * Adds the socket paths to the server config.
+ * @param serverConfig The server config.
+ */
+export function addDefaultSocketPaths(serverConfig) {
+    for (const routeGenerator of serverSocketRouteGenerators) {
+        const types = serverConfig.types[routeGenerator.type];
+        if (Is.arrayValue(types) &&
+            !Is.stringValue(types[0].socketPath) &&
+            Is.stringValue(routeGenerator.defaultPath)) {
+            types[0].socketPath = routeGenerator.defaultPath;
+        }
+    }
+}
+//# sourceMappingURL=engineServerConfigHelper.js.map

package/dist/es/utils/engineServerConfigHelper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engineServerConfigHelper.js","sourceRoot":"","sources":["../../../src/utils/engineServerConfigHelper.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,uCAAuC;AACvC,OAAO,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAC;AAEpC,OAAO,yBAAyB,MAAM,wCAAwC,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AACrG,OAAO,2BAA2B,MAAM,0CAA0C,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AAEzG;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,YAAiC;IACpE,KAAK,MAAM,cAAc,IAAI,yBAAyB,EAAE,CAAC;QACxD,MAAM,KAAK,GAAG,YAAY,CAAC,KAAK,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;QAEtD,IACC,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC;YACpB,CAAC,EAAE,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;YAClC,EAAE,CAAC,MAAM,CAAC,cAAc,CAAC,WAAW,CAAC,EACpC,CAAC;YACF,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,GAAG,cAAc,CAAC,WAAW,CAAC;QAChD,CAAC;IACF,CAAC;AACF,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,YAAiC;IACtE,KAAK,MAAM,cAAc,IAAI,2BAA2B,EAAE,CAAC;QAC1D,MAAM,KAAK,GAAG,YAAY,CAAC,KAAK,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;QAEtD,IACC,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC;YACpB,CAAC,EAAE,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC;YACpC,EAAE,CAAC,WAAW,CAAC,cAAc,CAAC,WAAW,CAAC,EACzC,CAAC;YACF,KAAK,CAAC,CAAC,CAAC,CAAC,UAAU,GAAG,cAAc,CAAC,WAAW,CAAC;QAClD,CAAC;IACF,CAAC;AACF,CAAC","sourcesContent":["// Copyright 2024 IOTA Stiftung.\n// SPDX-License-Identifier: Apache-2.0.\nimport { Is } from \"@twin.org/core\";\nimport type { IEngineServerConfig } from \"@twin.org/engine-server-types\";\nimport serverRestRouteGenerators from \"../data/serverRestRouteGenerators.json\" with { type: \"json\" };\nimport serverSocketRouteGenerators from \"../data/serverSocketRouteGenerators.json\" with { type: \"json\" };\n\n/**\n * Adds the rest paths to the server config if not already set.\n * @param serverConfig The server config.\n */\nexport function addDefaultRestPaths(serverConfig: IEngineServerConfig): void {\n\tfor (const routeGenerator of serverRestRouteGenerators) {\n\t\tconst types = serverConfig.types[routeGenerator.type];\n\n\t\tif (\n\t\t\tIs.arrayValue(types) &&\n\t\t\t!Is.stringValue(types[0].restPath) &&\n\t\t\tIs.string(routeGenerator.defaultPath)\n\t\t) {\n\t\t\ttypes[0].restPath = routeGenerator.defaultPath;\n\t\t}\n\t}\n}\n\n/**\n * Adds the socket paths to the server config.\n * @param serverConfig The server config.\n */\nexport function addDefaultSocketPaths(serverConfig: IEngineServerConfig): void {\n\tfor (const routeGenerator of serverSocketRouteGenerators) {\n\t\tconst types = serverConfig.types[routeGenerator.type];\n\n\t\tif (\n\t\t\tIs.arrayValue(types) &&\n\t\t\t!Is.stringValue(types[0].socketPath) &&\n\t\t\tIs.stringValue(routeGenerator.defaultPath)\n\t\t) {\n\t\t\ttypes[0].socketPath = routeGenerator.defaultPath;\n\t\t}\n\t}\n}\n"]}

package/dist/types/engineServer.d.ts

@@ -1,5 +1,5 @@
 import type { IRestRoute, ISocketRoute } from "@twin.org/api-models";
-import type { IEngineCore, IEngineCoreTypeConfig, IEngineServer } from "@twin.org/engine-models";
+import type { IEngineCore, IEngineServer } from "@twin.org/engine-models";
 import { type IEngineServerConfig } from "@twin.org/engine-server-types";
 /**
  * Server for the engine.
@@ -8,7 +8,7 @@ export declare class EngineServer<T extends IEngineServerConfig = IEngineServerC
     /**
      * Runtime name for the class.
      */
-    readonly CLASS_NAME: string;
+    static readonly CLASS_NAME: string;
     /**
      * Create a new instance of EngineServer.
      * @param options The options for the engine.
@@ -20,19 +20,17 @@ export declare class EngineServer<T extends IEngineServerConfig = IEngineServerC
     /**
      * Add a REST route generator.
      * @param type The type to add the generator for.
-     * @param typeConfig The type config.
      * @param module The module containing the generator.
      * @param method The method to call on the module.
      */
-    addRestRouteGenerator(type: string, typeConfig: IEngineCoreTypeConfig[] | undefined, module: string, method: string): void;
+    addRestRouteGenerator(type: string, module: string, method: string): void;
     /**
      * Add a socket route generator.
      * @param type The type to add the generator for.
-     * @param typeConfig The type config.
      * @param module The module containing the generator.
      * @param method The method to call on the module.
      */
-    addSocketRouteGenerator(type: string, typeConfig: IEngineCoreTypeConfig[] | undefined, module: string, method: string): void;
+    addSocketRouteGenerator(type: string, module: string, method: string): void;
     /**
      * Get the built REST routes.
      * @returns The REST routes.

package/dist/types/index.d.ts

@@ -1,2 +1,2 @@
-export * from "./engineServer";
-export * from "./utils/engineServerConfigHelper";
+export * from "./engineServer.js";
+export * from "./utils/engineServerConfigHelper.js";