[VRF-54] Cria script de embedded para serviço de autenticações desacopladas

.github/workflows/lint.yml

@@ -17,6 +17,9 @@ jobs:
           - name: v2
             path: packages/v2
             lockfile: packages/v2/pnpm-lock.yaml
+          - name: v3
+            path: packages/v3
+            lockfile: packages/v3/pnpm-lock.yaml
     steps:
       - name: Checkout Code
         uses: actions/checkout@v6

.github/workflows/tests.yml

@@ -17,6 +17,9 @@ jobs:
           - name: v2
             path: packages/v2
             lockfile: packages/v2/pnpm-lock.yaml
+          - name: v3
+            path: packages/v3
+            lockfile: packages/v3/pnpm-lock.yaml
     steps:
       - name: Checkout Code
         uses: actions/checkout@v6

README.md

@@ -19,11 +19,141 @@ Para desmontar o `iframe` da DOM:
 widget.unmount();
 ```
 
+### Autenticações (`v3-beta`)
+
+Para criar o componente de autenticação:
+
+```javascript
+import Verify from '@clicksign/embedded/v3/verify';
+
+const transaction = new Verify('d973213c-6411-11e8-8df5-7cd1c3e91b23');
+
+transaction.on('loaded', ev => { console.log(ev); })
+transaction.on('success', ev => { console.log(ev); })
+transaction.on('failed', ev => { console.log(ev); })
+transaction.on('error', ev => { console.log(ev); })
+
+transaction.start('container-id');
+```
+
+O construtor de `Verify` aceita um segundo parâmetro (`options`) com:
+
+- `locale` (padrão: `'pt-br'`; aceitos: `en-us` | `pt-br` | `es-mx`)
+- `custom` (padrão: `null`)
+
+Parâmetros aceitos em `custom`:
+
+- `colors.buttonTextColor`: `string` (cor em HEX, ex: `#ffffff`)
+- `colors.buttonBackgroundColor`: `string` (cor em HEX, ex: `#000000`)
+
+Schema de `custom`:
+
+```javascript
+{
+  colors: {
+    buttonTextColor: string, // ex: '#ffffff'
+    buttonBackgroundColor: string // ex: '#000000'
+  }
+}
+```
+
+Exemplo com `locale` e `custom`:
+
+```javascript
+const transaction = new Verify('d973213c-6411-11e8-8df5-7cd1c3e91b23', {
+  locale: 'en-US',
+  custom: {
+    colors: {
+      buttonTextColor: '#ffffff',
+      buttonBackgroundColor: '#000000'
+    }
+  }
+});
+```
+
+#### Eventos `success` e `failed`
+
+Os eventos `success` e `failed` retornam um JWT (string).
+
+Exemplo do evento `success` (JWT decodificado):
+
+```javascript
+{
+  authentication: 'Liveness',
+  evidences: [
+    {
+      url: 'http://.../verify-evidences/evidences/2026/02/26/e3da3762-4c50-4b60-9396-c8df15dc4619.png'
+    }
+  ],
+  exp: 1772139169,
+  iat: 1772135569,
+  is_valid: true,
+  transaction: {
+    id: '72849611-079a-40e1-b92e-2a89f4148d6a',
+    state: 'succeed'
+  }
+}
+```
+
+Exemplo do evento `failed` (JWT decodificado):
+
+```javascript
+{
+  authentication: 'Liveness',
+  evidences: [
+    {
+      url: 'http://.../verify-evidences/evidences/2026/02/26/e3da3762-4c50-4b60-9396-c8df15dc4619.png'
+    }
+  ],
+  exp: 1772139169,
+  iat: 1772135569,
+  is_valid: false,
+  transaction: {
+    id: '72849611-079a-40e1-b92e-2a89f4148d6a',
+    state: 'failed'
+  }
+}
+```
+
+#### Evento `error`
+
+O evento `error` retorna detalhes de falha durante a autenticação:
+
+```javascript
+{
+  code: 'CameraPermissionDenied' | 'LivenessError',
+  details: {
+    message: string
+  }
+}
+```
+
+Exemplo:
+
+```javascript
+{
+  code: 'CameraPermissionDenied',
+  details: {
+    message: 'Usuário negou acesso à câmera'
+  }
+}
+```
+
+Para desmontar o `iframe` da DOM:
+
+```javascript
+transaction.unmount();
+```
+
 ## Como contribuir
 
