@wix/himalaya-cli 0.899.0 → 0.900.0

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

@@ -35,7 +35,11 @@ export interface WixEventLocation {
 export interface WixEvent {
     id: string;
     title?: string;
-    /** SCHEDULED | STARTED | ENDED | CANCELED | DRAFT */
+    /** Normally one of `WixEventStatus`, but deliberately NOT narrowed to it: `decodeEvent`
+     *  fills this from the server's `status` and passes a value it does not recognise straight
+     *  through, because dropping or rewriting one would lose a real event. A union here would
+     *  be a claim this SDK cannot enforce. Compare against `WixEventStatus` when you need the
+     *  stored set; the narrowing that IS enforced is on the `statuses` filter below. */
     eventStatus?: string;
     /** EventType: RSVP | TICKETS | EXTERNAL | NO_REGISTRATION */
     eventType?: string;
@@ -55,6 +59,23 @@ export interface WixGetEventResponse {
 }
 export interface WixDeleteEventResponse {
 }
+/** The stored event statuses — what this SDK knows the server stores, and so the only values
+ *  the `statuses` filter can match. The one source for both the runtime guard and the type
+ *  below, so a status added here cannot be missed by either.
+ *
+ *  Exported because `WixEventStatus` is declared in terms of it: the generated SDK reference
+ *  ships each exported declaration verbatim, and a reader copying a type that names a symbol
+ *  they cannot see gets TS2304.
+ *
+ *  Frozen because `as const` is erased: it makes the TYPE readonly and leaves an ordinary
+ *  mutable array behind. Unexported that was academic; exported it is not — module bindings
+ *  share one array object, so a `push` from any untyped caller would edit the very set
+ *  `queryEvents` validates against, for every caller in that realm. The freeze makes the
+ *  runtime keep the promise the type already makes. */
+export declare const EVENT_STATUSES: readonly ["SCHEDULED", "STARTED", "ENDED", "CANCELED", "DRAFT"];
+/** One of the stored event statuses. `WixQueryEventsOptions.statuses` takes these, so a value
+ *  outside the set is refused while the call is being written rather than when it is made. */
+export type WixEventStatus = (typeof EVENT_STATUSES)[number];
 export interface WixQueryEventsOptions {
     /** Server-side WQL filter/sort for Events v3. Unlike the legacy convenience
      * options below, these criteria are applied before paging. */
@@ -73,13 +94,13 @@ export interface WixQueryEventsOptions {
     limit?: number;
     /** Page offset. */
     offset?: number;
-    /** Status filter (e.g. `["SCHEDULED"]`). Every entry must be one of the stored event
-     * statuses — `SCHEDULED`, `STARTED`, `ENDED`, `CANCELED`, `DRAFT` — and anything else is
-     * rejected rather than quietly matching nothing. Omitted → all statuses returned.
+    /** Status filter (e.g. `["SCHEDULED"]`). Every entry must be a `WixEventStatus`; anything
+     * else is refused rather than quietly matching nothing — by the compiler for a typed caller,
+     * and at runtime for one that is not. Omitted → all statuses returned.
      * There is no stored "upcoming" status; select future events by their start date.
-     * For a value the server accepts that this list does not name, use `query.filter`, which is
-     * passed through to the server unchanged. */
-    statuses?: string[];
+     * For a value the server accepts that `WixEventStatus` does not name, use `query.filter`,
+     * which is passed through to the server unchanged. */
+    statuses?: WixEventStatus[];
     /** Sort property (the Owner list orders by "start"). */
     order?: string;
     /** Free-text title search. */

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

@@ -242,7 +242,7 @@ function wixCall(method, path, body) {
   return globalThis.himalaya.wixApi.call(method, path, body);
 }
 var BASE = "https://manage.wix.com/_api/wix-one-events-server/events-in-clubs";
-var EVENT_STATUSES = ["SCHEDULED", "STARTED", "ENDED", "CANCELED", "DRAFT"];
+var EVENT_STATUSES = Object.freeze(["SCHEDULED", "STARTED", "ENDED", "CANCELED", "DRAFT"]);
 function decodeEvent(raw) {
   if (raw == null) return raw;
   const r = raw;
@@ -365,6 +365,7 @@ function getEventsOrder(eventId, orderNumber) {
   );
 }
 export {
+  EVENT_STATUSES,
   cancelTicketReservation,
   checkoutReservation,
   createEvent,

package/guides/sdk-reference.json

@@ -14313,7 +14313,7 @@
         "name": "WixEvent",
         "kind": "interface",
         "jsdoc": "",
-        "decl": "export interface WixEvent {\n  id: string;\n  title?: string;\n  /** SCHEDULED | STARTED | ENDED | CANCELED | DRAFT */\n  eventStatus?: string;\n  /** EventType: RSVP | TICKETS | EXTERNAL | NO_REGISTRATION */\n  eventType?: string;\n  scheduling?: WixEventScheduling;\n  location?: WixEventLocation;\n  mainImage?: WixEventImage;\n  slug?: string;\n  about?: string;\n  description?: string;\n}"
+        "decl": "export interface WixEvent {\n  id: string;\n  title?: string;\n  /** Normally one of `WixEventStatus`, but deliberately NOT narrowed to it: `decodeEvent`\n   *  fills this from the server's `status` and passes a value it does not recognise straight\n   *  through, because dropping or rewriting one would lose a real event. A union here would\n   *  be a claim this SDK cannot enforce. Compare against `WixEventStatus` when you need the\n   *  stored set; the narrowing that IS enforced is on the `statuses` filter below. */\n  eventStatus?: string;\n  /** EventType: RSVP | TICKETS | EXTERNAL | NO_REGISTRATION */\n  eventType?: string;\n  scheduling?: WixEventScheduling;\n  location?: WixEventLocation;\n  mainImage?: WixEventImage;\n  slug?: string;\n  about?: string;\n  description?: string;\n}"
       },
       {
         "name": "WixGetEventListResponse",
@@ -14333,11 +14333,23 @@
         "jsdoc": "",
         "decl": "export interface WixDeleteEventResponse {\n  // Empty object on success.\n}"
       },
+      {
+        "name": "EVENT_STATUSES",
+        "kind": "const",
+        "jsdoc": "/** The stored event statuses — what this SDK knows the server stores, and so the only values\n *  the `statuses` filter can match. The one source for both the runtime guard and the type\n *  below, so a status added here cannot be missed by either.\n *\n *  Exported because `WixEventStatus` is declared in terms of it: the generated SDK reference\n *  ships each exported declaration verbatim, and a reader copying a type that names a symbol\n *  they cannot see gets TS2304.\n *\n *  Frozen because `as const` is erased: it makes the TYPE readonly and leaves an ordinary\n *  mutable array behind. Unexported that was academic; exported it is not — module bindings\n *  share one array object, so a `push` from any untyped caller would edit the very set\n *  `queryEvents` validates against, for every caller in that realm. The freeze makes the\n *  runtime keep the promise the type already makes. */",
+        "decl": "export const EVENT_STATUSES = Object.freeze([\"SCHEDULED\", \"STARTED\", \"ENDED\", \"CANCELED\", \"DRAFT\"] as const);"
+      },
+      {
+        "name": "WixEventStatus",
+        "kind": "type",
+        "jsdoc": "/** One of the stored event statuses. `WixQueryEventsOptions.statuses` takes these, so a value\n *  outside the set is refused while the call is being written rather than when it is made. */",
+        "decl": "export type WixEventStatus = (typeof EVENT_STATUSES)[number];"
+      },
       {
         "name": "WixQueryEventsOptions",
         "kind": "interface",
         "jsdoc": "",
-        "decl": "export interface WixQueryEventsOptions {\n  /** Server-side WQL filter/sort for Events v3. Unlike the legacy convenience\n   * options below, these criteria are applied before paging. */\n  query?: { filter?: Record<string, unknown>; sort?: Array<{ fieldName: string; order: \"ASC\" | \"DESC\" }>; paging?: { limit?: number; offset?: number } };\n  /** Page size. */\n  limit?: number;\n  /** Page offset. */\n  offset?: number;\n  /** Status filter (e.g. `[\"SCHEDULED\"]`). Every entry must be one of the stored event\n   * statuses — `SCHEDULED`, `STARTED`, `ENDED`, `CANCELED`, `DRAFT` — and anything else is\n   * rejected rather than quietly matching nothing. Omitted → all statuses returned.\n   * There is no stored \"upcoming\" status; select future events by their start date.\n   * For a value the server accepts that this list does not name, use `query.filter`, which is\n   * passed through to the server unchanged. */\n  statuses?: string[];\n  /** Sort property (the Owner list orders by \"start\"). */\n  order?: string;\n  /** Free-text title search. */\n  title?: string;\n  /** Include draft events in the result. */\n  includeDrafts?: boolean;\n}"
+        "decl": "export interface WixQueryEventsOptions {\n  /** Server-side WQL filter/sort for Events v3. Unlike the legacy convenience\n   * options below, these criteria are applied before paging. */\n  query?: { filter?: Record<string, unknown>; sort?: Array<{ fieldName: string; order: \"ASC\" | \"DESC\" }>; paging?: { limit?: number; offset?: number } };\n  /** Page size. */\n  limit?: number;\n  /** Page offset. */\n  offset?: number;\n  /** Status filter (e.g. `[\"SCHEDULED\"]`). Every entry must be a `WixEventStatus`; anything\n   * else is refused rather than quietly matching nothing — by the compiler for a typed caller,\n   * and at runtime for one that is not. Omitted → all statuses returned.\n   * There is no stored \"upcoming\" status; select future events by their start date.\n   * For a value the server accepts that `WixEventStatus` does not name, use `query.filter`,\n   * which is passed through to the server unchanged. */\n  statuses?: WixEventStatus[];\n  /** Sort property (the Owner list orders by \"start\"). */\n  order?: string;\n  /** Free-text title search. */\n  title?: string;\n  /** Include draft events in the result. */\n  includeDrafts?: boolean;\n}"
       },
       {
         "name": "decodeEvent",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wix/himalaya-cli",
-  "version": "0.899.0",
+  "version": "0.900.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": [
@@ -64,5 +64,5 @@
       "artifactId": "himalaya-cli"
     }
   },
-  "falconPackageHash": "47e91eec4e2d242f704df7f34e1fc4871c8e22cd0a1730de9561dd36"
+  "falconPackageHash": "da76e219579846bfb3438187f1efd8432fe18858acbbb9678699bd07"
 }