platform-types 1.10.861 → 1.10.862

package/dist/maintenance.d.ts

@@ -64,6 +64,17 @@ declare global {
         /** Optional operator reason (10-500 chars, refused when it carries personal data). Internal: AUDIT row only. */
         reason?: string;
     }
+    /**
+     * The `422 BROADCAST_CHANNEL_NOT_CONFIGURED` body of a maintenance broadcast:
+     * `channels` names every requested channel with no platform sender (never
+     * `'email'`), in request order. Refused whole, before the roster read, any
+     * claim or any send.
+     */
+    interface MaintenanceBroadcastChannelRefusal {
+        message: string;
+        error: 'BROADCAST_CHANNEL_NOT_CONFIGURED';
+        channels: MaintenanceBroadcastChannel[];
+    }
     /**
      * What one channel actually did.
      *

package/dist/messaging.d.ts

@@ -277,9 +277,12 @@ declare global {
             cause: 'refunded' | 'charged_back';
             at: number;
         };
-        /** The platform's comprobante for the purchase. Always `null` for now. */
+        /**
+         * The platform's comprobante for the purchase — non-null only for a
+         * purchase approved on or after the platform's self-billing go-live.
+         */
         factura: PlatformFiscalDoc;
-        /** The platform's credit note for its reversal. Always `null` for now. */
+        /** The platform's credit note for its reversal — non-null only when `reversal` is set and `factura` is non-null. */
         creditNote: PlatformFiscalDoc;
     }
     /** One page of the store's pack purchases, newest first. `cursor` present only when more may follow. */

package/dist/subscription.d.ts

@@ -727,8 +727,12 @@ declare global {
     /**
      * 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.
+     * `Invoice` the tenant issues. `null` when there is none; `pending` while it
+     * is owed and not yet authorised — an ARCA rejection or a retry stays
+     * `pending`, never a third state; `issued` once ARCA authorised it. `number`
+     * is `PPPP-NNNNNNNN` (point of sale and comprobante number, zero-padded);
+     * `issuedAt` is Unix ms. Nothing writes one yet, so every reader still
+     * answers `null`.
      */
     type PlatformFiscalDoc = null | {
         status: 'pending';
@@ -739,6 +743,21 @@ declare global {
         cae: string;
         issuedAt: number;
     };
+    /** Which platform document `GET /subscription/invoices/{paymentId}/pdf` renders. */
+    type PlatformFiscalDocKind = 'factura' | 'creditNote';
+    /**
+     * `data` of `GET /subscription/invoices/{paymentId}/pdf?doc=factura|creditNote`
+     * (adminToken), for a subscription OR a message-pack payment of the token's
+     * store: a short-lived presigned `url` to the rendered PDF, valid until
+     * `expiresAt` (Unix ms, about 5 minutes). Fetch it on click, never cache it.
+     * `404 PLATFORM_FISCAL_DOC_NOT_FOUND` when the payment or its document does
+     * not exist; `409 PLATFORM_FISCAL_DOC_PENDING` while it is still pending.
+     * The route itself ships with platform self-billing's PDF slice.
+     */
+    interface PlatformFiscalDocPdf {
+        url: string;
+        expiresAt: number;
+    }
     /**
      * One charge SINFACTURA made against a tenant, normalized out of whichever
      * billing provider holds the money. Backs the per-tenant payment history and
@@ -751,6 +770,12 @@ declare global {
      * unpaid and identity-proven distinct paid provider entries without counting matched payments
      * twice. Unknown or partially overlapping paid aggregates are omitted and the response is truncated; retained rows carry the paid plan and period metadata below. The
      * cross-tenant billing rollup continues to read live provider history only.
+     *
+     * Every row also carries `factura` and `creditNote` — the platform's OWN
+     * comprobante for the charge and its reversal, required and `null` when
+     * absent: non-null only on a retained `mercadopago` row that is `'paid'` or a
+     * reversed `'void'`, approved on or after the self-billing go-live (rules on
+     * each field). Top-level `pdfUrl` / `issuedAt` are unchanged by them.
      */
     interface InvoiceSummary {
         id: string;
@@ -777,6 +802,21 @@ declare global {
         /** Unix ms; reversal facts preserve the original amount and map status to void. */
         refundedAt?: number;
         chargedBackAt?: number;
+        /**
+         * The platform's comprobante for this charge. Non-null only on a
+         * retained `mercadopago` row whose status is `'paid'`, or `'void'`
+         * because it was reversed (`refundedAt` / `chargedBackAt` set), approved
+         * on or after the platform's self-billing go-live. Stripe rows, live
+         * provider rows (`'open'`, `'failed'`, and paid entries with no retained
+         * row) and payments before the go-live are always `null`. Never omitted.
+         */
+        factura: PlatformFiscalDoc;
+        /**
+         * The platform's credit note reversing that comprobante. Non-null only
+         * on a reversed (`'void'`) row whose `factura` is non-null; `null` on a
+         * `'paid'` row and wherever `factura` is `null`. Never omitted.
+         */
+        creditNote: PlatformFiscalDoc;
     }
     /**
      * One tier's `SK: PLAN` template row, as assessed by

package/package.json

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