sinfactura-types 1.6.42 → 1.6.44

package/dist/index.d.ts

@@ -15,10 +15,12 @@ export * from "./imports";
 export * from "./invoice";
 export * from "./log";
 export * from "./maintenance";
+export * from "./mercadolibre";
 export * from "./mercadopago";
 export * from "./notification";
 export * from "./order";
 export * from "./payment";
+export * from "./platform";
 export * from "./pricing";
 export * from "./print";
 export * from "./product";

package/dist/index.js

@@ -15,10 +15,12 @@ export * from "./imports";
 export * from "./invoice";
 export * from "./log";
 export * from "./maintenance";
+export * from "./mercadolibre";
 export * from "./mercadopago";
 export * from "./notification";
 export * from "./order";
 export * from "./payment";
+export * from "./platform";
 export * from "./pricing";
 export * from "./print";
 export * from "./product";

package/dist/mercadolibre.d.ts

@@ -0,0 +1,65 @@
+declare global {
+    interface MlOauthTokenResponse {
+        access_token: string;
+        token_type?: string;
+        expires_in: number;
+        scope?: string;
+        user_id: number;
+        refresh_token: string;
+    }
+    interface MlOauthInitiateResponse {
+        authorizationUrl: string;
+    }
+    interface MlOauthCallbackResponse {
+        connected: true;
+        storeId: string;
+        mercadolibreUserId: string;
+        expiresAt: number;
+        connectedAt: number;
+    }
+    type MlOauthErrorCode = "OAUTH_USER_DENIED" | "OAUTH_STATE_MISMATCH" | "OAUTH_EXCHANGE_FAILED" | "ML_OAUTH_NOT_CONFIGURED" | "ML_REDIRECT_URI_MISMATCH" | "ML_OFFLINE_ACCESS_NOT_GRANTED" | "ML_OPERATOR_SUB_ACCOUNT";
+    interface MercadolibreStatus {
+        connected: boolean;
+        status: MercadolibreConnectionStatus;
+        userId?: string;
+        nickname?: string;
+        connectedAt?: number;
+        expiresAt?: number;
+        autoInvoice?: boolean;
+        defaultPosId?: number;
+        syncPolicy?: Mercadolibre["syncPolicy"];
+    }
+    interface MlWebhookEvent {
+        _id: string;
+        resource: string;
+        user_id: number;
+        topic: string;
+        application_id: number;
+        attempts: number;
+        sent: string;
+        received: string;
+    }
+    type MlMatchGrade = "vinculada" | "para-revisar" | "sin-vincular";
+    type MlMatchBasis = "seller_sku" | "gtin" | "title";
+    interface MlMatchSuggestion {
+        productId: string;
+        sku?: string;
+        mlItemId: string;
+        mlTitle?: string;
+        userProductId?: string;
+        familyId?: string;
+        variationId?: string;
+        grade: MlMatchGrade;
+        basis?: MlMatchBasis;
+    }
+    interface MercadolibreOrderWsPayload {
+        orderId: string;
+        mlOrderId: string;
+        packId?: string;
+        buyerNickname?: string;
+        total: number;
+        currency: string;
+        paidAt?: number;
+    }
+}
+export {};

package/dist/mercadolibre.js

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

package/dist/notification.d.ts

@@ -6,7 +6,8 @@ export declare enum NotificationTypeEnum {
     DOLARINFORMAL = "DOLARINFORMAL",
     DOLARBNA = "DOLARBNA",
     ERROR = "ERROR",
-    AFIP_CERT_EXPIRY = "AFIP_CERT_EXPIRY"
+    AFIP_CERT_EXPIRY = "AFIP_CERT_EXPIRY",
+    MERCADOLIBRE = "MERCADOLIBRE"
 }
 declare global {
     interface NotificationInterface {

package/dist/notification.js

@@ -17,4 +17,7 @@ export var NotificationTypeEnum;
     NotificationTypeEnum["DOLARBNA"] = "DOLARBNA";
     NotificationTypeEnum["ERROR"] = "ERROR";
     NotificationTypeEnum["AFIP_CERT_EXPIRY"] = "AFIP_CERT_EXPIRY";
+    // ML order-ingestion fanout (app#797 / api#1574) — User-row read path
+    // added by the orders_v2 worker.
+    NotificationTypeEnum["MERCADOLIBRE"] = "MERCADOLIBRE";
 })(NotificationTypeEnum || (NotificationTypeEnum = {}));

package/dist/order.d.ts

@@ -56,6 +56,42 @@ declare global {
             };
         };
         linkedPayments?: Record<string, LinkedPaymentEntry>;
