@smartico/public-api 0.0.438 → 0.0.440

package/dist/index.modern.mjs

@@ -364,6 +364,7 @@ var SAWGameType;
   SAWGameType[SAWGameType["Plinko"] = 11] = "Plinko";
   SAWGameType[SAWGameType["CoinFlip"] = 12] = "CoinFlip";
   SAWGameType[SAWGameType["CustomMinigame"] = 13] = "CustomMinigame";
+  SAWGameType[SAWGameType["Bingo"] = 14] = "Bingo";
 })(SAWGameType || (SAWGameType = {}));
 var SAWGameTypeName;
 (function (SAWGameTypeName) {
@@ -380,6 +381,7 @@ var SAWGameTypeName;
   SAWGameTypeName["Plinko"] = "plinko";
   SAWGameTypeName["CoinFlip"] = "coin_flip";
   SAWGameTypeName["CustomMinigame"] = "custom_minigame";
+  SAWGameTypeName["Bingo"] = "bingo";
   SAWGameTypeName["Unknown"] = "unknown";
 })(SAWGameTypeName || (SAWGameTypeName = {}));
 /** @hidden */
@@ -397,7 +399,8 @@ const SAWGameTypeNamed = type => {
     [SAWGameType.Voyager]: SAWGameTypeName.Voyager,
     [SAWGameType.Plinko]: SAWGameTypeName.Plinko,
     [SAWGameType.CoinFlip]: SAWGameTypeName.CoinFlip,
-    [SAWGameType.CustomMinigame]: SAWGameTypeName.CustomMinigame
+    [SAWGameType.CustomMinigame]: SAWGameTypeName.CustomMinigame,
+    [SAWGameType.Bingo]: SAWGameTypeName.Bingo
   }[type] || SAWGameTypeName.Unknown;
 };
 
@@ -1255,8 +1258,8 @@ var AchievementAvailabilityStatus;
   AchievementAvailabilityStatus[AchievementAvailabilityStatus["AvailableInactive"] = 1] = "AvailableInactive";
   /** Mission without date/time restrictions or with passed active from date, opt-in is required, user is opted-in or mission is unlocked*/
   AchievementAvailabilityStatus[AchievementAvailabilityStatus["AvailableActive"] = 2] = "AvailableActive";
