@meuecommerce/frete-adapter-node 0.1.0 → 0.2.0

package/dist/index.d.ts

@@ -10,3 +10,5 @@ export { InMemorySettingsStore } from "./inMemorySettingsStore.js";
 export type { InMemorySettingsStoreOptions } from "./inMemorySettingsStore.js";
 export { EnvSecretStore } from "./envSecretStore.js";
 export type { EnvSecretStoreOptions } from "./envSecretStore.js";
+export { createOpenAIDimensionEstimator } from "./openAIDimensionEstimator.js";
+export type { OpenAIDimensionEstimatorOptions } from "./openAIDimensionEstimator.js";

package/dist/index.js

@@ -7,3 +7,4 @@
 export { createCorreiosHttpClient } from "./correiosHttpClient.js";
 export { InMemorySettingsStore } from "./inMemorySettingsStore.js";
 export { EnvSecretStore } from "./envSecretStore.js";
+export { createOpenAIDimensionEstimator } from "./openAIDimensionEstimator.js";

package/dist/openAIDimensionEstimator.d.ts

@@ -0,0 +1,24 @@
+/**
+ * `ProductDimensionEstimator` implemented with the OpenAI chat-completions API.
+ *
+ * Ports the dimension-estimation path from the Velo `openAI/` modules:
+ * - `ai-tools.js`      -> the `estimate_dimensions` tool + request/response handling
+ * - `prompt-methods.js`-> `createDimensionEstimationPrompt`
+ * - `box-methods.js`   -> `validateAndOptimizeDimensions` (post-process AI output)
+ *
+ * `fetch` is injectable (defaults to global fetch) so this also runs under Velo
+ * with `wix-fetch` passed in. The API key is passed in — the caller resolves it
+ * (e.g. via a `SecretStore`), keeping secret handling out of this module.
+ */
+import type { ProductDimensionEstimator } from "@meuecommerce/frete";
+type FetchLike = typeof globalThis.fetch;
+export interface OpenAIDimensionEstimatorOptions {
+    apiKey: string;
+    fetch?: FetchLike;
+    model?: string;
+    temperature?: number;
+    apiUrl?: string;
+    timeoutMs?: number;
+}
+export declare function createOpenAIDimensionEstimator(options: OpenAIDimensionEstimatorOptions): ProductDimensionEstimator;
+export {};

package/dist/openAIDimensionEstimator.js

