@meuecommerce/frete-adapter-node 0.2.1 → 0.3.1

package/dist/cjs/correiosLabelHttpClient.js

@@ -0,0 +1,115 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createCorreiosLabelHttpClient = createCorreiosLabelHttpClient;
+/**
+ * Node implementation of the `CorreiosLabelClient` port using global `fetch`.
+ *
+ * Mirrors `correiosHttpClient.ts`: same base URL, per-request timeout, and
+ * bounded retry on transient network failures. It stays deliberately thin —
+ * one round-trip per method; the "request PDF then poll" loop lives in the
+ * `generateLabel` use case.
+ *
+ * Endpoints (Correios pré-postagem API):
+ * - `POST /prepostagem/v1/prepostagens`                       — create
+ * - `POST /prepostagem/v1/prepostagens/rotulo/assincrono/pdf` — request async PDF
+ * - `GET  /prepostagem/v1/prepostagens/rotulo/download/assincrono/{idRecibo}` — poll/download
+ *
+ * NOTE: the async download path isn't in the public docs mirror; the default
+ * below is the officially-referenced one and is overridable via `downloadPath`
+ * so it can be corrected against homolog without touching the use case.
+ */
+const frete_1 = require("@meuecommerce/frete");
+const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+function createCorreiosLabelHttpClient(options = {}) {
+    const { fetch = globalThis.fetch, baseUrl = frete_1.correiosApiUrl, timeoutMs = 20000, retries = 2, retryDelayMs = 500, tipoRotulo = "P", downloadPath = "/prepostagem/v1/prepostagens/rotulo/download/assincrono/{idRecibo}", logger = console, } = options;
+    if (typeof fetch !== "function") {
+        throw new Error("createCorreiosLabelHttpClient: no fetch available (Node 18+ or pass options.fetch)");
+    }
+    async function fetchWithRetry(url, init) {
+        let lastError;
+        for (let attempt = 0; attempt < retries; attempt++) {
+            const controller = new AbortController();
+            const timer = setTimeout(() => controller.abort(), timeoutMs);
+            try {
+                return await fetch(url, { ...init, signal: controller.signal });
+            }
+            catch (error) {
+                lastError = error;
+                if (attempt === retries - 1)
+                    break;
+                await sleep(retryDelayMs * Math.pow(2, attempt));
+            }
+            finally {
+                clearTimeout(timer);
+            }
+        }
+        throw lastError;
+    }
+    function authHeaders(token) {
+        return {
+            "Content-Type": "application/json",
+            Accept: "application/json",
+            Authorization: `Bearer ${token}`,
+        };
+    }
+    return {
+        async createPrepostagem(payload, token) {
+            const response = await fetchWithRetry(`${baseUrl}/prepostagem/v1/prepostagens`, {
+                method: "POST",
+                headers: authHeaders(token),
+                body: JSON.stringify(payload),
+            });
+            // Correios returns a structured error body (with the failure reason) on 4xx;
+            // the use case filters by `txErro`, so pass it through rather than throwing.
+            const json = (await response.json().catch(() => ({})));
+            if (response.status !== 200 && response.status !== 201) {
+                logger.warn(`[correios.createPrepostagem] status=${response.status} body=${JSON.stringify(json)}`);
+                if (!json.txErro)
+                    json.txErro = `http_${response.status}`;
+            }
+            return json;
+        },
+        async requestLabelPdf(ids, token) {
+            const response = await fetchWithRetry(`${baseUrl}/prepostagem/v1/prepostagens/rotulo/assincrono/pdf`, {
+                method: "POST",
+                headers: authHeaders(token),
+                body: JSON.stringify({ idsPrePostagem: ids, tipoRotulo }),
+            });
+            const json = (await response.json().catch(() => ({})));
+            if (!json.idRecibo)
+                throw new Error(`requestLabelPdf: no idRecibo (status=${response.status})`);
+            return { idRecibo: json.idRecibo };
+        },
+        async downloadLabelPdf(idRecibo, token) {
+            const path = downloadPath.replace("{idRecibo}", encodeURIComponent(idRecibo));
+            // tipoRotulo is also accepted as a query param on the download (PPN-285).
+            const sep = path.includes("?") ? "&" : "?";
+            const url = `${baseUrl}${path}${sep}tipoRotulo=${encodeURIComponent(tipoRotulo)}`;
+            const response = await fetchWithRetry(url, {
+                method: "GET",
+                headers: { Accept: "application/pdf, application/json", Authorization: `Bearer ${token}` },
+            });
+            const contentType = response.headers.get("content-type") ?? "";
+            // 202 (or 204) = still processing; tell the use case to poll again.
+            if (response.status === 202 || response.status === 204)
+                return { ready: false };
+            if (response.status !== 200) {
+                const body = await response.text().catch(() => "");
+                return { ready: false, message: `http_${response.status}: ${body.slice(0, 200)}` };
+            }
+            // Correios may return the PDF as raw bytes (application/pdf) or wrapped in
+            // JSON as base64 (dados/pdf). Handle both.
+            if (contentType.includes("application/pdf") || contentType.includes("octet-stream")) {
+                const buf = Buffer.from(await response.arrayBuffer());
+                return buf.length ? { ready: true, pdfBase64: buf.toString("base64") } : { ready: false };
+            }
+            const json = (await response.json().catch(() => ({})));
+            const pdfBase64 = (json.dados ?? json.pdf ?? json.base64 ?? json.arquivo);
+            if (pdfBase64)
+                return { ready: true, pdfBase64 };
+            // 200 without a PDF carries a business message (e.g. "status Pendente").
+            const message = typeof json.mensagem === "string" ? json.mensagem : undefined;
+            return message ? { ready: false, message } : { ready: false };
+        },
+    };
+}

