etiquetas.js 1.0.0-alpha.7 → 1.0.0-alpha.9

package/README.md

@@ -1,175 +1,122 @@
-# 🏷️ Sistema de Etiquetas - Etiquetas.js
-
-Sistema completo para geração de etiquetas de peças, tamponamentos, insumos, retalhos e volumes com suporte a impressão e download de PDFs.
-
-## 📋 Recursos Principais
-
-- Geração de 5 tipos de etiquetas: Peças, Tamponamentos, Insumos, Retalhos e Volumes
-- Suporte para impressão direta
-- Download em formato PDF
-- Templates personalizáveis
-- Integração com API para busca de modelos de etiquetas
-- **🔄 Legacy Transformer** - Sistema de transformação de dados legados
-
-## 🚀 Instalação
-
-```bash
-npm install etiquetas.js
-```
-
-## ⚙️ Uso Básico
-
-```javascript
-import etiquetas from './src/etiquetas.js';
-
-// Inicializar o sistema com seu token JWT para autenticação na API
-etiquetas.init({
-  token:'<jwt-token>'
-});
-
-// Gerar etiqueta de peça
-const pdfBuffer = await etiquetas.makeLabel(labelData, '<id-etiqueta>',options);
-//Gerar e enviar para impressora, caso a impressora não esteja disponível o arquivo é baixado automaticamente
-await etiquetas.sendLabel(labelData, '<id-etiqueta>',{
-  fileName:<nome-do-arquivo>
-});
-
-// Download ou impressão
-await etiquetas.downloadPDF(pdfBuffer, '<nome-etiqueta>.pdf');
-// ou
-await etiquetas.sendToPrinter(pdfBuffer);
-```
-
-## 🔄 Legacy Transformer
-
-O sistema de transformação de dados legados permite converter dados antigos para o formato atual das etiquetas. **O transformer padrão é configurado na função `init()`** e será aplicado automaticamente em todas as operações.
-
-### Configuração no Init
-
-```javascript
-import etiquetas from './src/etiquetas.js';
-
-// Inicializar com legacy transformer (padrão)
-etiquetas.init({
-  token: 'your-token',
-  // defaultTransformer não especificado = legacy por padrão
-});
-
-// Inicializar com transformer customizado como padrão
-etiquetas.init({
-  token: 'your-token',
-  defaultTransformer: {
-    fieldMap: 'custom',
-    fieldMapSource: {
-      old_field: 'new_field',
-      status: ['active', 'inactive', 'pending']
-    }
-  }
-});
-
-// Inicializar sem transformer (desabilitado)
-etiquetas.init({
-  token: 'your-token',
-  defaultTransformer: {
-    fieldMap: 'none'
-  }
-});
-```
-
-### Uso Básico (Usa Padrão do Init)
-
-```javascript
-// O transformer configurado no init será aplicado automaticamente
-const pdf = await etiquetas.makeLabel({
-  VARIAVEL1: 123,
-  VARIAVEL2: '12345',
-
-}, 'template-id');
-
-// Também funciona com sendLabel
-const result = await etiquetas.sendLabel(legacyData, 'template-id');
-```
-
-### Sobrescrever Transformer Padrão
-
-```javascript
-// Sobrescrever para usar legacy transformer
-const pdf = await etiquetas.makeLabel(legacyData, 'template-id', {
-  transformer: {
-    fieldMap: "legacy"
-  }
-});
-
-// Sobrescrever para usar fieldMap customizado
-const customFieldMap = {
-  // Mapeamento simples
-  OLD_FIELD: 'newField',
-  
-  // Mapeamento com array de valores
-  STATUS: ['active', 'inactive', 'pending'],
-  
-  // Transformação com função
-  CUSTOM_CODE: (data) => data.code ? `NEW_${data.code}` : null
-};
-
-const pdf = await etiquetas.makeLabel(legacyData, 'template-id', {
-  transformer: {
-    fieldMap: "custom",
-    fieldMapSource: customFieldMap
-  }
-});
-
-// Sobrescrever para desabilitar transformer
-const pdf = await etiquetas.makeLabel(normalizedData, 'template-id', {
-  transformer: {
-    fieldMap: "none"
-  }
-});
-```
-
-### Opções do Init
-
-| Opção | Tipo | Descrição |
-|-------|------|-----------|
-| `defaultTransformer.fieldMap` | string | Tipo do fieldMap padrão: `"legacy"` (padrão), `"custom"` ou `"none"` |
-| `defaultTransformer.fieldMapSource` | Object | FieldMap customizado (obrigatório se `fieldMap="custom"`) |
-
-### Opções das Funções (Sobrescrever Padrão)
-
-| Opção | Tipo | Descrição |
-|-------|------|-----------|
-| `transformer.fieldMap` | string | Tipo do fieldMap: `"legacy"`, `"custom"` ou `"none"` (sobrescreve padrão do init) |
-| `transformer.fieldMapSource` | Object | FieldMap customizado (obrigatório se `fieldMap="custom"`) |
-
-### API Legacy (Deprecated)
-
-```javascript
-// ⚠️ API antiga - ainda funciona mas está deprecated
-const pdf = await etiquetas.makeLabel(legacyData, 'template-id', {
-  useLegacyTransformer: true,
-  customFieldMap: myFieldMap
-});
-```
-
-### Validação e Tratamento de Erros
-
-```javascript
-// Validar fieldMap antes de usar
-const isValid = etiquetas.validateFieldMap(myFieldMap);
-
-// Tratamento de erros
-try {
-  const pdf = await etiquetas.makeLabel(legacyData, 'template-id', {
-    transformer: {
-      fieldMap: "custom",
-      fieldMapSource: invalidFieldMap
-    }
-  });
-} catch (error) {
-  console.error('Erro na transformação:', error.message);
-}
-```
-
-Para documentação completa sobre transformações, consulte: [src/transformers/README.md](src/transformers/README.md)
-
-
+# 🏷️ Sistema de Etiquetas - Etiquetas.js
+
+Sistema completo para geração de etiquetas de peças, tamponamentos, insumos, retalhos e volumes com suporte a impressão e download de PDFs.
+
+
+
+## 🚀 Instalação
+
+```bash
+npm install etiquetas.js
+```
+
+## ⚙️ Configuração Inicial
+
+```javascript
+import etiquetas from 'etiquetas.js';
+
+// Inicializar o sistema
+etiquetas.init({
+  token: '<jwt-token>'
+});
+```
+
+## 📚 API Principal
+    <jwt-token> é utilizado como authorization na api dinabox para obter os templates de etiqueta
+### Inicialização e Configuração
+
+```javascript
+// Inicializar sistema
+etiquetas.init(config);
+
+
+// Verificar status da impressora
+const status = await etiquetas.getPrinterStatus();
+```
+
+### Geração de Etiquetas
+
+const labelData = [{variableProps: {
+
+
+```javascript
+// Gerar etiqueta de peça
+[{
+  <all-variables>
+}, specialProps: {
+  <all-specialprops>
+}] 
+O tamanho do array de labelData é a quantidade de etiquetas que serão geradas. Os dados   <all-variables> e <all-specialprops>
+
+const pdfPeca = await etiquetas.makeLabel({variableProps: {
+  PROJETO_ID:123
+
+},specialProps: {
+  lamination: {
+    
+    material_id:"123",
+    edges: {
+      left_id:"123",
+      right_id:null,
+      bottom_id:"123",
+      top_id:"245"
+    }
+    
+  },
+  
+  }
+}}, <label-id>);
+```
+
+### Saída e Impressão
+
+
+
+```javascript
+// Download de PDF
+await etiquetas.downloadPDF(pdfBuffer, 'etiqueta.pdf');
+
+// Enviar para impressora
+await etiquetas.sendToPrinter(pdfBuffer);
+
+// Envio inteligente (imprime se conectado, senão faz download)
+await etiquetas.sendLabel(labelData, <label-id>);
+
+```
+
+## 🎨 Templates
+
+### Templates Disponíveis
+Utilizando a API das labels busque o ID do template
+
+Cada arquivo contém a definição de variáveis e propriedades especiais que podem ser usadas na geração das etiquetas correspondentes.
+
+## 📑 Variáveis e SpecialProps dos Templates
+
+Abaixo estão listadas todas as variáveis (`variableProps`) e propriedades especiais (`specialProps`) disponíveis para uso em qualquer template de etiqueta. Use-as conforme o tipo de etiqueta desejado.
+
+### Lista universal de variableProps
+
+- {{PROJETO_NOME}}, {{PROJETO_ID}}, {{LOTE_ID}}, {{CLIENTE_NOME}}, {{MODULO_NOME}}, {{MODULO_QTD}}, {{MODULO_REF}}, {{MODULO_OBS}}, {{PECA_ID}}, {{PECA_CODIGO}}, {{PECA_REF}}, {{PECA_INDICE}}, {{PECA_INDICE2}}, {{PECA_NOME}}, {{PECA_OBS}}, {{LARGURA}}, {{ALTURA}}, {{ESPESSURA}}, {{MN}}, {{MA}}, {{ML}}, {{FURO_A}}, {{FURO_A2}}, {{FURO_B}}, {{FURO_B2}}, {{FE}}, {{FD}}, {{FS}}, {{FI}}, {{PECA_TIPO}}, {{MATERIAL_NOME}}, {{TAMPONAMENTO_ID}}, {{TAMPONAMENTO_REF}}, {{TAMPONAMENTO_QT}}, {{TAMPONAMENTO_PESO}}, {{TAMPONAMENTO_NOME}}, {{INSUMO_NOME}}, {{INSUMO_ID}}, {{INSUMO_DIMENSOES}}, {{INSUMO_QTD}}, {{INSUMO_PESO}}, {{INSUMO_REF}}, {{INSUMO_MARCA}}, {{INSUMO_CATEGORIA}}, {{INSUMO_FABRICANTE}}, {{RETALHO_ID}}, {{DATA_CRIACAO}}, {{RETALHO_INDICE}}, {{LADO_USINAGEM}}, {{RETALHO_NOME}}, {{RETALHO_QT}}, {{RETALHO_PESO}}, {{RETALHO_DIMENSOES}}, {{RETALHO_MATERIAL}}, {{RETALHO_ORIGEM}}, {{CODIGO_A}}, {{CODIGO_B}}, {{FURO_A_SD}}, {{FURO_B_SD}}, {{FURO_TOPO}}, {{VOLUME_ID}}, {{VOLUME_NOME}}, {{VOLUME_PESO}}, {{VOLUME_DATA}}, {{VOLUME_DESCRICAO}}, {{VOLUME_PECAS}}, {{VOLUME_DIMENSOES}}
+
+> **Observação:** Você pode usar qualquer combinação dessas variáveis em qualquer template, desde que o template utilize o campo correspondente.
+
+---
+
+### Lista universal de specialProps
+
+- **rect**: Retângulo. Dados necessários: já vem no template.
+- **lamination**: Desenha bordas de laminação conforme materiais. Dados necessários: informações de borda e material (edge_left_id, material_id, etc).
+- **enhancedLamination**: Laminação detalhada, com indicação visual de materiais e furos. Dados necessários: dados de peça, bordas e furos (holes_diagram, width, height, etc).
+- **identifierByProject**: Gera um identificador visual (preto e branco) para o projeto. Dados necessários: project_id, numberByProject.
+- **colorfulIdentifierByProject**: Igual ao anterior, mas colorido. Dados necessários: project_id, numberByProject, color.
+- **barCode**: Gera um código de barras. Dados necessários: código a ser convertido (originBarcode, customBarcode, code_a, code_b, etc).
+- **miniSheet**: Miniatura da chapa. Dados necessários: lista de partes (parts), dimensões da chapa (height, width).
+- **miniPartA**: Miniatura da peça (lado A). Dados necessários: dados da peça (width, height, index).
+- **miniPartB**: Miniatura da peça (lado B). Dados necessários: dados da peça (width, height, index).
+- **Image**: Imagem. Dados necessários: já vem no template.
+- **text**: Texto estático. Dados necessários: já vem no template.
+- **volumeContent**: Gera uma tabela de itens do volume. Dados necessários: itemList (array de itens do volume).
+
+> **Observação:** Você pode usar qualquer combinação dessas specialProps em qualquer template, desde que o template utilize o campo correspondente.
+

package/dist/etiquetas.es.js

@@ -1,4 +1,4 @@
-import { a0, L, h, q, M, K, P, O, a6, D, G, J, T, U, i, S, a8, E, H, x, R, V, A, j, a7, $, X, a3, a4, m, e, a9, Z, a, l, n, t, b, d, f, s, p, a2, B, C, o, F, v, Y, a5, N, r, Q, w, y, I, W, a1, u, k, z } from "./index-Tvy8FVsM.js";
+import { a0, L, h, q, M, K, P, O, a6, D, G, J, T, U, i, S, a8, E, H, x, R, V, A, j, a7, $, X, a3, a4, m, e, a9, Z, a, l, n, t, b, d, f, s, p, a2, B, C, o, F, v, Y, a5, N, r, Q, w, y, I, W, a1, u, k, z } from "./index-Br1zbFfm.js";
 export {
   a0 as DEFAULT_LAMINATION_COLORS,
   L as LABEL_TYPES,