@fayz-ai/sdk 0.12.0 → 0.19.1

package/dist/agent.d.ts

@@ -75,6 +75,27 @@ export interface AgentAttachmentDigest {
     /** What the reader had to guess at, truncate or give up on. */
     warnings?: string[];
 }
+/**
+ * A file the user handed over TO BE READ — bytes, not a shape.
+ *
+ * The rule above holds and this is its one exception, drawn narrowly. A
+ * spreadsheet of patients gets DIGESTED because nobody asked for it to be read;
+ * it was attached so the agent could plan an import, and shipping it to a model
+ * provider would be a disclosure nobody consented to.
+ *
+ * A photographed receipt is the opposite case in every respect: one document,
+ * handed over on purpose, by a person whose whole request is "read this". The
+ * gesture IS the consent, so bytes travel — and ONLY for a file that arrived
+ * through an explicit request to read it. Never because an attachment happened
+ * to be an image.
+ */
+export interface AgentInlineFile {
+    name: string;
+    /** `image/jpeg`, `image/png`, `application/pdf`. */
+    mime: string;
+    /** Base64 of the file, without the `data:` prefix. */
+    data: string;
+}
 export interface FayzAgentChatInput {
     /** New end-user message. Omit when replying with tool results. */
     message?: string;
@@ -94,6 +115,14 @@ export interface FayzAgentChatInput {
     context?: Record<string, unknown>;
     /** Files the user attached this turn, as digests — never as bytes. */
     attachments?: AgentAttachmentDigest[];
+    /**
+     * Files the user handed over to be READ this turn — see AgentInlineFile.
+     *
+     * Separate from `attachments` on purpose: two fields means the boundary is
+     * visible at every call site and in every request log, instead of being a
+     * flag someone can flip by accident on a digest.
+     */
+    inlineFiles?: AgentInlineFile[];
     signal?: AbortSignal;
 }
 /** A server-plane write the broker parked pending human confirmation. */

package/dist/agent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,MAAM,WAAW,sBAAsB;IACrC,8CAA8C;IAC9C,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;IACjB,0DAA0D;IAC1D,cAAc,EAAE,MAAM,CAAA;IACtB,OAAO,CAAC,EAAE,OAAO,KAAK,CAAA;CACvB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,4CAA4C;IAC5C,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACrC;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACnC;AAED,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,MAAM,CAAA;IAClB,OAAO,EAAE,MAAM,CAAA;CAChB;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO,CAAA;IAChE,2DAA2D;IAC3D,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,oFAAoF;IACpF,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,MAAM,EAAE,EAAE,CAAA;IAClB,WAAW,EAAE,qBAAqB,EAAE,CAAA;CACrC;AAED,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,aAAa,GAAG,KAAK,GAAG,MAAM,GAAG,OAAO,GAAG,KAAK,GAAG,QAAQ,CAAA;IACjE,0EAA0E;IAC1E,MAAM,CAAC,EAAE,oBAAoB,EAAE,CAAA;IAC/B,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,MAAM,CAAC,EAAE,MAAM,EAAE,EAAE,CAAA;IACnB,WAAW,CAAC,EAAE,qBAAqB,EAAE,CAAA;IACrC,oCAAoC;IACpC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;CACpB;AAED,MAAM,WAAW,kBAAkB;IACjC,kEAAkE;IAClE,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,gFAAgF;IAChF,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,wEAAwE;IACxE,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,KAAK,CAAC,EAAE,aAAa,EAAE,CAAA;IACvB,WAAW,CAAC,EAAE,mBAAmB,EAAE,CAAA;IACnC,6EAA6E;IAC7E,aAAa,CAAC,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAA;KAAE,CAAA;IACjD,0EAA0E;IAC1E,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACjC,sEAAsE;IACtE,WAAW,CAAC,EAAE,qBAAqB,EAAE,CAAA;IACrC,MAAM,CAAC,EAAE,WAAW,CAAA;CACrB;AAED,yEAAyE;AACzE,MAAM,WAAW,sBAAsB;IACrC,EAAE,EAAE,MAAM,CAAA;IACV,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACjC;AAED,MAAM,WAAW,qBAAqB;IACpC,cAAc,EAAE,MAAM,CAAA;IACtB,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,iBAAiB,EAAE,CAAA;IAC9B,4EAA4E;IAC5E,aAAa,CAAC,EAAE,sBAAsB,CAAA;CACvC;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;CACpB;AAED,qBAAa,cAAe,SAAQ,KAAK;IAGrC,QAAQ,CAAC,MAAM,EAAE,MAAM;gBADvB,OAAO,EAAE,MAAM,EACN,MAAM,EAAE,MAAM;CAK1B;AAED,MAAM,WAAW,4BAA4B;IAC3C,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,wDAAwD;IACxD,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,4BAA4B;IAC3C,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;IACjB;iFAC6E;IAC7E,WAAW,CAAC,EAAE,qBAAqB,EAAE,CAAA;IACrC;0DACsD;IACtD,SAAS,CAAC,EAAE,KAAK,CAAC;QAChB,IAAI,EAAE,MAAM,CAAA;QACZ,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;QACnC,MAAM,CAAC,EAAE,MAAM,CAAA;KAChB,CAAC,CAAA;CACH;AAED,MAAM,WAAW,2BAA2B;IAC1C,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,QAAQ,EAAE,4BAA4B,EAAE,CAAA;CACzC;AAED,MAAM,WAAW,wBAAwB;IACvC,iFAAiF;IACjF,OAAO,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;CACvD;AAED,MAAM,WAAW,eAAe;IAC9B,yEAAyE;IACzE,OAAO,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,aAAa,CAAC,CAAA;IACrD,IAAI,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAA;IAC/D;;;;;OAKG;IACH,UAAU,CAAC,KAAK,EAAE,kBAAkB,EAAE,SAAS,CAAC,EAAE,wBAAwB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAA;IAC3G,oEAAoE;IACpE,iBAAiB,CAAC,cAAc,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,4BAA4B,EAAE,CAAC,CAAA;IACzG,sEAAsE;IACtE,eAAe,CACb,cAAc,EAAE,MAAM,EACtB,cAAc,CAAC,EAAE,MAAM,EACvB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,2BAA2B,CAAC,CAAA;CACxC;AAWD,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,sBAAsB,GAAG,eAAe,CAoItF"}
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"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"}

