@datacapy/server 0.1.0

package/dist/server/interfaces.d.ts

@@ -0,0 +1,70 @@
+import { ServerConfig } from '../server-config';
+import { ServerApiConfig } from '../api-config';
+import ServerAclRoleAssessor from '../acl/role-assessor';
+export interface LoggerInterface {
+    error(message: any, ...optionalParams: any[]): void;
+    warn?(message: any, ...optionalParams: any[]): void;
+    info?(message: any, ...optionalParams: any[]): void;
+    debug?(message: any, ...optionalParams: any[]): void;
+}
+export interface ModelManagerInterface {
+    services: {
+        [key: string]: any;
+    };
+    repos: {
+        [key: string]: any;
+    };
+    init(): Promise<any>;
+    shutdown(): Promise<any>;
+    setLogger(logger: any): void;
+}
+export interface ConfigurationManagerInterface {
+    getConfig(): ServerConfig;
+    getModelManager(): ModelManagerInterface;
+    setLogger(logger: LoggerInterface): void;
+}
+export interface LifecycleManagerInterface {
+    addInitialiser(initialiser: Function, stage?: string): void;
+    addInitialisers(initialisers: Function[], stage?: string): void;
+    runInitialisers(stage: string | undefined, context: any): Promise<void>;
+    addShutdownHandler(handler: Function, stage?: string): void;
+    addShutdownHandlers(handlers: Function[], stage?: string): void;
+    runShutdownHandlers(stage?: string): Promise<void>;
+}
+export interface ExpressAppManagerInterface {
+    getApp(): any;
+    getRouter(): any;
+    mountRouter(path: string): void;
+    setupErrorHandler(logger: LoggerInterface): void;
+}
+export interface HttpServerManagerInterface {
+    start(): Promise<void>;
+    shutdown(): Promise<any>;
+    getServer(): any;
+}
+export interface AclRegistryInterface {
+    addRoleAssessor(roleAssessor: ServerAclRoleAssessor): void;
+    addRoleAssessors(roleAssessors: ServerAclRoleAssessor[]): void;
+    getRoleAssessors(): {
+        [key: string]: any;
+    };
+}
+export interface ApiConfigRegistryInterface {
+    addApiConfig(config: ServerApiConfig): void;
+    addApiConfigs(configs: ServerApiConfig[]): void;
+    getApiConfigs(): ServerApiConfig[];
+}
+export interface EndpointRegistrarInterface {
+    registerEndpoints(): void;
+}
+export interface ServerInterface {
+    config: ServerConfig;
+    modelManager: ModelManagerInterface;
+    logger: LoggerInterface;
+    app: any;
+    router: any;
+    aclRoleAssessor: {
+        [key: string]: any;
+    };
+}
+//# sourceMappingURL=interfaces.d.ts.map

package/dist/server/interfaces.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interfaces.d.ts","sourceRoot":"","sources":["../../src/server/interfaces.ts"],"names":[],"mappings":"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"}

package/dist/server/interfaces.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=interfaces.js.map

package/dist/server/interfaces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interfaces.js","sourceRoot":"","sources":["../../src/server/interfaces.ts"],"names":[],"mappings":""}

package/dist/server/lifecycle-manager.d.ts

@@ -0,0 +1,19 @@
+import { LifecycleManagerInterface } from './interfaces';
+export declare class LifecycleManager implements LifecycleManagerInterface {
+    private initialisers;
+    private shutdownHandlers;
+    constructor();
+    addInitialiser(initialiser: Function, stage?: string): void;
+    addInitialisers(initialisers: Function[], stage?: string): void;
+    runInitialisers(stage: string | undefined, context: any): Promise<void>;
+    addShutdownHandler(handler: Function, stage?: string): void;
+    addShutdownHandlers(handlers: Function[], stage?: string): void;
+    runShutdownHandlers(stage?: string): Promise<void>;
+    getInitialisers(): {
+        [key: string]: any[];
+    };
+    getShutdownHandlers(): {
+        [key: string]: any[];
+    };
+}
+//# sourceMappingURL=lifecycle-manager.d.ts.map

