@cargolift-cdi/lib-payload 0.1.58 → 0.1.60

package/README.md

@@ -1,148 +1,326 @@
-# @cargolift-cdi/lib-payload · PayloadValidation
+# lib-payload
 
-Biblioteca utilizada pelos serviços do middleware para validar payloads antes de publicá-los ou processá-los. O `PayloadValidation` aplica regras declarativas, suporta objetos ou strings JSON e retorna um relatório padronizado com todos os erros encontrados.
+![Build Status](https://img.shields.io/badge/build-local-blue)
+![Versão](https://img.shields.io/badge/version-0.1.59-green)
+![Licença](https://img.shields.io/badge/license-MIT-lightgrey)
+![Cobertura de Testes](https://img.shields.io/badge/coverage-vitest-yellowgreen)
 
-## Instalação
+Biblioteca TypeScript para tratamento, validação, transformação, comparação e interpretação de payloads JSON no ecossistema Middleware Cargolift.
 
-```bash
-npm install @cargolift-cdi/lib-payload
-```
+---
+
+## 📌 Objetivo
+
+Este repositório centraliza utilitários e componentes reutilizáveis para lidar com payloads de integração, reduzindo duplicação de lógica entre serviços e padronizando comportamentos críticos de validação e auditoria.
+
+No contexto do Middleware, a lib apoia fluxos de integração com foco em **resiliência**, **rastreabilidade**, **consistência de dados** e **facilidade de manutenção**.
+
+Público-alvo:
+Desenvolvedores de bibliotecas e serviços do monorepo middleware.
+
+---
+
+## ✨ Funcionalidades
 
-## Uso rápido
+- **PayloadValidation:** valida payloads por schema declarativo (tipos, obrigatoriedade, ranges, padrões e listas permitidas).
+- **PayloadTransformation:** transforma estruturas JSON usando expressões JSONata.
+- **PayloadDiff:** compara entidade x payload e retorna apenas mudanças efetivas, com changelog para auditoria.
+- **PayloadCondition:** avalia árvores de condições lógicas (`all`/`any`) com suporte a variáveis dinâmicas.
+- **PayloadResponseInterpreter:** interpreta respostas de APIs externas para padronizar sucesso/erro e mensagens.
+- **Utilitários de payload:** navegação por path, comparação, JSON pointer, resolução de variáveis e hash.
+
+Diferenciais técnicos:
+- API agnóstica de framework.
+- Cobertura por testes com Vitest.
+- Foco em uso em pipelines de integração e processamento de mensagens.
+
+---
+
+## 🔍 Detalhamento
+
+### Validação de Payload
+
+`PayloadValidation` executa validação declarativa e retorna relatório estruturado sem interromper o fluxo por exceções de negócio.
+
+#### Exemplo de uso
 
 ```ts
-import { PayloadValidation, Schema } from "@cargolift-cdi/lib-payload";
-
-const schema: Schema = {
-  validations: [
-    { field: "order/id", required: true, type: "string", length: { min: 3, max: 36 } },
-    { field: "items", type: "array", minItems: 1 },
-    { field: "items/qty", type: "number", range: { min: 1 }, message: "Quantidade mínima por item é 1" },
-  ],
-};
+import { PayloadValidation } from "@cargolift-cdi/lib-payload";
 
 const validator = new PayloadValidation();
-const result = await validator.run(payloadOuJson, schema);
+
+const schema = {
+  "order/id": { required: true, type: "string" },
+  "items": { type: "array", minItems: 1 },
+  "items/qty": { type: "number", range: { min: 1 } },
+};
+
+const result = await validator.validate(
+  { order: { id: "ORD-1" }, items: [{ qty: 2 }] },
+  schema,
+);
 
 if (!result.success) {
   console.error(result.errorsList);
 }
 ```
 
-## Campos disponíveis no schema
+Parâmetros:
+- `rawPayload`: objeto ou string JSON.
+- `schema`: mapa de regras por caminho de campo.
+
+Retorno:
+- `SchemaValidationResult` com `success`, `errors` e `errorsList`.
 
-| Propriedade | Uso |
-| --- | --- |
-| `field` | Caminho do campo. Use `/` para navegar entre níveis (ex.: `address/city`). Arrays são percorridos automaticamente: `items/qty` valida cada `qty` dentro de `items`. |
-| `required` | Garante presença do campo. |
-| `allowNull` | Quando `false`, recusa valores `null` mesmo que o campo exista. |
-| `type` | Valida o tipo do conteúdo. Tipos suportados: `string`, `number`, `boolean`, `date`, `dateISO`, `object`, `array`, `email`. |
-| `length` | Restrições para strings (`min`, `max`). |
-| `range` | Faixas para números (`min`, `max`). |
-| `minItems` / `maxItems` | Controle de tamanho de arrays. |
-| `allowedValues` | Lista de valores aceitos. Combina com `ignoreCase` para strings. |
-| `ignoreCase` | Quando `true`, compara `allowedValues` sem diferenciar maiúsculas/minúsculas. |
-| `pattern` | Expressão regular aplicada ao valor (somente strings). |
-| `message` | Mensagem personalizada exibida quando a regra falhar. |
+### Transformação de Payload
 
-## Como os caminhos são avaliados
+`PayloadTransformation` utiliza JSONata para projeções e enriquecimentos de payload.
 
-- `customer/name` acessa propriedades aninhadas.
-- `contacts/type` aplica a regra a cada item da coleção `contacts`.
-- Valores inexistentes retornam `undefined`, permitindo diferenciar campos ausentes de campos nulos (`allowNull`).
+#### Exemplo de uso
 
-## Tipos especiais
+```ts
+import { PayloadTransformation } from "@cargolift-cdi/lib-payload";
+
+const expression = `{
+  "orderId": order.id,
+  "total": $sum(items.(qty * price))
+}`;
 
-- `date`: aceita objetos `Date` ou strings `DD/MM/YYYY`, `DD-MM-YYYY` e formatos reconhecidos por `Date.parse`.
-- `dateISO`: exige ISO 8601 (`2025-11-05T14:48:00.000Z`).
-- `email`: aplica regex simples `user@domain`.
+const result = await PayloadTransformation.transform(expression, {
+  order: { id: "ORD-10" },
+  items: [{ qty: 2, price: 10 }, { qty: 1, price: 5 }],
+});
+
+console.log(result.result);
+```
 
-## Exemplos práticos
+Parâmetros:
+- `expression`: expressão JSONata.
+- `payload`: entrada a ser transformada.
 
-### 1. Validando um payload bruto (string JSON)
+Retorno:
+- `PayloadTransformationResult` com `success`, `result` e `error?`.
+
+### Diff para Auditoria
+
+`PayloadDiff` compara entidade existente com payload recebido e retorna `sanitizedPayload` contendo somente alterações relevantes.
+
+#### Exemplo de uso
 
 ```ts
-const rawPayload = '{"order":{"id":"ORD-9","value":0},"items":[]}';
-
-const schema: Schema = {
-  validations: [
-    { field: "order/id", required: true, type: "string" },
-    { field: "order/value", type: "number", range: { min: 1 }, message: "Valor mínimo do pedido é 1" },
-    { field: "items", type: "array", minItems: 1 },
-  ],
-};
+import { PayloadDiff } from "@cargolift-cdi/lib-payload";
 
-const validation = new PayloadValidation();
-const result = await validation.run(rawPayload, schema);
+const entity = { name: "Cliente A", status: "active" };
+const payload = { name: "Cliente A", status: "inactive" };
 
-/* result.errors => [
-  { field: 'order/value', value: 0, error: 'Valor mínimo do pedido é 1' },
-  { field: 'items', value: [], error: "Campo 'items' deve conter ao menos 1 itens" }
-] */
+const diff = PayloadDiff.diff(entity, payload);
+
+if (diff.hasChanges) {
+  console.log(diff.sanitizedPayload); // { status: "inactive" }
+  console.log(diff.changes);
+}
 ```
 
-### 2. AllowedValues com ignoreCase e campos opcionais
+Parâmetros:
+- `entity`: estado atual persistido.
+- `payload`: estado recebido para atualização.
+- `options?`: campos ignorados e separador de path.
+
+Retorno:
+- `ResultPayloadDiff<T>` com `hasChanges`, `changes` e `sanitizedPayload`.
+
+---
+
+## 🛠 Tecnologias e Dependências
+
+<table>
+  <thead>
+    <tr>
+      <th>Tecnologia</th>
+      <th>Versão</th>
+      <th>Finalidade</th>
+    </tr>
+  </thead>
+  <tbody>
+    <tr>
+      <td>TypeScript</td>
+      <td>^5.9.3</td>
+      <td>Implementação tipada da biblioteca</td>
+    </tr>
+    <tr>
+      <td>Vitest</td>
+      <td>^3.2.4</td>
+      <td>Testes unitários e validação de comportamento</td>
+    </tr>
+    <tr>
+      <td>JSONata</td>
+      <td>^2.1.0</td>
+      <td>Transformação declarativa de payloads</td>
+    </tr>
+    <tr>
+      <td>@cargolift-cdi/lib-common</td>
+      <td>workspace:*</td>
+      <td>Tipos e utilitários compartilhados</td>
+    </tr>
+    <tr>
+      <td>@cargolift-cdi/types</td>
+      <td>workspace:*</td>
+      <td>Tipos de domínio usados em validação/condições</td>
+    </tr>
+  </tbody>
+</table>
+
+Dependências internas:
+- `@cargolift-cdi/lib-common`
+- `@cargolift-cdi/types`
+
+---
+
+## 🚀 Instalação
+
+### Pré-requisitos
+
+- Node.js: >= 18
+- pnpm: recomendado para o monorepo
+
+### Passos de instalação
+
+1. Instalar dependências do workspace:
 
-```ts
-const payload = {
-  status: "APPROVED",
-  channel: null,
-};
+```bash
+pnpm install
+```
 
-const schema: Schema = {
-  validations: [
-    {
-      field: "status",
-      type: "string",
-      allowedValues: ["pending", "approved", "rejected"],
-      ignoreCase: true,
-    },
-    {
-      field: "channel",
-      allowNull: false,
-      required: false,
-      type: "string",
-      message: "Canal precisa ser informado quando enviado",
-    },
-  ],
-};
+2. Build da biblioteca:
 
-const { success, errors } = await new PayloadValidation().run(payload, schema);
-// success === false porque allowNull=false e channel veio como null
+```bash
+pnpm --filter @cargolift-cdi/lib-payload build
 ```
 
-## Estrutura do resultado
+3. Rodar testes da biblioteca:
+
+```bash
+pnpm --filter @cargolift-cdi/lib-payload test
+```
 
-`PayloadValidation.run()` retorna `ValidationResult`:
+### Variáveis de ambiente
+
+Não há variáveis de ambiente obrigatórias para uso base da biblioteca.
+
+<table>
+  <thead>
+    <tr>
+      <th>Variável</th>
+      <th>Descrição</th>
+      <th>Obrigatória</th>
+      <th>Valor padrão</th>
+    </tr>
+  </thead>
+  <tbody>
+    <tr>
+      <td><code>N/A</code></td>
+      <td>Sem configuração obrigatória por ambiente para uso padrão</td>
+      <td>Não</td>
+      <td><code>N/A</code></td>
+    </tr>
+  </tbody>
+</table>
+
+---
+
+## 💡 Como Usar
+
+### Quickstart
 
 ```ts
-{
-  success: boolean;
-  errors: Array<{
-    field: string;
-    value: any;       // valor que falhou
-    error: string;    // mensagem final
-    rule?: SchemaValidation; // regra original (útil para auditorias)
-  }>;
-  errorsList: string[]; // mensagens simples
-}
+import {
+  PayloadValidation,
+  PayloadTransformation,
+  PayloadDiff,
+} from "@cargolift-cdi/lib-payload";
+
+const validator = new PayloadValidation();
+const validation = await validator.validate({ id: "1" }, { id: { required: true, type: "string" } });
+
+const transformed = await PayloadTransformation.transform('{"id": id}', { id: "1" });
+
+const diff = PayloadDiff.diff({ status: "A" }, { status: "I" });
+```
+
+### Casos de uso avançados
+
+- **Pré-validação de payload canônico no ESB:** aplicar `PayloadValidation` antes de regras de negócio.
+- **Detecção de alterações para update parcial:** usar `PayloadDiff` para evitar writes desnecessários e registrar changelog.
+- **Projeções de integração entre sistemas:** usar JSONata em `PayloadTransformation` para adaptar contratos.
+
+---
+
+## 📁 Estrutura do Projeto
+
+```text
+.
+├── src/
+│   ├── index.ts
+│   ├── payload-validation/
+│   ├── payload-transformation/
+│   ├── payload-diff/
+│   ├── payload-condition/
+│   ├── payload-response-interpreter/
+│   ├── util/
+│   └── __tests__/
+├── package.json
+├── tsconfig.json
+├── vitest.config.ts
+└── README.md
 ```
 
-- Em caso de payload malformado (JSON inválido), o erro é registrado com `field = "_schema"` e `value` contém o conteúdo bruto.
-- Nenhuma exceção é propagada para regras inválidas; a execução continua e todos os erros são agregados.
+- `src/payload-validation/`: validações declarativas por schema.
+- `src/payload-transformation/`: transformações com JSONata.
+- `src/payload-diff/`: comparação e sanitização de alterações.
+- `src/payload-condition/`: avaliação de regras condicionais.
+- `src/payload-response-interpreter/`: interpretação de respostas externas.
+- `src/util/`: funções auxiliares reutilizáveis.
+
+---
 
-## Tratamento do payload
+## 🧪 Testes
 
-- Aceita objetos JavaScript ou strings JSON.
-- Caso receba string, a biblioteca detecta o formato e tenta fazer `JSON.parse` (XML pode ser suportado futuramente, ver `detectType`).
-- Falhas de parsing disparam `BusinessError` com código `INVALID_PAYLOAD`, permitindo padronizar a resposta HTTP ou o nack de mensagens.
+### Como rodar os testes
 
-## Testes
+```bash
+pnpm --filter @cargolift-cdi/lib-payload test
+```
 
-A suíte usa Vitest e cobre cenários básicos de schema, tipos e parsing.
+### Build e smoke de tipagem
 
 ```bash
-npm test
+pnpm --filter @cargolift-cdi/lib-payload build
+pnpm --filter @cargolift-cdi/lib-payload build:smoke
 ```
 
-Execute os testes antes de publicar (`npm prepublishOnly`) para garantir que regressões sejam detectadas.
+---
+
+## 🤝 Contribuindo
+
+Padrão de branches:
+- `main`: branch principal.
+- `feature/*`: novas funcionalidades.
+- `bugfix/*`: correções.
+
+Padrão de commits:
+- Conventional Commits.
+- Exemplos:
+  - `feat(payload-validation): adiciona suporte a dateISO`
+  - `fix(payload-diff): corrige comparação de arrays aninhados`
+
+Processo de PR:
+1. Criar branch a partir de `main`.
+2. Implementar alteração com testes.
+3. Executar `test` e `build` da lib.
+4. Abrir PR com descrição técnica e impacto.
+
+---
+
+## 📄 Licença
+
+Este projeto é distribuído sob a licença MIT.

package/dist/{types/index.d.ts → index.d.ts}

@@ -1,8 +1,12 @@
 export * from "./payload-validation/payload-validation.js";
-export * from "./payload-validation/payload-validation.interface.js";
 export * from "./payload-response-interpreter/payload-response-interpreter.js";
 export * from "./payload-transformation/payload-transformation.js";
 export * from "./payload-condition/payload-condition.js";
+export * from "./payload-diff/payload-diff.js";
+export * from "./payload-diff/payload-diff.interface.js";
 export * from "./util/payload-path.util.js";
 export * from "./util/payload-comparator.util.js";
 export * from "./util/payload-pointer.util.js";
+export * from "./util/payload-variable-resolver.util.js";
+export * from "./util/payload-hash.util.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,4CAA4C,CAAC;AAC3D,cAAc,gEAAgE,CAAC;AAC/E,cAAc,oDAAoD,CAAC;AACnE,cAAc,0CAA0C,CAAC;AACzD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,0CAA0C,CAAC;AACzD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,mCAAmC,CAAC;AAClD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,0CAA0C,CAAC;AACzD,cAAc,6BAA6B,CAAC"}

package/dist/{esm/index.js → index.js}

@@ -1,9 +1,12 @@
 export * from "./payload-validation/payload-validation.js";
-export * from "./payload-validation/payload-validation.interface.js";
 export * from "./payload-response-interpreter/payload-response-interpreter.js";
 export * from "./payload-transformation/payload-transformation.js";
 export * from "./payload-condition/payload-condition.js";
+export * from "./payload-diff/payload-diff.js";
+export * from "./payload-diff/payload-diff.interface.js";
 export * from "./util/payload-path.util.js";
 export * from "./util/payload-comparator.util.js";
 export * from "./util/payload-pointer.util.js";
+export * from "./util/payload-variable-resolver.util.js";
+export * from "./util/payload-hash.util.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,4CAA4C,CAAC;AAC3D,cAAc,gEAAgE,CAAC;AAC/E,cAAc,oDAAoD,CAAC;AACnE,cAAc,0CAA0C,CAAC;AACzD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,0CAA0C,CAAC;AACzD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,mCAAmC,CAAC;AAClD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,0CAA0C,CAAC;AACzD,cAAc,6BAA6B,CAAC"}

package/dist/payload-condition/payload-condition.d.ts

@@ -0,0 +1,8 @@
+import { ErrorType, PayloadConditionResult, PayloadConditions } from "@cargolift-cdi/types";
+export interface PayloadConditionVariables {
+    [key: string]: any;
+}
+export declare class PayloadCondition {
+    static evaluate(conditions: PayloadConditions, payload: any, variables?: PayloadConditionVariables, exceptionErrorType?: ErrorType): Promise<PayloadConditionResult>;
+}
+//# sourceMappingURL=payload-condition.d.ts.map

package/dist/payload-condition/payload-condition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"payload-condition.d.ts","sourceRoot":"","sources":["../../src/payload-condition/payload-condition.ts"],"names":[],"mappings":"AAGA,OAAO,EAAwD,SAAS,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAGlJ,MAAM,WAAW,yBAAyB;IACxC,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED,qBAAa,gBAAgB;WACd,QAAQ,CAAC,UAAU,EAAE,iBAAiB,EAAE,OAAO,EAAE,GAAG,EAAE,SAAS,GAAE,yBAA8B,EAAE,kBAAkB,GAAE,SAA8B,GAAG,OAAO,CAAC,sBAAsB,CAAC;CAqCnM"}

package/dist/{esm/payload-condition → payload-condition}/payload-condition.js

@@ -1,9 +1,10 @@
 import { PayloadPath } from "../util/payload-path.util.js";
 import { PayloadComparator } from "../util/payload-comparator.util.js";
+import { PayloadVariableResolver } from "../util/payload-variable-resolver.util.js";
 import { ErrorType } from "@cargolift-cdi/types";
 import { PayloadUtil } from "@cargolift-cdi/lib-common";
 export class PayloadCondition {
-    static async evaluate(conditions, payload, exceptionErrorType = ErrorType.BUSINESS) {
+    static async evaluate(conditions, payload, variables = {}, exceptionErrorType = ErrorType.BUSINESS) {
         if (conditions === undefined || conditions === null) {
             return { success: false, error: "Regras de condições não fornecidas", errorType: ErrorType.NONE };
         }
@@ -27,7 +28,7 @@ export class PayloadCondition {
             if (normalizedPayload === undefined) {
                 return { success: false, error: "Payload invalido para avaliacao de condicoes", errorType: exceptionErrorType };
             }
-            const success = ConditionEvaluator.evaluate(conditions.conditions, normalizedPayload);
+            const success = ConditionEvaluator.evaluate(conditions.conditions, normalizedPayload, variables);
             if (success) {
                 return { success: true, errorType: ErrorType.NONE };
             }
@@ -41,24 +42,26 @@ export class PayloadCondition {
     }
 }
 class ConditionEvaluator {
-    static evaluate(condition, payload) {
+    static evaluate(condition, payload, variables = {}) {
         if (Array.isArray(condition)) {
-            return condition.every((c) => this.evaluate(c, payload));
+            return condition.every((c) => this.evaluate(c, payload, variables));
         }
         if (this.isAll(condition)) {
-            return condition.all.every((c) => this.evaluate(c, payload));
+            return condition.all.every((c) => this.evaluate(c, payload, variables));
         }
         if (this.isAny(condition)) {
-            return condition.any.some((c) => this.evaluate(c, payload));
+            return condition.any.some((c) => this.evaluate(c, payload, variables));
         }
-        return this.evaluateBase(condition, payload);
+        return this.evaluateBase(condition, payload, variables);
     }
-    static evaluateBase(condition, payload) {
+    static evaluateBase(condition, payload, variables = {}) {
         if (!condition.left || !condition.operator) {
             return false;
         }
-        const leftValue = PayloadPath.get(payload, condition.left);
-        return PayloadComparator.compare(leftValue, condition.operator, condition.right);
+        const resolvedLeft = PayloadVariableResolver.resolve(condition.left, variables);
+        const resolvedRight = PayloadVariableResolver.resolve(condition.right, variables);
+        const leftValue = PayloadPath.get(payload, resolvedLeft);
+        return PayloadComparator.compare(leftValue, condition.operator, resolvedRight);
     }
     static isAll(condition) {
         return condition.all !== undefined;

package/dist/payload-condition/payload-condition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"payload-condition.js","sourceRoot":"","sources":["../../src/payload-condition/payload-condition.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AACvE,OAAO,EAAE,uBAAuB,EAAE,MAAM,2CAA2C,CAAC;AACpF,OAAO,EAAwD,SAAS,EAA6C,MAAM,sBAAsB,CAAC;AAClJ,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAMxD,MAAM,OAAO,gBAAgB;IAC3B,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,UAA6B,EAAE,OAAY,EAAE,YAAuC,EAAE,EAAE,qBAAgC,SAAS,CAAC,QAAQ;QAC9J,IAAI,UAAU,KAAK,SAAS,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;YACpD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,oCAAoC,EAAE,SAAS,EAAE,SAAS,CAAC,IAAI,EAAE,CAAC;QACpG,CAAC;QAED,IAAI,CAAC;YACH,UAAU,GAAG,OAAO,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC;QACpF,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,kCAAkC,GAAI,GAAa,CAAC,OAAO,EAAE,SAAS,EAAE,kBAAkB,EAAE,CAAC;QAC/H,CAAC;QAED,IAAI,CAAC;YACH,OAAO,GAAG,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;QACxE,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,qDAAqD,GAAI,GAAa,CAAC,OAAO,EAAE,SAAS,EAAE,kBAAkB,EAAE,CAAC;QAClJ,CAAC;QAED,IAAI,UAAU,CAAC,UAAU,KAAK,SAAS,IAAI,UAAU,CAAC,UAAU,KAAK,IAAI,EAAE,CAAC;YAC1E,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,oCAAoC,EAAE,SAAS,EAAE,kBAAkB,EAAG,CAAC;QACzG,CAAC;QAED,IAAI,CAAC;YACH,MAAM,iBAAiB,GAAG,WAAW,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;YACzD,IAAI,iBAAiB,KAAK,SAAS,EAAE,CAAC;gBACpC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,8CAA8C,EAAE,SAAS,EAAE,kBAAkB,EAAE,CAAC;YAClH,CAAC;YAED,MAAM,OAAO,GAAG,kBAAkB,CAAC,QAAQ,CAAC,UAAU,CAAC,UAAU,EAAE,iBAAiB,EAAE,SAAS,CAAC,CAAC;YACjG,IAAI,OAAO,EAAE,CAAC;gBACZ,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,CAAC,IAAI,EAAE,CAAC;YACtD,CAAC;iBAAM,CAAC;gBACN,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,yBAAyB,EAAE,SAAS,EAAE,SAAS,CAAC,IAAI,EAAC,CAAC;YACxF,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,8BAA8B,GAAI,GAAa,CAAC,OAAO,EAAE,SAAS,EAAE,kBAAkB,EAAE,CAAC;QAC3H,CAAC;IACH,CAAC;CACF;AAED,MAAM,kBAAkB;IACtB,MAAM,CAAC,QAAQ,CAAC,SAAkC,EAAE,OAAgB,EAAE,YAAuC,EAAE;QAC7G,IAAI,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;YAC7B,OAAO,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC;QACtE,CAAC;QAED,IAAI,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC;YAC1B,OAAO,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC;QAC1E,CAAC;QAED,IAAI,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC;YAC1B,OAAO,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC;QACzE,CAAC;QAED,OAAO,IAAI,CAAC,YAAY,CAAC,SAAS,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;IAC1D,CAAC;IAEO,MAAM,CAAC,YAAY,CAAC,SAAwB,EAAE,OAAgB,EAAE,YAAuC,EAAE;QAC/G,IAAI,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,CAAC;YAC3C,OAAO,KAAK,CAAC;QACf,CAAC;QACD,MAAM,YAAY,GAAG,uBAAuB,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,EAAE,SAAS,CAAW,CAAC;QAC1F,MAAM,aAAa,GAAG,uBAAuB,CAAC,OAAO,CAAC,SAAS,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;QAClF,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;QACzD,OAAO,iBAAiB,CAAC,OAAO,CAAC,SAAS,EAAE,SAAS,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC;IACjF,CAAC;IAEO,MAAM,CAAC,KAAK,CAAC,SAAoB;QACvC,OAAQ,SAA0B,CAAC,GAAG,KAAK,SAAS,CAAC;IACvD,CAAC;IAEO,MAAM,CAAC,KAAK,CAAC,SAAoB;QACvC,OAAQ,SAA0B,CAAC,GAAG,KAAK,SAAS,CAAC;IACvD,CAAC;CACF"}

package/dist/payload-diff/payload-diff.d.ts

@@ -0,0 +1,5 @@
+import type { DiffOptions, ResultPayloadDiff } from "./payload-diff.interface.js";
+export declare class PayloadDiff {
+    static diff<T extends Record<string, unknown>>(entity: T | null | undefined, payload: Partial<T> | null | undefined, options?: DiffOptions): ResultPayloadDiff<T>;
+}
+//# sourceMappingURL=payload-diff.d.ts.map

package/dist/payload-diff/payload-diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"payload-diff.d.ts","sourceRoot":"","sources":["../../src/payload-diff/payload-diff.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAuQlF,qBAAa,WAAW;WAWR,IAAI,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClD,MAAM,EAAE,CAAC,GAAG,IAAI,GAAG,SAAS,EAC5B,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,SAAS,EACtC,OAAO,CAAC,EAAE,WAAW,GACpB,iBAAiB,CAAC,CAAC,CAAC;CAyDxB"}

package/dist/payload-diff/payload-diff.example.d.ts

@@ -0,0 +1 @@
+//# sourceMappingURL=payload-diff.example.d.ts.map

package/dist/payload-diff/payload-diff.example.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"payload-diff.example.d.ts","sourceRoot":"","sources":["../../src/payload-diff/payload-diff.example.ts"],"names":[],"mappings":""}

package/dist/payload-diff/payload-diff.example.js

@@ -0,0 +1,2 @@
+"use strict";
+//# sourceMappingURL=payload-diff.example.js.map

package/dist/payload-diff/payload-diff.example.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"payload-diff.example.js","sourceRoot":"","sources":["../../src/payload-diff/payload-diff.example.ts"],"names":[],"mappings":""}

package/dist/payload-diff/payload-diff.interface.d.ts

@@ -0,0 +1,13 @@
+import { DiffChangeLog } from "@cargolift-cdi/types";
+export interface ResultPayloadDiff<T> {
+    success: boolean;
+    hasChanges: boolean;
+    error?: string;
+    sanitizedPayload: Partial<T>;
+    changes: DiffChangeLog[];
+}
+export interface DiffOptions {
+    ignoreFields?: string[];
+    pathSeparator?: string;
+}
+//# sourceMappingURL=payload-diff.interface.d.ts.map

package/dist/payload-diff/payload-diff.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"payload-diff.interface.d.ts","sourceRoot":"","sources":["../../src/payload-diff/payload-diff.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAKrD,MAAM,WAAW,iBAAiB,CAAC,CAAC;IAElC,OAAO,EAAE,OAAO,CAAC;IAEjB,UAAU,EAAE,OAAO,CAAC;IAEpB,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,gBAAgB,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IAE7B,OAAO,EAAE,aAAa,EAAE,CAAC;CAC1B;AAKD,MAAM,WAAW,WAAW;IAK1B,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IAMxB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB"}

package/dist/payload-diff/payload-diff.interface.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=payload-diff.interface.js.map

package/dist/payload-diff/payload-diff.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"payload-diff.interface.js","sourceRoot":"","sources":["../../src/payload-diff/payload-diff.interface.ts"],"names":[],"mappings":""}