platform-types 1.10.806 → 1.10.808

package/dist/cjs/product.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.PRODUCT_MEDIA_INVALID_REASONS = exports.MAX_PRODUCT_PICTURE_ALT_CHARS = exports.PRODUCT_UPSERT_ERROR_CODES = exports.PRODUCT_UPSERT_ROW_ERROR_CODES = exports.PRODUCT_UPSERT_ROW_CAP = exports.PUBLIC_PRODUCT_SUGGEST_ERROR_CODES = exports.PUBLIC_PRODUCT_BY_SLUG_ERROR_CODES = exports.PRODUCT_PUBLISH_OVERDUE_AFTER_MS = exports.PRODUCT_PUBLISH_AT_MAX_AHEAD_MS = exports.PRODUCT_POST_ERROR_CODES = exports.PRODUCT_IDENTITY_ERROR_CODES = exports.PRODUCT_EXPORT_ERROR_CODES = exports.PRODUCT_CATALOG_EXPORT_COLUMNS = exports.RECENT_PURCHASES_MAX = exports.BEST_SELLERS_MAX = exports.DISCOVERY_SORTS = exports.MAX_BASE_QUANTITY = exports.BASE_QUANTITY_DECIMAL_PLACES = void 0;
+exports.PRODUCT_MEDIA_INVALID_REASONS = exports.MAX_PRODUCT_PICTURE_ALT_CHARS = exports.PRODUCT_UPSERT_ERROR_CODES = exports.PRODUCT_UPSERT_ROW_ERROR_CODES = exports.PRODUCT_UPSERT_ROW_CAP = exports.PUBLIC_PRODUCT_SUGGEST_ERROR_CODES = exports.PUBLIC_PRODUCT_BY_SLUG_ERROR_CODES = exports.PRODUCT_PUBLISH_OVERDUE_AFTER_MS = exports.PRODUCT_PUBLISH_AT_MAX_AHEAD_MS = exports.PRODUCT_POST_ERROR_CODES = exports.PRODUCT_IDENTITY_ERROR_CODES = exports.PRODUCT_EXPORT_ERROR_CODES = exports.PRODUCT_CATALOG_EXPORT_COLUMNS = exports.RECENT_PURCHASES_MAX = exports.BEST_SELLERS_MAX = exports.DISCOVERY_FACETS = exports.DISCOVERY_SORTS = exports.MAX_BASE_QUANTITY = exports.BASE_QUANTITY_DECIMAL_PLACES = void 0;
 /** Maximum decimal places in a canonical base quantity; inputs are exact, never rounded. */
 exports.BASE_QUANTITY_DECIMAL_PLACES = 6;
 /** Absolute base-quantity input bound; signed adjustments admit the negative of this value. */
@@ -11,6 +11,12 @@ exports.MAX_BASE_QUANTITY = 1_000_000;
  * order them inside one bounded request).
  */
 exports.DISCOVERY_SORTS = ['newest'];
+/**
+ * The facets Web `GET /products?mode=discover` can count (`facets=brand,tag,category`).
+ * `brand` tallies `brandId`, `tag` each of `tagIds`, `category` the EXACT `categoryId`
+ * (the filter matches no descendants, so a rolled-up parent would select nothing).
+ */
+exports.DISCOVERY_FACETS = ['brand', 'tag', 'category'];
 /** Most products the store's best-seller ranking holds, and web `mode=best-sellers` returns. */
 exports.BEST_SELLERS_MAX = 50;
 /** Most distinct products a buyer's recent-purchases row holds, and web `mode=recently-bought` returns. */

package/dist/cjs/store.js

@@ -187,6 +187,8 @@ exports.STORE_PATCH_ERROR_CODES = [
     'PRICE_LIST_NOT_FOUND',
     'DELIVERY_FEE_INVALID',
     'WHOLESALE_LIST_REQUIRED',
+    'DATA_FISCAL_URL_INVALID',
+    'STORE_PUBLIC_HOST_MISSING',
     'FORBIDDEN',
     'STORE_NOT_FOUND',
 ];

package/dist/product.d.ts

@@ -9,6 +9,13 @@ export declare const MAX_BASE_QUANTITY = 1000000;
  */
 export declare const DISCOVERY_SORTS: readonly ["newest"];
 export type DiscoverySort = (typeof DISCOVERY_SORTS)[number];
+/**
+ * The facets Web `GET /products?mode=discover` can count (`facets=brand,tag,category`).
+ * `brand` tallies `brandId`, `tag` each of `tagIds`, `category` the EXACT `categoryId`
+ * (the filter matches no descendants, so a rolled-up parent would select nothing).
+ */
+export declare const DISCOVERY_FACETS: readonly ["brand", "tag", "category"];
+export type DiscoveryFacet = (typeof DISCOVERY_FACETS)[number];
 /** Most products the store's best-seller ranking holds, and web `mode=best-sellers` returns. */
 export declare const BEST_SELLERS_MAX = 50;
 /** Most distinct products a buyer's recent-purchases row holds, and web `mode=recently-bought` returns. */