package/dist/server/lifecycle-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle-manager.d.ts","sourceRoot":"","sources":["../../src/server/lifecycle-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAA;AAMxD,qBAAa,gBAAiB,YAAW,yBAAyB;IAChE,OAAO,CAAC,YAAY,CAA0B;IAC9C,OAAO,CAAC,gBAAgB,CAA0B;;IAOlD,cAAc,CAAC,WAAW,EAAE,QAAQ,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI;IAQ3D,eAAe,CAAC,YAAY,EAAE,QAAQ,EAAE,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI;IAMzD,eAAe,CACnB,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,OAAO,EAAE,GAAG,GACX,OAAO,CAAC,IAAI,CAAC;IAYhB,kBAAkB,CAAC,OAAO,EAAE,QAAQ,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI;IAQ3D,mBAAmB,CAAC,QAAQ,EAAE,QAAQ,EAAE,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI;IAMzD,mBAAmB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAUxD,eAAe,IAAI;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,EAAE,CAAA;KAAE;IAI3C,mBAAmB,IAAI;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,EAAE,CAAA;KAAE;CAGhD"}

package/dist/server/lifecycle-manager.js

@@ -0,0 +1,60 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LifecycleManager = void 0;
+class LifecycleManager {
+    constructor() {
+        this.initialisers = {};
+        this.shutdownHandlers = {};
+    }
+    addInitialiser(initialiser, stage) {
+        stage = stage ? stage : 'default';
+        if (this.initialisers[stage] === undefined) {
+            this.initialisers[stage] = [];
+        }
+        this.initialisers[stage].push(initialiser);
+    }
+    addInitialisers(initialisers, stage) {
+        initialisers.forEach((initialiser) => {
+            this.addInitialiser(initialiser, stage);
+        });
+    }
+    async runInitialisers(stage, context) {
+        stage = stage ? stage : 'default';
+        if (this.initialisers[stage]) {
+            for (const initFunction of this.initialisers[stage]) {
+                const shutdownHandler = await Promise.resolve(initFunction(context));
+                if (typeof shutdownHandler == 'function') {
+                    this.addShutdownHandler(shutdownHandler, stage);
+                }
+            }
+        }
+    }
+    addShutdownHandler(handler, stage) {
+        stage = stage ? stage : 'default';
+        if (this.shutdownHandlers[stage] === undefined) {
+            this.shutdownHandlers[stage] = [];
+        }
+        this.shutdownHandlers[stage].unshift(handler);
+    }
+    addShutdownHandlers(handlers, stage) {
+        handlers.forEach((handler) => {
+            this.addShutdownHandler(handler, stage);
+        });
+    }
+    async runShutdownHandlers(stage) {
+        stage = stage ? stage : 'default';
+        if (this.shutdownHandlers[stage] && this.shutdownHandlers[stage].length) {
+            for (const handler of this.shutdownHandlers[stage]) {
+                await Promise.resolve(handler());
+            }
+        }
+    }
+    getInitialisers() {
+        return this.initialisers;
+    }
+    getShutdownHandlers() {
+        return this.shutdownHandlers;
+    }
+}
+exports.LifecycleManager = LifecycleManager;
+//# sourceMappingURL=lifecycle-manager.js.map

