@peabody-soft/mbs-model-ts 1.3.0 → 1.5.0

package/dist/generated/BusinessSyncInRequest.d.ts

@@ -7,16 +7,24 @@ import { MessageType } from "@protobuf-ts/runtime";
 import { Message } from "./Message";
 /**
  * Pushes the business entities a customer has changed - their shopping cart and the orders placed
- * from it - to one business database, named the same way a BusinessSyncOutRequest names it.
+ * from it - to one business database. The request names no business: the link token in the
+ * AuthTokens of the authorization header does, as a link names exactly one.
+ * Not implemented yet: the route (shopBusinessSyncIn) answers 501, and what is said here and in the
+ * BusinessSyncInResponse is the contract that it is to meet, and not behaviour that the server has.
+ * ProtoMap.fromProto accepts the paymentReceived of an order, and the senderId and status of a message,
+ * as they are sent, so, sync in has to enforce who may set each of them when it is written.
  * An entity being synced in carries the id it already has, or Constants.ENTITY_ID_NULL if the
  * caller is creating it and the server is to assign one; incoming update numbers are the caller's
- * own and are replaced by the server, which returns the new ones in the BusinessSyncInResponse.
+ * own and are replaced by the server, which returns the messages bearing the new ones in the
+ * BusinessSyncInResponse.
  *
  * @generated from protobuf message com.merabills.storefront.BusinessSyncInRequest
  */
 export interface BusinessSyncInRequest {
     /**
-     * Client-side cursor for the customer's orders and shopping cart (Constants.MESSAGE_ENTITY_TYPE_ID).
+     * Client-side cursor for the customer's orders and shopping cart (Constants.MESSAGE_ENTITY_TYPE_ID):
+     * how far the client's sync outs of them have got, which is not moved by a push. The answer to a push
+     * is only the messages that were pushed, so, it does not depend on this.
      *
      * @generated from protobuf field: int64 messageUpdateNumber = 1
      */

package/dist/generated/BusinessSyncInResponse.d.ts

@@ -7,10 +7,11 @@ import { MessageType } from "@protobuf-ts/runtime";
 import { Message } from "./Message";
 import { AuthTokens } from "./AuthTokens";
 /**
- * The answer to a BusinessSyncInRequest: the update number the server assigned to the pushed
- * entities, one per entity type. Raise the matching cursor to this value so the next sync out does
- * not fetch back what was just sent; 0 means nothing of that type was accepted. Carries no entities
- * - sync out again to see the server's view of what was pushed.
+ * Not implemented yet (the route answers 501): this is the contract that it is to meet.
+ * The answer to a BusinessSyncInRequest: the messages the server now holds for what was pushed,
+ * which bear the update numbers it assigned, and any tokens it renewed. A push is not a read, so, do
+ * not move the message cursor with these update numbers: a change somebody else made, with an update
+ * number below them, would then never be sent. The next sync out returns what was pushed as well.
  *
  * @generated from protobuf message com.merabills.storefront.BusinessSyncInResponse
  */

package/dist/generated/BusinessSyncOutRequest.d.ts

@@ -10,54 +10,81 @@ import { MessageType } from "@protobuf-ts/runtime";
  * Entity.updateNumber of that type already synced (0 asks for everything), and a response of
  * Constants.SYNC_OUT_LIMIT entities means call again with the updated cursors. The caller and the
  * business's link token are in the AuthTokens of the authorization header, not in this message.
+ * The call fails with 404 (NotFoundException) when the business does not exist, has been deleted,
+ * or does not allow customers to join it, whoever the caller is - see BusinessSyncOutResponse.
+ * Whether it has turned online shopping on is not a refusal: that is for the client to decide.
  *
  * @generated from protobuf message com.merabills.storefront.BusinessSyncOutRequest
  */
 export interface BusinessSyncOutRequest {
     /**
-     * The business to sync out, by its unique, lower case, url friendly id (Constants.BUSINESS_ID_MIN_LENGTH
-     * to Constants.BUSINESS_ID_MAX_LENGTH).
+     * The business to sync out, named one way or the other, and one of the two is required. A client that
+     * does not yet hold the Business names it by its businessId, and one that does names it by the entity id
+     * it read there (Business.entity.id), which is what every later read is to use. The pages of one read are
+     * that read, and go on naming the business the way its first request did.
      *
-     * @generated from protobuf field: string businessId = 1
+     * @generated from protobuf oneof: business
      */
-    businessId: string;
+    business: {
+        oneofKind: "businessId";
+        /**
+         * Its unique, lower case, url friendly id (Constants.BUSINESS_ID_MIN_LENGTH to
+         * Constants.BUSINESS_ID_MAX_LENGTH). One that names no business, which includes one that is not a
+         * possible id, is the same as a business that does not exist. This is for a caller that has no link
+         * token: a link token is refused together with it, and is to be sent with businessEntityId.
+         *
+         * @generated from protobuf field: string businessId = 1
+         */
+        businessId: string;
+    } | {
+        oneofKind: "businessEntityId";
+        /**
+         * Its entity id, which has to be that of a business. If the AuthTokens carry a link token, it has to
+         * be the link token of this business, and a link token of any other is refused.
+         *
+         * @generated from protobuf field: int64 businessEntityId = 2
+         */
+        businessEntityId: bigint;
+    } | {
+        oneofKind: undefined;
+    };
     /**
      * Cursor for the Business entity (Constants.BUSINESS_ENTITY_TYPE_ID). Separate from, and never
      * mixed with, ProfileSyncOutRequest.businessUpdateNumber.
      *
-     * @generated from protobuf field: int64 businessUpdateNumber = 2
+     * @generated from protobuf field: int64 businessUpdateNumber = 3
      */
     businessUpdateNumber: bigint;
     /**
      * Cursor for photos of the business, its products and its packages (Constants.ATTACHMENT_ENTITY_TYPE_ID).
      *
-     * @generated from protobuf field: int64 attachmentUpdateNumber = 3
+     * @generated from protobuf field: int64 attachmentUpdateNumber = 4
      */
     attachmentUpdateNumber: bigint;
     /**
      * The UrlAndToken.expiry of the attachment base url this client is holding, sent back unchanged;
      * 0 means it holds none. A time, not a cursor - it does not rise monotonically.
      *
-     * @generated from protobuf field: int64 attachmentBaseUrlExpiry = 4
+     * @generated from protobuf field: int64 attachmentBaseUrlExpiry = 5
      */
     attachmentBaseUrlExpiry: bigint;
     /**
      * Cursor for the business's settings (Constants.CONFIGURATION_ENTITY_TYPE_ID).
      *
-     * @generated from protobuf field: int64 configurationUpdateNumber = 5
+     * @generated from protobuf field: int64 configurationUpdateNumber = 6
      */
     configurationUpdateNumber: bigint;
     /**
      * Cursor for the customer's orders and shopping cart (Constants.MESSAGE_ENTITY_TYPE_ID).
      *
-     * @generated from protobuf field: int64 messageUpdateNumber = 6
+     * @generated from protobuf field: int64 messageUpdateNumber = 7
      */
     messageUpdateNumber: bigint;
     /**
      * Cursor for the whole catalog - product categories, products, packages, price lists and prices,
      * which all share this one cursor (Constants.ITEM_ENTITY_TYPE_ID).
      *
-     * @generated from protobuf field: int64 itemUpdateNumber = 7
+     * @generated from protobuf field: int64 itemUpdateNumber = 8
      */
     itemUpdateNumber: bigint;
 }

package/dist/generated/BusinessSyncOutRequest.js

@@ -6,18 +6,19 @@ import { MessageType } from "@protobuf-ts/runtime";
 class BusinessSyncOutRequest$Type extends MessageType {
     constructor() {
         super("com.merabills.storefront.BusinessSyncOutRequest", [
-            { no: 1, name: "businessId", kind: "scalar", T: 9 /*ScalarType.STRING*/ },
-            { no: 2, name: "businessUpdateNumber", kind: "scalar", T: 3 /*ScalarType.INT64*/, L: 0 /*LongType.BIGINT*/ },
-            { no: 3, name: "attachmentUpdateNumber", kind: "scalar", T: 3 /*ScalarType.INT64*/, L: 0 /*LongType.BIGINT*/ },
-            { no: 4, name: "attachmentBaseUrlExpiry", kind: "scalar", T: 3 /*ScalarType.INT64*/, L: 0 /*LongType.BIGINT*/ },
-            { no: 5, name: "configurationUpdateNumber", kind: "scalar", T: 3 /*ScalarType.INT64*/, L: 0 /*LongType.BIGINT*/ },
-            { no: 6, name: "messageUpdateNumber", kind: "scalar", T: 3 /*ScalarType.INT64*/, L: 0 /*LongType.BIGINT*/ },
-            { no: 7, name: "itemUpdateNumber", kind: "scalar", T: 3 /*ScalarType.INT64*/, L: 0 /*LongType.BIGINT*/ }
+            { no: 1, name: "businessId", kind: "scalar", oneof: "business", T: 9 /*ScalarType.STRING*/ },
+            { no: 2, name: "businessEntityId", kind: "scalar", oneof: "business", T: 3 /*ScalarType.INT64*/, L: 0 /*LongType.BIGINT*/ },
+            { no: 3, name: "businessUpdateNumber", kind: "scalar", T: 3 /*ScalarType.INT64*/, L: 0 /*LongType.BIGINT*/ },
+            { no: 4, name: "attachmentUpdateNumber", kind: "scalar", T: 3 /*ScalarType.INT64*/, L: 0 /*LongType.BIGINT*/ },
+            { no: 5, name: "attachmentBaseUrlExpiry", kind: "scalar", T: 3 /*ScalarType.INT64*/, L: 0 /*LongType.BIGINT*/ },
+            { no: 6, name: "configurationUpdateNumber", kind: "scalar", T: 3 /*ScalarType.INT64*/, L: 0 /*LongType.BIGINT*/ },
+            { no: 7, name: "messageUpdateNumber", kind: "scalar", T: 3 /*ScalarType.INT64*/, L: 0 /*LongType.BIGINT*/ },
+            { no: 8, name: "itemUpdateNumber", kind: "scalar", T: 3 /*ScalarType.INT64*/, L: 0 /*LongType.BIGINT*/ }
         ]);
     }
     create(value) {
         const message = globalThis.Object.create((this.messagePrototype));
-        message.businessId = "";
+        message.business = { oneofKind: undefined };
         message.businessUpdateNumber = 0n;
         message.attachmentUpdateNumber = 0n;
         message.attachmentBaseUrlExpiry = 0n;
@@ -34,24 +35,33 @@ class BusinessSyncOutRequest$Type extends MessageType {
             let [fieldNo, wireType] = reader.tag();
             switch (fieldNo) {
                 case /* string businessId */ 1:
-                    message.businessId = reader.string();
+                    message.business = {
+                        oneofKind: "businessId",
+                        businessId: reader.string()
+                    };
                     break;
-                case /* int64 businessUpdateNumber */ 2:
+                case /* int64 businessEntityId */ 2:
+                    message.business = {
+                        oneofKind: "businessEntityId",
+                        businessEntityId: reader.int64().toBigInt()
+                    };
+                    break;
+                case /* int64 businessUpdateNumber */ 3:
                     message.businessUpdateNumber = reader.int64().toBigInt();
                     break;
-                case /* int64 attachmentUpdateNumber */ 3:
+                case /* int64 attachmentUpdateNumber */ 4:
                     message.attachmentUpdateNumber = reader.int64().toBigInt();
                     break;
-                case /* int64 attachmentBaseUrlExpiry */ 4:
+                case /* int64 attachmentBaseUrlExpiry */ 5:
                     message.attachmentBaseUrlExpiry = reader.int64().toBigInt();
                     break;
-                case /* int64 configurationUpdateNumber */ 5:
+                case /* int64 configurationUpdateNumber */ 6:
                     message.configurationUpdateNumber = reader.int64().toBigInt();
                     break;
-                case /* int64 messageUpdateNumber */ 6:
+                case /* int64 messageUpdateNumber */ 7:
                     message.messageUpdateNumber = reader.int64().toBigInt();
                     break;
-                case /* int64 itemUpdateNumber */ 7:
+                case /* int64 itemUpdateNumber */ 8:
                     message.itemUpdateNumber = reader.int64().toBigInt();
                     break;
                 default:
@@ -67,26 +77,29 @@ class BusinessSyncOutRequest$Type extends MessageType {
     }
     internalBinaryWrite(message, writer, options) {
         /* string businessId = 1; */
-        if (message.businessId !== "")
-            writer.tag(1, WireType.LengthDelimited).string(message.businessId);
-        /* int64 businessUpdateNumber = 2; */
+        if (message.business.oneofKind === "businessId")
+            writer.tag(1, WireType.LengthDelimited).string(message.business.businessId);
+        /* int64 businessEntityId = 2; */
+        if (message.business.oneofKind === "businessEntityId")
+            writer.tag(2, WireType.Varint).int64(message.business.businessEntityId);
+        /* int64 businessUpdateNumber = 3; */
         if (message.businessUpdateNumber !== 0n)
-            writer.tag(2, WireType.Varint).int64(message.businessUpdateNumber);
-        /* int64 attachmentUpdateNumber = 3; */
+            writer.tag(3, WireType.Varint).int64(message.businessUpdateNumber);
+        /* int64 attachmentUpdateNumber = 4; */
         if (message.attachmentUpdateNumber !== 0n)
-            writer.tag(3, WireType.Varint).int64(message.attachmentUpdateNumber);
-        /* int64 attachmentBaseUrlExpiry = 4; */
+            writer.tag(4, WireType.Varint).int64(message.attachmentUpdateNumber);
+        /* int64 attachmentBaseUrlExpiry = 5; */
         if (message.attachmentBaseUrlExpiry !== 0n)
-            writer.tag(4, WireType.Varint).int64(message.attachmentBaseUrlExpiry);
-        /* int64 configurationUpdateNumber = 5; */
+            writer.tag(5, WireType.Varint).int64(message.attachmentBaseUrlExpiry);
+        /* int64 configurationUpdateNumber = 6; */
         if (message.configurationUpdateNumber !== 0n)
-            writer.tag(5, WireType.Varint).int64(message.configurationUpdateNumber);
-        /* int64 messageUpdateNumber = 6; */
+            writer.tag(6, WireType.Varint).int64(message.configurationUpdateNumber);
+        /* int64 messageUpdateNumber = 7; */
         if (message.messageUpdateNumber !== 0n)
-            writer.tag(6, WireType.Varint).int64(message.messageUpdateNumber);
-        /* int64 itemUpdateNumber = 7; */
+            writer.tag(7, WireType.Varint).int64(message.messageUpdateNumber);
+        /* int64 itemUpdateNumber = 8; */
         if (message.itemUpdateNumber !== 0n)
-            writer.tag(7, WireType.Varint).int64(message.itemUpdateNumber);
+            writer.tag(8, WireType.Varint).int64(message.itemUpdateNumber);
         let u = options.writeUnknownFields;
         if (u !== false)
             (u == true ? UnknownFieldHandler.onWrite : u)(this.typeName, message, writer);

package/dist/generated/BusinessSyncOutResponse.d.ts

@@ -23,6 +23,15 @@ import { AuthTokens } from "./AuthTokens";
  * (updateNumber's update-type bits = Constants.UPDATE_TYPE_DELETED) means the entity, and what it
  * owned, was deleted. At most Constants.SYNC_OUT_LIMIT entities arrive together - that many means
  * call again with the raised cursors.
+ * There is no response, but a 404 (NotFoundException), when the business is not one a storefront can
+ * open: it does not exist or has been deleted, or it does not allow customers to join it. Both are
+ * looked at on every call, whatever the cursors are, and are the same to every caller: one that holds
+ * a link token of the business, a customer that joined it, is told no differently.
+ * A client that has the business cached and is told this must stop showing it.
+ * Whether the business has turned online shopping on is not looked at: a client that has read all it
+ * is sent decides it from the GeneralSettings that it then holds (onlineShoppingEnabled). Settings that
+ * are not there, or that have been deleted, or that say it has not, make it a business that a storefront
+ * cannot open, and a client that finds so must stop showing it as if it had been told this.
  *
  * @generated from protobuf message com.merabills.storefront.BusinessSyncOutResponse
  */
@@ -35,8 +44,12 @@ export interface BusinessSyncOutResponse {
      */
     authTokens?: AuthTokens;
     /**
-     * The business named by the request. Absent unless it has changed. Also carried by a
+     * The business named by the request, which is how a client that named it by its businessId learns
+     * its entity id for the calls that follow. Absent unless it has changed. Also carried by a
      * ProfileSyncOutResponse, with its own separate cursor - keep the two update numbers apart.
+     * The businessId of a business can change, and this arriving changed is the only thing that says so: a
+     * client that was asked to open a business by its businessId, and holds it by its entity id, compares the
+     * two once it has read all it is sent, as the entity id does not say which business that businessId names now.
      *
      * @generated from protobuf field: com.merabills.storefront.Business business = 2
      */

package/dist/generated/Configuration.d.ts

@@ -26,7 +26,8 @@ export interface Configuration {
         oneofKind: "generalSettings";
         /**
          * The publicly visible settings of the business, held in the configuration whose id is
-         * Configuration.MIN_PUBLIC_CONFIGURATION_ID
+         * Configuration.MIN_PUBLIC_CONFIGURATION_ID. Not set for settings that the server cannot read, which are a
+         * business that made none
          *
          * @generated from protobuf field: com.merabills.storefront.GeneralSettings generalSettings = 2
          */

package/dist/generated/CreateUserRequest.d.ts

@@ -6,7 +6,11 @@ import type { PartialMessage } from "@protobuf-ts/runtime";
 import { MessageType } from "@protobuf-ts/runtime";
 import { User } from "./User";
 /**
- * Creates a new user, optionally joining it to a business as a customer in the same call.
+ * Creates a new user, optionally joining it to a business as a customer in the same call, and is
+ * answered with a ProfileSyncOutResponse. Not implemented yet: the route (shopCreateUser) answers 501, and
+ * every rule below is the contract that it is to meet, and not behaviour that the server has. See
+ * Prompt.txt, CREATE USER AND UPDATE USER, which also gives the contract of the route that updates the
+ * caller's own user (its request is a bare User, matched to the caller by entity.id).
  *
  * @generated from protobuf message com.merabills.storefront.CreateUserRequest
  */
@@ -18,7 +22,9 @@ export interface CreateUserRequest {
      */
     user?: User;
     /**
-     * The business to join as a customer after creating the user. 0 means none.
+     * The business to join as a customer after creating the user. 0 means none, and anything else has to be
+     * the id of a business: one that is not is refused, not ignored. One that cannot be joined is to be refused
+     * as ProfileSyncOutRequest.joinBusinessId says - a 404, and the user is created all the same.
      *
      * @generated from protobuf field: int64 joinBusinessId = 2
      */

package/dist/generated/Entity.d.ts

@@ -28,9 +28,13 @@ export interface Entity {
     updatedAt: bigint;
     /**
      * Id of the database that last updated this entity; Constants.MASTER_DB_ID means the server. A
-     * client stamps its own id here on every entity it pushes, so its own writes are not sent back to
-     * it on the next sync out. Only set on business-database entities (Attachment, Configuration,
-     * Message, Item); always 0 on the profile entities User, Business and BusinessLink.
+     * client that has a database of its own (a merchant app) stamps its own id here on every entity
+     * it pushes, so its own writes are not sent back to it on the next sync out. A storefront has no
+     * database of its own: it leaves this zero, and its sync outs leave out nobody's changes, but
+     * return everything newer than the cursors - what the caller itself pushed included, which
+     * changes nothing that it holds. Only set on business-database entities (Attachment,
+     * Configuration, Message, Item); always 0 on the profile entities User, Business and
+     * BusinessLink.
      *
      * @generated from protobuf field: int64 updateInfo = 3
      */

package/dist/generated/GeneralSettings.d.ts

@@ -15,8 +15,8 @@ import { PaymentMethodDetail } from "./PaymentMethodDetail";
  * The publicly visible settings of a business - tagline, contact info, location, fulfillment,
  * payment and delivery options, and online store presentation - held in the value of the
  * business's public Configuration entity.
- * Excluded: onlineShoppingEnabled, and the fields of the StoreSettings base class (authToken,
- * authTokenExpiry, lastSuccessfulSync and fees).
+ * Excluded: the fields of the StoreSettings base class (authToken, authTokenExpiry,
+ * lastSuccessfulSync and fees).
  * Not included because it is a constant: overdueAfterMillis.
  *
  * @generated from protobuf message com.merabills.storefront.GeneralSettings
@@ -65,13 +65,14 @@ export interface GeneralSettings {
      */
     fulfillmentModes: FulfillmentMode[];
     /**
-     * Charge for delivering an order, multiplied by Constants.AMOUNT_FACTOR
+     * Charge for delivering an order, including the taxes in deliveryChargeTaxes, multiplied by
+     * Constants.AMOUNT_FACTOR
      *
      * @generated from protobuf field: int64 deliveryCharge = 8
      */
     deliveryCharge: bigint;
     /**
-     * Taxes that apply to deliveryCharge (at most Constants.MAX_TAXES)
+     * Taxes that are included in deliveryCharge (at most Constants.MAX_TAXES)
      *
      * @generated from protobuf field: repeated com.merabills.storefront.Tax deliveryChargeTaxes = 9
      */
@@ -127,6 +128,15 @@ export interface GeneralSettings {
      * @generated from protobuf field: optional string onlineStoreThemeId = 17
      */
     onlineStoreThemeId?: string;
+    /**
+     * True if the business has turned online shopping on. The server does not refuse a business that has
+     * not: it is for the client to, once it has read all it is sent (see BusinessSyncOutResponse). A
+     * business with no general settings at all, or with settings that have been deleted, has not turned
+     * it on either.
+     *
+     * @generated from protobuf field: bool onlineShoppingEnabled = 18
+     */
+    onlineShoppingEnabled: boolean;
 }
 declare class GeneralSettings$Type extends MessageType<GeneralSettings> {
     constructor();

package/dist/generated/GeneralSettings.js

@@ -29,7 +29,8 @@ class GeneralSettings$Type extends MessageType {
             { no: 14, name: "primaryStoreLocation", kind: "message", T: () => LatLong },
             { no: 15, name: "googleBusinessCategoryId", kind: "scalar", opt: true, T: 9 /*ScalarType.STRING*/ },
             { no: 16, name: "googleBusinessCategoryName", kind: "scalar", opt: true, T: 9 /*ScalarType.STRING*/ },
-            { no: 17, name: "onlineStoreThemeId", kind: "scalar", opt: true, T: 9 /*ScalarType.STRING*/ }
+            { no: 17, name: "onlineStoreThemeId", kind: "scalar", opt: true, T: 9 /*ScalarType.STRING*/ },
+            { no: 18, name: "onlineShoppingEnabled", kind: "scalar", T: 8 /*ScalarType.BOOL*/ }
         ]);
     }
     create(value) {
@@ -43,6 +44,7 @@ class GeneralSettings$Type extends MessageType {
         message.deliveryChargeTaxes = [];
         message.freeDeliveryTotal = 0n;
         message.deliveryRadiusKms = 0;
+        message.onlineShoppingEnabled = false;
         if (value !== undefined)
             reflectionMergePartial(this, message, value);
         return message;
@@ -107,6 +109,9 @@ class GeneralSettings$Type extends MessageType {
                 case /* optional string onlineStoreThemeId */ 17:
                     message.onlineStoreThemeId = reader.string();
                     break;
+                case /* bool onlineShoppingEnabled */ 18:
+                    message.onlineShoppingEnabled = reader.bool();
+                    break;
                 default:
                     let u = options.readUnknownField;
                     if (u === "throw")
@@ -174,6 +179,9 @@ class GeneralSettings$Type extends MessageType {
         /* optional string onlineStoreThemeId = 17; */
         if (message.onlineStoreThemeId !== undefined)
             writer.tag(17, WireType.LengthDelimited).string(message.onlineStoreThemeId);
+        /* bool onlineShoppingEnabled = 18; */
+        if (message.onlineShoppingEnabled !== false)
+            writer.tag(18, WireType.Varint).bool(message.onlineShoppingEnabled);
         let u = options.writeUnknownFields;
         if (u !== false)
             (u == true ? UnknownFieldHandler.onWrite : u)(this.typeName, message, writer);

package/dist/generated/Message.d.ts

@@ -22,8 +22,10 @@ export interface Message {
      */
     entity?: Entity;
     /**
-     * Id of the User that sent this message. Not carried by a business sync out - resolve against a
-     * profile sync out, or use senderName / senderPhone below.
+     * Id of the party that sent this message - Java Message.senderId, which is a party id and not the id
+     * of a User: the party of the BusinessLink of the sender (BusinessLink.partyId). Carried by a business
+     * sync out, which sends a customer only the messages whose sender is their own party. senderName /
+     * senderPhone below say who it was without resolving the party.
      *
      * @generated from protobuf field: int64 senderId = 2
      */

package/dist/generated/Product.d.ts

@@ -12,7 +12,7 @@ import { Item } from "./Item";
  * A product (goods, service, raw material or fixed asset) in the catalog of a business. Belongs to
  * at most one category (Item.parentItemId, 0 = none); its packages and photos are found the same
  * way, by parentItemId / owningEntityId.
- * Excluded: isDraft, forOfflineSaleOnly, isStockKeepingEnabled, isExpiryTrackingEnabled,
+ * Excluded: isDraft, isStockKeepingEnabled, isExpiryTrackingEnabled,
  * storeProperties, defaultExpiry, classifications, all Translations fields.
  *
  * @generated from protobuf message com.merabills.storefront.Product
@@ -63,6 +63,15 @@ export interface Product {
      * @generated from protobuf field: repeated string features = 8
      */
     features: string[];
+    /**
+     * True when the business sells this product only offline (Java Product.getForOfflineSaleOnly: the product has "available
+     * online" turned off). The server sends such a product like any other public one, and it is for the client to not show
+     * it, nor its packages, to a customer, nor let a customer order it (mbs-model's Catalog leaves it out). Absent means
+     * false: a product that is not offline-only
+     *
+     * @generated from protobuf field: bool forOfflineSaleOnly = 9
+     */
+    forOfflineSaleOnly: boolean;
 }
 declare class Product$Type extends MessageType<Product> {
     constructor();

package/dist/generated/Product.js

@@ -17,7 +17,8 @@ class Product$Type extends MessageType {
             { no: 5, name: "manufacturer", kind: "scalar", opt: true, T: 9 /*ScalarType.STRING*/ },
             { no: 6, name: "manufacturerAddress", kind: "message", T: () => Address },
             { no: 7, name: "taxes", kind: "message", repeat: 2 /*RepeatType.UNPACKED*/, T: () => Tax },
-            { no: 8, name: "features", kind: "scalar", repeat: 2 /*RepeatType.UNPACKED*/, T: 9 /*ScalarType.STRING*/ }
+            { no: 8, name: "features", kind: "scalar", repeat: 2 /*RepeatType.UNPACKED*/, T: 9 /*ScalarType.STRING*/ },
+            { no: 9, name: "forOfflineSaleOnly", kind: "scalar", T: 8 /*ScalarType.BOOL*/ }
         ]);
     }
     create(value) {
@@ -25,6 +26,7 @@ class Product$Type extends MessageType {
         message.productType = 0;
         message.taxes = [];
         message.features = [];
+        message.forOfflineSaleOnly = false;
         if (value !== undefined)
             reflectionMergePartial(this, message, value);
         return message;
@@ -58,6 +60,9 @@ class Product$Type extends MessageType {
                 case /* repeated string features */ 8:
                     message.features.push(reader.string());
                     break;
+                case /* bool forOfflineSaleOnly */ 9:
+                    message.forOfflineSaleOnly = reader.bool();
+                    break;
                 default:
                     let u = options.readUnknownField;
                     if (u === "throw")
@@ -94,6 +99,9 @@ class Product$Type extends MessageType {
         /* repeated string features = 8; */
         for (let i = 0; i < message.features.length; i++)
             writer.tag(8, WireType.LengthDelimited).string(message.features[i]);
+        /* bool forOfflineSaleOnly = 9; */
+        if (message.forOfflineSaleOnly !== false)
+            writer.tag(9, WireType.Varint).bool(message.forOfflineSaleOnly);
         let u = options.writeUnknownFields;
         if (u !== false)
             (u == true ? UnknownFieldHandler.onWrite : u)(this.typeName, message, writer);

package/dist/generated/ProfileSyncOutRequest.d.ts

@@ -32,7 +32,23 @@ export interface ProfileSyncOutRequest {
      */
     businessLinkUpdateNumber: bigint;
     /**
-     * The business to join as a customer, if the caller is not already linked to it. 0 means none.
+     * The business to join as a customer, if the caller is not already linked to it. 0 means none, and
+     * anything else has to be the id of a business: one that is not is refused, not ignored.
+     * A call that carries a valid link token of this business is from a member of it already, and nothing is
+     * joined: the response is what the cursors above return, as for a call that joins nothing, and it is not
+     * refused for the business no longer allowing customers to join it. A link token that is not valid is
+     * refused (401), and one of another business says nothing of this one.
+     * Otherwise the response always carries the BusinessLink and the Business that a join returns, even
+     * where the cursors above would not return them.
+     * An invitation to this business for the caller (looked for by their phone number) takes precedence: it is
+     * accepted in the role and party that the invitation names, which may be those of a manager or an owner as
+     * well as of a customer, whether or not the business allows customers to join without an invitation, and
+     * the invitation is deleted. Only when there is none does the business decide.
+     * The call fails with 404 (NotFoundException) if there is no such business, or if the caller has no
+     * invitation to it and it does not allow customers to join it, and the caller does not hold a valid link
+     * token of it. It is the link token that is tested, and not membership: a member that does not hold one (on
+     * a new device, say) of a business that has since stopped allowing customers to join is refused in the same
+     * way, and then the whole call is a 404 - nothing of the profile is returned either, and not only no join.
      *
      * @generated from protobuf field: int64 joinBusinessId = 4
      */

package/dist/generated/ProfileSyncOutResponse.d.ts

@@ -11,8 +11,9 @@ import { AuthTokens } from "./AuthTokens";
 /**
  * The answer to a ProfileSyncOutRequest: who the caller is, the businesses they are linked to, and
  * those businesses. Nothing is nested - match BusinessLink.businessId against Business.entity.id.
- * Every field is absent/empty unless that type has changed; a tombstone (updateNumber's update-type
- * bits = Constants.UPDATE_TYPE_DELETED) means the entity, and what it owned, was deleted.
+ * Every field is absent/empty unless that type has changed, but for the caller's own user, which is
+ * sent with every response; a tombstone (updateNumber's update-type bits =
+ * Constants.UPDATE_TYPE_DELETED) means the entity, and what it owned, was deleted.
  *
  * @generated from protobuf message com.merabills.storefront.ProfileSyncOutResponse
  */
@@ -25,13 +26,17 @@ export interface ProfileSyncOutResponse {
      */
     authTokens?: AuthTokens;
     /**
-     * The caller. Absent unless their own profile has changed.
+     * The caller. Sent with every response, whatever userUpdateNumber is: a client keeps the copy it holds
+     * when it is as new as this one. The only user a response ever carries: nobody else's, such as the
+     * owner of a business, is sent to a customer.
      *
      * @generated from protobuf field: com.merabills.storefront.User user = 2
      */
     user?: User;
     /**
      * The businesses the caller is linked to, and the token for each. Empty unless a link has changed.
+     * Only the caller's own links: never that of anybody else, such as the owner of a business, which is a
+     * credential for it.
      *
      * @generated from protobuf field: repeated com.merabills.storefront.BusinessLink businessLinks = 3
      */

package/dist/generated/SalesOrderPayload.d.ts

@@ -10,7 +10,10 @@ import { FulfillmentMode } from "./FulfillmentMode";
 import { OrderStatus } from "./OrderStatus";
 /**
  * The payload of a SALES_ORDER message: an order placed by a customer.
- * Excluded: serviceStationNumber, dueDate.
+ * Excluded: serviceStationNumber, dueDate, createdByParty. The last is set by the merchant app for an
+ * order that its party placed itself and not an operator of the business on its behalf. Nothing reads
+ * it and a storefront has no use for it, so it is not carried, and the server leaves it unset on an
+ * order that a storefront pushes.
  *
  * @generated from protobuf message com.merabills.storefront.SalesOrderPayload
  */
@@ -66,7 +69,9 @@ export interface SalesOrderPayload {
      */
     note?: string;
     /**
-     * Payment received towards this order so far. Can only be set by an operator of the business.
+     * Payment received towards this order so far. Can only be set by an operator of the business. That is not
+     * enforced yet: sync in is not implemented (its route answers 501), and ProtoMap.fromProto accepts this
+     * from whoever pushes the order, so sync in must refuse or drop it from a customer when it is written.
      *
      * @generated from protobuf field: optional int64 paymentReceived = 10
      */

package/dist/generated/ShoppingList.d.ts

@@ -35,14 +35,17 @@ export interface ShoppingList {
      */
     autoAddServiceCharge: boolean;
     /**
-     * Id of the inventory location the items are drawn from. 0 is the default location.
+     * Id of the inventory location the items are drawn from. 0 is the default location. It is a number of 16 bits, from
+     * -32768 to 32767: a message with one that is outside of that is refused (400), and not read as some other location.
      *
      * @generated from protobuf field: int32 inventoryLocationId = 4
      */
     inventoryLocationId: number;
     /**
-     * Id of the PriceList the prices came from. A cart with none yet uses the id built from
-     * Constants.DEFAULT_SALE_PRICE_LIST.
+     * Id of the PriceList the prices came from. A storefront sells from the MeraBills Online price
+     * list (the id built from Constants.MERABILLS_ONLINE_PRICE_LIST), so, that is what a cart that it
+     * pushes carries, an empty one included. Java does not default this for a cart: one that was given
+     * no price list holds Constants.ENTITY_ID_NULL, and the server keeps the id that it is sent.
      *
      * @generated from protobuf field: int64 priceListId = 5
      */