@@ -281,6 +288,38 @@ declare global {
         sort?: string;
         /** The previous response's `LastEvaluatedKey`, under the SAME filters and sort; else 400 INVALID_CURSOR. */
         startKey?: string;
+        /**
+         * Comma-separated `DISCOVERY_FACETS` members to count. Unknown members are
+         * ignored; a value outside `^[\w,-]{1,128}$` is 400 `INVALID_DISCOVERY_QUERY`.
+         * Honoured only on a first page (no `startKey`), ignored after it. Never bound
+         * into the cursor.
+         */
+        facets?: string;
+    }
+    /**
+     * One facet value: applied as its filter with the other current filters, it returns at
+     * least `count` rows across the walk — exactly `count` unless the facets are `truncated`.
+     */
+    interface DiscoveryFacetValue {
+        id: string;
+        count: number;
+    }
+    /**
+     * The values each requested facet can take under the current query, count
+     * descending. Disjunctive: a facet is counted with every other filter applied
+     * but not its own, so the picked brand still lists its sibling brands. A
+     * facet absent from the request is absent here.
+     */
+    interface DiscoveryFacets {
+        brand?: DiscoveryFacetValue[];
+        tag?: DiscoveryFacetValue[];
+        category?: DiscoveryFacetValue[];
+        /**
+         * The count walk hit its read budget before the catalogue ended: every
+         * listed value still returns rows, but counts are lower bounds and a value
+         * may be missing — fall back to the store-wide list for anything unlisted.
+         */
+        truncated?: true;
     }
     /** One page of a discovery walk; `data` can be empty while `LastEvaluatedKey` is set. */
     interface PublicProductDiscoverResponse {
@@ -291,6 +330,12 @@ declare global {
         sort?: (typeof DISCOVERY_SORTS)[number];
         /** Present while rows remain; absent means the walk is complete. */
         LastEvaluatedKey?: string;
+        /**
+         * Only on a first page whose request named a known facet. Also absent when the
+         * count failed (the rows still answer) — read absence as "fall back to the
+         * store-wide lists", never as "no values".
+         */
+        facets?: DiscoveryFacets;
     }
     /**
      * Web `GET /products?mode=best-sellers` and `mode=recently-bought`: at most 50 rows, no cursor,

package/dist/product.js

@@ -8,6 +8,12 @@ export const MAX_BASE_QUANTITY = 1_000_000;
  * order them inside one bounded request).
  */
 export const DISCOVERY_SORTS = ['newest'];
+/**
+ * The facets Web `GET /products?mode=discover` can count (`facets=brand,tag,category`).
+ * `brand` tallies `brandId`, `tag` each of `tagIds`, `category` the EXACT `categoryId`
+ * (the filter matches no descendants, so a rolled-up parent would select nothing).
+ */
+export const DISCOVERY_FACETS = ['brand', 'tag', 'category'];
 /** Most products the store's best-seller ranking holds, and web `mode=best-sellers` returns. */
 export const BEST_SELLERS_MAX = 50;
 /** Most distinct products a buyer's recent-purchases row holds, and web `mode=recently-bought` returns. */

package/dist/store.d.ts

@@ -528,8 +528,8 @@ declare global {
         /** Unix ms — when the retired label's redirect ends (its reservation end). */
         redirectUntil?: number;
     }
-    /** An identity or withdrawal fact {@link StorePublicLegal} could not resolve; the storefront warns or degrades on it. */
-    type StorePublicLegalMissing = 'razonSocial' | 'fiscalAddress' | 'email' | 'phone' | 'withdrawalChannel';
+    /** An identity, withdrawal or Data Fiscal fact {@link StorePublicLegal} could not resolve; the storefront warns or degrades on it. */
+    type StorePublicLegalMissing = 'razonSocial' | 'fiscalAddress' | 'email' | 'phone' | 'withdrawalChannel' | 'dataFiscal';
     /**
      * The consumer-law facts a storefront renders: the merchant identity disclosure, the
      * Botón de Arrepentimiento and the privacy-text variants. Built by the api at read time
@@ -572,6 +572,16 @@ declare global {
             /** `['mercadopago']` while any `paymentMethods` row is `storefront: 'mp-checkout-pro'`, whatever its audience rule; else `[]`. */
             onlinePayment: Array<'mercadopago'>;
         };
