@wix/himalaya-cli 0.1494.0 → 0.1496.0

package/guides/sdk-reference.json

@@ -2197,7 +2197,7 @@
         "name": "StartPaymentErrorCode",
         "kind": "type",
         "jsdoc": "",
-        "decl": "export type StartPaymentErrorCode = \"NOT_PENDING\" | \"WRONG_PAYMENT_METHOD\" | \"NOT_ORDER_BUYER\" | \"UNSUPPORTED_ORDER\"\n  | \"PRODUCT_NOT_AVAILABLE\" | \"ALREADY_OWNED\" | \"APP_NOT_CONFIGURED\" | \"SUBSCRIPTION_NOT_IN_APP\" | \"ALREADY_SUBSCRIBED\";"
+        "decl": "export type StartPaymentErrorCode = \"NOT_PENDING\" | \"WRONG_PAYMENT_METHOD\" | \"NOT_ORDER_BUYER\" | \"UNSUPPORTED_ORDER\"\n  | \"PRODUCT_NOT_AVAILABLE\" | \"ALREADY_OWNED\";"
       },
       {
         "name": "StartItemPaymentErrorCode",
@@ -8963,25 +8963,7 @@
         "name": "WixServiceFixedPayment",
         "kind": "interface",
         "jsdoc": "",
-        "decl": "export interface WixServiceFixedPayment {\n  price?: WixServiceMoney;\n  deposit?: WixServiceMoney;\n  fullUpfrontPaymentAllowed?: boolean;\n}"
-      },
-      {
-        "name": "WixServiceVariedPayment",
-        "kind": "interface",
-        "jsdoc": "",
-        "decl": "export interface WixServiceVariedPayment {\n  defaultPrice?: WixServiceMoney;\n  deposit?: WixServiceMoney;\n  minPrice?: WixServiceMoney;\n  maxPrice?: WixServiceMoney;\n}"
-      },
-      {
-        "name": "WixServiceCustomPayment",
-        "kind": "interface",
-        "jsdoc": "",
-        "decl": "export interface WixServiceCustomPayment {\n  description?: string;\n}"
-      },
-      {
-        "name": "WixServicePaymentOptions",
-        "kind": "interface",
-        "jsdoc": "",
-        "decl": "export interface WixServicePaymentOptions {\n  online?: boolean;\n  inPerson?: boolean;\n  deposit?: boolean;\n  pricingPlan?: boolean;\n}"
+        "decl": "export interface WixServiceFixedPayment {\n  price?: WixServiceMoney;\n}"
       },
       {
         "name": "WixServiceRateLabel",
@@ -8993,199 +8975,25 @@
         "name": "WixServicePayment",
         "kind": "interface",
         "jsdoc": "",
-        "decl": "export interface WixServicePayment {\n  rateType?: string;\n  fixed?: WixServiceFixedPayment;\n  varied?: WixServiceVariedPayment;\n  custom?: WixServiceCustomPayment;\n  options?: WixServicePaymentOptions;\n  rateLabel?: WixServiceRateLabel;\n  price?: number;\n  currency?: string;\n}"
-      },
-      {
-        "name": "WixServiceDuration",
-        "kind": "interface",
-        "jsdoc": "",
-        "decl": "export interface WixServiceDuration {\n  minutes?: number;\n}"
-      },
-      {
-        "name": "WixServiceHourlyConfig",
-        "kind": "interface",
-        "jsdoc": "",
-        "decl": "export interface WixServiceHourlyConfig {\n  minDurationInMinutes?: number;\n  maxDurationInMinutes?: number;\n}"
-      },
-      {
-        "name": "WixServiceDailyConfig",
-        "kind": "interface",
-        "jsdoc": "",
-        "decl": "export interface WixServiceDailyConfig {\n  minDurationInDays?: number;\n  maxDurationInDays?: number;\n}"
-      },
-      {
-        "name": "WixServiceDurationRange",
-        "kind": "interface",
-        "jsdoc": "",
-        "decl": "export interface WixServiceDurationRange {\n  hourOptions?: WixServiceHourlyConfig;\n  dayOptions?: WixServiceDailyConfig;\n  unitType?: string;\n}"
+        "decl": "export interface WixServicePayment {\n  fixed?: WixServiceFixedPayment;\n  rateLabel?: WixServiceRateLabel;\n  price?: number;\n  currency?: string;\n}"
       },
       {
         "name": "WixServiceAvailabilityConstraints",
         "kind": "interface",
         "jsdoc": "",
-        "decl": "export interface WixServiceAvailabilityConstraints {\n  durations?: WixServiceDuration[];\n  sessionDurations?: number[];\n  durationRange?: WixServiceDurationRange;\n}"
+        "decl": "export interface WixServiceAvailabilityConstraints {\n  sessionDurations?: number[];\n}"
       },
       {
         "name": "WixServiceSchedule",
         "kind": "interface",
         "jsdoc": "",
-        "decl": "export interface WixServiceSchedule {\n  id?: string;\n  firstSessionStart?: string;\n  lastSessionEnd?: string;\n  availabilityConstraints?: WixServiceAvailabilityConstraints;\n}"
-      },
-      {
-        "name": "WixServiceImage",
-        "kind": "interface",
-        "jsdoc": "",
-        "decl": "export interface WixServiceImage {\n  id?: string;\n  url?: string;\n  height?: number;\n  width?: number;\n  altText?: string;\n}"
-      },
-      {
-        "name": "WixServiceMediaItem",
-        "kind": "interface",
-        "jsdoc": "",
-        "decl": "export interface WixServiceMediaItem {\n  image?: WixServiceImage;\n}"
-      },
-      {
-        "name": "WixServiceMedia",
-        "kind": "interface",
-        "jsdoc": "",
-        "decl": "export interface WixServiceMedia {\n  items?: WixServiceMediaItem[];\n  mainMedia?: WixServiceMediaItem;\n  coverMedia?: WixServiceMediaItem;\n}"
-      },
-      {
-        "name": "WixServiceStreetAddress",
-        "kind": "interface",
-        "jsdoc": "",
-        "decl": "export interface WixServiceStreetAddress {\n  number?: string;\n  name?: string;\n  apt?: string;\n}"
-      },
-      {
-        "name": "WixServiceAddress",
-        "kind": "interface",
-        "jsdoc": "",
-        "decl": "export interface WixServiceAddress {\n  streetAddress?: WixServiceStreetAddress;\n  addressLine?: string;\n  country?: string;\n  subdivision?: string;\n  city?: string;\n  postalCode?: string;\n  formattedAddress?: string;\n}"
-      },
-      {
-        "name": "WixServiceBusinessLocation",
-        "kind": "interface",
-        "jsdoc": "",
-        "decl": "export interface WixServiceBusinessLocation {\n  id?: string;\n  name?: string;\n  default?: boolean;\n  address?: WixServiceAddress;\n}"
-      },
-      {
-        "name": "WixServiceCustomLocation",
-        "kind": "interface",
-        "jsdoc": "",
-        "decl": "export interface WixServiceCustomLocation {\n  id?: string;\n  address?: WixServiceAddress;\n}"
-      },
-      {
-        "name": "WixServiceLocation",
-        "kind": "interface",
-        "jsdoc": "",
-        "decl": "export interface WixServiceLocation {\n  id?: string;\n  type?: string;\n  business?: WixServiceBusinessLocation;\n  custom?: WixServiceCustomLocation;\n  calculatedAddress?: WixServiceAddress;\n}"
-      },
-      {
-        "name": "WixServiceOnlineBooking",
-        "kind": "interface",
-        "jsdoc": "",
-        "decl": "export interface WixServiceOnlineBooking {\n  enabled?: boolean;\n  requireManualApproval?: boolean;\n  allowMultipleRequests?: boolean;\n}"
-      },
-      {
-        "name": "WixServiceConferencing",
-        "kind": "interface",
-        "jsdoc": "",
-        "decl": "export interface WixServiceConferencing {\n  enabled?: boolean;\n}"
-      },
-      {
-        "name": "WixServicePolicyDescription",
-        "kind": "interface",
-        "jsdoc": "",
-        "decl": "export interface WixServicePolicyDescription {\n  enabled?: boolean;\n  description?: string;\n}"
-      },
-      {
-        "name": "WixServiceLimitEarlyBookingPolicy",
-        "kind": "interface",
-        "jsdoc": "",
-        "decl": "export interface WixServiceLimitEarlyBookingPolicy {\n  enabled?: boolean;\n  earliestBookingInMinutes?: number;\n}"
-      },
-      {
-        "name": "WixServiceLimitLateBookingPolicy",
-        "kind": "interface",
-        "jsdoc": "",
-        "decl": "export interface WixServiceLimitLateBookingPolicy {\n  enabled?: boolean;\n  latestBookingInMinutes?: number;\n}"
-      },
-      {
-        "name": "WixServiceBookAfterStartPolicy",
-        "kind": "interface",
-        "jsdoc": "",
-        "decl": "export interface WixServiceBookAfterStartPolicy {\n  enabled?: boolean;\n}"
-      },
-      {
-        "name": "WixServiceCancellationPolicy",
-        "kind": "interface",
-        "jsdoc": "",
-        "decl": "export interface WixServiceCancellationPolicy {\n  enabled?: boolean;\n  limitLatestCancellation?: boolean;\n  latestCancellationInMinutes?: number;\n}"
-      },
-      {
-        "name": "WixServiceReschedulePolicy",
-        "kind": "interface",
-        "jsdoc": "",
-        "decl": "export interface WixServiceReschedulePolicy {\n  enabled?: boolean;\n  limitLatestReschedule?: boolean;\n  latestRescheduleInMinutes?: number;\n}"
-      },
-      {
-        "name": "WixServiceWaitlistPolicy",
-        "kind": "interface",
-        "jsdoc": "",
-        "decl": "export interface WixServiceWaitlistPolicy {\n  enabled?: boolean;\n  capacity?: number;\n  reservationTimeInMinutes?: number;\n}"
-      },
-      {
-        "name": "WixServiceParticipantsPolicy",
-        "kind": "interface",
-        "jsdoc": "",
-        "decl": "export interface WixServiceParticipantsPolicy {\n  maxParticipantsPerBooking?: number;\n}"
-      },
-      {
-        "name": "WixServiceCancellationWindow",
-        "kind": "interface",
-        "jsdoc": "",
-        "decl": "export interface WixServiceCancellationWindow {\n  amount?: WixServiceMoney;\n  percentage?: string;\n  startInMinutes?: number;\n}"
-      },
-      {
-        "name": "WixServiceCancellationFeePolicy",
-        "kind": "interface",
-        "jsdoc": "",
-        "decl": "export interface WixServiceCancellationFeePolicy {\n  enabled?: boolean;\n  cancellationWindows?: WixServiceCancellationWindow[];\n}"
-      },
-      {
-        "name": "WixServiceBookingPolicy",
-        "kind": "interface",
-        "jsdoc": "",
-        "decl": "export interface WixServiceBookingPolicy {\n  id?: string;\n  name?: string;\n  customPolicyDescription?: WixServicePolicyDescription;\n  limitEarlyBookingPolicy?: WixServiceLimitEarlyBookingPolicy;\n  limitLateBookingPolicy?: WixServiceLimitLateBookingPolicy;\n  bookAfterStartPolicy?: WixServiceBookAfterStartPolicy;\n  cancellationPolicy?: WixServiceCancellationPolicy;\n  reschedulePolicy?: WixServiceReschedulePolicy;\n  waitlistPolicy?: WixServiceWaitlistPolicy;\n  participantsPolicy?: WixServiceParticipantsPolicy;\n  cancellationFeePolicy?: WixServiceCancellationFeePolicy;\n}"
-      },
-      {
-        "name": "WixServiceStaffMember",
-        "kind": "interface",
-        "jsdoc": "",
-        "decl": "export interface WixServiceStaffMember {\n  staffMemberId?: string;\n  name?: string;\n  mainMedia?: WixServiceMediaItem;\n}"
-      },
-      {
-        "name": "WixServiceStaffMemberDetails",
-        "kind": "interface",
-        "jsdoc": "",
-        "decl": "export interface WixServiceStaffMemberDetails {\n  staffMembers?: WixServiceStaffMember[];\n}"
-      },
-      {
-        "name": "WixServicePageUrl",
-        "kind": "interface",
-        "jsdoc": "",
-        "decl": "export interface WixServicePageUrl {\n  relativePath?: string;\n  url?: string;\n}"
-      },
-      {
-        "name": "WixServiceUrls",
-        "kind": "interface",
-        "jsdoc": "",
-        "decl": "export interface WixServiceUrls {\n  servicePage?: WixServicePageUrl;\n  bookingPage?: WixServicePageUrl;\n}"
+        "decl": "export interface WixServiceSchedule {\n  availabilityConstraints?: WixServiceAvailabilityConstraints;\n}"
       },
       {
         "name": "WixService",
         "kind": "interface",
         "jsdoc": "",
-        "decl": "export interface WixService {\n  id: string;\n  name?: string;\n  description?: string;\n  type?: string;\n  tagLine?: string;\n  defaultCapacity?: number;\n  media?: WixServiceMedia;\n  duration?: number;\n  payment?: WixServicePayment;\n  onlineBooking?: WixServiceOnlineBooking;\n  conferencing?: WixServiceConferencing;\n  locations?: WixServiceLocation[];\n  bookingPolicy?: WixServiceBookingPolicy;\n  schedule?: WixServiceSchedule;\n  staffMemberDetails?: WixServiceStaffMemberDetails;\n  urls?: WixServiceUrls;\n  price?: number;\n  category?: string;\n}"
+        "decl": "export interface WixService {\n  id: string;\n  name?: string;\n  description?: string;\n  duration?: number;\n  payment?: WixServicePayment;\n  schedule?: WixServiceSchedule;\n  price?: number;\n  category?: string;\n}"
       },
       {
         "name": "WixServicesSearchPaging",
@@ -9217,12 +9025,6 @@
         "jsdoc": "",
         "decl": "export interface WixGetServiceResponse {\n  service: WixService;\n}"
       },