-  /** Mission with active from date defined, date is in future.
-   * Field: active_from_ts
+  /** Mission with active from date defined, date is in future, or a mission available only on some weekdays / days of the month that is outside its active days.
+   * Field: activity_period_next_start_ts when set (the time the mission opens next), otherwise active_from_ts
   */
   AchievementAvailabilityStatus[AchievementAvailabilityStatus["UnavailableWithActiveFrom"] = 3] = "UnavailableWithActiveFrom";
   /** Mission with active till date defined, date is in future, and no opt-in required and mission is unlocked.
@@ -1354,6 +1357,10 @@ MissionUtils.getAvailabilityStatus = mission => {
   if (!mission) {
     return null;
   }
+  // a mission available only on some weekdays / days of the month, currently outside them
+  if (mission.activity_period_next_start_ts && _MissionUtils.getMs(mission.activity_period_next_start_ts) > Date.now()) {
+    return AchievementAvailabilityStatus.UnavailableWithActiveFrom;
+  }
   const activeFrom = mission.active_from_ts ? _MissionUtils.getMs(mission.active_from_ts) : null;
   const activeTill = mission.active_till_ts ? _MissionUtils.getMs(mission.active_till_ts) : null;
   const startDate = mission.start_date_ts ? _MissionUtils.getMs(mission.start_date_ts) : null;
@@ -1648,6 +1655,7 @@ const UserAchievementTransform = items => {
       time_limit_ms: r.time_limit_ms,
       active_from_ts: r.active_from_ts,
       active_till_ts: r.active_till_ts,
+      activity_period_next_start_ts: r.activity_period_next_start_ts,
       dt_start: r.start_date_ts,
       reward: r.ach_public_meta.reward,
       progress: r.progress,
@@ -3323,6 +3331,10 @@ class WSAPIMissions extends WSAPIGeneral {
    * - `RECURRING` missions between cycles, until the next cycle starts.
    * - `RECURRING_QUANTITY` missions outside their `active_from_ts` /
    *   `active_till_ts` window.
+   * - Missions available only on some weekdays or days of the month, while
+   *   outside those days — unless the mission is configured to be shown
+   *   before it opens (then it arrives with `activity_period_next_start_ts`),
+   *   and always once it will not open again. Completed missions stay.
    *
    * Client-side filtering you may still want: missions with
    * `only_in_custom_section: true` are intended for their custom-section
@@ -3341,7 +3353,9 @@ class WSAPIMissions extends WSAPIGeneral {
    *    missions) at least one cycle done / the cap reached — see the recurring
    *    caveats below. Sort by `complete_date_ts` DESC.
    * 3. **Locked** — `is_locked === true`, OR not yet started
-   *    (`active_from_ts > Date.now()`). Sort by `position` ASC.
+   *    (`active_from_ts > Date.now()`), OR outside its active days
+   *    (`activity_period_next_start_ts > Date.now()` — show an "opens in"
+   *    countdown to it, and refetch when it elapses). Sort by `position` ASC.
    * 4. **In-progress** — `is_opted_in === true`, OR (no opt-in required and
    *    `progress > 0`). Sort by `position` ASC.
    * 5. **Available** — everything else (opt-in required but not yet joined, or
@@ -3666,8 +3680,9 @@ class WSAPIMissions extends WSAPIGeneral {
    *   means local mission state was stale (e.g. user opted in from another
    *   session/tab).
    * - `40013` — mission not opt-in-able: missing `requires_optin`, in
-   *   DRAFT/ARCHIVED state, or outside its `active_from_ts` /
-   *   `active_till_ts` window.
+   *   DRAFT/ARCHIVED state, outside its `active_from_ts` /
+   *   `active_till_ts` window, or outside its active weekdays / days of the
+   *   month (`activity_period_next_start_ts` is set).
    * - `40014` — mission is locked; user has unlock-tasks remaining.
    *   Surface the mission's `unlock_mission_description` to guide them.
    * - other non-zero — generic server error. Surface `err_message` if any.
@@ -6943,14 +6958,14 @@ class WSAPIMiniGames extends WSAPIRaffles {
    * substitution at fetch time.
    *
    * **Game-type variants**
-   * All twelve `SAWGameType` values (`SpinAWheel`, `ScratchCard`,
+   * All `SAWGameType` values (`SpinAWheel`, `ScratchCard`,
    * `MatchX`, `GiftBox`, `PrizeDrop`, `Quiz`, `LootboxWeekdays`,
    * `LootboxCalendarDays`, `TreasureHunt`, `Voyager`, `Plinko`,
-   * `CoinFlip`) surface through the same template shape. Most are
+   * `CoinFlip`, `CustomMinigame`, `Bingo`) surface through the same template shape. Most are
    * played via {@link playMiniGame}; the exceptions are:
    * - `PrizeDrop` — server-push only; the consumer does NOT call
    *   `playMiniGame`. Prizes arrive via the prize-drop push channel.
-   * - `MatchX` / `Quiz` — predictions are submitted via a separate
+   * - `MatchX` / `Quiz` / `Bingo` — predictions are submitted via a separate
    *   games server (not this SDK); the SAW spin is fired
    *   server-internally to deduct the buy-in.
    *
@@ -7116,7 +7131,7 @@ class WSAPIMiniGames extends WSAPIRaffles {
    * Works for all `SAWGameType` values EXCEPT:
    * - `PrizeDrop` — prizes arrive server-pushed; do NOT call
    *   `playMiniGame` for this type.
-   * - `MatchX` / `Quiz` — prediction submission goes through a
+   * - `MatchX` / `Quiz` / `Bingo` — prediction submission goes through a
    *   separate games server; `playMiniGame` is not the entry point.
    *
    * @remarks
@@ -8011,7 +8026,7 @@ class WSAPIAvatars extends WSAPIMiniGames {
 /** @group GamePick */
 class WSAPIGamePick extends WSAPIAvatars {
   /**
-   * Returns every open round for a MatchX or Quiz game template, with the full
+   * Returns every open round for a MatchX, Quiz or Bingo game template, with the full
    * event list (matches / questions) and the current user's selections per event.
    *
    * Use to power the rounds-lobby screen — typically a list of round cards a user
@@ -8021,7 +8036,7 @@ class WSAPIGamePick extends WSAPIAvatars {
    * @remarks
    * **Preconditions**
    * - User must be authenticated.
-   * - `saw_template_id` must reference a MatchX or Quiz game template. The SDK
+   * - `saw_template_id` must reference a MatchX, Quiz or Bingo game template. The SDK
    *   throws synchronously if it's missing.
    *
    * **Transport**
@@ -8054,7 +8069,7 @@ class WSAPIGamePick extends WSAPIAvatars {
    *
    * **UI guidance**: see [UI Guide — `gamePickGetActiveRounds`](../../docs/ui/gamepick/UIGuide_gamePickGetActiveRounds.md).
    *
-   * @param props.saw_template_id  ID of the MatchX or Quiz game template.
+   * @param props.saw_template_id  ID of the MatchX, Quiz or Bingo game template.
    * @returns Wrapped {@link GamesApiResponse} of {@link GamePickRound} array.
    *
    * @example
@@ -8079,7 +8094,7 @@ class WSAPIGamePick extends WSAPIAvatars {
   }
   /**
    * Returns a single round (events, user selections, scoring rules) for a
-   * MatchX or Quiz game. Use to power the round-detail / prediction-input
+   * MatchX, Quiz or Bingo game. Use to power the round-detail / prediction-input
    * screen the user lands on after picking a round from the lobby.
    *
    * Same shape as one entry of {@link gamePickGetActiveRounds}; cheaper when the
@@ -8111,7 +8126,7 @@ class WSAPIGamePick extends WSAPIAvatars {
    *
    * **UI guidance**: see [UI Guide — `gamePickGetActiveRound`](../../docs/ui/gamepick/UIGuide_gamePickGetActiveRound.md).
    *
-   * @param props.saw_template_id  ID of the MatchX or Quiz game template.
+   * @param props.saw_template_id  ID of the MatchX, Quiz or Bingo game template.
    * @param props.round_id         ID of the round to fetch.
    * @returns Wrapped {@link GamesApiResponse} of a single {@link GamePickRound}.
    *
@@ -8139,7 +8154,7 @@ class WSAPIGamePick extends WSAPIAvatars {
     return this.api.gpGetActiveRound(props.saw_template_id, props.round_id);
   }
   /**
-   * Returns the full round history (active + resolved) for a MatchX or Quiz game
+   * Returns the full round history (active + resolved) for a MatchX, Quiz or Bingo game
    * template, newest-first. Each round carries the user's predictions plus the
    * server-resolved outcome on each event.
    *
@@ -8173,7 +8188,7 @@ class WSAPIGamePick extends WSAPIAvatars {
    *
    * **UI guidance**: see [UI Guide — `gamePickGetHistory`](../../docs/ui/gamepick/UIGuide_gamePickGetHistory.md).
    *
-   * @param props.saw_template_id  ID of the MatchX or Quiz game template.
+   * @param props.saw_template_id  ID of the MatchX, Quiz or Bingo game template.
    * @returns Wrapped {@link GamesApiResponse} of {@link GamePickRound} array,
    * newest-first.
    *
@@ -8193,7 +8208,7 @@ class WSAPIGamePick extends WSAPIAvatars {
     return this.api.gpGetGamesHistory(props.saw_template_id);
   }
   /**
-   * Returns the leaderboard for a MatchX or Quiz game round — ranked list of
+   * Returns the leaderboard for a MatchX, Quiz or Bingo game round — ranked list of
    * players plus the current user's entry (`my_user`). Pass `round_id: -1` for
    * the season / overall leaderboard across every round in the template.
    *
@@ -8233,7 +8248,7 @@ class WSAPIGamePick extends WSAPIAvatars {
    *
    * **UI guidance**: see [UI Guide — `gamePickGetBoard`](../../docs/ui/gamepick/UIGuide_gamePickGetBoard.md).
    *
-   * @param props.saw_template_id  ID of the MatchX or Quiz game template.
+   * @param props.saw_template_id  ID of the MatchX, Quiz or Bingo game template.
    * @param props.round_id         Round ID, or `-1` for the season leaderboard.
    * @returns Wrapped {@link GamesApiResponse} of {@link GamePickRoundBoard}.
    *
@@ -8500,7 +8515,7 @@ class WSAPIGamePick extends WSAPIAvatars {
    *
    * **UI guidance**: see [UI Guide — `gamePickGetUserInfo`](../../docs/ui/gamepick/UIGuide_gamePickGetUserInfo.md).
    *
-   * @param props.saw_template_id  ID of the MatchX or Quiz game template.
+   * @param props.saw_template_id  ID of the MatchX, Quiz or Bingo game template.
    * @returns Wrapped {@link GamesApiResponse} of {@link GamePickUserInfo}.
    *
    * @example
@@ -8557,7 +8572,7 @@ class WSAPIGamePick extends WSAPIAvatars {
    *
    * **UI guidance**: see [UI Guide — `gamePickGetGameInfo`](../../docs/ui/gamepick/UIGuide_gamePickGetGameInfo.md).
    *
-   * @param props.saw_template_id  ID of the MatchX or Quiz game template.
+   * @param props.saw_template_id  ID of the MatchX, Quiz or Bingo game template.
    * @returns Wrapped {@link GamesApiResponse} of {@link GamePickGameInfo}.
    *
    * @example
@@ -8617,7 +8632,7 @@ class WSAPIGamePick extends WSAPIAvatars {
    *
    * **UI guidance**: see [UI Guide — `gamePickGetRoundInfoForUser`](../../docs/ui/gamepick/UIGuide_gamePickGetRoundInfoForUser.md).
    *
-   * @param props.saw_template_id  ID of the MatchX or Quiz game template.
+   * @param props.saw_template_id  ID of the MatchX, Quiz or Bingo game template.
    * @param props.round_id         ID of the round to inspect.
    * @param props.int_user_id      Internal user ID from
    *                                `gamePickGetBoard.users[].int_user_id`.