package/dist/cjs/envSecretStore.js

@@ -6,7 +6,7 @@ class EnvSecretStore {
     prefix;
     constructor(options = {}) {
         this.env = options.env ?? process.env;
-        this.prefix = options.prefix ?? "MEUFRETE_";
+        this.prefix = options.prefix ?? "FRETE_";
     }
     key(name) {
         return this.prefix + name.replace(/[^a-zA-Z0-9]+/g, "_").toUpperCase();

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/correiosLabelHttpClient.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Node implementation of the `CorreiosLabelClient` port using global `fetch`.
+ *
+ * Mirrors `correiosHttpClient.ts`: same base URL, per-request timeout, and
+ * bounded retry on transient network failures. It stays deliberately thin —
+ * one round-trip per method; the "request PDF then poll" loop lives in the
+ * `generateLabel` use case.
+ *
+ * Endpoints (Correios pré-postagem API):
+ * - `POST /prepostagem/v1/prepostagens`                       — create
+ * - `POST /prepostagem/v1/prepostagens/rotulo/assincrono/pdf` — request async PDF
+ * - `GET  /prepostagem/v1/prepostagens/rotulo/download/assincrono/{idRecibo}` — poll/download
+ *
+ * NOTE: the async download path isn't in the public docs mirror; the default
+ * below is the officially-referenced one and is overridable via `downloadPath`
+ * so it can be corrected against homolog without touching the use case.
+ */
+import { type CorreiosLabelClient } from "@meuecommerce/frete";
+type FetchLike = typeof globalThis.fetch;
+export interface CorreiosLabelHttpClientOptions {
+    /** Injectable fetch (defaults to global fetch). */
+    fetch?: FetchLike;
+    /** Correios API base URL (defaults to the production URL). */
+    baseUrl?: string;
+    /** Per-request timeout, ms. Default 20000. */
+    timeoutMs?: number;
+    /** Max attempts per call. Default 2. */
+    retries?: number;
+    /** Base backoff between retries, ms (exponential). Default 500. */
+    retryDelayMs?: number;
+    /** Label size sent to Correios: "P" padrão or "R" reduzido. Default "P". */
+    tipoRotulo?: string;
+    /**
+     * Download endpoint template; `{idRecibo}` is substituted. Default follows the
+     * Correios async-download convention. Override if homolog differs.
+     */
+    downloadPath?: string;
+    logger?: Pick<Console, "warn" | "error" | "log">;
+}
+export declare function createCorreiosLabelHttpClient(options?: CorreiosLabelHttpClientOptions): CorreiosLabelClient;
+export {};

package/dist/correiosLabelHttpClient.js

@@ -0,0 +1,112 @@
+/**
+ * Node implementation of the `CorreiosLabelClient` port using global `fetch`.
+ *
+ * Mirrors `correiosHttpClient.ts`: same base URL, per-request timeout, and
+ * bounded retry on transient network failures. It stays deliberately thin —
+ * one round-trip per method; the "request PDF then poll" loop lives in the
+ * `generateLabel` use case.
+ *
+ * Endpoints (Correios pré-postagem API):
+ * - `POST /prepostagem/v1/prepostagens`                       — create
+ * - `POST /prepostagem/v1/prepostagens/rotulo/assincrono/pdf` — request async PDF
+ * - `GET  /prepostagem/v1/prepostagens/rotulo/download/assincrono/{idRecibo}` — poll/download
+ *
+ * NOTE: the async download path isn't in the public docs mirror; the default
+ * below is the officially-referenced one and is overridable via `downloadPath`
+ * so it can be corrected against homolog without touching the use case.
+ */
+import { correiosApiUrl, } from "@meuecommerce/frete";
+const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+export function createCorreiosLabelHttpClient(options = {}) {
+    const { fetch = globalThis.fetch, baseUrl = correiosApiUrl, timeoutMs = 20000, retries = 2, retryDelayMs = 500, tipoRotulo = "P", downloadPath = "/prepostagem/v1/prepostagens/rotulo/download/assincrono/{idRecibo}", logger = console, } = options;
+    if (typeof fetch !== "function") {
+        throw new Error("createCorreiosLabelHttpClient: no fetch available (Node 18+ or pass options.fetch)");
+    }
+    async function fetchWithRetry(url, init) {
+        let lastError;
+        for (let attempt = 0; attempt < retries; attempt++) {
+            const controller = new AbortController();
+            const timer = setTimeout(() => controller.abort(), timeoutMs);
+            try {
+                return await fetch(url, { ...init, signal: controller.signal });
+            }
+            catch (error) {
+                lastError = error;
+                if (attempt === retries - 1)
+                    break;
+                await sleep(retryDelayMs * Math.pow(2, attempt));
+            }
+            finally {
+                clearTimeout(timer);
+            }
+        }
+        throw lastError;
+    }
+    function authHeaders(token) {
+        return {
+            "Content-Type": "application/json",
+            Accept: "application/json",
+            Authorization: `Bearer ${token}`,
+        };
+    }
+    return {
+        async createPrepostagem(payload, token) {
+            const response = await fetchWithRetry(`${baseUrl}/prepostagem/v1/prepostagens`, {
+                method: "POST",
+                headers: authHeaders(token),
+                body: JSON.stringify(payload),
+            });
+            // Correios returns a structured error body (with the failure reason) on 4xx;
+            // the use case filters by `txErro`, so pass it through rather than throwing.
+            const json = (await response.json().catch(() => ({})));
+            if (response.status !== 200 && response.status !== 201) {
+                logger.warn(`[correios.createPrepostagem] status=${response.status} body=${JSON.stringify(json)}`);
+                if (!json.txErro)
+                    json.txErro = `http_${response.status}`;
+            }
+            return json;
+        },
+        async requestLabelPdf(ids, token) {
+            const response = await fetchWithRetry(`${baseUrl}/prepostagem/v1/prepostagens/rotulo/assincrono/pdf`, {
+                method: "POST",
+                headers: authHeaders(token),
+                body: JSON.stringify({ idsPrePostagem: ids, tipoRotulo }),
+            });
+            const json = (await response.json().catch(() => ({})));
+            if (!json.idRecibo)
+                throw new Error(`requestLabelPdf: no idRecibo (status=${response.status})`);
+            return { idRecibo: json.idRecibo };
+        },
+        async downloadLabelPdf(idRecibo, token) {
+            const path = downloadPath.replace("{idRecibo}", encodeURIComponent(idRecibo));
+            // tipoRotulo is also accepted as a query param on the download (PPN-285).
+            const sep = path.includes("?") ? "&" : "?";
+            const url = `${baseUrl}${path}${sep}tipoRotulo=${encodeURIComponent(tipoRotulo)}`;
+            const response = await fetchWithRetry(url, {
+                method: "GET",
+                headers: { Accept: "application/pdf, application/json", Authorization: `Bearer ${token}` },
+            });
+            const contentType = response.headers.get("content-type") ?? "";
+            // 202 (or 204) = still processing; tell the use case to poll again.
+            if (response.status === 202 || response.status === 204)
+                return { ready: false };
+            if (response.status !== 200) {
+                const body = await response.text().catch(() => "");
+                return { ready: false, message: `http_${response.status}: ${body.slice(0, 200)}` };
+            }
+            // Correios may return the PDF as raw bytes (application/pdf) or wrapped in
+            // JSON as base64 (dados/pdf). Handle both.
+            if (contentType.includes("application/pdf") || contentType.includes("octet-stream")) {
+                const buf = Buffer.from(await response.arrayBuffer());
+                return buf.length ? { ready: true, pdfBase64: buf.toString("base64") } : { ready: false };
+            }
+            const json = (await response.json().catch(() => ({})));
+            const pdfBase64 = (json.dados ?? json.pdf ?? json.base64 ?? json.arquivo);
+            if (pdfBase64)
+                return { ready: true, pdfBase64 };
+            // 200 without a PDF carries a business message (e.g. "status Pendente").
+            const message = typeof json.mensagem === "string" ? json.mensagem : undefined;
+            return message ? { ready: false, message } : { ready: false };
+        },
+    };
+}

package/dist/envSecretStore.d.ts

@@ -4,13 +4,13 @@
  *
  * Secret names are normalized to an env-var convention: uppercased with
  * non-alphanumerics turned into underscores, plus an optional prefix. So
- * `getSecret("backfill_secret")` reads `MEUFRETE_BACKFILL_SECRET` by default.
+ * `getSecret("backfill_secret")` reads `FRETE_BACKFILL_SECRET` by default.
  */
 import type { SecretStore } from "@meuecommerce/frete";
 export interface EnvSecretStoreOptions {
     /** Env source (defaults to process.env). */
     env?: Record<string, string | undefined>;
-    /** Prefix applied to normalized names. Default "MEUFRETE_". Pass "" for none. */
+    /** Prefix applied to normalized names. Default "FRETE_". Pass "" for none. */
     prefix?: string;
 }
 export declare class EnvSecretStore implements SecretStore {

package/dist/envSecretStore.js

@@ -3,7 +3,7 @@ export class EnvSecretStore {
     prefix;
     constructor(options = {}) {
         this.env = options.env ?? process.env;
-        this.prefix = options.prefix ?? "MEUFRETE_";
+        this.prefix = options.prefix ?? "FRETE_";
     }
     key(name) {
         return this.prefix + name.replace(/[^a-zA-Z0-9]+/g, "_").toUpperCase();

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.1",
   "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,13 @@
     "access": "public"
   },
   "dependencies": {
-    "@meuecommerce/frete": "^0.2.0"
+    "@meuecommerce/frete": "^0.3.1"
   },
-  "module": "./dist/index.js"
+  "module": "./dist/index.js",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/devstudio163/frete.git",
+    "directory": "packages/adapter-node"
+  },
+  "homepage": "https://github.com/devstudio163/frete"
 }