sinfactura-types 1.10.445 → 1.10.447

package/dist/cjs/favorite.js

@@ -5,7 +5,8 @@
 // existed still carries the LEGACY `Customer.favorites` array on the CUSTOMER
 // row; `GET /favorites` reads both (rows win on a shared `productId`) and the
 // first `add`/`remove`/`merge` for that customer materializes the array into
-// rows and then drops it. Nothing backfills.
+// rows and then drops it. Nothing backfills, and nothing writes the array any
+// more — the mode-less whole-array `POST /favorites` is retired (400).
 //
 // ⚠️ A row stores ids and a timestamp, never a product snapshot. Name, price and
 // pictures are resolved at READ time against the live catalogue and the

package/dist/customer.d.ts

@@ -201,6 +201,20 @@ declare global {
          * already revoked.
          */
         appleRelayEmail?: string;
+        /**
+         * @deprecated The LEGACY whole-array wishlist, superseded by the
+         * `FAVORITE#` rows (`GET /favorites`). Nothing writes it any more, and
+         * `sanitizeCustomerRow` strips it at every CUSTOMER wire boundary, so it
+         * never arrives — it survives only as storage on rows not yet
+         * materialized, read raw by the favorites dual reader.
+         *
+         * ⚠️ Still PUBLISHED, as the one exception to "a field the sanitizer
+         * strips moves to `CustomerRow`": the storefront's `useFavorites` still
+         * reads `AuthCustomer.favorites` as a fallback, and moving the field
+         * would break its typecheck on the next types bump. Once that fallback is
+         * gone the field moves to `CustomerRow`.
+         * TODO(storefront#686): move to `CustomerRow` after the fallback is dropped.
+         */
         favorites?: Partial<Product>[];
         fullName: string;
         lastBuy?: number;
@@ -777,6 +791,13 @@ declare global {
          * carries the contact and its dates only.
          */
         contacts?: CustomerContactExportEntry[];
+        /**
+         * The subject's favorites, newest first. On BOTH surfaces — it is the
+         * subject's own data. Read from the `FAVORITE#` rows UNIONED with a legacy
+         * `Customer.favorites` array not yet materialized (rows win), because the
+         * `customer` object above no longer carries that array.
+         */
+        favorites: CustomerFavoriteExportEntry[];
         /**
          * Per COLLECTION, and honest: `true` means the read stopped before the
          * end of that partition and rows are MISSING from this export.
@@ -793,6 +814,7 @@ declare global {
             addresses: boolean;
             /** Present exactly when `contacts` is. */
             contacts?: boolean;
+            favorites: boolean;
         };
     }
     /**
@@ -917,6 +939,11 @@ declare global {
      * are dropped there too, and neither is declared on `Customer` any more —
      * they live on the api-internal `CustomerRow`, because a field this body
      * never carries has no business being published.
+     *
+     * ⚠️ ONE EXCEPTION: the deprecated `favorites` array is stripped there too
+     * and so never arrives, yet stays declared on `Customer` until the
+     * storefront's `useFavorites` fallback that reads it is removed; the field
+     * then moves to `CustomerRow` (the follow-up is tracked on that docblock).
      */
     interface AuthCustomer extends Customer {
         accessToken: string;

package/dist/favorite.d.ts

@@ -35,9 +35,9 @@ declare global {
      * The `'favorites'` socket frame from `POST /favorites { mode: 'add' }` and
      * `DELETE /favorites` — a DELTA, one per change, to the one customer.
      *
-     * ⚠️ The legacy whole-array `POST /favorites` (no `mode`) still emits the old
-     * `{ storeId, customerId, favorites }` shape on the same action; a client
-     * tells them apart by the presence of `op`.
+     * The old whole-array `{ storeId, customerId, favorites }` shape on the same
+     * action is no longer emitted: its only producer, the mode-less legacy
+     * `POST /favorites`, is retired. Every `'favorites'` frame carries `op`.
      */
     interface FavoritesChangedPayload {
         storeId: string;
@@ -71,6 +71,15 @@ declare global {
         productId: string;
         removed: boolean;
     }
+    /**
+     * One favorite in the art. 14 data-rights export (`CustomerDataExport.favorites`):
+     * what is HELD, never a priced catalogue view. `addedAt` is `0` for an entry
+     * that came from the legacy array (materialized or not), which never recorded one.
+     */
+    interface CustomerFavoriteExportEntry {
+        productId: string;
+        addedAt: number;
+    }
     /** Why a `merge` id was not added. */
     type FavoriteMergeSkipReason = 'PRODUCT_NOT_FOUND' | 'FAVORITES_LIMIT_REACHED';
     /**

package/dist/favorite.js

@@ -4,7 +4,8 @@
 // existed still carries the LEGACY `Customer.favorites` array on the CUSTOMER
 // row; `GET /favorites` reads both (rows win on a shared `productId`) and the
 // first `add`/`remove`/`merge` for that customer materializes the array into
-// rows and then drops it. Nothing backfills.
+// rows and then drops it. Nothing backfills, and nothing writes the array any
+// more — the mode-less whole-array `POST /favorites` is retired (400).
 //
 // ⚠️ A row stores ids and a timestamp, never a product snapshot. Name, price and
 // pictures are resolved at READ time against the live catalogue and the

package/dist/store.d.ts

@@ -1071,6 +1071,15 @@ declare global {
              * leg, so stock continues publishing while it is set.
              */
             pricePaused?: boolean;
+            /**
+             * The depósitos whose stock feeds MercadoLibre on a store whose
+             * `stockAuthority` is `'depositos'`: the push quantity is
+             * `max(0, Σ available)` over the ACTIVE ones, before the knobs above.
+             * Absent means the ML depósito from the sale ladder —
+             * `config.channelWarehouses.mercadolibre`, then the primary. Ignored
+             * while the switch is off, where the push keeps reading `Product.stock`.
+             */
+            warehouseIds?: string[];
         };
         /**
          * Unix ms of the last FULLY DRAINED run of the daily Conciliación
@@ -1128,6 +1137,12 @@ declare global {
         paused?: boolean | null;
         /** WRITE side of `pricePaused` — `null` clears it, same convention as the knobs above. */
         pricePaused?: boolean | null;
+        /**
+         * WRITE side of `warehouseIds`. Each id must name an active depósito of
+         * this store and the array must not be empty (both `400`); `null` clears
+         * it, returning the feed to the sale ladder's ML depósito.
+         */
+        warehouseIds?: string[] | null;
     }
     /**
      * Full write shape for the `mercadolibre` key of `PATCH /store`'s body.

package/package.json

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