@meuecommerce/frete-adapter-node 0.2.1 → 0.3.0

package/dist/cjs/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createOpenAIDimensionEstimator = exports.EnvSecretStore = exports.InMemorySettingsStore = exports.createCorreiosHttpClient = void 0;
+exports.createOpenAIBoxDistributor = exports.createOpenAIDimensionEstimator = exports.EnvSecretStore = exports.InMemorySettingsStore = exports.createCorreiosHttpClient = void 0;
 /**
  * @meuecommerce/frete-adapter-node — Node implementations of @meuecommerce/frete ports.
  *
@@ -15,3 +15,5 @@ var envSecretStore_js_1 = require("./envSecretStore.js");
 Object.defineProperty(exports, "EnvSecretStore", { enumerable: true, get: function () { return envSecretStore_js_1.EnvSecretStore; } });
 var openAIDimensionEstimator_js_1 = require("./openAIDimensionEstimator.js");
 Object.defineProperty(exports, "createOpenAIDimensionEstimator", { enumerable: true, get: function () { return openAIDimensionEstimator_js_1.createOpenAIDimensionEstimator; } });
+var openAIBoxDistributor_js_1 = require("./openAIBoxDistributor.js");
+Object.defineProperty(exports, "createOpenAIBoxDistributor", { enumerable: true, get: function () { return openAIBoxDistributor_js_1.createOpenAIBoxDistributor; } });

package/dist/cjs/openAIBoxDistributor.js

@@ -0,0 +1,125 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createOpenAIBoxDistributor = createOpenAIBoxDistributor;
+/**
+ * `ProductBoxDistributor` implemented with OpenAI — the AI that distributes
+ * products into boxes (a second call from the Velo `openAI/box-methods.js`
+ * `aiDistributeProducts`, tool `distribute_products`).
+ *
+ * Best-effort: `packBoxes` validates the output and falls back to the
+ * deterministic distribution, so a bad/failed call never breaks packing. `fetch`
+ * is injectable (Velo passes `wix-fetch`); the API key is passed in.
+ */
+const frete_1 = require("@meuecommerce/frete");
+const DISTRIBUTE_TOOL = {
+    type: "function",
+    function: {
+        name: "distribute_products",
+        description: "Distribui TODOS os produtos nas quantidades EXATAS - NUNCA perca produtos ou invente nomes",
+        parameters: {
+            type: "object",
+            properties: {
+                boxes: {
+                    type: "array",
+                    items: {
+                        type: "object",
+                        properties: {
+                            box: { type: "string", description: "ID EXATO da caixa - NUNCA invente" },
+                            products: {
+                                type: "array",
+                                items: {
+                                    type: "object",
+                                    properties: { name: { type: "string" }, quantity: { type: "number", minimum: 1 } },
+                                    required: ["name", "quantity"],
+                                },
+                            },
+                            dimensions: {
+                                type: "object",
+                                properties: { width: { type: "number" }, height: { type: "number" }, length: { type: "number" } },
+                                required: ["width", "height", "length"],
+                            },
+                        },
+                        required: ["box", "products", "dimensions"],
+                    },
+                },
+            },
+            required: ["boxes"],
+        },
+    },
+};
+function findByName(name, items) {
+    return items.find((i) => i.name === name);
+}
+function createPrompt(products, boxes, dims) {
+    const totalVolume = dims.products.reduce((total, p) => {
+        const product = findByName(p.name, products);
+        return product ? total + (0, frete_1.calculateVolume)(p.length, p.width, p.height) * product.quantity : total;
+    }, 0);
+    const boxLines = boxes
+        .map((box) => {
+        const cap = (0, frete_1.calculateVolume)(box.width, box.height, box.length);
+        const pct = Math.round((totalVolume / cap) * 100);
+        return `• ${box.id ?? box.name} (${box.name}): ${cap}cm³ — ${pct}% ${pct > 80 ? "❌ REJEITADA" : "✅ APROVADA"}`;
+    })
+        .join("\n");
+    const productLines = dims.products
+        .map((p) => {
+        const product = findByName(p.name, products);
+        if (!product)
+            return `• ${p.name}: não encontrado no carrinho`;
+        const vol = (0, frete_1.calculateVolume)(p.length, p.width, p.height);
+        return `• ${p.name}: ${product.quantity}x — ${p.length}×${p.width}×${p.height}cm — total ${vol * product.quantity}cm³`;
+    })
+        .join("\n");
+    return (`Especialista em logística: distribua TODOS os produtos nas caixas.\n\n` +
+        `REGRA: o volume dos produtos numa caixa não pode passar de 80% da capacidade dela.\n` +
+        `Volume total dos produtos: ${totalVolume}cm³\n\n` +
+        `CAIXAS:\n${boxLines}\n\nPRODUTOS:\n${productLines}\n\n` +
+        `PRIORIDADE ABSOLUTA: menor número de caixas = menor custo. Use 1 caixa quando couber; ` +
+        `só use múltiplas se for matematicamente impossível. Use IDs de caixa EXATOS e preserve os nomes e quantidades.\n` +
+        `Responda usando a função 'distribute_products'.`);
+}
+function createOpenAIBoxDistributor(options) {
+    const { apiKey, fetch = globalThis.fetch, model = "gpt-4o-mini", temperature = 0.5, apiUrl = "https://api.openai.com/v1/chat/completions", timeoutMs = 20000, } = options;
+    if (!apiKey)
+        throw new Error("createOpenAIBoxDistributor: apiKey is required");
+    if (typeof fetch !== "function")
+        throw new Error("createOpenAIBoxDistributor: no fetch available");
+    return {
+        async distribute(products, boxes, estimatedDimensions) {
+            const body = {
+                model,
+                messages: [
+                    { role: "system", content: "Você é um especialista em otimização logística. SEMPRE maximize consolidação e minimize número de caixas." },
+                    { role: "user", content: createPrompt(products, boxes, estimatedDimensions) },
+                ],
+                tools: [DISTRIBUTE_TOOL],
+                tool_choice: { type: "function", function: { name: "distribute_products" } },
+                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 distribuir os produtos");
+            return JSON.parse(args);
+        },
+    };
+}

package/dist/index.d.ts

@@ -12,3 +12,5 @@ export { EnvSecretStore } from "./envSecretStore.js";
 export type { EnvSecretStoreOptions } from "./envSecretStore.js";
 export { createOpenAIDimensionEstimator } from "./openAIDimensionEstimator.js";
 export type { OpenAIDimensionEstimatorOptions } from "./openAIDimensionEstimator.js";
+export { createOpenAIBoxDistributor } from "./openAIBoxDistributor.js";
+export type { OpenAIBoxDistributorOptions } from "./openAIBoxDistributor.js";

package/dist/index.js

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

package/dist/openAIBoxDistributor.d.ts

@@ -0,0 +1,21 @@
+/**
+ * `ProductBoxDistributor` implemented with OpenAI — the AI that distributes
+ * products into boxes (a second call from the Velo `openAI/box-methods.js`
+ * `aiDistributeProducts`, tool `distribute_products`).
+ *
+ * Best-effort: `packBoxes` validates the output and falls back to the
+ * deterministic distribution, so a bad/failed call never breaks packing. `fetch`
+ * is injectable (Velo passes `wix-fetch`); the API key is passed in.
+ */
+import { type ProductBoxDistributor } from "@meuecommerce/frete";
+type FetchLike = typeof globalThis.fetch;
+export interface OpenAIBoxDistributorOptions {
+    apiKey: string;
+    fetch?: FetchLike;
+    model?: string;
+    temperature?: number;
+    apiUrl?: string;
+    timeoutMs?: number;
+}
+export declare function createOpenAIBoxDistributor(options: OpenAIBoxDistributorOptions): ProductBoxDistributor;
+export {};

package/dist/openAIBoxDistributor.js

@@ -0,0 +1,122 @@
+/**
+ * `ProductBoxDistributor` implemented with OpenAI — the AI that distributes
+ * products into boxes (a second call from the Velo `openAI/box-methods.js`
+ * `aiDistributeProducts`, tool `distribute_products`).
+ *
+ * Best-effort: `packBoxes` validates the output and falls back to the
+ * deterministic distribution, so a bad/failed call never breaks packing. `fetch`
+ * is injectable (Velo passes `wix-fetch`); the API key is passed in.
+ */
+import { calculateVolume, } from "@meuecommerce/frete";
+const DISTRIBUTE_TOOL = {
+    type: "function",
+    function: {
+        name: "distribute_products",
+        description: "Distribui TODOS os produtos nas quantidades EXATAS - NUNCA perca produtos ou invente nomes",
+        parameters: {
+            type: "object",
+            properties: {
+                boxes: {
+                    type: "array",
+                    items: {
+                        type: "object",
+                        properties: {
+                            box: { type: "string", description: "ID EXATO da caixa - NUNCA invente" },
+                            products: {
+                                type: "array",
+                                items: {
+                                    type: "object",
+                                    properties: { name: { type: "string" }, quantity: { type: "number", minimum: 1 } },
+                                    required: ["name", "quantity"],
+                                },
+                            },
+                            dimensions: {
+                                type: "object",
+                                properties: { width: { type: "number" }, height: { type: "number" }, length: { type: "number" } },
+                                required: ["width", "height", "length"],
+                            },
+                        },
+                        required: ["box", "products", "dimensions"],
+                    },
+                },
+            },
+            required: ["boxes"],
+        },
+    },
+};
+function findByName(name, items) {
+    return items.find((i) => i.name === name);
+}
+function createPrompt(products, boxes, dims) {
+    const totalVolume = dims.products.reduce((total, p) => {
+        const product = findByName(p.name, products);
+        return product ? total + calculateVolume(p.length, p.width, p.height) * product.quantity : total;
+    }, 0);
+    const boxLines = boxes
+        .map((box) => {
+        const cap = calculateVolume(box.width, box.height, box.length);
+        const pct = Math.round((totalVolume / cap) * 100);
+        return `• ${box.id ?? box.name} (${box.name}): ${cap}cm³ — ${pct}% ${pct > 80 ? "❌ REJEITADA" : "✅ APROVADA"}`;
+    })
+        .join("\n");
+    const productLines = dims.products
+        .map((p) => {
+        const product = findByName(p.name, products);
+        if (!product)
+            return `• ${p.name}: não encontrado no carrinho`;
+        const vol = calculateVolume(p.length, p.width, p.height);
+        return `• ${p.name}: ${product.quantity}x — ${p.length}×${p.width}×${p.height}cm — total ${vol * product.quantity}cm³`;
+    })
+        .join("\n");
+    return (`Especialista em logística: distribua TODOS os produtos nas caixas.\n\n` +
+        `REGRA: o volume dos produtos numa caixa não pode passar de 80% da capacidade dela.\n` +
+        `Volume total dos produtos: ${totalVolume}cm³\n\n` +
+        `CAIXAS:\n${boxLines}\n\nPRODUTOS:\n${productLines}\n\n` +
+        `PRIORIDADE ABSOLUTA: menor número de caixas = menor custo. Use 1 caixa quando couber; ` +
+        `só use múltiplas se for matematicamente impossível. Use IDs de caixa EXATOS e preserve os nomes e quantidades.\n` +
+        `Responda usando a função 'distribute_products'.`);
+}
+export function createOpenAIBoxDistributor(options) {
+    const { apiKey, fetch = globalThis.fetch, model = "gpt-4o-mini", temperature = 0.5, apiUrl = "https://api.openai.com/v1/chat/completions", timeoutMs = 20000, } = options;
+    if (!apiKey)
+        throw new Error("createOpenAIBoxDistributor: apiKey is required");
+    if (typeof fetch !== "function")
+        throw new Error("createOpenAIBoxDistributor: no fetch available");
+    return {
+        async distribute(products, boxes, estimatedDimensions) {
+            const body = {
+                model,
+                messages: [
+                    { role: "system", content: "Você é um especialista em otimização logística. SEMPRE maximize consolidação e minimize número de caixas." },
+                    { role: "user", content: createPrompt(products, boxes, estimatedDimensions) },
+                ],
+                tools: [DISTRIBUTE_TOOL],
+                tool_choice: { type: "function", function: { name: "distribute_products" } },
+                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 distribuir os produtos");
+            return JSON.parse(args);
+        },
+    };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@meuecommerce/frete-adapter-node",
-  "version": "0.2.1",
+  "version": "0.3.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.2.0"
+    "@meuecommerce/frete": "^0.3.0"
   },
   "module": "./dist/index.js"
 }