etiquetas.js 1.0.0-alpha.1 → 1.0.0-alpha.3

package/README.md

@@ -9,6 +9,7 @@ Sistema completo para geração de etiquetas de peças, tamponamentos, insumos,
 - 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
 
@@ -19,20 +20,156 @@ npm install etiquetas.js
 ## ⚙️ Uso Básico
 
 ```javascript
-import { etiquetas } from 'etiquetas.js';
+import etiquetas from './src/etiquetas.js';
 
-// Inicializar o sistema
+// 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>');
+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(pdfPeca, '<nome-etiqueta>.pdf');
+await etiquetas.downloadPDF(pdfBuffer, '<nome-etiqueta>.pdf');
 // ou
-await etiquetas.sendToPrinter(pdfPeca);
+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)
+
 

package/dist/etiquetas.es.js

@@ -0,0 +1,66 @@
+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-BkmabrFq.js";
+export {
+  a1 as DEFAULT_LAMINATION_COLORS,
+  a 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,
+  F as createBrowserCanvas,
+  H as createBrowserDOM,
+  K as createBuffer,
+  U as createImage,
+  V as createImageFromPart,
+  k as createLabelWorker,
+  T as createMiniSheet,
+  a9 as dataTypeList,
+  E as default,
+  I as downloadFile,
+  y as downloadPDF,
+  S as downloadPdfFallback,
+  W as drawRect,
+  B as etiquetas,
+  l as generateLabelsFromHookData,
+  a8 as generateTableSVG,
+  a0 as getAspectRatio,
+  Y as getBorderColor,
+  a4 as getImagesFromUrl,
+  a5 as getImagesFromUrlToBase64,
+  o as getInputForLabels,
+  h as getInputLabels,
+  aa as getInputsByCategory,
+  $ as getNode,
+  d as getPartLabels,
+  n as getPartsForLabels,
+  p as getPartsFromProjectToLabels,
+  v as getPrinterStatus,
+  e as getScrapLabels,
+  f as getThickenedLabels,
+  i as getVolumeLabels,
+  t as init,
+  r as initialState,
+  a3 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,
+  s as reducer,
+  R as sendImagesToPrinter,
+  x as sendLabel,
+  z as sendToPrinter,
+  J as serializeXML,
+  X as setBorder,
+  a2 as stopCreatingLabels,
+  u as useLabelData,
+  m as useLabelStore,
+  A as validateLabelData
+};
+//# sourceMappingURL=etiquetas.es.js.map

package/dist/etiquetas.es.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"etiquetas.es.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}