package/dist/server/lifecycle-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle-manager.js","sourceRoot":"","sources":["../../src/server/lifecycle-manager.ts"],"names":[],"mappings":";;;AAMA,MAAa,gBAAgB;IAI3B;QACE,IAAI,CAAC,YAAY,GAAG,EAAE,CAAA;QACtB,IAAI,CAAC,gBAAgB,GAAG,EAAE,CAAA;IAC5B,CAAC;IAED,cAAc,CAAC,WAAqB,EAAE,KAAc;QAClD,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAA;QACjC,IAAI,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,KAAK,SAAS,EAAE,CAAC;YAC3C,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,GAAG,EAAE,CAAA;QAC/B,CAAC;QACD,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAA;IAC5C,CAAC;IAED,eAAe,CAAC,YAAwB,EAAE,KAAc;QACtD,YAAY,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,EAAE;YACnC,IAAI,CAAC,cAAc,CAAC,WAAW,EAAE,KAAK,CAAC,CAAA;QACzC,CAAC,CAAC,CAAA;IACJ,CAAC;IAED,KAAK,CAAC,eAAe,CACnB,KAAyB,EACzB,OAAY;QAEZ,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAA;QACjC,IAAI,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC;YAC7B,KAAK,MAAM,YAAY,IAAI,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC;gBACpD,MAAM,eAAe,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAA;gBACpE,IAAI,OAAO,eAAe,IAAI,UAAU,EAAE,CAAC;oBACzC,IAAI,CAAC,kBAAkB,CAAC,eAAe,EAAE,KAAK,CAAC,CAAA;gBACjD,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,kBAAkB,CAAC,OAAiB,EAAE,KAAc;QAClD,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAA;QACjC,IAAI,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,KAAK,SAAS,EAAE,CAAC;YAC/C,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,GAAG,EAAE,CAAA;QACnC,CAAC;QACD,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;IAC/C,CAAC;IAED,mBAAmB,CAAC,QAAoB,EAAE,KAAc;QACtD,QAAQ,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;YAC3B,IAAI,CAAC,kBAAkB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAA;QACzC,CAAC,CAAC,CAAA;IACJ,CAAC;IAED,KAAK,CAAC,mBAAmB,CAAC,KAAc;QACtC,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAA;QACjC,IAAI,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC,MAAM,EAAE,CAAC;YACxE,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,EAAE,CAAC;gBACnD,MAAM,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,CAAA;YAClC,CAAC;QACH,CAAC;IACH,CAAC;IAGD,eAAe;QACb,OAAO,IAAI,CAAC,YAAY,CAAA;IAC1B,CAAC;IAED,mBAAmB;QACjB,OAAO,IAAI,CAAC,gBAAgB,CAAA;IAC9B,CAAC;CACF;AArED,4CAqEC"}

package/dist/server-config.d.ts

@@ -0,0 +1,10 @@
+import { ModelManagerConfig } from '@datacapy/om';
+export interface ServerConfig {
+    path: string;
+    port?: number;
+    appDir?: string;
+    model?: ModelManagerConfig;
+    [key: string]: any;
+}
+export default ServerConfig;
+//# sourceMappingURL=server-config.d.ts.map

package/dist/server-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-config.d.ts","sourceRoot":"","sources":["../src/server-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAA;AAEjD,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,kBAAkB,CAAA;IAC1B,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;CACnB;AAED,eAAe,YAAY,CAAA"}

package/dist/server-config.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=server-config.js.map

package/dist/server-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-config.js","sourceRoot":"","sources":["../src/server-config.ts"],"names":[],"mappings":""}

package/dist/server.d.ts

