taon 21.0.89 → 21.0.91

package/browser/package.json

@@ -1,6 +1,6 @@
 {
   "name": "taon/browser",
-  "version": "21.0.89",
+  "version": "21.0.91",
   "peerDependencies": {
     "@angular/common": "^21.0.0",
     "@angular/core": "^21.0.0"

package/browser/types/taon-browser.d.ts

@@ -4,12 +4,14 @@ import * as expressType from 'express';
 import { Request, Response, Application, RequestHandler } from 'express';
 import { HttpResponse, Ng2RestAxiosRequestConfig, RestResponseWrapper, TaonServerMiddlewareInterceptOptions, TaonClientMiddlewareInterceptOptions, ResponseTypeAxios, HttpResponseError, RestErrorResponseWrapper, ModelValue, EncodeSchema } from 'ng2-rest/browser';
 export { TaonClientMiddlewareInterceptOptions, TaonServerMiddlewareInterceptOptions } from 'ng2-rest/browser';
-import { Server } from 'http';
+import { Server as Server$1 } from 'http';
 import { DataSource, Repository, SaveOptions, DeepPartial, QueryDeepPartialEntity, InsertResult, UpsertOptions, FindOptionsWhere, UpdateResult, FindManyOptions, FindOneOptions, QueryRunner, SelectQueryBuilder, Table, RelationPath, MigrationInterface, EntitySubscriberInterface, InsertEvent, UpdateEvent, RemoveEvent, SoftRemoveEvent, RecoverEvent, TransactionStartEvent, TransactionCommitEvent, TransactionRollbackEvent } from 'taon-typeorm/browser';
 export { AfterInsert, AfterLoad, AfterRecover, AfterRemove, AfterSoftRemove, AfterUpdate, BeforeInsert, BeforeRecover, BeforeRemove, BeforeSoftRemove, BeforeUpdate, Column, Connection, CreateDateColumn, Column as CustomColumn, DeleteDateColumn, Generated, Generated as GeneratedColumn, Index, JoinColumn, JoinTable, ManyToMany, ManyToOne, OneToMany, OneToOne, PrimaryColumn, PrimaryGeneratedColumn, Repository, TreeChildren, TreeParent, UpdateDateColumn, VersionColumn, VirtualColumn } from 'taon-typeorm/browser';
 import { CoreModels } from 'tnp-core/browser';
 import { MySqlQuerySource } from 'taon-type-sql/browser';
 import { Observable, Subscriber } from 'rxjs';
+import { ServerOptions, Server, DefaultEventsMap } from 'socket.io';
+import { io, Socket } from 'socket.io-client';
 import * as i0 from '@angular/core';
 import { InjectionToken, ViewContainerRef, WritableSignal, TemplateRef } from '@angular/core';
 import { AxiosResponse } from 'axios';
@@ -17,8 +19,6 @@ import * as _ngx_formly_core from '@ngx-formly/core';
 import { FieldWrapper, FieldArrayType, FormlyFormBuilder, FormlyFieldConfig } from '@ngx-formly/core';
 import * as Electron from 'electron';
 import { ipcRenderer } from 'electron';
-import { ServerOptions, Server as Server$1, DefaultEventsMap } from 'socket.io';
-import { io, Socket } from 'socket.io-client';
 import { StorSignal } from 'taon-storage/browser';
 import * as multer from 'multer';
 
@@ -634,6 +634,257 @@ declare namespace Models {
     }
 }
 
+declare namespace RealtimeModels {
+    type SubsManagerOpt = {
+        core: RealtimeCore;
+        customEvent: string;
+        roomName: string;
+        property: string;
+    };
+    interface ChangeOption {
+        /**
+         * Specify property name to listen changes on that property only;
+         */
+        property?: string;
+        /**
+         * Override custom event name to listen
+         */
+        customEvent?: string;
+        /**
+         * Value from entity object.
+         * Key for this value is usually id or unique key
+         * property defined in entity decorator.
+         * TODO @LAST IMPLEMENT unique key support
+         */
+        idOrUniqValue?: any;
+    }
+    type EventHandler = (...args: any[]) => void;
+}
+
+/**
+ * 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
+ */
+declare class RealtimeClient {
+    private core;
+    private subsManagers;
+    constructor(core: RealtimeCore);
+    private init;
+    /**
+     * 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.ChangeOption): Observable<RESULT>;
+    /**
+     * Listen changes entity table
+     * Example: for pagination, lists update ...
+     */
+    listenChangesEntityTable<RESULT = any>(entityClassFn: Function): Observable<RESULT>;
+    listenChangesCustomEvent<RESULT = any>(customEvent: string): Observable<RESULT>;
+    /**
+     * Trigger custom event on backend
+     * @param customEvent global event name
+     * @param dataToPush
+     */
+    triggerCustomEvent(customEvent: string, dataToPush?: any): void;
+    private getUniqueIdentifierForConnection;
+}
+
+/**
+ * Server for realtime communication
+ * you can trigger:
+ * - entity changes (any property in table changed)
+ * - entity custom property changes (specific property changed)
+ * - entity table changes (new instance added, instance removed)
+ * - custom events
+ *
+ * and also listen to:
+ * - custom events from yourself
+ */
+declare class RealtimeServer {
+    private core;
+    constructor(core: RealtimeCore);
+    private init;
+    private triggerChanges;
+    triggerEntityChanges(entityObjOrClass: Function | object, 
+    /**
+     * value of unique key property of entity instance
+     * (this value is not needed if entityObjOrClass is instance of entity)
+     */
+    idToTrigger?: number | string): void;
+    triggerEntityPropertyChanges(entityObjOrClass: Function | object, 
+    /**
+     * property name or array of property names that changed
+     * for entity instance
+     */
+    property: string | string[], 
+    /**
+     * value of unique key property of entity instance
+     * (this value is not needed if entityObjOrClass is instance of entity)
+     */
+    idToTrigger?: number | string): void;
+    triggerEntityTableChanges(entityClassOrInstance: Function | object): void;
+    triggerCustomEvent(customEvent: string, dataToPush: any): void;
+    /**
+     * Listen to custom events from users
+     * @param customEvent  global event name
+     */
+    listenChangesCustomEvent(customEvent: string): Observable<any>;
+}
+
+declare abstract class RealtimeStrategy {
+    protected ctx: EndpointContext;
+    constructor(ctx: EndpointContext);
+    get ioClient(): typeof io;
+    ioServer(url: string, opt: ServerOptions): Server<DefaultEventsMap, DefaultEventsMap, DefaultEventsMap, any>;
+    abstract toString(): string;
+}
+
+declare class MockServerIpc {
+    contextName: string;
+    static serverByContextName: Map<string, MockServerIpc>;
+    static from(contextName: string): MockServerIpc;
+    namespacesByName: Map<string, MockNamespaceIpc>;
+    constructor(contextName: string);
+    of(namespace: string): MockNamespaceIpc;
+}
+declare class MockNamespaceIpc {
+    /**
+     * Namespace name
+     */
+    name: string;
+    server: MockServerIpc;
+    electronClients: Set<Electron.WebContents>;
+    roomsByRoomName: {
+        [roomName: string]: Set<Electron.WebContents>;
+    };
+    private namespaceEventHandlers;
+    constructor(
+    /**
+     * Namespace name
+     */
+    name: string, server: MockServerIpc);
+    on(eventName: string, callback: RealtimeModels.EventHandler): any;
+    off(event: string, callback?: RealtimeModels.EventHandler): any;
+    emit(eventName: string, ...args: any[]): any;
+    to(roomName: string): RoomEmitterIpc;
+    in(roomName: string): RoomEmitterIpc;
+    join(webContents: Electron.WebContents, roomName: string): void;
+    leave(webContents: Electron.WebContents, roomName: string): void;
+    path(): string;
+    get nsp(): {
+        readonly name: string;
+    };
+}
+declare class RoomEmitterIpc {
+    private electronClients;
+    /**
+     * namespace name
+     */
+    private name;
+    private includeSender;
+    private sender;
+    constructor(electronClients: Set<Electron.WebContents>, 
+    /**
+     * namespace name
+     */
+    name: string, includeSender?: boolean, sender?: MockSocketIpc);
+    emit(eventName: string, ...args: any[]): void;
+}
+declare class MockSocketIpc {
+    namespaceName: string;
+    ipcRenderer: typeof ipcRenderer;
+    private socketEventHandlers;
+    get name(): string;
+    /**
+     * @param namespaceName instead url for ipc
+     */
+    constructor(namespaceName: string);
+    on(eventName: string, callback: (event: any, ...args: any[]) => void): void;
+    off(event: string, callback?: (event: any, ...args: any[]) => void): void;
+    emit(event: string, ...args: any[]): void;
+}
+/**
+ * Purpose:
+ * - backend-browser communication between 2 processes in electron mode
+ */
+declare class RealtimeStrategyIpc extends RealtimeStrategy {
+    protected ctx: EndpointContext;
+    toString(): string;
+    constructor(ctx: EndpointContext);
+    ioServer(__: string, opt: ServerOptions): any;
+    get ioClient(): any;
+}
+
+/**
+ * Purpose:
+ * - browser-browser communication mock (in websql mode)
+ */
+declare class RealtimeStrategyMock extends RealtimeStrategy {
+    protected ctx: EndpointContext;
+    toString(): string;
+    constructor(ctx: EndpointContext);
+    ioServer(url: string, opt: ServerOptions): any;
+    get ioClient(): any;
+}
+
+/**
+ * Purpose:
+ * - backend-browser communication
+ * - backend-backend communication
+ */
+declare class RealtimeStrategySocketIO extends RealtimeStrategy {
+    protected ctx: EndpointContext;
+    toString(): string;
+    constructor(ctx: EndpointContext);
+    ioServer(...args: any[]): any;
+    get ioClient(): typeof io;
+}
+
+/**
+ * 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)
+ */
+declare class RealtimeCore {
+    ctx: EndpointContext;
+    readonly allHttpMethods: string[];
+    readonly client: RealtimeClient;
+    readonly server: RealtimeServer;
+    readonly strategy: RealtimeStrategy;
+    /**
+     * global FE socket - only for established connection
+     */
+    conectSocketFE: Socket<DefaultEventsMap, DefaultEventsMap>;
+    /**
+     * socket for namespaces and rooms
+     */
+    socketFE: Socket<DefaultEventsMap, DefaultEventsMap>;
+    /**
+     * global BE socket - only for established connection
+     */
+    connectSocketBE: Server<DefaultEventsMap, DefaultEventsMap, DefaultEventsMap, any>;
+    /**
+     * socket for namespaces and rooms
+     */
+    socketBE: Server<DefaultEventsMap, DefaultEventsMap, DefaultEventsMap, any>;
+    constructor(ctx: EndpointContext);
+    private resolveStrategy;
+    pathFor(namespace?: string): URL;
+}
+
 declare class EndpointContext {
     private originalConfig;
     private configFn;
@@ -672,7 +923,7 @@ declare class EndpointContext {
     private injectableTypesfromContexts;
     private allTypesfromContexts;
     expressApp: Application;
-    serverTcpUdp: Server;
+    serverTcpUdp: Server$1;
     databaseConfig?: Models.DatabaseConfigTypeOrm;
     mode: Models.FrameworkMode;
     readonly onlyMigrationRun?: boolean;
@@ -681,7 +932,9 @@ declare class EndpointContext {
     session?: Models.ISession;
     connection: DataSource;
     private entitiesTriggers;
-    private realtime;
+    private _realtime;
+    get realtime(): RealtimeCore;
+    set realtime(v: RealtimeCore);
     get realtimeClient(): taon_browser.RealtimeClient;
     get realtimeServer(): taon_browser.RealtimeServer;
     /**
@@ -799,6 +1052,9 @@ declare class EndpointContext {
     get isProductionMode(): boolean;
     get host(): string | undefined;
     get origin(): string | undefined;
+    /**
+     * init typeorm subscribers
+     */
     initSubscribers(): Promise<any>;
     initEntities(): Promise<void>;
     destroy(): Promise<void>;
@@ -1646,257 +1902,6 @@ declare const SimpleJsonColumn: () => PropertyDecorator;
 declare const BooleanColumn: (defaultValue: boolean | null) => PropertyDecorator;
 declare const DateTimeColumn: (defaultValue?: boolean | null) => PropertyDecorator;
 
-/**
- * Server for realtime communication
- * you can trigger:
- * - entity changes (any property in table changed)
- * - entity custom property changes (specific property changed)
- * - entity table changes (new instance added, instance removed)
- * - custom events
- *
- * and also listen to:
- * - custom events from yourself
- */
-declare class RealtimeServer {
-    private core;
-    constructor(core: RealtimeCore);
-    private init;
-    private triggerChanges;
-    triggerEntityChanges(entityObjOrClass: Function | object, 
-    /**
-     * value of unique key property of entity instance
-     * (this value is not needed if entityObjOrClass is instance of entity)
-     */
-    idToTrigger?: number | string): void;
-    triggerEntityPropertyChanges(entityObjOrClass: Function | object, 
-    /**
-     * property name or array of property names that changed
-     * for entity instance
-     */
-    property: string | string[], 
-    /**
-     * value of unique key property of entity instance
-     * (this value is not needed if entityObjOrClass is instance of entity)
-     */
-    idToTrigger?: number | string): void;
-    triggerEntityTableChanges(entityClassOrInstance: Function | object): void;
-    triggerCustomEvent(customEvent: string, dataToPush: any): void;
-    /**
-     * Listen to custom events from users
-     * @param customEvent  global event name
-     */
-    listenChangesCustomEvent(customEvent: string): Observable<any>;
-}
-
-declare abstract class RealtimeStrategy {
-    protected ctx: EndpointContext;
-    constructor(ctx: EndpointContext);
-    get ioClient(): typeof io;
-    ioServer(url: string, opt: ServerOptions): Server$1<DefaultEventsMap, DefaultEventsMap, DefaultEventsMap, any>;
-    abstract toString(): string;
-}
-
-declare namespace RealtimeModels {
-    type SubsManagerOpt = {
-        core: RealtimeCore;
-        customEvent: string;
-        roomName: string;
-        property: string;
-    };
-    interface ChangeOption {
-        /**
-         * Specify property name to listen changes on that property only;
-         */
-        property?: string;
-        /**
-         * Override custom event name to listen
-         */
-        customEvent?: string;
-        /**
-         * Value from entity object.
-         * Key for this value is usually id or unique key
-         * property defined in entity decorator.
-         * TODO @LAST IMPLEMENT unique key support
-         */
-        idOrUniqValue?: any;
-    }
-    type EventHandler = (...args: any[]) => void;
-}
-
-declare class MockServerIpc {
-    contextName: string;
-    static serverByContextName: Map<string, MockServerIpc>;
-    static from(contextName: string): MockServerIpc;
-    namespacesByName: Map<string, MockNamespaceIpc>;
-    constructor(contextName: string);
-    of(namespace: string): MockNamespaceIpc;
-}
-declare class MockNamespaceIpc {
-    /**
-     * Namespace name
-     */
-    name: string;
-    server: MockServerIpc;
-    electronClients: Set<Electron.WebContents>;
-    roomsByRoomName: {
-        [roomName: string]: Set<Electron.WebContents>;
-    };
-    private namespaceEventHandlers;
-    constructor(
-    /**
-     * Namespace name
-     */
-    name: string, server: MockServerIpc);
-    on(eventName: string, callback: RealtimeModels.EventHandler): any;
-    off(event: string, callback?: RealtimeModels.EventHandler): any;
-    emit(eventName: string, ...args: any[]): any;
-    to(roomName: string): RoomEmitterIpc;
-    in(roomName: string): RoomEmitterIpc;
-    join(webContents: Electron.WebContents, roomName: string): void;
-    leave(webContents: Electron.WebContents, roomName: string): void;
-    path(): string;
-    get nsp(): {
-        readonly name: string;
-    };
-}
-declare class RoomEmitterIpc {
-    private electronClients;
-    /**
-     * namespace name
-     */
-    private name;
-    private includeSender;
-    private sender;
-    constructor(electronClients: Set<Electron.WebContents>, 
-    /**
-     * namespace name
-     */
-    name: string, includeSender?: boolean, sender?: MockSocketIpc);
-    emit(eventName: string, ...args: any[]): void;
-}
-declare class MockSocketIpc {
-    namespaceName: string;
-    ipcRenderer: typeof ipcRenderer;
-    private socketEventHandlers;
-    get name(): string;
-    /**
-     * @param namespaceName instead url for ipc
-     */
-    constructor(namespaceName: string);
-    on(eventName: string, callback: (event: any, ...args: any[]) => void): void;
-    off(event: string, callback?: (event: any, ...args: any[]) => void): void;
-    emit(event: string, ...args: any[]): void;
-}
-/**
- * Purpose:
- * - backend-browser communication between 2 processes in electron mode
- */
-declare class RealtimeStrategyIpc extends RealtimeStrategy {
-    protected ctx: EndpointContext;
-    toString(): string;
-    constructor(ctx: EndpointContext);
-    ioServer(__: string, opt: ServerOptions): any;
-    get ioClient(): any;
-}
-
-/**
- * Purpose:
- * - browser-browser communication mock (in websql mode)
- */
-declare class RealtimeStrategyMock extends RealtimeStrategy {
-    protected ctx: EndpointContext;
-    toString(): string;
-    constructor(ctx: EndpointContext);
-    ioServer(url: string, opt: ServerOptions): any;
-    get ioClient(): any;
-}
-
-/**
- * Purpose:
- * - backend-browser communication
- * - backend-backend communication
- */
-declare class RealtimeStrategySocketIO extends RealtimeStrategy {
-    protected ctx: EndpointContext;
-    toString(): string;
-    constructor(ctx: EndpointContext);
-    ioServer(...args: any[]): any;
-    get ioClient(): typeof io;
-}
-
-/**
- * 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)
- */
-declare class RealtimeCore {
-    ctx: EndpointContext;
-    readonly allHttpMethods: string[];
-    readonly client: RealtimeClient;
-    readonly server: RealtimeServer;
-    readonly strategy: RealtimeStrategy;
-    /**
-     * global FE socket - only for established connection
-     */
-    conectSocketFE: Socket<DefaultEventsMap, DefaultEventsMap>;
-    /**
-     * socket for namespaces and rooms
-     */
-    socketFE: Socket<DefaultEventsMap, DefaultEventsMap>;
-    /**
-     * global BE socket - only for established connection
-     */
-    connectSocketBE: Server$1<DefaultEventsMap, DefaultEventsMap, DefaultEventsMap, any>;
-    /**
-     * socket for namespaces and rooms
-     */
-    socketBE: Server$1<DefaultEventsMap, DefaultEventsMap, DefaultEventsMap, any>;
-    constructor(ctx: EndpointContext);
-    private resolveStrategy;
-    pathFor(namespace?: string): URL;
-}
-
-/**
- * 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
- */
-declare class RealtimeClient {
-    private core;
-    private subsManagers;
-    constructor(core: RealtimeCore);
-    private init;
-    /**
-     * 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.ChangeOption): Observable<RESULT>;
-    /**
-     * Listen changes entity table
-     * Example: for pagination, lists update ...
-     */
-    listenChangesEntityTable<RESULT = any>(entityClassFn: Function): Observable<RESULT>;
-    listenChangesCustomEvent<RESULT = any>(customEvent: string): Observable<RESULT>;
-    /**
-     * Trigger custom event on backend
-     * @param customEvent global event name
-     * @param dataToPush
-     */
-    triggerCustomEvent(customEvent: string, dataToPush?: any): void;
-    private getUniqueIdentifierForConnection;
-}
-
 declare class RealtimeSubsManager {
     private options;
     private isListening;