platform-types 1.10.808 → 1.10.810

package/dist/cart.d.ts

@@ -211,6 +211,25 @@ declare global {
          * while `ecommerce.config.showNetPlusIva` is on.
          */
         netOfIva?: number;
+        /**
+         * The «PRECIO SIN IMPUESTOS NACIONALES» amount of `price`, per unit:
+         * `netOfIva` minus the line's impuestos internos,
+         * `netOfIva − round2(netOfIva × internalTaxes.percent / 100)`, and
+         * `netOfIva` itself when the line records none. Present exactly when
+         * `netOfIva` is, except that an unreadable `internalTaxes` or a refused
+         * figure leaves it out alone.
+         *
+         * ⚠️ READ-TIME and DISPLAY ONLY, on the same customer exits as `netOfIva`
+         * and under the same rules: never stored, never on an operator copy, never
+         * charged or totalled. Not gated by `showNetPlusIva`.
+         */
+        netOfNationalTaxes?: number;
+        /**
+         * The product's `internalTaxes`, stamped from the product row at re-price
+         * time like `ivaType`: the input to `netOfNationalTaxes`. Absent means
+         * none. Rides the line onto `OrderLine`; no invoice reads it.
+         */
+        internalTaxes?: ProductInternalTaxes;
         listId?: number;
         currency?: string;
         currencyValue?: number;

package/dist/cjs/product.js

@@ -7,10 +7,10 @@ exports.BASE_QUANTITY_DECIMAL_PLACES = 6;
 exports.MAX_BASE_QUANTITY = 1_000_000;
 /**
  * The `sort` values Web `GET /products?mode=discover` serves. `newest` is
- * descending product id; name and price sorts are not served (no index can
- * order them inside one bounded request).
+ * descending product id; `price_asc` / `price_desc` are the caller's own price
+ * (see `PublicProductDiscoverInput.sort`). Name sorts are not served.
  */
-exports.DISCOVERY_SORTS = ['newest'];
+exports.DISCOVERY_SORTS = ['newest', 'price_asc', 'price_desc'];
 /**
  * The facets Web `GET /products?mode=discover` can count (`facets=brand,tag,category`).
  * `brand` tallies `brandId`, `tag` each of `tagIds`, `category` the EXACT `categoryId`

package/dist/cjs/socket.js

@@ -738,6 +738,9 @@ exports.isSocketAction = isSocketAction;
  * `ivaType` is an INPUT to the shopper copy's `prices[].netOfIva`: the customer
  * fan-out re-prices the frame, and without the rate a merged frame would leave a
  * stale net beside a new gross. The customer copy still drops the Id itself.
+ * `internalTaxes` is the same kind of input, to `prices[].netOfNationalTaxes`:
+ * without it a frame would publish the legend amount of a product with no
+ * impuestos internos. The customer copy drops it too.
  */
 exports.PRODUCT_STOCK_FRAME_FIELDS = [
     'stock',
@@ -750,6 +753,7 @@ exports.PRODUCT_STOCK_FRAME_FIELDS = [
     'updatedAt',
     'lastMovementAt',
     'ivaType',
+    'internalTaxes',
 ];
 /*  Agent diagnostic commands                                                 */
 /**

package/dist/pricing.d.ts

@@ -143,9 +143,19 @@ declare global {
      * A price slot as a PUBLIC read emits it (web catalogue reads, customer
      * `products` frames). A read-time extension of {@link PriceSlot}, never
      * stored: `Product.prices` stays `PriceSlot[]`, so no writer can persist a net.
+     *
+     * `netOfNationalTaxes` is the «PRECIO SIN IMPUESTOS NACIONALES» amount
+     * (Resolución SIC 4/2025 art. 2(c)), the same shape as `netOfIva`, figure for
+     * figure: each `netOfIva` figure minus the product's impuestos internos
+     * (`Product.internalTaxes`), `net − round2(net × percent / 100)`. A product
+     * recording no internos gets the `netOfIva` figures. Present exactly when
+     * `netOfIva` is, except that an unreadable stored `internalTaxes` or a refused
+     * figure leaves it out alone. Never replaces `amount`, and is sent whatever
+     * `showNetPlusIva` says: the legend shows on every view.
      */
     type PublicPriceSlot = PriceSlot & {
         netOfIva?: PublicPriceNet;
+        netOfNationalTaxes?: PublicPriceNet;
     };
 }
 export {};

package/dist/product.d.ts

@@ -4,10 +4,10 @@ export declare const BASE_QUANTITY_DECIMAL_PLACES = 6;
 export declare const MAX_BASE_QUANTITY = 1000000;
 /**
  * The `sort` values Web `GET /products?mode=discover` serves. `newest` is
- * descending product id; name and price sorts are not served (no index can
- * order them inside one bounded request).
+ * descending product id; `price_asc` / `price_desc` are the caller's own price
+ * (see `PublicProductDiscoverInput.sort`). Name sorts are not served.
  */
-export declare const DISCOVERY_SORTS: readonly ["newest"];
+export declare const DISCOVERY_SORTS: readonly ["newest", "price_asc", "price_desc"];
 export type DiscoverySort = (typeof DISCOVERY_SORTS)[number];
 /**
  * The facets Web `GET /products?mode=discover` can count (`facets=brand,tag,category`).
@@ -36,12 +36,25 @@ declare global {
         /** Server-owned; starts at 1 and increments when the declaration changes. */
         unitRevision: number;
     }
