@windycom/plugin-devtools 1.0.9 → 3.0.0

package/types/client/d.ts.files/favs.d.ts

@@ -0,0 +1,69 @@
+import type { RouteType, StationId, Timestamp } from '@windy/types';
+import type { LatLon, Alert, AlertProps } from '@windy/interfaces';
+
+export type FavId = string;
+
+/** New fav type not including alerts */
+export type FavTypeNew = 'fav' | 'airport' | 'station' | 'webcam' | 'route';
+
+/** @deprecated Old fav type including alert that will be abandoned soon */
+export type FavType = FavTypeNew | 'alert';
+
+export type RouteAsString = `${RouteType}/${string}`;
+
+export type FavFragment =
+    | (LatLon & {
+          /** Title of the fav */
+          title: string;
+      }) &
+          (
+              | { type: 'fav' }
+
+              /** @deprecated use till migration of alerts is in process */
+              | {
+                    type: 'alert';
+                    alert: Alert;
+                    alertProps: AlertProps;
+                }
+
+              /** Airport ICAO code in case of airport */
+              | { type: 'airport'; icao: string }
+
+              /** Weather station ID (if WX station) */
+              | { type: 'station'; stationId: StationId }
+              | { type: 'webcam'; webcamId: number }
+              | { type: 'route'; route: RouteAsString }
+          );
+
+export type Fav = FavFragment & {
+    /** Unique mongoDb ID of item */
+    id: FavId;
+
+    /**
+     * If user wants to pin to top this fav, this timestamp enable us to sort all the favs
+     * so the last pinned is on top
+     */
+    pin2top?: Timestamp | null;
+
+    /**
+     * If user wants to pin to homepage this fav, this timestamp enable us to sort all the favs
+     * so the last pinned is first in line
+     */
+    pin2homepage?: Timestamp | null;
+
+    /**
+     * Timestamp when the item has been updated for the last time. It is used for updating items on all devices (the most up-to-date wins)
+     */
+    updated: Timestamp;
+};
+
+export type ObsoleteFav = FavFragment & {
+    key: string;
+};
+
+export type FavQuery =
+    | { webcamsId: number }
+    | { stationId: StationId }
+    | { icao: string }
+    | { type: FavType }
+    | { title: string };

package/types/client/d.ts.files/incomingMessages.d.ts

@@ -53,10 +53,6 @@ export interface QueryStringEmbedParams {
     product?: Products;
     showDetail: boolean;
     showMarker: boolean;
-    /**
-     * @deprecated Only used for query string of type=alert
-     */
-    timestamps?: string;
     type: 'map' | 'alert' | 'forecast';
     zoom: number;
 }

package/types/client/d.ts.files/notifications.d.ts

@@ -1,8 +1,8 @@
 import { QueryStringSource } from '@windy/http.d';
 
 export interface NotifHttpQsOptions extends QueryStringSource {
-    pageSize: number;
-    current: number;
+    pageSize?: number;
+    current?: number;
     markAsViewed?: boolean;
 }
 

package/types/client/d.ts.files/plugin-params.d.ts

@@ -1,10 +1,7 @@
-import { OpenOptions } from '@capacitor/browser';
-import { PublicationParams } from '@plugins/articles/articles.d';
-import { FavEventTypes } from '@plugins/favs/favs.d';
-import { ProviderConstructorParams } from '@plugins/_shared/subscription-services/subscription-services.d';
+import { Fav, FavId } from '@windy/favs.d';
+import { StartupArticleData, WhatsNewData } from '@windy/startup.d';
 import { HiddenReasonType, ReasonTypes } from '@plugins/subscription/subscription';
 import { FullRenderParameters } from '@windy/Layer.d';
