sinfactura-types 1.10.607 → 1.10.609

package/dist/audit.d.ts

@@ -9,6 +9,8 @@ declare global {
      */
     interface OrderAuditEntry {
         entity: 'ORDER';
+        /** Absent on older API responses; legacy rows carry status: legacy. */
+        audit?: PublicAuditMetadata;
         /** The `orderId`. */
         entityId: string;
         storeId: string;

package/dist/auditEnvelope.d.ts

@@ -0,0 +1,73 @@
+declare global {
+    type EntityAuditEntity = 'PLAN' | 'STORE' | 'PAYMENT' | 'ORDER' | 'MERCADOPAGO' | 'INVOICE' | 'SUBSCRIPTION' | 'USER' | 'CUSTOMER' | 'INTEGRATION' | 'PLATFORM';
+    /** Existing business fields with independently projected public metadata. */
+    interface EntityAuditHttpEntry {
+        entity: EntityAuditEntity;
+        entityId: string;
+        storeId?: string;
+        timestamp: number;
+        actor: OrderAuditActor;
+        action: string;
+        before: Record<string, unknown>;
+        after: Record<string, unknown>;
+        reason: string;
+        createdAt: number;
+        origin?: OrderAuditOrigin;
+        audit: PublicAuditMetadata;
+    }
+    /** Internal, forward-only metadata; independent of each event's schema_version. */
+    interface AuditEnvelopeV1 {
+        envelopeVersion: 1;
+        eventId: string;
+        surface: AuditSurface;
+        dataClass: AuditDataClass;
+        scope: {
+            kind: 'tenant';
+            tenantId: string;
+        } | {
+            kind: 'platform';
+        } | {
+            kind: 'unknown';
+        };
+        occurredAt: string;
+        recordedAt: string;
+        actor: {
+            principal: {
+                kind: 'user' | 'customer' | 'platform-user';
+                id: string;
+            } | {
+                kind: 'system' | 'anonymous' | 'unknown';
+            };
+            resolution: 'named' | 'name-unresolved' | 'system' | 'anonymous' | 'unknown';
+            /** Trusted support context only; never a public projection. */
+            support?: {
+                operatorId: string;
+                sessionId: string;
+            };
+        };
+        subject?: {
+            type: string;
+            id: string;
+        };
+        targets?: {
+            type: string;
+            id: string;
+        }[];
+        action: string;
+        correlationId?: string;
+        causationId?: string;
+    }
+    type AuditSurface = 'storefrontEvents' | 'userActivity' | 'entityAudit' | 'storeLogPartition' | 'errorPartition' | 'fiscalAudit' | 'loginHistory' | 'outboundMessageLog' | 'impersonationAudit' | 'notifyDelivery' | 'orderOutbox';
+    type AuditDataClass = 'customer-analytics' | 'operator-audit' | 'entity-diff-history' | 'legacy-mixed-log' | 'operational-error' | 'fiscal-interaction-log' | 'security-audit' | 'outbound-message-forensics' | 'privileged-access-audit' | 'notification-delivery-outcome' | 'delivery-intent';
+    /** Public metadata contains no internal attribution, references or bookkeeping. */
+    type PublicAuditMetadata = {
+        status: 'legacy';
+    } | {
+        status: 'v1';
+        envelopeVersion: 1;
+        eventId: string;
+        occurredAt: string;
+        recordedAt: string;
+    };
+}
+export {};

package/dist/auditEnvelope.js

@@ -0,0 +1 @@
+export {};

package/dist/cjs/auditEnvelope.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/index.js

@@ -28,6 +28,7 @@ __exportStar(require("./ai.js"), exports);
 __exportStar(require("./api.js"), exports);
 __exportStar(require("./appointment.js"), exports);
 __exportStar(require("./audit.js"), exports);
+__exportStar(require("./auditEnvelope.js"), exports);
 __exportStar(require("./attendance.js"), exports);
 __exportStar(require("./auth.js"), exports);
 __exportStar(require("./basket.js"), exports);

package/dist/cjs/socket.js

@@ -503,7 +503,6 @@ exports.SOCKET_ACTIONS = [
     // Notifications & messaging.
     'notifications',
     'support-message',
-    'whatsapp-message',
     /**
      * An automatic WhatsApp order draft settled (`ready` or `failed`). Admin
      * sockets of the store only; `data` is a `WhatsAppStoredOrderDraft`.

package/dist/index.d.ts

@@ -4,6 +4,7 @@ export * from './ai.ts';
 export * from './api.ts';
 export * from './appointment.ts';
 export * from './audit.ts';
+export * from './auditEnvelope.ts';
 export * from './attendance.ts';
 export * from './auth.ts';
 export * from './basket.ts';

package/dist/index.js

@@ -12,6 +12,7 @@ export * from "./ai.js";
 export * from "./api.js";
 export * from "./appointment.js";
 export * from "./audit.js";
+export * from "./auditEnvelope.js";
 export * from "./attendance.js";
 export * from "./auth.js";
 export * from "./basket.js";

package/dist/notification.d.ts

@@ -284,12 +284,13 @@ declare global {
      * What the outbound seam (`notify()`) knew about one call the moment its
      * transport returned. It is never a delivery receipt: `enqueued` and
      * `handed-off` say a queue or a sender took the message, and `sent` says the
-     * provider accepted it. What the provider did next arrives later, through
-     * `EMAILEVENT#`.
+     * provider accepted it. Later SES events arrive through `EMAILEVENT#`;
+     * WhatsApp status callbacks update the established `WHATSAPP#` history.
      */
-    type NotifyDeliveryOutcome = 'sent' | 'not-sent' | 'enqueued' | 'handed-off' | 'failed';
+    type NotifyDeliveryOutcome = 'sent' | 'suppressed' | 'not-sent' | 'enqueued' | 'handed-off' | 'failed';
     /** Why a channel did not deliver, including send-time preference refusals. */
     type NotifyNotSentReason = 'skipped-by-preference' | 'demo' | 'suppressed' | 'refused';
+    type NotifyWhatsAppSuppressionReason = 'allowlist-missing' | 'recipient-malformed' | 'recipient-not-allowlisted';
     /**
      * A recorded transport outcome or send-time preference refusal — the
      * wire half of the `NOTIFY#{storeId}` delivery row. The stored row,
@@ -304,14 +305,14 @@ declare global {
      * `transport`, plus a count.
      */
     interface NotifyDelivery {
-        transport: 'email' | 'queue' | 'ses' | 'ses-marketing' | 'push';
+        transport: 'email' | 'queue' | 'ses' | 'ses-marketing' | 'push' | 'whatsapp';
         /** The closed audience enum `notify()` accepts. */
         audience: 'store-customer' | 'account-holder' | 'store-operator' | 'platform-staff' | 'marketing-recipient';
         /** The producer's event name. Never recipient data. */
         logTag: string;
         outcome: NotifyDeliveryOutcome;
-        /** Only when `outcome` is `'not-sent'`. */
-        reason?: NotifyNotSentReason;
+        /** Only when `outcome` is `'not-sent'` or `'suppressed'`. */
+        reason?: NotifyNotSentReason | NotifyWhatsAppSuppressionReason;
         /** Provider channel for sent email; semantic channel for preference skips. */
         channel?: 'gmail' | 'ses' | NotificationPreferenceChannel;
         /** Only when SES returned one. The join key to `EMAILEVENT#`. */

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-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", "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];
 /**

package/dist/socket.js

@@ -500,7 +500,6 @@ export const SOCKET_ACTIONS = [
     // Notifications & messaging.
     'notifications',
     'support-message',
-    'whatsapp-message',
     /**
      * An automatic WhatsApp order draft settled (`ready` or `failed`). Admin
      * sockets of the store only; `data` is a `WhatsAppStoredOrderDraft`.

package/dist/subscription.d.ts

@@ -247,6 +247,7 @@ declare global {
      * `before`/`after` carry only the fields that changed (diff slice).
      */
     interface PlanAuditEntry {
+        audit?: PublicAuditMetadata;
         entity: 'PLAN';
         entityId: string;
         timestamp: number;
@@ -495,6 +496,7 @@ declare global {
      * each side structurally rather than trusting every field to be present.
      */
     interface SubscriptionAuditEntry {
+        audit?: PublicAuditMetadata;
         storeId: string;
         timestamp: number;
         actor: {

package/package.json

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