-Os testes estão escritos utilizando Jasmine Browser e estão automatizados pelo
-Gulp.  Basta instalar as dependências com `npm install` e `gulp` para testar e
-`gulp build` para compilar.
+Instale as dependencias com `pnpm install`.
+
+Builds disponiveis:
+
+- `pnpm run build:v1`
+- `pnpm run build:v2`
+- `pnpm run build:v3`
 
 ## Suporte
 

package.json

@@ -5,12 +5,16 @@
   "engines": {
     "node": "^18.18.0"
   },
+  "packageManager": "pnpm@10.29.3",
   "devDependencies": {
     "esbuild": "^0.27.3"
   },
   "scripts": {
     "build:v1": "esbuild packages/v1/src/embedded.js --minify --outdir=build",
-    "build:v2": "esbuild packages/v2/index.js --bundle --sourcemap --minify --keep-names --target=safari15 --outfile=build/v2/embedded.js"
+    "build:v2": "esbuild packages/v2/index.js --bundle --sourcemap --minify --keep-names --target=safari15 --outfile=build/v2/embedded.js",
+    "build:v3:sign": "esbuild packages/v3/index.js --bundle --sourcemap --minify --keep-names --target=safari15 --outfile=build/v3/embedded.js",
+    "build:v3:verify": "esbuild packages/v3/verify.js --bundle --sourcemap --minify --keep-names --target=safari15 --outfile=build/v3/verify.js",
+    "build:v3": "pnpm run build:v3:sign && pnpm run build:v3:verify"
   },
   "repository": {
     "type": "git",

packages/v3/.eslintrc.js

@@ -0,0 +1,41 @@
+module.exports = {
+  env: {
+    browser: true,
+    es2021: true,
+  },
+  extends: [
+    'eslint:recommended',
+    'airbnb-base',
+  ],
+  overrides: [
+    {
+      env: {
+        node: true,
+      },
+      files: ['.eslintrc.{js,cjs}'],
+      parserOptions: {
+        sourceType: 'script',
+      },
+    },
+    {
+      files: ['src/**/*.spec.js'],
+      globals: {
+        describe: 'readonly',
+        it: 'readonly',
+        test: 'readonly',
+        expect: 'readonly',
+        beforeEach: 'readonly',
+        afterEach: 'readonly',
+        beforeAll: 'readonly',
+        afterAll: 'readonly',
+        vi: 'readonly',
+      },
+    },
+  ],
+  parserOptions: {
+    ecmaVersion: 'latest',
+    sourceType: 'module',
+  },
+  rules: {},
+  plugins: ['vitest'],
+};

packages/v3/index.js

@@ -0,0 +1,5 @@
+import Clicksign from './src/signature/embedded';
+
+globalThis.Clicksign = Clicksign;
+
+export default Clicksign;

packages/v3/package.json

@@ -0,0 +1,22 @@
+{
+  "name": "@clicksign/embedded",
+  "license": "MIT",
+  "version": "3.0.0",
+  "engines": {
+    "node": "^18.18.0"
+  },
+  "packageManager": "pnpm@10.29.3",
+  "main": "index.js",
+  "scripts": {
+    "test": "vitest run --config vitest.config.mjs",
+    "lint": "eslint \"src/**/*.js\""
+  },
+  "devDependencies": {
+    "eslint": "^8.57.0",
+    "eslint-config-airbnb-base": "^15.0.0",
+    "eslint-plugin-import": "^2.31.0",
+    "eslint-plugin-vitest": "^0.5.4",
+    "jsdom": "^26.1.0",
+    "vitest": "^2.1.9"
+  }
+}