@serve.zone/platformclient 2.3.0 → 3.0.0

package/ts/classes.platformclient.ts

@@ -3,6 +3,10 @@ import { SzSmsConnector } from './email/classes.smsconnector.js';
 import { SzPushNotificationConnector } from './email/classes.pushnotificationconnector.js';
 import { SzLetterConnector } from './email/classes.letterconnector.js';
 import { SzWebPushConnector } from './webpush/classes.webpushconnector.js';
+import {
+  SzCoreMailConnector,
+  type ISzCoreMailConnectorOptions,
+} from './coremail/classes.coremailconnector.js';
 import * as plugins from './plugins.js';
 
 export interface ISzPlatformClientOptions {
@@ -13,6 +17,7 @@ export interface ISzPlatformClientOptions {
   platformUrl?: string;
   binding?: plugins.servezoneInterfaces.platform.IPlatformBinding;
   bindings?: plugins.servezoneInterfaces.platform.IPlatformBinding[];
+  coreMail?: ISzCoreMailConnectorOptions;
 }
 
 export class SzPlatformClient {
@@ -23,19 +28,37 @@ export class SzPlatformClient {
   public typedrouter: plugins.typedrequest.TypedRouter = new plugins.typedrequest.TypedRouter();
   public typedsocket!: plugins.typedsocket.TypedSocket;
   private qenvInstance = new plugins.qenv.Qenv();
+  private stopped = false;
+  private initPromise?: Promise<void>;
+  private stopPromise?: Promise<void>;
+  private readonly platformSocketAbortController = new AbortController();
 
   public emailConnector = new SzEmailConnector(this);
   public smsConnector = new SzSmsConnector(this);
   public pushNotificationConnector = new SzPushNotificationConnector(this);
   public webPushConnector = new SzWebPushConnector(this);
   public letterConnector = new SzLetterConnector(this);
+  public coreMailConnector = new SzCoreMailConnector();
 
   constructor(authorizationStringArg?: string | ISzPlatformClientOptions) {
     this.applyOptions(authorizationStringArg);
   }
 
-  public async init(authorizationStringArg?: string | ISzPlatformClientOptions) {
+  public init(
+    authorizationStringArg?: string | ISzPlatformClientOptions,
+  ): Promise<void> {
+    if (this.stopped) {
+      return Promise.reject(this.createAbortError());
+    }
+    if (this.initPromise) {
+      return this.initPromise;
+    }
     this.applyOptions(authorizationStringArg);
+    this.initPromise = this.initInner();
+    return this.initPromise;
+  }
+
+  private async initInner(): Promise<void> {
     if (!this.authorizationString) {
       this.authorizationString = await this.getConfiguredAuthorizationString();
     }
@@ -48,19 +71,33 @@ export class SzPlatformClient {
       this.platformBindings,
       await this.discoverPlatformBindings()
     );
-    if (!this.authorizationString) {
-      this.authorizationString = this.getAuthorizationStringFromBindings();
-    }
-    if (!this.authorizationString) throw new Error('authorizationString is required');
-    if (this.authorizationString === 'test') {
-      this.activateDebugMode();
+    if (!this.authorizationString && this.coreMailConnector.isConfigured) {
+      await this.coreMailConnector.init();
+      this.assertRunning();
       return;
     }
-    this.typedsocket = await plugins.typedsocket.TypedSocket.createClient(
+    if (!this.authorizationString) throw new Error('authorizationString is required');
+    const socket = await plugins.typedsocket.TypedSocket.createClient(
       this.typedrouter as any,
-      await this.getConnectionAddress()
+      await this.getConnectionAddress(),
+      { abortSignal: this.platformSocketAbortController.signal },
     );
-    await this.setAuthorizationTag();
+    if (this.stopped) {
+      await socket.stop().catch(() => undefined);
+      throw this.createAbortError();
+    }
+    this.typedsocket = socket;
+    try {
+      await this.setAuthorizationTag();
+      this.assertRunning();
+      if (this.coreMailConnector.isConfigured) {
+        await this.coreMailConnector.init();
+        this.assertRunning();
+      }
+    } catch (error) {
+      await socket.stop().catch(() => undefined);
+      throw error;
+    }
   }
 
   private activateDebugMode() {
@@ -101,6 +138,9 @@ export class SzPlatformClient {
         Boolean
       ) as plugins.servezoneInterfaces.platform.IPlatformBinding[]
     );
+    if (optionsArg.coreMail) {
+      this.coreMailConnector.configure(optionsArg.coreMail);
+    }
   }
 
   private async getConnectionAddress() {
@@ -143,26 +183,6 @@ export class SzPlatformClient {
     );
   }
 
-  private getAuthorizationStringFromBindings() {
-    const authEnvNames = [
-      'SERVEZONE_PLATFORM_AUTHORIZATION',
-      'SERVEZONE_PLATFORM_TOKEN',
-      'SERVEZONE_API_TOKEN',
-      'AUTHORIZATION',
-      'TOKEN',
-    ];
-    for (const binding of this.platformBindings) {
-      for (const credential of binding.credentials || []) {
-        for (const envName of authEnvNames) {
-          const value = credential.env?.[envName];
-          if (value) {
-            return value;
-          }
-        }
-      }
-    }
-  }
-
   private async setAuthorizationTag() {
     if (!this.authorizationString) {
       return;
@@ -176,16 +196,39 @@ export class SzPlatformClient {
     }
   }
 
-  public async stop(): Promise<void> {
-    await Promise.all([
+  public stop(): Promise<void> {
+    this.stopPromise ??= this.stopInner();
+    return this.stopPromise;
+  }
+
+  private async stopInner(): Promise<void> {
+    this.stopped = true;
+    this.platformSocketAbortController.abort(this.createAbortError());
+    const socket = this.typedsocket;
+    await Promise.allSettled([
       this.emailConnector.stop(),
       this.webPushConnector.stop(),
+      this.coreMailConnector.stop(),
+      socket?.stop(),
+      this.initPromise,
     ]);
-    if (this.typedsocket) {
-      await this.typedsocket.stop();
+    if (this.typedsocket && this.typedsocket !== socket) {
+      await this.typedsocket.stop().catch(() => undefined);
     }
   }
 
+  private assertRunning(): void {
+    if (this.stopped) {
+      throw this.createAbortError();
+    }
+  }
+
+  private createAbortError(): Error {
+    const error = new Error('Platform client operation aborted.');
+    error.name = 'AbortError';
+    return error;
+  }
+
   private async discoverPlatformBindings() {
     const bindings: plugins.servezoneInterfaces.platform.IPlatformBinding[] = [];
     const envBindings = await this.getConfiguredEnvVar('SERVEZONE_PLATFORM_BINDINGS');