etiquetas.js 1.0.0-alpha.2 → 1.0.0-alpha.20

package/README.md

@@ -1,171 +1,130 @@
-# 🏷️ 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 '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 pdfPeca = await etiquetas.makePartLabel(dadosPeca, '<id-etiqueta>');
-
-// Download ou impressão
-await etiquetas.downloadPDF(pdfPeca, '<nome-etiqueta>.pdf');
-// ou
-await etiquetas.sendToPrinter(pdfPeca);
-```
-
-## 🔄 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({
-  PROJETO_ID: 123,
-  NOME_PROJETO: 'Sistema Antigo',
-  STATUS: 'ATIVO'
-}, '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>',
+  baseURL: 'https://api.exemplo.com' // OBRIGATÓRIO: URL base da API
+});
+```
+
+## 📚 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({
+  token: '<jwt-token>', // Token JWT para autenticação
+  baseURL: 'https://api.exemplo.com', // URL base da API (OBRIGATÓRIO)
+  autoConnectPrinter: true, // Auto-conectar ao SSE da impressora (padrão: true)
+  defaultTransformer: { // Configuração do transformer (opcional)
+    fieldMap: 'legacy' // Opções: 'legacy', 'custom', 'none'
+  }
+});
+
+
+// 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,39 +1,39 @@
-import { a1, a, j, L, b, N, M, Q, P, a7, F, H, K, U, V, k, T, a9, E, I, y, S, W, B, l, a8, a0, Y, a4, a5, o, h, aa, $, d, n, p, v, e, f, i, t, r, a3, C, D, q, G, w, Z, a6, O, s, R, x, z, J, X, a2, u, m, A } from "./index-BmMBOPX1.js";
+import { a3, b, j, L, N, M, R, U, Q, a9, F, H, K, W, X, k, V, ab, E, I, y, T, Y, B, l, aa, a2, $, a6, a7, o, h, ac, a1, d, n, p, v, e, f, i, t, r, a5, C, D, q, G, w, a0, a8, P, s, S, x, O, z, J, Z, a4, u, m, A } from "./index-DC5U961t.js";
 export {
-  a1 as DEFAULT_LAMINATION_COLORS,
-  a as LABEL_TYPES,
+  a3 as DEFAULT_LAMINATION_COLORS,
+  b as LABEL_TYPES,
   j as LabelWorker,
   L as LabelsAPI,
-  b as apiClient,
   N as base64Decode,
   M as base64Encode,
-  Q as checkPrinterAvailability,
-  P as convertPdfToImages,
-  a7 as convertSVGTableToAutoTableData,
+  R as checkPrinterAvailability,
+  U as convertPdfFileToArrayBuffer,
+  Q as convertPdfToImages,
+  a9 as convertSVGTableToAutoTableData,
   F as createBrowserCanvas,
   H as createBrowserDOM,
   K as createBuffer,
-  U as createImage,
-  V as createImageFromPart,
+  W as createImage,
+  X as createImageFromPart,
   k as createLabelWorker,
-  T as createMiniSheet,
-  a9 as dataTypeList,
+  V as createMiniSheet,
+  ab as dataTypeList,
   E as default,
   I as downloadFile,
   y as downloadPDF,
-  S as downloadPdfFallback,
-  W as drawRect,
+  T as downloadPdfFallback,
+  Y as drawRect,
   B as etiquetas,
   l as generateLabelsFromHookData,
-  a8 as generateTableSVG,
-  a0 as getAspectRatio,
-  Y as getBorderColor,
-  a4 as getImagesFromUrl,
-  a5 as getImagesFromUrlToBase64,
+  aa as generateTableSVG,
+  a2 as getAspectRatio,
+  $ as getBorderColor,
+  a6 as getImagesFromUrl,
+  a7 as getImagesFromUrlToBase64,
   o as getInputForLabels,
   h as getInputLabels,
-  aa as getInputsByCategory,
-  $ as getNode,
+  ac as getInputsByCategory,
+  a1 as getNode,
   d as getPartLabels,
   n as getPartsForLabels,
   p as getPartsFromProjectToLabels,
@@ -43,22 +43,23 @@ export {
   i as getVolumeLabels,
   t as init,
   r as initialState,
-  a3 as initializeBrowserEnvironment,
+  a5 as initializeBrowserEnvironment,
   C as isBrowser,
   D as isNodeJS,
   q as labelTypeNames,
   G as loadImageBrowser,
   w as makeLabel,
-  Z as makeLamination,
-  a6 as mmToPx,
-  O as processLabelForParts,
+  a0 as makeLamination,
+  a8 as mmToPx,
+  P as processLabelForParts,
   s as reducer,
-  R as sendImagesToPrinter,
+  S as sendImagesToPrinter,
   x as sendLabel,
+  O as sendPdfFileToPrinter,
   z as sendToPrinter,
   J as serializeXML,
-  X as setBorder,
-  a2 as stopCreatingLabels,
+  Z as setBorder,
+  a4 as stopCreatingLabels,
   u as useLabelData,
   m as useLabelStore,
   A as validateLabelData