sinfactura-types 1.10.650 → 1.10.652

package/dist/ai.d.ts

@@ -747,6 +747,48 @@ declare global {
         /** Epoch ms. */
         updatedAt: number;
     }
+    /** Staff sends a priced quote to the sender of one stored inbound WhatsApp message. No AI spend. */
+    interface WhatsAppOrderConfirmationRequest {
+        messageId: string;
+        presupuestoId: string;
+        paymentMethod?: number;
+        deliveryMethod?: number;
+    }
+    type WhatsAppOrderConfirmationStatus = 'sending' | 'awaiting' | 'confirming' | 'confirmed' | 'cancelled' | 'changes_requested' | 'expired' | 'superseded' | 'failed';
+    /**
+     * Public confirmation returned by POST /whatsapp/order-draft/confirmation and
+     * emitted to operator sockets. The private nonce and sender number never reach
+     * this shape. An accepted staff-authored quote is converted through the existing
+     * atomic order service; an AI parse cannot create an order.
+     */
+    interface WhatsAppOrderConfirmation {
+        messageId: string;
+        presupuestoId: string;
+        status: WhatsAppOrderConfirmationStatus;
+        customerId: string;
+        paymentMethod?: number;
+        deliveryMethod?: number;
+        sentBy: {
+            userId: string;
+            fullName: string;
+        };
+        /** Epoch ms; the earlier of the quote expiry and 24 hours after sending. */
+        expiresAt: number;
+        sentMessageId?: string;
+        orderId?: string;
+        /** A stable refusal code, never a raw provider message or customer text. */
+        error?: string;
+        createdAt: number;
+        updatedAt: number;
+    }
+    /**
+     * Route refusals in addition to the existing entitlement/impersonation codes.
+     * `…_DISABLED` (503) is the `whatsappOrderConfirmationEnabled` platform switch;
+     * `…_RECIPIENT_MISMATCH` (409) is a quote whose customer phone is not the
+     * source message's sender; `…_SETTLED` (409) carries the final confirmation
+     * in `data` (confirmed, cancelled, superseded, or failed after the tap).
+     */
+    type WhatsAppOrderConfirmationErrorCode = 'VALIDATION_FAILED' | 'ADMIN_REQUIRED' | 'WHATSAPP_MESSAGE_NOT_FOUND' | 'PRESUPUESTO_NOT_FOUND' | 'PRESUPUESTO_NOT_MUTABLE' | 'CUSTOMER_NOT_FOUND' | 'PAYMENT_METHOD_NOT_FOUND' | 'DELIVERY_METHOD_NOT_FOUND' | 'WHATSAPP_WINDOW_CLOSED' | 'WHATSAPP_ORDER_CONFIRMATION_DISABLED' | 'WHATSAPP_ORDER_CONFIRMATION_RECIPIENT_MISMATCH' | 'WHATSAPP_ORDER_CONFIRMATION_PENDING' | 'WHATSAPP_ORDER_CONFIRMATION_SETTLED' | 'PLATFORM_INTEGRATION_DISABLED' | 'WHATSAPP_NOT_CONNECTED' | 'WHATSAPP_RECIPIENT_NOT_ALLOWED' | 'WHATSAPP_SEND_UNCONFIRMED' | 'WHATSAPP_SEND_FAILED' | 'WHATSAPP_TEMPLATE_NOT_APPROVED' | 'WHATSAPP_RECIPIENT_OPTED_OUT' | 'WHATSAPP_RATE_LIMITED' | 'WHATSAPP_ACCOUNT_SUSPENDED' | 'WHATSAPP_TOKEN_REJECTED';
     /**
      * The ONE spent-budget refusal every AI spend route answers —
      * `POST /products/enrich`, `/reports/narrative`, `/marketing/copy`,

package/dist/cjs/socket.js

@@ -502,10 +502,12 @@ exports.SOCKET_ACTIONS = [
     'notifications',
     'support-message',
     /**
-     * An automatic WhatsApp order draft settled (`ready` or `failed`). Admin
-     * sockets of the store only; `data` is a `WhatsAppStoredOrderDraft`.
+     * An automatic WhatsApp order draft settled (`ready` or `failed`). The
+     * operator sockets of the store only; `data` is a `WhatsAppStoredOrderDraft`.
      */
     'whatsapp-order-draft',
+    /** Staff quote confirmation state; operator audience only, data: WhatsAppOrderConfirmation. */
+    'whatsapp-order-confirmation',
     // Payments & providers.
     'payment_received',
     // Operator-only observation invalidation; never a receipt or customer frame.