-      {
-        "name": "WixGetServiceOptions",
-        "kind": "interface",
-        "jsdoc": "",
-        "decl": "export interface WixGetServiceOptions {\n  conditionalFields?: string[];\n}"
-      },
       {
         "name": "WixServiceWrite",
         "kind": "interface",
@@ -9361,13 +9163,13 @@
         "name": "WixServicePayment",
         "kind": "interface",
         "jsdoc": "",
-        "decl": "export interface WixServicePayment {\n  /** \"FIXED\" | \"CUSTOM\" | \"VARIED\" | \"NO_FEE\". */\n  rateType?: string;\n  fixed?: { price?: WixServiceMoney; deposit?: WixServiceMoney; fullUpfrontPaymentAllowed?: boolean };\n  varied?: { defaultPrice?: WixServiceMoney; deposit?: WixServiceMoney; minPrice?: WixServiceMoney; maxPrice?: WixServiceMoney };\n  custom?: { description?: string };\n  /** How the customer may pay. A service offers at least one of these. */\n  options?: { online?: boolean; inPerson?: boolean; deposit?: boolean; pricingPlan?: boolean };\n  rateLabel?: { amount?: string; currency?: string };\n  /** @deprecated Legacy flat payment shape. */\n  price?: number;\n  /** @deprecated Legacy flat payment shape. */\n  currency?: string;\n}"
+        "decl": "export interface WixServicePayment {\n  fixed?: { price?: WixServiceMoney };\n  rateLabel?: { amount?: string; currency?: string };\n  /** @deprecated Legacy flat payment shape. */\n  price?: number;\n  /** @deprecated Legacy flat payment shape. */\n  currency?: string;\n}"
       },
       {
         "name": "WixService",
         "kind": "interface",
         "jsdoc": "",
-        "decl": "export interface WixService {\n  id: string;\n  /** Optimistic-concurrency token — required by every v2 write (updateService reads it if omitted). */\n  revision?: string;\n  name?: string;\n  description?: string;\n  /** \"APPOINTMENT\" | \"CLASS\" | \"COURSE\". */\n  type?: string;\n  tagLine?: string;\n  defaultCapacity?: number;\n  media?: WixServiceMedia;\n  /** Session length in minutes. */\n  duration?: number;\n  /** Raw Bookings v2 response shape. */\n  payment?: WixServicePayment;\n  onlineBooking?: { enabled?: boolean; requireManualApproval?: boolean; allowMultipleRequests?: boolean };\n  conferencing?: { enabled?: boolean };\n  locations?: WixServiceLocation[];\n  bookingPolicy?: WixServiceBookingPolicy;\n  schedule?: {\n    id?: string;\n    firstSessionStart?: string;\n    lastSessionEnd?: string;\n    availabilityConstraints?: { durations?: Array<{ minutes?: number }>; sessionDurations?: number[]; durationRange?: WixServiceDurationRange };\n  };\n  /** Returned only when the request asks for `STAFF_MEMBER_DETAILS` (see `getService`). */\n  staffMemberDetails?: WixServiceStaffMemberDetails;\n  urls?: WixServiceUrls;\n  /** @deprecated Compatibility projection populated by `decodeService`. */\n  price?: number;\n  /** @deprecated Legacy v1 compatibility field. */\n  category?: string;\n}"
+        "decl": "export interface WixService {\n  id: string;\n  /** Optimistic-concurrency token — required by every v2 write (updateService reads it if omitted). */\n  revision?: string;\n  name?: string;\n  description?: string;\n  /** Session length in minutes. */\n  duration?: number;\n  /** Raw Bookings v2 response shape. */\n  payment?: WixServicePayment;\n  schedule?: { availabilityConstraints?: { sessionDurations?: number[] } };\n  /** @deprecated Compatibility projection populated by `decodeService`. */\n  price?: number;\n  /** @deprecated Legacy v1 compatibility field. */\n  category?: string;\n}"
       },
       {
         "name": "decodeService",
@@ -9446,8 +9248,9 @@
       {
         "name": "getService",
         "kind": "function",
-        "jsdoc": "/** Fetch a single service by id — GET /bookings/v2/services/{id}. Visitor-readable\n *  (public GA route, not the owner `_api/` gateway). The detail/edit-prefill source.\n *  `options.conditionalFields` asks for fields Wix returns only on request\n *  (\"STAFF_MEMBER_DETAILS\", \"DISCOUNT_INFO_DETAILS\"), each sent as a repeated\n *  `conditionalFields` query parameter. Without `options` the request is the one this\n *  function always sent. */",
-        "decl": "export async function getService(serviceId: string, options?: WixGetServiceOptions): Promise<WixGetServiceResponse>;"
+        "jsdoc": "/** Fetch a single service by id — GET /bookings/v2/services/{id}. Visitor-readable\n *  (public GA route, not the owner `_api/` gateway). The detail/edit-prefill source. */",
+        "decl": "export async function getService(serviceId: string): Promise<WixGetServiceResponse>;",
+        "http": "GET /bookings/v2/services/{…}"
       },
       {
         "name": "WixServiceWrite",
@@ -9563,54 +9366,6 @@
         "decl": "export function cancelBookingAsMember(bookingId: string, revision: string, notify = true): Promise<WixUpdateBookingResponse>;",
         "http": "POST /bookings/v2/bookings/{…}/cancel"
       },
-      {
-        "name": "WixWaitlistContact",
-        "kind": "interface",
-        "jsdoc": "",
-        "decl": "export interface WixWaitlistContact {\n  email: string;\n  firstName?: string;\n  lastName?: string;\n}"
-      },
-      {
-        "name": "WixWaitlistRegistration",
-        "kind": "interface",
-        "jsdoc": "",
-        "decl": "export interface WixWaitlistRegistration {\n  id?: string;\n  bookingId?: string;\n  waitingResource?: string;\n  status?: string;\n  availableActions?: { leave?: boolean; enroll?: boolean };\n}"
-      },
-      {
-        "name": "WixWaitlistEntry",
-        "kind": "interface",
-        "jsdoc": "",
-        "decl": "export interface WixWaitlistEntry {\n  /** The waitlisted session id. */\n  waitingResource?: string;\n  registrations?: WixWaitlistRegistration[];\n}"
-      },
-      {
-        "name": "WixRegisterToWaitlistResponse",
-        "kind": "interface",
-        "jsdoc": "",
-        "decl": "export interface WixRegisterToWaitlistResponse {\n  registrationId?: string;\n  booking?: { id?: string; status?: string };\n}"
-      },
-      {
-        "name": "registerToWaitlist",
-        "kind": "function",
-        "jsdoc": "/** Register the signed-in member to a full session's waitlist —\n *  POST /bookings/v1/waitlist/register. `sessionId` is the availability slot's\n *  `sessionId`. Wix answers with an error when the session has no waitlist or it is\n *  full, so offer this only while the entry reports `waitingList.openSpots > 0`.\n *  @scope member — requires a signed-in site member; `contact.email` is theirs. Only name and\n *  email are sent, so a booking form with other required fields can refuse it. */",
-        "decl": "export function registerToWaitlist(sessionId: string, contact: WixWaitlistContact): Promise<WixRegisterToWaitlistResponse>;",
-        "http": "POST /bookings/v1/waitlist/register",
-        "scope": "member"
-      },
-      {
-        "name": "listWaitlists",
-        "kind": "function",
-        "jsdoc": "/** The waitlists of the given sessions — GET /bookings/v1/waitlist/list (public data).\n *  Each registration carries its `bookingId`, which is how a member's own place is found.\n *  @scope visitor — an anonymous visitor session is enough. */",
-        "decl": "export function listWaitlists(sessionIds: string[]): Promise<{ list?: WixWaitlistEntry[] }>;",
-        "http": "GET /bookings/v1/waitlist/list",
-        "scope": "visitor"
-      },
-      {
-        "name": "leaveWaitlist",
-        "kind": "function",
-        "jsdoc": "/** Leave a waitlist — POST /bookings/v1/waitlist/leave. Wix also cancels the pending\n *  booking the registration created, and offers the place to the next registrant.\n *  @scope member — requires the signed-in member who registered; `registrationId` comes from\n *  `listWaitlists`. */",
-        "decl": "export function leaveWaitlist(registrationId: string, sessionId: string): Promise<{ registrationId?: string; waitingResource?: string }>;",
-        "http": "POST /bookings/v1/waitlist/leave",
-        "scope": "member"
-      },
       {
         "name": "isBookingPolicyViolation",
         "kind": "function",

package/guides/widgets.md

@@ -58,9 +58,11 @@ the OS grants a background refresh, never on its own. An app that embeds Himalay
 produce from `HimalayaEmbedSurfaces.publishWidgets` (see
 [embedding → widgets](embedding-sdk.md#home-and-lock-screen-widgets)).
 
-`refresh.pushTopic` exists in the type definitions, but nothing consumes it yet: setting it does not
-make the widget update when data changes. Without a device produce, plan the widget around what you
-know when the app is built — a call to action, a constant, or a schedule (see
+`refresh.pushTopic` is consumed only by an app that embeds Himalaya apps: its push handler hands the
+topic to `HimalayaEmbedSurfaces.handlePush`, which publishes the place again (see
+[embedding → push refresh](embedding-sdk.md#push-refresh-widgets-and-live-activities)). A standalone
+app does nothing with it: setting it does not make the widget update when data changes. Without a
+device produce or that host, plan the widget around what you know when the app is built — a call to action, a constant, or a schedule (see
 [timelines](#content-whose-future-you-know-live-time-and-timelines)) — and let the tap take the user
 into the app, where the live data is.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wix/himalaya-cli",
-  "version": "0.1494.0",
+  "version": "0.1496.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": [
@@ -71,5 +71,5 @@
       "artifactId": "himalaya-cli"
     }
   },
-  "falconPackageHash": "83e398472e7eab5d1c81ff13de41fb87a660cfc7364c8cbd61d59411"
+  "falconPackageHash": "62f2d72e731199e9639b54a6fe134fb94787cad79d777403144183b4"
 }