+        /**
+         * The shop's Formulario 960/D (Data Fiscal) link, from `integrations.afip.dataFiscal`.
+         * Absent when none is recorded, and `missing` then names `dataFiscal`.
+         * `matchesCurrentDomain` is `false` once the shop's public host is no longer the one the
+         * link was recorded for (RG 1415 art. 25 asks for a new form after a domain change).
+         */
+        dataFiscal?: {
+            url: string;
+            matchesCurrentDomain: boolean;
+        };
         missing: StorePublicLegalMissing[];
     }
     interface Store {
@@ -1780,6 +1790,21 @@ declare global {
          * clears it back to the default.
          */
         freight?: AfipFreightFiscal;
+        /**
+         * The shop's Formulario 960/D (Data Fiscal) link (RG 1415 art. 25). ADMIN-tier on
+         * `PATCH /store`, which takes `{ url }` only: `url` is `https:` on an ARCA host
+         * (`afip.gob.ar` or `arca.gob.ar`, subdomains included), and `domain` is STAMPED by the
+         * api with the shop's public host at write time, never taken from the body. `null`
+         * clears it. Published as `StorePublicLegal.dataFiscal`.
+         */
+        dataFiscal?: AfipDataFiscal;
+    }
+    /** {@link Afip.dataFiscal}: the link as recorded and the public host it was recorded for. */
+    interface AfipDataFiscal {
+        /** `https:` on `afip.gob.ar` / `arca.gob.ar` or a subdomain, normalised by the URL parser. */
+        url: string;
+        /** The shop's canonical public host when the link was written — bare host, no scheme. */
+        domain: string;
     }
     /**
      * Write shape for the `afip` key of `PATCH /store`'s body. The wire accepts an
@@ -1795,6 +1820,10 @@ declare global {
         iibbJurisdictions?: IibbJurisdictionConfig[] | null;
         actividades?: number[] | null;
         freight?: AfipFreightFiscal | null;
+        /** The link alone — the api stamps `domain` with the shop's public host and refuses one sent. */
+        dataFiscal?: {
+            url: string;
+        } | null;
     }
     /**
      * Write shape for the `config` key of `PATCH /store`'s body. Two things the
@@ -2591,5 +2620,5 @@ export type StoreModuleRefusalBody = {
  * checks, the display-currency lock, the storefront fence) are not listed
  * either. Cross-cutting refusals: check `GATING_ERROR_CODES` as well.
  */
-export declare const STORE_PATCH_ERROR_CODES: readonly ["STORE_CONFIG_FORBIDDEN", "STORE_ECOMMERCE_FORBIDDEN", "STORE_FISCAL_FIELD_FORBIDDEN", "STORE_JURISDICTION_FORBIDDEN", "AFIP_RELACION_FLAG_FORBIDDEN", "FX_TABLE_FORBIDDEN", "FX_AUTO_UPDATE_FORBIDDEN", "FIELD_NOT_WRITABLE_HERE", "AFIP_POINT_OF_SALE_NOT_CLEARABLE", "CURRENCY_CATALOG_ID_UNKNOWN", "ARS_RATE_MUST_BE_ONE", "CURRENCY_RATE_ABOVE_CEILING", "FX_CATALOG_ID_UNKNOWN", "FX_SOURCE_ID_UNKNOWN", "DISPLAY_CURRENCY_NOT_INVOICEABLE", "PRODUCT_CURRENCY_NOT_INVOICEABLE", "PRICE_LIST_NOT_FOUND", "DELIVERY_FEE_INVALID", "WHOLESALE_LIST_REQUIRED", "FORBIDDEN", "STORE_NOT_FOUND"];
+export declare const STORE_PATCH_ERROR_CODES: readonly ["STORE_CONFIG_FORBIDDEN", "STORE_ECOMMERCE_FORBIDDEN", "STORE_FISCAL_FIELD_FORBIDDEN", "STORE_JURISDICTION_FORBIDDEN", "AFIP_RELACION_FLAG_FORBIDDEN", "FX_TABLE_FORBIDDEN", "FX_AUTO_UPDATE_FORBIDDEN", "FIELD_NOT_WRITABLE_HERE", "AFIP_POINT_OF_SALE_NOT_CLEARABLE", "CURRENCY_CATALOG_ID_UNKNOWN", "ARS_RATE_MUST_BE_ONE", "CURRENCY_RATE_ABOVE_CEILING", "FX_CATALOG_ID_UNKNOWN", "FX_SOURCE_ID_UNKNOWN", "DISPLAY_CURRENCY_NOT_INVOICEABLE", "PRODUCT_CURRENCY_NOT_INVOICEABLE", "PRICE_LIST_NOT_FOUND", "DELIVERY_FEE_INVALID", "WHOLESALE_LIST_REQUIRED", "DATA_FISCAL_URL_INVALID", "STORE_PUBLIC_HOST_MISSING", "FORBIDDEN", "STORE_NOT_FOUND"];
 export type StorePatchErrorCode = (typeof STORE_PATCH_ERROR_CODES)[number];

package/dist/store.js

@@ -182,6 +182,8 @@ export const STORE_PATCH_ERROR_CODES = [
     'PRICE_LIST_NOT_FOUND',
     'DELIVERY_FEE_INVALID',
     'WHOLESALE_LIST_REQUIRED',
+    'DATA_FISCAL_URL_INVALID',
+    'STORE_PUBLIC_HOST_MISSING',
     'FORBIDDEN',
     'STORE_NOT_FOUND',
 ];

package/dist/storefrontDesign.d.ts

@@ -762,6 +762,8 @@ declare global {
         /** Web `mode=discover`'s `sort`; an unserved one answers 400 `DISCOVERY_SORT_UNSUPPORTED`. */
         sort?: DiscoverySort;
         startKey?: string;
+        /** Web `mode=discover`'s `facets`: counted on a first page only, answered as `facets`. */
+        facets?: string;
     }
     /**
      * Web `GET /products?updatedAt=`'s recency listing (the shop's «Ingresos» page), with the

package/package.json

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