platform-types 1.10.859 → 1.10.861

package/dist/balancePayment.d.ts

@@ -79,8 +79,8 @@ declare global {
         /**
          * 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 a newer
-         * debit of an order whose older one cannot be paid online.
+         * 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;
     }
@@ -183,6 +183,9 @@ export declare const BALANCE_ATTEMPT_MAX_DEBITS = 50;
  *   `order` — an orderless debit, or not the oldest open debit of its order.
  * - `BALANCE_NOTHING_OWED` · 409 — the selection owes nothing.
  * - `BALANCE_ATTEMPT_NOT_FOUND` · 404 — no such attempt of the caller's.
+ * - `BALANCE_ATTEMPT_CONFLICT` · 409 — a start of another selection by the same
+ *   customer, at the same moment, took this attempt number; nothing was started
+ *   for this request — retry.
  */
-export declare const BALANCE_PAYMENT_ERROR_CODES: readonly ["BALANCE_PAYMENT_DISABLED", "BALANCE_CURRENCY_UNSUPPORTED", "BALANCE_SELECTION_STALE", "BALANCE_SELECTION_NOT_PREFIX", "BALANCE_NOTHING_OWED", "BALANCE_ATTEMPT_NOT_FOUND"];
+export declare const BALANCE_PAYMENT_ERROR_CODES: readonly ["BALANCE_PAYMENT_DISABLED", "BALANCE_CURRENCY_UNSUPPORTED", "BALANCE_SELECTION_STALE", "BALANCE_SELECTION_NOT_PREFIX", "BALANCE_NOTHING_OWED", "BALANCE_ATTEMPT_NOT_FOUND", "BALANCE_ATTEMPT_CONFLICT"];
 export {};

package/dist/balancePayment.js

@@ -61,6 +61,9 @@ export const BALANCE_ATTEMPT_MAX_DEBITS = 50;
  *   `order` — an orderless debit, or not the oldest open debit of its order.
  * - `BALANCE_NOTHING_OWED` · 409 — the selection owes nothing.
  * - `BALANCE_ATTEMPT_NOT_FOUND` · 404 — no such attempt of the caller's.
+ * - `BALANCE_ATTEMPT_CONFLICT` · 409 — a start of another selection by the same
+ *   customer, at the same moment, took this attempt number; nothing was started
+ *   for this request — retry.
  */
 export const BALANCE_PAYMENT_ERROR_CODES = [
     'BALANCE_PAYMENT_DISABLED',
@@ -69,4 +72,5 @@ export const BALANCE_PAYMENT_ERROR_CODES = [
     'BALANCE_SELECTION_NOT_PREFIX',
     'BALANCE_NOTHING_OWED',
     'BALANCE_ATTEMPT_NOT_FOUND',
+    'BALANCE_ATTEMPT_CONFLICT',
 ];

package/dist/cjs/balancePayment.js

@@ -64,6 +64,9 @@ exports.BALANCE_ATTEMPT_MAX_DEBITS = 50;
  *   `order` — an orderless debit, or not the oldest open debit of its order.
  * - `BALANCE_NOTHING_OWED` · 409 — the selection owes nothing.
  * - `BALANCE_ATTEMPT_NOT_FOUND` · 404 — no such attempt of the caller's.
+ * - `BALANCE_ATTEMPT_CONFLICT` · 409 — a start of another selection by the same
+ *   customer, at the same moment, took this attempt number; nothing was started
+ *   for this request — retry.
  */
 exports.BALANCE_PAYMENT_ERROR_CODES = [
     'BALANCE_PAYMENT_DISABLED',
@@ -72,4 +75,5 @@ exports.BALANCE_PAYMENT_ERROR_CODES = [
     'BALANCE_SELECTION_NOT_PREFIX',
     'BALANCE_NOTHING_OWED',
     'BALANCE_ATTEMPT_NOT_FOUND',
+    'BALANCE_ATTEMPT_CONFLICT',
 ];

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/cjs/terminal.js

@@ -92,8 +92,10 @@ exports.TERMINAL_ENROLMENT_ERROR_CODES = [
  *   did not match.
  * - `PASSWORD_NOT_SET` · 409 — `POST /terminal/activation` and `POST
  *   /terminal/pin`: the employee (a founder registered with Google or Apple) has
- *   no password. The body carries `providers`, the recorded sign-in providers, as
- *   `POST /auth/verify-password` does. Nothing is counted against the account.
+ *   no password. On `/terminal/pin` the body carries `providers`, the recorded
+ *   sign-in providers, as `POST /auth/verify-password` does; `/terminal/activation`
+ *   answers it after the lock and captcha gates, with no `providers`. Nothing is
+ *   counted against the account.
  * - `IDEMPOTENCY_KEY_REUSE` · 422 / `IDEMPOTENCY_IN_PROGRESS` · 409 /
  *   `INVALID_IDEMPOTENCY_KEY` · 400 — the `Idempotency-Key` header's own
  *   refusals on `POST /terminal/operators`. A MISSING header is

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

@@ -589,8 +589,10 @@ export type TerminalEnrolmentErrorCode = (typeof TERMINAL_ENROLMENT_ERROR_CODES)
  *   did not match.
  * - `PASSWORD_NOT_SET` · 409 — `POST /terminal/activation` and `POST
  *   /terminal/pin`: the employee (a founder registered with Google or Apple) has
- *   no password. The body carries `providers`, the recorded sign-in providers, as
- *   `POST /auth/verify-password` does. Nothing is counted against the account.
+ *   no password. On `/terminal/pin` the body carries `providers`, the recorded
+ *   sign-in providers, as `POST /auth/verify-password` does; `/terminal/activation`
+ *   answers it after the lock and captcha gates, with no `providers`. Nothing is
+ *   counted against the account.
  * - `IDEMPOTENCY_KEY_REUSE` · 422 / `IDEMPOTENCY_IN_PROGRESS` · 409 /
  *   `INVALID_IDEMPOTENCY_KEY` · 400 — the `Idempotency-Key` header's own
  *   refusals on `POST /terminal/operators`. A MISSING header is

package/dist/terminal.js

@@ -89,8 +89,10 @@ export const TERMINAL_ENROLMENT_ERROR_CODES = [
  *   did not match.
  * - `PASSWORD_NOT_SET` · 409 — `POST /terminal/activation` and `POST
  *   /terminal/pin`: the employee (a founder registered with Google or Apple) has
- *   no password. The body carries `providers`, the recorded sign-in providers, as
- *   `POST /auth/verify-password` does. Nothing is counted against the account.
+ *   no password. On `/terminal/pin` the body carries `providers`, the recorded
+ *   sign-in providers, as `POST /auth/verify-password` does; `/terminal/activation`
+ *   answers it after the lock and captcha gates, with no `providers`. Nothing is
+ *   counted against the account.
  * - `IDEMPOTENCY_KEY_REUSE` · 422 / `IDEMPOTENCY_IN_PROGRESS` · 409 /
  *   `INVALID_IDEMPOTENCY_KEY` · 400 — the `Idempotency-Key` header's own
  *   refusals on `POST /terminal/operators`. A MISSING header is

package/package.json

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