sinfactura-types 1.6.21 → 1.6.23

package/README.md

@@ -74,7 +74,14 @@ This re-resolves the git ref to the latest commit on `dist` and pins it in the l
 
 > **Why explicit?** `yarn install` does NOT re-resolve git branch refs to their current HEAD — it reuses the cached resolution for reproducibility. Consumers that want auto-bump-on-pull can add a `post-merge` Husky hook that runs `yarn up sinfactura-types@github:sinfactura/types#dist` whenever `package.json`/`yarn.lock` changed in the merge.
 
-## Legacy: Publishing a New NPM Version
+## Publishing
+
+See [`PUBLISHING.md`](./PUBLISHING.md) for the full release workflow — when to
+bump the version, the `dist`-branch and npm channels, the PR checklist, and how
+to coordinate a cross-repo rollout. Per-release summaries live in
+[`CHANGELOG.md`](./CHANGELOG.md).
+
+### Legacy: Publishing a New NPM Version
 
 Kept for reference / external consumers. New SINFACTURA repos should use the git URL instead.
 

package/dist/account.d.ts

@@ -12,6 +12,23 @@ declare global {
         debit?: number;
         credit?: number;
         amount?: number;
+        /**
+         * catalogId (api#942, lowercase e.g. `'ars'`/`'usd-oficial'`) — FK
+         * to PlatformCurrency. Promoted from the api#945 module augmentation
+         * (app#1539 / ADR-0013).
+         *
+         * DENOMINATION CONTRACT: this row's money values (`amount`/`credit`/
+         * `debit`/`balance`) are denominated in the catalogId named here.
+         * When `currency` is ABSENT — which is ≈all legacy/historical rows —
+         * the row is denominated in `store.config.displayCurrency` as it was
+         * at write time, and consumers MUST fall back to it. NEVER infer the
+         * denomination from `customer.currencyId`: that field is a
+         * display/pricing preference (passenger data server-side), and
+         * mislabeling unstamped rows by it is the root cause of api#1333.
+         *
+         * 6 legacy rows carry a raw uppercase ISO `'ARS'` (pre-#1137);
+         * being normalized to catalogId in api#1350.
+         */
         currency?: string;
         currencyValue?: number;
         currencyValueAt?: number;

package/dist/auth.d.ts

@@ -12,6 +12,7 @@ declare global {
         cuit: string;
         fullName: string;
         phone?: string;
+        acknowledgedSharedCuit?: boolean;
     }
     interface Recover {
         email: string;

package/dist/customer.d.ts

@@ -45,6 +45,17 @@ declare global {
         salt?: string;
         search: string;
         updatedAt?: number;
+        /**
+         * catalogId (api#942) — FK to PlatformCurrency.
+         *
+         * DISPLAY / PRICING preference only: which currency this customer
+         * views and transacts in (load-bearing in storefront pricing + the
+         * DNI/CUIT checkout gate). It is NOT a ledger denomination and is
+         * pure passenger data server-side. MUST NOT be used to infer the
+         * denomination of unstamped `ACCOUNT` rows — doing so is the root
+         * cause of api#1333. Unstamped ledger rows fall back to
+         * `store.config.displayCurrency`, never to this field.
+         */
         currencyId?: string;
         deliveryAddress?: {
             fullName: string;

package/dist/demo.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Demo environment types (sinfactura/types#33, part of sinfactura/app#1054).
+ *
+ * Custom JWT claims minted for anonymous public demo sessions
+ * (test.sinfactura.com) and in-app demo tenants. The `readOnly` flag is
+ * enforced server-side via the `requireWritable` gate (ADR-0010 / api#870);
+ * see also `Store.type === 'demo'` in store.ts.
+ */
+declare global {
+    /**
+     * Firebase custom claims attached to a demo session token. The presence of
+     * `demo: true` marks the session as a demo tenant.
+     */
+    interface DemoClaims {
+        /** Always `true` — discriminates a demo session from a real one. */
+        demo: true;
+        /** Tenant the demo session is scoped to. */
+        storeId: string;
+        /** When true, all writes are blocked (view-only demo). */
+        readOnly: boolean;
+    }
+}
+export {};

package/dist/demo.js

@@ -0,0 +1,9 @@
+/**
+ * Demo environment types (sinfactura/types#33, part of sinfactura/app#1054).
+ *
+ * Custom JWT claims minted for anonymous public demo sessions
+ * (test.sinfactura.com) and in-app demo tenants. The `readOnly` flag is
+ * enforced server-side via the `requireWritable` gate (ADR-0010 / api#870);
+ * see also `Store.type === 'demo'` in store.ts.
+ */
+export {};

package/dist/index.d.ts

@@ -9,6 +9,7 @@ export * from "./cash";
 export * from "./categories";
 export * from "./currency";
 export * from "./customer";
+export * from "./demo";
 export * from "./imports";
 export * from "./invoice";
 export * from "./log";
@@ -19,6 +20,8 @@ export * from "./order";
 export * from "./payment";
 export * from "./product";
 export * from "./return";
+export * from "./serviceOrder";
+export * from "./serviceTemplate";
 export * from "./stock";
 export * from "./store";
 export * from "./storefrontEvent";

package/dist/index.js

@@ -9,6 +9,7 @@ export * from "./cash";
 export * from "./categories";
 export * from "./currency";
 export * from "./customer";
+export * from "./demo";
 export * from "./imports";
 export * from "./invoice";
 export * from "./log";
@@ -19,6 +20,8 @@ export * from "./order";
 export * from "./payment";
 export * from "./product";
 export * from "./return";
+export * from "./serviceOrder";
+export * from "./serviceTemplate";
 export * from "./stock";
 export * from "./store";
 export * from "./storefrontEvent";

package/dist/invoice.d.ts

@@ -34,6 +34,10 @@ declare global {
         caeExpiration: string;
         observations?: string;
         fiscalStatus?: FiscalStatus;
+        serviceStartDate?: number;
+        serviceEndDate?: number;
+        paymentDueDate?: number;
+        serviceOrderId?: string;
     }
     interface InvoiceItem {
         code: string;

package/dist/serviceOrder.d.ts

@@ -0,0 +1,139 @@
+/**
+ * Service order types — repair / installation / maintenance / diagnosis
+ * workflows ("Órdenes de Servicio").
+ *
+ * Phase 1 Foundation for the Services Feature (sinfactura/app#758,
+ * sinfactura/types#30). A ServiceOrder is a parallel entity to the
+ * product-sales Order pipeline: multi-stage workflow, technician assignment,
+ * equipment intake, parts consumption, and AFIP concept=2 service invoicing.
+ *
+ * Companion: ServiceTemplate (serviceTemplate.ts, sinfactura/types#31) defines
+ * per-type default configuration that seeds new orders.
+ */
+declare global {
+    /** Kind of service. Drives which workflow stages apply (see ServiceTemplate). */
+    type ServiceType = 'repair' | 'installation' | 'maintenance' | 'diagnosis';
+    /**
+     * Workflow stage of a service order. The canonical full repair pipeline is
+     * received → diagnosing → quoted → approved → in_progress → testing → ready →
+     * delivered, plus the terminal `cancelled`. Simpler service types skip stages
+     * (configured per `ServiceTemplate.requiredStages`).
+     */
+    type ServiceStatus = 'received' | 'diagnosing' | 'quoted' | 'approved' | 'in_progress' | 'testing' | 'ready' | 'delivered' | 'cancelled';
+    /** Operator-set urgency, used for Kanban ordering and SLA hints. */
+    type ServicePriority = 'low' | 'normal' | 'high' | 'urgent';
+    /**
+     * How the service is priced.
+     * - `flat`        — single fixed price.
+     * - `hourly`      — labor billed by the hour (`laborRate` × hours).
+     * - `parts_labor` — parts at cost/markup + labor.
+     * - `diagnostic`  — fixed diagnostic fee.
+     * - `warranty`    — no charge (covered under warranty).
+     */
+    type PricingModel = 'flat' | 'hourly' | 'parts_labor' | 'diagnostic' | 'warranty';
+    /** A single inventory part consumed on a service order. */
+    interface PartUsed {
+        productId: string;
+        sku: string;
+        name: string;
+        quantity: number;
+        unitCost: number;
+        total: number;
+    }
+    /** A technician work session logged against a service order (manual hours at V1). */
+    interface WorkLog {
+        workLogId: string;
+        technicianId: string;
+        /** Unix ms of the work session. */
+        date: number;
+        /** Hours worked in this session. */
+        hours: number;
+        description: string;
+        partsUsed?: PartUsed[];
+    }
+    /** One entry in a service order's status history (append-only audit trail). */
+    interface ServiceStatusEntry {
+        status: ServiceStatus;
+        /** Unix ms when the transition happened. */
+        timestamp: number;
+        /** User who triggered the transition. */
+        userId: string;
+        notes?: string;
+    }
+    /**
+     * Core service-order entity. Parallel to `Order` but with a multi-stage
+     * workflow, equipment intake, technician assignment, and service-specific
+     * pricing. Stored in its own DynamoDB partition (sinfactura/api#637).
+     */
+    interface ServiceOrder {
+        storeId: string;
+        serviceOrderId: string;
+        /** Human-facing sequential ticket number shown to the customer. */
+        ticketNumber: string;
+        customerId: string;
+        serviceType: ServiceType;
+        /** FK to the `ServiceTemplate` this order was created from, if any. */
+        templateId?: string;
+        priority: ServicePriority;
+        status: ServiceStatus;
+        statusHistory: ServiceStatusEntry[];
+        /** When true the order is paused (waiting on parts, customer, etc.). */
+        onHold: boolean;
+        equipment?: {
+            type?: string;
+            brand?: string;
+            model?: string;
+            serialNumber?: string;
+            /** Accessories received with the equipment (charger, case, …). */
+            accessories?: string[];
+            /** Cosmetic / functional condition noted at intake. */
+            condition?: string;
+            /** Customer-reported fault. */
+            reportedIssue?: string;
+        };
+        diagnosis?: {
+            notes: string;
+            diagnosedBy?: string;
+            /** Unix ms. */
+            diagnosedAt?: number;
+        };
+        quote?: {
+            pricingModel: PricingModel;
+            laborCost?: number;
+            partsCost?: number;
+            amount: number;
+            /** Unix ms when the quote was presented to the customer. */
+            quotedAt?: number;
+            /** Set once the customer approves / rejects. */
+            approved?: boolean;
+            approvedBy?: string;
+            approvedAt?: number;
+        };
+        technicianId?: string;
+        /** Unix ms the order was assigned. */
+        assignedAt?: number;
+        workLogs: WorkLog[];
+        partsUsed: PartUsed[];
+        pricingModel: PricingModel;
+        laborRate?: number;
+        laborCost?: number;
+        partsCost?: number;
+        discount?: number;
+        total?: number;
+        /**
+         * Self-describing currency catalogId stamp (see the currency taxonomy in
+         * `currency.ts`). Absent rows fall back to `store.config.displayCurrency`.
+         */
+        currency?: string;
+        createdAt: number;
+        updatedAt: number;
+        /** Promised completion / pickup date shown to the customer. */
+        promisedAt?: number;
+        deliveredAt?: number;
+        invoiceId?: string;
+        warrantyDays?: number;
+        /** Unix ms the warranty expires (stamped at delivery). */
+        warrantyExpiresAt?: number;
+    }
+}
+export {};

package/dist/serviceOrder.js

@@ -0,0 +1,13 @@
+/**
+ * Service order types — repair / installation / maintenance / diagnosis
+ * workflows ("Órdenes de Servicio").
+ *
+ * Phase 1 Foundation for the Services Feature (sinfactura/app#758,
+ * sinfactura/types#30). A ServiceOrder is a parallel entity to the
+ * product-sales Order pipeline: multi-stage workflow, technician assignment,
+ * equipment intake, parts consumption, and AFIP concept=2 service invoicing.
+ *
+ * Companion: ServiceTemplate (serviceTemplate.ts, sinfactura/types#31) defines
+ * per-type default configuration that seeds new orders.
+ */
+export {};

package/dist/serviceTemplate.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Service template types — pre-defined per-service-type configuration for the
+ * Services Feature (sinfactura/app#758, sinfactura/types#31).
+ *
+ * A ServiceTemplate seeds defaults onto a new ServiceOrder: which workflow
+ * stages are mandatory, default pricing model / rates, QA checklists, and
+ * common parts auto-populated on intake. Shares the ServiceType / ServiceStatus
+ * / PricingModel unions defined in serviceOrder.ts.
+ */
+declare global {
+    /** A single QA checklist item on a service template. */
+    interface ServiceChecklistItem {
+        step: string;
+        description?: string;
+        required: boolean;
+    }
+    /** A commonly-used part auto-populated onto orders created from the template. */
+    interface ServiceCommonPart {
+        productId: string;
+        name: string;
+        quantity: number;
+    }
+    /**
+     * Pre-defined configuration for a service type. Defines the default workflow,
+     * pricing, checklists, and common parts for orders created from it. One per
+     * (storeId, templateId).
+     */
+    interface ServiceTemplate {
+        storeId: string;
+        templateId: string;
+        /** Display name, e.g. "Reparación de motor eléctrico". */
+        name: string;
+        description: string;
+        serviceType: ServiceType;
+        categoryId?: string;
+        /** Which workflow stages are mandatory for orders using this template. */
+        requiredStages: ServiceStatus[];
+        /** Auto-proceed without quote approval. */
+        skipQuote: boolean;
+        /** Whether equipment intake is needed. */
+        requiresEquipment: boolean;
+        estimatedHours: number;
+        basePrice: number;
+        pricingModel: PricingModel;
+        laborRate?: number;
+        warrantyDays?: number;
+        checklist: ServiceChecklistItem[];
+        commonParts: ServiceCommonPart[];
+        disabled: boolean;
+    }
+}
+export {};

package/dist/serviceTemplate.js

@@ -0,0 +1,10 @@
+/**
+ * Service template types — pre-defined per-service-type configuration for the
+ * Services Feature (sinfactura/app#758, sinfactura/types#31).
+ *
+ * A ServiceTemplate seeds defaults onto a new ServiceOrder: which workflow
+ * stages are mandatory, default pricing model / rates, QA checklists, and
+ * common parts auto-populated on intake. Shares the ServiceType / ServiceStatus
+ * / PricingModel unions defined in serviceOrder.ts.
+ */
+export {};

package/dist/store.d.ts

@@ -4,10 +4,6 @@ declare global {
         fiscalConditions: FiscalCondition[];
         ivaTypes: Method[];
         minWithDni: number;
-        notificationOptions: {
-            id: string;
-            name: string;
-        }[];
         stats: {
             store: number;
         };
@@ -105,6 +101,7 @@ declare global {
     interface Store {
         storeId: string;
         createdAt: number;
+        type?: 'production' | 'demo';
         name: string;
         address: {
             street: string;
@@ -115,6 +112,7 @@ declare global {
         cuit: string;
         phone: string;
         email: string;
+        acknowledgedSharedCuit?: boolean;
         config: {
             priceDecimals: 0 | 1 | 2 | 3;
             stock: boolean;
@@ -124,6 +122,12 @@ declare global {
              * the operator's screens are framed in — distinct from the
              * currency of any individual money entity (Order / Invoice /
              * etc carry their own self-describing `currency` stamps).
+             *
+             * NOTE: the self-describing-stamp invariant is true for Order /
+             * Invoice but only ASPIRATIONAL for ACCOUNT — `Account.currency`
+             * is optional and ≈100% of historical rows are unstamped, so they
+             * fall back to THIS field for their denomination (tracked
+             * api#1333 / api#1352).
              */
             displayCurrency?: string;
             /**
@@ -173,13 +177,13 @@ declare global {
         fiscalConditions: FiscalCondition[];
         ivaTypes: Method[];
         minWithDni: number;
-        notificationOptions?: Method[];
         maintenance?: MaintenanceInfo;
         legacyCurrencyIds?: Record<number, string>;
     }
     interface StoreIntegrations {
         afip?: Afip;
         mercadopago?: Mercadopago;
+        whatsapp?: WhatsAppConfig;
     }
     type FxAutoUpdateStrategy = "overwrite" | "overwrite-if-stale" | "notify-only";
     interface FxAutoUpdateBinding {

package/dist/userActivity.d.ts

@@ -328,7 +328,61 @@ declare global {
         event: 'Impersonation UI Ended';
         target_store_id: string;
     }
-    type UserActivityEvent = UserLoggedInEvent | UserLoggedOutEvent | UserPasswordChangedEvent | UserSuspendedEvent | TwoFactorEnrolledEvent | TwoFactorDisabledEvent | TwoFactorResetEvent | TwoFactorRecoveryCodesGeneratedEvent | StorePaletteChangedEvent | StoreSettingsUpdatedEvent | PlanChangedEvent | InvoiceCreatedEvent | OrderCreatedEvent | OrderCancelledEvent | ProductPriceChangedEvent | CustomerCreatedEvent | CustomerEditedEvent | CashDrawerOpenedEvent | CashDrawerClosedEvent | TenantImpersonatedEvent | SecretRotatedEvent | UserCreatedEvent | UserUpdatedEvent | ProductCreatedEvent | ProductUpdatedEvent | StockIncomeCreatedEvent | CategoryCreatedEvent | CategoryUpdatedEvent | BrandCreatedEvent | BrandUpdatedEvent | SupplierCreatedEvent | SupplierUpdatedEvent | SupplierInvoiceCreatedEvent | SupplierAccountCreatedEvent | SupplierAccountUpdatedEvent | AccountCreatedEvent | AccountDeletedEvent | BasketUpdatedEvent | BasketDeletedEvent | CashDrawerMovementEvent | PaymentCreatedEvent | PaymentLinkedEvent | PaymentUnlinkedEvent | PaymentLinkageUpdatedEvent | NotificationReadEvent | LogDeletedEvent | PlanCreatedEvent | StoreMaintenanceToggledEvent | PlatformMaintenanceToggledEvent | TenantCreatedEvent | LiteralUpdatedEvent | SupportTicketCreatedEvent | SupportTicketUpdatedEvent | AuditTrailViewedEvent | ReportViewedEvent | CustomerPiiViewedEvent | CashDrawerUiOpenedEvent | CashDrawerUiClosedEvent | ExportInitiatedEvent | ImpersonationUiStartedEvent | ImpersonationUiEndedEvent;
+    interface PaymentViewedEvent extends UserActivityEventBase {
+        event: 'Payment Viewed';
+        payment_id: string;
+        source?: string;
+        linked_status?: 'linked' | 'unlinked';
+    }
+    interface InvoiceViewedEvent extends UserActivityEventBase {
+        event: 'Invoice Viewed';
+        invoice_id: string;
+        fiscal_status?: string;
+    }
+    interface CustomerDetailViewedEvent extends UserActivityEventBase {
+        event: 'Customer Detail Viewed';
+        customer_id: string;
+    }
+    interface SupplierAccountViewedEvent extends UserActivityEventBase {
+        event: 'Supplier Account Viewed';
+        supplier_id: string;
+    }
+    interface SearchPerformedEvent extends UserActivityEventBase {
+        event: 'Search Performed';
+        scope: 'customers' | 'audit' | 'suppliers' | 'invoices' | 'payments';
+        query_hash?: string;
+        result_count?: number;
+    }
+    interface ActionDeniedEvent extends UserActivityEventBase {
+        event: 'Action Denied';
+        attempted_action: string;
+        resource_type: string;
+        resource_id?: string;
+        reason: 'permission' | 'subscription' | 'maintenance';
+    }
+    interface TwoFactorChallengeShownEvent extends UserActivityEventBase {
+        event: 'Two-Factor Challenge Shown';
+        method: 'password' | 'social';
+        provider?: string;
+    }
+    interface TwoFactorCodeValidationFailedEvent extends UserActivityEventBase {
+        event: 'Two-Factor Code Validation Failed';
+        method: 'totp' | 'recovery';
+        attempt_number?: number;
+    }
+    interface TwoFactorEnrollmentStartedEvent extends UserActivityEventBase {
+        event: 'Two-Factor Enrollment Started';
+    }
+    interface TwoFactorRecoveryCodesRevealedEvent extends UserActivityEventBase {
+        event: 'Two-Factor Recovery Codes Revealed';
+        code_count: number;
+    }
+    interface TwoFactorResetInitiatedEvent extends UserActivityEventBase {
+        event: 'Two-Factor Reset Initiated';
+        target_user_id: string;
+        initiator_role: string;
+    }
+    type UserActivityEvent = UserLoggedInEvent | UserLoggedOutEvent | UserPasswordChangedEvent | UserSuspendedEvent | TwoFactorEnrolledEvent | TwoFactorDisabledEvent | TwoFactorResetEvent | TwoFactorRecoveryCodesGeneratedEvent | StorePaletteChangedEvent | StoreSettingsUpdatedEvent | PlanChangedEvent | InvoiceCreatedEvent | OrderCreatedEvent | OrderCancelledEvent | ProductPriceChangedEvent | CustomerCreatedEvent | CustomerEditedEvent | CashDrawerOpenedEvent | CashDrawerClosedEvent | TenantImpersonatedEvent | SecretRotatedEvent | UserCreatedEvent | UserUpdatedEvent | ProductCreatedEvent | ProductUpdatedEvent | StockIncomeCreatedEvent | CategoryCreatedEvent | CategoryUpdatedEvent | BrandCreatedEvent | BrandUpdatedEvent | SupplierCreatedEvent | SupplierUpdatedEvent | SupplierInvoiceCreatedEvent | SupplierAccountCreatedEvent | SupplierAccountUpdatedEvent | AccountCreatedEvent | AccountDeletedEvent | BasketUpdatedEvent | BasketDeletedEvent | CashDrawerMovementEvent | PaymentCreatedEvent | PaymentLinkedEvent | PaymentUnlinkedEvent | PaymentLinkageUpdatedEvent | NotificationReadEvent | LogDeletedEvent | PlanCreatedEvent | StoreMaintenanceToggledEvent | PlatformMaintenanceToggledEvent | TenantCreatedEvent | LiteralUpdatedEvent | SupportTicketCreatedEvent | SupportTicketUpdatedEvent | AuditTrailViewedEvent | ReportViewedEvent | CustomerPiiViewedEvent | CashDrawerUiOpenedEvent | CashDrawerUiClosedEvent | ExportInitiatedEvent | ImpersonationUiStartedEvent | ImpersonationUiEndedEvent | PaymentViewedEvent | InvoiceViewedEvent | CustomerDetailViewedEvent | SupplierAccountViewedEvent | SearchPerformedEvent | ActionDeniedEvent | TwoFactorChallengeShownEvent | TwoFactorCodeValidationFailedEvent | TwoFactorEnrollmentStartedEvent | TwoFactorRecoveryCodesRevealedEvent | TwoFactorResetInitiatedEvent;
 }
 /**
  * Canonical whitelist of UI-only `UserActivityEvent` variant names — the 8
@@ -340,5 +394,5 @@ declare global {
  * Source of truth lives here so the api whitelist can't drift from the
  * actual UI-only variant taxonomy.
  */
-export declare const UI_ONLY_USER_ACTIVITY_VARIANTS: readonly ["Audit Trail Viewed", "Report Viewed", "Customer PII Viewed", "Cash Drawer UI Opened", "Cash Drawer UI Closed", "Export Initiated", "Impersonation UI Started", "Impersonation UI Ended"];
+export declare const UI_ONLY_USER_ACTIVITY_VARIANTS: readonly ["Audit Trail Viewed", "Report Viewed", "Customer PII Viewed", "Cash Drawer UI Opened", "Cash Drawer UI Closed", "Export Initiated", "Impersonation UI Started", "Impersonation UI Ended", "Payment Viewed", "Invoice Viewed", "Customer Detail Viewed", "Supplier Account Viewed", "Search Performed", "Action Denied", "Two-Factor Challenge Shown", "Two-Factor Code Validation Failed", "Two-Factor Enrollment Started", "Two-Factor Recovery Codes Revealed", "Two-Factor Reset Initiated"];
 export type UiOnlyUserActivityVariant = (typeof UI_ONLY_USER_ACTIVITY_VARIANTS)[number];

package/dist/userActivity.js

@@ -40,4 +40,18 @@ export const UI_ONLY_USER_ACTIVITY_VARIANTS = [
     'Export Initiated',
     'Impersonation UI Started',
     'Impersonation UI Ended',
+    // Phase 4 (api#1266) — FE emits each through the ingest gate. `Action Denied`
+    // is whitelisted for the FE-gate path (pre-roundtrip maintenance/subscription/
+    // permission denials); the real BE 403 row is written server-side, not POSTed.
+    'Payment Viewed',
+    'Invoice Viewed',
+    'Customer Detail Viewed',
+    'Supplier Account Viewed',
+    'Search Performed',
+    'Action Denied',
+    'Two-Factor Challenge Shown',
+    'Two-Factor Code Validation Failed',
+    'Two-Factor Enrollment Started',
+    'Two-Factor Recovery Codes Revealed',
+    'Two-Factor Reset Initiated',
 ];

package/dist/whatsapp.d.ts

@@ -88,5 +88,87 @@ declare global {
         pricing_model: 'CBP' | string;
         category: 'user_initiated' | string;
     }
+    /** Per-tenant WhatsApp Business connection + plan tier. */
+    interface WhatsAppConfig {
+        wabaId: string;
+        phoneNumberId: string;
+        /** Meta access token — encrypted at rest. */
+        accessToken: string;
+        verifiedName: string;
+        qualityRating: 'GREEN' | 'YELLOW' | 'RED';
+        status: 'connected' | 'disconnected' | 'suspended';
+        tier: 'free' | 'pro' | 'enterprise';
+        /** ISO timestamp. */
+        connectedAt: string;
+        /** ISO timestamp. */
+        disconnectedAt?: string;
+    }
+    /** A customer conversation thread. */
+    interface WhatsAppConversation {
+        conversationId: string;
+        storeId: string;
+        customerId: string;
+        customerPhone: string;
+        customerName: string;
+        lastMessage: WhatsAppChatMessage;
+        unreadCount: number;
+        status: 'active' | 'resolved';
+        /** userId of the assigned agent (Enterprise tier). */
+        assignedTo?: string;
+        /** ISO timestamp. */
+        createdAt: string;
+        /** ISO timestamp. */
+        updatedAt: string;
+    }
+    /** A single message within a conversation. */
+    interface WhatsAppChatMessage {
+        messageId: string;
+        conversationId: string;
+        direction: 'inbound' | 'outbound';
+        type: 'text' | 'template' | 'image' | 'document' | 'interactive';
+        content: string;
+        templateName?: string;
+        mediaUrl?: string;
+        status: 'sent' | 'delivered' | 'read' | 'failed';
+        /** ISO timestamp. */
+        timestamp: string;
+        /** userId for outbound messages. */
+        sentBy?: string;
+    }
+    /** Per-tenant, per-period message usage for metered billing (Model C). */
+    interface WhatsAppUsage {
+        storeId: string;
+        /** Billing period, YYYY-MM. */
+        billingPeriod: string;
+        messageCount: number;
+        allowance: number;
+        overage: number;
+        tier: 'free' | 'pro' | 'enterprise';
+    }
+    /** A reusable message template registered with Meta. */
+    interface WhatsAppTemplate {
+        templateId: string;
+        name: string;
+        category: 'marketing' | 'utility' | 'authentication';
+        language: string;
+        status: 'APPROVED' | 'PENDING' | 'REJECTED';
+        components: WhatsAppTemplateComponent[];
+        /** ISO timestamp. */
+        createdAt: string;
+        /** ISO timestamp. */
+        updatedAt: string;
+    }
+    interface WhatsAppTemplateComponent {
+        type: 'HEADER' | 'BODY' | 'FOOTER' | 'BUTTONS';
+        format?: 'TEXT' | 'IMAGE' | 'VIDEO' | 'DOCUMENT';
+        text?: string;
+        buttons?: WhatsAppTemplateButton[];
+    }
+    interface WhatsAppTemplateButton {
+        type: 'QUICK_REPLY' | 'URL' | 'PHONE_NUMBER';
+        text: string;
+        url?: string;
+        phoneNumber?: string;
+    }
 }
 export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sinfactura-types",
-  "version": "1.6.21",
+  "version": "1.6.23",
   "main": "dist/index.js",
   "type": "module",
   "types": "./dist/index.d.ts",