@wix/himalaya-cli 0.1035.0 → 0.1037.0

package/fixtures/wix-canned.json

@@ -1057,20 +1057,69 @@
         "title": "Roastery Rebuild",
         "description": "A 12-week fit-out, start to finish.",
         "slug": "roastery-rebuild",
-        "coverImage": "https://static.wixstatic.com/media/example-rebuild.jpg"
+        "coverImage": {
+          "type": "WIX_MEDIA",
+          "imageInfo": {
+            "id": "example-rebuild.jpg",
+            "url": "https://static.wixstatic.com/media/example-rebuild.jpg",
+            "width": 2752,
+            "height": 1536
+          },
+          "secure": false
+        }
       },
       {
         "id": "proj-0002",
         "title": "Harvest Field Notes",
         "description": "Photography from the 2026 trip.",
         "slug": "harvest-field-notes",
-        "coverImage": "https://static.wixstatic.com/media/example-fieldnotes.jpg"
+        "coverImage": {
+          "type": "WIX_MEDIA",
+          "imageInfo": {
+            "id": "example-fieldnotes.jpg",
+            "url": "https://static.wixstatic.com/media/example-fieldnotes.jpg",
+            "width": 1024,
+            "height": 1024
+          },
+          "secure": false
+        }
       }
     ],
     "pagingMetadata": {
       "count": 2
     }
   },
