@devix-tecnologia/assinatura-eletronica 0.0.0-stage → 0.5.1

package/DEVELOPERS.md

@@ -0,0 +1,123 @@
+# Desenvolvendo um novo provedor de assinatura
+
+Guia para implementar um provedor concreto (`IProvedorAssinatura`) e validá-lo
+com os testes de contrato.
+
+## Estrutura esperada de um provider package
+
+```
+packages/meu-provedor-client/
+  src/
+    meu-provedor-client/
+      meu-provedor-client.ts         # class MeuProvedorClient implements IProvedorAssinatura
+      meu-provedor-client.types.ts   # tipos específicos do provedor (config, responses)
+      meu-provedor-client.test.ts    # testes unitários (mock) + testes de contrato
+      index.ts                       # barrel: só a API pública
+    index.ts                         # reexporta o barrel do módulo
+  package.json
+  tsconfig.json
+  tsconfig.build.json
+  vitest.config.ts
+  README.md
+```
+
+## Interface a implementar
+
+```typescript
+import type {
+  IProvedorAssinatura,
+  DocumentoParaAssinar,
+} from '@devix-tecnologia/assinatura-eletronica';
+
+class MeuProvedorClient implements IProvedorAssinatura {
+  async enviarParaAssinatura(
+    documento: DocumentoParaAssinar
+  ): Promise<ResultadoEnvio>;
+  async obterDetalhes(idDoc: string): Promise<DetalhesDocumento>;
+  async cancelarDocumento(idDoc: string): Promise<void>;
+  normalizarWebhook(payload: unknown): EventoAssinatura;
+}
+```
+
+### Contrato de cada método
+
+**`enviarParaAssinatura`**
+- Recebe um `DocumentoParaAssinar` com PDF em base64, lista de signatários, metadata
+- Deve fazer upload/binário do PDF + criar lista de signatários + enviar para assinatura
+- Retorna `ResultadoEnvio` com `provedorDocId` (ID único no provedor) e `linkAcompanhamento` opcional
+
+**`obterDetalhes`**
+- Recebe o `provedorDocId` retornado pelo envio
+- Retorna `DetalhesDocumento` com `status` (string) e URLs de arquivo opcionais
+
+**`cancelarDocumento`**
+- Recebe o `provedorDocId`
+- Deve cancelar o documento no provedor
+- Resolve sem valor em caso de sucesso
+
+**`normalizarWebhook`**
+- Recebe o payload cru do webhook do provedor
+- Retorna `EventoAssinatura` normalizado
+- Os tipos de evento: `documento_finalizado`, `signatario_assinou`, `documento_cancelado`, `email_nao_entregue`, `outro`
+
+## Testes de contrato
+
+O pacote exporta `createProvedorAssinaturaContractTests` que executa uma suite
+de testes de conformidade da interface `IProvedorAssinatura`. Importe e execute
+no `.test.ts` do seu provedor:
+
+```typescript
+import { describe, it, expect, beforeEach } from 'vitest';
+import { createProvedorAssinaturaContractTests } from '@devix-tecnologia/assinatura-eletronica/provedor-assinatura.contract';
+import { MeuProvedorClient } from './meu-provedor-client.js';
+
+const hasRealCredentials = !!process.env.MEU_PROVEDOR_TOKEN;
+
+(hasRealCredentials ? describe : describe.skip)(
+  'MeuProvedorClient contract (real API)',
+  () => {
+    createProvedorAssinaturaContractTests(
+      {
+        createProvider: () =>
+          new MeuProvedorClient({
+            token: process.env.MEU_PROVEDOR_TOKEN!,
+            sandbox: true,
+          }),
+        createDocument: () => ({
+          pdfBase64: 'dGVzdGU=',
+          signatarios: [{ nome: 'João Silva', email: 'joao@teste.com' }],
+          nome: 'Contrato Teste',
+          dataLimite: '2026-07-18',
+          sandbox: true,
+          idExterno: 'ext-001',
+        }),
+      },
+      { describe, it, beforeEach, expect }
+    );
+  }
+);
+```
+
+- Os testes de contrato são **skipados por padrão** (sem credenciais reais)
+- Ative com `MEU_PROVEDOR_TOKEN=xxx pnpm test`
+- Os testes garantem que a interface está corretamente implementada
+
+## Testes unitários (mock)
+
+Além do contrato, mantenha testes unitários com o HTTP layer mockado para
+cobrir comportamentos específicos do provedor:
+
+- Mapeamento correto dos campos do `DocumentoParaAssinar` para a API do provedor
+- Normalização de webhooks para cada tipo de evento
+- Tratamento de erros e edge cases (payloads sem campos, timeout, etc.)
+- Overrides por-signatário (se aplicável)
+
+## Convensões
+
+- Segue o padrão de estrutura de módulos da Devix (`@devix-tecnologia/padroes`):
+  uma pasta kebab-case por classe, com `.ts`, `.types.ts`, `.test.ts` e `index.ts`
+- Imports relativos com extensão `.js` (o pacote é ESM e compila com `nodenext`)
+- O `index.ts` é **export-only** (sem lógica)
+- O constructor deve usar um objeto de configuração tipado
+- Dependa do núcleo por `workspace:^`; a versão de cada pacote é calculada pelo
+  `lerna version` a partir dos commits (ver `devdocs/README.md` na raiz)

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024-2026 Devix Tecnologia Ltda
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,142 @@
-# Temporary Holding Version
+# @devix-tecnologia/assinatura-eletronica
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Abstração unificada para provedores de assinatura eletrônica (ZapSign, D4Sign),
+com orquestração multi-provedor (roteamento, retries, failover) sobre o SDK
+[`@layerall/core`](https://github.com/sidartaveloso/layerall).
+
+## Instalação
+
+```bash
+pnpm add @devix-tecnologia/assinatura-eletronica
+```
+
+## Uso básico
+
+```typescript
+import {
+  AssinaturaOrquestrador,
+  criarObserverPadrao,
+} from '@devix-tecnologia/assinatura-eletronica';
+import { ZapsignClient } from '@devix-tecnologia/zapsign-client';
+
+const provedor = new ZapsignClient({
+  apiToken: process.env.ZAPSIGN_TOKEN!,
+  sandbox: true,
+});
+
+const orquestrador = new AssinaturaOrquestrador(
+  provedor,
+  undefined,
+  criarObserverPadrao(console)
+);
+
+const resultado = await orquestrador.enviarParaAssinatura({
+  pdfBase64,
+  signatarios: [{ nome: 'Fulano', email: 'fulano@exemplo.com' }],
+  nome: 'Contrato',
+  dataLimite: '2026-12-31',
+  sandbox: true,
+  idExterno: 'contrato_123',
+});
+
+console.log(resultado.provedorDocId, resultado.linkAcompanhamento);
+```
+
+## API pública
+
+### Tipos de domínio
+
+| Tipo                   | Descrição                                                 |
+| ---------------------- | --------------------------------------------------------- |
+| `IProvedorAssinatura`  | Interface que todo provedor deve implementar              |
+| `DocumentoParaAssinar` | Dados do documento + lista de signatários                 |
+| `ResultadoEnvio`       | Retorno de `enviarParaAssinatura`                         |
+| `DetalhesDocumento`    | Retorno de `obterDetalhes`                                |
+| `EventoAssinatura`     | Evento normalizado de webhook                             |
+| `Signatario`           | Dados de um signatário (nome, email, telefone, overrides) |
+
+### AssinaturaOrquestrador
+
+Orquestrador multi-provedor. Construtor:
+
+```typescript
+new AssinaturaOrquestrador(
+  provedor: IProvedorAssinatura | IProvedorAssinatura[],
+  policy?: PolicyDocument,
+  observer?: Observer,
+)
+```
+
+| Método                            | Retorno                      |
+| --------------------------------- | ---------------------------- |
+| `enviarParaAssinatura(documento)` | `Promise<ResultadoEnvio>`    |
+| `obterDetalhes(idDoc)`            | `Promise<DetalhesDocumento>` |
+| `cancelarDocumento(idDoc)`        | `Promise<void>`              |
+| `normalizarWebhook(payload)`      | `EventoAssinatura`           |
+
+Lança `AggregateError` quando todos os provedores falham.
+
+### Multi-provedor com failover
+
+```typescript
+import { ZapsignClient } from '@devix-tecnologia/zapsign-client';
+import { D4SignClient } from '@devix-tecnologia/d4sign-client';
+
+const orquestrador = new AssinaturaOrquestrador([
+  new ZapsignClient({ apiToken: process.env.ZAPSIGN_TOKEN!, sandbox: true }),
+  // new D4SignClient({ tokenAPI: ..., cryptKey: ..., cofreUUID: ..., sandbox: true }),
+]);
+```
+
+### Observer (logs estruturados)
+
+```typescript
+import { criarObserverPadrao } from '@devix-tecnologia/assinatura-eletronica';
+import type { Logger } from '@devix-tecnologia/utils';
+
+const observer = criarObserverPadrao(logger, { prefixo: '[assinatura]' });
+```
+
+Os eventos `onStart`/`onAttempt`/`onFinish` do LayerAll são traduzidos em logs
+com contexto estruturado (requestId, provedor, tentativa, latência, erro).
+
+### Estratégias de seleção de provedor
+
+A política padrão é `failover`. É possível customizar via `PolicyDocument`:
+
+```typescript
+import type { PolicyDocument } from '@devix-tecnologia/assinatura-eletronica';
+
+const policy: PolicyDocument = {
+  tenants: {
+    default: {
+      providers: ['ZapsignClient_0', 'D4SignClient_1'],
+      operations: {
+        create: {
+          strategy: 'failover',
+          failover: true,
+          retries: { max: 2, backoffMs: 300 },
+          timeoutMs: 10_000,
+        },
+        status: { strategy: 'round_robin' },
+      },
+    },
+  },
+};
+```
+
+Estratégias suportadas: `failover`, `round_robin`, `load_balance`, `most_fast`.
+
+## Provedores conhecidos
+
+- **[@devix-tecnologia/zapsign-client](../zapsign-client)** — Integração com [ZapSign](https://zapsign.com.br)
+- **[@devix-tecnologia/d4sign-client](../d4sign-client)** — Integração com [D4Sign](https://d4sign.com.br)
+
+## Para desenvolvedores de provedores
+
+Veja [DEVELOPERS.md](./DEVELOPERS.md) — guia de implementação, contrato de testes
+e estrutura do pacote.
+
+## Licença
+
+MIT. Ver [LICENSE](./LICENSE).

package/dist/assinatura-orquestrador/assinatura-orquestrador.d.ts

@@ -0,0 +1,12 @@
+import type { Observer, PolicyDocument } from '@layerall/core';
+import type { DetalhesDocumento, DocumentoParaAssinar, EventoAssinatura, IProvedorAssinatura, ResultadoEnvio } from '../provedor-assinatura/provedor-assinatura.types.js';
+export declare class AssinaturaOrquestrador {
+    private router;
+    private provedores;
+    constructor(provedor: IProvedorAssinatura | IProvedorAssinatura[], policy?: PolicyDocument, observer?: Observer);
+    enviarParaAssinatura(documento: DocumentoParaAssinar): Promise<ResultadoEnvio>;
+    obterDetalhes(idDoc: string): Promise<DetalhesDocumento>;
+    cancelarDocumento(idDoc: string): Promise<void>;
+    normalizarWebhook(payload: unknown): EventoAssinatura;
+}
+//# sourceMappingURL=assinatura-orquestrador.d.ts.map

package/dist/assinatura-orquestrador/assinatura-orquestrador.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assinatura-orquestrador.d.ts","sourceRoot":"","sources":["../../src/assinatura-orquestrador/assinatura-orquestrador.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAY,MAAM,gBAAgB,CAAC;AAMzE,OAAO,KAAK,EACV,iBAAiB,EACjB,oBAAoB,EACpB,gBAAgB,EAChB,mBAAmB,EACnB,cAAc,EACf,MAAM,qDAAqD,CAAC;AAU7D,qBAAa,sBAAsB;IACjC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,UAAU,CAAwB;IAE1C,YACE,QAAQ,EAAE,mBAAmB,GAAG,mBAAmB,EAAE,EACrD,MAAM,CAAC,EAAE,cAAc,EACvB,QAAQ,CAAC,EAAE,QAAQ,EAsBpB;IAEK,oBAAoB,CACxB,SAAS,EAAE,oBAAoB,GAC9B,OAAO,CAAC,cAAc,CAAC,CAkBzB;IAEK,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAiB7D;IAEK,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAepD;IAED,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,gBAAgB,CAEpD;CACF"}

package/dist/assinatura-orquestrador/assinatura-orquestrador.js

@@ -0,0 +1,57 @@
+import { Router } from '@layerall/core';
+import { criarPolicyDefault, mapearOperacao, } from '../layerall-policy/layerall-policy.js';
+import { criarProviderLayerAll, obterIdProvedor, } from '../provider-adapter/provider-adapter.js';
+export class AssinaturaOrquestrador {
+    router;
+    provedores;
+    constructor(provedor, policy, observer) {
+        this.provedores = Array.isArray(provedor) ? provedor : [provedor];
+        const providersMap = {};
+        const idsProvedores = [];
+        for (let i = 0; i < this.provedores.length; i++) {
+            const p = this.provedores[i];
+            const id = obterIdProvedor(p, i);
+            idsProvedores.push(id);
+            providersMap[id] = criarProviderLayerAll(p, id);
+        }
+        this.router = new Router({
+            providers: providersMap,
+            policy: policy ?? criarPolicyDefault(idsProvedores),
+            observer,
+        });
+    }
+    async enviarParaAssinatura(documento) {
+        const operacao = mapearOperacao('enviarParaAssinatura');
+        const result = await this.router.execute(operacao, {
+            externalId: documento.idExterno,
+            data: { operacao: 'enviarParaAssinatura', args: [documento] },
+        });
+        if (result.status === 'failed') {
+            throw new AggregateError([new Error(result.error?.message ?? 'Falha desconhecida')], 'Todos os provedores de assinatura falharam');
+        }
+        return result.result;
+    }
+    async obterDetalhes(idDoc) {
+        const operacao = mapearOperacao('obterDetalhes');
+        const result = await this.router.execute(operacao, {
+            data: { operacao: 'obterDetalhes', args: [idDoc] },
+        });
+        if (result.status === 'failed') {
+            throw new AggregateError([new Error(result.error?.message ?? 'Falha desconhecida')], 'Todos os provedores falharam ao obter detalhes');
+        }
+        return result.result;
+    }
+    async cancelarDocumento(idDoc) {
+        const operacao = mapearOperacao('cancelarDocumento');
+        const result = await this.router.execute(operacao, {
+            data: { operacao: 'cancelarDocumento', args: [idDoc] },
+        });
+        if (result.status === 'failed') {
+            throw new AggregateError([new Error(result.error?.message ?? 'Falha desconhecida')], 'Todos os provedores falharam ao cancelar documento');
+        }
+    }
+    normalizarWebhook(payload) {
+        return this.provedores[0].normalizarWebhook(payload);
+    }
+}
+//# sourceMappingURL=assinatura-orquestrador.js.map

package/dist/assinatura-orquestrador/assinatura-orquestrador.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assinatura-orquestrador.js","sourceRoot":"","sources":["../../src/assinatura-orquestrador/assinatura-orquestrador.ts"],"names":[],"mappings":"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"}

package/dist/assinatura-orquestrador/assinatura-orquestrador.types.d.ts

@@ -0,0 +1,14 @@
+export {};
+/**
+ * AssinaturaOrquestrador é a porta de entrada unificada para envio de
+ * documentos a provedores de assinatura eletrônica.
+ *
+ * Delega a orquestração (failover, round-robin, load balance, most-fast)
+ * ao Router do LayerAll, aplicando a política configurada.
+ *
+ * @remarks
+ * - Construtor aceita um provedor único ou um array (para fallback).
+ * - `enviarParaAssinatura` retorna `AggregateError` quando todos falham.
+ * - `normalizarWebhook` sempre delega ao primeiro provedor da lista.
+ */
+//# sourceMappingURL=assinatura-orquestrador.types.d.ts.map

package/dist/assinatura-orquestrador/assinatura-orquestrador.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assinatura-orquestrador.types.d.ts","sourceRoot":"","sources":["../../src/assinatura-orquestrador/assinatura-orquestrador.types.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;GAWG"}

package/dist/assinatura-orquestrador/assinatura-orquestrador.types.js

@@ -0,0 +1,14 @@
+export {};
+/**
+ * AssinaturaOrquestrador é a porta de entrada unificada para envio de
+ * documentos a provedores de assinatura eletrônica.
+ *
+ * Delega a orquestração (failover, round-robin, load balance, most-fast)
+ * ao Router do LayerAll, aplicando a política configurada.
+ *
+ * @remarks
+ * - Construtor aceita um provedor único ou um array (para fallback).
+ * - `enviarParaAssinatura` retorna `AggregateError` quando todos falham.
+ * - `normalizarWebhook` sempre delega ao primeiro provedor da lista.
+ */
+//# sourceMappingURL=assinatura-orquestrador.types.js.map

package/dist/assinatura-orquestrador/assinatura-orquestrador.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assinatura-orquestrador.types.js","sourceRoot":"","sources":["../../src/assinatura-orquestrador/assinatura-orquestrador.types.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;GAWG"}

package/dist/assinatura-orquestrador/index.d.ts

@@ -0,0 +1,2 @@
+export { AssinaturaOrquestrador } from './assinatura-orquestrador.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/assinatura-orquestrador/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/assinatura-orquestrador/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC"}

package/dist/assinatura-orquestrador/index.js

@@ -0,0 +1,2 @@
+export { AssinaturaOrquestrador } from './assinatura-orquestrador.js';
+//# sourceMappingURL=index.js.map

package/dist/assinatura-orquestrador/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/assinatura-orquestrador/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export type { Logger } from '@devix-tecnologia/utils';
+export type { Observer, OperationName, PolicyDocument } from '@layerall/core';
+export { AssinaturaOrquestrador } from './assinatura-orquestrador/assinatura-orquestrador.js';
+export { criarPolicyDefault, mapearOperacao, } from './layerall-policy/layerall-policy.js';
+export { criarObserverPadrao } from './observer/observer.js';
+export type { LoggerLike, ObserverOptions } from './observer/observer.types.js';
+export type { DetalhesDocumento, DocumentoParaAssinar, EventoAssinatura, IProvedorAssinatura, ResultadoEnvio, Signatario, } from './provedor-assinatura/provedor-assinatura.types.js';
+export { criarProviderLayerAll, obterIdProvedor, } from './provider-adapter/provider-adapter.js';
+export type { DadosOperacao, ResultadoOperacao, } from './provider-adapter/provider-adapter.types.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,YAAY,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAEtD,YAAY,EAAE,QAAQ,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAC9E,OAAO,EAAE,sBAAsB,EAAE,MAAM,sDAAsD,CAAC;AAC9F,OAAO,EACL,kBAAkB,EAClB,cAAc,GACf,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC7D,YAAY,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAChF,YAAY,EACV,iBAAiB,EACjB,oBAAoB,EACpB,gBAAgB,EAChB,mBAAmB,EACnB,cAAc,EACd,UAAU,GACX,MAAM,oDAAoD,CAAC;AAC5D,OAAO,EACL,qBAAqB,EACrB,eAAe,GAChB,MAAM,wCAAwC,CAAC;AAChD,YAAY,EACV,aAAa,EACb,iBAAiB,GAClB,MAAM,8CAA8C,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+export { AssinaturaOrquestrador } from './assinatura-orquestrador/assinatura-orquestrador.js';
+export { criarPolicyDefault, mapearOperacao, } from './layerall-policy/layerall-policy.js';
+export { criarObserverPadrao } from './observer/observer.js';
+export { criarProviderLayerAll, obterIdProvedor, } from './provider-adapter/provider-adapter.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":"AAGA,OAAO,EAAE,sBAAsB,EAAE,MAAM,sDAAsD,CAAC;AAC9F,OAAO,EACL,kBAAkB,EAClB,cAAc,GACf,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAU7D,OAAO,EACL,qBAAqB,EACrB,eAAe,GAChB,MAAM,wCAAwC,CAAC"}

package/dist/layerall-policy/index.d.ts

@@ -0,0 +1,2 @@
+export { criarPolicyDefault, mapearOperacao } from './layerall-policy.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/layerall-policy/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/layerall-policy/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/layerall-policy/index.js

@@ -0,0 +1,2 @@
+export { criarPolicyDefault, mapearOperacao } from './layerall-policy.js';
+//# sourceMappingURL=index.js.map

package/dist/layerall-policy/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/layerall-policy/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/layerall-policy/layerall-policy.d.ts

@@ -0,0 +1,4 @@
+import type { OperationName, PolicyDocument } from '@layerall/core';
+export declare function criarPolicyDefault(idsProvedores: string[]): PolicyDocument;
+export declare function mapearOperacao(operacao: string): OperationName;
+//# sourceMappingURL=layerall-policy.d.ts.map

package/dist/layerall-policy/layerall-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layerall-policy.d.ts","sourceRoot":"","sources":["../../src/layerall-policy/layerall-policy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAUpE,wBAAgB,kBAAkB,CAAC,aAAa,EAAE,MAAM,EAAE,GAAG,cAAc,CAgB1E;AAED,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,aAAa,CAM9D"}

package/dist/layerall-policy/layerall-policy.js

@@ -0,0 +1,28 @@
+const MAPA_OPERACAO = {
+    enviarParaAssinatura: 'create',
+    obterDetalhes: 'status',
+    cancelarDocumento: 'cancel',
+};
+const OPERACOES_DOMINIO = Object.keys(MAPA_OPERACAO);
+export function criarPolicyDefault(idsProvedores) {
+    const operacoes = Object.fromEntries(OPERACOES_DOMINIO.map((op) => [
+        MAPA_OPERACAO[op],
+        { strategy: 'failover', failover: true },
+    ]));
+    return {
+        tenants: {
+            default: {
+                providers: idsProvedores,
+                operations: operacoes,
+            },
+        },
+    };
+}
+export function mapearOperacao(operacao) {
+    const mapeada = MAPA_OPERACAO[operacao];
+    if (!mapeada) {
+        throw new Error(`Operação desconhecida: ${operacao}`);
+    }
+    return mapeada;
+}
+//# sourceMappingURL=layerall-policy.js.map

package/dist/layerall-policy/layerall-policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"layerall-policy.js","sourceRoot":"","sources":["../../src/layerall-policy/layerall-policy.ts"],"names":[],"mappings":"AAEA,MAAM,aAAa,GAAkC;IACnD,oBAAoB,EAAE,QAAQ;IAC9B,aAAa,EAAE,QAAQ;IACvB,iBAAiB,EAAE,QAAQ;CAC5B,CAAC;AAEF,MAAM,iBAAiB,GAAG,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;AAErD,MAAM,UAAU,kBAAkB,CAAC,aAAuB;IACxD,MAAM,SAAS,GAAG,MAAM,CAAC,WAAW,CAClC,iBAAiB,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC;QAC5B,aAAa,CAAC,EAAE,CAAC;QACjB,EAAE,QAAQ,EAAE,UAAmB,EAAE,QAAQ,EAAE,IAAI,EAAE;KAClD,CAAC,CACH,CAAC;IAEF,OAAO;QACL,OAAO,EAAE;YACP,OAAO,EAAE;gBACP,SAAS,EAAE,aAAa;gBACxB,UAAU,EAAE,SAAS;aACtB;SACF;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,QAAgB;IAC7C,MAAM,OAAO,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;IACxC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,0BAA0B,QAAQ,EAAE,CAAC,CAAC;IACxD,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/layerall-policy/layerall-policy.types.d.ts

@@ -0,0 +1,8 @@
+export {};
+/**
+ * Mapeamento de operações de domínio para OperationName do LayerAll:
+ * - `enviarParaAssinatura` → `create`
+ * - `obterDetalhes` → `status`
+ * - `cancelarDocumento` → `cancel`
+ */
+//# sourceMappingURL=layerall-policy.types.d.ts.map

package/dist/layerall-policy/layerall-policy.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layerall-policy.types.d.ts","sourceRoot":"","sources":["../../src/layerall-policy/layerall-policy.types.ts"],"names":[],"mappings":";AAAA;;;;;GAKG"}

package/dist/layerall-policy/layerall-policy.types.js

@@ -0,0 +1,8 @@
+export {};
+/**
+ * Mapeamento de operações de domínio para OperationName do LayerAll:
+ * - `enviarParaAssinatura` → `create`
+ * - `obterDetalhes` → `status`
+ * - `cancelarDocumento` → `cancel`
+ */
+//# sourceMappingURL=layerall-policy.types.js.map

package/dist/layerall-policy/layerall-policy.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"layerall-policy.types.js","sourceRoot":"","sources":["../../src/layerall-policy/layerall-policy.types.ts"],"names":[],"mappings":";AAAA;;;;;GAKG"}

package/dist/observer/index.d.ts

@@ -0,0 +1,4 @@
+export type { Logger } from '@devix-tecnologia/utils';
+export { criarObserverPadrao } from './observer.js';
+export type { LoggerLike, ObserverOptions } from './observer.types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/observer/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/observer/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpD,YAAY,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/observer/index.js

@@ -0,0 +1,2 @@
+export { criarObserverPadrao } from './observer.js';
+//# sourceMappingURL=index.js.map

package/dist/observer/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/observer/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC"}

package/dist/observer/observer.d.ts

@@ -0,0 +1,10 @@
+import type { Logger } from '@devix-tecnologia/utils';
+import type { Observer } from '@layerall/core';
+import type { ObserverOptions } from './observer.types.js';
+/**
+ * Cria um {@link Observer} do LayerAll que traduz os eventos de
+ * orquestração (`onStart`/`onAttempt`/`onFinish`) em logs estruturados,
+ * substituindo o log solto que existia antes nas factories/serviços.
+ */
+export declare function criarObserverPadrao(logger?: Logger, opts?: ObserverOptions): Observer;
+//# sourceMappingURL=observer.d.ts.map

package/dist/observer/observer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observer.d.ts","sourceRoot":"","sources":["../../src/observer/observer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE3D;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,GAAE,MAAgB,EACxB,IAAI,GAAE,eAAoB,GACzB,QAAQ,CAwEV"}

package/dist/observer/observer.js

@@ -0,0 +1,70 @@
+/**
+ * Cria um {@link Observer} do LayerAll que traduz os eventos de
+ * orquestração (`onStart`/`onAttempt`/`onFinish`) em logs estruturados,
+ * substituindo o log solto que existia antes nas factories/serviços.
+ */
+export function criarObserverPadrao(logger = console, opts = {}) {
+    const prefixo = opts.prefixo ?? '[assinatura]';
+    const emitir = (nivel, mensagem, dados) => {
+        const fn = logger[nivel] ?? logger.info;
+        if (!fn)
+            return;
+        const linha = dados
+            ? `${prefixo} ${mensagem} ${JSON.stringify(dados)}`
+            : `${prefixo} ${mensagem}`;
+        fn.call(logger, linha);
+    };
+    return {
+        onStart(ev) {
+            emitir('info', 'operação iniciada', {
+                requestId: ev.requestId,
+                operacao: ev.operation,
+                estrategia: ev.strategy,
+            });
+        },
+        onAttempt(log) {
+            if (log.ok) {
+                emitir('info', 'tentativa concluída', {
+                    requestId: log.requestId,
+                    operacao: log.operation,
+                    provedor: log.provider,
+                    tentativa: log.attempt,
+                    latenciaMs: log.latencyMs,
+                });
+                return;
+            }
+            emitir('warn', 'tentativa falhou', {
+                requestId: log.requestId,
+                operacao: log.operation,
+                provedor: log.provider,
+                tentativa: log.attempt,
+                latenciaMs: log.latencyMs,
+                transiente: log.transient,
+                codigoErro: log.errorCode,
+                erro: log.error,
+            });
+        },
+        onFinish(res) {
+            if (res.status === 'succeeded') {
+                emitir('info', 'operação concluída', {
+                    requestId: res.requestId,
+                    operacao: res.operation,
+                    provedor: res.provider,
+                    tentativas: res.attempts,
+                    latenciaMs: res.latencyMs,
+                    receipt: res.providerReceipt,
+                });
+                return;
+            }
+            emitir('error', 'operação falhou em todos os provedores', {
+                requestId: res.requestId,
+                operacao: res.operation,
+                tentativas: res.attempts,
+                latenciaMs: res.latencyMs,
+                codigoErro: res.error?.code,
+                erro: res.error?.message,
+            });
+        },
+    };
+}
+//# sourceMappingURL=observer.js.map

package/dist/observer/observer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"observer.js","sourceRoot":"","sources":["../../src/observer/observer.ts"],"names":[],"mappings":"AAIA;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CACjC,MAAM,GAAW,OAAO,EACxB,IAAI,GAAoB,EAAE;IAE1B,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,cAAc,CAAC;IAE/C,MAAM,MAAM,GAAG,CACb,KAAgC,EAChC,QAAgB,EAChB,KAA+B,EACzB,EAAE;QACR,MAAM,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC;QACxC,IAAI,CAAC,EAAE;YAAE,OAAO;QAChB,MAAM,KAAK,GAAG,KAAK;YACjB,CAAC,CAAC,GAAG,OAAO,IAAI,QAAQ,IAAI,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE;YACnD,CAAC,CAAC,GAAG,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC7B,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IACzB,CAAC,CAAC;IAEF,OAAO;QACL,OAAO,CAAC,EAAE;YACR,MAAM,CAAC,MAAM,EAAE,mBAAmB,EAAE;gBAClC,SAAS,EAAE,EAAE,CAAC,SAAS;gBACvB,QAAQ,EAAE,EAAE,CAAC,SAAS;gBACtB,UAAU,EAAE,EAAE,CAAC,QAAQ;aACxB,CAAC,CAAC;QACL,CAAC;QAED,SAAS,CAAC,GAAG;YACX,IAAI,GAAG,CAAC,EAAE,EAAE,CAAC;gBACX,MAAM,CAAC,MAAM,EAAE,qBAAqB,EAAE;oBACpC,SAAS,EAAE,GAAG,CAAC,SAAS;oBACxB,QAAQ,EAAE,GAAG,CAAC,SAAS;oBACvB,QAAQ,EAAE,GAAG,CAAC,QAAQ;oBACtB,SAAS,EAAE,GAAG,CAAC,OAAO;oBACtB,UAAU,EAAE,GAAG,CAAC,SAAS;iBAC1B,CAAC,CAAC;gBACH,OAAO;YACT,CAAC;YAED,MAAM,CAAC,MAAM,EAAE,kBAAkB,EAAE;gBACjC,SAAS,EAAE,GAAG,CAAC,SAAS;gBACxB,QAAQ,EAAE,GAAG,CAAC,SAAS;gBACvB,QAAQ,EAAE,GAAG,CAAC,QAAQ;gBACtB,SAAS,EAAE,GAAG,CAAC,OAAO;gBACtB,UAAU,EAAE,GAAG,CAAC,SAAS;gBACzB,UAAU,EAAE,GAAG,CAAC,SAAS;gBACzB,UAAU,EAAE,GAAG,CAAC,SAAS;gBACzB,IAAI,EAAE,GAAG,CAAC,KAAK;aAChB,CAAC,CAAC;QACL,CAAC;QAED,QAAQ,CAAC,GAAG;YACV,IAAI,GAAG,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;gBAC/B,MAAM,CAAC,MAAM,EAAE,oBAAoB,EAAE;oBACnC,SAAS,EAAE,GAAG,CAAC,SAAS;oBACxB,QAAQ,EAAE,GAAG,CAAC,SAAS;oBACvB,QAAQ,EAAE,GAAG,CAAC,QAAQ;oBACtB,UAAU,EAAE,GAAG,CAAC,QAAQ;oBACxB,UAAU,EAAE,GAAG,CAAC,SAAS;oBACzB,OAAO,EAAE,GAAG,CAAC,eAAe;iBAC7B,CAAC,CAAC;gBACH,OAAO;YACT,CAAC;YAED,MAAM,CAAC,OAAO,EAAE,wCAAwC,EAAE;gBACxD,SAAS,EAAE,GAAG,CAAC,SAAS;gBACxB,QAAQ,EAAE,GAAG,CAAC,SAAS;gBACvB,UAAU,EAAE,GAAG,CAAC,QAAQ;gBACxB,UAAU,EAAE,GAAG,CAAC,SAAS;gBACzB,UAAU,EAAE,GAAG,CAAC,KAAK,EAAE,IAAI;gBAC3B,IAAI,EAAE,GAAG,CAAC,KAAK,EAAE,OAAO;aACzB,CAAC,CAAC;QACL,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/observer/observer.types.d.ts

@@ -0,0 +1,8 @@
+import type { Logger } from '@devix-tecnologia/utils';
+/** Alias para a interface Logger do utils, exportado para conveniência dos consumidores. */
+export type LoggerLike = Logger;
+export interface ObserverOptions {
+    /** Prefixo aplicado a todas as linhas de log. Default: `[assinatura]`. */
+    prefixo?: string;
+}
+//# sourceMappingURL=observer.types.d.ts.map

package/dist/observer/observer.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observer.types.d.ts","sourceRoot":"","sources":["../../src/observer/observer.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAEtD,4FAA4F;AAC5F,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC;AAEhC,MAAM,WAAW,eAAe;IAC9B,0EAA0E;IAC1E,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB"}

package/dist/observer/observer.types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=observer.types.js.map

package/dist/observer/observer.types.js.map

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

package/dist/provedor-assinatura/index.d.ts

@@ -0,0 +1,3 @@
+export { criarProvedorQueFalha, criarProvedorStub, documentoPadrao, } from './provedor-assinatura.mock.js';
+export type { DetalhesDocumento, DocumentoParaAssinar, EventoAssinatura, IProvedorAssinatura, ResultadoEnvio, Signatario, } from './provedor-assinatura.types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/provedor-assinatura/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/provedor-assinatura/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,iBAAiB,EACjB,eAAe,GAChB,MAAM,+BAA+B,CAAC;AACvC,YAAY,EACV,iBAAiB,EACjB,oBAAoB,EACpB,gBAAgB,EAChB,mBAAmB,EACnB,cAAc,EACd,UAAU,GACX,MAAM,gCAAgC,CAAC"}

package/dist/provedor-assinatura/index.js

@@ -0,0 +1,2 @@
+export { criarProvedorQueFalha, criarProvedorStub, documentoPadrao, } from './provedor-assinatura.mock.js';
+//# sourceMappingURL=index.js.map

package/dist/provedor-assinatura/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/provedor-assinatura/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,iBAAiB,EACjB,eAAe,GAChB,MAAM,+BAA+B,CAAC"}

package/dist/provedor-assinatura/provedor-assinatura.contract.d.ts

@@ -0,0 +1,24 @@
+import type { DocumentoParaAssinar, IProvedorAssinatura } from './provedor-assinatura.types.js';
+export interface ProvedorAssinaturaContractSuite {
+    createProvider: () => IProvedorAssinatura;
+    createDocument: () => DocumentoParaAssinar;
+}
+export interface AssercaoContrato {
+    toBeDefined(): void;
+    toBeTypeOf(type: string): void;
+    toBeGreaterThan(n: number): void;
+    toContain(item: unknown): void;
+    toEqual(expected: unknown): void;
+    toBe(expected: unknown): void;
+    resolves: {
+        toBeUndefined(): unknown;
+    };
+}
+export interface TestFramework {
+    describe(name: string, fn: () => void): void;
+    it(name: string, fn: () => Promise<void> | void): void;
+    beforeEach(fn: () => void): void;
+    expect(actual: unknown): AssercaoContrato;
+}
+export declare function createProvedorAssinaturaContractTests(suite: ProvedorAssinaturaContractSuite, t: TestFramework): void;
+//# sourceMappingURL=provedor-assinatura.contract.d.ts.map

package/dist/provedor-assinatura/provedor-assinatura.contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provedor-assinatura.contract.d.ts","sourceRoot":"","sources":["../../src/provedor-assinatura/provedor-assinatura.contract.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,oBAAoB,EACpB,mBAAmB,EACpB,MAAM,gCAAgC,CAAC;AAExC,MAAM,WAAW,+BAA+B;IAC9C,cAAc,EAAE,MAAM,mBAAmB,CAAC;IAC1C,cAAc,EAAE,MAAM,oBAAoB,CAAC;CAC5C;AAKD,MAAM,WAAW,gBAAgB;IAC/B,WAAW,IAAI,IAAI,CAAC;IACpB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,eAAe,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,SAAS,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC;IAC/B,OAAO,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI,CAAC;IACjC,IAAI,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI,CAAC;IAC9B,QAAQ,EAAE;QAAE,aAAa,IAAI,OAAO,CAAA;KAAE,CAAC;CACxC;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;IAC7C,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC;IACvD,UAAU,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;IACjC,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,gBAAgB,CAAC;CAC3C;AAED,wBAAgB,qCAAqC,CACnD,KAAK,EAAE,+BAA+B,EACtC,CAAC,EAAE,aAAa,GACf,IAAI,CA6DN"}

package/dist/provedor-assinatura/provedor-assinatura.contract.js

@@ -0,0 +1,48 @@
+export function createProvedorAssinaturaContractTests(suite, t) {
+    const { describe, it, beforeEach, expect } = t;
+    describe('IProvedorAssinatura contract', () => {
+        let provedor;
+        beforeEach(() => {
+            provedor = suite.createProvider();
+        });
+        it('deve retornar ResultadoEnvio ao enviar documento para assinatura', async () => {
+            const documento = suite.createDocument();
+            const resultado = await provedor.enviarParaAssinatura(documento);
+            expect(resultado).toBeDefined();
+            expect(resultado.provedorDocId).toBeTypeOf('string');
+            expect(resultado.provedorDocId.length).toBeGreaterThan(0);
+        });
+        it('deve obter detalhes do documento', async () => {
+            const documento = suite.createDocument();
+            const resultado = await provedor.enviarParaAssinatura(documento);
+            const detalhes = await provedor.obterDetalhes(resultado.provedorDocId);
+            expect(detalhes).toBeDefined();
+            expect(detalhes.status).toBeTypeOf('string');
+        });
+        it('deve cancelar documento', async () => {
+            const documento = suite.createDocument();
+            const resultado = await provedor.enviarParaAssinatura(documento);
+            await expect(provedor.cancelarDocumento(resultado.provedorDocId)).resolves.toBeUndefined();
+        });
+        it('deve normalizar webhook retornando EventoAssinatura valido', () => {
+            const evento = provedor.normalizarWebhook({ qualquer: 'payload' });
+            expect(evento).toBeDefined();
+            expect(evento.tipo).toBeTypeOf('string');
+            expect([
+                'documento_finalizado',
+                'signatario_assinou',
+                'documento_cancelado',
+                'email_nao_entregue',
+                'outro',
+            ]).toContain(evento.tipo);
+            expect(evento.provedorDocId).toBeTypeOf('string');
+            expect(evento.raw).toBeDefined();
+        });
+        it('deve extrair provedorDocId do payload do webhook quando presente', () => {
+            const evento = provedor.normalizarWebhook({ id: 'doc-custom-123' });
+            expect(evento.provedorDocId).toBe('doc-custom-123');
+            expect(evento.raw).toEqual({ id: 'doc-custom-123' });
+        });
+    });
+}
+//# sourceMappingURL=provedor-assinatura.contract.js.map

package/dist/provedor-assinatura/provedor-assinatura.contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provedor-assinatura.contract.js","sourceRoot":"","sources":["../../src/provedor-assinatura/provedor-assinatura.contract.ts"],"names":[],"mappings":"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"}

package/dist/provedor-assinatura/provedor-assinatura.mock.d.ts

@@ -0,0 +1,5 @@
+import type { DocumentoParaAssinar, IProvedorAssinatura } from './provedor-assinatura.types.js';
+export declare function criarProvedorStub(): IProvedorAssinatura;
+export declare function criarProvedorQueFalha(): IProvedorAssinatura;
+export declare const documentoPadrao: DocumentoParaAssinar;
+//# sourceMappingURL=provedor-assinatura.mock.d.ts.map

package/dist/provedor-assinatura/provedor-assinatura.mock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provedor-assinatura.mock.d.ts","sourceRoot":"","sources":["../../src/provedor-assinatura/provedor-assinatura.mock.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,oBAAoB,EACpB,mBAAmB,EACpB,MAAM,gCAAgC,CAAC;AAExC,wBAAgB,iBAAiB,IAAI,mBAAmB,CA8BvD;AAED,wBAAgB,qBAAqB,IAAI,mBAAmB,CAW3D;AAED,eAAO,MAAM,eAAe,EAAE,oBAO7B,CAAC"}

package/dist/provedor-assinatura/provedor-assinatura.mock.js

@@ -0,0 +1,53 @@
+import { vi } from 'vitest';
+export function criarProvedorStub() {
+    let contadorStub = 0;
+    return {
+        async enviarParaAssinatura() {
+            contadorStub++;
+            return {
+                provedorDocId: `doc-stub-${String(contadorStub).padStart(3, '0')}`,
+                linkAcompanhamento: `https://stub.assinatura.com/doc/${contadorStub}`,
+                rawResponse: { stub: true },
+            };
+        },
+        async obterDetalhes(idDoc) {
+            return {
+                status: 'signed',
+                originalFileUrl: `https://stub.assinatura.com/doc/${idDoc}/original`,
+                signedFileUrl: `https://stub.assinatura.com/doc/${idDoc}/signed`,
+            };
+        },
+        async cancelarDocumento() {
+            return;
+        },
+        normalizarWebhook(payload) {
+            const body = payload;
+            return {
+                tipo: 'documento_finalizado',
+                provedorDocId: String(body?.id ?? 'doc-stub-001'),
+                raw: payload,
+            };
+        },
+    };
+}
+export function criarProvedorQueFalha() {
+    return {
+        enviarParaAssinatura: vi
+            .fn()
+            .mockRejectedValue(new Error('Falha no provedor')),
+        obterDetalhes: vi.fn().mockRejectedValue(new Error('Falha no provedor')),
+        cancelarDocumento: vi
+            .fn()
+            .mockRejectedValue(new Error('Falha no provedor')),
+        normalizarWebhook: vi.fn(),
+    };
+}
+export const documentoPadrao = {
+    pdfBase64: 'dGVzdGU=',
+    signatarios: [{ nome: 'João Silva', email: 'joao@teste.com' }],
+    nome: 'Contrato Teste',
+    dataLimite: '2026-07-18',
+    sandbox: true,
+    idExterno: 'ext-001',
+};
+//# sourceMappingURL=provedor-assinatura.mock.js.map

package/dist/provedor-assinatura/provedor-assinatura.mock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provedor-assinatura.mock.js","sourceRoot":"","sources":["../../src/provedor-assinatura/provedor-assinatura.mock.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAM5B,MAAM,UAAU,iBAAiB;IAC/B,IAAI,YAAY,GAAG,CAAC,CAAC;IACrB,OAAO;QACL,KAAK,CAAC,oBAAoB;YACxB,YAAY,EAAE,CAAC;YACf,OAAO;gBACL,aAAa,EAAE,YAAY,MAAM,CAAC,YAAY,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE;gBAClE,kBAAkB,EAAE,mCAAmC,YAAY,EAAE;gBACrE,WAAW,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE;aAC5B,CAAC;QACJ,CAAC;QACD,KAAK,CAAC,aAAa,CAAC,KAAK;YACvB,OAAO;gBACL,MAAM,EAAE,QAAQ;gBAChB,eAAe,EAAE,mCAAmC,KAAK,WAAW;gBACpE,aAAa,EAAE,mCAAmC,KAAK,SAAS;aACjE,CAAC;QACJ,CAAC;QACD,KAAK,CAAC,iBAAiB;YACrB,OAAO;QACT,CAAC;QACD,iBAAiB,CAAC,OAAO;YACvB,MAAM,IAAI,GAAG,OAAkC,CAAC;YAChD,OAAO;gBACL,IAAI,EAAE,sBAAsB;gBAC5B,aAAa,EAAE,MAAM,CAAC,IAAI,EAAE,EAAE,IAAI,cAAc,CAAC;gBACjD,GAAG,EAAE,OAAO;aACb,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,qBAAqB;IACnC,OAAO;QACL,oBAAoB,EAAE,EAAE;aACrB,EAAE,EAAE;aACJ,iBAAiB,CAAC,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC;QACpD,aAAa,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC;QACxE,iBAAiB,EAAE,EAAE;aAClB,EAAE,EAAE;aACJ,iBAAiB,CAAC,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC;QACpD,iBAAiB,EAAE,EAAE,CAAC,EAAE,EAAE;KAC3B,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,eAAe,GAAyB;IACnD,SAAS,EAAE,UAAU;IACrB,WAAW,EAAE,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,gBAAgB,EAAE,CAAC;IAC9D,IAAI,EAAE,gBAAgB;IACtB,UAAU,EAAE,YAAY;IACxB,OAAO,EAAE,IAAI;IACb,SAAS,EAAE,SAAS;CACrB,CAAC"}

package/dist/provedor-assinatura/provedor-assinatura.types.d.ts

@@ -0,0 +1,69 @@
+export interface Signatario {
+    nome: string;
+    email: string;
+    telefone?: string;
+    mensagemPersonalizada?: string;
+    /** Envia e-mail automático de convite a ESTE signatário (API ZapSign: send_automatic_email). */
+    sendAutomaticEmail?: boolean;
+    /** Envia convite por WhatsApp a ESTE signatário (API ZapSign: send_automatic_whatsapp). */
+    sendAutomaticWhatsapp?: boolean;
+    /** Impede ESTE signatário de editar o e-mail (API ZapSign: lock_email). */
+    lockEmail?: boolean;
+    /** Impede ESTE signatário de editar o telefone (API ZapSign: lock_phone). */
+    lockPhone?: boolean;
+    /** Exige selfie DESTE signatário (API ZapSign: require_selfie_photo). */
+    requireSelfie?: boolean;
+    /** Exige foto do documento DESTE signatário (API ZapSign: require_document_photo). */
+    requireDocumentPhoto?: boolean;
+    /** Modo de autenticação DESTE signatário (API ZapSign: auth_mode). */
+    authMode?: string;
+}
+export interface DocumentoParaAssinar {
+    pdfBase64: string;
+    signatarios: Signatario[];
+    nome: string;
+    /** Data-limite para assinar (YYYY-MM-DD). Opcional: quando ausente, o provedor não envia limite. */
+    dataLimite?: string;
+    sandbox: boolean;
+    idExterno: string;
+    /** Envia e-mail automático de convite aos signatários (API ZapSign: send_automatic_email). */
+    sendAutomaticEmail?: boolean;
+    /** Envia convite por WhatsApp aos signatários (API ZapSign: send_automatic_whatsapp). */
+    sendAutomaticWhatsapp?: boolean;
+    /** Impede o signatário de editar o e-mail (API ZapSign: lock_email). */
+    lockEmail?: boolean;
+    /** Impede o signatário de editar o telefone (API ZapSign: lock_phone). */
+    lockPhone?: boolean;
+    /** Exige selfie do signatário (API ZapSign: require_selfie_photo). */
+    requireSelfie?: boolean;
+    /** Exige foto do documento do signatário (API ZapSign: require_document_photo). */
+    requireDocumentPhoto?: boolean;
+    metadata?: Record<string, unknown>;
+}
+export interface ResultadoEnvio {
+    provedorDocId: string;
+    linkAcompanhamento?: string;
+    rawResponse: unknown;
+}
+export interface DetalhesDocumento {
+    status: string;
+    originalFileUrl?: string;
+    signedFileUrl?: string;
+}
+export interface EventoAssinatura {
+    tipo: 'documento_finalizado' | 'signatario_assinou' | 'documento_cancelado' | 'email_nao_entregue' | 'outro';
+    provedorDocId: string;
+    /** ID externo do documento no sistema consumidor (ex.: contrato_123). Preenchido quando o provedor o envia. */
+    idExterno?: string;
+    /** URL do arquivo assinado, quando o evento a traz (ex.: doc finalizado). */
+    signedFileUrl?: string;
+    signatario?: Signatario;
+    raw: unknown;
+}
+export interface IProvedorAssinatura {
+    enviarParaAssinatura(documento: DocumentoParaAssinar): Promise<ResultadoEnvio>;
+    obterDetalhes(idDoc: string): Promise<DetalhesDocumento>;
+    cancelarDocumento(idDoc: string): Promise<void>;
+    normalizarWebhook(payload: unknown): EventoAssinatura;
+}
+//# sourceMappingURL=provedor-assinatura.types.d.ts.map

package/dist/provedor-assinatura/provedor-assinatura.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provedor-assinatura.types.d.ts","sourceRoot":"","sources":["../../src/provedor-assinatura/provedor-assinatura.types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,gGAAgG;IAChG,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,2FAA2F;IAC3F,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,2EAA2E;IAC3E,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,6EAA6E;IAC7E,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,yEAAyE;IACzE,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,sFAAsF;IACtF,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,sEAAsE;IACtE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,oGAAoG;IACpG,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,8FAA8F;IAC9F,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,yFAAyF;IACzF,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,wEAAwE;IACxE,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,0EAA0E;IAC1E,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,sEAAsE;IACtE,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,mFAAmF;IACnF,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,cAAc;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EACA,sBAAsB,GACtB,oBAAoB,GACpB,qBAAqB,GACrB,oBAAoB,GACpB,OAAO,CAAC;IACZ,aAAa,EAAE,MAAM,CAAC;IACtB,+GAA+G;IAC/G,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6EAA6E;IAC7E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,GAAG,EAAE,OAAO,CAAC;CACd;AAED,MAAM,WAAW,mBAAmB;IAClC,oBAAoB,CAClB,SAAS,EAAE,oBAAoB,GAC9B,OAAO,CAAC,cAAc,CAAC,CAAC;IAC3B,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IACzD,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChD,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,gBAAgB,CAAC;CACvD"}

package/dist/provedor-assinatura/provedor-assinatura.types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=provedor-assinatura.types.js.map

package/dist/provedor-assinatura/provedor-assinatura.types.js.map

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

package/dist/provider-adapter/index.d.ts

@@ -0,0 +1,3 @@
+export { criarProviderLayerAll, obterIdProvedor } from './provider-adapter.js';
+export type { DadosOperacao, OperacaoAssinatura, PropriedadesProvedor, ResultadoOperacao, } from './provider-adapter.types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/provider-adapter/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/provider-adapter/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC/E,YAAY,EACV,aAAa,EACb,kBAAkB,EAClB,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,6BAA6B,CAAC"}

package/dist/provider-adapter/index.js

@@ -0,0 +1,2 @@
+export { criarProviderLayerAll, obterIdProvedor } from './provider-adapter.js';
+//# sourceMappingURL=index.js.map

package/dist/provider-adapter/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/provider-adapter/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/provider-adapter/provider-adapter.d.ts

@@ -0,0 +1,6 @@
+import type { Provider as LayerAllProvider } from '@layerall/core';
+import type { IProvedorAssinatura } from '../provedor-assinatura/provedor-assinatura.types.js';
+import type { DadosOperacao, PropriedadesProvedor, ResultadoOperacao } from './provider-adapter.types.js';
+export declare function criarProviderLayerAll(provedor: IProvedorAssinatura, idProvedor?: string, propriedades?: PropriedadesProvedor): LayerAllProvider<DadosOperacao, ResultadoOperacao>;
+export declare function obterIdProvedor(provedor: IProvedorAssinatura, indice: number): string;
+//# sourceMappingURL=provider-adapter.d.ts.map

package/dist/provider-adapter/provider-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-adapter.d.ts","sourceRoot":"","sources":["../../src/provider-adapter/provider-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,QAAQ,IAAI,gBAAgB,EAC7B,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qDAAqD,CAAC;AAC/F,OAAO,KAAK,EACV,aAAa,EACb,oBAAoB,EACpB,iBAAiB,EAClB,MAAM,6BAA6B,CAAC;AAErC,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,mBAAmB,EAC7B,UAAU,CAAC,EAAE,MAAM,EACnB,YAAY,CAAC,EAAE,oBAAoB,GAClC,gBAAgB,CAAC,aAAa,EAAE,iBAAiB,CAAC,CAyBpD;AAED,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,mBAAmB,EAC7B,MAAM,EAAE,MAAM,GACb,MAAM,CAIR"}

package/dist/provider-adapter/provider-adapter.js

@@ -0,0 +1,30 @@
+export function criarProviderLayerAll(provedor, idProvedor, propriedades) {
+    return {
+        id: idProvedor ?? provedor.constructor.name ?? 'provider',
+        ...propriedades,
+        async invoke(ctx) {
+            const { operacao, args } = ctx.payload.data;
+            switch (operacao) {
+                case 'enviarParaAssinatura':
+                    return provedor.enviarParaAssinatura(args[0]);
+                case 'obterDetalhes':
+                    return provedor.obterDetalhes(args[0]);
+                case 'cancelarDocumento':
+                    return provedor.cancelarDocumento(args[0]);
+                default:
+                    throw {
+                        code: 'operacao_invalida',
+                        message: `Operação desconhecida: ${operacao}`,
+                        transient: false,
+                    };
+            }
+        },
+    };
+}
+export function obterIdProvedor(provedor, indice) {
+    const nome = provedor.constructor.name;
+    if (!nome || nome === 'Object')
+        return `provider_${indice}`;
+    return `${nome}_${indice}`;
+}
+//# sourceMappingURL=provider-adapter.js.map

package/dist/provider-adapter/provider-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-adapter.js","sourceRoot":"","sources":["../../src/provider-adapter/provider-adapter.ts"],"names":[],"mappings":"AAWA,MAAM,UAAU,qBAAqB,CACnC,QAA6B,EAC7B,UAAmB,EACnB,YAAmC;IAEnC,OAAO;QACL,EAAE,EAAE,UAAU,IAAI,QAAQ,CAAC,WAAW,CAAC,IAAI,IAAI,UAAU;QACzD,GAAG,YAAY;QACf,KAAK,CAAC,MAAM,CACV,GAAiC;YAEjC,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC;YAE5C,QAAQ,QAAQ,EAAE,CAAC;gBACjB,KAAK,sBAAsB;oBACzB,OAAO,QAAQ,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;gBAChD,KAAK,eAAe;oBAClB,OAAO,QAAQ,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;gBACzC,KAAK,mBAAmB;oBACtB,OAAO,QAAQ,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;gBAC7C;oBACE,MAAM;wBACJ,IAAI,EAAE,mBAAmB;wBACzB,OAAO,EAAE,0BAA0B,QAAQ,EAAE;wBAC7C,SAAS,EAAE,KAAK;qBACjB,CAAC;YACN,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,QAA6B,EAC7B,MAAc;IAEd,MAAM,IAAI,GAAG,QAAQ,CAAC,WAAW,CAAC,IAAI,CAAC;IACvC,IAAI,CAAC,IAAI,IAAI,IAAI,KAAK,QAAQ;QAAE,OAAO,YAAY,MAAM,EAAE,CAAC;IAC5D,OAAO,GAAG,IAAI,IAAI,MAAM,EAAE,CAAC;AAC7B,CAAC"}

package/dist/provider-adapter/provider-adapter.types.d.ts

@@ -0,0 +1,26 @@
+import type { DetalhesDocumento, DocumentoParaAssinar, ResultadoEnvio } from '../provedor-assinatura/provedor-assinatura.types.js';
+/** Operações de domínio expostas ao LayerAll. */
+export type OperacaoAssinatura = 'enviarParaAssinatura' | 'obterDetalhes' | 'cancelarDocumento';
+/** Payload de entrada de cada operação. */
+export type DadosOperacao = {
+    operacao: 'enviarParaAssinatura';
+    args: [DocumentoParaAssinar];
+} | {
+    operacao: 'obterDetalhes';
+    args: [string];
+} | {
+    operacao: 'cancelarDocumento';
+    args: [string];
+};
+/** Resultado de cada operação. */
+export type ResultadoOperacao = ResultadoEnvio | DetalhesDocumento | void;
+/** Propriedades opcionais de um provedor para o LayerAll (peso, capacidade, saúde etc.). */
+export type PropriedadesProvedor = {
+    weight?: number;
+    capacity?: number;
+    enabled?: boolean;
+    health?: number;
+    baseLatency?: number;
+    failRate?: number;
+};
+//# sourceMappingURL=provider-adapter.types.d.ts.map

package/dist/provider-adapter/provider-adapter.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-adapter.types.d.ts","sourceRoot":"","sources":["../../src/provider-adapter/provider-adapter.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EACjB,oBAAoB,EACpB,cAAc,EACf,MAAM,qDAAqD,CAAC;AAE7D,iDAAiD;AACjD,MAAM,MAAM,kBAAkB,GAC1B,sBAAsB,GACtB,eAAe,GACf,mBAAmB,CAAC;AAExB,2CAA2C;AAC3C,MAAM,MAAM,aAAa,GACrB;IAAE,QAAQ,EAAE,sBAAsB,CAAC;IAAC,IAAI,EAAE,CAAC,oBAAoB,CAAC,CAAA;CAAE,GAClE;IAAE,QAAQ,EAAE,eAAe,CAAC;IAAC,IAAI,EAAE,CAAC,MAAM,CAAC,CAAA;CAAE,GAC7C;IAAE,QAAQ,EAAE,mBAAmB,CAAC;IAAC,IAAI,EAAE,CAAC,MAAM,CAAC,CAAA;CAAE,CAAC;AAEtD,kCAAkC;AAElC,MAAM,MAAM,iBAAiB,GAAG,cAAc,GAAG,iBAAiB,GAAG,IAAI,CAAC;AAE1E,4FAA4F;AAC5F,MAAM,MAAM,oBAAoB,GAAG;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC"}

package/dist/provider-adapter/provider-adapter.types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=provider-adapter.types.js.map

package/dist/provider-adapter/provider-adapter.types.js.map

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

package/package.json

@@ -1,6 +1,63 @@
 {
   "name": "@devix-tecnologia/assinatura-eletronica",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.5.1",
+  "description": "Abstração unificada para provedores de assinatura eletrônica",
+  "keywords": [
+    "assinatura",
+    "zapsign",
+    "d4sign",
+    "eletronica"
+  ],
+  "license": "MIT",
+  "author": "Devix Tecnologia Ltda <contato@devix.co> (https://devix.co)",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./provedor-assinatura.contract": {
+      "types": "./dist/provedor-assinatura/provedor-assinatura.contract.d.ts",
+      "import": "./dist/provedor-assinatura/provedor-assinatura.contract.js",
+      "default": "./dist/provedor-assinatura/provedor-assinatura.contract.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "DEVELOPERS.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "@devix-tecnologia:registry": "https://registry.npmjs.org/",
+    "access": "public"
+  },
+  "dependencies": {
+    "@devix-tecnologia/utils": "^0.2.0",
+    "@layerall/core": "^2.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^24.13.5",
+    "typescript": "^7.0.2",
+    "vitest": "^5.0.1"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/devix-tecnologia/assinatura-eletronica.git",
+    "directory": "packages/assinatura-eletronica"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "clean": "rm -rf dist coverage tsconfig.tsbuildinfo",
+    "dev": "tsc -p tsconfig.build.json --watch",
+    "format": "biome check --write .",
+    "lint": "biome check . --error-on-warnings",
+    "test": "vitest --run",
+    "test:watch": "vitest --watch",
+    "typecheck": "tsc --noEmit"
+  }
 }