+    /**
+     * `Product.internalTaxes`: impuestos internos as a nominal `percent`,
+     * greater than 0 and less than 100, applied to the net of IVA. The legend
+     * amount is `netOfIva − round2(netOfIva × percent / 100)`. A rate only:
+     * a fixed amount per unit would need a currency and an FX step the
+     * per-figure net has none of. A later basis is an additive key.
+     */
+    interface ProductInternalTaxes {
+        percent: number;
+    }
     type ProductUnitsInput = Omit<ProductUnits, 'unitRevision'>;
     /** The display declaration plus the purchase-unit factor; `unitRevision` stays server-only. */
     type PublicProductUnits = Pick<ProductUnits, 'baseUnit' | 'purchaseUnit' | 'packLabel' | 'baseUnitsPerPurchaseUnit'>;
     type PublicProduct = Omit<Partial<Product>, 'units' | 'unitRevisionGeneration' | 'prices'> & {
         units?: PublicProductUnits | null;
-        /** The shopper's one applicable slot, with its read-time `netOfIva` when the product is rated. */
+        /**
+         * The shopper's one applicable slot, with its read-time `netOfIva` and
+         * `netOfNationalTaxes` when the product is rated.
+         */
         prices?: PublicPriceSlot[];
     };
     /** Anonymous Web GET /products lookup; the tenant comes from the public store context. */