@@ -581,8 +583,8 @@ exports.SOCKET_ACTIONS = [
     // ⚠️ A frame for a period whose `periodStatus` is `'OPEN'` carries numbers
     // ML will still restate; a consumer must not render one as final.
     'mercadolibre_settlement_period',
-    // BE → all store users when an avanzado custom domain's provisioning state
-    // moves (`CustomDomainSocketPayload`). Status only: the row's
+    // BE → the store's OPERATOR sockets when an avanzado custom domain's provisioning state
+    // moves, or a teardown removes it (`provisioning: null`) (`CustomDomainSocketPayload`). Status only: the row's
     // `verificationToken` is an ownership credential and is never re-sent here.
     'customDomain',
     // BE → all store users on every purchase-order write: create, update, cancel,

package/dist/log.d.ts

@@ -166,7 +166,8 @@ declare global {
         createdAt: number;
         updatedAt: number;
         dated: number;
-        mode?: string;
+        /** ERROR rows only; the legacy store LOG writer is retired. */
+        mode?: 'error';
         userId?: string;
         customerId?: string;
         fullName?: string;

package/dist/platform.d.ts

@@ -132,6 +132,32 @@ export interface TenantWipeOpBody extends PlatformOperatorReason {
     /** Must equal `storeId`. */
     confirm: string;
 }
+/** Additive admission contract; route activation follows coordinated rollout. */
+export interface TenantOperationV2Body extends PlatformOperatorReason {
+    mode: 'tenant-operation-v2';
+    action: 'delete-tenant' | 'reset-tenant';
+    requestId: string;
+    storeId: string;
+    confirm: string;
+}
+export type TenantOperationState = 'queued' | 'running' | 'uncertain' | 'business-completed' | 'completed' | 'failed';
+export interface TenantOperationClassReport {
+    classId: string;
+    disposition: 'retained' | 'removed' | 'pending' | 'unresolved';
+    reason?: string;
+    counts?: Record<string, number>;
+}
+export interface TenantOperationAdmission {
+    operationId: string;
+    status: TenantOperationState;
+    action: 'delete-tenant' | 'reset-tenant';
+    targetStoreId: string;
+}
+export interface TenantOperationStatus extends TenantOperationAdmission {
+    createdAt: number;
+    updatedAt: number;
+    classes: TenantOperationClassReport[];
+}
 /**
  * `POST /platform/literals` — the MANAGER literals write. The tenant route
  * (`POST /literals`) takes `scope` and `literals` only.

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", "whatsapp-order-draft", "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", "stripe", "subscription", "caea", "print", "print-order", "print-invoice", "print-product", "print-tag", "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"];
+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", "whatsapp-order-draft", "whatsapp-order-confirmation", "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", "stripe", "subscription", "caea", "print", "print-order", "print-invoice", "print-product", "print-tag", "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"];
 /** Union of every server→client data-frame action. */
 export type SocketAction = (typeof SOCKET_ACTIONS)[number];
 /**
@@ -40,6 +40,12 @@ export interface CustomDomainSocketPayload {
     storeId: string;
     /** The NORMALIZED host, as stored on the row. */
     host: string;
+    /**
+     * The attempt as it now stands, or `null` when a teardown (a deprovision, a
+     * revoke, the grace-expiry sweep) removed it — whatever state it was in.
+     * Merge the `null` over a cached row: the attempt is gone, and the host can
+     * be provisioned again.
+     */
     provisioning: {
         state: DomainProvisioningState;
         /** 1-based; see `DomainProvisioning.step`. */
@@ -55,7 +61,7 @@ export interface CustomDomainSocketPayload {
         /** Unix MILLISECONDS. Present once `state` reaches `active`. */
         activatedAt?: number;
         error?: string;
-    };
+    } | null;
     /**
      * See `DomainRecord.deactivatesAt`. Every frame the server sends carries the
      * key — the number, or `null` when the domain is not in grace — so any frame

package/dist/socket.js

@@ -499,10 +499,12 @@ export const SOCKET_ACTIONS = [
     'notifications',
     'support-message',
     /**
-     * An automatic WhatsApp order draft settled (`ready` or `failed`). Admin
-     * sockets of the store only; `data` is a `WhatsAppStoredOrderDraft`.
+     * An automatic WhatsApp order draft settled (`ready` or `failed`). The
+     * operator sockets of the store only; `data` is a `WhatsAppStoredOrderDraft`.
      */
     'whatsapp-order-draft',
+    /** Staff quote confirmation state; operator audience only, data: WhatsAppOrderConfirmation. */
+    'whatsapp-order-confirmation',
     // Payments & providers.
     'payment_received',
     // Operator-only observation invalidation; never a receipt or customer frame.
@@ -578,8 +580,8 @@ export const SOCKET_ACTIONS = [
     // ⚠️ A frame for a period whose `periodStatus` is `'OPEN'` carries numbers
     // ML will still restate; a consumer must not render one as final.
     'mercadolibre_settlement_period',
-    // BE → all store users when an avanzado custom domain's provisioning state
-    // moves (`CustomDomainSocketPayload`). Status only: the row's
+    // BE → the store's OPERATOR sockets when an avanzado custom domain's provisioning state
+    // moves, or a teardown removes it (`provisioning: null`) (`CustomDomainSocketPayload`). Status only: the row's
     // `verificationToken` is an ownership credential and is never re-sent here.
     'customDomain',
     // BE → all store users on every purchase-order write: create, update, cancel,

package/dist/store.d.ts

@@ -1665,6 +1665,7 @@ declare global {
          * that ran out) and the domain keeps serving, and stays the shop's canonical
          * address, until this instant. Then the hourly sweep tears it down: the row
          * stays `VERIFIED`, loses `provisioning`, and this field returns to `null`.
+         * Any other teardown (a deprovision, a revoke) removes it.
          * A domain that never went live gets no grace (the date is the moment of the
          * loss). `null` or absent = not in grace; a re-upgrade clears it.
          */
@@ -1681,9 +1682,14 @@ declare global {
      * `lastCheckedAt` / `startedAt` diagnostics, although this type admits them.
      *
      * Unlike `GET /store/domains`, a PENDING claim whose seven-day window has
-     * lapsed but which DynamoDB has not reaped yet is still listed.
+     * lapsed but which DynamoDB has not reaped yet is still listed (it still
+     * blocks every other store from the host until it is reaped), and carries
+     * `claimExpired: true` so staff can tell it from a live claim.
      */
-    type PlatformDomainRecord = Omit<DomainRecord, 'verificationToken'>;
+    type PlatformDomainRecord = Omit<DomainRecord, 'verificationToken'> & {
+        /** Present (always `true`) only on a PENDING claim whose seven-day window has lapsed. */
+        claimExpired?: true;
+    };
     /**
      * `GET /platform/stores/{storeId}/domains` (supervisorToken: SUPERVISOR,
      * MANAGER) — one store's custom domains plus its public address, so the

package/package.json

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