@@ -0,0 +1,53 @@
+import * as _Http from 'http';
+import express from 'express';
+import { ModelManager } from '@datacapy/om';
+import { ServerConfig } from './server-config';
+import { ServerApiConfig } from './api-config';
+import ServerAclRoleAssessor from './acl/role-assessor';
+import { ErrorTranslator } from './remote-object/interfaces';
+export declare class Server {
+    modelManager: ModelManager | any;
+    config: ServerConfig;
+    apiConfigs: Array<ServerApiConfig>;
+    app: express.Application;
+    server: _Http.Server | null;
+    router: express.Router;
+    aclRoleAssessor: {
+        [key: string]: any;
+    };
+    logger: any;
+    initialisers: {
+        [key: string]: any[];
+    };
+    shutdownHandlers: {
+        [key: string]: any[];
+    };
+    initialised: boolean;
+    private configurationManager;
+    private lifecycleManager;
+    private expressAppManager;
+    private httpServerManager;
+    private aclRegistry;
+    private apiConfigRegistry;
+    private endpointRegistrar;
+    constructor(options?: ServerConfig, modelManager?: ModelManager);
+    setLogger(logger: any): this;
+    setErrorTranslator(errorTranslator: ErrorTranslator): this;
+    init(): Promise<void>;
+    runInitialisers(stage?: string): Promise<void>;
+    addInitialiser(initialiser: any, stage?: string): void;
+    addInitialisers(initialisers: any, stage?: string): void;
+    addShutdownHandler(handler: any, stage?: string): void;
+    addShutdownHandlers(handlers: any, stage?: string): void;
+    runShutdownHandlers(stage?: string): Promise<void>;
+    addRoleAssessor(roleAssessor: ServerAclRoleAssessor): void;
+    addRoleAssessors(roleAssessors: ServerAclRoleAssessor[]): void;
+    addApiConfig(config: ServerApiConfig): void;
+    addApiConfigs(configs: Array<ServerApiConfig>): void;
+    registerEndpoints(): void;
+    registerEndpointsConfig(config: ServerApiConfig): void;
+    start(): Promise<void>;
+    shutdown(): Promise<any>;
+}
+export default Server;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,MAAM,CAAA;AAC7B,OAAO,OAAO,MAAM,SAAS,CAAA;AAC7B,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAE3C,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAC9C,OAAO,qBAAqB,MAAM,qBAAqB,CAAA;AAUvD,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAA;AAM5D,qBAAa,MAAM;IAEjB,YAAY,EAAE,YAAY,GAAG,GAAG,CAAA;IAChC,MAAM,EAAE,YAAY,CAAA;IACpB,UAAU,EAAE,KAAK,CAAC,eAAe,CAAC,CAAA;IAClC,GAAG,EAAE,OAAO,CAAC,WAAW,CAAA;IACxB,MAAM,EAAE,KAAK,CAAC,MAAM,GAAG,IAAI,CAAA;IAC3B,MAAM,EAAE,OAAO,CAAC,MAAM,CAAA;IACtB,eAAe,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;KAAE,CAAA;IACvC,MAAM,EAAE,GAAG,CAAA;IACX,YAAY,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,EAAE,CAAA;KAAE,CAAA;IACtC,gBAAgB,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,EAAE,CAAA;KAAE,CAAA;IAC1C,WAAW,EAAE,OAAO,CAAA;IAGpB,OAAO,CAAC,oBAAoB,CAAsB;IAClD,OAAO,CAAC,gBAAgB,CAAkB;IAC1C,OAAO,CAAC,iBAAiB,CAAmB;IAC5C,OAAO,CAAC,iBAAiB,CAAmB;IAC5C,OAAO,CAAC,WAAW,CAAa;IAChC,OAAO,CAAC,iBAAiB,CAAmB;IAC5C,OAAO,CAAC,iBAAiB,CAAmB;gBAEhC,OAAO,CAAC,EAAE,YAAY,EAAE,YAAY,CAAC,EAAE,YAAY;IAqD/D,SAAS,CAAC,MAAM,KAAA,GAAG,IAAI;IASvB,kBAAkB,CAAC,eAAe,EAAE,eAAe,GAAG,IAAI;IAKpD,IAAI;IA2BJ,eAAe,CAAC,KAAK,CAAC,EAAE,MAAM;IAIpC,cAAc,CAAC,WAAW,KAAA,EAAE,KAAK,CAAC,EAAE,MAAM;IAI1C,eAAe,CAAC,YAAY,KAAA,EAAE,KAAK,CAAC,EAAE,MAAM;IAI5C,kBAAkB,CAAC,OAAO,KAAA,EAAE,KAAK,CAAC,EAAE,MAAM;IAI1C,mBAAmB,CAAC,QAAQ,KAAA,EAAE,KAAK,CAAC,EAAE,MAAM;IAItC,mBAAmB,CAAC,KAAK,CAAC,EAAE,MAAM;IAIxC,eAAe,CAAC,YAAY,EAAE,qBAAqB;IAInD,gBAAgB,CAAC,aAAa,EAAE,qBAAqB,EAAE;IAIvD,YAAY,CAAC,MAAM,EAAE,eAAe;IAIpC,aAAa,CAAC,OAAO,EAAE,KAAK,CAAC,eAAe,CAAC;IAI7C,iBAAiB;IAIjB,uBAAuB,CAAC,MAAM,EAAE,eAAe;IAIzC,KAAK;IAIL,QAAQ;CAgBf;AAED,eAAe,MAAM,CAAA"}

package/dist/server.js