+        channel?: OrderChannel;
+        mercadolibre?: OrderMercadolibre;
+    }
+    type OrderChannel = 'meli';
+    interface OrderMercadolibre {
+        mlOrderId: string;
+        packId?: string;
+        buyerNickname?: string;
+        shipmentId?: string;
+        logisticType?: string;
+        items?: OrderMercadolibreItem[];
+        fees?: {
+            saleFee?: number;
+            shippingCostSeller?: number;
+            currency: string;
+            currencyValue?: number;
+            currencyValueAt?: number;
+        };
+        billingInfo?: {
+            docType?: string;
+            docNumber?: string;
+            custType?: 'CO' | 'BU';
+            taxpayerType?: string;
+            iibbNumber?: string;
+        };
+    }
+    interface OrderMercadolibreItem {
+        mlItemId: string;
+        variationId?: string;
+        userProductId?: string;
+        sellerSku?: string;
+        quantity: number;
+        stock?: {
+            mlStoreId?: string;
+            networkNodeId?: string;
+        }[];
     }
     interface LinkedPaymentEntry {
         source: 'mp' | 'stripe' | 'mp_movement';

package/dist/platform.d.ts

@@ -0,0 +1,21 @@
+export interface PlatformConfigEntry {
+    key: string;
+    valueType: 'boolean' | 'string' | 'number';
+    kind: 'setting' | 'flag';
+    value: string | number | boolean;
+    defaultValue: string | number | boolean;
+    scope: 'app' | 'web' | 'landing' | 'storefront';
+    description?: string;
+    updatedBy?: string;
+    updatedAt?: number;
+    previousValue?: string | number | boolean;
+    source: 'default' | 'override';
+}
+export interface PlatformGlobalsPostBody {
+    globals: Record<string, {
+        value: string | number | boolean | null;
+        valueType: 'boolean' | 'string' | 'number';
+        kind: 'setting' | 'flag';
+        scope: 'app' | 'web' | 'landing' | 'storefront';
+    }>;
+}

package/dist/platform.js

@@ -0,0 +1,5 @@
+// Platform-wide config/feature-flag contracts (api#1108). Single fixed
+// GLOBALS/PLATFORM scope, unlike Literals' multi-scope override chain — no
+// per-tenant override use case identified for globals/flags (deliberate
+// divergence from api#1484/#1485's Literals model).
+export {};

package/dist/product.d.ts

@@ -44,6 +44,19 @@ declare global {
         isService: boolean;
         cost: number;
         prices?: PriceSlot[];
+        channels?: Record<string, ProductChannelMapping>;
+    }
+    type ProductChannelStatus = 'linked' | 'pending' | 'paused' | 'rejected' | 'unlinked';
+    interface ProductChannelMapping {
+        externalId?: string;
+        userProductId?: string;
+        familyId?: string;
+        variationId?: string;
+        status: ProductChannelStatus;
+        linkedAt?: number;
+        lastSyncedAt?: number;
+        basis?: MlMatchBasis | 'manual';
+        syncErrors?: string[];
     }
 }
 export {};

package/dist/store.d.ts

