platform-types 1.10.858 → 1.10.860

package/dist/balancePayment.d.ts

@@ -76,6 +76,13 @@ declare global {
         original: number;
         /** What is still owed on it — the amount a start charges for it. Always above zero. */
         remaining: number;
+        /**
+         * Whether a `mode: 'order'` start may name this debit: it is the OLDEST open
+         * debit of its order, counting the ones not listed here (an order's credit
+         * settles that one first). `false` on an orderless debit, and on any newer
+         * debit of its order — listed or not, the older one is paid first.
+         */
+        orderPayable: boolean;
     }
     /** `data` of web `GET /account?mode=open-debits`. */
     interface OpenAccountDebitsResponse {

package/dist/cjs/socket.js

@@ -584,6 +584,21 @@ exports.SOCKET_ACTIONS = [
     'purchaseWithdrawalChanged',
     'stripe',
     'subscription',
+    /**
+     * A message pack's credits landed on the store's bought balance, or a
+     * reversed pack took them back. `data` is the store's fresh
+     * `MessageBalanceView` (`messaging.ts`), exactly what
+     * `GET /message-credits?mode=balance` answers — replace the cached balance.
+     * AT MOST once per committed move, never on a provider redelivery: a send
+     * lost after the commit is not repeated, so it is a refresh hint, never the
+     * only way the balance reaches the client.
+     *
+     * ⚠️ OPERATOR sockets of the store only, and ADMIN tier only (`wsPostStore`
+     * with `audience: 'operator'` and `lowTierData: null` — the tier
+     * `GET /message-credits` admits). Never a customer socket. Silent while
+     * `tenantMessagingEnabled` is off.
+     */
+    'messageCredits',
     // Fiscal.
     'caea',
     // Print agent audience (`wsPostPrinter`).

package/dist/messaging.d.ts

@@ -251,6 +251,42 @@ declare global {
         currency: MessagePackCurrency;
         displayOrder: number;
     }
+    /**
+     * One message pack the store paid for, as `GET /message-credits?mode=purchases`
+     * lists it — one MercadoPago payment, newest first by `paidAt`.
+     */
+    interface StoreMessagePackPurchase {
+        /** The MercadoPago payment id. */
+        paymentId: string;
+        packId: string;
+        /** The pack's CURRENT catalogue name (an inactive pack included); `null` once its row is gone. */
+        packName: string | null;
+        /** The credits the purchase added — frozen at checkout, never a later reprice. */
+        credits: number;
+        /** What was paid, in centavos; `null` when the provider reported no amount. */
+        amountCents: number | null;
+        /** As the provider reported it, lowercase (`ars`); `null` when it reported none. */
+        currency: string | null;
+        /** When MercadoPago reports it paid, else when the approval landed here. */
+        paidAt: number;
+        /**
+         * The payment refunded or charged back — its credits were taken back.
+         * When both happened, the EARLIER one.
+         */
+        reversal: null | {
+            cause: 'refunded' | 'charged_back';
+            at: number;
+        };
+        /** The platform's comprobante for the purchase. Always `null` for now. */
+        factura: PlatformFiscalDoc;
+        /** The platform's credit note for its reversal. Always `null` for now. */
+        creditNote: PlatformFiscalDoc;
+    }
+    /** One page of the store's pack purchases, newest first. `cursor` present only when more may follow. */
+    interface MessagePackPurchasePage {
+        items: StoreMessagePackPurchase[];
+        cursor?: string;
+    }
     /** `POST /platform/billing/message-packs` (managerToken). */
     interface MessagePackCreateRequest {
         name: string;

package/dist/socket.d.ts

@@ -26,7 +26,7 @@
  * A client must ignore actions it does not own rather than assume it
  * receives all of them.
  */
-export declare const SOCKET_ACTIONS: readonly ["account", "appointments", "appointmentWaitlist", "attendance", "attributes", "automation-rules", "baskets", "cart", "brands", "cash", "catalogOperation", "categories", "campaigns", "customers", "customerNote", "customerAddress", "customerContact", "deliveries", "globals", "inventory", "invoices", "literals", "loyalty", "orders", "presupuestos", "products", "promotions", "segments", "returns", "rma", "templates", "services", "service-templates", "shifts", "stores", "suppliers", "supplier-invoice", "support", "surveys", "users", "warehouses", "zones", "favorites", "webhooks", "account-delete", "baskets-delete", "cart-delete", "log-delete", "notifications", "support-message", "payment_received", "mp_payment_status_changed", "payment_linked", "payment_unlinked", "mercadopago", "mercadopago_dynamic_qr_created", "mercadopago_static_qr_created", "mp_hook_log_appended", "mp_ipn_log_appended", "orderPaymentAttempt", "balancePaymentAttempt", "orderDelivery", "paymentAttemptChanged", "orderPurchaseWithdrawal", "orderReturnRequest", "purchaseWithdrawalChanged", "stripe", "subscription", "caea", "print", "print-order", "print-invoice", "print-product", "print-tag", "print-service-order", "print_job_failed", "request_printers", "printers_changed", "agent_status_changed", "print_rules_changed", "printers_active", "agent_command", "maintenance", "currency_auto_updated", "drain_progress", "integration_event_appended", "userActivityRecorded", "mercadolibre_settlement_period", "customDomain", "purchaseOrders", "cycleCounts", "stockTransfers", "workItems", "wholesaleRequests"];
+export declare const SOCKET_ACTIONS: readonly ["account", "appointments", "appointmentWaitlist", "attendance", "attributes", "automation-rules", "baskets", "cart", "brands", "cash", "catalogOperation", "categories", "campaigns", "customers", "customerNote", "customerAddress", "customerContact", "deliveries", "globals", "inventory", "invoices", "literals", "loyalty", "orders", "presupuestos", "products", "promotions", "segments", "returns", "rma", "templates", "services", "service-templates", "shifts", "stores", "suppliers", "supplier-invoice", "support", "surveys", "users", "warehouses", "zones", "favorites", "webhooks", "account-delete", "baskets-delete", "cart-delete", "log-delete", "notifications", "support-message", "payment_received", "mp_payment_status_changed", "payment_linked", "payment_unlinked", "mercadopago", "mercadopago_dynamic_qr_created", "mercadopago_static_qr_created", "mp_hook_log_appended", "mp_ipn_log_appended", "orderPaymentAttempt", "balancePaymentAttempt", "orderDelivery", "paymentAttemptChanged", "orderPurchaseWithdrawal", "orderReturnRequest", "purchaseWithdrawalChanged", "stripe", "subscription", "messageCredits", "caea", "print", "print-order", "print-invoice", "print-product", "print-tag", "print-service-order", "print_job_failed", "request_printers", "printers_changed", "agent_status_changed", "print_rules_changed", "printers_active", "agent_command", "maintenance", "currency_auto_updated", "drain_progress", "integration_event_appended", "userActivityRecorded", "mercadolibre_settlement_period", "customDomain", "purchaseOrders", "cycleCounts", "stockTransfers", "workItems", "wholesaleRequests"];
 /** Union of every server→client data-frame action. */
 export type SocketAction = (typeof SOCKET_ACTIONS)[number];
 /**

package/dist/socket.js

@@ -581,6 +581,21 @@ export const SOCKET_ACTIONS = [
     'purchaseWithdrawalChanged',
     'stripe',
     'subscription',
+    /**
+     * A message pack's credits landed on the store's bought balance, or a
+     * reversed pack took them back. `data` is the store's fresh
+     * `MessageBalanceView` (`messaging.ts`), exactly what
+     * `GET /message-credits?mode=balance` answers — replace the cached balance.
+     * AT MOST once per committed move, never on a provider redelivery: a send
+     * lost after the commit is not repeated, so it is a refresh hint, never the
+     * only way the balance reaches the client.
+     *
+     * ⚠️ OPERATOR sockets of the store only, and ADMIN tier only (`wsPostStore`
+     * with `audience: 'operator'` and `lowTierData: null` — the tier
+     * `GET /message-credits` admits). Never a customer socket. Silent while
+     * `tenantMessagingEnabled` is off.
+     */
+    'messageCredits',
     // Fiscal.
     'caea',
     // Print agent audience (`wsPostPrinter`).

package/dist/subscription.d.ts

@@ -724,6 +724,21 @@ declare global {
         refundedAt?: number;
         chargedBackAt?: number;
     }
+    /**
+     * The platform's own fiscal document for a charge it made a tenant (a
+     * subscription payment, a message pack) or for its reversal — never an
+     * `Invoice` the tenant issues. Always `null` for now: no platform
+     * self-billing writes it yet. `issuedAt` is Unix ms.
+     */
+    type PlatformFiscalDoc = null | {
+        status: 'pending';
+    } | {
+        status: 'issued';
+        letter: 'A' | 'B';
+        number: string;
+        cae: string;
+        issuedAt: number;
+    };
     /**
      * One charge SINFACTURA made against a tenant, normalized out of whichever
      * billing provider holds the money. Backs the per-tenant payment history and

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "platform-types",
-	"version": "1.10.858",
+	"version": "1.10.860",
 	"description": "Shared wire and entity contracts for the platform.",
 	"type": "module",
 	"main": "dist/index.js",