@meuecommerce/frete-adapter-node 0.8.1 → 0.9.0

package/dist/cjs/openAIDimensionEstimator.js

@@ -8,7 +8,7 @@ const openAIResponsesAgentRunner_js_1 = require("./openAIResponsesAgentRunner.js
  * `L3` record so a prompt change can invalidate stale estimates in background
  * instead of at checkout.
  */
-exports.DIMENSION_PROMPT_VERSION = "2026-09-04.responses.v1";
+exports.DIMENSION_PROMPT_VERSION = "2026-09-11.responses.v2-atributos";
 /**
  * Strict JSON schema for the response.
  *
@@ -29,8 +29,20 @@ const DIMENSIONS_SCHEMA = {
                     length: { type: "number", description: "Comprimento em cm" },
                     width: { type: "number", description: "Largura em cm" },
                     height: { type: "number", description: "Altura em cm" },
+                    attrs: {
+                        type: "object",
+                        description: "Como o produto ocupa espaço. Na dúvida, false — cada traço afrouxa o encaixe.",
+                        properties: {
+                            fragile: { type: "boolean", description: "Quebra se receber peso em cima (vidro, cerâmica, ovo)" },
+                            compressible: { type: "boolean", description: "Cede quando espremido (roupa, tecido, espuma, travesseiro)" },
+                            nestable: { type: "boolean", description: "Unidades iguais encaixam uma na outra (tigela, copo, cone, pote)" },
+                            keepUpright: { type: "boolean", description: "Precisa viajar em pé (líquido, bolo, planta)" },
+                        },
+                        required: ["fragile", "compressible", "nestable", "keepUpright"],
+                        additionalProperties: false,
+                    },
                 },
-                required: ["name", "length", "width", "height"],
+                required: ["name", "length", "width", "height", "attrs"],
                 additionalProperties: false,
             },
         },
@@ -54,8 +66,29 @@ function createPrompt(products, boxes, samples) {
         `🚨 LIMITES FÍSICOS OBRIGATÓRIOS:\n- Largura máxima: ${maxWidth}cm\n- Altura máxima: ${maxHeight}cm\n- Comprimento máximo: ${maxLength}cm\n(Maior caixa: ${box.name ?? "—"})\n\n` +
         `📦 PRODUTOS PARA ESTIMAR:\n${products.map((p, i) => `${i + 1}. ${p.name} - ${p.quantity}x (${p.weight}kg cada)`).join("\n")}\n` +
         samplesSection +
+        `\n🧱 COMO O PRODUTO OCUPA ESPAÇO (campo attrs, um por produto):\n` +
+        `- fragile: quebra se levar peso em cima — vidro, cerâmica, garrafa, ovo\n` +
+        `- compressible: cede quando espremido — roupa, tecido, espuma, travesseiro, pelúcia\n` +
+        `- nestable: unidades IGUAIS encaixam uma na outra — tigela, copo, cone, pote, vaso\n` +
+        `- keepUpright: precisa viajar em pé — líquido, tinta, bolo, planta\n` +
+        `Na dúvida responda false. Cada traço afrouxa o encaixe, e afrouxar errado faz o pacote não fechar.\n` +
         `\n⚠️ REGRAS: respeite os limites; preserve os nomes EXATOS; retorne length×width×height em cm.`);
 }
+/**
+ * Só os traços verdadeiros, e nada quando não há nenhum.
+ *
+ * O schema obriga o modelo a responder os quatro booleanos, então quase todo
+ * produto volta com `{fragile:false, compressible:false, ...}`. Guardar isso é
+ * gravar ruído em cada linha da memória e, pior, apagar a diferença entre
+ * "sabemos que é um tijolo" e "não perguntamos" — que é justamente o que o
+ * empacotador precisa distinguir.
+ */
+function attrsVerdadeiros(attrs) {
+    if (!attrs)
+        return null;
+    const so = Object.fromEntries(Object.entries(attrs).filter(([, v]) => v === true));
+    return Object.keys(so).length ? { attrs: so } : null;
+}
 /** Apply the largest-box physical limits + a minimum-volume floor to AI output. */
 function validateAndOptimize(aiResult, products, boxes) {
     const box = largestBox(boxes);
@@ -84,6 +117,7 @@ function validateAndOptimize(aiResult, products, boxes) {
             length: Math.round(length * 10) / 10,
             width: Math.round(width * 10) / 10,
             height: Math.round(height * 10) / 10,
+            ...(attrsVerdadeiros(product.attrs) ?? {}),
         };
     });
     return { products: optimized };

package/dist/openAIDimensionEstimator.d.ts

@@ -25,7 +25,7 @@ type FetchLike = typeof globalThis.fetch;
  * `L3` record so a prompt change can invalidate stale estimates in background
  * instead of at checkout.
  */