@@ -0,0 +1,115 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Server = void 0;
+const index_1 = require("./server/index");
+class Server {
+    constructor(options, modelManager) {
+        this.configurationManager = new index_1.ConfigurationManager(options, modelManager);
+        this.lifecycleManager = new index_1.LifecycleManager();
+        this.expressAppManager = new index_1.ExpressAppManager(this.configurationManager.getConfig(), console);
+        this.aclRegistry = new index_1.AclRegistry();
+        this.apiConfigRegistry = new index_1.ApiConfigRegistry();
+        this.logger = console;
+        this.endpointRegistrar = new index_1.EndpointRegistrar(this.configurationManager, this.expressAppManager, this.aclRegistry, this.apiConfigRegistry, this.logger);
+        this.httpServerManager = new index_1.HttpServerManager(this.expressAppManager.getApp(), this.configurationManager.getConfig(), this.logger, () => this.shutdown());
+        this.config = this.configurationManager.getConfig();
+        this.modelManager = this.configurationManager.getModelManager();
+        this.app = this.expressAppManager.getApp();
+        this.router = this.expressAppManager.getRouter();
+        this.aclRoleAssessor = this.aclRegistry.getRoleAssessors();
+        this.apiConfigs = this.apiConfigRegistry.getApiConfigs();
+        this.server = null;
+        this.initialised = false;
+        Object.defineProperty(this, 'initialisers', {
+            get: () => this.lifecycleManager.getInitialisers(),
+        });
+        Object.defineProperty(this, 'shutdownHandlers', {
+            get: () => this.lifecycleManager.getShutdownHandlers(),
+        });
+        Object.defineProperty(this, 'server', {
+            get: () => this.httpServerManager.getServer(),
+        });
+    }
+    setLogger(logger) {
+        this.logger = logger;
+        this.configurationManager.setLogger(logger);
+        this.expressAppManager['logger'] = logger;
+        this.httpServerManager['logger'] = logger;
+        this.endpointRegistrar['logger'] = logger;
+        return this;
+    }
+    setErrorTranslator(errorTranslator) {
+        this.endpointRegistrar['errorTranslator'] = errorTranslator;
+        return this;
+    }
+    async init() {
+        if (!this.initialised) {
+            await this.lifecycleManager.runInitialisers(undefined, this);
+            await this.lifecycleManager.runInitialisers('00-init', this);
+            await this.modelManager.init();
+            await this.lifecycleManager.runInitialisers('01-model-initialised', this);
+            await this.lifecycleManager.runInitialisers('02-resources-loaded', this);
+            this.endpointRegistrar.registerEndpoints();
+            await this.lifecycleManager.runInitialisers('03-endpoints-registered', this);
+            this.expressAppManager.mountRouter(this.config.path);
+            await this.lifecycleManager.runInitialisers('04-router-mounted', this);
+            this.expressAppManager.setupErrorHandler(this.logger);
+            await this.lifecycleManager.runInitialisers('99-final', this);
+            this.initialised = true;
+        }
+    }
+    async runInitialisers(stage) {
+        await this.lifecycleManager.runInitialisers(stage, this);
+    }
+    addInitialiser(initialiser, stage) {
+        this.lifecycleManager.addInitialiser(initialiser, stage);
+    }
+    addInitialisers(initialisers, stage) {
+        this.lifecycleManager.addInitialisers(initialisers, stage);
+    }
+    addShutdownHandler(handler, stage) {
+        this.lifecycleManager.addShutdownHandler(handler, stage);
+    }
+    addShutdownHandlers(handlers, stage) {
+        this.lifecycleManager.addShutdownHandlers(handlers, stage);
+    }
+    async runShutdownHandlers(stage) {
+        await this.lifecycleManager.runShutdownHandlers(stage);
+    }
+    addRoleAssessor(roleAssessor) {
+        this.aclRegistry.addRoleAssessor(roleAssessor);
+    }
+    addRoleAssessors(roleAssessors) {
+        this.aclRegistry.addRoleAssessors(roleAssessors);
+    }
+    addApiConfig(config) {
+        this.apiConfigRegistry.addApiConfig(config);
+    }
+    addApiConfigs(configs) {
+        this.apiConfigRegistry.addApiConfigs(configs);
+    }
+    registerEndpoints() {
+        this.endpointRegistrar.registerEndpoints();
+    }
+    registerEndpointsConfig(config) {
+        this.endpointRegistrar['registerEndpointsConfig'](config);
+    }
+    async start() {
+        await this.httpServerManager.start();
+    }
+    async shutdown() {
+        this.logger.info('Shutting down');
+        await this.lifecycleManager.runShutdownHandlers('99-final');
+        await this.lifecycleManager.runShutdownHandlers('04-router-mounted');
+        await this.lifecycleManager.runShutdownHandlers('03-endpoints-registered');
+        await this.lifecycleManager.runShutdownHandlers('02-resources-loaded');
+        await this.lifecycleManager.runShutdownHandlers('01-model-initialised');
+        await this.modelManager.shutdown();
+        await this.lifecycleManager.runShutdownHandlers('00-init');
+        await this.lifecycleManager.runShutdownHandlers();
+        return this.httpServerManager.shutdown();
+    }
+}
+exports.Server = Server;
+exports.default = Server;
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "@datacapy/server",
+  "type": "commonjs",
+  "version": "0.1.0",
+  "description": "Datacapy server: REST API server over the object model",
+  "main": "dist/index",
+  "types": "dist/index.d.ts",
+  "author": "Kevin Foster <kevin.foster.uk@gmail.com>",
+  "license": "BSD-3-Clause",
+  "homepage": "https://github.com/datacapy/datacapy#readme",
+  "bugs": {
+    "url": "https://github.com/datacapy/datacapy/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/datacapy/datacapy.git",
+    "directory": "package/server"
+  },
+  "devDependencies": {
+    "@eslint/js": "^10.0.1",
+    "@types/bcrypt": "^6.0.0",
+    "@types/express": "^5.0.6",
+    "@types/jest": "^30.0.0",
+    "@types/node": "^25.9.8",
+    "eslint": "^10.11.0",
+    "husky": "^9.1.7",
+    "jest": "^30.5.2",
+    "lint-staged": "^15.5.2",
+    "prettier": "3.9.9",
+    "ts-jest": "^29.4.14",
+    "ts-node": "^10.9.2",
+    "typescript": "^6.0.3",
+    "typescript-eslint": "^8.71.0"
+  },
+  "dependencies": {
+    "bcryptjs": "^3.0.3",
+    "body-parser": "^2.3.0",
+    "express": "^5.2.1",
+    "merge": "^2.1.1",
+    "mongodb": "^6.21.0",
+    "@datacapy/om": "0.1.0"
+  },
+  "files": [
+    "/dist",
+    "/tsconfig.json"
+  ],
+  "lint-staged": {
+    "**/*": "prettier --write --ignore-unknown"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "pnpm run clean && tsc && pnpm run build-minimise",
+    "build-minimise": "find ./dist -type f -name '*.test.js' -delete && find ./dist -type f -name '*.test.js.map' -delete && find ./dist -type f -name '*.test.d.ts' -delete && find ./dist -type f -name '*.test.d.ts.map' -delete && find ./dist -type d -name 'test' -exec rm -rf {} + && find ./dist -type d -name 'test-utils' -exec rm -rf {} +",
+    "clean": "rm -fr ./dist/*",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:coverage": "jest --coverage",
+    "typecheck": "tsc --noEmit",
+    "test-fixtures-build": "cd ./src/test/fixtures && tsc",
+    "test-fixtures-clean": "find ./src/test/fixtures -type f \\( -name '*.js' -or -name '*.js.map' -or -name '*.d.ts' \\) -delete",
+    "prettier:check": "prettier --check src",
+    "format": "prettier --write src"
+  }
+}

package/tsconfig.json

@@ -0,0 +1,27 @@
+{
+  "compilerOptions": {
+    "target": "es2019",
+    "module": "commonjs",
+    "allowJs": false,
+    "strict": false,
+    "noImplicitAny": false,
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "baseUrl": "./src",
+    "ignoreDeprecations": "6.0",
+    "paths": {
+      "*": ["*"]
+    },
+    "removeComments": true,
+    "esModuleInterop": true,
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "skipLibCheck": true,
+    "types": ["node", "jest"],
+    "allowSyntheticDefaultImports": true,
+    "forceConsistentCasingInFileNames": true
+  },
+  "include": ["src/**/*", "src/**/_tests/*"],
+  "exclude": ["node_modules", "src/test-utils"]
+}