@koda-sl/baker-cli 0.369.0-dev.ba2803c37 → 0.370.0-dev.0cc0d2b86

package/README.md

@@ -3699,8 +3699,9 @@ baker shopify stock --limit 20                     # every product with every op
 ```
 
 **`meta.store`** is on every answer: `connection` (`connected` · `needs_reconnect` · `disconnected`), `catalog` (`starting` · `importing` · `ready` · `failed`, with `importProgress` while importing), `unreadable` (products Baker couldn't read; `unreadableCapped` past 100), `checksFailing` (Baker couldn't check the store for changes lately), `storefront` (`online_store`, or `own` for a store that sells through its own site) and `lastActivity` (when Baker last heard from the store — not a promise the copy is current). `hints[]` turn each of these into what to tell the user.
+**`store`:** `--full` adds the admin link and every country. `capped: true` means a count stopped at its ceiling — `outOfStock` and `partlyOut` at 100, `collections` at 500 — so that count reads "that many or more"; a hint says which.
 **`products`:** `--search <words>`, `--collection <handle|id>`, `--stock`, `--limit <1-100>`, `--cursor`; `--full` adds vendor, type, option count, photo link, visibility and status. Every price, here and in `product` (`price`, `compareAt`, each option's price, `pricesByCountry`), is one string with its currency beside each amount: `"USD 785.95"`, `"USD 9.95 – USD 49.95"`. A row's `availability` is absent when the product is on the store, `link_only` when it is buyable only through its link, `not_for_sale` (with `status`) when it can't be bought on the online store.
-**`product`:** positional `<ref>` — the numeric id, the handle, a store product link (`…/products/<handle>`, even an all-digit handle), a Baker Products link, or `gid://shopify/Product/<n>`. Returns options (50 per page, `--variants-cursor` for more; 250 with `--full`), `outOptions` (up to 50, `outOptionsMore` for the rest), `pricesByCountry` when the store sells at more than one price, `photos[]` (`imageId` + a Baker-hosted `url`, never a Shopify link), `url` (the product's page in Baker) and `storeUrl`. `--full` adds the whole description, SEO, category, the admin link and each option's SKU, barcode, feed id and prices by country. `NOT_FOUND` carries a hint to search instead.
+**`product`:** positional `<ref>` — the numeric id, the handle, a store product link (`…/products/<handle>`, even an all-digit handle), a Baker Products link, a Shopify admin product link (`admin.shopify.com/store/<shop>/products/<n>`), or `gid://shopify/Product/<n>`. Returns options (50 per page, `--variants-cursor` for more; 250 with `--full`), `outOptions` (up to 50, `outOptionsMore` for the rest), `pricesByCountry` when the store sells at more than one price, `photos[]` (`imageId` + a Baker-hosted `url`, never a Shopify link), `url` (the product's page in Baker) and `storeUrl`. `--full` adds the whole description, SEO, category, the admin link and each option's SKU, barcode, feed id and prices by country. `NOT_FOUND` carries a hint to search instead.
 **`collections`:** `--search <words>`; each row has `handle`, Shopify's product count and, on a store with an online store, `onStore`.
 **`stock`:** `--collection`, `--limit <1-200>` (default 50 per list), `--full` (SKUs and Baker links). Options that keep selling at zero or don't track stock are not out of stock.
 

package/dist/cli.js

@@ -64579,6 +64579,8 @@ var shopifyStockRequestSchema = z50.object({
 var AMOUNT = String.raw`[A-Z]{3} \d+(?:\.\d+)?`;
 var shopifyPriceSchema = z50.string().regex(new RegExp(`^${AMOUNT}$`), "a price is '<CURRENCY> <amount>'");
 var shopifyPriceRangeSchema = z50.string().regex(new RegExp(`^${AMOUNT}(?: \u2013 ${AMOUNT})?$`), "a price range is '<CURRENCY> <min> \u2013 <CURRENCY> <max>'");
+var SHOPIFY_STOCK_COUNT_CAP = 100;
+var SHOPIFY_COLLECTION_COUNT_CAP = 500;
 var shopifyStoreSummarySchema = z50.object({
   name: z50.string(),
   domain: z50.string(),
@@ -64589,7 +64591,7 @@ var shopifyStoreSummarySchema = z50.object({
   collections: z50.number(),
   outOfStock: z50.number(),
   partlyOut: z50.number(),
-  /** A count stopped at its cap: 100 for stock counts, 500 for collections. */
+  /** A count stopped at its cap: `SHOPIFY_STOCK_COUNT_CAP` for stock counts, `SHOPIFY_COLLECTION_COUNT_CAP` for collections. */
   capped: z50.literal(true).optional(),
   pricePoints: z50.array(
     z50.object({
@@ -64799,7 +64801,8 @@ function productsHints(answer, options) {
   if (answer.nextCursor)
     hints2.push(`More products: rerun with \`--cursor ${answer.nextCursor}\` and the same filters.`);
   if (answer.products.length === 0 && !answer.nextCursor) {
-    if (options.filtered) hints2.push("No products match; drop `--search`/`--stock`/`--collection`.");
+    if (options.paged) hints2.push("No more products: the earlier pages were the whole list.");
+    else if (options.filtered) hints2.push("No products match; drop `--search`/`--stock`/`--collection`.");
     else if (cleanAndReady(answer.store)) hints2.push("The store has no products yet.");
     else {
       hints2.push(
@@ -64873,15 +64876,17 @@ function productHints(product, store) {
 function stockHints(answer, limit) {
   const hints2 = [];
   const any = answer.outOfStock.length > 0 || answer.partlyOut.length > 0;
-  if (!any) hints2.push("Nothing is out of stock.");
-  else {
+  const unfinished = answer.more.outOfStock || answer.more.partlyOut;
+  const pageThrough = "page through with `baker shopify products --stock out_of_stock` / `--stock partly_out` (and the same `--collection`)";
+  if (any) {
     hints2.push(
       "Before promoting these, check which ads and pages point at them; pausing or swapping them is a staged change."
     );
-  }
-  if (answer.more.outOfStock || answer.more.partlyOut) {
+  } else if (!unfinished) hints2.push("Nothing is out of stock.");
+  if (unfinished) {
+    const full = answer.more.outOfStock && answer.outOfStock.length >= limit || answer.more.partlyOut && answer.partlyOut.length >= limit;
     hints2.push(
-      `More than ${limit} products in a list; raise \`--limit\` (up to 200) or page through with \`baker shopify products --stock out_of_stock\` / \`--stock partly_out\`.`
+      full ? `More than ${limit} products in a list; raise \`--limit\` (up to 200) or ${pageThrough}.` : `Baker didn't check every product in one go, so these lists may be missing some \u2014 don't say nothing else is out of stock; ${pageThrough}.`
     );
   }
   const big = answer.partlyOut.find((row) => row.outOptionsMore);
@@ -64892,8 +64897,19 @@ function stockHints(answer, limit) {
   }
   return hints2;
 }
-function storeHints() {
-  return ["Share the Products page link (productsUrl) when the user wants to browse the catalog."];
+function storeHints(summary) {
+  const hints2 = ["Share the Products page link (productsUrl) when the user wants to browse the catalog."];
+  if (summary.capped) {
+    const atCeiling = [
+      summary.outOfStock >= SHOPIFY_STOCK_COUNT_CAP ? `${SHOPIFY_STOCK_COUNT_CAP} or more products out of stock` : null,
+      summary.partlyOut >= SHOPIFY_STOCK_COUNT_CAP ? `${SHOPIFY_STOCK_COUNT_CAP} or more products partly out` : null,
+      summary.collections >= SHOPIFY_COLLECTION_COUNT_CAP ? `${SHOPIFY_COLLECTION_COUNT_CAP} or more collections` : null
+    ].filter((count2) => count2 !== null);
+    hints2.push(
+      `Some counts stopped at Baker's ceiling: say ${atCeiling.join(", ")} \u2014 never the number as exact. \`baker shopify stock\` and \`baker shopify products --stock out_of_stock\` page through them.`
+    );
+  }
+  return hints2;
 }
 
 // src/commands/shopify/refusal.ts
@@ -64956,7 +64972,7 @@ var fullArg = {
 };
 registerSchema({
   command: "shopify.store",
-  description: "Start here for the connected Shopify store: its name, currency, home country, how many products and collections it has, how many products are out of stock or partly out, the prices by country it sells at (only when it has more than one), and the link to the Products page in Baker. `meta.store` says whether Baker's copy is complete and whether Baker can still reach the store.",
+  description: 'Start here for the connected Shopify store: its name, currency, home country, how many products and collections it has, how many products are out of stock or partly out, the prices by country it sells at (only when it has more than one), and the link to the Products page in Baker. `capped: true` means a count stopped at its ceiling (100 out of stock or partly out, 500 collections): say "100 or more", never the number as exact. `meta.store` says whether Baker\'s copy is complete and whether Baker can still reach the store.',
   args: { full: { ...fullArg, description: "Add the store's products page in Shopify admin and every country" } }
 });
 registerSchema({
@@ -64986,7 +65002,7 @@ registerSchema({
 });
 registerSchema({
   command: "shopify.product",
-  description: "One product of the connected store \u2014 accepts its id, its handle, a link to it on the store or in Baker. Returns its options with price and stock, prices by country, the options out of stock, its collections, and its photos' library imageIds to place on a landing (`baker images download <imageIds> --out src/pages/<page>/_images/`) or pass to a creative. `--out-of-stock` lists only the options out of stock.",
+  description: "One product of the connected store \u2014 accepts its id, its handle, a link to it on the store, in Baker or in Shopify admin. Returns its options with price and stock, prices by country, the options out of stock, its collections, and its photos' library imageIds to place on a landing (`baker images download <imageIds> --out src/pages/<page>/_images/`) or pass to a creative. `--out-of-stock` lists only the options out of stock.",
   args: {
     ref: { type: "positional", description: "Product id, handle, or a link to the product", required: true },
     "variants-cursor": {
@@ -65031,7 +65047,7 @@ var storeCommand = defineCommand209({
   run: async ({ args: args5 }) => {
     try {
       const answer = await apiGet("/api/shopify/store", params({ full: args5.full }));
-      emit2(answer.summary, { store: answer.store }, [...storeStateHints(answer.store), ...storeHints()]);
+      emit2(answer.summary, { store: answer.store }, [...storeStateHints(answer.store), ...storeHints(answer.summary)]);
     } catch (err) {
       fail9(err);
     }
@@ -65076,7 +65092,7 @@ var productsCommand = defineCommand209({
           count: answer.products.length,
           ...answer.nextCursor ? { next_cursor: answer.nextCursor } : {}
         },
-        [...storeStateHints(answer.store), ...productsHints(answer, { filtered })]
+        [...storeStateHints(answer.store), ...productsHints(answer, { filtered, paged: Boolean(args5.cursor) })]
       );
     } catch (err) {
       fail9(err);