-export declare const DIMENSION_PROMPT_VERSION = "2026-09-04.responses.v1";
+export declare const DIMENSION_PROMPT_VERSION = "2026-09-11.responses.v2-atributos";
 export interface OpenAIDimensionEstimatorOptions {
     apiKey?: string;
     fetch?: FetchLike;

package/dist/openAIDimensionEstimator.js

@@ -4,7 +4,7 @@ import { createOpenAIResponsesAgentRunner } from "./openAIResponsesAgentRunner.j
  * `L3` record so a prompt change can invalidate stale estimates in background
  * instead of at checkout.
  */
-export const DIMENSION_PROMPT_VERSION = "2026-09-04.responses.v1";
+export const DIMENSION_PROMPT_VERSION = "2026-09-11.responses.v2-atributos";
 /**
  * Strict JSON schema for the response.
  *
@@ -25,8 +25,20 @@ const DIMENSIONS_SCHEMA = {
                     length: { type: "number", description: "Comprimento em cm" },
                     width: { type: "number", description: "Largura em cm" },
                     height: { type: "number", description: "Altura em cm" },
+                    attrs: {
+                        type: "object",
+                        description: "Como o produto ocupa espaço. Na dúvida, false — cada traço afrouxa o encaixe.",
+                        properties: {
+                            fragile: { type: "boolean", description: "Quebra se receber peso em cima (vidro, cerâmica, ovo)" },
+                            compressible: { type: "boolean", description: "Cede quando espremido (roupa, tecido, espuma, travesseiro)" },
+                            nestable: { type: "boolean", description: "Unidades iguais encaixam uma na outra (tigela, copo, cone, pote)" },
+                            keepUpright: { type: "boolean", description: "Precisa viajar em pé (líquido, bolo, planta)" },
+                        },
+                        required: ["fragile", "compressible", "nestable", "keepUpright"],
+                        additionalProperties: false,
+                    },
                 },
-                required: ["name", "length", "width", "height"],
+                required: ["name", "length", "width", "height", "attrs"],
                 additionalProperties: false,
             },
         },
@@ -50,8 +62,29 @@ function createPrompt(products, boxes, samples) {
         `🚨 LIMITES FÍSICOS OBRIGATÓRIOS:\n- Largura máxima: ${maxWidth}cm\n- Altura máxima: ${maxHeight}cm\n- Comprimento máximo: ${maxLength}cm\n(Maior caixa: ${box.name ?? "—"})\n\n` +
         `📦 PRODUTOS PARA ESTIMAR:\n${products.map((p, i) => `${i + 1}. ${p.name} - ${p.quantity}x (${p.weight}kg cada)`).join("\n")}\n` +
         samplesSection +
+        `\n🧱 COMO O PRODUTO OCUPA ESPAÇO (campo attrs, um por produto):\n` +
+        `- fragile: quebra se levar peso em cima — vidro, cerâmica, garrafa, ovo\n` +
+        `- compressible: cede quando espremido — roupa, tecido, espuma, travesseiro, pelúcia\n` +
+        `- nestable: unidades IGUAIS encaixam uma na outra — tigela, copo, cone, pote, vaso\n` +
+        `- keepUpright: precisa viajar em pé — líquido, tinta, bolo, planta\n` +
+        `Na dúvida responda false. Cada traço afrouxa o encaixe, e afrouxar errado faz o pacote não fechar.\n` +
         `\n⚠️ REGRAS: respeite os limites; preserve os nomes EXATOS; retorne length×width×height em cm.`);
 }
+/**
+ * Só os traços verdadeiros, e nada quando não há nenhum.
+ *
+ * O schema obriga o modelo a responder os quatro booleanos, então quase todo
+ * produto volta com `{fragile:false, compressible:false, ...}`. Guardar isso é
+ * gravar ruído em cada linha da memória e, pior, apagar a diferença entre
+ * "sabemos que é um tijolo" e "não perguntamos" — que é justamente o que o
+ * empacotador precisa distinguir.
+ */
+function attrsVerdadeiros(attrs) {
+    if (!attrs)
+        return null;
+    const so = Object.fromEntries(Object.entries(attrs).filter(([, v]) => v === true));
+    return Object.keys(so).length ? { attrs: so } : null;
+}
 /** Apply the largest-box physical limits + a minimum-volume floor to AI output. */
 function validateAndOptimize(aiResult, products, boxes) {
     const box = largestBox(boxes);
@@ -80,6 +113,7 @@ function validateAndOptimize(aiResult, products, boxes) {
             length: Math.round(length * 10) / 10,
             width: Math.round(width * 10) / 10,
             height: Math.round(height * 10) / 10,
+            ...(attrsVerdadeiros(product.attrs) ?? {}),
         };
     });
     return { products: optimized };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@meuecommerce/frete-adapter-node",
-  "version": "0.8.1",
+  "version": "0.9.0",
   "description": "Node implementation of @meuecommerce/frete ports (Correios HTTP client) using global fetch. Used by the Shopify/Fly deployment and the MCP server.",
   "type": "module",
   "main": "./dist/cjs/index.js",
@@ -31,7 +31,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@meuecommerce/frete": "^0.8.1"
+    "@meuecommerce/frete": "^0.9.0"
   },
   "module": "./dist/index.js",
   "repository": {