@@ -0,0 +1,127 @@
+const ESTIMATE_DIMENSIONS_TOOL = {
+    type: "function",
+    function: {
+        name: "estimate_dimensions",
+        description: "Estima dimensões de produtos PRESERVANDO os nomes exatos fornecidos",
+        parameters: {
+            type: "object",
+            properties: {
+                products: {
+                    type: "array",
+                    items: {
+                        type: "object",
+                        properties: {
+                            name: { type: "string" },
+                            length: { type: "number", description: "Comprimento em cm" },
+                            width: { type: "number", description: "Largura em cm" },
+                            height: { type: "number", description: "Altura em cm" },
+                        },
+                        required: ["name", "length", "width", "height"],
+                    },
+                },
+            },
+            required: ["products"],
+        },
+    },
+};
+function largestBox(boxes) {
+    return boxes.reduce((largest, current) => current.width * current.height * current.length > largest.width * largest.height * largest.length ? current : largest);
+}
+function createPrompt(products, boxes, samples) {
+    const box = largestBox(boxes);
+    const maxWidth = Math.floor(box.width * 0.8);
+    const maxHeight = Math.floor(box.height * 0.8);
+    const maxLength = Math.floor(box.length * 0.8);
+    const samplesSection = samples.length > 0
+        ? `\n🌟 EXEMPLOS DO USUÁRIO (PRIORIDADE MÁXIMA):\n${samples.map((s, i) => `${i + 1}. ${s}`).join("\n")}\n\n` +
+            `📋 INSTRUÇÕES:\n1. Para cada produto, procure um exemplo similar acima\n2. Match exato → use dimensões EXATAS\n3. Similar → ajuste\n4. Sem match → conhecimento geral\n`
+        : `\n📋 INSTRUÇÕES (SEM EXEMPLOS):\n1. Considere a embalagem comercial típica brasileira\n2. Use conhecimento sobre produtos similares\n3. Ajuste baseado no peso\n`;
+    return (`Você é um especialista em dimensões de produtos brasileiros para e-commerce.\n\n` +
+        `🚨 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⚠️ REGRAS: respeite os limites; preserve os nomes EXATOS; retorne length×width×height em cm.\n` +
+        `Responda usando a função 'estimate_dimensions'.`);
+}
+/** Apply the largest-box physical limits + a minimum-volume floor to AI output. */
+function validateAndOptimize(aiResult, products, boxes) {
+    const box = largestBox(boxes);
+    const maxWidth = Math.floor(box.width * 0.8);
+    const maxHeight = Math.floor(box.height * 0.8);
+    const maxLength = Math.floor(box.length * 0.8);
+    const optimized = aiResult.products.map((product) => {
+        let { length, width, height } = product;
+        if (length > maxLength)
+            length = maxLength;
+        if (width > maxWidth)
+            width = maxWidth;
+        if (height > maxHeight)
+            height = maxHeight;
+        const volume = length * width * height;
+        const original = products.find((p) => p.name === product.name);
+        const minVolume = (original?.weight || 0.1) * 500;
+        if (volume > 0 && volume < minVolume) {
+            const scale = Math.cbrt(minVolume / volume);
+            length = Math.min(maxLength, length * scale);
+            width = Math.min(maxWidth, width * scale);
+            height = Math.min(maxHeight, height * scale);
+        }
+        return {
+            name: product.name,
+            length: Math.round(length * 10) / 10,
+            width: Math.round(width * 10) / 10,
+            height: Math.round(height * 10) / 10,
+        };
+    });
+    return { products: optimized };
+}
+export function createOpenAIDimensionEstimator(options) {
+    const { apiKey, fetch = globalThis.fetch, model = "gpt-4o-mini", temperature = 0.1, apiUrl = "https://api.openai.com/v1/chat/completions", timeoutMs = 20000, } = options;
+    if (!apiKey)
+        throw new Error("createOpenAIDimensionEstimator: apiKey is required");
+    if (typeof fetch !== "function")
+        throw new Error("createOpenAIDimensionEstimator: no fetch available");
+    return {
+        async estimate(products, boxes, productSamples = []) {
+            if (!boxes.length)
+                throw new Error("estimate: no boxes provided");
+            const body = {
+                model,
+                messages: [
+                    {
+                        role: "system",
+                        content: "Você é um especialista em dimensões de produtos. Use os exemplos personalizados como prioridade máxima quando o nome bater.",
+                    },
+                    { role: "user", content: createPrompt(products, boxes, productSamples) },
+                ],
+                tools: [ESTIMATE_DIMENSIONS_TOOL],
+                tool_choice: { type: "function", function: { name: "estimate_dimensions" } },
+                temperature,
+            };
+            const controller = new AbortController();
+            const timer = setTimeout(() => controller.abort(), timeoutMs);
+            let response;
+            try {
+                response = await fetch(apiUrl, {
+                    method: "POST",
+                    headers: { Authorization: `Bearer ${apiKey}`, "Content-Type": "application/json" },
+                    body: JSON.stringify(body),
+                    signal: controller.signal,
+                });
+            }
+            finally {
+                clearTimeout(timer);
+            }
+            if (!response.ok)
+                throw new Error(`OpenAI API Error: ${response.status} ${response.statusText}`);
+            const json = (await response.json());
+            if (json.error)
+                throw new Error(`OpenAI Error: ${json.error.message}`);
+            const args = json.choices?.[0]?.message?.tool_calls?.[0]?.function?.arguments;
+            if (!args)
+                throw new Error("IA não conseguiu estimar dimensões dos produtos");
+            const parsed = JSON.parse(args);
+            return validateAndOptimize(parsed, products, boxes);
+        },
+    };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@meuecommerce/frete-adapter-node",
-  "version": "0.1.0",
+  "version": "0.2.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/index.js",
@@ -11,12 +11,15 @@
       "import": "./dist/index.js"
     }
   },
-  "files": ["dist"],
+  "files": [
+    "dist"
+  ],
   "engines": {
     "node": ">=18.18"
   },
   "scripts": {
     "build": "tsc -p tsconfig.json",
+    "prepublishOnly": "npm run build",
     "typecheck": "tsc --noEmit",
     "test": "vitest run",
     "test:watch": "vitest"
@@ -26,6 +29,6 @@
     "access": "public"
   },
   "dependencies": {
-    "@meuecommerce/frete": "^0.1.0"
+    "@meuecommerce/frete": "^0.2.0"
   }
 }