@koda-sl/baker-cli 0.371.0-dev.8cef1f9ea → 0.371.0-dev.aada6916f

package/dist/cli.js

@@ -5897,7 +5897,11 @@ var REJECTION_CODES = [
   "missing_identity",
   "invalid_timestamp",
   "invalid_value",
-  "batch_too_large"
+  "batch_too_large",
+  // Appended, never inserted: the set a client branches on grows, and no code
+  // it already handles changes meaning.
+  "invalid_items",
+  "invalid_consent"
 ];
 var EVENT_INGEST_BATCH_MAX = 500;
 var EVENT_INGEST_BODY_MAX_BYTES = 8 * 1024 * 1024;
@@ -5910,12 +5914,15 @@ function validateEventName(name) {
   if (value === "" || value.length > MAX_EVENT_NAME || !EVENT_NAME.test(value)) return "invalid_name";
   return null;
 }
+var MAX_ITEM_QUANTITY = 1e6;
 var REJECTION_MESSAGES = {
   invalid_event_id: "event_id, when sent, must be 1-128 characters of A-Z a-z 0-9 . _ : -",
   invalid_name: "event_name is required: up to 80 characters of letters (any language), digits, spaces, . _ and -, starting with a letter or a digit",
   missing_identity: "user_data named nobody, and no url named a page",
   invalid_timestamp: "event_time must be an ISO-8601 instant with an offset or Unix seconds, and not in the future",
   invalid_value: "value and currency go together: a non-negative decimal and an ISO-4217 code",
+  invalid_items: "each item names a product_id, variant_id or feed_id; quantity is a whole number from 1 to 1000000; price is a non-negative decimal sent with a currency",
+  invalid_consent: "consent.analytics and consent.marketing, when sent, are granted or denied",
   batch_too_large: `a request carries at most ${EVENT_INGEST_BATCH_MAX} events and ${EVENT_INGEST_BODY_MAX_BYTES / (1024 * 1024)} MB`
 };
 
@@ -7294,7 +7301,8 @@ var TRIGGER_KINDS = {
       "utm_source",
       "utm_medium",
       "utm_campaign",
-      "properties.<name>"
+      "properties.<name>",
+      "items"
     ],
     keywords: ["purchase", "signup", "conversion", "analytics", "tracking", "hubspot", "crm", "deal", "funnel", "lead"]
   },
@@ -14906,8 +14914,22 @@ var ANALYTICS_EVENT_TYPES = [
    * page, `ingest` for a third party's server — and every report that needs to
    * tell them apart filters on that.
    */
-  "custom"
+  "custom",
+  /**
+   * A fact about the business that names no person — a product changed, a
+   * variant went out of stock.
+   *
+   * Only a commerce door writes it (`ingestShopifyFacts`), and it is a type of
+   * its own rather than a `custom` event with no identity for one reason:
+   * every report that lists named events whitelists `custom`, so an
+   * operational fact would otherwise appear in the conversion picker, the
+   * funnel and the sends. Here it reaches the raw feed and the agents that
+   * listen for its name, and no person-level report. The row builder blanks
+   * every identity column on it, whatever it carried.
+   */
+  "operational"
 ];
+var EVENT_ITEMS_MAX = 250;
 var ANALYTICS_DEVICE_TYPES = ["desktop", "mobile", "tablet", "bot", "unknown"];
 var ANALYTICS_BEACON_BATCH_MAX = 50;
 
