@peabody-soft/mbs-model-ts 1.7.1 → 1.9.0

package/dist/Business.js

@@ -57,7 +57,8 @@ export default class Business extends Entity {
         this._orders = value;
     }
     // What this customer has picked and not yet ordered. Null until something is put in a cart, and
-    // null again once the cart is ordered. The cart message itself stays, with no list. Only the list
+    // null again once the cart is ordered. The cart message itself stays, with no list, or with a list
+    // that has no items (the merchant app stores one), which is null here too. Only the list
     // is exposed here. The fulfillment mode is chosen when an order is placed and is stored on the
     // Order (see defaultFulfillmentMode).
     get cart() {

package/dist/Catalog.d.ts

@@ -1,13 +1,15 @@
 import Item from "./Item";
 import Package from "./Package";
+import Price from "./Price";
 import PriceList from "./PriceList";
 import Product from "./Product";
 import ProductCategory from "./ProductCategory";
 export default class Catalog {
-    private readonly _priceList;
-    constructor(categories: ReadonlyArray<ProductCategory>, products: ReadonlyArray<Product>, _priceList: PriceList | null);
+    constructor(categories: ReadonlyArray<ProductCategory>, products: ReadonlyArray<Product>, packages: ReadonlyArray<Package>, priceLists: ReadonlyArray<PriceList>, prices: ReadonlyArray<Price>);
     get categories(): ReadonlyArray<ProductCategory>;
     get products(): ReadonlyArray<Product>;
+    get currentSalePriceListId(): bigint;
+    private set currentSalePriceListId(value);
     get priceList(): PriceList | null;
     get productCount(): number;
     get packageCount(): number;
@@ -19,10 +21,20 @@ export default class Catalog {
     private static compareNames;
     private static compareIds;
     private static comparePrices;
+    private applySalePriceList;
     static readonly EMPTY: Catalog;
-    private readonly _categories;
-    private readonly _products;
-    private readonly _categoryMap;
-    private readonly _productMap;
-    private readonly _packageMap;
+    private readonly _allCategories;
+    private readonly _allProducts;
+    private readonly _uncategorized;
+    private readonly _candidatePackages;
+    private readonly _priceListMap;
+    private _currentSalePriceListId;
+    private _categories;
+    private _products;
+    private _categoryMap;
+    private _productMap;
+    private _packageMap;
+}
+export interface UpdatableCatalog {
+    set currentSalePriceListId(value: bigint);
 }

package/dist/Catalog.js

@@ -1,51 +1,70 @@
 import { Constants as proto_Constants } from "./generated/Constants";
-import { EntityHeader } from "./Entity";
+import { DEFAULT_SALE_PRICE_LIST_ID } from "./Constants";
+import { EntityHeader, UpdatableEntity } from "./Entity";
 import ProductCategory from "./ProductCategory";
 // The catalog of a business: its categories and the products in them. Not an entity and not on the
-// wire. The sync layer rebuilds it from the flat item entities of a sync response.
+// wire. The sync layer builds it from the flat item entities of a sync response, as the merchant
+// app's Catalog is built.
+//
+// The constructor links what it is given: a package to its product, a price to its price list and a
+// price list to its parent. It does not depend on any price list being present. Packages are priced
+// from currentSalePriceListId, so setting that id decides which packages and products are buyable.
 class Catalog {
-    constructor(categories, products, _priceList) {
-        this._priceList = _priceList;
+    constructor(categories, products, packages, priceLists, prices) {
+        // Every package that has a product, by that product's id, whether it can be bought or not
+        this._candidatePackages = new Map();
+        this._priceListMap = new Map();
+        this._currentSalePriceListId = DEFAULT_SALE_PRICE_LIST_ID;
+        // What a customer can reach, rebuilt by applySalePriceList
+        this._categories = Object.freeze([]);
+        this._products = Object.freeze([]);
         this._categoryMap = new Map();
         this._productMap = new Map();
         this._packageMap = new Map();
+        this._allCategories = categories;
+        this._allProducts = products;
         // A dummy category for products whose parentItemId is Constants.ENTITY_ID_NULL. Its id is also
         // ENTITY_ID_NULL, so getCategory(product.productCategoryId) resolves it like a real category.
-        // It is left out below like any other category when it has no products.
-        const uncategorized = new ProductCategory(new EntityHeader(BigInt(proto_Constants.ENTITY_ID_NULL), 0n, 0n, 0n, 0n), "", null, BigInt(proto_Constants.ENTITY_ID_NULL), false);
-        // Only a buyable product is part of a catalog: enabled, not sold only offline, with at least one
-        // buyable package. Any other is left out of products, getProduct and its categories, and its
-        // packages are unreachable by id. Enforced here so no builder can expose a product that cannot
-        // be bought.
-        const buyableProducts = [];
-        const productsByCategory = new Map();
-        for (const product of products) {
-            if (!product.isBuyable)
+        // It is left out like any other category when it has no buyable products.
+        this._uncategorized = new ProductCategory(new EntityHeader(BigInt(proto_Constants.ENTITY_ID_NULL), 0n, 0n, 0n, 0n), "", null, BigInt(proto_Constants.ENTITY_ID_NULL), false);
+        // A package with no product is dropped
+        const productsById = new Map();
+        for (const product of products)
+            productsById.set(product.id, product);
+        for (const pkg of packages) {
+            const product = productsById.get(pkg.productId);
+            if (product === undefined)
                 continue;
-            buyableProducts.push(product);
-            this._productMap.set(product.id, product);
-            const productsOfCategory = productsByCategory.get(product.productCategoryId);
-            if (productsOfCategory === undefined)
-                productsByCategory.set(product.productCategoryId, [product]);
+            UpdatableEntity.setParent(pkg, product);
+            const productPackages = this._candidatePackages.get(product.id);
+            if (productPackages === undefined)
+                this._candidatePackages.set(product.id, [pkg]);
             else
-                productsOfCategory.push(product);
-            for (const pkg of product.packages)
-                this._packageMap.set(pkg.id, pkg);
+                productPackages.push(pkg);
         }
-        this._products = Object.freeze(buyableProducts);
-        // A category with no buyable products is left out instead of being kept empty. This includes
-        // the dummy category.
-        const nonEmptyCategories = [];
-        for (const category of [...categories, uncategorized]) {
-            const categoryProducts = productsByCategory.get(category.id);
-            if (categoryProducts === undefined)
+        // The first of two price lists with one id is kept. A price with no price list is dropped, and a
+        // list holds one price per package, the first to arrive.
+        for (const priceList of priceLists)
+            if (!this._priceListMap.has(priceList.id))
+                this._priceListMap.set(priceList.id, priceList);
+        const pricesByList = new Map();
+        for (const price of prices) {
+            if (!this._priceListMap.has(price.priceListId))
                 continue;
-            category.products = Object.freeze(categoryProducts);
-            nonEmptyCategories.push(category);
+            const listPrices = pricesByList.get(price.priceListId);
+            if (listPrices === undefined)
+                pricesByList.set(price.priceListId, new Map([[price.packageId, price]]));
+            else if (!listPrices.has(price.packageId))
+                listPrices.set(price.packageId, price);
         }
-        this._categories = Object.freeze(nonEmptyCategories);
-        for (const category of this._categories)
-            this._categoryMap.set(category.id, category);
+        // A parent that was not read, or a list that names itself, leaves the list without a parent
+        for (const priceList of this._priceListMap.values()) {
+            const updatable = priceList;
+            updatable.prices = pricesByList.get(priceList.id) ?? new Map();
+            const parent = this._priceListMap.get(priceList.parentPriceListId) ?? null;
+            updatable.parentPriceList = parent === priceList ? null : parent;
+        }
+        this.applySalePriceList();
     }
     // In no particular order - a UI orders these for display
     get categories() {
@@ -55,11 +74,22 @@ class Catalog {
     get products() {
         return this._products;
     }
-    // The one price list a storefront sells from (MeraBills Online). Null until it arrives. Every
-    // price in this catalog belongs to it, and prices in other lists are left out. A shopping list
+    // The id of the price list packages are priced from, DEFAULT_SALE_PRICE_LIST_ID until the sync
+    // layer sets it. Setting it prices every package from that list (see PriceList.getPrice), and keeps
+    // the packages, products and categories that can then be bought. An id that names no list prices
+    // nothing, so the catalog holds nothing.
+    get currentSalePriceListId() {
+        return this._currentSalePriceListId;
+    }
+    set currentSalePriceListId(value) {
+        this._currentSalePriceListId = value;
+        this.applySalePriceList();
+    }
+    // The price list packages are priced from (MeraBills Online for a storefront). Null when the
+    // catalog has no list with the current id, as before the catalog has arrived. A shopping list
     // built from this catalog carries its id, or MERABILLS_ONLINE_PRICE_LIST_ID while it is null.
     get priceList() {
-        return this._priceList;
+        return this._priceListMap.get(this._currentSalePriceListId) ?? null;
     }
     get productCount() {
         return this._products.length;
@@ -75,7 +105,8 @@ class Catalog {
         return this._productMap.get(productId) ?? null;
     }
     // Null for the four reserved package ids a shopping list uses for its charge and summary lines
-    // (see Ids.isReservedPackageId), and for a package whose product was deleted or is not buyable
+    // (see Ids.isReservedPackageId), and for a package that is not buyable or whose product is not
+    // buyable
     getPackage(packageId) {
         return this._packageMap.get(packageId) ?? null;
     }
@@ -111,7 +142,56 @@ class Catalog {
             return -1;
         return left.offerPrice - right.offerPrice;
     }
+    // Prices the packages from the current sale price list, then rebuilds what a customer can reach.
+    // Only a buyable product is part of a catalog: enabled, not sold only offline, with at least one
+    // buyable package. Any other is left out of products, getProduct and its categories, and its
+    // packages are unreachable by id. A category with no buyable products is left out too, the dummy
+    // one included.
+    applySalePriceList() {
+        const salePriceList = this.priceList;
+        const buyableProducts = [];
+        const productMap = new Map();
+        const packageMap = new Map();
+        const productsByCategory = new Map();
+        for (const product of this._allProducts) {
+            const candidates = this._candidatePackages.get(product.id) ?? [];
+            for (const pkg of candidates) {
+                const price = salePriceList === null ? null : salePriceList.getPrice(pkg.id);
+                pkg.price = price;
+                if (price !== null)
+                    UpdatableEntity.setParent(price, pkg);
+            }
+            // The product keeps only the buyable ones, and is judged by them
+            product.packages = candidates;
+            if (!product.isBuyable)
+                continue;
+            buyableProducts.push(product);
+            productMap.set(product.id, product);
+            const productsOfCategory = productsByCategory.get(product.productCategoryId);
+            if (productsOfCategory === undefined)
+                productsByCategory.set(product.productCategoryId, [product]);
+            else
+                productsOfCategory.push(product);
+            for (const pkg of product.packages)
+                packageMap.set(pkg.id, pkg);
+        }
+        const nonEmptyCategories = [];
+        const categoryMap = new Map();
+        for (const category of [...this._allCategories, this._uncategorized]) {
+            const categoryProducts = productsByCategory.get(category.id);
+            category.products = Object.freeze(categoryProducts ?? []);
+            if (categoryProducts === undefined)
+                continue;
+            nonEmptyCategories.push(category);
+            categoryMap.set(category.id, category);
+        }
+        this._products = Object.freeze(buyableProducts);
+        this._categories = Object.freeze(nonEmptyCategories);
+        this._productMap = productMap;
+        this._packageMap = packageMap;
+        this._categoryMap = categoryMap;
+    }
 }
 // A business whose catalog has not arrived yet
-Catalog.EMPTY = new Catalog(Object.freeze([]), Object.freeze([]), null);
+Catalog.EMPTY = new Catalog([], [], [], [], []);
 export default Catalog;

package/dist/Constants.d.ts

@@ -1,5 +1,6 @@
 export { Constants } from "./generated/Constants";
 export declare function buildPriceListId(priceList: number): bigint;
+export declare const DEFAULT_SALE_PRICE_LIST_ID: bigint;
 export declare const MERABILLS_ONLINE_PRICE_LIST_ID: bigint;
 export declare const MAX_SCALED_AMOUNT: bigint;
 export declare function amountFromScaledValue(scaledAmount: bigint): number;

package/dist/Constants.js

@@ -11,9 +11,12 @@ export { Constants } from "./generated/Constants";
 export function buildPriceListId(priceList) {
     return Ids.buildId(proto_Constants.PRICE_LIST_ENTITY_TYPE_ID, BigInt(priceList));
 }
-// The only price list this library reads. A business prices a package in several lists (over the
-// counter, on a marketplace), and only this one is the storefront's. Prices in other lists are
-// skipped, see ProtoMap.buildBusiness.
+// The list a catalog sells from until another is set, as in the merchant app's Catalog
+export const DEFAULT_SALE_PRICE_LIST_ID = buildPriceListId(proto_Constants.DEFAULT_SALE_PRICE_LIST);
+// The list a storefront sells from. A business prices a package in several lists (over the counter,
+// on a marketplace), and a response can carry any of its public ones. ProtoMap.buildBusiness sets
+// the catalog to sell from this one, which can take the amounts of a package from its parent (see
+// PriceList.getPrice).
 export const MERABILLS_ONLINE_PRICE_LIST_ID = buildPriceListId(proto_Constants.MERABILLS_ONLINE_PRICE_LIST);
 // The largest amount the protocol can carry (Java Transaction.MAX_AMOUNT). Kept here because it does
 // not fit a protobuf enum value. It is 2^44 - 1, well below 2^53, so an amount is safe as a number.

package/dist/Entity.d.ts

@@ -10,6 +10,7 @@ export default abstract class Entity {
     get isDeleted(): boolean;
     get parent(): Entity | null;
     protected set parent(value: Entity | null);
+    protected get header(): EntityHeader;
     private static readonly UPDATE_TYPE_MASK;
     private readonly _header;
     private _parent;

package/dist/Entity.js

@@ -49,6 +49,10 @@ class Entity {
     set parent(value) {
         this._parent = value;
     }
+    // For a subclass that builds a variant of itself, which has the same id and update number
+    get header() {
+        return this._header;
+    }
 }
 Entity.UPDATE_TYPE_MASK = BigInt(proto_Constants.UPDATE_TYPE_MASK);
 export default Entity;

package/dist/Enums.d.ts

@@ -5,6 +5,7 @@ export { BusinessIdentifierType } from "./generated/BusinessIdentifierType";
 export { DimensionUnit } from "./generated/DimensionUnit";
 export { FulfillmentMode } from "./generated/FulfillmentMode";
 export { MessageType } from "./generated/MessageType";
+export { OnlineStoreTheme } from "./generated/OnlineStoreTheme";
 export { OrderStatus } from "./generated/OrderStatus";
 export { PackageIdentifierType } from "./generated/PackageIdentifierType";
 export { PaymentMethod } from "./generated/PaymentMethod";

package/dist/Enums.js

@@ -8,6 +8,7 @@ export { BusinessIdentifierType } from "./generated/BusinessIdentifierType";
 export { DimensionUnit } from "./generated/DimensionUnit";
 export { FulfillmentMode } from "./generated/FulfillmentMode";
 export { MessageType } from "./generated/MessageType";
+export { OnlineStoreTheme } from "./generated/OnlineStoreTheme";
 export { OrderStatus } from "./generated/OrderStatus";
 export { PackageIdentifierType } from "./generated/PackageIdentifierType";
 export { PaymentMethod } from "./generated/PaymentMethod";

package/dist/GeneralSettings.d.ts

@@ -1,4 +1,5 @@
 import { FulfillmentMode as proto_FulfillmentMode } from "./generated/FulfillmentMode";
+import { OnlineStoreTheme as proto_OnlineStoreTheme } from "./generated/OnlineStoreTheme";
 import { AddressList } from "./Address";
 import BusinessIdentifier from "./BusinessIdentifier";
 import LatLong from "./LatLong";
@@ -22,10 +23,10 @@ export default class GeneralSettings {
     private readonly _primaryStoreLocation;
     private readonly _googleBusinessCategoryId;
     private readonly _googleBusinessCategoryName;
-    private readonly _onlineStoreThemeId;
+    private readonly _onlineStoreTheme;
     private readonly _onlineShoppingEnabled;
-    static fromScaledValues(paymentMethodDetails: ReadonlyArray<PaymentMethodDetail>, customerServicePhone: string | null, isWhatsAppSupported: boolean, isSmsSupported: boolean, businessAddresses: AddressList, businessIdentifiers: ReadonlyArray<BusinessIdentifier>, fulfillmentModes: ReadonlyArray<proto_FulfillmentMode>, scaledDeliveryCharge: bigint, deliveryChargeTaxes: ReadonlyArray<Tax>, scaledFreeDeliveryTotal: bigint, deliveryRadiusKilometres: number, storeTagline: string | null, workingDays: WorkingDays, primaryStoreLocation: LatLong | null, googleBusinessCategoryId: string | null, googleBusinessCategoryName: string | null, onlineStoreThemeId: string | null, onlineShoppingEnabled: boolean): GeneralSettings;
-    constructor(_paymentMethodDetails: ReadonlyArray<PaymentMethodDetail>, _customerServicePhone: string | null, _isWhatsAppSupported: boolean, _isSmsSupported: boolean, _businessAddresses: AddressList, _businessIdentifiers: ReadonlyArray<BusinessIdentifier>, _fulfillmentModes: ReadonlyArray<proto_FulfillmentMode>, _deliveryCharge: number, _deliveryChargeTaxes: ReadonlyArray<Tax>, _freeDeliveryTotal: number, _deliveryRadiusKilometres: number, _storeTagline: string | null, _workingDays: WorkingDays, _primaryStoreLocation: LatLong | null, _googleBusinessCategoryId: string | null, _googleBusinessCategoryName: string | null, _onlineStoreThemeId: string | null, _onlineShoppingEnabled: boolean);
+    static fromScaledValues(paymentMethodDetails: ReadonlyArray<PaymentMethodDetail>, customerServicePhone: string | null, isWhatsAppSupported: boolean, isSmsSupported: boolean, businessAddresses: AddressList, businessIdentifiers: ReadonlyArray<BusinessIdentifier>, fulfillmentModes: ReadonlyArray<proto_FulfillmentMode>, scaledDeliveryCharge: bigint, deliveryChargeTaxes: ReadonlyArray<Tax>, scaledFreeDeliveryTotal: bigint, deliveryRadiusKilometres: number, storeTagline: string | null, workingDays: WorkingDays, primaryStoreLocation: LatLong | null, googleBusinessCategoryId: string | null, googleBusinessCategoryName: string | null, onlineStoreTheme: proto_OnlineStoreTheme | null, onlineShoppingEnabled: boolean): GeneralSettings;
+    constructor(_paymentMethodDetails: ReadonlyArray<PaymentMethodDetail>, _customerServicePhone: string | null, _isWhatsAppSupported: boolean, _isSmsSupported: boolean, _businessAddresses: AddressList, _businessIdentifiers: ReadonlyArray<BusinessIdentifier>, _fulfillmentModes: ReadonlyArray<proto_FulfillmentMode>, _deliveryCharge: number, _deliveryChargeTaxes: ReadonlyArray<Tax>, _freeDeliveryTotal: number, _deliveryRadiusKilometres: number, _storeTagline: string | null, _workingDays: WorkingDays, _primaryStoreLocation: LatLong | null, _googleBusinessCategoryId: string | null, _googleBusinessCategoryName: string | null, _onlineStoreTheme: proto_OnlineStoreTheme | null, _onlineShoppingEnabled: boolean);
     get paymentMethodDetails(): ReadonlyArray<PaymentMethodDetail>;
     get customerServicePhone(): string | null;
     get isWhatsAppSupported(): boolean;
@@ -42,7 +43,7 @@ export default class GeneralSettings {
     get primaryStoreLocation(): LatLong | null;
     get googleBusinessCategoryId(): string | null;
     get googleBusinessCategoryName(): string | null;
-    get onlineStoreThemeId(): string | null;
+    get onlineStoreTheme(): proto_OnlineStoreTheme | null;
     get onlineShoppingEnabled(): boolean;
     static readonly EMPTY: GeneralSettings;
 }

package/dist/GeneralSettings.js

@@ -7,10 +7,10 @@ import WorkingDays from "./WorkingDays";
 // merchant-only fields are absent.
 class GeneralSettings {
     // For ProtoMap, which sees amounts still multiplied by Constants.AMOUNT_FACTOR.
-    static fromScaledValues(paymentMethodDetails, customerServicePhone, isWhatsAppSupported, isSmsSupported, businessAddresses, businessIdentifiers, fulfillmentModes, scaledDeliveryCharge, deliveryChargeTaxes, scaledFreeDeliveryTotal, deliveryRadiusKilometres, storeTagline, workingDays, primaryStoreLocation, googleBusinessCategoryId, googleBusinessCategoryName, onlineStoreThemeId, onlineShoppingEnabled) {
-        return new GeneralSettings(paymentMethodDetails, customerServicePhone, isWhatsAppSupported, isSmsSupported, businessAddresses, businessIdentifiers, fulfillmentModes, amountFromScaledValue(scaledDeliveryCharge), deliveryChargeTaxes, amountFromScaledValue(scaledFreeDeliveryTotal), deliveryRadiusKilometres, storeTagline, workingDays, primaryStoreLocation, googleBusinessCategoryId, googleBusinessCategoryName, onlineStoreThemeId, onlineShoppingEnabled);
+    static fromScaledValues(paymentMethodDetails, customerServicePhone, isWhatsAppSupported, isSmsSupported, businessAddresses, businessIdentifiers, fulfillmentModes, scaledDeliveryCharge, deliveryChargeTaxes, scaledFreeDeliveryTotal, deliveryRadiusKilometres, storeTagline, workingDays, primaryStoreLocation, googleBusinessCategoryId, googleBusinessCategoryName, onlineStoreTheme, onlineShoppingEnabled) {
+        return new GeneralSettings(paymentMethodDetails, customerServicePhone, isWhatsAppSupported, isSmsSupported, businessAddresses, businessIdentifiers, fulfillmentModes, amountFromScaledValue(scaledDeliveryCharge), deliveryChargeTaxes, amountFromScaledValue(scaledFreeDeliveryTotal), deliveryRadiusKilometres, storeTagline, workingDays, primaryStoreLocation, googleBusinessCategoryId, googleBusinessCategoryName, onlineStoreTheme, onlineShoppingEnabled);
     }
-    constructor(_paymentMethodDetails, _customerServicePhone, _isWhatsAppSupported, _isSmsSupported, _businessAddresses, _businessIdentifiers, _fulfillmentModes, _deliveryCharge, _deliveryChargeTaxes, _freeDeliveryTotal, _deliveryRadiusKilometres, _storeTagline, _workingDays, _primaryStoreLocation, _googleBusinessCategoryId, _googleBusinessCategoryName, _onlineStoreThemeId, _onlineShoppingEnabled) {
+    constructor(_paymentMethodDetails, _customerServicePhone, _isWhatsAppSupported, _isSmsSupported, _businessAddresses, _businessIdentifiers, _fulfillmentModes, _deliveryCharge, _deliveryChargeTaxes, _freeDeliveryTotal, _deliveryRadiusKilometres, _storeTagline, _workingDays, _primaryStoreLocation, _googleBusinessCategoryId, _googleBusinessCategoryName, _onlineStoreTheme, _onlineShoppingEnabled) {
         this._paymentMethodDetails = _paymentMethodDetails;
         this._customerServicePhone = _customerServicePhone;
         this._isWhatsAppSupported = _isWhatsAppSupported;
@@ -27,7 +27,7 @@ class GeneralSettings {
         this._primaryStoreLocation = _primaryStoreLocation;
         this._googleBusinessCategoryId = _googleBusinessCategoryId;
         this._googleBusinessCategoryName = _googleBusinessCategoryName;
-        this._onlineStoreThemeId = _onlineStoreThemeId;
+        this._onlineStoreTheme = _onlineStoreTheme;
         this._onlineShoppingEnabled = _onlineShoppingEnabled;
     }
     get paymentMethodDetails() {
@@ -93,10 +93,11 @@ class GeneralSettings {
     get googleBusinessCategoryName() {
         return this._googleBusinessCategoryName;
     }
-    // Which of the storefront's own themes this business picked. The storefront defines what an id
-    // means. This library does not interpret it. Null when none was picked.
-    get onlineStoreThemeId() {
-        return this._onlineStoreThemeId;
+    // Which of the storefront's themes this business picked. Null when none was picked. A theme that a
+    // newer app added, which this version of the library has no entry for, is returned as it came: a
+    // number that is not a member of the enum. A caller that maps themes must have a fallback.
+    get onlineStoreTheme() {
+        return this._onlineStoreTheme;
     }
     // Whether the business has turned online shopping on. The server sends the business either way.
     // Model throws a NotFoundException, after reading everything it was sent, when the settings it

package/dist/Item.js

@@ -17,7 +17,8 @@ export default class Item extends Entity {
     get description() {
         return this._description;
     }
-    // Constants.ENTITY_ID_NULL when this item has no parent (e.g. an uncategorized product, or a price list).
+    // Constants.ENTITY_ID_NULL when this item has no parent (e.g. an uncategorized product, or a price
+    // list with no parent list).
     get parentItemId() {
         return this._parentItemId;
     }

package/dist/Package.d.ts

@@ -11,8 +11,7 @@ export default class Package extends Item {
     private readonly _dimensions;
     private readonly _weight;
     private readonly _photos;
-    private readonly _price;
-    constructor(header: EntityHeader, name: string, description: string | null, productId: bigint, isDisabled: boolean, _isSoldLoose: boolean, _itemCode: bigint, _identifiers: ReadonlyArray<PackageIdentifier>, _dimensions: Dimensions | null, _weight: Weight | null, _photos: ReadonlyArray<Photo>, _price: Price | null);
+    constructor(header: EntityHeader, name: string, description: string | null, productId: bigint, isDisabled: boolean, _isSoldLoose: boolean, _itemCode: bigint, _identifiers: ReadonlyArray<PackageIdentifier>, _dimensions: Dimensions | null, _weight: Weight | null, _photos: ReadonlyArray<Photo>);
     get productId(): bigint;
     get isSoldLoose(): boolean;
     get itemCode(): bigint;
@@ -21,5 +20,10 @@ export default class Package extends Item {
     get weight(): Weight | null;
     get photos(): ReadonlyArray<Photo>;
     get price(): Price | null;
+    private set price(value);
     get isBuyable(): boolean;
+    private _price;
+}
+export interface UpdatablePackage {
+    set price(value: Price | null);
 }

package/dist/Package.js

@@ -1,8 +1,9 @@
 import Item from "./Item";
 // A package, or variant, of a product (a 500 gram bottle of mango pickle, say) and the thing a
-// customer buys. Built complete, with photos and price resolved, so everything here is readonly.
+// customer buys. Built with its photos. Catalog sets the price, once the price list to sell from is
+// known.
 export default class Package extends Item {
-    constructor(header, name, description, productId, isDisabled, _isSoldLoose, _itemCode, _identifiers, _dimensions, _weight, _photos, _price) {
+    constructor(header, name, description, productId, isDisabled, _isSoldLoose, _itemCode, _identifiers, _dimensions, _weight, _photos) {
         super(header, name, description, productId, isDisabled);
         this._isSoldLoose = _isSoldLoose;
         this._itemCode = _itemCode;
@@ -10,7 +11,7 @@ export default class Package extends Item {
         this._dimensions = _dimensions;
         this._weight = _weight;
         this._photos = _photos;
-        this._price = _price;
+        this._price = null;
     }
     // The product this package is a variant of, which is the parent id every item has
     get productId() {
@@ -37,11 +38,16 @@ export default class Package extends Item {
     get photos() {
         return this._photos;
     }
-    // What this package costs, with the taxes of its product included (Product.taxes). Null when the
-    // business has not priced it, so it cannot be bought.
+    // What this package costs, with the taxes of its product included (Product.taxes). It is the
+    // price in the catalog's sale price list, which can follow that list's parent (see
+    // PriceList.getPrice). It is disabled when the package is not in the list. Null when the list gives
+    // the package no price, so the package cannot be bought.
     get price() {
         return this._price;
     }
+    set price(value) {
+        this._price = value;
+    }
     // True when this package is enabled and has an enabled price. Checked here because a
     // product-level filter does not guarantee that every package, or every price, of an otherwise
     // visible product is enabled.

package/dist/Price.d.ts

@@ -4,10 +4,13 @@ export default class Price extends Item {
     private readonly _packageId;
     private readonly _regularPrice;
     private readonly _offerPrice;
-    static fromScaledValues(header: EntityHeader, name: string, description: string | null, priceListId: bigint, isDisabled: boolean, packageId: bigint, scaledRegularPrice: bigint, scaledOfferPrice: bigint): Price;
-    constructor(header: EntityHeader, name: string, description: string | null, priceListId: bigint, isDisabled: boolean, _packageId: bigint, _regularPrice: number, _offerPrice: number);
+    private readonly _isPlaceholder;
+    static fromScaledValues(header: EntityHeader, name: string, description: string | null, priceListId: bigint, isDisabled: boolean, packageId: bigint, scaledRegularPrice: bigint, scaledOfferPrice: bigint, isPlaceholder?: boolean): Price;
+    constructor(header: EntityHeader, name: string, description: string | null, priceListId: bigint, isDisabled: boolean, _packageId: bigint, _regularPrice: number, _offerPrice: number, _isPlaceholder?: boolean);
     get packageId(): bigint;
     get priceListId(): bigint;
+    get isPlaceholder(): boolean;
+    withIsDisabled(isDisabled: boolean): Price;
     get regularPrice(): number;
     get offerPrice(): number;
     get finalPrice(): number;

package/dist/Price.js

@@ -9,14 +9,15 @@ import Item from "./Item";
 // stores a price without taxes, so a cart takes them out (CartEditor).
 export default class Price extends Item {
     // For ProtoMap, which sees prices still multiplied by Constants.AMOUNT_FACTOR.
-    static fromScaledValues(header, name, description, priceListId, isDisabled, packageId, scaledRegularPrice, scaledOfferPrice) {
-        return new Price(header, name, description, priceListId, isDisabled, packageId, amountFromScaledValue(scaledRegularPrice), amountFromScaledValue(scaledOfferPrice));
+    static fromScaledValues(header, name, description, priceListId, isDisabled, packageId, scaledRegularPrice, scaledOfferPrice, isPlaceholder = false) {
+        return new Price(header, name, description, priceListId, isDisabled, packageId, amountFromScaledValue(scaledRegularPrice), amountFromScaledValue(scaledOfferPrice), isPlaceholder);
     }
-    constructor(header, name, description, priceListId, isDisabled, _packageId, _regularPrice, _offerPrice) {
+    constructor(header, name, description, priceListId, isDisabled, _packageId, _regularPrice, _offerPrice, _isPlaceholder = false) {
         super(header, name, description, priceListId, isDisabled);
         this._packageId = _packageId;
         this._regularPrice = _regularPrice;
         this._offerPrice = _offerPrice;
+        this._isPlaceholder = _isPlaceholder;
     }
     // The package this price applies to. Nothing nests on the wire, so this is how the catalog finds
     // the price of a package.
@@ -27,6 +28,20 @@ export default class Price extends Item {
     get priceListId() {
         return this.parentItemId;
     }
+    // True when this price has no amounts of its own: the package has the amounts of the price the
+    // list's parent has for it. regularPrice and offerPrice are a copy of those, which can be out of
+    // date, so they are never used. isDisabled says whether the package is in this list. See
+    // PriceList.getPrice, which resolves it. A UI never sees one, because Package.price is never a
+    // placeholder.
+    get isPlaceholder() {
+        return this._isPlaceholder;
+    }
+    // This price with another enabled state: the same entity, amounts and list. For PriceList.getPrice,
+    // which returns a price that is not the one the list holds when the package's state in the list
+    // differs from the state of the price that gives its amounts.
+    withIsDisabled(isDisabled) {
+        return new Price(this.header, this.name, this.description, this.priceListId, isDisabled, this._packageId, this._regularPrice, this._offerPrice, this._isPlaceholder);
+    }
     get regularPrice() {
         return this._regularPrice;
     }

package/dist/PriceList.d.ts

@@ -1,3 +1,16 @@
 import Item from "./Item";
+import Price from "./Price";
 export default class PriceList extends Item {
+    get parentPriceListId(): bigint;
+    get parentPriceList(): PriceList | null;
+    private set parentPriceList(value);
+    get prices(): ReadonlyMap<bigint, Price>;
+    private set prices(value);
+    getPrice(packageId: bigint): Price | null;
+    private _parentPriceList;
+    private _prices;
+}
+export interface UpdatablePriceList {
+    set parentPriceList(value: PriceList | null);
+    set prices(value: ReadonlyMap<bigint, Price>);
 }

package/dist/PriceList.js

@@ -1,5 +1,53 @@
 import Item from "./Item";
-// A named list of prices. A storefront sells from one, so no package has two prices to choose
-// between. Catalog.priceList holds it, and CartEditor names its id on the carts it builds.
+// A named list of prices, at most one per package. A list can have a parent, named by its
+// parentItemId, and gets the amounts of some packages from it. See getPrice for the rules. Catalog
+// sets the prices and the parent, once every price list and price has been read.
 export default class PriceList extends Item {
+    constructor() {
+        super(...arguments);
+        this._parentPriceList = null;
+        this._prices = new Map();
+    }
+    // The id of the list whose prices give the amounts of the packages this list takes them from it
+    // for, or Constants.ENTITY_ID_NULL when this list has no parent
+    get parentPriceListId() {
+        return this.parentItemId;
+    }
+    // Null when this list has no parent, or when the parent was not read. Not Entity.parent, which is
+    // the business.
+    get parentPriceList() {
+        return this._parentPriceList;
+    }
+    set parentPriceList(value) {
+        this._parentPriceList = value;
+    }
+    // The prices of this list itself, by package id. getPrice also looks in the parent.
+    get prices() {
+        return this._prices;
+    }
+    set prices(value) {
+        this._prices = value;
+    }
+    // The price of a package in this list, or null when the list gives it none. Only the parent is
+    // consulted, not its parent.
+    // - A list follows its parent. A package the list has no price for has the parent's price, so its
+    //   amounts and whether it is enabled.
+    // - A price of this list replaces the parent's price, both amounts and enabled state.
+    // - A placeholder replaces only the enabled state. The amounts are the parent's. The placeholder
+    //   holds a copy of them that can be out of date, so it is never used.
+    // - The package is in the list when the price returned is enabled.
+    // - A placeholder gives no price when the parent has none.
+    // The price returned is the one that gives the amounts when it already has the right state, and a
+    // copy of it with the right state (withIsDisabled) otherwise.
+    getPrice(packageId) {
+        const ownPrice = this._prices.get(packageId);
+        if (ownPrice !== undefined && !ownPrice.isPlaceholder)
+            return ownPrice;
+        const parentPrice = this._parentPriceList?._prices.get(packageId);
+        if (parentPrice === undefined)
+            return null;
+        if (ownPrice === undefined || ownPrice.isDisabled === parentPrice.isDisabled)
+            return parentPrice;
+        return parentPrice.withIsDisabled(ownPrice.isDisabled);
+    }
 }

package/dist/Product.d.ts

@@ -16,7 +16,7 @@ export default class Product extends Item {
     private readonly _features;
     private readonly _isForOfflineSaleOnly;
     private readonly _photos;
-    constructor(header: EntityHeader, name: string, description: string | null, productCategoryId: bigint, isDisabled: boolean, _productType: proto_ProductType, _brand: string | null, _isManufacturedByBusiness: boolean, _manufacturer: string | null, _manufacturerAddress: Address | null, _taxes: ReadonlyArray<Tax>, _features: ReadonlyArray<string>, _isForOfflineSaleOnly: boolean, _photos: ReadonlyArray<Photo>, packages: ReadonlyArray<Package>);
+    constructor(header: EntityHeader, name: string, description: string | null, productCategoryId: bigint, isDisabled: boolean, _productType: proto_ProductType, _brand: string | null, _isManufacturedByBusiness: boolean, _manufacturer: string | null, _manufacturerAddress: Address | null, _taxes: ReadonlyArray<Tax>, _features: ReadonlyArray<string>, _isForOfflineSaleOnly: boolean, _photos: ReadonlyArray<Photo>);
     get productCategoryId(): bigint;
     get productType(): proto_ProductType;
     get brand(): string | null;
@@ -28,8 +28,12 @@ export default class Product extends Item {
     get isForOfflineSaleOnly(): boolean;
     get photos(): ReadonlyArray<Photo>;
     get packages(): ReadonlyArray<Package>;
+    private set packages(value);
     get lowestPrice(): Price | null;
     get isOnOffer(): boolean;
     get isBuyable(): boolean;
-    private readonly _packages;
+    private _packages;
+}
+export interface UpdatableProduct {
+    set packages(value: ReadonlyArray<Package>);
 }