@sankhyalabs/core-docs 0.0.0-feat-dev-41261.6 → 0.0.0-feat-dev-KB-75149.2

package/classes/LockManager.md

@@ -0,0 +1,191 @@
+[**@sankhyalabs/core**](../README.md) • **Docs**
+
+***
+
+[@sankhyalabs/core](../globals.md) / LockManager
+
+# Class: LockManager
+
+## Constructors
+
+### new LockManager()
+
+> **new LockManager**(): [`LockManager`](LockManager.md)
+
+#### Returns
+
+[`LockManager`](LockManager.md)
+
+## Properties
+
+### ATTRIBUTE\_NAME
+
+> `static` **ATTRIBUTE\_NAME**: `string` = `"data-locker-manger-context-id"`
+
+Nome do atributo que será utilizado para controlar contexto de locks nos elementos da DOM.
+
+#### Source
+
+src/utils/LockManager.ts:24
+
+***
+
+### \_locks
+
+> `static` `private` **\_locks**: `Map`\<`string`, `Lock`[]\>
+
+#### Source
+
+src/utils/LockManager.ts:19
+
+## Methods
+
+### addLockManagerCtxId()
+
+> `static` **addLockManagerCtxId**(`startElement`): `string`
+
+Cria um contexto de locker, caso nao exista, para todos elementos pais iniciados com ez- ou snk-.
+
+#### Parameters
+
+• **startElement**: `HTMLElement`
+
+Elemento de de onde o lock deve começar.
+
+#### Returns
+
+`string`
+
+- O id do locker, que pode ser usado para iniciar ou aguardar um lock do contexto.
+
+#### Source
+
+src/utils/LockManager.ts:83
+
+***
+
+### buildContextID()
+
+> `static` `private` **buildContextID**(): `string`
+
+#### Returns
+
+`string`
+
+#### Source
+
+src/utils/LockManager.ts:26
+
+***
+
+### buildLockerID()
+
+> `static` `private` **buildLockerID**(`ctxId`, `operation`): `undefined` \| `string`
+
+#### Parameters
+
+• **ctxId**: `string` \| `HTMLElement`
+
+• **operation**: [`TASKBAR_CLICK`](../enumerations/LockManagerOperation.md#taskbar_click)
+
+#### Returns
+
+`undefined` \| `string`
+
+#### Source
+
+src/utils/LockManager.ts:30
+
+***
+
+### findExistingCtxId()
+
+> `static` `private` **findExistingCtxId**(`element`): `null` \| `string`
+
+#### Parameters
+
+• **element**: `HTMLElement`
+
+#### Returns
+
+`null` \| `string`
+
+#### Source
+
+src/utils/LockManager.ts:43
+
+***
+
+### lock()
+
+> `static` **lock**(`id`, `operation`): `any`
+
+Inicia um locker baseado em um contexto e uma operação.
+
+#### Parameters
+
+• **id**: `string` \| `HTMLElement`
+
+Pode ser um ID do contexto de locker, ou, o elemento contendo um contexto de locker.
+
+• **operation**: [`TASKBAR_CLICK`](../enumerations/LockManagerOperation.md#taskbar_click)
+
+Operação do contexto que o lock deve ser feito.
+
+#### Returns
+
+`any`
+
+- Uma função que fara a liberação do lock.
+
+#### Source
+
+src/utils/LockManager.ts:114
+
+***
+
+### traverseAndAddAttr()
+
+> `static` `private` **traverseAndAddAttr**(`element`, `ctxId`): `void`
+
+#### Parameters
+
+• **element**: `HTMLElement`
+
+• **ctxId**: `string`
+
+#### Returns
+
+`void`
+
+#### Source
+
+src/utils/LockManager.ts:65
+
+***
+
+### whenResolve()
+
+> `static` **whenResolve**(`id`, `operation`): `Promise`\<`void`\>
+
+Aguarda todos os lockers de um contexto e operação serem resolvidos.
+
+#### Parameters
+
+• **id**: `string` \| `HTMLElement`
+
+Pode ser um ID do contexto de locker, ou, o elemento contendo um contexto de locker.
+
+• **operation**: [`TASKBAR_CLICK`](../enumerations/LockManagerOperation.md#taskbar_click)
+
+Operação do contexto que devera aguardar.
+
+#### Returns
+
+`Promise`\<`void`\>
+
+- Promise que será resolvida quando todos lockers forem finalizados.
+
+#### Source
+
+src/utils/LockManager.ts:142

package/classes/MaskFormatter.md

@@ -66,7 +66,7 @@ resultaria na string '123-____'.
 
 #### Source
 
-src/utils/MaskFormatter.ts:92
+src/utils/MaskFormatter.ts:91
 
 ## Properties
 
@@ -76,7 +76,7 @@ src/utils/MaskFormatter.ts:92
 
 #### Source
 
-src/utils/MaskFormatter.ts:66
+src/utils/MaskFormatter.ts:65
 
 ***
 
@@ -86,7 +86,7 @@ src/utils/MaskFormatter.ts:66
 
 #### Source
 
-src/utils/MaskFormatter.ts:67
+src/utils/MaskFormatter.ts:66
 
 ***
 
@@ -99,7 +99,7 @@ ou seja, aqueles que o usuário ainda não informou. Por padrão usamos um espa
 
 #### Source
 
-src/utils/MaskFormatter.ts:73
+src/utils/MaskFormatter.ts:72
 
 ***
 
@@ -129,7 +129,7 @@ src/utils/MaskFormatter.ts:55
 
 #### Source
 
-src/utils/MaskFormatter.ts:466
+src/utils/MaskFormatter.ts:379
 
 ***
 
@@ -149,7 +149,7 @@ src/utils/MaskFormatter.ts:54
 
 #### Source
 
-src/utils/MaskFormatter.ts:480
+src/utils/MaskFormatter.ts:393
 
 ***
 
@@ -179,7 +179,7 @@ src/utils/MaskFormatter.ts:49
 
 #### Source
 
-src/utils/MaskFormatter.ts:391
+src/utils/MaskFormatter.ts:304
 
 ***
 
@@ -209,7 +209,7 @@ src/utils/MaskFormatter.ts:52
 
 #### Source
 
-src/utils/MaskFormatter.ts:372
+src/utils/MaskFormatter.ts:285
 
 ***
 
@@ -219,7 +219,7 @@ src/utils/MaskFormatter.ts:372
 
 #### Source
 
-src/utils/MaskFormatter.ts:443
+src/utils/MaskFormatter.ts:356
 
 ***
 
@@ -239,7 +239,7 @@ src/utils/MaskFormatter.ts:51
 
 #### Source
 
-src/utils/MaskFormatter.ts:420
+src/utils/MaskFormatter.ts:333
 
 ## Accessors
 
@@ -265,34 +265,10 @@ A última máscara informada.
 
 #### Source
 
-src/utils/MaskFormatter.ts:88
+src/utils/MaskFormatter.ts:87
 
 ## Methods
 
-### applyMask()
-
-> **applyMask**(`value`): `string`
-
-Aplica a máscara quando o input é alterado
-
-#### Parameters
-
-• **value**: `string`
-
-Valor a ser aplicado com a máscara.
-
-#### Returns
-
-`string`
-
-O valor processado de acordo com o padrão.
-
-#### Source
-
-src/utils/MaskFormatter.ts:103
-
-***
-
 ### format()
 
 > **format**(`value`, `trimBefore`): `string`
@@ -317,31 +293,7 @@ O valor processado de acordo com o padrão.
 
 #### Source
 
-src/utils/MaskFormatter.ts:189
-
-***
-
-### removeMask()
-
-> **removeMask**(`value`): `string`
-
-Remove a máscara formatando a string retornando sem máscara
-
-#### Parameters
-
-• **value**: `string`
-
-Valor a ser formatado com máscara.
-
-#### Returns
-
-`string`
-
-O valor processado de acordo com o padrão.
-
-#### Source
-
-src/utils/MaskFormatter.ts:169
+src/utils/MaskFormatter.ts:102
 
 ***
 
@@ -357,4 +309,4 @@ Prepara a formatação internamente de acordo com o padrão.
 
 #### Source
 
-src/utils/MaskFormatter.ts:209
+src/utils/MaskFormatter.ts:122

package/classes/SelectionInfo.md

@@ -30,7 +30,7 @@
 
 #### Source
 
-src/dataunit/DataUnit.ts:2015
+src/dataunit/DataUnit.ts:2030
 
 ## Properties
 
@@ -40,7 +40,7 @@ src/dataunit/DataUnit.ts:2015
 
 #### Source
 
-src/dataunit/DataUnit.ts:2012
+src/dataunit/DataUnit.ts:2027
 
 ***
 
@@ -50,7 +50,7 @@ src/dataunit/DataUnit.ts:2012
 
 #### Source
 
-src/dataunit/DataUnit.ts:2013
+src/dataunit/DataUnit.ts:2028
 
 ***
 
@@ -60,7 +60,7 @@ src/dataunit/DataUnit.ts:2013
 
 #### Source
 
-src/dataunit/DataUnit.ts:2009
+src/dataunit/DataUnit.ts:2024
 
 ***
 
@@ -74,7 +74,7 @@ src/dataunit/DataUnit.ts:2009
 
 #### Source
 
-src/dataunit/DataUnit.ts:2011
+src/dataunit/DataUnit.ts:2026
 
 ***
 
@@ -84,7 +84,7 @@ src/dataunit/DataUnit.ts:2011
 
 #### Source
 
-src/dataunit/DataUnit.ts:2008
+src/dataunit/DataUnit.ts:2023
 
 ***
 
@@ -94,7 +94,7 @@ src/dataunit/DataUnit.ts:2008
 
 #### Source
 
-src/dataunit/DataUnit.ts:2010
+src/dataunit/DataUnit.ts:2025
 
 ## Accessors
 
@@ -108,7 +108,7 @@ src/dataunit/DataUnit.ts:2010
 
 #### Source
 
-src/dataunit/DataUnit.ts:2043
+src/dataunit/DataUnit.ts:2058
 
 ***
 
@@ -122,7 +122,7 @@ src/dataunit/DataUnit.ts:2043
 
 #### Source
 
-src/dataunit/DataUnit.ts:2033
+src/dataunit/DataUnit.ts:2048
 
 ***
 
@@ -136,7 +136,7 @@ src/dataunit/DataUnit.ts:2033
 
 #### Source
 
-src/dataunit/DataUnit.ts:2023
+src/dataunit/DataUnit.ts:2038
 
 ## Methods
 
@@ -150,7 +150,7 @@ src/dataunit/DataUnit.ts:2023
 
 #### Source
 
-src/dataunit/DataUnit.ts:2050
+src/dataunit/DataUnit.ts:2065
 
 ***
 
@@ -164,4 +164,4 @@ src/dataunit/DataUnit.ts:2050
 
 #### Source
 
-src/dataunit/DataUnit.ts:2054
+src/dataunit/DataUnit.ts:2069

package/classes/ServiceUtils.md

@@ -0,0 +1,67 @@
+[**@sankhyalabs/core**](../README.md) • **Docs**
+
+***
+
+[@sankhyalabs/core](../globals.md) / ServiceUtils
+
+# Class: ServiceUtils
+
+## Constructors
+
+### new ServiceUtils()
+
+> **new ServiceUtils**(): [`ServiceUtils`](ServiceUtils.md)
+
+#### Returns
+
+[`ServiceUtils`](ServiceUtils.md)
+
+## Methods
+
+### useCacheWithService()
+
+> `static` **useCacheWithService**\<`T`\>(`identifier`, `fetchFunction`, `storageType`): `Promise`\<`T`\>
+
+Auxilia no uso do CacheManager, gerando automaticamente uma chave de cache com base no identificador.
+
+#### Type parameters
+
+• **T**
+
+Tipo do dado a ser retornado.
+
+#### Parameters
+
+• **identifier**: `string`
+
+Identificadores únicos usados para compor a chave de cache.
+
+• **fetchFunction**
+
+Função que retorna uma `Promise` com o valor a ser armazenado no cache caso ele não exista ou tenha expirado.
+
+• **storageType**: [`StorageType`](../enumerations/StorageType.md)= `StorageType.IN_MEMORY_CACHE`
+
+Tipo de armazenamento: `'sessionStorage'` ou `'localStorage'`. O padrão é `'sessionStorage'`.
+
+#### Returns
+
+`Promise`\<`T`\>
+
+Uma `Promise` com o valor armazenado ou obtido via `fetchFunction`.
+
+#### Example
+
+```typescript
+const actions = await useCacheWithService(
+ `${this.entityName} - ${this.resourceID}`,
+  async () => {
+    return await fetchActionsFromAPI();
+  }
+);
+console.log(actions);
+```
+
+#### Source
+
+src/utils/ServiceUtils.ts:28

package/classes/SilentException.md

@@ -0,0 +1,193 @@
+[**@sankhyalabs/core**](../README.md) • **Docs**
+
+***
+
+[@sankhyalabs/core](../globals.md) / SilentException
+
+# Class: SilentException
+
+`SilentException`: Exceção lançada quando uma exception silenciosa é.
+
+## Extends
+
+- `Error`
+
+## Constructors
+
+### new SilentException()
+
+> **new SilentException**(`title`, `message`, `errorCode`): [`SilentException`](SilentException.md)
+
+#### Parameters
+
+• **title**: `string`= `""`
+
+• **message**: `string`= `""`
+
+• **errorCode**: `string`= `""`
+
+#### Returns
+
+[`SilentException`](SilentException.md)
+
+#### Overrides
+
+`Error.constructor`
+
+#### Source
+
+src/exceptions/SilentException.ts:18
+
+## Properties
+
+### cause?
+
+> `optional` **cause**: `unknown`
+
+#### Inherited from
+
+`Error.cause`
+
+#### Source
+
+node\_modules/typescript/lib/lib.es2022.error.d.ts:26
+
+***
+
+### errorCode
+
+> **errorCode**: `string`
+
+Código do erro, indica o erro disparado pelo backend.
+
+#### Source
+
+src/exceptions/SilentException.ts:16
+
+***
+
+### message
+
+> **message**: `string`
+
+Descrição do erro.
+
+#### Overrides
+
+`Error.message`
+
+#### Source
+
+src/exceptions/SilentException.ts:13
+
+***
+
+### name
+
+> **name**: `string`
+
+Nome da exceção.
+
+#### Overrides
+
+`Error.name`
+
+#### Source
+
+src/exceptions/SilentException.ts:7
+
+***
+
+### stack?
+
+> `optional` **stack**: `string`
+
+#### Inherited from
+
+`Error.stack`
+
+#### Source
+
+node\_modules/typescript/lib/lib.es5.d.ts:1055
+
+***
+
+### title
+
+> **title**: `string`
+
+Titulo do erro.
+
+#### Source
+
+src/exceptions/SilentException.ts:10
+
+***
+
+### prepareStackTrace()?
+
+> `static` `optional` **prepareStackTrace**: (`err`, `stackTraces`) => `any`
+
+Optional override for formatting stack traces
+
+#### See
+
+https://v8.dev/docs/stack-trace-api#customizing-stack-traces
+
+#### Parameters
+
+• **err**: `Error`
+
+• **stackTraces**: `CallSite`[]
+
+#### Returns
+
+`any`
+
+#### Inherited from
+
+`Error.prepareStackTrace`
+
+#### Source
+
+node\_modules/@types/node/globals.d.ts:27
+
+***
+
+### stackTraceLimit
+
+> `static` **stackTraceLimit**: `number`
+
+#### Inherited from
+
+`Error.stackTraceLimit`
+
+#### Source
+
+node\_modules/@types/node/globals.d.ts:29
+
+## Methods
+
+### captureStackTrace()
+
+> `static` **captureStackTrace**(`targetObject`, `constructorOpt`?): `void`
+
+Create .stack property on a target object
+
+#### Parameters
+
+• **targetObject**: `object`
+
+• **constructorOpt?**: `Function`
+
+#### Returns
+
+`void`
+
+#### Inherited from
+
+`Error.captureStackTrace`
+
+#### Source
+
+node\_modules/@types/node/globals.d.ts:20