@@ -30920,6 +30942,48 @@ var EVENT_FIELDS = [
     name: "properties",
     need: "optional",
     takes: "A flat object of strings \u2014 anything you want to break the event down by later."
+  },
+  {
+    name: "items",
+    need: "optional",
+    takes: "What was bought, one entry per product line \u2014 for a purchase, a cart or a refund.",
+    note: `Each line names its product by at least one of the ids below. value still carries the whole event's money. An order with more than ${EVENT_ITEMS_MAX} lines keeps the first ${EVENT_ITEMS_MAX}.`
+  },
+  {
+    name: "product_id, variant_id, feed_id",
+    need: "conditional",
+    under: true,
+    takes: "Your store's product id, its variant id, or the id the product has in your ads catalog. At least one per line, up to 255 characters each."
+  },
+  {
+    name: "quantity",
+    need: "optional",
+    under: true,
+    takes: `How many: a whole number from 1 to ${MAX_ITEM_QUANTITY.toLocaleString("en-US")}.`
+  },
+  {
+    name: "price",
+    need: "optional",
+    under: true,
+    takes: "The price of one unit, in the event's currency \u2014 so it needs currency. A decimal like value."
+  },
+  {
+    name: "consent",
+    need: "optional",
+    takes: "What the person allowed, if your site asked them.",
+    note: "Send it whenever you know it. A person who said no to marketing is still counted in your reports, and is never matched or sent to an ad platform."
+  },
+  {
+    name: "analytics",
+    need: "optional",
+    under: true,
+    takes: "granted or denied \u2014 whether they allowed being measured. Denied keeps the event and forgets who it was."
+  },
+  {
+    name: "marketing",
+    need: "optional",
+    under: true,
+    takes: "granted or denied \u2014 whether they allowed their visit to be used for advertising."
   }
 ];
 var RESPONSE_FIELDS = [
@@ -31249,7 +31313,37 @@ var ingestEventSchema = z39.strictObject({
    * left alone: masking one would rename the field and could collide with a
    * sibling.
    */
-  properties: z39.record(z39.string(), z39.string()).nullish()
+  properties: z39.record(z39.string(), z39.string()).nullish(),
+  /**
+   * What was bought, one entry per line — for a purchase, a cart, a refund.
+   *
+   * Flat and Meta-like for the same reason as the rest of this body: it is
+   * Meta's `contents` (`id`, `quantity`, `item_price`) and GA4's `items`
+   * (`item_id`, `quantity`, `price`) under one spelling a sender can map from
+   * either. A line names what it is by any of three ids — the store's product,
+   * its variant, or the id the product has in an ads catalog. `price` is the
+   * *unit* price in the event's `currency`; `value` stays the whole event's
+   * money. Structure only here; `validateItems` judges each line.
+   */
+  items: z39.array(
+    z39.strictObject({
+      product_id: z39.string().nullish(),
+      variant_id: z39.string().nullish(),
+      feed_id: z39.string().nullish(),
+      quantity: z39.union([z39.string(), z39.number()]).nullish(),
+      price: z39.union([z39.string(), z39.number()]).nullish()
+    })
+  ).nullish(),
+  /**
+   * What the person allowed, each `granted` or `denied`: `analytics` (being
+   * measured at all) and `marketing` (being matched and sent to an ad
+   * platform). Absent means the sender did not say. Enforced before anything
+   * is stored — see `./consent`. `validateConsent` judges the values.
+   */
+  consent: z39.strictObject({
+    analytics: z39.string().nullish(),
+    marketing: z39.string().nullish()
+  }).nullish()
 });
 var ingestBatchSchema = z39.strictObject({
   events: z39.array(ingestEventSchema).min(1).max(EVENT_INGEST_BATCH_MAX)
@@ -64584,6 +64678,8 @@ var shopifyProductRequestSchema = z50.object({
   content: flag.optional(),
   /** One custom field whole, by its name or `namespace.key`. */
   field: z50.string().min(1).max(200).optional(),
+  /** With `field`: the option (its `variantId`) whose field to return, when options share one. */
+  variant: z50.string().regex(/^\d{1,30}$/, "an option's variantId").optional(),
   /** How many of the option each buy link puts in the cart (1-99, default 1). */
   quantity: z50.coerce.number().int().min(1).max(SHOPIFY_MAX_BUY_QUANTITY).optional()
 });
@@ -64727,6 +64823,8 @@ var shopifyFieldRefSchema = z50.object({
   url: z50.string().optional(),
   mimeType: z50.string().optional(),
   alt: z50.string().optional(),
+  /** A video's preview image; its `url` is the video file itself. */
+  previewUrl: z50.string().optional(),
   /** A product's or a collection's title, from Baker's copy. */
   title: z50.string().optional(),
   /** An image brought into the library: its imageId, to place like the product's photos. */
@@ -65053,7 +65151,8 @@ function contentHints(product) {
   }
   const truncated = product.content?.fields.find((field) => field.truncated);
   if (truncated) {
-    hints2.push(`Some fields are shown in part: read one whole with \`--field ${truncated.key}\`.`);
+    const option = truncated.variantId ? ` --variant ${truncated.variantId}` : "";
+    hints2.push(`Some fields are shown in part: read one whole with \`--field ${truncated.key}${option}\`.`);
   }
   if (product.content?.unreadable?.length || product.content?.fields.some((field) => field.unreadable)) {
     hints2.push(
@@ -65256,6 +65355,11 @@ registerSchema({
       description: 'One custom field whole, by its name or its key (e.g. "Size chart" or custom.size_chart)',
       required: false
     },
+    variant: {
+      type: "string",
+      description: "With --field: the option whose field to return, by its variantId (options share their fields, e.g. --field custom.fit --variant 102)",
+      required: false
+    },
     quantity: {
       type: "number",
       description: "How many of the option each buy link puts in the cart, 1-99 (default 1)",
@@ -65367,6 +65471,11 @@ var productCommand = defineCommand209({
       default: false
     },
     field: { type: "string", description: "One custom field whole, by its name or key", required: false },
+    variant: {
+      type: "string",
+      description: "With --field: the option whose field it is, by its variantId",
+      required: false
+    },
     quantity: {
       type: "string",
       description: "How many each buy link puts in the cart, 1-99 (default 1)",
@@ -65391,6 +65500,7 @@ var productCommand = defineCommand209({
           outOfStock: args5["out-of-stock"],
           content: args5.content,
           field: args5.field,
+          variant: args5.variant,
           quantity: args5.quantity,
           full: args5.full
         })
@@ -65466,6 +65576,7 @@ Examples:
   baker shopify product the-complete-snowboard       # one product: options with buyUrl, prices, photos, videos
   baker shopify product <handle> --content           # its whole details: description, custom fields, subscriptions
   baker shopify product <handle> --field "Size chart" # one custom field, whole
+  baker shopify product <handle> --field custom.fit --variant <variantId> # one option's field, whole
   baker shopify product <handle> --quantity 2        # buy links that put 2 in the cart
   baker shopify product <id> --out-of-stock          # only its options that are out of stock
   baker shopify stock                                # every product with options out of stock