@sankhyalabs/core 3.1.2 → 4.0.0

package/.docs/interfaces/ChildLink.md

@@ -0,0 +1,30 @@
+[@sankhyalabs/core](../README.md) / [Exports](../modules.md) / ChildLink
+
+# Interface: ChildLink
+
+## Table of contents
+
+### Properties
+
+- [source](ChildLink.md#source)
+- [target](ChildLink.md#target)
+
+## Properties
+
+### source
+
+• **source**: `string`
+
+#### Defined in
+
+src/dataunit/metadata/UnitMetadata.ts:17
+
+___
+
+### target
+
+• **target**: `string`
+
+#### Defined in
+
+src/dataunit/metadata/UnitMetadata.ts:18

package/.docs/interfaces/DUActionInterceptor.md

@@ -26,4 +26,4 @@
 
 #### Defined in
 
-src/dataunit/DataUnit.ts:1194
+src/dataunit/DataUnit.ts:1408

package/.docs/interfaces/FieldDescriptor.md

@@ -26,7 +26,7 @@
 
 #### Defined in
 
-src/dataunit/metadata/UnitMetadata.ts:23
+src/dataunit/metadata/UnitMetadata.ts:24
 
 ___
 
@@ -36,7 +36,7 @@ ___
 
 #### Defined in
 
-src/dataunit/metadata/UnitMetadata.ts:25
+src/dataunit/metadata/UnitMetadata.ts:26
 
 ___
 
@@ -46,7 +46,7 @@ ___
 
 #### Defined in
 
-src/dataunit/metadata/UnitMetadata.ts:30
+src/dataunit/metadata/UnitMetadata.ts:31
 
 ___
 
@@ -56,7 +56,7 @@ ___
 
 #### Defined in
 
-src/dataunit/metadata/UnitMetadata.ts:31
+src/dataunit/metadata/UnitMetadata.ts:32
 
 ___
 
@@ -66,7 +66,7 @@ ___
 
 #### Defined in
 
-src/dataunit/metadata/UnitMetadata.ts:22
+src/dataunit/metadata/UnitMetadata.ts:23
 
 ___
 
@@ -76,7 +76,7 @@ ___
 
 #### Defined in
 
-src/dataunit/metadata/UnitMetadata.ts:21
+src/dataunit/metadata/UnitMetadata.ts:22
 
 ___
 
@@ -86,7 +86,7 @@ ___
 
 #### Defined in
 
-src/dataunit/metadata/UnitMetadata.ts:29
+src/dataunit/metadata/UnitMetadata.ts:30
 
 ___
 
@@ -96,7 +96,7 @@ ___
 
 #### Defined in
 
-src/dataunit/metadata/UnitMetadata.ts:27
+src/dataunit/metadata/UnitMetadata.ts:28
 
 ___
 
@@ -106,7 +106,7 @@ ___
 
 #### Defined in
 
-src/dataunit/metadata/UnitMetadata.ts:28
+src/dataunit/metadata/UnitMetadata.ts:29
 
 ___
 
@@ -116,7 +116,7 @@ ___
 
 #### Defined in
 
-src/dataunit/metadata/UnitMetadata.ts:24
+src/dataunit/metadata/UnitMetadata.ts:25
 
 ___
 
@@ -126,4 +126,4 @@ ___
 
 #### Defined in
 
-src/dataunit/metadata/UnitMetadata.ts:26
+src/dataunit/metadata/UnitMetadata.ts:27

package/.docs/interfaces/Filter.md

@@ -18,7 +18,7 @@
 
 #### Defined in
 
-src/dataunit/metadata/UnitMetadata.ts:42
+src/dataunit/metadata/UnitMetadata.ts:43
 
 ___
 
@@ -28,7 +28,7 @@ ___
 
 #### Defined in
 
-src/dataunit/metadata/UnitMetadata.ts:41
+src/dataunit/metadata/UnitMetadata.ts:42
 
 ___
 
@@ -38,4 +38,4 @@ ___
 
 #### Defined in
 
-src/dataunit/metadata/UnitMetadata.ts:43
+src/dataunit/metadata/UnitMetadata.ts:44

package/.docs/interfaces/PageRequest.md

@@ -18,7 +18,7 @@
 
 #### Defined in
 
-src/dataunit/DataUnit.ts:1298
+src/dataunit/DataUnit.ts:1514
 
 ___
 
@@ -28,7 +28,7 @@ ___
 
 #### Defined in
 
-src/dataunit/DataUnit.ts:1299
+src/dataunit/DataUnit.ts:1515
 
 ___
 
@@ -38,4 +38,4 @@ ___
 
 #### Defined in
 
-src/dataunit/DataUnit.ts:1300
+src/dataunit/DataUnit.ts:1516

package/.docs/interfaces/QuickFilter.md

@@ -17,7 +17,7 @@
 
 #### Defined in
 
-src/dataunit/DataUnit.ts:1305
+src/dataunit/DataUnit.ts:1521
 
 ___
 
@@ -27,4 +27,4 @@ ___
 
 #### Defined in
 
-src/dataunit/DataUnit.ts:1304
+src/dataunit/DataUnit.ts:1520

package/.docs/interfaces/Record.md

@@ -16,18 +16,30 @@
 
 ### Properties
 
+- [\_\_owner\_\_dataunit\_\_name\_\_](Record.md#__owner__dataunit__name__)
 - [\_\_parent\_\_record\_\_id\_\_](Record.md#__parent__record__id__)
 - [\_\_record\_\_id\_\_](Record.md#__record__id__)
+- [\_\_record\_\_label\_\_](Record.md#__record__label__)
 
 ## Properties
 
+### \_\_owner\_\_dataunit\_\_name\_\_
+
+• `Optional` **\_\_owner\_\_dataunit\_\_name\_\_**: `string`
+
+#### Defined in
+
+src/dataunit/DataUnit.ts:1415
+
+___
+
 ### \_\_parent\_\_record\_\_id\_\_
 
 • `Optional` **\_\_parent\_\_record\_\_id\_\_**: `string`
 
 #### Defined in
 
-src/dataunit/DataUnit.ts:1199
+src/dataunit/DataUnit.ts:1414
 
 ___
 
@@ -37,4 +49,14 @@ ___
 
 #### Defined in
 
-src/dataunit/DataUnit.ts:1198
+src/dataunit/DataUnit.ts:1412
+
+___
+
+### \_\_record\_\_label\_\_
+
+• `Optional` **\_\_record\_\_label\_\_**: `string`
+
+#### Defined in
+
+src/dataunit/DataUnit.ts:1413

package/.docs/interfaces/SavedRecord.md

@@ -13,8 +13,10 @@
 ### Properties
 
 - [\_\_old\_\_id\_\_](SavedRecord.md#__old__id__)
+- [\_\_owner\_\_dataunit\_\_name\_\_](SavedRecord.md#__owner__dataunit__name__)
 - [\_\_parent\_\_record\_\_id\_\_](SavedRecord.md#__parent__record__id__)
 - [\_\_record\_\_id\_\_](SavedRecord.md#__record__id__)
+- [\_\_record\_\_label\_\_](SavedRecord.md#__record__label__)
 
 ## Properties
 
@@ -24,7 +26,21 @@
 
 #### Defined in
 
-src/dataunit/DataUnit.ts:1204
+src/dataunit/DataUnit.ts:1420
+
+___
+
+### \_\_owner\_\_dataunit\_\_name\_\_
+
+• `Optional` **\_\_owner\_\_dataunit\_\_name\_\_**: `string`
+
+#### Inherited from
+
+[Record](Record.md).[__owner__dataunit__name__](Record.md#__owner__dataunit__name__)
+
+#### Defined in
+
+src/dataunit/DataUnit.ts:1415
 
 ___
 
@@ -38,7 +54,7 @@ ___
 
 #### Defined in
 
-src/dataunit/DataUnit.ts:1199
+src/dataunit/DataUnit.ts:1414
 
 ___
 
@@ -52,4 +68,18 @@ ___
 
 #### Defined in
 
-src/dataunit/DataUnit.ts:1198
+src/dataunit/DataUnit.ts:1412
+
+___
+
+### \_\_record\_\_label\_\_
+
+• `Optional` **\_\_record\_\_label\_\_**: `string`
+
+#### Inherited from
+
+[Record](Record.md).[__record__label__](Record.md#__record__label__)
+
+#### Defined in
+
+src/dataunit/DataUnit.ts:1413

package/.docs/interfaces/Sort.md

@@ -18,7 +18,7 @@
 
 #### Defined in
 
-src/dataunit/metadata/UnitMetadata.ts:55
+src/dataunit/metadata/UnitMetadata.ts:56
 
 ___
 
@@ -28,7 +28,7 @@ ___
 
 #### Defined in
 
-src/dataunit/metadata/UnitMetadata.ts:53
+src/dataunit/metadata/UnitMetadata.ts:54
 
 ___
 
@@ -38,4 +38,4 @@ ___
 
 #### Defined in
 
-src/dataunit/metadata/UnitMetadata.ts:54
+src/dataunit/metadata/UnitMetadata.ts:55

package/.docs/interfaces/SortingProvider.md

@@ -26,4 +26,4 @@
 
 #### Defined in
 
-src/dataunit/metadata/UnitMetadata.ts:64
+src/dataunit/metadata/UnitMetadata.ts:65

package/.docs/interfaces/UnitMetadata.md

@@ -15,7 +15,7 @@
 
 ### children
 
-• `Optional` **children**: `ChildDescriptor`[]
+• `Optional` **children**: [`ChildDescriptor`](ChildDescriptor.md)[]
 
 #### Defined in
 

package/.docs/interfaces/WaitingChange.md

@@ -18,7 +18,7 @@
 
 #### Defined in
 
-src/dataunit/DataUnit.ts:1293
+src/dataunit/DataUnit.ts:1509
 
 ___
 
@@ -28,7 +28,7 @@ ___
 
 #### Defined in
 
-src/dataunit/DataUnit.ts:1294
+src/dataunit/DataUnit.ts:1510
 
 ___
 
@@ -38,4 +38,4 @@ ___
 
 #### Defined in
 
-src/dataunit/DataUnit.ts:1292
+src/dataunit/DataUnit.ts:1508

package/.docs/modules/MaskFormatter.md

@@ -20,9 +20,9 @@
 
 #### Defined in
 
-src/utils/MaskFormatter.ts:158
+src/utils/MaskFormatter.ts:166
 
-src/utils/MaskFormatter.ts:398
+src/utils/MaskFormatter.ts:406
 
 ## Variables
 
@@ -32,6 +32,6 @@ src/utils/MaskFormatter.ts:398
 
 #### Defined in
 
-src/utils/MaskFormatter.ts:158
+src/utils/MaskFormatter.ts:166
 
-src/utils/MaskFormatter.ts:398
+src/utils/MaskFormatter.ts:406

package/.docs/modules.md

@@ -25,6 +25,7 @@
 - [Change](classes/Change.md)
 - [DataUnit](classes/DataUnit.md)
 - [DataUnitAction](classes/DataUnitAction.md)
+- [DataUnitStorage](classes/DataUnitStorage.md)
 - [DateUtils](classes/DateUtils.md)
 - [ElementIDUtils](classes/ElementIDUtils.md)
 - [ErrorException](classes/ErrorException.md)
@@ -46,6 +47,8 @@
 
 ### Interfaces
 
+- [ChildDescriptor](interfaces/ChildDescriptor.md)
+- [ChildLink](interfaces/ChildLink.md)
 - [DUActionInterceptor](interfaces/DUActionInterceptor.md)
 - [ExecutionContext](interfaces/ExecutionContext.md)
 - [FieldDescriptor](interfaces/FieldDescriptor.md)

package/dist/dataunit/DataUnit.d.ts

@@ -7,6 +7,7 @@ import { PaginationInfo } from "./loading/PaginationInfo.js";
  * `DataUnit`: Atua como uma camada de abstração entre o back-end e a interface do usuário.
  */
 export default class DataUnit {
+    private _uuid;
     private _name;
     private _observers;
     private _sortingProvider?;
@@ -16,13 +17,17 @@ export default class DataUnit {
     private _pageSize;
     private _childByName;
     private _parentDataUnit;
-    private _parentSelectedRecordID;
     metadataLoader?: (dataUnit: DataUnit) => Promise<UnitMetadata>;
     dataLoader?: (dataUnit: DataUnit, request: LoadDataRequest) => Promise<LoadDataResponse>;
     saveLoader?: (dataUnit: DataUnit, changes: Array<Change>) => Promise<Array<SavedRecord>>;
     removeLoader?: (dataUnit: DataUnit, recordIds: Array<string>) => Promise<Array<string>>;
     recordLoader?: (dataUnit: DataUnit, recordIds: Array<string>) => Promise<Array<Record>>;
-    constructor(name: string, parentDataUnit?: DataUnit);
+    constructor(name?: string, parentDataUnit?: DataUnit);
+    /**
+     * Desfaz vinculos do DataUnit. Chamado quando o DU não é mais necessário.
+     */
+    release(): void;
+    get dataUnitId(): string;
     /**
      *
      * Obtém o nome de identificação do DataUnit (geralmente em formato de URI - Uniform Resource Identifier).
@@ -65,11 +70,13 @@ export default class DataUnit {
      *
      * @param request - Dados da requisição para carregamento dos registros.
      * @param executionCtx - Contexto de execução do carregamento dos registros do DataUnit.
+     * @param checkLastFilter - Habilita a verificação da última requisição, evitando carga desnecessária.
      *
      * @returns - Registros do DataUnit.
      *
     */
     private executeLoadData;
+    private isSameRequest;
     /**
      *
      * Carrega os metadados do DataUnit.
@@ -86,11 +93,12 @@ export default class DataUnit {
      *
      * @param quickFilter - Filtros a serem aplicados.
      * @param executionCtx - Contexto de execução do carregamento dos registros.
+     * @param checkLastFilter - Habilita a verificação da última requisição, evitando carga desnecessária.
      *
      * @returns - Registros requisitados.
      *
     */
-    loadData(quickFilter?: QuickFilter, executionCtx?: ExecutionContext): Promise<LoadDataResponse>;
+    loadData(quickFilter?: QuickFilter, executionCtx?: ExecutionContext, checkLastFilter?: boolean): Promise<LoadDataResponse>;
     /**
      *
      * Alterna entre os registros por número de página.
@@ -122,6 +130,7 @@ export default class DataUnit {
      *
     */
     previousPage(executionCtx?: ExecutionContext): Promise<LoadDataResponse | void>;
+    private notifySavingData;
     /**
      *
      * Salva o estado do registro do DataUnit.
@@ -132,6 +141,27 @@ export default class DataUnit {
      *
     */
     saveData(executionCtx?: ExecutionContext): Promise<void>;
+    /**
+     *
+     * Retorna as alterações a serem salvas no DataUnit atual.
+     *
+     *
+     *
+     * @returns - Mudanças realizadas no DataUnit atual
+     *
+    */
+    buildChangesToSave(): Array<Change>;
+    buildChangesToSaveFromChild(allChanges: Array<Change>, dataUnit: DataUnit): void;
+    /**
+     *
+     * Retorna todas as alterações do DataUnit a serem salvas, incluindo no nível Master e Detail.
+     *
+     *
+     *
+     * @returns - Todas as mudanças realizadas no DataUnit, tanto Master quanto Detail;
+     *
+    */
+    getAllChangesToSave(): Array<Change>;
     /**
      *
      * Remove o registro selecionado.
@@ -177,6 +207,19 @@ export default class DataUnit {
      *
     */
     valueToString(fieldName: string, value: any): string;
+    /**
+     *
+     * Formata o valor do campo considerando as informações do descriptor.
+     * Diferente do método "valueToString" que retorna o dado em valor textual,
+     * getFormattedValue retorna uma informação amigável ao usuário, geralmente
+     * usada na interface.
+     *
+     * @param fieldName - Nome do campo utilizado do qual se quer obter valor.
+     *
+     * @returns - Valor formatado.
+     *
+    */
+    getFormattedValue(fieldName: string): string;
     /**
      *
      * Adiciona um interceptor correspondente a uma ação do DataUnit para fazer um processamento customizado.
@@ -301,6 +344,8 @@ export default class DataUnit {
      *
     */
     copySelected(executionCtx?: ExecutionContext): void;
+    private getRecordsByDataUnit;
+    private getParentRecordId;
     /**
      *
      * Retorna se a alteração no campo já foi concluída ou se ainda está incompleta.
@@ -438,7 +483,7 @@ export default class DataUnit {
      * @param executionCtx - Contexto de execução do cancelamento da seleção dos registros.
      *
     */
-    cancelEdition(executionCtx?: ExecutionContext): void;
+    cancelEdition(executionCtx?: ExecutionContext, fromParent?: boolean): Promise<void>;
     /**
      *
      * Retorna se existe algum tipo de alteração pendente.
@@ -447,6 +492,14 @@ export default class DataUnit {
      *
     */
     isDirty(): boolean;
+    /**
+     *
+     * Retorna se existe algum DataUnit detail com alterações pendentes.
+     *
+     * @returns Verdadeiro se existir alterações pendentes em algum DataUnit detail.
+     *
+    */
+    private childrenIsDirty;
     /**
      *
      * Retorna se existe algum registro em modo de edição.
@@ -480,6 +533,22 @@ export default class DataUnit {
      *
     */
     isNewRecord(recordId: string): boolean;
+    /**
+     *
+     * Retorna se existe pelo menos um registro novo.
+     *
+     * @returns Verdadeiro se algum registro foi adicionado.
+     *
+    */
+    hasNewRecord(): boolean;
+    /**
+     *
+     * Retorna se existe pelo menos um registro novo.
+     *
+     * @returns Verdadeiro se algum registro foi adicionado.
+     *
+    */
+    hasCopiedRecord(): boolean;
     /**
      *
      * Retorna se a informação do estado anterior está salva, permitindo desfazer a ação.
@@ -560,6 +629,14 @@ export default class DataUnit {
      *
     */
     getChildDataunit(name: string): DataUnit;
+    /**
+     *
+     * Remove um dataunit filho.
+     *
+     * @param name - Nome do dataunit filho.
+     *
+    */
+    removeChildDataunit(name: string): void;
     /**
      *
      * Adiciona um novo observer no DataUnit.
@@ -635,7 +712,9 @@ export interface DUActionInterceptor {
 }
 export interface Record {
     __record__id__: string;
+    __record__label__?: string;
     __parent__record__id__?: string;
+    __owner__dataunit__name__?: string;
     [key: string]: any;
 }
 export interface SavedRecord extends Record {