@@ -150,6 +150,7 @@ declare global {
         newPhotoURL?: string;
         removePhotoURL?: string;
         mercadopagoUserId?: string;
+        mercadolibreUserId?: string;
         currencies: StoreCurrencySubscription[];
         cashInMethods: Method[];
         cashOutMethods: Method[];
@@ -194,6 +195,7 @@ declare global {
         whatsapp?: WhatsAppConfig;
         sms?: SmsIntegration;
         gmail?: Gmail;
+        mercadolibre?: Mercadolibre;
     }
     interface SmsIntegration {
         /** When true, the store may send SMS through the shared platform account. */
@@ -265,6 +267,39 @@ declare global {
         code?: string;
     }
     type MercadopagoConnectionStatus = "connected" | "expired" | "disconnected" | "error" | "never";
+    type MercadolibreConnectionStatus = "connected" | "expired" | "disconnected" | "error" | "needs-reauth" | "never";
+    interface Mercadolibre {
+        userId?: string;
+        nickname?: string;
+        /** KMS-encrypted (`alias/ml-oauth-tokens`) — never returned in API responses. */
+        accessTokenEncrypted?: string;
+        /** KMS-encrypted. SINGLE-USE rotated by ML (last-only-valid) — never returned. */
+        refreshTokenEncrypted?: string;
+        expiresAt?: number;
+        connectedAt?: number;
+        tokenType?: string;
+        scope?: string;
+        status?: MercadolibreConnectionStatus;
+        disconnectedAt?: number;
+        lastTokenRefreshAt?: number;
+        /** Transient (network/5xx) failures only — a hard `invalid_grant` is
+         * terminal on FIRST occurrence (→ `needs-reauth`), never counted. */
+        tokenRefreshFailures?: number;
+        /** Write-ahead refresh-attempt marker (ADR-0018 Amendment B): unix ms
+         * persisted BEFORE calling ML's token endpoint. A dangling marker found
+         * by the next lock-acquirer means the previous winner may have burned
+         * the single-use refresh token → go straight to `needs-reauth`. */
+        refreshAttemptAt?: number;
+        /** Per-channel auto-invoice toggle — default OFF; enabling requires
+         * `defaultPosId` (dedicated PdV) + the Facturador-collision check. */
+        autoInvoice?: boolean;
+        defaultPosId?: number;
+        syncPolicy?: {
+            stockBuffer?: number;
+            stockLimit?: number;
+            paused?: boolean;
+        };
+    }
     interface Afip {
         production: boolean;
         address?: string;
@@ -286,6 +321,8 @@ declare global {
         accessTicket_EB?: string;
         accessTicket_RSF?: string;
         accessTicket_FEX?: string;
+        accessTicket_FECRED?: string;
+        accessTicket_CDC?: string;
         hasCert?: boolean;
         hasKey?: boolean;
         facturaMLegend?: 'retencion' | 'cbu_informada';

package/dist/subscription.d.ts

@@ -63,7 +63,7 @@ declare global {
      * every existing plan in `FEATURE_MATRIX` must then declare the new key
      * (TypeScript enforces this via `Record<FeatureKey, Entitlement>`).
      */
-    type FeatureKey = 'maxOrdersMonth' | 'maxInvoicesMonth' | 'maxProducts' | 'maxUsers' | 'maxCustomers' | 'maxStores' | 'priceListsMax' | 'afipInvoicing' | 'paymentIntegrations' | 'suppliers' | 'cashManagement' | 'multiStore' | 'importExport' | 'advancedReports' | 'customBranding' | 'apiAccess' | 'prioritySupport' | 'whatsappCommerce' | 'aiFeatures' | 'mobileApp' | 'customDomain' | 'advancedPricing';
+    type FeatureKey = 'maxOrdersMonth' | 'maxInvoicesMonth' | 'maxProducts' | 'maxUsers' | 'maxCustomers' | 'maxStores' | 'priceListsMax' | 'afipInvoicing' | 'paymentIntegrations' | 'suppliers' | 'cashManagement' | 'multiStore' | 'importExport' | 'advancedReports' | 'customBranding' | 'apiAccess' | 'prioritySupport' | 'whatsappCommerce' | 'aiFeatures' | 'mobileApp' | 'customDomain' | 'advancedPricing' | 'marketplaceChannels';
     /** Full feature matrix — every tier declares every feature. */
     type FeatureMatrix = Record<PlanTier, Record<FeatureKey, Entitlement>>;
     /** Resolved entitlements for a specific tenant (matrix + overrides applied). */

package/dist/supplier.d.ts

@@ -60,6 +60,10 @@ declare global {
         invoiceNumber: number;
         dated: number;
         total: number;
+        authorizationCode: string;
+        authorizationMode?: 'CAE' | 'CAEA' | 'CAI';
+        receptorDocType?: number;
+        receptorDocNumber?: string;
     }
     /**
      * WSCDC `ConstatarComprobante` result (api#1500). `result` mirrors the

package/dist/userActivity.d.ts

@@ -392,7 +392,7 @@ declare global {
     }
     interface IntegrationTokenRefreshedEvent extends UserActivityEventBase {
         event: 'Integration Token Refreshed';
-        provider: 'mercadopago' | 'gmail';
+        provider: 'mercadopago' | 'gmail' | 'mercadolibre';
         outcome: 'refreshed' | 'disconnected' | 'skipped' | 'error';
         trigger: 'operator-single' | 'operator-global';
         detail?: string;
@@ -400,7 +400,15 @@ declare global {
     interface WaitlistConvertedEvent extends UserActivityEventBase {
         event: 'Waitlist Converted';
     }
-    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 | IntegrationTokenRefreshedEvent | WaitlistConvertedEvent;
+    interface PlatformConfigUpdatedEvent extends UserActivityEventBase {
+        event: 'Platform Config Updated';
+        key: string;
+        kind: 'setting' | 'flag';
+        scope: 'app' | 'web' | 'landing' | 'storefront';
+        before: string | number | boolean;
+        after: string | number | boolean;
+    }
+    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 | IntegrationTokenRefreshedEvent | WaitlistConvertedEvent | PlatformConfigUpdatedEvent;
 }
 /**
  * Canonical whitelist of UI-only `UserActivityEvent` variant names — the 8

package/dist/userActivity.js

@@ -24,6 +24,7 @@
 //   - 1.6.34 (+field) — LiteralUpdatedEvent gains `scope`; new `LiteralScope` contract (api#1484)
 //   - (+1 variant) — IntegrationTokenRefreshedEvent (types#91, api#1540)
 //   - 1.6.39 (+1 variant) — WaitlistConvertedEvent (types#92, api#1567)
+//   - 1.6.43 (+1 variant) — PlatformConfigUpdatedEvent (api#1108)
 /**
  * Canonical whitelist of UI-only `UserActivityEvent` variant names — the 8
  * Phase 3 verbs shipped in 1.6.13 (types#74). Imported by the api side

package/package.json

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