@sankhyalabs/core 5.2.0 → 5.3.0

package/.docs/classes/PromiseSync.md

@@ -0,0 +1,91 @@
+[@sankhyalabs/core](../README.md) / [Exports](../modules.md) / PromiseSync
+
+# Class: PromiseSync<T\>
+
+O intuito desta classe é organizar a finalização de várias
+promessas executando determinada ação (callback) com o resultado.
+
+## Type parameters
+
+| Name |
+| :------ |
+| `T` |
+
+## Table of contents
+
+### Constructors
+
+- [constructor](PromiseSync.md#constructor)
+
+### Properties
+
+- [\_callBack](PromiseSync.md#_callback)
+- [\_promises](PromiseSync.md#_promises)
+
+### Methods
+
+- [add](PromiseSync.md#add)
+
+## Constructors
+
+### constructor
+
+• **new PromiseSync**<`T`\>(`callBack`)
+
+#### Type parameters
+
+| Name |
+| :------ |
+| `T` |
+
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `callBack` | [`PromiseSyncCallback`](../interfaces/PromiseSyncCallback.md)<`T`\> |
+
+#### Defined in
+
+src/async/PromiseSync.ts:13
+
+## Properties
+
+### \_callBack
+
+• **\_callBack**: [`PromiseSyncCallback`](../interfaces/PromiseSyncCallback.md)<`T`\>
+
+#### Defined in
+
+src/async/PromiseSync.ts:8
+
+___
+
+### \_promises
+
+• **\_promises**: `Promise`<`T`\>[]
+
+#### Defined in
+
+src/async/PromiseSync.ts:7
+
+## Methods
+
+### add
+
+▸ **add**(`promise`): `void`
+
+Adiciona na lista de promises pendentes. Isso faz com que criemos uma nova espera.
+
+#### Parameters
+
+| Name | Type | Description |
+| :------ | :------ | :------ |
+| `promise` | `Promise`<`T`\> | Entrará na lista aguardada. |
+
+#### Returns
+
+`void`
+
+#### Defined in
+
+src/async/PromiseSync.ts:23

package/.docs/interfaces/PromiseSyncCallback.md

@@ -0,0 +1,39 @@
+[@sankhyalabs/core](../README.md) / [Exports](../modules.md) / PromiseSyncCallback
+
+# Interface: PromiseSyncCallback<T\>
+
+Representa o callback de um sincronizador `PromiseSync<T>`.
+
+## Type parameters
+
+| Name |
+| :------ |
+| `T` |
+
+## Table of contents
+
+### Methods
+
+- [resolve](PromiseSyncCallback.md#resolve)
+
+## Methods
+
+### resolve
+
+▸ **resolve**(`result`): `void`
+
+Será chamado sempre que todas as promessas adicionadas finalizarem.
+
+#### Parameters
+
+| Name | Type | Description |
+| :------ | :------ | :------ |
+| `result` | `PromiseSettledResult`<`Awaited`<`T`\>\>[] | A lista com o resultado de todas as promises aguardadas. |
+
+#### Returns
+
+`void`
+
+#### Defined in
+
+src/async/PromiseSync.ts:48

package/.docs/modules.md

@@ -38,6 +38,7 @@
 - [NumberUtils](classes/NumberUtils.md)
 - [ObjectUtils](classes/ObjectUtils.md)
 - [OnboardingUtils](classes/OnboardingUtils.md)
+- [PromiseSync](classes/PromiseSync.md)
 - [ReadyUtil](classes/ReadyUtil.md)
 - [RequestMetadata](classes/RequestMetadata.md)
 - [SelectionInfo](classes/SelectionInfo.md)
@@ -62,6 +63,7 @@
 - [LoadDataResponse](interfaces/LoadDataResponse.md)
 - [PageRequest](interfaces/PageRequest.md)
 - [PaginationInfo](interfaces/PaginationInfo.md)
+- [PromiseSyncCallback](interfaces/PromiseSyncCallback.md)
 - [QuickFilter](interfaces/QuickFilter.md)
 - [Record](interfaces/Record.md)
 - [SavedRecord](interfaces/SavedRecord.md)

package/dist/async/PromiseSync.d.ts

@@ -0,0 +1,29 @@
+/**
+ * O intuito desta classe é organizar a finalização de várias
+ * promessas executando determinada ação (callback) com o resultado.
+ */
+export default class PromiseSync<T> {
+    _promises: Array<Promise<T>>;
+    _callBack: PromiseSyncCallback<T>;
+    /**
+     * @param {PromiseSyncCallback<T>} callback - Será chamado sempre que todas as promises se resolverem.
+     */
+    constructor(callBack: PromiseSyncCallback<T>);
+    /**
+     * Adiciona na lista de promises pendentes. Isso faz com que criemos uma nova espera.
+     *
+     * @param {Promise<T>} promise - Entrará na lista aguardada.
+     */
+    add(promise: Promise<T>): void;
+}
+/**
+ * Representa o callback de um sincronizador `PromiseSync<T>`.
+ */
+export interface PromiseSyncCallback<T> {
+    /**
+     * Será chamado sempre que todas as promessas adicionadas finalizarem.
+     *
+     * @param result - A lista com o resultado de todas as promises aguardadas.
+     */
+    resolve(result: PromiseSettledResult<Awaited<T>>[]): void;
+}

package/dist/async/PromiseSync.js

@@ -0,0 +1,31 @@
+/**
+ * O intuito desta classe é organizar a finalização de várias
+ * promessas executando determinada ação (callback) com o resultado.
+ */
+export default class PromiseSync {
+    /**
+     * @param {PromiseSyncCallback<T>} callback - Será chamado sempre que todas as promises se resolverem.
+     */
+    constructor(callBack) {
+        this._promises = [];
+        this._callBack = callBack;
+    }
+    /**
+     * Adiciona na lista de promises pendentes. Isso faz com que criemos uma nova espera.
+     *
+     * @param {Promise<T>} promise - Entrará na lista aguardada.
+     */
+    add(promise) {
+        this._promises.push(promise);
+        Promise.allSettled(this._promises)
+            .then(result => {
+            if (result.length === this._promises.length) {
+                this._promises = [];
+                if (this._callBack) {
+                    this._callBack.resolve(result);
+                }
+            }
+        });
+    }
+}
+//# sourceMappingURL=PromiseSync.js.map

package/dist/async/PromiseSync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PromiseSync.js","sourceRoot":"","sources":["../../src/async/PromiseSync.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,OAAO,OAAO,WAAW;IAK5B;;OAEG;IACH,YAAY,QAAgC;QACxC,IAAI,CAAC,SAAS,GAAG,EAAE,CAAC;QACpB,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;IAC9B,CAAC;IAED;;;;OAIG;IACI,GAAG,CAAC,OAAmB;QAC1B,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC7B,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC;aAC7B,IAAI,CAAC,MAAM,CAAC,EAAE;YACX,IAAI,MAAM,CAAC,MAAM,KAAK,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE;gBACzC,IAAI,CAAC,SAAS,GAAG,EAAE,CAAC;gBAEpB,IAAI,IAAI,CAAC,SAAS,EAAE;oBAChB,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;iBAClC;aACJ;QACL,CAAC,CACJ,CAAC;IACN,CAAC;CACJ"}

package/dist/index.d.ts

@@ -29,4 +29,5 @@ import { JSUtils } from "./utils/JSUtils.js";
 import { DataUnitStorage } from "./dataunit/DataUnitStorage.js";
 import VersionUtils from './utils/VersionUtils.js';
 import { OnboardingUtils } from "./utils/OnboardingUtils.js";
-export { StringUtils, MaskFormatter, NumberUtils, FloatingManager, DateUtils, ArrayUtils, TimeFormatter, SkwHttpProvider, HttpProvider, RequestMetadata, AuthorizedServiceCaller, DataUnit, DataUnitStorage, Record, SavedRecord, DataType, UnitMetadata, FieldDescriptor, UserInterface, DependencyType, ChildDescriptor, ChildLink, DataUnitAction, Action, Change, Sort, Filter, ChangeOperation, DUActionInterceptor, ApplicationContext, WaitingChange, PageRequest, QuickFilter, ReadyUtil, ObjectUtils, WarningException, WaitingChangeException, ErrorException, ErrorTracking, ExecutionContext, PaginationInfo, SortingProvider, SortMode, LoadDataRequest, LoadDataResponse, SelectionInfo, SelectionMode, ElementIDUtils, IElementIDInfo, UserAgentUtils, JSUtils, VersionUtils, OnboardingUtils };
+import { default as PromiseSync, PromiseSyncCallback } from "./async/PromiseSync.js";
+export { StringUtils, MaskFormatter, NumberUtils, FloatingManager, DateUtils, ArrayUtils, TimeFormatter, SkwHttpProvider, HttpProvider, RequestMetadata, AuthorizedServiceCaller, DataUnit, DataUnitStorage, Record, SavedRecord, DataType, UnitMetadata, FieldDescriptor, UserInterface, DependencyType, ChildDescriptor, ChildLink, DataUnitAction, Action, Change, Sort, Filter, ChangeOperation, DUActionInterceptor, ApplicationContext, WaitingChange, PageRequest, QuickFilter, ReadyUtil, ObjectUtils, WarningException, WaitingChangeException, ErrorException, ErrorTracking, ExecutionContext, PaginationInfo, SortingProvider, SortMode, LoadDataRequest, LoadDataResponse, SelectionInfo, SelectionMode, ElementIDUtils, IElementIDInfo, UserAgentUtils, JSUtils, VersionUtils, OnboardingUtils, PromiseSync, PromiseSyncCallback };

package/dist/index.js

@@ -26,6 +26,7 @@ import { JSUtils } from "./utils/JSUtils.js";
 import { DataUnitStorage } from "./dataunit/DataUnitStorage.js";
 import VersionUtils from './utils/VersionUtils.js';
 import { OnboardingUtils } from "./utils/OnboardingUtils.js";
+import { default as PromiseSync } from "./async/PromiseSync.js";
 /*Classes públicas no pacote*/
-export { StringUtils, MaskFormatter, NumberUtils, FloatingManager, DateUtils, ArrayUtils, TimeFormatter, SkwHttpProvider, HttpProvider, RequestMetadata, AuthorizedServiceCaller, DataUnit, DataUnitStorage, DataType, UserInterface, DependencyType, DataUnitAction, Action, Change, ChangeOperation, ApplicationContext, ReadyUtil, ObjectUtils, WarningException, WaitingChangeException, ErrorException, ErrorTracking, SortMode, SelectionInfo, SelectionMode, ElementIDUtils, UserAgentUtils, JSUtils, VersionUtils, OnboardingUtils };
+export { StringUtils, MaskFormatter, NumberUtils, FloatingManager, DateUtils, ArrayUtils, TimeFormatter, SkwHttpProvider, HttpProvider, RequestMetadata, AuthorizedServiceCaller, DataUnit, DataUnitStorage, DataType, UserInterface, DependencyType, DataUnitAction, Action, Change, ChangeOperation, ApplicationContext, ReadyUtil, ObjectUtils, WarningException, WaitingChangeException, ErrorException, ErrorTracking, SortMode, SelectionInfo, SelectionMode, ElementIDUtils, UserAgentUtils, JSUtils, VersionUtils, OnboardingUtils, PromiseSync };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,eAAe,MAAM,yBAAyB,CAAC;AACtD,OAAO,SAAS,MAAM,sBAAsB,CAAC;AAC7C,OAAO,UAAU,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,uBAAuB,EAAE,MAAM,mCAAmC,CAAC;AAC5E,OAAO,QAAQ,EAAE,EAAsB,MAAM,EAAE,eAAe,EAAgE,aAAa,EAAE,aAAa,EAAC,MAAM,wBAAwB,CAAC;AAC1L,OAAO,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAC3D,OAAO,EAAiC,aAAa,EAAQ,QAAQ,EAA2B,cAAc,EAA8B,MAAM,qCAAqC,CAAC;AACxL,OAAO,EAAE,cAAc,EAAE,MAAM,EAAoB,MAAM,2CAA2C,CAAC;AACrG,OAAO,kBAAkB,MAAM,+BAA+B,CAAC;AAC/D,OAAO,SAAS,MAAM,sBAAsB,CAAC;AAC7C,OAAO,WAAW,MAAM,wBAAwB,CAAC;AACjD,OAAO,gBAAgB,MAAM,kCAAkC,CAAC;AAChE,OAAO,sBAAsB,MAAM,wCAAwC,CAAC;AAC5E,OAAO,cAAc,MAAM,gCAAgC,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAI1D,OAAO,EAAE,cAAc,EAAkB,MAAM,2BAA2B,CAAC;AAC3E,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACjE,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,YAAY,MAAM,yBAAyB,CAAA;AAClD,OAAO,EAAE,eAAe,EAAC,MAAM,4BAA4B,CAAC;AAE5D,8BAA8B;AAC9B,OAAO,EACH,WAAW,EACX,aAAa,EACb,WAAW,EACX,eAAe,EACf,SAAS,EACT,UAAU,EACV,aAAa,EACb,eAAe,EACf,YAAY,EACZ,eAAe,EACf,uBAAuB,EACvB,QAAQ,EACR,eAAe,EAGf,QAAQ,EAGR,aAAa,EACb,cAAc,EAGd,cAAc,EACd,MAAM,EACN,MAAM,EAGN,eAAe,EAEf,kBAAkB,EAIlB,SAAS,EACT,WAAW,EACX,gBAAgB,EAChB,sBAAsB,EACtB,cAAc,EACd,aAAa,EAIb,QAAQ,EAGR,aAAa,EACb,aAAa,EACb,cAAc,EAEd,cAAc,EACd,OAAO,EACP,YAAY,EACZ,eAAe,EAClB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,eAAe,MAAM,yBAAyB,CAAC;AACtD,OAAO,SAAS,MAAM,sBAAsB,CAAC;AAC7C,OAAO,UAAU,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,uBAAuB,EAAE,MAAM,mCAAmC,CAAC;AAC5E,OAAO,QAAQ,EAAE,EAAsB,MAAM,EAAE,eAAe,EAAgE,aAAa,EAAE,aAAa,EAAC,MAAM,wBAAwB,CAAC;AAC1L,OAAO,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAC3D,OAAO,EAAiC,aAAa,EAAQ,QAAQ,EAA2B,cAAc,EAA8B,MAAM,qCAAqC,CAAC;AACxL,OAAO,EAAE,cAAc,EAAE,MAAM,EAAoB,MAAM,2CAA2C,CAAC;AACrG,OAAO,kBAAkB,MAAM,+BAA+B,CAAC;AAC/D,OAAO,SAAS,MAAM,sBAAsB,CAAC;AAC7C,OAAO,WAAW,MAAM,wBAAwB,CAAC;AACjD,OAAO,gBAAgB,MAAM,kCAAkC,CAAC;AAChE,OAAO,sBAAsB,MAAM,wCAAwC,CAAC;AAC5E,OAAO,cAAc,MAAM,gCAAgC,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAI1D,OAAO,EAAE,cAAc,EAAkB,MAAM,2BAA2B,CAAC;AAC3E,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACjE,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,YAAY,MAAM,yBAAyB,CAAA;AAClD,OAAO,EAAE,eAAe,EAAC,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAC,OAAO,IAAI,WAAW,EAAsB,MAAM,wBAAwB,CAAC;AAEnF,8BAA8B;AAC9B,OAAO,EACH,WAAW,EACX,aAAa,EACb,WAAW,EACX,eAAe,EACf,SAAS,EACT,UAAU,EACV,aAAa,EACb,eAAe,EACf,YAAY,EACZ,eAAe,EACf,uBAAuB,EACvB,QAAQ,EACR,eAAe,EAGf,QAAQ,EAGR,aAAa,EACb,cAAc,EAGd,cAAc,EACd,MAAM,EACN,MAAM,EAGN,eAAe,EAEf,kBAAkB,EAIlB,SAAS,EACT,WAAW,EACX,gBAAgB,EAChB,sBAAsB,EACtB,cAAc,EACd,aAAa,EAIb,QAAQ,EAGR,aAAa,EACb,aAAa,EACb,cAAc,EAEd,cAAc,EACd,OAAO,EACP,YAAY,EACZ,eAAe,EACf,WAAW,EAEd,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sankhyalabs/core",
-  "version": "5.2.0",
+  "version": "5.3.0",
   "description": "Modulo core JavaScript da Sankhya.",
   "main": "dist/index.js",
   "module": "dist/index.js",

package/src/async/PromiseSync.ts

@@ -0,0 +1,49 @@
+/**
+ * O intuito desta classe é organizar a finalização de várias
+ * promessas executando determinada ação (callback) com o resultado.
+ */
+export default class PromiseSync<T>{
+
+    _promises: Array<Promise<T>>;
+    _callBack: PromiseSyncCallback<T>;
+
+    /**
+     * @param {PromiseSyncCallback<T>} callback - Será chamado sempre que todas as promises se resolverem.
+     */
+    constructor(callBack: PromiseSyncCallback<T>) {
+        this._promises = [];
+        this._callBack = callBack;
+    }
+
+    /**
+     * Adiciona na lista de promises pendentes. Isso faz com que criemos uma nova espera.
+     * 
+     * @param {Promise<T>} promise - Entrará na lista aguardada. 
+     */
+    public add(promise: Promise<T>): void {
+        this._promises.push(promise);
+        Promise.allSettled(this._promises)
+            .then(result => {
+                if (result.length === this._promises.length) {
+                    this._promises = [];
+
+                    if (this._callBack) {
+                        this._callBack.resolve(result);
+                    }
+                }
+            }
+        );
+    }
+}
+
+/**
+ * Representa o callback de um sincronizador `PromiseSync<T>`.
+ */
+export interface PromiseSyncCallback<T> {
+    /**
+     * Será chamado sempre que todas as promessas adicionadas finalizarem.
+     * 
+     * @param result - A lista com o resultado de todas as promises aguardadas.
+     */
+    resolve(result: PromiseSettledResult<Awaited<T>> []): void;
+}

package/src/index.ts

@@ -29,6 +29,7 @@ import { JSUtils } from "./utils/JSUtils.js";
 import { DataUnitStorage } from "./dataunit/DataUnitStorage.js";
 import VersionUtils from './utils/VersionUtils.js'
 import { OnboardingUtils} from "./utils/OnboardingUtils.js";
+import {default as PromiseSync, PromiseSyncCallback} from "./async/PromiseSync.js";
 
 /*Classes públicas no pacote*/
 export {
@@ -84,5 +85,7 @@ export {
     UserAgentUtils,
     JSUtils,
     VersionUtils,
-    OnboardingUtils
+    OnboardingUtils,
+    PromiseSync,
+    PromiseSyncCallback
 };