@@ -280,10 +293,22 @@ declare global {
         isNew?: 'true';
         /**
          * A member of `DISCOVERY_SORTS`. `newest` = descending product id (mint
-         * order), on every filter combination. A well-formed value the api does not
-         * serve is 400 `DISCOVERY_SORT_UNSUPPORTED` ({@link DiscoverySortRefusal});
-         * one not matching `^[a-z_]{1,32}$` is 400 `INVALID_DISCOVERY_QUERY`. An
-         * empty value is absent. Bound into the cursor when present.
+         * order), on every filter combination. `price_asc` / `price_desc` = the
+         * caller's own price, as each row is priced for them: in the store's display
+         * currency, an open offer counting as the price, no quantity break. Rows the
+         * caller is shown no price for (a hidden slot, every row for a guest of a
+         * store that hides prices) come LAST in both directions; equal prices and
+         * that unpriced tail are newest first. A price sort reads the whole filtered
+         * set on every page, so a set too large for one read is 400
+         * `DISCOVERY_SORT_UNSUPPORTED` after the reads, with `supportedSorts`
+         * naming what that query can be served in, and a read the time budget cut
+         * short is 503 `PRODUCT_LOOKUP_INCOMPLETE` (retryable). A price cursor is
+         * also bound to the caller's price list: resumed under another (a sign-in,
+         * a list change) it is 400 `INVALID_CURSOR`. A well-formed value the api does
+         * not serve is 400 `DISCOVERY_SORT_UNSUPPORTED` ({@link DiscoverySortRefusal})
+         * before any read; one not matching `^[a-z_]{1,32}$` is 400
+         * `INVALID_DISCOVERY_QUERY`. An empty value is absent. Bound into the cursor
+         * when present.
          */
         sort?: string;
         /** The previous response's `LastEvaluatedKey`, under the SAME filters and sort; else 400 INVALID_CURSOR. */
@@ -380,8 +405,14 @@ declare global {
         truncated?: true;
     }
     /** Refusals of Web `GET /products?mode=discover`. */
-    type DiscoveryErrorCode = 'INVALID_DISCOVERY_QUERY' | 'INVALID_CURSOR' | 'DISCOVERY_SORT_UNSUPPORTED';
-    /** 400 body for a well-formed `sort` the api does not serve; `supportedSorts` lists what it does. */
+    type DiscoveryErrorCode = 'INVALID_DISCOVERY_QUERY' | 'INVALID_CURSOR' | 'DISCOVERY_SORT_UNSUPPORTED'
+    /** 503: a price-sorted walk the time budget cut short; retry. */
+     | 'PRODUCT_LOOKUP_INCOMPLETE';
+    /**
+     * 400 body for a `sort` the api does not serve for this request; `supportedSorts` lists what
+     * it does — every member for an unknown value, the non-price sorts when a price sort's
+     * filtered set was too large to read whole.
+     */
     interface DiscoverySortRefusal {
         message: string;
         error: 'DISCOVERY_SORT_UNSUPPORTED';
@@ -938,6 +969,19 @@ declare global {
         currencyValue?: number;
         currencyValueAt?: number;
         ivaType: number;
+        /**
+         * Impuestos internos the merchant records for this product, as a nominal
+         * rate: the input to the public `prices[].netOfNationalTaxes` and the cart
+         * line's `netOfNationalTaxes` («PRECIO SIN IMPUESTOS NACIONALES»). Absent
+         * means none. Written through `POST /products`, cleared through
+         * `removeFields: ['internalTaxes']`.
+         *
+         * ⚠️ DISPLAY INPUT ONLY. No invoice reads it: the voucher declares no
+         * impuestos internos tributo, so a product recording them still prints
+         * `$0,00` on the RG 5614 «Otros Impuestos Nacionales Indirectos» line.
+         * Never on a public product row; the shopper gets the net, never the rate.
+         */
+        internalTaxes?: ProductInternalTaxes;
         /** Optional category membership. New enabled membership atomically requires an existing, enabled, unfrozen category.
          * Cosmetic edits preserve legacy references; leaving or disabling remains allowed while frozen.
          */

package/dist/product.js

@@ -4,10 +4,10 @@ export const BASE_QUANTITY_DECIMAL_PLACES = 6;
 export const MAX_BASE_QUANTITY = 1_000_000;
 /**
  * The `sort` values Web `GET /products?mode=discover` serves. `newest` is
- * descending product id; name and price sorts are not served (no index can
- * order them inside one bounded request).
+ * descending product id; `price_asc` / `price_desc` are the caller's own price
+ * (see `PublicProductDiscoverInput.sort`). Name sorts are not served.
  */
-export const DISCOVERY_SORTS = ['newest'];
+export const DISCOVERY_SORTS = ['newest', 'price_asc', 'price_desc'];
 /**
  * The facets Web `GET /products?mode=discover` can count (`facets=brand,tag,category`).
  * `brand` tallies `brandId`, `tag` each of `tagIds`, `category` the EXACT `categoryId`

package/dist/productGroup.d.ts

@@ -194,7 +194,7 @@ declare global {
      * (per combination only), `stock` (always 0), `tagIds` and `typedAttributes`
      * (set per child afterwards, through `POST /products`).
      */
-    type ProductVariantFields = Partial<Pick<Product, 'description' | 'categoryId' | 'brandId' | 'zone' | 'cost' | 'currency' | 'ivaType' | 'prices' | 'limit' | 'isService' | 'isNew' | 'hiddenFromStorefront' | 'sellableOn' | 'minStock' | 'reorderPoint' | 'safetyStock' | 'leadTimeDays' | 'serviceLevel' | 'lotTracking' | 'weightGrams' | 'lengthMm' | 'widthMm' | 'heightMm' | 'model' | 'seoTitle' | 'seoDescription' | 'attributes'>> & {
+    type ProductVariantFields = Partial<Pick<Product, 'description' | 'categoryId' | 'brandId' | 'zone' | 'cost' | 'currency' | 'ivaType' | 'internalTaxes' | 'prices' | 'limit' | 'isService' | 'isNew' | 'hiddenFromStorefront' | 'sellableOn' | 'minStock' | 'reorderPoint' | 'safetyStock' | 'leadTimeDays' | 'serviceLevel' | 'lotTracking' | 'weightGrams' | 'lengthMm' | 'widthMm' | 'heightMm' | 'model' | 'seoTitle' | 'seoDescription' | 'attributes'>> & {
         /** `draft` or `active`; omitted creates the child as `POST /products` does. */
         catalogStatus?: Exclude<CatalogStatus, 'archived'>;
         /**

package/dist/socket.d.ts

@@ -176,8 +176,11 @@ export interface SocketMessage<T = unknown> {
  * `ivaType` is an INPUT to the shopper copy's `prices[].netOfIva`: the customer
  * fan-out re-prices the frame, and without the rate a merged frame would leave a
  * stale net beside a new gross. The customer copy still drops the Id itself.
+ * `internalTaxes` is the same kind of input, to `prices[].netOfNationalTaxes`:
+ * without it a frame would publish the legend amount of a product with no
+ * impuestos internos. The customer copy drops it too.
  */
-export declare const PRODUCT_STOCK_FRAME_FIELDS: readonly ["stock", "prices", "cost", "currency", "hiddenFromStorefront", "disabled", "catalogStatus", "updatedAt", "lastMovementAt", "ivaType"];
+export declare const PRODUCT_STOCK_FRAME_FIELDS: readonly ["stock", "prices", "cost", "currency", "hiddenFromStorefront", "disabled", "catalogStatus", "updatedAt", "lastMovementAt", "ivaType", "internalTaxes"];
 /**
  * `data` of a **partial** `products` frame — the projection every stock-moving
  * write announces, and the only `products` shape that is not a whole `Product`.

package/dist/socket.js

@@ -734,6 +734,9 @@ export const isSocketAction = (value) => typeof value === 'string' && SOCKET_ACT
  * `ivaType` is an INPUT to the shopper copy's `prices[].netOfIva`: the customer
  * fan-out re-prices the frame, and without the rate a merged frame would leave a
  * stale net beside a new gross. The customer copy still drops the Id itself.
+ * `internalTaxes` is the same kind of input, to `prices[].netOfNationalTaxes`:
+ * without it a frame would publish the legend amount of a product with no
+ * impuestos internos. The customer copy drops it too.
  */
 export const PRODUCT_STOCK_FRAME_FIELDS = [
     'stock',
@@ -746,6 +749,7 @@ export const PRODUCT_STOCK_FRAME_FIELDS = [
     'updatedAt',
     'lastMovementAt',
     'ivaType',
+    'internalTaxes',
 ];
 /*  Agent diagnostic commands                                                 */
 /**

package/package.json

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