@wix/himalaya-cli 0.1582.0 → 0.1584.0

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/_types/core/dev-server/src/builder.d.ts

@@ -1350,6 +1350,9 @@ export declare function agenda(props: {
      *  an Agenda without silently inverting its own sort. Flips the day GROUPS and
      *  the events within each group together. */
     descending?: boolean;
+    /** `{ date }` when the day at the top of the visible area changes by the user's scroll (not a
+     *  `scrollToDate` jump): a calendar above the list can follow it. */
+    onVisibleDateChange?: ActionShape;
 }, opts?: {
     id?: string;
 }): Component;
@@ -1689,6 +1692,11 @@ export declare function lazyList(props: {
     itemsPath?: string;
     /** Animate insert/remove/reorder as the bound array changes (needs stable ids). */
     animateItems?: boolean;
+    /** `$service:` path naming a row by its item `id` ("id" or "id|nonce"): a change scrolls that
+     *  row to the top of the visible area. Section anchors. */
+    scrollToItemPath?: string;
+    /** `{ id }` when the row at the top of the visible area changes by the user's scroll. */
+    onTopItemChange?: ActionShape;
 }, opts?: {
     id?: string;
 }): Component;

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/_types/core/ts/src/schema.d.ts

@@ -531,6 +531,20 @@ export interface LazyListProps {
      */
     contentInsetTop?: number;
     contentInsetBottom?: number;
+    /**
+     * Jump to a row of a bound (`itemsPath`) list: a `$service:` path whose value names a row by
+     * its item's `id`. When the value CHANGES to a non-empty one, the row's top is brought to the
+     * top of the visible area (the list's scroll, or the screen's when the list sits in it).
+     * Only the part before the first "|" is the id, so a worker can re-trigger the same row
+     * ("cat:yoga|2"). Unknown id ⇒ nothing.
+     */
+    scrollToItemPath?: string;
+    /**
+     * Fired with args `{ id }` when the bound row at the top of the visible area changes because
+     * the user scrolled: on a change only, after the scroll settles, never for a
+     * `scrollToItemPath` jump, not on first render. Rows with no `id` are skipped.
+     */
+    onTopItemChange?: Action;
 }
 export interface GridProps {
     items: Component[];
@@ -2408,7 +2422,10 @@ export interface AgendaProps {
     events?: CalendarEvent[];
     eventsPath?: string;
     scrollToDate?: string;
-    /** Worker-driven jump target (a literal `scrollToDate` is frozen in the descriptor). */
+    /** Worker-driven jump target (a literal `scrollToDate` is frozen in the descriptor). Either may be
+     *  "YYYY-MM-DD|<anything>": the day is the part before "|", and a change of the whole value jumps
+     *  again, also to the same day. A suffix-less value equal to the day last reported through
+     *  `onVisibleDateChange` is an echo of the user's own scroll and does not move the list. */
     scrollToDatePath?: string;
     stickyHeaders?: boolean;
     emptyText?: string;
@@ -2422,6 +2439,11 @@ export interface AgendaProps {
      *  (an owner's orders, recent activity) could not become an Agenda without
      *  silently inverting itself — every arm sorted ascending unconditionally. */
     descending?: boolean;
+    /** Fired with args `{ date: "YYYY-MM-DD" }` when the day group at the top of the visible area
+     *  changes because the user scrolled (the agenda's own scroll, or the screen's): on a change
+     *  only, after the scroll settles, never for a `scrollToDate` jump, not on first render. Lets a
+     *  calendar above the list follow it. */
+    onVisibleDateChange?: Action;
 }
 export type CoreComponentBody = {
     package: "himalaya";
@@ -3178,7 +3200,9 @@ export interface TopBarAction {
     badge?: NavBadge;
     /** Live bindings against `NavigationConfig.navLogicBundle` — see `NavTabItem`.
      *  `hiddenPath` drops the action from the trailing cluster, which is how "hide
-     *  Checkout while the cart is empty" is said without publishing two top bars. */
+     *  Checkout while the cart is empty" is said without publishing two top bars.
+     *  A screen's own top-bar action binds the same nav worker; runtime 1.8.0 and later
+     *  watch those paths (an older one shows the action). */
     hiddenPath?: string;
     labelPath?: string;
     iconPath?: string;

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/_types/core/ts/src/validator.d.ts

@@ -708,6 +708,15 @@ export declare const screenDescriptorSchema: {
                 readonly badge: {
                     readonly $ref: "#/$defs/navBadge";
                 };
+                readonly hiddenPath: {
+                    readonly type: "string";
+                };
+                readonly labelPath: {
+                    readonly type: "string";
+                };
+                readonly iconPath: {
+                    readonly type: "string";
+                };
             };
         };
         readonly navBadge: {
@@ -2137,6 +2146,15 @@ export declare const widgetSnapshotSchema: {
                 readonly badge: {
                     readonly $ref: "#/$defs/navBadge";
                 };
+                readonly hiddenPath: {
+                    readonly type: "string";
+                };
+                readonly labelPath: {
+                    readonly type: "string";
+                };
+                readonly iconPath: {
+                    readonly type: "string";
+                };
             };
         };
         readonly navBadge: {

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/_types/stdlib/wix-sdk/blog-v3/src/extensions.d.ts

@@ -6,6 +6,8 @@ export declare function getDraftPost(postId: string, options?: WixCallOptions):
  * list projection (no body), so the body-bearing fields live here on the read
  * shape `getPost` returns once the body fieldsets are requested. */
 export interface WixPostWithContent extends WixPost {
+    /** Legacy Comments resource ID. Present when INTERNAL_ID was requested. */
+    internalId?: string;
     /** Ricos rich-content body (opaque JSON). Present only when RICH_CONTENT was requested. */
     richContent?: WixRichContent;
     /** Plain-text rendering of the body. Present only when CONTENT_TEXT was requested. */

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/_types/stdlib/wix-sdk/comments-v1/src/extensions.d.ts

@@ -29,7 +29,9 @@ type BlogCommentLike = {
 /** A created or listed comment as the blog screen's row. Accepts the curated and the auto-tier
  *  (`comments.createComment`) response shapes alike — both are the same REST wire object. */
 export declare function blogCommentRow(comment: BlogCommentLike | undefined): WixBlogCommentRow;
+/** `postId` is Blog v3 `post.internalId` (request INTERNAL_ID), not its navigation UUID. */
 export declare function createBlogComment(postId: string, text: string): Promise<WixBlogCommentRow>;
+/** First Comments page for Blog v3 `post.internalId`, not its navigation UUID. */
 export declare function listBlogComments(postId: string): Promise<WixBlogCommentRow[]>;
 /** The appId Wix Groups registers as its comments provider. Same value as
  *  GROUPS_APP_ID/GROUPS_APP_DEF_ID used elsewhere in this repo (social-feed's

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/_types/stdlib/wix-sdk/events/src/index.d.ts

@@ -126,6 +126,9 @@ export interface WixQueryEventsOptions {
     limit?: number;
     /** Page offset. */
     offset?: number;
+    /** Extra Events v3 fieldsets to read with each row (see {@link WixEventFieldset}), as
+     *  {@link getEvent} takes. Omitted → the default fieldset, and the request is unchanged. */
+    fields?: WixEventFieldset[];
     /** Status filter (e.g. `["UPCOMING"]`), matched exactly against each row's `eventStatus`.
      * Omitted → all statuses returned; a value no row carries selects nothing.
      *

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/_types/stdlib/wix-sdk/groups/src/extensions.d.ts

@@ -16,6 +16,21 @@ export declare function queryGroups(req?: WixGroupsQueryRequest, opts?: WixCallO
  * public group.
  */
 export declare function getGroup(id: string, opts?: WixCallOptions): Promise<WixGroup>;
+export interface WixGroupRule {
+    title?: string;
+    description?: string;
+}
+export interface WixListGroupRulesResponse {
+    rules?: WixGroupRule[];
+}
+/**
+ * List a group's community rules — GET /social-groups/v2/rules/{groupId}.
+ *
+ * @scope visitor — a Visitor read of a public group returned 200 with `{ rules: [] }`
+ * (2026-11-05). Whether a private/secret group's rules are visible to a non-member
+ * is unconfirmed — needsLiveProbe. A group with no rules answers an empty `rules`.
+ */
+export declare function listRules(groupId: string, opts?: WixCallOptions): Promise<WixListGroupRulesResponse>;
 export interface WixGroupCoverImage {
     /** A previously-uploaded Wix Media file id (from site-media generate-upload-url + PUT). */
     mediaId?: string;

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/_types/stdlib/wix-sdk/loyalty/src/extensions.d.ts

@@ -1,3 +1,4 @@
+import { type WixCallOptions } from "./index.js";
 export interface LoyaltyOverview {
     balance?: number;
     earned?: number;
@@ -41,3 +42,15 @@ export interface LoyaltyDashboardResponse {
 /** Loyalty BFF dashboard — program status + points overview + customers page.
  *  GET /v1/loyalty-dashboard?limit=N. User-instance authed (auto-attached). */
 export declare function getLoyaltyBffDashboard(limit?: number): Promise<LoyaltyDashboardResponse>;
+/** Read the authenticated member's own Loyalty account; no customer ID is accepted.
+ * Source contract: loyalty-v1.getCurrentMemberAccount. Anonymous visitors are refused.
+ * A signed-in customer recording is still required for migration acceptance.
+ * @scope member
+ */
+export declare function getCurrentMemberLoyaltyAccount(readOptions?: WixCallOptions): Promise<{
+    account?: {
+        points?: {
+            balance?: number;
+        };
+    };
+}>;

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/_types/stdlib/wix-sdk/members-v1/src/index.d.ts

@@ -34,6 +34,11 @@ export interface WixPaging {
 export interface WixMembersQuery {
     filter?: Record<string, unknown>;
     paging?: WixPaging;
+    /** REST Query's wire name is `sorting`; `sort` remains for existing callers. */
+    sorting?: Array<{
+        fieldName: string;
+        order?: "ASC" | "DESC";
+    }>;
     sort?: unknown[];
 }
 export interface WixMemberImage {
@@ -77,10 +82,16 @@ export interface WixMembersMetadata {
     count?: number;
     offset?: number;
     total?: number;
+    tooManyToCount?: boolean;
 }
 export interface WixQueryMembersRequest {
     query?: WixMembersQuery;
     fieldsets?: string[];
+    /** Branded directory search uses these public member fields, on the server. */
+    search?: {
+        expression: string;
+        fields?: string[];
+    };
 }
 export interface WixQueryMembersResponse {
     members: WixMember[];
@@ -177,8 +188,11 @@ export interface WixActivityCounter {
     /** The app the counters belong to (match against MEMBERS_FOLLOWERS_APP_ID). */
     appId?: string;
     memberId?: string;
-    /** Per-key counters, e.g. { followerCount: { count }, followingCount: { count } }. */
-    counters?: Record<string, {
+    /** Branded's REST wire shape is a keyed array. Keep the older map shape readable too. */
+    counters?: Array<{
+        key?: string;
+        count?: number;
+    }> | Record<string, {
         count?: number;
     }>;
 }
@@ -198,8 +212,9 @@ export interface WixMyConnectionsResponse {
     connectedMembers?: WixMemberConnection[];
 }
 /** Followers / following totals for a member — POST
- *  /members/v1/activity-counters/query. Parses the Followers-app counter entry;
- *  defaults each total to 0 when absent. May 403 → caller should default. */
+ *  /members/v1/activity-counters/query. Requires explicit nonnegative safe integer
+ *  totals for this member's Followers-app entry. Missing/invalid totals reject,
+ *  as do permission failures; callers should hide unavailable counts, never invent zero. */
 export declare function getFollowCounts(memberId: string, options?: WixCallOptions): Promise<WixFollowCounts>;
 /** Whether the signed-in member follows `targetId` — POST
  *  /members/v3/followers/my/connections. Returns false on any miss. May 403 →

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/core.mjs

@@ -8794,7 +8794,11 @@ var screenDescriptorSchema = {
         label: { type: "string" },
         accessibilityLabel: { type: "string" },
         onTap: { $ref: "#/$defs/action" },
-        badge: { $ref: "#/$defs/navBadge" }
+        badge: { $ref: "#/$defs/navBadge" },
+        // RFC 0010 slot bindings (core.proto TopBarAction 7–9): they bind the app's nav worker.
+        hiddenPath: { type: "string" },
+        labelPath: { type: "string" },
+        iconPath: { type: "string" }
       }
     },
     navBadge: {

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/sdui.mjs

@@ -7366,7 +7366,11 @@ var screenDescriptorSchema = {
         label: { type: "string" },
         accessibilityLabel: { type: "string" },
         onTap: { $ref: "#/$defs/action" },
-        badge: { $ref: "#/$defs/navBadge" }
+        badge: { $ref: "#/$defs/navBadge" },
+        // RFC 0010 slot bindings (core.proto TopBarAction 7–9): they bind the app's nav worker.
+        hiddenPath: { type: "string" },
+        labelPath: { type: "string" },
+        iconPath: { type: "string" }
       }
     },
     navBadge: {

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/wix-comments.mjs

@@ -80,6 +80,9 @@ async function listBlogComments(postId) {
     "GET",
     `/comments/v1/comments/list-by-resource?${query}`
   );
+  if (!Array.isArray(response?.comments) && !(response?.comments == null && response?.pagingMetadata?.count === 0)) {
+    throw new Error("Blog comments response has no comment page");
+  }
   const rows = (response.comments ?? []).map((comment) => ({
     id: comment.id ?? "comment",
     authorName: commentAuthor(comment),

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/wix-events.mjs

@@ -230,7 +230,9 @@ function normalizeEventAt(e, now) {
     id,
     title,
     day: date && !Number.isNaN(date.getTime()) ? String(date.getDate()) : title.slice(0, 1).toUpperCase(),
-    month: date && !Number.isNaN(date.getTime()) ? date.toLocaleString("en-US", { month: "short" }).toUpperCase() : "",
+    // From the fixed table, not `toLocaleString`: QuickJS (the watch engine) has no ECMA-402 and
+    // answers that call with the whole "11/10/2030, 12:00:00 PM" string.
+    month: date && !Number.isNaN(date.getTime()) ? MONTHS_SHORT[date.getMonth()].toUpperCase() : "",
     dateLine: eventWhen(e, now),
     // "Past" for a finished event, "" otherwise — the shared collection row prints it in the
     // meta line, so an event from last month no longer reads as current.
@@ -300,7 +302,7 @@ function eventStartMs(e) {
 async function queryEvents(opts = {}, readOptions) {
   const limit = opts.limit ?? opts.query?.paging?.limit ?? 50;
   const offset = opts.offset ?? opts.query?.paging?.offset ?? 0;
-  const res = await wixCall("POST", "/events/v3/events/query", { query: { ...opts.query, paging: { limit, offset } } }, readOptions);
+  const res = await wixCall("POST", "/events/v3/events/query", { query: { ...opts.query, paging: { limit, offset } }, ...opts.fields?.length ? { fields: opts.fields } : {} }, readOptions);
   let events = (res.events ?? []).map(decodeEvent);
   if (opts.statuses) {
     const wanted = new Set(opts.statuses);

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/wix-groups.mjs

@@ -6,6 +6,10 @@ function getGroup(id, opts) {
   if (!id) throw new Error("getGroup: id is required");
   return wixCall("GET", `/social-groups-proxy/groups/v2/groups/${encodeURIComponent(id)}`, void 0, opts);
 }
+function listRules(groupId, opts) {
+  if (!groupId) throw new Error("listRules: groupId is required");
+  return wixCall("GET", `/social-groups/v2/rules/${encodeURIComponent(groupId)}`, void 0, opts);
+}
 function createGroup(group) {
   return wixCall("POST", "/social-groups-proxy/groups/v2/groups", { group });
 }
@@ -102,6 +106,7 @@ export {
   joinGroup,
   leaveGroup,
   listJoinGroupRequests,
+  listRules,
   queryGroups,
   queryMembers,
   rejectJoinGroupRequests,

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/wix-loyalty.mjs

@@ -3,6 +3,9 @@ var LOYALTY_BFF = "https://apps.wix.com/loyalty/mobile-api/v1";
 function getLoyaltyBffDashboard(limit = 25) {
   return wixCall("GET", `${LOYALTY_BFF}/loyalty-dashboard?limit=${encodeURIComponent(String(limit))}`);
 }
+function getCurrentMemberLoyaltyAccount(readOptions) {
+  return wixCall("GET", "/loyalty-accounts/v1/accounts/my-account", void 0, readOptions);
+}
 
 // ../../stdlib/wix-sdk/loyalty/src/index.ts
 function wixCall(method, path, body, readOptions) {
@@ -40,6 +43,7 @@ function listLoyaltyEarningRules(readOptions) {
   return wixCall("GET", "/_api/loyalty-earning-rules/v1/earning-rules/rules", void 0, readOptions);
 }
 export {
+  getCurrentMemberLoyaltyAccount,
   getLoyaltyBffDashboard,
   getLoyaltyProgram,
   listLoyaltyEarningRules,

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/wix-members.mjs

@@ -84,10 +84,17 @@ async function getFollowCounts(memberId, options) {
     { query: { filter: { memberId: { $in: [memberId] } } } },
     options
   );
-  const entry = (res.activityCounters ?? []).find((c) => c.appId === MEMBERS_FOLLOWERS_APP_ID);
+  const entry = (res.activityCounters ?? []).find((c) => c.appId === MEMBERS_FOLLOWERS_APP_ID && c.memberId === memberId);
+  const counters = entry?.counters;
+  const value = (key) => Array.isArray(counters) ? counters.find((counter) => counter?.key === key)?.count : counters?.[key]?.count;
+  const followers = value("followerCount");
+  const following = value("followingCount");
+  if (typeof followers !== "number" || !Number.isSafeInteger(followers) || followers < 0 || typeof following !== "number" || !Number.isSafeInteger(following) || following < 0) {
+    throw new Error("getFollowCounts: explicit member totals are unavailable");
+  }
   return {
-    followers: entry?.counters?.followerCount?.count ?? 0,
-    following: entry?.counters?.followingCount?.count ?? 0
+    followers,
+    following
   };
 }
 async function isFollowingMember(targetId) {