taon 21.0.44 → 21.0.45

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

@@ -0,0 +1,288 @@
+//#region imports
+import { Observable } from 'rxjs';
+import { ___NS__add, ___NS__after, ___NS__ary, ___NS__assign, ___NS__assignIn, ___NS__assignInWith, ___NS__assignWith, ___NS__at, ___NS__attempt, ___NS__before, ___NS__bind, ___NS__bindAll, ___NS__bindKey, ___NS__camelCase, ___NS__capitalize, ___NS__castArray, ___NS__ceil, ___NS__chain, ___NS__chunk, ___NS__clamp, ___NS__clone, ___NS__cloneDeep, ___NS__cloneDeepWith, ___NS__cloneWith, ___NS__compact, ___NS__concat, ___NS__cond, ___NS__conforms, ___NS__conformsTo, ___NS__constant, ___NS__countBy, ___NS__create, ___NS__curry, ___NS__curryRight, ___NS__debounce, ___NS__deburr, ___NS__defaults, ___NS__defaultsDeep, ___NS__defaultTo, ___NS__defer, ___NS__delay, ___NS__difference, ___NS__differenceBy, ___NS__differenceWith, ___NS__divide, ___NS__drop, ___NS__dropRight, ___NS__dropRightWhile, ___NS__dropWhile, ___NS__each, ___NS__eachRight, ___NS__endsWith, ___NS__entries, ___NS__entriesIn, ___NS__eq, ___NS__escape, ___NS__escapeRegExp, ___NS__every, ___NS__extend, ___NS__extendWith, ___NS__fill, ___NS__filter, ___NS__find, ___NS__findIndex, ___NS__findKey, ___NS__findLast, ___NS__findLastIndex, ___NS__findLastKey, ___NS__first, ___NS__flatMap, ___NS__flatMapDeep, ___NS__flatMapDepth, ___NS__flatten, ___NS__flattenDeep, ___NS__flattenDepth, ___NS__flip, ___NS__floor, ___NS__flow, ___NS__flowRight, ___NS__forEach, ___NS__forEachRight, ___NS__forIn, ___NS__forInRight, ___NS__forOwn, ___NS__forOwnRight, ___NS__fromPairs, ___NS__functions, ___NS__functionsIn, ___NS__get, ___NS__groupBy, ___NS__gt, ___NS__gte, ___NS__has, ___NS__hasIn, ___NS__head, ___NS__identity, ___NS__includes, ___NS__indexOf, ___NS__initial, ___NS__inRange, ___NS__intersection, ___NS__intersectionBy, ___NS__intersectionWith, ___NS__invert, ___NS__invertBy, ___NS__invoke, ___NS__invokeMap, ___NS__isArguments, ___NS__isArray, ___NS__isArrayBuffer, ___NS__isArrayLike, ___NS__isArrayLikeObject, ___NS__isBoolean, ___NS__isBuffer, ___NS__isDate, ___NS__isElement, ___NS__isEmpty, ___NS__isEqual, ___NS__isEqualWith, ___NS__isError, ___NS__isFinite, ___NS__isFunction, ___NS__isInteger, ___NS__isLength, ___NS__isMap, ___NS__isMatch, ___NS__isMatchWith, ___NS__isNaN, ___NS__isNative, ___NS__isNil, ___NS__isNull, ___NS__isNumber, ___NS__isObject, ___NS__isObjectLike, ___NS__isPlainObject, ___NS__isRegExp, ___NS__isSafeInteger, ___NS__isSet, ___NS__isString, ___NS__isSymbol, ___NS__isTypedArray, ___NS__isUndefined, ___NS__isWeakMap, ___NS__isWeakSet, ___NS__iteratee, ___NS__join, ___NS__kebabCase, ___NS__keyBy, ___NS__keys, ___NS__keysIn, ___NS__last, ___NS__lastIndexOf, ___NS__lowerCase, ___NS__lowerFirst, ___NS__lt, ___NS__lte, ___NS__map, ___NS__mapKeys, ___NS__mapValues, ___NS__matches, ___NS__matchesProperty, ___NS__max, ___NS__maxBy, ___NS__mean, ___NS__meanBy, ___NS__memoize, ___NS__merge, ___NS__mergeWith, ___NS__method, ___NS__methodOf, ___NS__min, ___NS__minBy, ___NS__mixin, ___NS__multiply, ___NS__negate, ___NS__noop, ___NS__now, ___NS__nth, ___NS__nthArg, ___NS__omit, ___NS__omitBy, ___NS__once, ___NS__orderBy, ___NS__over, ___NS__overArgs, ___NS__overEvery, ___NS__overSome, ___NS__pad, ___NS__padEnd, ___NS__padStart, ___NS__parseInt, ___NS__partial, ___NS__partialRight, ___NS__partition, ___NS__pick, ___NS__pickBy, ___NS__property, ___NS__propertyOf, ___NS__pull, ___NS__pullAll, ___NS__pullAllBy, ___NS__pullAllWith, ___NS__pullAt, ___NS__random, ___NS__range, ___NS__rangeRight, ___NS__rearg, ___NS__reduce, ___NS__reduceRight, ___NS__reject, ___NS__remove, ___NS__repeat, ___NS__replace, ___NS__rest, ___NS__result, ___NS__reverse, ___NS__round, ___NS__sample, ___NS__sampleSize, ___NS__set, ___NS__setWith, ___NS__shuffle, ___NS__size, ___NS__slice, ___NS__snakeCase, ___NS__some, ___NS__sortBy, ___NS__sortedIndex, ___NS__sortedIndexBy, ___NS__sortedIndexOf, ___NS__sortedLastIndex, ___NS__sortedLastIndexBy, ___NS__sortedLastIndexOf, ___NS__sortedUniq, ___NS__sortedUniqBy, ___NS__split, ___NS__spread, ___NS__startCase, ___NS__startsWith, ___NS__stubArray, ___NS__stubFalse, ___NS__stubObject, ___NS__stubString, ___NS__stubTrue, ___NS__subtract, ___NS__sum, ___NS__sumBy, ___NS__tail, ___NS__take, ___NS__takeRight, ___NS__takeRightWhile, ___NS__takeWhile, ___NS__tap, ___NS__template, ___NS__templateSettings, ___NS__throttle, ___NS__thru, ___NS__times, ___NS__toArray, ___NS__toFinite, ___NS__toInteger, ___NS__toLength, ___NS__toLower, ___NS__toNumber, ___NS__toPairs, ___NS__toPairsIn, ___NS__toPath, ___NS__toPlainObject, ___NS__toSafeInteger, ___NS__toString, ___NS__toUpper, ___NS__transform, ___NS__trim, ___NS__trimEnd, ___NS__trimStart, ___NS__truncate, ___NS__unary, ___NS__unescape, ___NS__union, ___NS__unionBy, ___NS__unionWith, ___NS__uniq, ___NS__uniqBy, ___NS__uniqueId, ___NS__uniqWith, ___NS__unset, ___NS__unzip, ___NS__unzipWith, ___NS__update, ___NS__updateWith, ___NS__upperCase, ___NS__upperFirst, ___NS__values, ___NS__valuesIn, ___NS__without, ___NS__words, ___NS__wrap, ___NS__xor, ___NS__xorBy, ___NS__xorWith, ___NS__zip, ___NS__zipObject, ___NS__zipObjectDeep, ___NS__zipWith, UtilsOs__NS__commandExistsAsync, UtilsOs__NS__commandExistsSync, UtilsOs__NS__detectEditor, UtilsOs__NS__Editor, UtilsOs__NS__EDITOR_PROCESSES, UtilsOs__NS__EditorArr, UtilsOs__NS__EditorProcess, UtilsOs__NS__getEditorSettingsJsonPath, UtilsOs__NS__getRealHomeDir, UtilsOs__NS__isBrowser, UtilsOs__NS__isDockerAvailable, UtilsOs__NS__isElectron, UtilsOs__NS__isNode, UtilsOs__NS__isNodeVersionOk, UtilsOs__NS__isPortInUse, UtilsOs__NS__isRunningInBrowser, UtilsOs__NS__isRunningInCliMode, UtilsOs__NS__isRunningInDocker, UtilsOs__NS__isRunningInElectron, UtilsOs__NS__isRunningInLinuxGraphicsCapableEnvironment, UtilsOs__NS__isRunningInMochaTest, UtilsOs__NS__isRunningInNode, UtilsOs__NS__isRunningInOsWithGraphicsCapableEnvironment, UtilsOs__NS__isRunningInSSRMode, UtilsOs__NS__isRunningInVscodeExtension, UtilsOs__NS__isRunningInWebSQL, UtilsOs__NS__isRunningInWindows, UtilsOs__NS__isRunningInWindowsCmd, UtilsOs__NS__isRunningInWindowsPowerShell, UtilsOs__NS__isRunningInWsl, UtilsOs__NS__isRunningNodeDebugger, UtilsOs__NS__isSSRMode, UtilsOs__NS__isVscodeExtension, UtilsOs__NS__isWebSQL, UtilsOs__NS__killAllEditor, UtilsOs__NS__openFolderInFileExplorer, UtilsOs__NS__openFolderInVSCode, UtilsOs__NS__pipxNestedPackageExists, UtilsOs__NS__pipxPackageExists, UtilsOs__NS__pythonModuleExists, UtilsOs__NS__UnknownEditor } from 'tnp-core/lib-prod';
+import { Helpers__NS___fixCommand, Helpers__NS__bigMaxBuffer, Helpers__NS__checkProcess, Helpers__NS__cleanExit, Helpers__NS__clearConsole, Helpers__NS__command, Helpers__NS__commandOutputAsString, Helpers__NS__commandOutputAsStringAsync, Helpers__NS__compilationWrapper, Helpers__NS__contain, Helpers__NS__createFolder, Helpers__NS__createSymLink, Helpers__NS__error, Helpers__NS__execute, Helpers__NS__exists, Helpers__NS__filesFrom, Helpers__NS__foldersFrom, Helpers__NS__getFilesFrom, Helpers__NS__getFoldersFrom, Helpers__NS__getIsBrowser, Helpers__NS__getIsElectron, Helpers__NS__getIsNode, Helpers__NS__getIsRunningInGitBash, Helpers__NS__getIsSupportedTaonTerminal, Helpers__NS__getIsVerboseMode, Helpers__NS__getIsWebSQL, Helpers__NS__getIsWsl, Helpers__NS__getStdio, Helpers__NS__hideNodeWarnings, Helpers__NS__info, Helpers__NS__isBlob, Helpers__NS__isBuffer, Helpers__NS__isClass, Helpers__NS__isExistedSymlink, Helpers__NS__isFile, Helpers__NS__isFolder, Helpers__NS__isRunningInDocker, Helpers__NS__isRunningInLinuxGraphicsCapableEnvironment, Helpers__NS__isSymlinkFileExitedOrUnexisted, Helpers__NS__isSymlinkThatMatchesUrl, Helpers__NS__isUnexistedLink, Helpers__NS__killOnPort, Helpers__NS__killProcess, Helpers__NS__killProcessByPort, Helpers__NS__linksToFolderFrom, Helpers__NS__linksToFoldersFrom, Helpers__NS__log, Helpers__NS__logError, Helpers__NS__logInfo, Helpers__NS__logProc, Helpers__NS__logSuccess, Helpers__NS__logWarn, Helpers__NS__mediaTypeFromSrc, Helpers__NS__mkdirp, Helpers__NS__modifyLineByLine, Helpers__NS__msgCacheClear, Helpers__NS__openFolderInFileExplorer, Helpers__NS__parse, Helpers__NS__pathContainLink, Helpers__NS__questionYesNo, Helpers__NS__readFile, Helpers__NS__readJson, Helpers__NS__readJson5, Helpers__NS__readJsonC, Helpers__NS__relative, Helpers__NS__remove, Helpers__NS__removeEmptyLineFromString, Helpers__NS__removeFileIfExists, Helpers__NS__removeFolderIfExists, Helpers__NS__removeIfExists, Helpers__NS__removeSlashAtBegin, Helpers__NS__removeSlashAtEnd, Helpers__NS__removeSymlinks, Helpers__NS__renderError, Helpers__NS__replaceLinesInFile, Helpers__NS__run, Helpers__NS__runAsyncIn, Helpers__NS__runSyncIn, Helpers__NS__runSyncOrAsync, Helpers__NS__sleep, Helpers__NS__stopApplication, Helpers__NS__stringify, Helpers__NS__success, Helpers__NS__taskDone, Helpers__NS__taskStarted, Helpers__NS__throwError, Helpers__NS__timeout, Helpers__NS__tryCatchError, Helpers__NS__tryReadFile, Helpers__NS__tryRemoveDir, Helpers__NS__values, Helpers__NS__wait, Helpers__NS__warn, Helpers__NS__writeFile, Helpers__NS__writeJson, Helpers__NS__writeJson5, Helpers__NS__writeJsonC } from 'tnp-core/lib-prod';
+
+import type { TaonBaseEntity } from '../base-classes/base-entity';
+import { ClassHelpers__NS__asyncHandler, ClassHelpers__NS__ensureClassConfig, ClassHelpers__NS__ensureMethodConfig, ClassHelpers__NS__getClassConfig, ClassHelpers__NS__getClassFnFromObject, ClassHelpers__NS__getControllerConfigs, ClassHelpers__NS__getFullInternalName, ClassHelpers__NS__getMethodsNames, ClassHelpers__NS__getName, ClassHelpers__NS__getOrginalClass, ClassHelpers__NS__getUniqueKey, ClassHelpers__NS__hasParentClassWithName, ClassHelpers__NS__isContextClassObject, ClassHelpers__NS__setName } from '../helpers/class-helpers';
+import { Symbols__NS__classMethodsNames, Symbols__NS__classNameStaticProperty, Symbols__NS__ctxInClassOrClassObj, Symbols__NS__fullClassNameStaticProperty, Symbols__NS__metadata, Symbols__NS__old, Symbols__NS__orignalClass, Symbols__NS__orignalClassClonesObj, Symbols__NS__REALTIME } from '../symbols';
+
+import { RealtimeCore } from './realtime-core';
+import { RealtimeSubsManager } from './realtime-subs-manager';
+import { RealtimeModels__NS__ChangeOption, RealtimeModels__NS__EventHandler, RealtimeModels__NS__SubsManagerOpt } from './realtime.models';
+
+//#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 {
+  private subsManagers: { [path: string]: RealtimeSubsManager } = {};
+  constructor(private core: RealtimeCore) {
+    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();
+    }
+  }
+
+  //#region methods & getters / init
+  private init(): void {
+    //#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
+  }
+  //#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<RESULT = any>(
+    entityClassFnOrObj: Function | object,
+    options?: RealtimeModels__NS__ChangeOption,
+  ): Observable<RESULT> {
+    options = options || ({} as any);
+
+    if (___NS__isObject(entityClassFnOrObj)) {
+      const orgObj = entityClassFnOrObj as TaonBaseEntity;
+      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
+        ...
+
+to use socket realtime connection;
+        `);
+        return () => {
+          // empty nothing to do
+        };
+      }
+
+      let roomName: string;
+
+      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: RealtimeModels__NS__SubsManagerOpt = {
+        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<RESULT = any>(
+    entityClassFn: Function,
+  ): Observable<RESULT> {
+    const className = ClassHelpers__NS__getName(entityClassFn);
+    return this.listenChangesEntity<RESULT>(entityClassFn, {
+      customEvent: Symbols__NS__REALTIME.TABLE_CHANGE(
+        this.core.ctx.contextName,
+        className,
+      ),
+    });
+  }
+  //#endregion
+
+  //#region listen changes custom event
+  listenChangesCustomEvent<RESULT = any>(
+    customEvent: string,
+  ): Observable<RESULT> {
+    return this.listenChangesEntity<RESULT>(void 0, {
+      customEvent,
+    });
+  }
+  //#endregion
+
+  //#region methods & getters / trigger custom event\
+  /**
+   * Trigger custom event on backend
+   * @param customEvent global event name
+   * @param dataToPush
+   */
+  public triggerCustomEvent(customEvent: string, dataToPush?: any): void {
+    this.core.socketFE.emit(customEvent, dataToPush);
+  }
+  //#endregion
+
+  //#region methods & getters / get room id from
+  private getUniqueIdentifierForConnection(
+    options: RealtimeModels__NS__SubsManagerOpt,
+  ): string {
+    let url: URL = new URL(options.core.ctx.host);
+    let contextNameForCommunication =
+      options.core.ctx.contextNameForCommunication;
+    return `${contextNameForCommunication}:${url.origin}|${options.roomName}|${options.property}|${options.customEvent}`;
+  }
+  //#endregion
+}

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

@@ -0,0 +1,134 @@
+//#region imports
+import { Server } from 'socket.io';
+import { DefaultEventsMap } from 'socket.io';
+import { Socket as SocketClient } from 'socket.io-client';
+import { Helpers__NS___fixCommand, Helpers__NS__bigMaxBuffer, Helpers__NS__checkProcess, Helpers__NS__cleanExit, Helpers__NS__clearConsole, Helpers__NS__command, Helpers__NS__commandOutputAsString, Helpers__NS__commandOutputAsStringAsync, Helpers__NS__compilationWrapper, Helpers__NS__contain, Helpers__NS__createFolder, Helpers__NS__createSymLink, Helpers__NS__error, Helpers__NS__execute, Helpers__NS__exists, Helpers__NS__filesFrom, Helpers__NS__foldersFrom, Helpers__NS__getFilesFrom, Helpers__NS__getFoldersFrom, Helpers__NS__getIsBrowser, Helpers__NS__getIsElectron, Helpers__NS__getIsNode, Helpers__NS__getIsRunningInGitBash, Helpers__NS__getIsSupportedTaonTerminal, Helpers__NS__getIsVerboseMode, Helpers__NS__getIsWebSQL, Helpers__NS__getIsWsl, Helpers__NS__getStdio, Helpers__NS__hideNodeWarnings, Helpers__NS__info, Helpers__NS__isBlob, Helpers__NS__isBuffer, Helpers__NS__isClass, Helpers__NS__isExistedSymlink, Helpers__NS__isFile, Helpers__NS__isFolder, Helpers__NS__isRunningInDocker, Helpers__NS__isRunningInLinuxGraphicsCapableEnvironment, Helpers__NS__isSymlinkFileExitedOrUnexisted, Helpers__NS__isSymlinkThatMatchesUrl, Helpers__NS__isUnexistedLink, Helpers__NS__killOnPort, Helpers__NS__killProcess, Helpers__NS__killProcessByPort, Helpers__NS__linksToFolderFrom, Helpers__NS__linksToFoldersFrom, Helpers__NS__log, Helpers__NS__logError, Helpers__NS__logInfo, Helpers__NS__logProc, Helpers__NS__logSuccess, Helpers__NS__logWarn, Helpers__NS__mediaTypeFromSrc, Helpers__NS__mkdirp, Helpers__NS__modifyLineByLine, Helpers__NS__msgCacheClear, Helpers__NS__openFolderInFileExplorer, Helpers__NS__parse, Helpers__NS__pathContainLink, Helpers__NS__questionYesNo, Helpers__NS__readFile, Helpers__NS__readJson, Helpers__NS__readJson5, Helpers__NS__readJsonC, Helpers__NS__relative, Helpers__NS__remove, Helpers__NS__removeEmptyLineFromString, Helpers__NS__removeFileIfExists, Helpers__NS__removeFolderIfExists, Helpers__NS__removeIfExists, Helpers__NS__removeSlashAtBegin, Helpers__NS__removeSlashAtEnd, Helpers__NS__removeSymlinks, Helpers__NS__renderError, Helpers__NS__replaceLinesInFile, Helpers__NS__run, Helpers__NS__runAsyncIn, Helpers__NS__runSyncIn, Helpers__NS__runSyncOrAsync, Helpers__NS__sleep, Helpers__NS__stopApplication, Helpers__NS__stringify, Helpers__NS__success, Helpers__NS__taskDone, Helpers__NS__taskStarted, Helpers__NS__throwError, Helpers__NS__timeout, Helpers__NS__tryCatchError, Helpers__NS__tryReadFile, Helpers__NS__tryRemoveDir, Helpers__NS__values, Helpers__NS__wait, Helpers__NS__warn, Helpers__NS__writeFile, Helpers__NS__writeJson, Helpers__NS__writeJson5, Helpers__NS__writeJsonC, UtilsOs__NS__commandExistsAsync, UtilsOs__NS__commandExistsSync, UtilsOs__NS__detectEditor, UtilsOs__NS__Editor, UtilsOs__NS__EDITOR_PROCESSES, UtilsOs__NS__EditorArr, UtilsOs__NS__EditorProcess, UtilsOs__NS__getEditorSettingsJsonPath, UtilsOs__NS__getRealHomeDir, UtilsOs__NS__isBrowser, UtilsOs__NS__isDockerAvailable, UtilsOs__NS__isElectron, UtilsOs__NS__isNode, UtilsOs__NS__isNodeVersionOk, UtilsOs__NS__isPortInUse, UtilsOs__NS__isRunningInBrowser, UtilsOs__NS__isRunningInCliMode, UtilsOs__NS__isRunningInDocker, UtilsOs__NS__isRunningInElectron, UtilsOs__NS__isRunningInLinuxGraphicsCapableEnvironment, UtilsOs__NS__isRunningInMochaTest, UtilsOs__NS__isRunningInNode, UtilsOs__NS__isRunningInOsWithGraphicsCapableEnvironment, UtilsOs__NS__isRunningInSSRMode, UtilsOs__NS__isRunningInVscodeExtension, UtilsOs__NS__isRunningInWebSQL, UtilsOs__NS__isRunningInWindows, UtilsOs__NS__isRunningInWindowsCmd, UtilsOs__NS__isRunningInWindowsPowerShell, UtilsOs__NS__isRunningInWsl, UtilsOs__NS__isRunningNodeDebugger, UtilsOs__NS__isSSRMode, UtilsOs__NS__isVscodeExtension, UtilsOs__NS__isWebSQL, UtilsOs__NS__killAllEditor, UtilsOs__NS__openFolderInFileExplorer, UtilsOs__NS__openFolderInVSCode, UtilsOs__NS__pipxNestedPackageExists, UtilsOs__NS__pipxPackageExists, UtilsOs__NS__pythonModuleExists, UtilsOs__NS__UnknownEditor } from 'tnp-core/lib-prod';
+
+import { apiPrefix } from '../constants';
+import type { EndpointContext } from '../endpoint-context';
+
+import { RealtimeClient } from './realtime-client';
+import { RealtimeServer } from './realtime-server';
+import type { RealtimeStrategy } from './realtime-strategy';
+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 {
+  //#region fields
+  readonly allHttpMethods = [
+    'GET',
+    'POST',
+    'PUT',
+    'DELETE',
+    'PATCH',
+    'OPTIONS',
+    'HEAD',
+  ];
+  public readonly client: RealtimeClient;
+  public readonly server: RealtimeServer;
+  public readonly strategy: RealtimeStrategy;
+
+  /**
+   * global FE socket - only for established connection
+   */
+  public conectSocketFE: SocketClient<DefaultEventsMap, DefaultEventsMap>;
+  /**
+   * socket for namespaces and rooms
+   */
+  public socketFE: SocketClient<DefaultEventsMap, DefaultEventsMap>;
+  /**
+   * global BE socket - only for established connection
+   */
+  public connectSocketBE: Server<
+    DefaultEventsMap,
+    DefaultEventsMap,
+    DefaultEventsMap,
+    any
+  >;
+  /**
+   * socket for namespaces and rooms
+   */
+  public socketBE: Server<
+    DefaultEventsMap,
+    DefaultEventsMap,
+    DefaultEventsMap,
+    any
+  >;
+  //#endregion
+
+  //#region constructor
+  constructor(public ctx: EndpointContext) {
+    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 as any);
+      // console.log('DONE INITING SERVER');
+      this.client = new RealtimeClient(this as any);
+      // console.log('DONE INITING CLIENT');
+    } else {
+      this.client = new RealtimeClient(this as any);
+      this.server = new RealtimeServer(this as any);
+    }
+  }
+  //#endregion
+
+  //#region methods & getters / resovle staraegy
+  private resolveStrategy(): RealtimeStrategy {
+    // 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);
+  }
+  //#endregion
+
+  //#region path for
+  public pathFor(namespace?: string) {
+    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) as URL;
+  }
+  //#endregion
+}