@devix-tecnologia/zapsign-client 0.0.0-stage → 0.4.4

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,137 @@
-# Temporary Holding Version
+# @devix-tecnologia/zapsign-client
 
-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.
+Cliente [ZapSign](https://zapsign.com.br) implementando a interface
+`IProvedorAssinatura` do pacote `@devix-tecnologia/assinatura-eletronica`.
+
+## Instalação
+
+```bash
+pnpm add @devix-tecnologia/zapsign-client
+```
+
+## Configuração
+
+```typescript
+import { ZapsignClient } from '@devix-tecnologia/zapsign-client';
+
+const client = new ZapsignClient({
+  apiToken: process.env.ZAPSIGN_TOKEN!, // obrigatório
+  sandbox: true, // default: true
+  baseUrl: 'https://proxy.interno/api/v1/docs/', // opcional: vence sandbox
+  folderPath: '/contratos', // opcional
+  brandPrimaryColor: '#000000', // opcional: default #000000
+  authMode: 'assinaturaTela', // opcional: default assinaturaTela
+});
+```
+
+| Parâmetro           | Tipo       | Default          | Descrição                                          |
+| ------------------- | ---------- | ---------------- | -------------------------------------------------- |
+| `apiToken`          | `string`   | —                | Token de autenticação da API ZapSign               |
+| `sandbox`           | `boolean`  | `true`           | Ambiente de testes                                 |
+| `baseUrl`           | `string`   | —                | URL base customizada (ex.: proxy). Vence `sandbox` |
+| `folderPath`        | `string`   | —                | Pasta no ZapSign onde os docs são criados          |
+| `brandPrimaryColor` | `string`   | `#000000`        | Cor da marca no fluxo de assinatura                |
+| `authMode`          | `AuthMode` | `assinaturaTela` | Modo de autenticação padrão                        |
+
+## Uso
+
+Enviar um documento para assinatura:
+
+```typescript
+const resultado = await client.enviarParaAssinatura({
+  pdfBase64: 'dGVzdGU=...',
+  signatarios: [{ nome: 'João Silva', email: 'joao@teste.com' }],
+  nome: 'Contrato',
+  dataLimite: '2026-12-31', // opcional
+  sandbox: true,
+  idExterno: 'contrato_123',
+  sendAutomaticEmail: true, // opcional: envio automático de e-mail
+  sendAutomaticWhatsapp: false, // opcional: envio automático de WhatsApp
+  requireSelfie: false, // opcional: exige selfie do signatário
+  requireDocumentPhoto: false, // opcional: exige foto do documento
+});
+```
+
+Consultar detalhes e cancelar:
+
+```typescript
+const detalhes = await client.obterDetalhes('doc-token-123');
+// { status: 'signed', originalFileUrl: '...', signedFileUrl: '...' }
+
+await client.cancelarDocumento('doc-token-123');
+```
+
+### Overrides por signatário
+
+Campos como `sendAutomaticEmail`, `authMode`, `requireSelfie` podem ser
+definidos por signatário (vence o nível-documento):
+
+```typescript
+signatarios: [
+  {
+    nome: 'Usuário Automático',
+    email: 'auto@exemplo.com',
+    sendAutomaticEmail: false,       // não envia convite
+    lockEmail: false,
+    authMode: 'assinaturaTela',
+    requireSelfie: true,
+    requireDocumentPhoto: true,
+    lockPhone: true,
+    sendAutomaticWhatsapp: true,
+  },
+  { nome: 'Representante', email: 'rep@exemplo.com' }, // herda do documento
+],
+```
+
+### Assinatura automática (operador assina pelo signatário)
+
+```typescript
+await client.assinarAutomaticamente(
+  ['signer-token-1', 'signer-token-2'], // tokens dos signatários
+  'user-token-9' // token do operador
+);
+```
+
+### Normalização de webhooks
+
+```typescript
+const evento = client.normalizarWebhook({
+  event_type: 'doc_signed',
+  status: 'signed',
+  token: 'doc-token-456',
+  external_id: 'contrato_123',
+  signed_file: 'https://zapsign.com.br/doc/signed.pdf',
+});
+// { tipo: 'documento_finalizado', provedorDocId: 'doc-token-456', idExterno: 'contrato_123', signedFileUrl: '...' }
+```
+
+| Evento ZapSign | Status   | `tipo` normalizado     |
+| -------------- | -------- | ---------------------- |
+| `doc_signed`   | `signed` | `documento_finalizado` |
+| `doc_signed`   | outros   | `signatario_assinou`   |
+| `doc_deleted`  | —        | `documento_cancelado`  |
+| outros         | —        | `outro`                |
+
+## Uso com o orquestrador
+
+```typescript
+import {
+  AssinaturaOrquestrador,
+  criarObserverPadrao,
+} from '@devix-tecnologia/assinatura-eletronica';
+import { ZapsignClient } from '@devix-tecnologia/zapsign-client';
+
+const orquestrador = new AssinaturaOrquestrador(
+  new ZapsignClient({ apiToken: process.env.ZAPSIGN_TOKEN!, sandbox: true }),
+  undefined,
+  criarObserverPadrao(console)
+);
+
+const resultado = await orquestrador.enviarParaAssinatura({
+  /* ... */
+});
+```
+
+## Licença
+
+MIT. Ver [LICENSE](./LICENSE).

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export type { ZapsignConfig } from './zapsign-client/index.js';
+export { ZapsignClient } from './zapsign-client/index.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,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export { ZapsignClient } from './zapsign-client/index.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":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/zapsign-client/index.d.ts

@@ -0,0 +1,3 @@
+export { ZapsignClient } from './zapsign-client.js';
+export type { ZapsignConfig } from './zapsign-client.types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/zapsign-client/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/zapsign-client/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,YAAY,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/zapsign-client/index.js

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

package/dist/zapsign-client/index.js.map

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

package/dist/zapsign-client/zapsign-client.d.ts

@@ -0,0 +1,21 @@
+import type { DetalhesDocumento, DocumentoParaAssinar, EventoAssinatura, IProvedorAssinatura, ResultadoEnvio } from '@devix-tecnologia/assinatura-eletronica';
+import type { ZapsignConfig, ZapsignSignResponse } from './zapsign-client.types.js';
+export declare class ZapsignClient implements IProvedorAssinatura {
+    private baseURL;
+    private apiToken;
+    private folderPath?;
+    private brandPrimaryColor;
+    private authMode;
+    constructor(config: ZapsignConfig);
+    enviarParaAssinatura(documento: DocumentoParaAssinar): Promise<ResultadoEnvio>;
+    obterDetalhes(idDoc: string): Promise<DetalhesDocumento>;
+    /**
+     * Assinatura automática (task-036): um usuário da plataforma assina via API, sem fluxo de convite.
+     * POST /api/v1/sign/ com user_token (do usuário que assina) + signer_tokens (dos signatários no doc).
+     * https://docs.zapsign.com.br — operação específica do ZapSign (não faz parte de IProvedorAssinatura).
+     */
+    assinarAutomaticamente(signerTokens: string[], userToken: string): Promise<ZapsignSignResponse>;
+    cancelarDocumento(idDoc: string): Promise<void>;
+    normalizarWebhook(payload: unknown): EventoAssinatura;
+}
+//# sourceMappingURL=zapsign-client.d.ts.map

package/dist/zapsign-client/zapsign-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zapsign-client.d.ts","sourceRoot":"","sources":["../../src/zapsign-client/zapsign-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EACjB,oBAAoB,EACpB,gBAAgB,EAChB,mBAAmB,EACnB,cAAc,EACf,MAAM,yCAAyC,CAAC;AAEjD,OAAO,KAAK,EAEV,aAAa,EAGb,mBAAmB,EACpB,MAAM,2BAA2B,CAAC;AAEnC,qBAAa,aAAc,YAAW,mBAAmB;IACvD,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,UAAU,CAAC,CAAS;IAC5B,OAAO,CAAC,iBAAiB,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAW;IAE3B,YAAY,MAAM,EAAE,aAAa,EAYhC;IAEK,oBAAoB,CACxB,SAAS,EAAE,oBAAoB,GAC9B,OAAO,CAAC,cAAc,CAAC,CA6CzB;IAEK,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAa7D;IAED;;;;OAIG;IACG,sBAAsB,CAC1B,YAAY,EAAE,MAAM,EAAE,EACtB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,mBAAmB,CAAC,CAY9B;IAEK,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAIpD;IAED,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,gBAAgB,CAyBpD;CACF"}

package/dist/zapsign-client/zapsign-client.js

@@ -0,0 +1,114 @@
+import axios from 'axios';
+export class ZapsignClient {
+    baseURL;
+    apiToken;
+    folderPath;
+    brandPrimaryColor;
+    authMode;
+    constructor(config) {
+        this.apiToken = config.apiToken;
+        // baseUrl explícita (ex.: vinda de env/proxy) vence o switch por sandbox (task-036).
+        // `||` (não `??`): env vazia ('') deve cair no switch, não virar baseURL vazia.
+        this.baseURL =
+            config.baseUrl ||
+                (config.sandbox === false
+                    ? 'https://api.zapsign.com.br/api/v1/docs/'
+                    : 'https://sandbox.api.zapsign.com.br/api/v1/docs/');
+        this.folderPath = config.folderPath;
+        this.brandPrimaryColor = config.brandPrimaryColor ?? '#000000';
+        this.authMode = config.authMode ?? 'assinaturaTela';
+    }
+    async enviarParaAssinatura(documento) {
+        const { data } = await axios.post(this.baseURL, {
+            name: documento.nome,
+            external_id: documento.idExterno,
+            base64_pdf: documento.pdfBase64,
+            sandbox: documento.sandbox,
+            ...(documento.dataLimite !== undefined
+                ? { date_limit_to_sign: documento.dataLimite }
+                : {}),
+            brand_primary_color: this.brandPrimaryColor,
+            ...(this.folderPath !== undefined
+                ? { folder_path: this.folderPath }
+                : {}),
+            // Precedência (task-036): override do SIGNATÁRIO ?? nível-DOCUMENTO ?? default.
+            signers: documento.signatarios.map((s) => ({
+                name: s.nome,
+                email: s.email,
+                send_automatic_email: s.sendAutomaticEmail ?? documento.sendAutomaticEmail ?? true,
+                send_automatic_whatsapp: s.sendAutomaticWhatsapp ?? documento.sendAutomaticWhatsapp ?? false,
+                custom_message: s.mensagemPersonalizada ?? '',
+                lock_email: s.lockEmail ?? documento.lockEmail ?? false,
+                lock_phone: s.lockPhone ?? documento.lockPhone ?? false,
+                phone_country: '55',
+                phone_number: s.telefone ?? '',
+                auth_mode: s.authMode ?? this.authMode,
+                require_selfie_photo: s.requireSelfie ?? documento.requireSelfie ?? false,
+                require_document_photo: s.requireDocumentPhoto ?? documento.requireDocumentPhoto ?? false,
+            })),
+        }, {
+            headers: { Authorization: `Bearer ${this.apiToken}` },
+        });
+        return {
+            provedorDocId: data.token,
+            linkAcompanhamento: data.signers?.[0]?.sign_url,
+            rawResponse: data,
+        };
+    }
+    async obterDetalhes(idDoc) {
+        const { data } = await axios.get(`${this.baseURL}${idDoc}`, {
+            headers: { Authorization: `Bearer ${this.apiToken}` },
+        });
+        return {
+            status: data.status,
+            originalFileUrl: data.original_file,
+            signedFileUrl: data.signed_file,
+        };
+    }
+    /**
+     * Assinatura automática (task-036): um usuário da plataforma assina via API, sem fluxo de convite.
+     * POST /api/v1/sign/ com user_token (do usuário que assina) + signer_tokens (dos signatários no doc).
+     * https://docs.zapsign.com.br — operação específica do ZapSign (não faz parte de IProvedorAssinatura).
+     */
+    async assinarAutomaticamente(signerTokens, userToken) {
+        // Deriva do sufixo docs/ para preservar prefixos de path de baseUrl custom (proxy);
+        // fallback: path absoluto na origem (bases oficiais da ZapSign).
+        const url = /docs\/?$/.test(this.baseURL)
+            ? this.baseURL.replace(/docs\/?$/, 'sign/')
+            : new URL('/api/v1/sign/', this.baseURL).toString();
+        const { data } = await axios.post(url, { user_token: userToken, signer_tokens: signerTokens }, { headers: { Authorization: `Bearer ${this.apiToken}` } });
+        return data;
+    }
+    async cancelarDocumento(idDoc) {
+        await axios.delete(`${this.baseURL}${idDoc}`, {
+            headers: { Authorization: `Bearer ${this.apiToken}` },
+        });
+    }
+    normalizarWebhook(payload) {
+        // Payload real do webhook ZapSign é PLANO: { event_type, status, external_id, token, ... }.
+        const body = (payload ?? {});
+        const eventType = String(body.event_type ?? '');
+        const status = String(body.status ?? '');
+        let tipo;
+        if (eventType === 'doc_signed' && status === 'signed') {
+            tipo = 'documento_finalizado';
+        }
+        else if (eventType === 'doc_signed') {
+            tipo = 'signatario_assinou';
+        }
+        else if (eventType === 'doc_deleted') {
+            tipo = 'documento_cancelado';
+        }
+        else {
+            tipo = 'outro';
+        }
+        return {
+            tipo,
+            provedorDocId: String(body.token ?? ''),
+            idExterno: body.external_id ? String(body.external_id) : undefined,
+            signedFileUrl: body.signed_file ? String(body.signed_file) : undefined,
+            raw: payload,
+        };
+    }
+}
+//# sourceMappingURL=zapsign-client.js.map

package/dist/zapsign-client/zapsign-client.js.map

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

package/dist/zapsign-client/zapsign-client.types.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Modo de autenticação do signatário (API ZapSign: auth_mode). Autocomplete para os valores mais
+ * comuns, mas aceita outros que a API do ZapSign suporte (`& {}` evita rejeitar valores válidos
+ * não listados aqui — não temos o enum fechado autoritativo da API).
+ */
+export type AuthMode = 'assinaturaTela' | 'tokenEmail' | 'tokenSms' | (string & {});
+export interface ZapsignConfig {
+    apiToken: string;
+    sandbox?: boolean;
+    /** URL-base da API (ex.: vinda de env/proxy). Quando definida, vence o switch por sandbox. */
+    baseUrl?: string;
+    /** Pasta no ZapSign onde os documentos são criados (API: folder_path). Ex.: '/'. */
+    folderPath?: string;
+    /** Cor primária da marca no fluxo de assinatura (API: brand_primary_color). Ex.: '#000000'. */
+    brandPrimaryColor?: string;
+    /** Modo de autenticação do signatário (API: auth_mode). Ex.: 'assinaturaTela'. */
+    authMode?: AuthMode;
+}
+export interface ZapsignSignerResponse {
+    sign_url: string;
+}
+export interface ZapsignCreateResponse {
+    token: string;
+    signers: ZapsignSignerResponse[];
+}
+export interface ZapsignDetailResponse {
+    token: string;
+    status: string;
+    original_file: string;
+    signed_file: string;
+    external_id: string;
+}
+/** Resposta do POST /api/v1/sign/ (assinatura automática). Shape mínimo observado. */
+export interface ZapsignSignResponse {
+    status?: string;
+    [k: string]: unknown;
+}
+//# sourceMappingURL=zapsign-client.types.d.ts.map

package/dist/zapsign-client/zapsign-client.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zapsign-client.types.d.ts","sourceRoot":"","sources":["../../src/zapsign-client/zapsign-client.types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,MAAM,QAAQ,GAChB,gBAAgB,GAChB,YAAY,GACZ,UAAU,GACV,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAElB,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,8FAA8F;IAC9F,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oFAAoF;IACpF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,+FAA+F;IAC/F,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,kFAAkF;IAClF,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,qBAAqB,EAAE,CAAC;CAClC;AAED,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,sFAAsF;AACtF,MAAM,WAAW,mBAAmB;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CACtB"}

package/dist/zapsign-client/zapsign-client.types.js

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

package/dist/zapsign-client/zapsign-client.types.js.map

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

package/package.json

@@ -1,6 +1,51 @@
 {
   "name": "@devix-tecnologia/zapsign-client",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.4.4",
+  "description": "Cliente ZapSign implementando IProvedorAssinatura",
+  "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"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "@devix-tecnologia:registry": "https://registry.npmjs.org/",
+    "access": "public"
+  },
+  "dependencies": {
+    "@devix-tecnologia/assinatura-eletronica": "^0.5.1",
+    "axios": "^1.20.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/zapsign-client"
+  },
+  "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"
+  }
 }