sinfactura-types 1.6.43 → 1.6.45

package/dist/index.d.ts

@@ -15,6 +15,7 @@ export * from "./imports";
 export * from "./invoice";
 export * from "./log";
 export * from "./maintenance";
+export * from "./mercadolibre";
 export * from "./mercadopago";
 export * from "./notification";
 export * from "./order";

package/dist/index.js

@@ -15,6 +15,7 @@ export * from "./imports";
 export * from "./invoice";
 export * from "./log";
 export * from "./maintenance";
+export * from "./mercadolibre";
 export * from "./mercadopago";
 export * from "./notification";
 export * from "./order";

package/dist/mercadolibre.d.ts

@@ -0,0 +1,118 @@
+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;
+    }
+    type GtinRequirementTag = "not_required" | "conditional_required" | "new_required";
+    interface MlAttribute {
+        id: string;
+        name?: string;
+        value_id?: string;
+        value_name?: string;
+        attribute_group_id?: string;
+        attribute_group_name?: string;
+    }
+    interface MlRequiredAttribute {
+        id: string;
+        name?: string;
+        required: boolean;
+        tags?: string[];
+    }
+    interface MlCategoryPrediction {
+        domainName: string;
+        categoryId: string;
+        categoryName: string;
+        attributes: MlAttribute[];
+        requiredAttributes: MlRequiredAttribute[];
+        immediatePayment?: "required" | "optional";
+        maxTitleLength?: number;
+        gtinRequirement: GtinRequirementTag;
+    }
+    interface PublishPrediction extends MlCategoryPrediction {
+        isUpMigrated: boolean;
+    }
+    interface MlPublishRequest {
+        productId: string;
+        categoryId: string;
+        attributes: MlAttribute[];
+        listingTypeId: string;
+        saleTerms?: Record<string, unknown>[];
+        pictures?: {
+            url: string;
+        }[];
+        description?: string;
+    }
+    interface MlPublishResponse {
+        productId: string;
+        itemId: string;
+        userProductId?: string;
+        isUpMigrated: boolean;
+        status: "linked";
+    }
+    interface MlFieldError {
+        field: string;
+        code?: string;
+        message: string;
+        type?: "warning" | "error";
+        causeId?: 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/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;
@@ -278,7 +313,7 @@ declare global {
         pointOfSale?: number;
         activitiesStartedAt?: number;
         invoiceNote?: string;
-        showInvoiceLogo?: string;
+        showInvoiceLogo?: boolean;
         currency: CatalogId;
         cert?: string;
         csr?: string;

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/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;

package/package.json

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