@smartico/public-api 0.0.438 → 0.0.439

package/dist/Missions/AchievementAvailabilityStatus.d.ts

@@ -10,8 +10,8 @@ export declare enum AchievementAvailabilityStatus {
     AvailableInactive = 1,
     /** Mission without date/time restrictions or with passed active from date, opt-in is required, user is opted-in or mission is unlocked*/
     AvailableActive = 2,
-    /** 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
     */
     UnavailableWithActiveFrom = 3,
     /** Mission with active till date defined, date is in future, and no opt-in required and mission is unlocked.

package/dist/Missions/UserAchievement.d.ts

@@ -31,6 +31,7 @@ export interface UserAchievement {
     related_games?: AchRelatedGame[];
     active_from_ts?: number;
     active_till_ts?: number;
+    activity_period_next_start_ts?: number;
     ach_categories?: number[];
     recurring_quantity?: number;
     completed_count?: number;

package/dist/WSAPI/WSAPIMissions.d.ts

@@ -50,6 +50,10 @@ export declare 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
@@ -68,7 +72,9 @@ export declare 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
@@ -378,8 +384,9 @@ export declare 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.

package/dist/WSAPI/WSAPITypes.d.ts

@@ -857,6 +857,8 @@ export interface TMissionOrBadge {
     active_from_ts: number;
     /** Holds time till mission will become unavailable, for the missions that are targeted to be available from specific date/time */
     active_till_ts: number;
+    /** Time (epoch ms) when a mission that is available only on some weekdays or days of the month opens next. Set only while the mission is outside its active days and is shown before it opens; absent when it is open now or has no such limit */
+    activity_period_next_start_ts?: number;
     /** The date when the mission was started, relevant for the time limited missions, also indicating opt-it date for mission that requires opt-in and unlock date for Locked mission. */
     dt_start: number;
     /** The progress of the mission in percents calculated as the aggregated relative percentage of all tasks */

package/dist/index.js

@@ -1281,8 +1281,8 @@ exports.AchievementAvailabilityStatus = void 0;
   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.
@@ -1382,6 +1382,10 @@ MissionUtils.getAvailabilityStatus = function (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 exports.AchievementAvailabilityStatus.UnavailableWithActiveFrom;
+  }
   var activeFrom = mission.active_from_ts ? _MissionUtils.getMs(mission.active_from_ts) : null;
   var activeTill = mission.active_till_ts ? _MissionUtils.getMs(mission.active_till_ts) : null;
   var startDate = mission.start_date_ts ? _MissionUtils.getMs(mission.start_date_ts) : null;
@@ -1680,6 +1684,7 @@ var UserAchievementTransform = function 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,
@@ -3457,6 +3462,10 @@ var WSAPIMissions = /*#__PURE__*/function (_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
@@ -3475,7 +3484,9 @@ var WSAPIMissions = /*#__PURE__*/function (_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
@@ -3823,8 +3834,9 @@ var WSAPIMissions = /*#__PURE__*/function (_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.