ModuleManager.ts 3.2 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143
  1. import { ModuleStatus } from "./BaseModule";
  2. import JobQueue from "./JobQueue";
  3. import { Modules, ModuleClass } from "./types/Modules";
  4. export default class ModuleManager {
  5. static primaryInstance = new this();
  6. private modules?: Modules;
  7. /**
  8. * getStatus - Get status of modules
  9. *
  10. * @returns Module statuses
  11. */
  12. public getStatus() {
  13. const status: Record<string, ModuleStatus> = {};
  14. Object.entries(this.modules || {}).forEach(([name, module]) => {
  15. status[name] = module.getStatus();
  16. });
  17. return status;
  18. }
  19. /**
  20. * Gets a module
  21. *
  22. */
  23. public getModule(moduleName: keyof Modules) {
  24. return this.modules && this.modules[moduleName];
  25. }
  26. /**
  27. * loadModule - Load and initialize module
  28. *
  29. * @param moduleName - Name of the module
  30. * @returns Module
  31. */
  32. private async loadModule<T extends keyof Modules>(moduleName: T) {
  33. const mapper = {
  34. data: "DataModule",
  35. events: "EventsModule",
  36. stations: "StationModule",
  37. websocket: "WebSocketModule"
  38. };
  39. const { default: Module }: { default: ModuleClass<Modules[T]> } =
  40. await import(`./modules/${mapper[moduleName]}`);
  41. return new Module();
  42. }
  43. /**
  44. * loadModules - Load and initialize all modules
  45. *
  46. * @returns Promise
  47. */
  48. private async loadModules() {
  49. this.modules = {
  50. data: await this.loadModule("data"),
  51. events: await this.loadModule("events"),
  52. stations: await this.loadModule("stations"),
  53. websocket: await this.loadModule("websocket")
  54. };
  55. }
  56. /**
  57. * startModule - Start module
  58. */
  59. private async startModule(module: Modules[keyof Modules]) {
  60. switch (module.getStatus()) {
  61. case ModuleStatus.STARTING:
  62. case ModuleStatus.STARTED:
  63. return;
  64. case ModuleStatus.ERROR:
  65. throw new Error("Dependent module failed to start");
  66. case ModuleStatus.STOPPING:
  67. case ModuleStatus.STOPPED:
  68. case ModuleStatus.DISABLED:
  69. throw new Error("Dependent module is unavailable");
  70. default:
  71. break;
  72. }
  73. for (const name of module.getDependentModules()) {
  74. const dependency = this.getModule(name);
  75. if (!dependency) throw new Error("Dependent module not found");
  76. // eslint-disable-next-line no-await-in-loop
  77. await this.startModule(dependency);
  78. }
  79. await module.startup().catch(async err => {
  80. module.setStatus(ModuleStatus.ERROR);
  81. throw err;
  82. });
  83. }
  84. /**
  85. * startup - Handle startup
  86. */
  87. public async startup() {
  88. try {
  89. await this.loadModules();
  90. if (!this.modules) throw new Error("No modules were loaded");
  91. for (const module of Object.values(this.modules)) {
  92. // eslint-disable-next-line no-await-in-loop
  93. await this.startModule(module);
  94. }
  95. JobQueue.getPrimaryInstance().resume();
  96. } catch (err) {
  97. await this.shutdown();
  98. throw err;
  99. }
  100. }
  101. /**
  102. * shutdown - Handle shutdown
  103. */
  104. public async shutdown() {
  105. if (this.modules)
  106. await Promise.all(
  107. Object.values(this.modules).map(async module => {
  108. if (
  109. [
  110. ModuleStatus.STARTED,
  111. ModuleStatus.STARTING,
  112. ModuleStatus.ERROR
  113. ].includes(module.getStatus())
  114. )
  115. await module.shutdown();
  116. })
  117. );
  118. }
  119. static getPrimaryInstance(): ModuleManager {
  120. return this.primaryInstance;
  121. }
  122. static setPrimaryInstance(instance: ModuleManager) {
  123. this.primaryInstance = instance;
  124. }
  125. }