+  "POST /portfolio/v1/items/query": {
+    "items": [
+      {
+        "id": "item-0001",
+        "projectId": "proj-0001",
+        "sortOrder": 1,
+        "type": "IMAGE",
+        "title": "The finished bar",
+        "image": {
+          "type": "WIX_MEDIA",
+          "imageInfo": {
+            "id": "example-rebuild-bar.jpg",
+            "url": "https://static.wixstatic.com/media/example-rebuild-bar.jpg",
+            "width": 1600,
+            "height": 1067
+          }
+        }
+      },
+      {
+        "id": "item-0002",
+        "projectId": "proj-0001",
+        "sortOrder": 2,
+        "type": "TEXT",
+        "title": "Twelve weeks",
+        "description": "Stripped to the brick, rebuilt around the roaster."
+      }
+    ],
+    "metadata": {
+      "count": 2
+    }
+  },
   "POST /badges/v4/badges/query": {
     "badges": [
       {

package/guides/sdk-reference.json

@@ -14603,7 +14603,7 @@
         "name": "EventRow",
         "kind": "interface",
         "jsdoc": "",
-        "decl": "export interface EventRow {\n  id: string;\n  title: string;\n  day: string;\n  month: string;\n  dateLine: string;\n  location: string;\n  status: string;\n  image: string;\n  hasImage: boolean;\n  noImage: boolean;\n  detailScreenId: string;\n}"
+        "decl": "export interface EventRow {\n  id: string;\n  title: string;\n  day: string;\n  month: string;\n  dateLine: string;\n  /** \"Past\" once the event has finished, else \"\". */\n  statusLabel: string;\n  location: string;\n  status: string;\n  image: string;\n  hasImage: boolean;\n  noImage: boolean;\n  detailScreenId: string;\n}"
       },
       {
         "name": "titleCase",
@@ -14662,15 +14662,27 @@
       {
         "name": "eventWhen",
         "kind": "function",
-        "jsdoc": "",
-        "decl": "export function eventWhen(e: WixEvent): string;"
+        "jsdoc": "/** The event's date line. The year is written only when it is not the current year, so a\n *  past-year event can no longer pass for an upcoming one (\"Sat, Jul 18\"). `now` is injectable\n *  for tests; it defaults to the wall clock. */",
+        "decl": "export function eventWhen(e: WixEvent, now: number = Date.now()): string;"
+      },
+      {
+        "name": "eventIsPast",
+        "kind": "function",
+        "jsdoc": "/** Has the event finished? Its end when it has one, else its start. */",
+        "decl": "export function eventIsPast(e: WixEvent, now: number = Date.now()): boolean;"
       },
       {
         "name": "normalizeEvent",
         "kind": "function",
-        "jsdoc": "",
+        "jsdoc": "/** One-argument on purpose: callers write `.map(normalizeEvent)`, which would pass the array\n *  index as a second argument. Use {@link normalizeEventAt} to pin the clock. */",
         "decl": "export function normalizeEvent(e: WixEvent): EventRow;"
       },
+      {
+        "name": "normalizeEventAt",
+        "kind": "function",
+        "jsdoc": "/** {@link normalizeEvent} against an explicit clock (epoch ms): `now` decides whether the date\n *  line carries the year and whether `statusLabel` reads \"Past\". Pure — no API call, any scope. */",
+        "decl": "export function normalizeEventAt(e: WixEvent, now: number): EventRow;"
+      },
       {
         "name": "eventDescription",
         "kind": "function",
@@ -19552,11 +19564,23 @@
     "source": "stdlib/wix-sdk/portfolio/src/index.ts",
     "description": "Portfolio — projects and collections",
     "api": [
+      {
+        "name": "WixMediaImage",
+        "kind": "interface",
+        "jsdoc": "/** A Wix Portfolio media image — a project / collection cover or a project item's image. */",
+        "decl": "export interface WixMediaImage {\n  type?: string;\n  imageInfo?: { id?: string; url?: string; width?: number; height?: number };\n}"
+      },
+      {
+        "name": "portfolioCoverRef",
+        "kind": "function",
+        "jsdoc": "/**\n * The Wix media reference of a Portfolio cover or item image — its `imageInfo.url`, else\n * its `imageInfo.id` — for `wixMediaUrl` to resolve and size. `\"\"` when there is none.\n * A bare string is still accepted, so a cover stored as a url string keeps rendering.\n *\n * @example\n * const image = wixMediaUrl(portfolioCoverRef(project.coverImage));\n */",
+        "decl": "export function portfolioCoverRef(cover: WixMediaImage | string | null | undefined): string;"
+      },
       {
         "name": "WixPortfolioProject",
         "kind": "interface",
         "jsdoc": "",
-        "decl": "export interface WixPortfolioProject {\n  id: string;\n  title?: string;\n  description?: string;\n  /** Project cover. coverImage is a Wix media url/id. */\n  coverImage?: string;\n  slug?: string;\n  hidden?: boolean;\n  createdDate?: string;\n  updatedDate?: string;\n}"
+        "decl": "export interface WixPortfolioProject {\n  id: string;\n  title?: string;\n  description?: string;\n  /**\n   * Project cover. The live wire shape is a media OBJECT\n   * (`{type:\"WIX_MEDIA\", imageInfo:{id,url,width,height}}`), not a url string —\n   * read it with {@link portfolioCoverRef}; `wixMediaUrl` returns `\"\"` for the object.\n   * A url string is still accepted, for projects constructed by hand.\n   */\n  coverImage?: WixMediaImage | string;\n  slug?: string;\n  hidden?: boolean;\n  createdDate?: string;\n  updatedDate?: string;\n}"
       },
       {
         "name": "WixListProjectsResponse",
@@ -19571,12 +19595,6 @@
         "decl": "export function listProjects(limit = 100, cursor?: string): Promise<WixListProjectsResponse>;",
         "http": "GET /portfolio/v1/projects?{…}"
       },
-      {
-        "name": "WixMediaImage",
-        "kind": "interface",
-        "jsdoc": "",
-        "decl": "export interface WixMediaImage { imageInfo?: { id?: string; url?: string } }"
-      },
       {
         "name": "WixPortfolioCollection",
         "kind": "interface",
@@ -19606,14 +19624,14 @@
         "name": "WixListProjectItemsResponse",
         "kind": "interface",
         "jsdoc": "",
-        "decl": "export interface WixListProjectItemsResponse {\n  items?: WixPortfolioProjectItem[];\n  pagingMetadata?: { count?: number; cursors?: { next?: string }; hasNext?: boolean };\n}"
+        "decl": "export interface WixListProjectItemsResponse {\n  items?: WixPortfolioProjectItem[];\n  /**\n   * Paging, under the name this function always documented. A Wix query reports it as\n   * `metadata`; {@link listProjectItems} copies that here when `pagingMetadata` is absent.\n   */\n  pagingMetadata?: { count?: number; cursors?: { next?: string }; hasNext?: boolean };\n  /** The query endpoint's own name for the paging block. */\n  metadata?: { count?: number; cursors?: { next?: string }; hasNext?: boolean };\n}"
       },
       {
         "name": "listProjectItems",
         "kind": "function",
-        "jsdoc": "/** GET /portfolio/v1/projects/{projectId}/items — list a project's items. */",
+        "jsdoc": "/**\n * POST /portfolio/v1/items/query — list a project's items.\n *\n * A first page filters on `projectId` with `paging.limit`. Passing a `cursor` (a previous\n * page's `pagingMetadata.cursors.next`) switches to `cursorPaging` and drops the filter,\n * because a Wix query cursor already carries it. Items come back in the order Wix returns\n * them — sort on `sortOrder` for the author's order.\n */",
         "decl": "export function listProjectItems(projectId: string, limit = 100, cursor?: string): Promise<WixListProjectItemsResponse>;",
-        "http": "GET /portfolio/v1/projects/{…}/items?{…}"
+        "http": "POST /portfolio/v1/items/query"
       }
     ]
   },

package/guides/wix-business-context.md

@@ -122,9 +122,21 @@ never change. If nothing is reachable, keep the default kit.
 RFC 0048 refused a **content dump** on the runtime facade. The dump lives here, at **build time**:
 
 ```bash
-himi site analyze --client-id <id> --site <msid> --url https://… --out .himi/business-book [--apply]
+himi site analyze --url https://… --out .himi/business-book                                  # visitor-only pass
+himi site analyze --url https://… --client-id <id> [--site <msid>] --out .himi/business-book [--apply]
 ```
 
+`--url` alone is the **visitor-only pass**: the published pages, their look (screenshots,
+`--wst-*`), the Copy chapter and the Placeholders chapter (template phone/email, Wix editor text, a
+second business name, repeated images). It needs no OAuth client, so no anonymous token is minted
+and every vertical probe reports `visitor skipped` — the Catalog has no counts. `--client-id` (the
+site's Headless client) adds those counts, each Bookings service's price and payment mode
+(`pay online only`, `pay in person only`, `free`, …), and the `wix` binding `--apply` writes;
+`--apply` without it exits 2. `--site` adds the owner-only chapters (CMS, media, roles); an
+ambient `WIX_SITE_ID` does so only beside an explicit `--client-id` flag (an exported
+`WIX_CLIENT_ID` does not count), so a URL-only pass is never silently upgraded to an owner read
+of whichever site that variable names.
+
 Same collector, three doors:
 
 | Door | Artifact |

package/guides/wix-site-to-himi-app.md

@@ -59,14 +59,23 @@ banner. Keep **only the first ASCII line** (`head -1`) or HTTP headers throw
 ### 1. Analyze — do not re-fetch Wix
 
 ```sh
+# Visitor-only pass — the URL is all it needs (published pages, look, copy, template leftovers):
+himi site analyze --url https://customer.wixsite.com/site --out .himi/business-book
+
+# Full pass — --client-id adds catalog counts, service payment modes and the --apply binding;
+# --site adds the owner chapters (CMS, media, roles):
 himi site analyze \
-  --client-id <headless-oauth-client-id> \
   --url https://customer.wixsite.com/site \
+  --client-id <headless-oauth-client-id> \
   --site <msid> \
   --out .himi/business-book
 # screenshots + --wst-*: npx playwright install chromium
 ```
 
+Check `book.md` → **Placeholders** before reusing any copy: a template phone (`123-456-7890`),
+Wix editor text, a second business name or one photo repeated across a gallery is the
+template's, not the customer's.
+
 Read `book.json`, `book.md`, `evidence/pages/`, `media/`, `velo/` (via
 `book.velo.files[].localPath`). Write `.himi/business-book/look.notes.md` for mood,
 overlay tie-break, language. **Never rewrite `book.json`.** Never log

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wix/himalaya-cli",
-  "version": "0.1035.0",
+  "version": "0.1037.0",
   "type": "module",
   "description": "himi — the Himalaya authoring CLI. Build a Tier-5 content package on your own machine, push it to the production serve as a draft, preview it on web + Himi Player, and read worker logs back — the remote dev loop. Wraps @himalaya/serve-cli for transport.",
   "keywords": [
@@ -65,5 +65,5 @@
       "artifactId": "himalaya-cli"
     }
   },
-  "falconPackageHash": "a1f78ccbd699eee4485119c69175cd6331ff4eb0fb6f23f06086d17a"
+  "falconPackageHash": "e35236017e826d4e25212e7448f29f8004d84cec687b348a8231366e"
 }