-import { WebcamCategoryType } from '@windy/Webcams.d';
 import { HttpPayload } from '@windy/http.d';
 import {
     CapAlertHeadline,
@@ -12,8 +9,6 @@ import {
     HomeLocation,
     LatLon,
     PickerCoords,
-    SavedAlertFav,
-    SavedFav,
     SummaryDataHash,
     WeatherDataPayload,
 } from '@windy/interfaces.d';
@@ -23,8 +18,10 @@ import {
     DetailDisplayType,
     RouteType,
     StationOrPoiType,
-    type ExternalPluginIdent,
+    ExternalPluginIdent,
+    type Timestamp,
 } from '@windy/types.d';
+import { WebcamCategoryType } from '@windy/webcams';
 
 /**
  * Type of source event, that led to opening any plugin
@@ -33,12 +30,12 @@ export type PluginOpenEventSource =
     | 'contextmenu'
     | 'hp'
     | 'url'
-    | 'sigleclick'
     | 'poi-icon'
     | 'search'
     | 'detail'
     | 'singleclick'
     | 'favs-page'
+    | 'favs-on-hp'
     | 'picker'
     | 'meta'
     | 'fallback'
@@ -48,6 +45,7 @@ export type PluginOpenEventSource =
     | 'api'
     | 'last'
     | 'back-button'
+    | 'other'
     | 'label';
 
 export interface PluginSource {
@@ -55,7 +53,7 @@ export interface PluginSource {
     poiType?: StationOrPoiType | Pois | 'stations';
 }
 
-interface DetailOpenParams extends PluginSource, LatLon {
+export interface DetailOpenParams extends PluginSource, LatLon {
     /**
      * How to display detail
      */
@@ -82,16 +80,15 @@ interface DetailOpenParams extends PluginSource, LatLon {
     sourceEl?: HTMLElement;
 
     /**
-     * Detail was opened by clicking on Alert neotification so detail table should be scrolled to
+     * Detail was opened by clicking on Alert notification so detail table should be scrolled to
      * particular timestamp
      */
     moveToTimestamp?: boolean;
 
     /**
-     * Array of times, when Alert was triggered in a form of 897987987,098908089,09809098
-     * where numbers are timestamps / tsHour
+     * Array of timestamp, when Alert was triggered
      */
-    hrTimestamps?: string;
+    timestamps?: Timestamp[] | null;
 }
 
 type WebcamDetailOpenParams =
@@ -101,8 +98,9 @@ type WebcamDetailOpenParams =
     | undefined;
 
 type RplannerDistanceParams =
+    | { view: RouteType; coords: string; id: FavId; isFav: true } // Opening from favourites
     | { view?: RouteType; coords: string; id?: string } // Opening from URL
-    | SavedFav
+    | Fav
     // | RplannerOpeningAsFavs // Clicking on route stored as fav
     | LatLon[] // User puts two airports is search bar
     | (LatLon & {
@@ -124,27 +122,16 @@ export type PluginsOpenParams = {
     detail: DetailOpenParams;
     picker: PickerOpenParams;
     'picker-mobile': PickerOpenParams;
-    favs:
-        | (PluginSource & {
-              msg?: FavEventTypes;
-          })
-        | undefined;
-
-    station: PluginSource & { id?: string; stationId?: string };
+    favs: PluginSource & { importObsoleteFavs?: boolean };
+    station: PluginSource & { id: string };
     multimodel: LatLon & PluginSource & { name?: string | null };
     webcams: (PluginSource & { category: WebcamCategoryType }) | undefined;
     'webcams-detail': PluginSource & WebcamDetailOpenParams;
     'webcams-edit': PluginSource & WebcamDetailOpenParams;
-    'webcams-embed':
-        | PluginSource & {
-              id: string | number;
-              forcedPois?: boolean;
-          };
     'webcams-remove': PluginSource & WebcamDetailOpenParams;
     //settings: (PluginSource & { id: string }) | undefined;
-    settings: (PluginSource & { section?: 'notificationPreferences' }) | undefined;
-    articles: (PluginSource & { id: number }) | (PluginSource & PublicationParams) | undefined;
-    'article-publisher': (PluginSource & { pane?: '' | 'list' | 'detail' }) | null;
+    settings: PluginSource | undefined;
+    articles: (PluginSource & { id: number | string }) | undefined;
     upload: PluginSource & { id: string };
     uploader: PluginSource & { id?: string };
     'cap-alert': PluginSource &
@@ -157,32 +144,27 @@ export type PluginsOpenParams = {
     contextmenu: PluginSource & LatLon & { containerPoint?: L.Point };
     subscription:
         | (PluginSource & {
-              fscNext?: string;
               promote?: ReasonTypes | HiddenReasonType;
               pendingError?: Error & { responseText: string };
           })
         | undefined;
-    alerts:
-        | (PluginSource & {
-              id?: string;
-              name?: string;
-              title?: string;
-              action?: 'new';
-              lat?: string | number;
-              lon?: string | number;
-          })
-        | (PluginSource & SavedAlertFav);
+    'alerts-edit': PluginSource &
+        (
+            | { action: 'edit'; id: string }
+            | { action: 'migration'; favId: string }
+            | {
+                  action: 'new';
+                  lat: number;
+                  lon: number;
+                  locationName?: string;
+              }
+        );
+    alerts: PluginSource & {
+        message?: string;
+    };
     distance: PluginSource & RplannerDistanceParams;
     rplanner: PluginSource & RplannerDistanceParams;
-    airport: PluginSource & {
-        // Airport plugin can receive ICAO code as id || icao property
-        icao?: string;
-        id?: string;
-    };
-    'save-password': PluginSource & {
-        username: string;
-        password: string;
-    };
+    airport: PluginSource & { id: string };
     share: undefined;
     'nearest-stations': PluginSource & LatLon & { compactVersion?: boolean; includeAirq?: boolean };
     'nearest-airq': PluginSource & LatLon;
@@ -191,13 +173,12 @@ export type PluginsOpenParams = {
     'external-plugins':
         | (PluginSource & { id?: string; qs?: PluginsQsParams['external-plugins'] })
         | undefined;
-    browser: PluginSource & {
-        options: OpenOptions;
-        onFinished?: () => void;
-    };
     sounding: PluginSource & LatLon & { name?: string };
     radiosonde: PluginSource & { id: string; lat?: number; lon?: number };
-    'hp-weather': PluginSource & {
+    startup: PluginSource;
+    'startup-whats-new': PluginSource & { data: WhatsNewData };
+    'startup-articles': PluginSource & { data: StartupArticleData[] };
+    'startup-weather': PluginSource & {
         coords: HomeLocation | GeolocationInfo;
         promises: {
             wx: Promise<HttpPayload<WeatherDataPayload<SummaryDataHash>>>;
@@ -218,10 +199,16 @@ export type PluginsOpenParams = {
               showSystemDialog?: boolean;
           })
         | undefined;
-    offline: PluginSource;
+    'location-permission':
+        | (PluginSource & {
+              resolve?: (value: boolean | PromiseLike<boolean>) => void;
+          })
+        | undefined;
     'developer-mode': (PluginSource & { qs: Record<string, string> | undefined }) | undefined;
     'windy-external-plugin': PluginSource & LatLon;
-    menu: PluginSource;
+    menu: PluginSource & { scrollTo?: 'pois' };
+    onboarding: (PluginSource & { getUserInterests?: boolean }) | undefined;
+    'heatmaps-redirect': PluginSource & { id?: string };
 } & {
     [external: ExternalPluginIdent]:
         | (PluginSource & { query: Record<string, string> | undefined })
@@ -230,7 +217,6 @@ export type PluginsOpenParams = {
 } & { [others: string]: undefined };
 
 export type PluginsQsParams = {
-    subscription: ProviderConstructorParams | undefined;
     'external-plugins': Record<string, string> | undefined;
     'developer-mode': Record<string, string> | undefined;
     detail: { hrTimestamps?: string; name?: string; moveToTimestamp?: string };

package/types/client/d.ts.files/plugins.d.ts

@@ -1,52 +1,45 @@
-import { BottomTagPlugin } from '@windy/BottomTagPlugin';
+import { BottomSveltePlugin } from '@windy/BottomSveltePlugins';
 import { Plugin } from '@windy/Plugin';
 import { SveltePanePlugin } from '@windy/SveltePanePlugin';
 import { SveltePlugin } from '@windy/SveltePlugin';
 import { TagPlugin } from '@windy/TagPlugin';
 
-export interface BottomTagPlugins {
-    accumulations: BottomTagPlugin<'accumulations'>;
-    radar: BottomTagPlugin<'radar'>;
-    satellite: BottomTagPlugin<'satellite'>;
-    'cap-alerts': BottomTagPlugin<'cap-alerts'>;
-    'day-switcher': BottomTagPlugin<'day-switcher'>;
+export interface BottomSveltePlugins {
+    'mobile-calendar'?: BottomSveltePlugin<'mobile-calendar'>;
+    'progress-bar'?: BottomSveltePlugin<'progress-bar'>;
 
-    // mobile only, not embed
-    'mobile-calendar'?: BottomTagPlugin<'mobile-calendar'>;
-
-    // embed or desktop only
-    'progress-bar'?: BottomTagPlugin<'progress-bar'>;
+    'day-switcher': BottomSveltePlugin<'day-switcher'>;
+    'cap-alerts': BottomSveltePlugin<'cap-alerts'>;
+    accumulations: BottomSveltePlugin<'accumulations'>;
 }
 
 export interface SveltePanePlugins {
     favs: SveltePanePlugin<'favs'>;
+    'alerts-edit': SveltePanePlugin<'alerts-edit'>;
     alerts: SveltePanePlugin<'alerts'>;
     colors: SveltePanePlugin<'colors'>;
     articles: SveltePanePlugin<'articles'>;
-
     debug: SveltePanePlugin<'debug'>;
     hurricanes: SveltePanePlugin<'hurricanes'>;
     'cap-alert': SveltePanePlugin<'cap-alert'>;
-    login: SveltePanePlugin<'login'>;
     'delete-info': SveltePanePlugin<'delete-info'>;
     settings: SveltePanePlugin<'settings'>;
     sounding: SveltePanePlugin<'sounding'>;
     radiosonde: SveltePanePlugin<'radiosonde'>;
     airport: SveltePanePlugin<'airport'>;
     info: SveltePanePlugin<'info'>;
-
     webcams: SveltePanePlugin<'webcams'>;
     'webcams-detail': SveltePanePlugin<'webcams-detail'>;
     'webcams-add': SveltePanePlugin<'webcams-add'>;
     'webcams-edit': SveltePanePlugin<'webcams-edit'>;
     'webcams-remove': SveltePanePlugin<'webcams-remove'>;
-    'webcams-embed': SveltePanePlugin<'webcams-embed'>;
 
     uploader?: SveltePanePlugin<'uploader'>;
     'external-plugins'?: SveltePanePlugin<'external-plugins'>;
 }
 
 export interface SveltePlugins {
+    login: SveltePlugin<'login'>;
     'nearest-webcams': SveltePlugin<'nearest-webcams'>;
     'nearest-webcams-mobile': SveltePlugin<'nearest-webcams-mobile'>;
     'nearest-airq': SveltePlugin<'nearest-airq'>;
@@ -55,25 +48,43 @@ export interface SveltePlugins {
     multimodel: SveltePlugin<'multimodel'>;
     subscription: SveltePlugin<'subscription'>;
     'pending-subscription': SveltePlugin<'pending-subscription'>;
-    'whats-new': SveltePlugin<'whats-new'>;
-    offline: SveltePlugin<'offline'>;
     detail: SveltePlugin<'detail'>;
     station: SveltePlugin<'station'>;
     consent: SveltePlugin<'consent'>;
     rplanner: SveltePlugin<'rplanner'>;
     menu: SveltePlugin<'menu'>;
+    'fav-alert-menu': SveltePlugin<'fav-alert-menu'>;
+    radar: SveltePlugin<'radar'>;
+    satellite: SveltePlugin<'satellite'>;
+    'radar-plus': SveltePlugin<'radar-plus'>;
+    'map-selector': SveltePlugin<'map-selector'>;
 
     // Mobile/desktop only plugins
     distance?: SveltePlugin<'distance'>;
-    'article-publisher'?: SveltePlugin<'article-publisher'>;
-    'beta-test'?: SveltePlugin<'beta-test'>;
     'watch-faces'?: SveltePlugin<'watch-faces'>;
     'app-review-dialog'?: SveltePlugin<'app-review-dialog'>;
+    widgets?: SveltePlugin<'widgets'>;
     'fav-layers'?: SveltePlugin<'fav-layers'>;
+    onboarding?: SveltePlugin<'onboarding'>;
     'developer-mode'?: SveltePlugin<'developer-mode'>;
+    'pin-to-homepage'?: SveltePlugin<'pin-to-homepage'>;
+    'startup-whats-new'?: SveltePlugin<'startup-whats-new'>;
+    'rhpane-top': SveltePlugin<'rhpane-top'>;
+    rhbottom?: SveltePlugin<'rhbottom'>;
+    'location-permission'?: SveltePlugin<'location-permission'>;
+
+    'startup-weather'?: SveltePlugin<'startup-weather'>;
+    'mobile-ui'?: SveltePlugin<'mobile-ui'>;
+    'embed-ui'?: SveltePlugin<'embed-ui'>;
+    contextmenu?: SveltePlugin<'contextmenu'>;
+    upload: SveltePlugin<'upload'>;
+    screenshot: SveltePlugin<'screenshot'>;
+    search: SveltePlugin<'search'>;
+    'startup-articles'?: SveltePlugin<'startup-articles'>;
+    'picker-mobile'?: SveltePlugin<'picker-mobile'>; // to Svelte plugin
 
     // Used as fake plugin for any other external plugin
-    // basically we are unalble to type each individual external plugin
+    // basically we are unable to type each individual external plugin
     'windy-external-plugin'?: SveltePlugin<'windy-external-plugin'>;
 }
 
@@ -81,41 +92,15 @@ export interface PlainPlugins {
     'gl-particles': Plugin<'gl-particles'>;
     'legacy-tile-render': Plugin<'legacy-tile-render'>;
     particles: Plugin<'particles'>;
+    isolines: Plugin<'isolines'>;
 }
 
 export interface TagPlugins {
-    /**
-     * Libraries with possible CSS, that remains opened
-     */
-    'rhpane-top': TagPlugin<'rhpane-top'>;
-    rhbottom: TagPlugin<'rhbottom'>;
-    patch: TagPlugin<'patch'>;
+    // These plugins have css only (no html)
     'poi-libs': TagPlugin<'poi-libs'>;
-
-    /**
-     * Tag Plugins
-     */
-    'fav-alert-menu': TagPlugin<'fav-alert-menu'>;
-    upload: TagPlugin<'upload'>;
-    screenshot: TagPlugin<'screenshot'>;
-    isolines: TagPlugin<'isolines'>;
-    search: TagPlugin<'search'>;
-
-    // not embed plugins
-    'hp-weather'?: TagPlugin<'hp-weather'>;
-
-    // desktop only plugins
-    contextmenu?: TagPlugin<'contextmenu'>;
     picker?: TagPlugin<'picker'>;
     globe?: TagPlugin<'globe'>;
-
-    // mobile only plugins
-    'picker-mobile'?: TagPlugin<'picker-mobile'>;
-    'promo-mobile-intro'?: TagPlugin<'promo-mobile-intro'>;
-    profile?: TagPlugin<'profile'>;
-    'save-password'?: TagPlugin<'save-password'>;
-    browser?: TagPlugin<'browser'>;
-    'map-selector'?: TagPlugin<'map-selector'>;
+    'heatmaps-redirect': TagPlugin<'heatmaps-redirect'>;
 }
 
 export interface Plugins
@@ -123,10 +108,10 @@ export interface Plugins
         SveltePlugins,
         SveltePanePlugins,
         PlainPlugins,
-        BottomTagPlugins {}
+        BottomSveltePlugins {}
 
 export interface WindowPlugins
     extends TagPlugins,
         SveltePlugins,
         SveltePanePlugins,
-        BottomTagPlugins {}
+        BottomSveltePlugins {}

package/types/client/d.ts.files/pois.d.ts

@@ -1,6 +1,6 @@
 import type { DataSpecifications } from '@windy/dataSpecifications.d';
 import type { Pois } from '@windy/rootScope.d';
-import type { LoadedTranslations } from '@windy/trans.d';
+import type { LoadedTranslations } from '@windy/types';
 
 export type PoisCheckboxeDef = {
     checkboxTranslation?: keyof LoadedTranslations;

package/types/client/d.ts.files/products.d.ts

@@ -1,30 +1,43 @@
+import { AccessProduct, AccessCProduct } from '@windy/AccessProducts';
 import { AromeProduct } from '@windy/AromeProduct';
 import { EcmwfAnalysisProduct } from '@windy/EcmwfAnalysisProduct';
 import { EcmwfProduct } from '@windy/EcmwfProduct';
 import { Product } from '@windy/Product';
+import { RadarPlusProduct } from '@windy/RadarPlusProduct';
 import { SatelliteProduct } from '@windy/SatelliteProduct';
+
 import { Products } from '@windy/rootScope.d';
 
 export type products = Implements<
     { [P in Products]: Product },
     {
-        bomAccess: Product;
+        bomAccess: AccessProduct;
+        bomAccessAd: AccessCProduct;
+        bomAccessBn: AccessCProduct;
+        bomAccessDn: AccessCProduct;
+        bomAccessNq: AccessCProduct;
+        bomAccessPh: AccessCProduct;
+        bomAccessSy: AccessCProduct;
+        bomAccessVt: AccessCProduct;
         mblue: Product;
         ecmwf: EcmwfProduct;
         ecmwfWaves: Product;
         ecmwfAnalysis: EcmwfAnalysisProduct;
+        canHrdps: Product;
+        canRdwpsWaves: Product;
         cams: Product;
         camsEu: Product;
         cmems: Product;
+        czeAladin: Product;
         gfs: Product;
         gfsWaves: Product;
         icon: Product;
         iconD2: Product;
         iconEu: Product;
         iconEuWaves: Product;
-        iconWaves: Product;
         arome: Product;
         aromeAntilles: AromeProduct;
+        aromeFrance: AromeProduct;
         aromeReunion: AromeProduct;
         nems: Product;
         namAlaska: Product;
@@ -34,11 +47,15 @@ export type products = Implements<
         efi: Product;
         radar: Product;
         satellite: SatelliteProduct;
+        radarPlus: RadarPlusProduct;
         hrrrAlaska: Product;
         hrrrConus: Product;
         ukv: Product;
         drought: Product;
         fireDanger: Product;
         activeFires: Product;
+        jmaMsm: Product;
+        jmaCwmWaves: Product;
+        topoMap: Product;
     }
 >;

package/types/client/d.ts.files/rootScope.d.ts

@@ -2,8 +2,6 @@ export type Levels = typeof import('./rootScope').levels[number];
 
 export type Overlays = typeof import('./rootScope').overlays[number];
 
-export type AcTimes = typeof import('./rootScope').acTimes[number];
-
 export type LocalProducts = typeof import('./rootScope').localProducts[number];
 
 export type GlobalProducts = typeof import('./rootScope').globalProducts[number];
@@ -22,22 +20,6 @@ export type Products = typeof import('./rootScope').products[number];
 
 export type SupportedLanguages = typeof import('./rootScope').supportedLanguages[number];
 
-export type Pois =
-    | 'favs'
-    | 'cities'
-    | 'wind'
-    | 'temp'
-    | 'precip'
-    | 'metars'
-    | 'radiosonde'
-    | 'cams'
-    | 'pgspots'
-    | 'kitespots'
-    | 'surfspots'
-    | 'tide'
-    | 'radiation'
-    | 'firespots'
-    | 'airq'
-    | 'empty';
-
-export type Isolines = 'off' | 'pressure' | 'gh' | 'temp' | 'deg0';
+export type Pois = keyof typeof import('./rootScope').pois;
+
+export type Isolines = typeof import('./rootScope').isolinesType[number];

package/types/client/d.ts.files/satellite.d.ts

@@ -42,6 +42,7 @@ export interface SatelliteInfoJson {
 
     // content added during processing:
     hash: number;
+    // time interval for archive
     minDateTs: number;
     maxDateTs: number;
 

package/types/client/d.ts.files/startup.d.ts

@@ -0,0 +1,59 @@
+import type { RelatedHomepageArticlesResponseDto } from '@plugins/articles/articles.d';
+import type { Timestamp } from '@windy/types';
+
+export type StartupNewsType = 'hp-article' | 'whats-new';
+
+export interface StartupItem {
+    type: StartupNewsType;
+}
+
+export interface StartupResponse {
+    'hp-articles'?: StartupArticleData[];
+    'whats-new'?: WhatsNewData;
+}
+
+export interface StartupArticleData extends RelatedHomepageArticlesResponseDto, StartupItem {
+    type: 'hp-article';
+}
+
+export interface WhatsNewData extends StartupItem {
+    type: 'whats-new';
+    id: string;
+    title: string;
+    contributors: {
+        name: string;
+        avatarUrl: string;
+    }[];
+    content: {
+        new?: string;
+        improved?: string;
+        fixed?: string;
+    };
+}
+
+export interface EnhancedStartupArticle extends StartupArticleData {
+    key: string;
+    count: number;
+    lastDisplayed: number;
+}
+
+/**
+ * Info about articles, user has already seen
+ */
+export interface SeenArticle {
+    /**
+     * Last time, the article has been displayed to the user
+     */
+    lastDisplayed: Timestamp;
+
+    /**
+     * How many times the article has been seen
+     * (one count is added only if the article has been seen after 12 hours from the last seen time)
+     */
+    count: number;
+
+    /**
+     * Marks beginning of 12h interval
+     */
+    seen: Timestamp;
+}