taon 19.0.65 → 19.0.67

package/browser/lib/base-classes/base-class.d.ts

@@ -5,5 +5,12 @@ export declare class BaseClass<CloneT extends BaseClass = any> {
      * taon after class instance creation
      */
     _(): Promise<void>;
-    clone(override?: Partial<CloneT>): CloneT;
+    /**
+     *
+     * @param overrideObjOrFn if object is provided it will override values in cloned object,
+     * if function is provided it will be called with old cloned values and should return
+     * object with values to override
+     * @returns cloned instance of the class
+     */
+    clone(overrideObjOrFn?: Partial<CloneT> | ((oldValues: Partial<CloneT>) => Partial<CloneT>)): CloneT;
 }

package/browser/lib/base-classes/base-controller.d.ts

@@ -1,4 +1,5 @@
 // @ts-nocheck
+import { RestErrorResponseWrapper, HttpResponseError } from 'ng2-rest/browser';
 import type { ContextsEndpointStorage } from '../endpoint-context-storage';
 import type { Models } from '../models';
 import { BaseInjector } from './base-injector';
@@ -13,7 +14,7 @@ export interface MulterFileUploadResponse {
     size: number;
     mimetype: string;
 }
-export declare class BaseController<T = any> extends BaseInjector {
+export declare class BaseController<UPLOAD_FILE_QUERY_PARAMS = {}> extends BaseInjector {
     /**
      * Hook that is called when taon app is inited
      * (all contexts are created and inited)
@@ -21,11 +22,62 @@ export declare class BaseController<T = any> extends BaseInjector {
     afterAllCtxInited(options: {
         ctxStorage: ContextsEndpointStorage;
     }): Promise<void>;
-    uploadFormDataToServer(formData: FormData): Models.Http.Response<MulterFileUploadResponse[]>;
+    uploadFormDataToServer(formData: FormData, queryParams?: UPLOAD_FILE_QUERY_PARAMS): Models.Http.Response<MulterFileUploadResponse[]>;
     /**
      * Hook after file is uploaded
      * through `uploadFormDataToServer` or `uploadLocalFileToServer`
      */
-    protected afterFileUploadAction(file: MulterFileUploadResponse): void | Promise<void>;
-    uploadLocalFileToServer(absFilePath: string, options?: Pick<Models.Http.Rest.Ng2RestAxiosRequestConfig, 'onUploadProgress'>): Promise<MulterFileUploadResponse[]>;
+    protected afterFileUploadAction(file?: MulterFileUploadResponse, queryParams?: UPLOAD_FILE_QUERY_PARAMS): void | Promise<void>;
+    uploadLocalFileToServer(absFilePath: string, options?: Pick<Models.Http.Rest.Ng2RestAxiosRequestConfig, 'onUploadProgress'>, queryParams?: UPLOAD_FILE_QUERY_PARAMS): Promise<MulterFileUploadResponse[]>;
+    /**
+     * Easy way to wait for status change with http (1s default) pooling.
+     *
+     * example (in sub class):
+     * ```ts
+        async check() {
+            await this.waitForProperStatusChange({
+              request: () => this.uploadFormDataToServer(void 0, void 0).request(),
+              statusCheck: resp => resp.body.json[0].ok,
+            });
+          }
+     * ```
+     */
+    _waitForProperStatusChange<T>(options: {
+        actionName: string;
+        /**
+         * Request for pooling
+         */
+        request: (opt?: {
+            /**
+             * optional index number to identify request in logs
+             * (starts from 0 and increments by 1 on each try)
+             */
+            reqIndexNum?: number;
+            httpErrorsCount?: number;
+        }) => ReturnType<Models.Http.Response<T>['request']>;
+        poolingInterval?: number;
+        /**
+         * default infinite tries
+         */
+        maxTries?: number;
+        /**
+         * default infiniti allowed http errors
+         */
+        allowedHttpErrors?: number;
+        /**
+         * condition to be met
+         */
+        statusCheck?: (response: Awaited<ReturnType<typeof options.request>>) => boolean;
+        /**
+         * if return true.. loop will continue
+         * if false .. will exit the loop
+         */
+        loopRequestsOnBackendError?: (opt: {
+            unknownError: Error;
+            unknownHttpError: HttpResponseError<any>;
+            taonError: HttpResponseError<RestErrorResponseWrapper>;
+            reqIndexNum?: number;
+            httpErrorsCount?: number;
+        }) => boolean | Promise<boolean>;
+    }): Promise<void>;
 }

package/browser/lib/base-classes/base-crud-controller.d.ts

@@ -5,10 +5,10 @@ import { BaseRepository } from './base-repository';
 /**
  * Please override property entityClassFn with entity class.
  */
-export declare abstract class BaseCrudController<Entity> extends BaseController {
+export declare abstract class BaseCrudController<Entity, UPLOAD_FILE_QUERY_PARAMS = {}> extends BaseController<UPLOAD_FILE_QUERY_PARAMS> {
     protected db: BaseRepository<Entity>;
     /**
-     * Please provide entity as class propery entityClassFn:
+     * Please provide entity as class property entityClassFn:
      * @returns class function
      *
      */
@@ -21,8 +21,9 @@ export declare abstract class BaseCrudController<Entity> extends BaseController
     updateById(id: number | string, item: Entity): Models.Http.Response<Entity>;
     patchById(id: number | string, item: Entity): Models.Http.Response<Entity>;
     bulkUpdate(items: Entity[]): Models.Http.Response<Entity[]>;
-    deleteById(id: number): Models.Http.Response<Entity>;
+    deleteById(id: number | string): Models.Http.Response<Entity>;
     bulkDelete(ids: (number | string)[]): Models.Http.Response<(number | string | Entity)[]>;
-    create(item: Entity): Models.Http.Response<Entity>;
+    clearTable(): Models.Http.Response<void>;
+    save(item: Entity): Models.Http.Response<Entity>;
     bulkCreate(items: Entity): Models.Http.Response<Entity[]>;
 }

package/browser/lib/base-classes/base-repository.d.ts

@@ -61,6 +61,9 @@ export declare abstract class BaseRepository<Entity extends {
     bulkSave(items: Entity[], options?: SaveOptions & {
         reload: false;
     }): Promise<Entity[]>;
+    /**
+     * @deprecated use bulkSave instead
+     */
     bulkCreate(items: Entity[], options?: SaveOptions & {
         reload: false;
     }): Promise<Entity[]>;

package/browser/lib/config/method-config.d.ts

@@ -17,6 +17,7 @@ export declare class MethodConfig implements Pick<TaonHttpDecoratorOptions, 'pat
      * override default axiso response type
      */
     responseType?: any;
+    overrideExpressSendAsHtml?: boolean;
     path: string;
     descriptor: PropertyDescriptor;
     type: CoreModels.HttpMethod;

package/browser/lib/decorators/http/http-decorators.d.ts

@@ -1,7 +1,7 @@
 // @ts-nocheck
+import { Models } from 'ng2-rest/browser';
 import * as methods from './http-methods-decorators';
 import * as params from './http-params-decorators';
-import { Models } from 'ng2-rest/browser';
 export declare namespace Http {
     export import GET = methods.GET;
     export import POST = methods.POST;
@@ -9,6 +9,7 @@ export declare namespace Http {
     export import DELETE = methods.DELETE;
     export import PATCH = methods.PATCH;
     export import HEAD = methods.HEAD;
+    export import HTML = methods.HTML;
     export import Response = Models.HttpResponse;
     namespace Param {
         export import Query = params.Query;

package/browser/lib/decorators/http/http-methods-decorators.d.ts

@@ -18,21 +18,52 @@ export type TaonMiddlewareFunction = (options: {
 export interface TaonHttpDecoratorOptions {
     /**
      * @deprecated don't use in production - keep stuff encapsulated
-     * path is global in express app
-     * ! BE CAREFUL ! global path IS NOT GLOBAL inside dockerized app
-     *  (/api/contextName is automatically added to global path in docker)
+     * normally path is generated from method name and its params
      */
     path?: string;
     /**
-     * ! BE CAREFULL
      * If true, the path will be global
+     *
+     * ! BE CAREFUL ! global path IS NOT GLOBAL inside dockerized app
+     * (/api/contextName is automatically added to global path in docker)
+     *
+     * @deprecated don't use in production - keep stuff encapsulated
      */
     pathIsGlobal?: boolean;
     overrideContentType?: CoreModels.ContentType;
     overrideResponseType?: ModelsNg2Rest.ResponseTypeAxios;
+    /**
+     * Express will send response as HTML string with proper headers
+     */
+    overrideExpressSendAsHtml?: boolean;
     middlewares?: TaonMiddlewareFunction;
 }
 export declare function GET(pathOrOptions?: string | TaonHttpDecoratorOptions, pathIsGlobal?: boolean): (target: any, propertyKey: string, descriptor: PropertyDescriptor) => void;
+/**
+ * Method for sending html website from text
+ * Example
+ *
+ * ```ts
+ * ...
+ * // in your taon controller
+ * ..Taon.Http.HTML()
+ * sendHtmlDummyWebsite(): Taon.ResponseHtml {
+ *  return  `
+      <html>
+        <head>
+          <title>Dummy website</title>
+        </head>
+        <body>
+          <h1>This is dummy website</h1>
+          <p>Served as HTML string from Taon controller method</p>
+        </body>
+      </html>
+ *  `; *
+ * }
+ * ...
+ * ```
+ */
+export declare function HTML(pathOrOptions?: Pick<TaonHttpDecoratorOptions, 'path' | 'pathIsGlobal'>): (target: any, propertyKey: string, descriptor: PropertyDescriptor) => void;
 export declare function HEAD(pathOrOptions?: string | TaonHttpDecoratorOptions, pathIsGlobal?: boolean): (target: any, propertyKey: string, descriptor: PropertyDescriptor) => void;
 export declare function POST(pathOrOptions?: string | TaonHttpDecoratorOptions, pathIsGlobal?: boolean): (target: any, propertyKey: string, descriptor: PropertyDescriptor) => void;
 export declare function PUT(pathOrOptions?: string | TaonHttpDecoratorOptions, pathIsGlobal?: boolean): (target: any, propertyKey: string, descriptor: PropertyDescriptor) => void;

package/browser/lib/decorators/http/http-params-decorators.d.ts

@@ -1,4 +1,7 @@
 // @ts-nocheck
+/**
+ * @deprecated use Taon.Http.Param.Path (is more safe and cleaner)
+ */
 export declare function Path(name: string): (target: any, propertyKey: string | symbol, parameterIndex: number) => void;
 export declare function Query(name?: string): (target: any, propertyKey: string | symbol, parameterIndex: number) => void;
 export declare function Cookie(name: string, expireInSecond?: number): (target: any, propertyKey: string | symbol, parameterIndex: number) => void;

package/browser/lib/endpoint-context.d.ts

@@ -1,6 +1,7 @@
 // @ts-nocheck
 import type { Server } from 'http';
 import type { NgZone } from '@angular/core';
+import * as express from 'express';
 import type { Application } from 'express';
 import { DataSource } from 'taon-typeorm/browser';
 import type { BaseInjector } from './base-classes/base-injector';
@@ -66,6 +67,7 @@ export declare class EndpointContext {
     get logHttp(): boolean;
     get logRealtime(): boolean;
     get logFramework(): boolean;
+    get logRoutes(): boolean;
     get logDb(): boolean;
     get logMigrations(): boolean;
     /**
@@ -185,6 +187,7 @@ export declare class EndpointContext {
     private initCustomBackendMiddlewares;
     private initBackendMiddlewares;
     private initServer;
+    protected sendError(res: express.Response, error: unknown, req: express.Request, expressPath: string): void;
     /**
      * client can be browser or nodejs (when remote host)
      */

package/browser/lib/get-response-value.d.ts

@@ -1,6 +1,6 @@
 // @ts-nocheck
-import { Models } from './models';
 import { Response as ExpressResponse, Request as ExpressRequest } from 'express';
+import { Models } from './models';
 export declare const getResponseValue: <T>(response: Models.Http.Response<T>, options?: {
     req: ExpressRequest;
     res: ExpressResponse;

package/browser/lib/helpers/taon-helpers.d.ts

@@ -4,6 +4,7 @@ import { MethodConfig } from '../config/method-config';
 export declare namespace TaonHelpers {
     const fillUpTo: (s: string, nCharacters: number) => string;
     const isGoodPath: (p: string) => boolean;
+    const firstStringOrElemFromArray: (stringOrArrayOfString: string[] | string) => string;
     const tryTransformParam: (param: any) => any;
     const getExpressPath: (c: ControllerConfig, pathOrClassConfig: Partial<MethodConfig>) => string;
     const defaultType: (value: any) => {};

package/browser/lib/index.d.ts

@@ -1,6 +1,7 @@
 // @ts-nocheck
 import 'reflect-metadata';
 import { NgZone } from '@angular/core';
+import { RestErrorResponseWrapper } from 'ng2-rest/browser';
 import * as base from './base-classes/base';
 import * as controllerDecorator from './decorators/classes/controller-decorator';
 import * as entityDecorator from './decorators/classes/entity-decorator';
@@ -23,6 +24,7 @@ export { BaseProvider } from './base-classes/base-provider';
 export { BaseEntity } from './base-classes/base-entity';
 export { BaseContext } from './base-classes/base-context';
 export { BaseMigration } from './base-classes/base-migration';
+export { BaseClass } from './base-classes/base-class';
 export { TaonAdditionalMiddlewareMethodInfo } from './base-classes/base-middleware';
 export { createContext, TaonContext } from './create-context';
 export { inject } from './inject';
@@ -34,6 +36,8 @@ export { ContextsEndpointStorage } from './endpoint-context-storage';
 export { ClassHelpers } from './helpers/class-helpers';
 export type { TaonClientMiddlewareInterceptOptions, TaonServerMiddlewareInterceptOptions, } from 'ng2-rest/browser';
 export declare namespace Taon {
+    const error: (opt: Pick<RestErrorResponseWrapper, "message" | "status" | "details" | "code">) => void;
+    type ResponseHtml = models.Models.Http.Response<string>;
     export import Response = models.Models.Http.Response;
     export import Http = http.Http;
     export import Base = base.Base;

package/browser/lib/models.d.ts

@@ -1,8 +1,10 @@
 // @ts-nocheck
 import { Response as ExpressResponse, Request as ExpressRequest } from 'express';
-import { Models as ModelsNg2Rest } from 'ng2-rest/browser';
+import { Models as ModelsNg2Rest, RestResponseWrapper } from 'ng2-rest/browser';
 import { CoreModels } from 'tnp-core/browser';
 import type { EndpointContext } from './endpoint-context';
+export declare class TaonRestResponseWrapper extends RestResponseWrapper {
+}
 export declare namespace Models {
     type FrameworkMode = 'backend-frontend(tcp+udp)' | 'remote-backend(tcp+udp)' | 'backend-frontend(ipc-electron)' | 'backend-frontend(websql-electron)' | 'backend-frontend(websql)';
     enum ClassType {
@@ -82,6 +84,7 @@ export declare namespace Models {
         framework?: boolean;
         db?: boolean;
         migrations?: boolean;
+        routes?: boolean;
     };
     interface ContextOptions<CONTEXTS, CONTROLLERS, ENTITIES, REPOSITORIES, PROVIDERS, SUBSCRIBERS, MIGRATIONS, MIDDLEWARES> {
         appId?: string;
@@ -230,15 +233,6 @@ export declare namespace Models {
             (req?: ExpressRequest, res?: ExpressResponse): Promise<SyncResponse<T> | SyncResponseFunc<T>>;
         }
         type Response<T = string> = AsyncResponse<T> & ClientAction<T>;
-        class Errors {
-            message: string;
-            private code;
-            toString: () => string;
-            private constructor();
-            private static create;
-            static entityNotFound(entity?: Function): Errors;
-            static custom(message: string, code?: ModelsNg2Rest.HttpCode): Errors;
-        }
     }
     interface StartParams {
         port: number;

package/browser/lib/realtime/realtime-client.d.ts

@@ -1,33 +1,37 @@
 // @ts-nocheck
 import { Observable } from 'rxjs';
-import type { BaseEntity } from '../base-classes/base-entity';
 import { RealtimeCore } from './realtime-core';
 import { RealtimeModels } from './realtime.models';
+/**
+ * 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 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:
      *
-     * ...
-     * Context.Realtime.Server.TrigggerEntityChanges(myEntityInstance);
+     * myContext.realtimeServer.triggerEntityChanges(myEntityInstance);
      * ...
      */
-    listenChangesEntity(entityClassFn: Function, idOrUniqValue: any, options: RealtimeModels.ChangeOption): Observable<unknown>;
-    listenChangesEntityTable(entityClassFn: Function): Observable<unknown>;
+    listenChangesEntity<RESULT = any>(entityClassFnOrObj: Function | object, options?: RealtimeModels.ChangeOption): Observable<RESULT>;
     /**
-     * Changes trigger on backend needs to be done manually.. example code:
-     *
-     * ...
-     * Context.Realtime.Server.TrigggerEntityChanges(myEntityInstance);
-     * // or
-     * Context.Realtime.Server.TrigggerEntityPropertyChanges(myEntityInstance,{ property: 'geolocationX' });
-     * ...
+     * Listen changes entity table
+     * Example: for pagination, lists update ...
      */
-    listenChangesEntityObj<T extends BaseEntity>(entity: T, options?: RealtimeModels.ChangeOption): Observable<unknown>;
-    listenChangesCustomEvent(customEvent: string): Observable<unknown>;
+    listenChangesEntityTable<RESULT = any>(entityClassFn: Function): Observable<RESULT>;
+    listenChangesCustomEvent<RESULT = any>(customEvent: string): Observable<RESULT>;
     /**
      * Trigger custom event on backend
      * @param customEvent global event name

package/browser/lib/realtime/realtime-server.d.ts

@@ -1,14 +1,39 @@
 // @ts-nocheck
 import { Observable } from 'rxjs';
-import type { BaseEntity } from '../base-classes/base-entity';
 import { RealtimeCore } from './realtime-core';
+/**
+ * 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
+ */
 export declare class RealtimeServer {
     private core;
     constructor(core: RealtimeCore);
     private init;
     private triggerChanges;
-    triggerEntityChanges(entityObjOrClass: Function, idToTrigger?: number | string): void;
-    triggerEntityPropertyChanges<ENTITY extends BaseEntity>(entityObjOrClass: new (...args: any[]) => ENTITY, property: keyof ENTITY | (keyof ENTITY)[], idToTrigger?: number | string): void;
+    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;
     /**

package/browser/lib/realtime/realtime.models.d.ts

@@ -7,9 +7,22 @@ export declare namespace RealtimeModels {
         roomName: string;
         property: string;
     };
-    type ChangeOption = {
+    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;
 }

package/browser/package.json

@@ -1,6 +1,6 @@
 {
   "name": "taon/browser",
-  "version": "19.0.65",
+  "version": "19.0.67",
   "module": "fesm2022/taon.mjs",
   "typings": "index.d.ts",
   "exports": {

package/icon-menu-taon.svg

@@ -1,15 +1,15 @@
-<?xml version="1.0" encoding="UTF-8" standalone="no"?>
-<svg
-   viewBox="0 0 23.432 23.432004"
-   version="1.1"
-   id="svg1"
-   width="23.431999"
-   height="23.432003"
-   xmlns="http://www.w3.org/2000/svg"
-   xmlns:svg="http://www.w3.org/2000/svg">
-  <defs
-     id="defs1" />
-  <path
-     id="path1"
-     d="m 11.521484,1.265625 c -0.953032,1.5597622 -1.9887223,3.0593334 -3.1074215,4.5 C 6.9495642,4.7476223 5.485983,3.7308932 4.0214844,2.7128906 3.8829075,2.6603831 3.738968,2.6414114 3.5917969,2.6582031 2.7651252,6.7213623 1.8733597,10.758159 0.9140625,14.767578 v 0.75 c 1.6097872,1.096932 3.2239518,2.188127 4.8417969,3.273438 v 0.08008 h 0.1171875 c 1.806633,1.211497 3.6188659,2.414261 5.4355471,3.611328 0.07144,0.07147 0.14145,0.143364 0.21289,0.214844 h 0.429688 c 3.432812,-2.431526 6.897745,-4.824781 10.394531,-7.179688 V 14.552734 C 21.353633,10.612741 20.406845,6.6479161 19.505859,2.6582031 19.42892,2.5563391 19.339974,2.5393307 19.238281,2.6054688 17.782054,3.6890192 16.286176,4.7048374 14.75,5.6523438 a 3.4715793,3.1345327 0 0 0 -0.01758,-0.00195 C 13.814421,4.161603 12.851221,2.7003542 11.84375,1.265625 Z M 4.1855469,8.9433594 H 10.810547 V 10.048828 H 8.34375 V 15.46875 H 6.6601562 V 10.048828 H 4.1855469 Z m 7.7285151,0 h 1.638672 l 3.41211,4.3574216 V 8.9433594 h 1.564453 V 15.46875 h -1.689453 l -3.361328,-4.253906 v 4.253906 h -1.564454 z" />
-</svg>
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<svg
+   viewBox="0 0 23.432 23.432004"
+   version="1.1"
+   id="svg1"
+   width="23.431999"
+   height="23.432003"
+   xmlns="http://www.w3.org/2000/svg"
+   xmlns:svg="http://www.w3.org/2000/svg">
+  <defs
+     id="defs1" />
+  <path
+     id="path1"
+     d="m 11.521484,1.265625 c -0.953032,1.5597622 -1.9887223,3.0593334 -3.1074215,4.5 C 6.9495642,4.7476223 5.485983,3.7308932 4.0214844,2.7128906 3.8829075,2.6603831 3.738968,2.6414114 3.5917969,2.6582031 2.7651252,6.7213623 1.8733597,10.758159 0.9140625,14.767578 v 0.75 c 1.6097872,1.096932 3.2239518,2.188127 4.8417969,3.273438 v 0.08008 h 0.1171875 c 1.806633,1.211497 3.6188659,2.414261 5.4355471,3.611328 0.07144,0.07147 0.14145,0.143364 0.21289,0.214844 h 0.429688 c 3.432812,-2.431526 6.897745,-4.824781 10.394531,-7.179688 V 14.552734 C 21.353633,10.612741 20.406845,6.6479161 19.505859,2.6582031 19.42892,2.5563391 19.339974,2.5393307 19.238281,2.6054688 17.782054,3.6890192 16.286176,4.7048374 14.75,5.6523438 a 3.4715793,3.1345327 0 0 0 -0.01758,-0.00195 C 13.814421,4.161603 12.851221,2.7003542 11.84375,1.265625 Z M 4.1855469,8.9433594 H 10.810547 V 10.048828 H 8.34375 V 15.46875 H 6.6601562 V 10.048828 H 4.1855469 Z m 7.7285151,0 h 1.638672 l 3.41211,4.3574216 V 8.9433594 h 1.564453 V 15.46875 h -1.689453 l -3.361328,-4.253906 v 4.253906 h -1.564454 z" />
+</svg>

package/lib/base-classes/base-class.d.ts

@@ -4,5 +4,12 @@ export declare class BaseClass<CloneT extends BaseClass = any> {
      * taon after class instance creation
      */
     _(): Promise<void>;
-    clone(override?: Partial<CloneT>): CloneT;
+    /**
+     *
+     * @param overrideObjOrFn if object is provided it will override values in cloned object,
+     * if function is provided it will be called with old cloned values and should return
+     * object with values to override
+     * @returns cloned instance of the class
+     */
+    clone(overrideObjOrFn?: Partial<CloneT> | ((oldValues: Partial<CloneT>) => Partial<CloneT>)): CloneT;
 }

package/lib/base-classes/base-class.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.BaseClass = void 0;
+const lib_1 = require("tnp-core/lib");
 const class_helpers_1 = require("../helpers/class-helpers");
 const clone_obj_1 = require("../helpers/clone-obj");
 //#endregion
@@ -13,9 +14,26 @@ class BaseClass {
     async _() { }
     //#endregion
     //#region clone
-    clone(override) {
+    /**
+     *
+     * @param overrideObjOrFn if object is provided it will override values in cloned object,
+     * if function is provided it will be called with old cloned values and should return
+     * object with values to override
+     * @returns cloned instance of the class
+     */
+    clone(overrideObjOrFn) {
+        if (lib_1._.isString(overrideObjOrFn)) {
+            console.log(overrideObjOrFn);
+            throw new Error('String is not supported as .clone() method argument');
+        }
         const classFn = class_helpers_1.ClassHelpers.getClassFnFromObject(this);
-        return (0, clone_obj_1.cloneObj)(override, classFn);
+        if (lib_1._.isFunction(overrideObjOrFn)) {
+            // console.log('clone with fn');
+            const oldValues = (lib_1._.cloneDeep(this) || {});
+            return (0, clone_obj_1.cloneObj)(overrideObjOrFn(oldValues), classFn);
+        }
+        // console.log('clone normal');
+        return (0, clone_obj_1.cloneObj)(overrideObjOrFn, classFn);
     }
 }
 exports.BaseClass = BaseClass;

package/lib/base-classes/base-class.js.map

@@ -1 +1 @@
-{"version":3,"file":"base-class.js","sourceRoot":"","sources":[""],"names":[],"mappings":";;;AAIA,4DAAwD;AACxD,oDAAgD;AAEhD,YAAY;AAEZ,MAAa,SAAS;IACpB,mCAAmC;IACnC;;;OAGG;IACH,KAAK,CAAC,CAAC,KAAmB,CAAC;IAC3B,YAAY;IAEZ,eAAe;IACR,KAAK,CAAC,QAA0B;QACrC,MAAM,OAAO,GAAG,4BAAY,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC;QACxD,OAAO,IAAA,oBAAQ,EAAS,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC7C,CAAC;CAEF;AAfD,8BAeC"}
+{"version":3,"file":"base-class.js","sourceRoot":"","sources":[""],"names":[],"mappings":";;;AAEA,sCAAiC;AAEjC,4DAAwD;AACxD,oDAAgD;AAEhD,YAAY;AAEZ,MAAa,SAAS;IACpB,mCAAmC;IACnC;;;OAGG;IACH,KAAK,CAAC,CAAC,KAAmB,CAAC;IAC3B,YAAY;IAEZ,eAAe;IACf;;;;;;OAMG;IACI,KAAK,CACV,eAEqD;QAErD,IAAG,OAAC,CAAC,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAC;YAC/B,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;YAC7B,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;QACzE,CAAC;QACD,MAAM,OAAO,GAAG,4BAAY,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC;QACxD,IAAI,OAAC,CAAC,UAAU,CAAC,eAAe,CAAC,EAAE,CAAC;YAClC,gCAAgC;YAChC,MAAM,SAAS,GAAG,CAAC,OAAC,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,CAA2B,CAAC;YACtE,OAAO,IAAA,oBAAQ,EAAS,eAAe,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,CAAC;QAC/D,CAAC;QACD,+BAA+B;QAC/B,OAAO,IAAA,oBAAQ,EAAS,eAAsB,EAAE,OAAO,CAAC,CAAC;IAC3D,CAAC;CAEF;AApCD,8BAoCC"}

package/lib/base-classes/base-controller.d.ts

@@ -1,4 +1,5 @@
 import * as FormData from 'form-data';
+import { RestErrorResponseWrapper, HttpResponseError } from 'ng2-rest';
 import type { ContextsEndpointStorage } from '../endpoint-context-storage';
 import type { Models } from '../models';
 import { BaseInjector } from './base-injector';
@@ -13,7 +14,7 @@ export interface MulterFileUploadResponse {
     size: number;
     mimetype: string;
 }
-export declare class BaseController<T = any> extends BaseInjector {
+export declare class BaseController<UPLOAD_FILE_QUERY_PARAMS = {}> extends BaseInjector {
     /**
      * Hook that is called when taon app is inited
      * (all contexts are created and inited)
@@ -21,11 +22,62 @@ export declare class BaseController<T = any> extends BaseInjector {
     afterAllCtxInited(options: {
         ctxStorage: ContextsEndpointStorage;
     }): Promise<void>;
-    uploadFormDataToServer(formData: FormData): Models.Http.Response<MulterFileUploadResponse[]>;
+    uploadFormDataToServer(formData: FormData, queryParams?: UPLOAD_FILE_QUERY_PARAMS): Models.Http.Response<MulterFileUploadResponse[]>;
     /**
      * Hook after file is uploaded
      * through `uploadFormDataToServer` or `uploadLocalFileToServer`
      */
-    protected afterFileUploadAction(file: MulterFileUploadResponse): void | Promise<void>;
-    uploadLocalFileToServer(absFilePath: string, options?: Pick<Models.Http.Rest.Ng2RestAxiosRequestConfig, 'onUploadProgress'>): Promise<MulterFileUploadResponse[]>;
-}
+    protected afterFileUploadAction(file?: MulterFileUploadResponse, queryParams?: UPLOAD_FILE_QUERY_PARAMS): void | Promise<void>;
+    uploadLocalFileToServer(absFilePath: string, options?: Pick<Models.Http.Rest.Ng2RestAxiosRequestConfig, 'onUploadProgress'>, queryParams?: UPLOAD_FILE_QUERY_PARAMS): Promise<MulterFileUploadResponse[]>;
+    /**
+     * Easy way to wait for status change with http (1s default) pooling.
+     *
+     * example (in sub class):
+     * ```ts
+        async check() {
+            await this.waitForProperStatusChange({
+              request: () => this.uploadFormDataToServer(void 0, void 0).request(),
+              statusCheck: resp => resp.body.json[0].ok,
+            });
+          }
+     * ```
+     */
+    _waitForProperStatusChange<T>(options: {
+        actionName: string;
+        /**
+         * Request for pooling
+         */
+        request: (opt?: {
+            /**
+             * optional index number to identify request in logs
+             * (starts from 0 and increments by 1 on each try)
+             */
+            reqIndexNum?: number;
+            httpErrorsCount?: number;
+        }) => ReturnType<Models.Http.Response<T>['request']>;
+        poolingInterval?: number;
+        /**
+         * default infinite tries
+         */
+        maxTries?: number;
+        /**
+         * default infiniti allowed http errors
+         */
+        allowedHttpErrors?: number;
+        /**
+         * condition to be met
+         */
+        statusCheck?: (response: Awaited<ReturnType<typeof options.request>>) => boolean;
+        /**
+         * if return true.. loop will continue
+         * if false .. will exit the loop
+         */
+        loopRequestsOnBackendError?: (opt: {
+            unknownError: Error;
+            unknownHttpError: HttpResponseError<any>;
+            taonError: HttpResponseError<RestErrorResponseWrapper>;
+            reqIndexNum?: number;
+            httpErrorsCount?: number;
+        }) => boolean | Promise<boolean>;
+    }): Promise<void>;
+}