package/dist/agent.js

@@ -1,3 +1,3 @@
-export { FayzAgentError, createFayzAgentClient } from './chunk-LSBVNW75.js';
+export { FayzAgentError, createFayzAgentClient } from './chunk-KTRZI44K.js';
 //# sourceMappingURL=agent.js.map
 //# sourceMappingURL=agent.js.map

package/dist/{chunk-4YRHC5N7.js → chunk-BTXIUI4E.js}

@@ -1,4 +1,4 @@
-import { resetDeprecationWarnings, warnDeprecated } from './chunk-HA5O3CW7.js';
+import { resetDeprecationWarnings, warnDeprecated } from './chunk-LCW5ZV5S.js';
 
 // src/lib/dedupe-fetch.ts
 var DEFAULT_VARY = [
@@ -16,7 +16,11 @@ var DEFAULT_VARY = [
   // count=exact changes Content-Range
   "x-fayz-store",
   // storefront tenant scope
-  "x-fayz-tenant"
+  "x-fayz-tenant",
+  // The active unit. Load-bearing, not decorative: two reads of the SAME url
+  // under different units are different questions, and without this line the
+  // second one joins the first and a franchisee is handed another unit's rows.
+  "x-fayz-unit"
 ];
 var collapsed = 0;
 var flights = /* @__PURE__ */ new Map();
@@ -87,8 +91,9 @@ function setShopAccessTokenResolver(resolver) {
 var CARRIER_QUOTE_BUDGET_MS = 2500;
 var CARRIER_OPTION_SEPARATOR = "::";
 var CHECKOUT_GATEWAYS = {
-  abacatepay: { open: "shop-checkout-open", settle: "shop-checkout-settle" },
-  vindi: { open: "vindi-checkout-open", settle: "vindi-checkout-settle" }
+  abacatepay: { open: "shop-checkout-open", settle: "shop-checkout-settle", link: false },
+  vindi: { open: "vindi-checkout-open", settle: "vindi-checkout-settle", link: true },
+  mercadopago: { open: "mercadopago-checkout-open", settle: "mercadopago-checkout-settle", link: false }
 };
 function checkoutGateway(provider) {
   const slug = String(provider ?? "").trim();
@@ -569,7 +574,7 @@ function createFayzShopProvider(options) {
     },
     async listOrders(options2) {
       const query = tenantQuery();
-      query.set("select", "*,items:plg_shop_order_items(*),shipments:fulfillments(status,delivered_at)");
+      query.set("select", "*,items:plg_shop_order_items(*)");
       if (options2?.status) query.set("status", `eq.${options2.status}`);
       if (options2?.financialStatus) query.set("financial_status", `eq.${options2.financialStatus}`);
       if (options2?.fulfillmentStatus) query.set("fulfillment_status", `eq.${options2.fulfillmentStatus}`);
@@ -581,7 +586,7 @@ function createFayzShopProvider(options) {
       if (options2?.offset) query.set("offset", String(options2.offset));
       let rows = [];
       try {
-        rows = await request("plg_shop_orders", { query });
+        rows = await request("v_shop_orders", { query });
       } catch (error) {
         if (!options2?.customerId) throw error;
       }
@@ -610,7 +615,7 @@ function createFayzShopProvider(options) {
       query.set("select", "*,items:plg_shop_order_items(*)");
       let rows = [];
       try {
-        rows = await request("plg_shop_orders", { query });
+        rows = await request("v_shop_orders", { query });
       } catch {
       }
       if (rows[0]) return rowToOrder(rows[0]);
@@ -655,6 +660,45 @@ function createFayzShopProvider(options) {
      * its own — `settleCheckoutSession` is what turns it into an order, and only
      * after the acquirer says the money is in.
      */
+    /**
+     * Remember the contact details of whoever is signed in.
+     *
+     * Called when the buyer leaves the contact step rather than when an order
+     * completes: an abandoned checkout teaches the store nothing, and the person
+     * who most needs their phone remembered is the one who did not finish. The
+     * function decides which columns may be written and to whose row — a shopper
+     * is not a tenant member, so there is no policy that would let this be a
+     * plain UPDATE, and RLS could not narrow one to two columns anyway.
+     */
+    async saveCustomerContact(input) {
+      try {
+        await request("rpc/shop_save_customer_contact", {
+          method: "POST",
+          body: JSON.stringify({
+            p_tenant_id: storeId,
+            p_phone: input.phone ?? null,
+            p_document: input.document ?? null
+          })
+        });
+      } catch {
+      }
+    },
+    /** The acquirer's public key, for a checkout that tokenises in the browser. */
+    async paymentPublicKey(provider) {
+      const gateway = checkoutGateway(provider);
+      if (!gateway) return null;
+      try {
+        const response = await (options.fetcher ?? fetch)(`${functionsUrl}/${gateway.open}`, {
+          method: "POST",
+          headers: { apikey: key, Authorization: `Bearer ${key}`, "Content-Type": "application/json" },
+          body: JSON.stringify({ tenantId: storeId, action: "public_key" })
+        });
+        const payload = await response.json().catch(() => null);
+        return response.ok ? payload?.publicKey ?? null : null;
+      } catch {
+        return null;
+      }
+    },
     async openCheckoutSession(input) {
       const provider = String(input.provider ?? "").trim() || "abacatepay";
       const gateway = checkoutGateway(provider);
@@ -670,7 +714,35 @@ function createFayzShopProvider(options) {
         })),
         customer: input.customer,
         shippingAddress: input.shippingAddress ?? null,
-        discountCode: input.discountCode ?? null
+        discountCode: input.discountCode ?? null,
+        // O que o comprador escolheu, no vocabulário da loja. Quem traduz para
+        // o número do adquirente é a função, do lado de lá, onde também mora a
+        // lista do que o lojista habilitou.
+        method: input.paymentMethod ?? null,
+        // Para onde o adquirente devolve quem pagou fora daqui. A função confere
+        // este endereço contra a origem de quem pediu: é uma URL que entregamos
+        // a terceiro, e terceiro nenhum redireciona comprador nosso para onde
+        // quiser.
+        returnUrl: input.returnUrl ?? null,
+        asLink: input.asLink === true,
+        // O cartão digitado DENTRO da loja, quando o adquirente tokeniza no
+        // navegador. Não é um número de cartão: é um código de uso único que o
+        // Brick do Mercado Pago devolveu, e sem ele a função não tem o que
+        // cobrar.
+        //
+        // Este corpo é montado campo a campo, então o que não estiver nomeado
+        // aqui NÃO CHEGA do outro lado — a vitrine já mandava os cinco e todos
+        // eram descartados em silêncio, com o comprador recebendo "não
+        // recebemos os dados do cartão" depois de preencher tudo certo.
+        // Enviados como null quando ausentes, para que um Pix continue sendo um
+        // corpo com as mesmas chaves.
+        cardToken: input.cardToken ?? null,
+        installments: input.installments ?? null,
+        paymentMethodId: input.paymentMethodId ?? null,
+        issuerId: input.issuerId ?? null,
+        // A recomendação nº 1 deles para aprovação: sem a impressão digital do
+        // aparelho, um comprador legítimo é recusado com mais frequência.
+        deviceId: input.deviceId ?? null
       });
       const response = await (options.fetcher ?? fetch)(`${functionsUrl}/${gateway.open}`, {
         method: "POST",
@@ -689,6 +761,11 @@ function createFayzShopProvider(options) {
         total: Number(payload.total ?? 0),
         state: "open",
         provider,
+        method: payload.method ?? input.paymentMethod ?? null,
+        // A página do adquirente: o link que o lojista manda e o endereço para
+        // onde o comprador de cartão é levado. São a mesma coisa vista de dois
+        // lugares — quem chama decide se copia ou se vai.
+        paymentUrl: payload.redirectUrl ?? payload.paymentUrl ?? null,
         charge: payload.brCode ? {
           emv: payload.brCode,
           // O tipo promete base64 PURO, e a AbacatePay manda com o
@@ -696,6 +773,12 @@ function createFayzShopProvider(options) {
           // Sem tirar aqui, a tela prefixava de novo e o QR não aparecia —
           // um <img> com src inválido, silencioso.
           qrcodeBase64: (payload.brCodeBase64 ?? "").replace(/^data:image\/\w+;base64,/u, "") || null,
+          // Vindi hosts the QR instead of inlining it, so the image arrives
+          // as an https URL to an SVG. It travels beside the base64 rather
+          // than inside it: the two cannot be told apart at the point of use
+          // without guessing at the string, and drawing either as the other
+          // is a silently broken <img> in front of someone trying to pay.
+          qrcodeUrl: String(payload.qrCodeUrl ?? "").trim() || null,
           expiresAt: payload.expiresAt ?? ""
         } : null
       };
@@ -705,14 +788,17 @@ function createFayzShopProvider(options) {
      * read as "still waiting" (`unknown`) and never as a payment that failed —
      * one wrong `failed` here throws away a cart the buyer already paid for.
      */
-    async settleCheckoutSession(sessionId, provider) {
+    async settleCheckoutSession(sessionId, provider, chargeToken) {
       const gateway = checkoutGateway(String(provider ?? "").trim() || "abacatepay");
       if (!gateway) return { state: "unknown" };
       try {
         const response = await (options.fetcher ?? fetch)(`${functionsUrl}/${gateway.settle}`, {
           method: "POST",
           headers: { apikey: key, Authorization: `Bearer ${key}`, "Content-Type": "application/json" },
-          body: JSON.stringify({ tenantId: storeId, sessionId })
+          // `chargeToken` é PISTA, nunca afirmação: o adquirente pendura o token
+          // na volta do comprador, e o servidor confere com ele antes de aceitar.
+          // Serve para fechar a compra na hora em vez de esperar o webhook.
+          body: JSON.stringify({ tenantId: storeId, sessionId, ...chargeToken ? { chargeToken } : {} })
         });
         const payload = await response.json().catch(() => null);
         if (!response.ok || !payload?.state) return { state: "unknown" };
@@ -784,7 +870,10 @@ function createFayzShopProvider(options) {
         code: row?.code ?? null,
         type: row?.type ?? null,
         value: Number(row?.value ?? 0),
-        reason: row?.reason ?? void 0
+        reason: row?.reason ?? void 0,
+        // 0057 answers `min_subtotal` with the number. Dropped here, the cart
+        // could only say "inválido ou expirado" about a coupon that is neither.
+        ...row?.min_subtotal != null ? { minSubtotal: Number(row.min_subtotal) } : {}
       };
     },
     async cancelOrder(orderId, reason) {
@@ -837,7 +926,7 @@ function createFayzShopProvider(options) {
       const discountTotal = input.discountTotal ?? 0;
       const shippingTotal = input.shippingTotal ?? 0;
       const total = Math.round((subtotal - discountTotal + shippingTotal) * 100) / 100;
-      const [order] = await request("plg_shop_orders", {
+      const [order] = await request("v_shop_orders", {
         method: "POST",
         body: JSON.stringify({
           tenant_id: storeId,
@@ -875,7 +964,7 @@ function createFayzShopProvider(options) {
       return this.getOrder(order.id);
     },
     async updateOrder(id, input) {
-      await request("plg_shop_orders", {
+      await request("v_shop_orders", {
         method: "PATCH",
         query: singleById(id),
         body: JSON.stringify(updateOrderPayload(input))
@@ -1285,5 +1374,5 @@ function createBrokerShopProvider(options) {
 }
 
 export { FayzShopError, PRODUCT_METADATA_OVERLAY_DEPRECATION, createDedupedFetch, createFayzShopProvider, getDedupeStats, resetDedupeStats, resetProductMetadataOverlayDeprecationWarning, setShopAccessTokenResolver, setShopCarrierQuotesResolver, setShopShippingItemsResolver };
-//# sourceMappingURL=chunk-4YRHC5N7.js.map
-//# sourceMappingURL=chunk-4YRHC5N7.js.map
+//# sourceMappingURL=chunk-BTXIUI4E.js.map
+//# sourceMappingURL=chunk-BTXIUI4E.js.map