taon 21.0.53 → 21.0.55

package/lib-prod/realtime/realtime-client.js

@@ -1,107 +1,125 @@
-import { Observable } from "rxjs";
-import { ___NS__isObject, ___NS__isString } from "tnp-core/lib-prod";
-import { Helpers__NS__logInfo } from "tnp-core/lib-prod";
-import { ClassHelpers__NS__getClassFnFromObject, ClassHelpers__NS__getName, ClassHelpers__NS__getUniqueKey } from "../helpers/class-helpers";
-import { Symbols__NS__REALTIME } from "../symbols";
-import { RealtimeSubsManager } from "./realtime-subs-manager";
-class RealtimeClient {
-  constructor(core) {
-    this.core = core;
-    this.core = core;
-    if (!core.ctx.disabledRealtime) {
-      this.init();
+//#region imports
+import { Observable } from 'rxjs';
+import { ___NS__isObject, ___NS__isString } from 'tnp-core/lib-prod';
+import { Helpers__NS__logInfo } from 'tnp-core/lib-prod';
+import { ClassHelpers__NS__getClassFnFromObject, ClassHelpers__NS__getName, ClassHelpers__NS__getUniqueKey } from '../helpers/class-helpers';
+import { Symbols__NS__REALTIME } from '../symbols';
+import { RealtimeSubsManager } from './realtime-subs-manager';
+//#endregion
+/**
+ * Client for realtime communication
+ * you can listen to:
+ * - entity changes (any property in table changed)
+ * - entity custom property changes (specific property changed)
+ * - entity table changes (new instance added, instance removed)
+ * - custom events
+ */
+export class RealtimeClient {
+    constructor(core) {
+        this.core = core;
+        this.subsManagers = {};
+        this.core = core;
+        if (!core.ctx.disabledRealtime) {
+            // this.core.ctx.logRealtime &&
+            //   Helpers__NS__info(`
+            //   [ctx=${this.core.ctx.contextName}] init RealtimeClient (type: ${this.core.ctx.contextType})
+            //   `);
+            this.init();
+        }
     }
-  }
-  subsManagers = {};
-  //#region methods & getters / init
-  init() {
-    const nspPath = {
-      global: this.core.pathFor(),
-      realtime: this.core.pathFor(
-        Symbols__NS__REALTIME.NAMESPACE(this.core.ctx.contextName)
-      )
-    };
-    if (this.core.ctx.config.frontendHost && this.core.ctx.config.frontendHost !== "" && this.core.ctx.isRunningInsideDocker) {
-      this.core.ctx.logRealtime && Helpers__NS__logInfo(
-        `[${this.core.ctx.contextName}] USING FRONTEND HOST ${this.core.ctx.config.frontendHost} FOR REALTIME`
-      );
-      nspPath.global = new URL(
-        `${this.core.ctx.frontendHostUri.origin}${nspPath.global.pathname}`
-      );
-      nspPath.realtime = new URL(
-        `${this.core.ctx.frontendHostUri.origin}${nspPath.realtime.pathname}`
-      );
-    } else {
-      this.core.ctx.logRealtime && Helpers__NS__logInfo(
-        `[${this.core.ctx.contextName}] Not using frontend host for realtime`
-      );
-    }
-    this.core.ctx.logRealtime && console.info(
-      "[CLIENT] NAMESPACE GLOBAL ",
-      nspPath.global.href + ` host: ${this.core.ctx.host}`
-    );
-    this.core.ctx.logRealtime && console.info(
-      "[CLIENT] NAMESPACE REALTIME",
-      nspPath.realtime.href + ` host: ${this.core.ctx.host}`
-    );
-    this.core.conectSocketFE = this.core.strategy.ioClient(
-      nspPath.global.origin,
-      {
-        path: nspPath.global.pathname
-      }
-    );
-    if (this.core.conectSocketFE.on) {
-      this.core.conectSocketFE.on("connect", () => {
-        this.core.ctx.logRealtime && console.info(
-          `[CLIENT] connected to GLOBAL namespace ${nspPath.global.pathname} of host: ${this.core.ctx.host}`
-        );
-      });
-    }
-    this.core.socketFE = this.core.strategy.ioClient(nspPath.realtime.origin, {
-      path: nspPath.realtime.pathname
-    });
-    if (this.core.socketFE.on) {
-      this.core.socketFE.on("connect", () => {
-        this.core.ctx.logRealtime && console.info(
-          `[CLIENT] connected to REALTIME namespace ${nspPath.realtime.pathname} host: ${this.core.ctx.host}`
-        );
-      });
-    }
-  }
-  //#endregion
-  //#region methods & getters  / listen changes entity
-  /**
-   * Usage:
-   * myContext.realtimeClient.listenChangesEntity(myEntityInstance);
-   *
-   *
-   * Changes trigger on backend needs to be done manually.. example code:
-   *
-   * myContext.realtimeServer.triggerEntityChanges(myEntityInstance);
-   * ...
-   */
-  listenChangesEntity(entityClassFnOrObj, options) {
-    options = options || {};
-    if (___NS__isObject(entityClassFnOrObj)) {
-      const orgObj = entityClassFnOrObj;
-      entityClassFnOrObj = ClassHelpers__NS__getClassFnFromObject(entityClassFnOrObj);
-      const uniqueKey = ClassHelpers__NS__getUniqueKey(entityClassFnOrObj);
-      if (uniqueKey) {
-        options.idOrUniqValue = orgObj[uniqueKey];
-      }
-    }
-    const { property, customEvent } = options;
-    const className = !customEvent && ClassHelpers__NS__getName(entityClassFnOrObj);
-    if (___NS__isString(property)) {
-      if (property.trim() === "") {
-        throw new Error(
-          `[Taon][listenChangesEntity.. incorrect property '' for ${className}`
-        );
-      }
+    //#region methods & getters / init
+    init() {
+        //#region prepare naspaces pathes
+        const nspPath = {
+            global: this.core.pathFor(),
+            realtime: this.core.pathFor(Symbols__NS__REALTIME.NAMESPACE(this.core.ctx.contextName)),
+        };
+        // console.log('[browser] nspPath', nspPath);
+        if (this.core.ctx.config.frontendHost &&
+            this.core.ctx.config.frontendHost !== '' &&
+            this.core.ctx.isRunningInsideDocker) {
+            this.core.ctx.logRealtime &&
+                Helpers__NS__logInfo(`[${this.core.ctx.contextName}] USING FRONTEND HOST` +
+                    ` ${this.core.ctx.config.frontendHost} FOR REALTIME`);
+            nspPath.global = new URL(`${this.core.ctx.frontendHostUri.origin}${nspPath.global.pathname}`);
+            nspPath.realtime = new URL(`${this.core.ctx.frontendHostUri.origin}${nspPath.realtime.pathname}`);
+        }
+        else {
+            this.core.ctx.logRealtime &&
+                Helpers__NS__logInfo(`[${this.core.ctx.contextName}] Not using frontend host for realtime`);
+        }
+        this.core.ctx.logRealtime &&
+            console.info('[CLIENT] NAMESPACE GLOBAL ', nspPath.global.href + ` host: ${this.core.ctx.host}`);
+        this.core.ctx.logRealtime &&
+            console.info('[CLIENT] NAMESPACE REALTIME', nspPath.realtime.href + ` host: ${this.core.ctx.host}`);
+        //#endregion
+        //#region prepare globa FE socket
+        this.core.conectSocketFE = this.core.strategy.ioClient(nspPath.global.origin, {
+            path: nspPath.global.pathname,
+        });
+        if (this.core.conectSocketFE.on) {
+            this.core.conectSocketFE.on('connect', () => {
+                // console.info(
+                //   `[CLIENT] connected to GLOBAL namespace ${global.nsp} of host: ${context.host}`,
+                // );
+                this.core.ctx.logRealtime &&
+                    console.info(`[CLIENT] connected to GLOBAL namespace ${nspPath.global.pathname}` +
+                        ` of host: ${this.core.ctx.host}`);
+            });
+        }
+        //#endregion
+        //#region prepare realtime FE socket
+        this.core.socketFE = this.core.strategy.ioClient(nspPath.realtime.origin, {
+            path: nspPath.realtime.pathname,
+        });
+        if (this.core.socketFE.on) {
+            this.core.socketFE.on('connect', () => {
+                // console.info(
+                //   `[CLIENT] connected to REALTIME namespace ${realtime.nsp} host: ${context.host}`,
+                // );
+                this.core.ctx.logRealtime &&
+                    console.info(`[CLIENT] connected to REALTIME namespace ${nspPath.realtime.pathname}` +
+                        ` host: ${this.core.ctx.host}`);
+            });
+        }
+        //#endregion
     }
-    return new Observable((observer) => {
-      if (this.core.ctx.disabledRealtime) {
-        console.error(`[Taon][realtime rxjs] remove taon config flag:
+    //#endregion
+    //#region methods & getters  / listen changes entity
+    /**
+     * Usage:
+     * myContext.realtimeClient.listenChangesEntity(myEntityInstance);
+     *
+     *
+     * Changes trigger on backend needs to be done manually.. example code:
+     *
+     * myContext.realtimeServer.triggerEntityChanges(myEntityInstance);
+     * ...
+     */
+    listenChangesEntity(entityClassFnOrObj, options) {
+        options = options || {};
+        if (___NS__isObject(entityClassFnOrObj)) {
+            const orgObj = entityClassFnOrObj;
+            entityClassFnOrObj =
+                ClassHelpers__NS__getClassFnFromObject(entityClassFnOrObj);
+            const uniqueKey = ClassHelpers__NS__getUniqueKey(entityClassFnOrObj);
+            if (uniqueKey) {
+                options.idOrUniqValue = orgObj[uniqueKey];
+            }
+        }
+        //#region parameters validation
+        const { property, customEvent } = options;
+        const className = !customEvent && ClassHelpers__NS__getName(entityClassFnOrObj);
+        if (___NS__isString(property)) {
+            if (property.trim() === '') {
+                throw new Error(`[Taon][listenChangesEntity.. incorrect property '' for ${className}`);
+            }
+        }
+        //#endregion
+        return new Observable(observer => {
+            //#region prepare parameters for manager
+            if (this.core.ctx.disabledRealtime) {
+                console.error(`[Taon][realtime rxjs] remove taon config flag:
 
         ...
         disabledRealtime: true
@@ -109,88 +127,72 @@ class RealtimeClient {
 
 to use socket realtime connection;
         `);
-        return () => {
-        };
-      }
-      let roomName;
-      if (customEvent) {
-        roomName = Symbols__NS__REALTIME.ROOM_NAME_CUSTOM(
-          this.core.ctx.contextName,
-          customEvent
-        );
-      } else {
-        roomName = ___NS__isString(property) ? Symbols__NS__REALTIME.ROOM_NAME_UPDATE_ENTITY_PROPERTY(
-          this.core.ctx.contextName,
-          className,
-          property,
-          options.idOrUniqValue
-        ) : Symbols__NS__REALTIME.ROOM_NAME_UPDATE_ENTITY(
-          this.core.ctx.contextName,
-          className,
-          options.idOrUniqValue
-        );
-      }
-      const roomSubOptions = {
-        core: this.core,
-        property,
-        roomName,
-        customEvent
-      };
-      const subManagerId = this.getUniqueIdentifierForConnection(roomSubOptions);
-      if (!this.subsManagers[subManagerId]) {
-        this.subsManagers[subManagerId] = new RealtimeSubsManager(
-          roomSubOptions
-        );
-      }
-      const inst = this.subsManagers[subManagerId];
-      inst.add(observer);
-      inst.startListenIfNotStarted(this.core.socketFE);
-      return () => {
-        inst.remove(observer);
-      };
-    });
-  }
-  //#endregion
-  //#region listen changes entity table
-  /**
-   * Listen changes entity table
-   * Example: for pagination, lists update ...
-   */
-  listenChangesEntityTable(entityClassFn) {
-    const className = ClassHelpers__NS__getName(entityClassFn);
-    return this.listenChangesEntity(entityClassFn, {
-      customEvent: Symbols__NS__REALTIME.TABLE_CHANGE(
-        this.core.ctx.contextName,
-        className
-      )
-    });
-  }
-  //#endregion
-  //#region listen changes custom event
-  listenChangesCustomEvent(customEvent) {
-    return this.listenChangesEntity(void 0, {
-      customEvent
-    });
-  }
-  //#endregion
-  //#region methods & getters / trigger custom event\
-  /**
-   * Trigger custom event on backend
-   * @param customEvent global event name
-   * @param dataToPush
-   */
-  triggerCustomEvent(customEvent, dataToPush) {
-    this.core.socketFE.emit(customEvent, dataToPush);
-  }
-  //#endregion
-  //#region methods & getters / get room id from
-  getUniqueIdentifierForConnection(options) {
-    let url = new URL(options.core.ctx.host);
-    let contextNameForCommunication = options.core.ctx.contextNameForCommunication;
-    return `${contextNameForCommunication}:${url.origin}|${options.roomName}|${options.property}|${options.customEvent}`;
-  }
-  //#endregion
+                return () => {
+                    // empty nothing to do
+                };
+            }
+            let roomName;
+            if (customEvent) {
+                roomName = Symbols__NS__REALTIME.ROOM_NAME_CUSTOM(this.core.ctx.contextName, customEvent);
+            }
+            else {
+                roomName = ___NS__isString(property)
+                    ? Symbols__NS__REALTIME.ROOM_NAME_UPDATE_ENTITY_PROPERTY(this.core.ctx.contextName, className, property, options.idOrUniqValue)
+                    : Symbols__NS__REALTIME.ROOM_NAME_UPDATE_ENTITY(this.core.ctx.contextName, className, options.idOrUniqValue);
+            }
+            const roomSubOptions = {
+                core: this.core,
+                property,
+                roomName,
+                customEvent,
+            };
+            //#endregion
+            const subManagerId = this.getUniqueIdentifierForConnection(roomSubOptions);
+            if (!this.subsManagers[subManagerId]) {
+                this.subsManagers[subManagerId] = new RealtimeSubsManager(roomSubOptions);
+            }
+            const inst = this.subsManagers[subManagerId];
+            inst.add(observer);
+            inst.startListenIfNotStarted(this.core.socketFE);
+            return () => {
+                inst.remove(observer);
+            };
+        });
+    }
+    //#endregion
+    //#region listen changes entity table
+    /**
+     * Listen changes entity table
+     * Example: for pagination, lists update ...
+     */
+    listenChangesEntityTable(entityClassFn) {
+        const className = ClassHelpers__NS__getName(entityClassFn);
+        return this.listenChangesEntity(entityClassFn, {
+            customEvent: Symbols__NS__REALTIME.TABLE_CHANGE(this.core.ctx.contextName, className),
+        });
+    }
+    //#endregion
+    //#region listen changes custom event
+    listenChangesCustomEvent(customEvent) {
+        return this.listenChangesEntity(void 0, {
+            customEvent,
+        });
+    }
+    //#endregion
+    //#region methods & getters / trigger custom event\
+    /**
+     * Trigger custom event on backend
+     * @param customEvent global event name
+     * @param dataToPush
+     */
+    triggerCustomEvent(customEvent, dataToPush) {
+        this.core.socketFE.emit(customEvent, dataToPush);
+    }
+    //#endregion
+    //#region methods & getters / get room id from
+    getUniqueIdentifierForConnection(options) {
+        let url = new URL(options.core.ctx.host);
+        let contextNameForCommunication = options.core.ctx.contextNameForCommunication;
+        return `${contextNameForCommunication}:${url.origin}|${options.roomName}|${options.property}|${options.customEvent}`;
+    }
 }
-export {
-  RealtimeClient
-};

package/lib-prod/realtime/realtime-core.js

@@ -1,82 +1,81 @@
-import { UtilsOs__NS__isElectron, UtilsOs__NS__isWebSQL } from "tnp-core/lib-prod";
-import { apiPrefix } from "../constants";
-import { RealtimeClient } from "./realtime-client";
-import { RealtimeServer } from "./realtime-server";
-import {
-  RealtimeStrategyIpc,
-  RealtimeStrategyMock,
-  RealtimeStrategySocketIO
-} from "./realtime-strategy";
-class RealtimeCore {
-  //#endregion
-  //#region constructor
-  constructor(ctx) {
-    this.ctx = ctx;
-    this.ctx = ctx;
-    this.strategy = this.resolveStrategy();
-    if (UtilsOs__NS__isWebSQL) {
-      this.server = new RealtimeServer(this);
-      this.client = new RealtimeClient(this);
-    } else {
-      this.client = new RealtimeClient(this);
-      this.server = new RealtimeServer(this);
+import { UtilsOs__NS__isElectron, UtilsOs__NS__isWebSQL } from 'tnp-core/lib-prod';
+import { apiPrefix } from '../constants';
+import { RealtimeClient } from './realtime-client';
+import { RealtimeServer } from './realtime-server';
+import { RealtimeStrategyIpc, RealtimeStrategyMock, RealtimeStrategySocketIO, } from './realtime-strategy';
+//#endregion
+/**
+ * Realtime class
+ * - mock (when browser-browser)
+ * - sockets (from socket io when backend-browser)
+ * - ipc (when electron is used or between processes)
+ * - webworker (when webworker is used in browser or nodejs)
+ */
+export class RealtimeCore {
+    //#endregion
+    //#region constructor
+    constructor(ctx) {
+        this.ctx = ctx;
+        //#region fields
+        this.allHttpMethods = [
+            'GET',
+            'POST',
+            'PUT',
+            'DELETE',
+            'PATCH',
+            'OPTIONS',
+            'HEAD',
+        ];
+        this.ctx = ctx;
+        this.strategy = this.resolveStrategy();
+        //     this.ctx.logRealtime &&
+        //       console.log(`
+        // [ctx=${this.ctx.contextName}] realtime strategy: ${this.strategy}, context type: ${this.ctx.contextType}
+        //         `);
+        if (UtilsOs__NS__isWebSQL) {
+            this.server = new RealtimeServer(this);
+            // console.log('DONE INITING SERVER');
+            this.client = new RealtimeClient(this);
+            // console.log('DONE INITING CLIENT');
+        }
+        else {
+            this.client = new RealtimeClient(this);
+            this.server = new RealtimeServer(this);
+        }
     }
-  }
-  //#region fields
-  allHttpMethods = [
-    "GET",
-    "POST",
-    "PUT",
-    "DELETE",
-    "PATCH",
-    "OPTIONS",
-    "HEAD"
-  ];
-  client;
-  server;
-  strategy;
-  /**
-   * global FE socket - only for established connection
-   */
-  conectSocketFE;
-  /**
-   * socket for namespaces and rooms
-   */
-  socketFE;
-  /**
-   * global BE socket - only for established connection
-   */
-  connectSocketBE;
-  /**
-   * socket for namespaces and rooms
-   */
-  socketBE;
-  //#endregion
-  //#region methods & getters / resovle staraegy
-  resolveStrategy() {
-    if (this.ctx.mode === "backend-frontend(websql)" || this.ctx.mode === "backend-frontend(websql-electron)") {
-      return new RealtimeStrategyMock(this.ctx);
+    //#endregion
+    //#region methods & getters / resovle staraegy
+    resolveStrategy() {
+        // console.log(`[taon] resolveStrategy for this.ctx.mode ${this.ctx.mode}`);
+        if (this.ctx.mode === 'backend-frontend(websql)' ||
+            this.ctx.mode === 'backend-frontend(websql-electron)') {
+            // debugger
+            return new RealtimeStrategyMock(this.ctx);
+        }
+        if (this.ctx.mode === 'backend-frontend(ipc-electron)') {
+            return new RealtimeStrategyIpc(this.ctx);
+        }
+        // if (this.ctx.mode === 'backend-frontend(tcp+udp)') {
+        //   return new RealtimeStrategySocketIO(this.ctx);
+        // }
+        // if (this.ctx.mode === 'remote-backend(tcp+udp)') {
+        //   return new RealtimeStrategySocketIO(this.ctx);
+        // }
+        return new RealtimeStrategySocketIO(this.ctx);
     }
-    if (this.ctx.mode === "backend-frontend(ipc-electron)") {
-      return new RealtimeStrategyIpc(this.ctx);
+    //#endregion
+    //#region path for
+    pathFor(namespace) {
+        let nsp = namespace ? namespace : '';
+        nsp = nsp === '/' ? '' : nsp;
+        const contextNameForCommunication = this.ctx.contextNameForCommunication;
+        let prefix = `${apiPrefix}/${contextNameForCommunication}/udp`;
+        if (UtilsOs__NS__isElectron) {
+            prefix = ``;
+        }
+        const href = `${this.ctx.uriOrigin}${this.ctx.uriPathnameOrNothingIfRoot}` +
+            `/${prefix}${prefix && nsp ? '-' + nsp : nsp}`;
+        // console.log(`HREF: ${href}, nsp: ${nsp}`)
+        return new URL(href);
     }
-    return new RealtimeStrategySocketIO(this.ctx);
-  }
-  //#endregion
-  //#region path for
-  pathFor(namespace) {
-    let nsp = namespace ? namespace : "";
-    nsp = nsp === "/" ? "" : nsp;
-    const contextNameForCommunication = this.ctx.contextNameForCommunication;
-    let prefix = `${apiPrefix}/${contextNameForCommunication}/udp`;
-    if (UtilsOs__NS__isElectron) {
-      prefix = ``;
-    }
-    const href = `${this.ctx.uriOrigin}${this.ctx.uriPathnameOrNothingIfRoot}/${prefix}${prefix && nsp ? "-" + nsp : nsp}`;
-    return new URL(href);
-  }
-  //#endregion
 }
-export {
-  RealtimeCore
-};