@windycom/plugin-devtools 1.0.9 → 3.0.0

package/types/interfaces.d.ts

@@ -3,19 +3,16 @@
  */
 import { Weekday } from '@windy/Calendar.d';
 import { ExtendedTileParams } from '@windy/DataTiler.d';
+import { FavId } from '@windy/favs';
 import { FullRenderParameters } from '@windy/Layer.d';
 import { Particles } from '@windy/Particles';
-import { PluginsOpenParams, type PluginsQsParams } from '@windy/plugin-params.d';
-import { Plugins } from '@windy/plugins.d';
 import {
-    AcTimes,
-    Isolines,
-    Levels,
-    Overlays,
-    PointProducts,
-    Products,
-    SupportedLanguages,
-} from '@windy/rootScope.d';
+    PluginsOpenParams,
+    type DetailOpenParams,
+    type PluginsQsParams,
+} from '@windy/plugin-params.d';
+import { Plugins } from '@windy/plugins.d';
+import { Isolines, Levels, Overlays, PointProducts, Products } from '@windy/rootScope.d';
 import {
     BatteryPreferences,
     CapAlertInfo,
@@ -24,27 +21,26 @@ import {
     DetailDisplayType,
     DetailRows,
     Directions,
-    FavType,
     GoogleServicesPreferences,
     GpsPreferences,
-    HTMLString,
     ISODateString,
-    LocationPrefecernces,
+    LocationPreferences,
     MeteogramLayers,
     MeteogramLevels,
-    NoticicationPrefecernces,
+    NotificationPreferences,
     NumOrNull,
     NumValue,
     Path,
     Pixel,
     Platform,
-    SearchType,
     StationOrPoiType,
     Timestamp,
     WidgetNotificationPreferences,
+    WidgetType,
     YearMonthDay,
+    type MigrationResult,
+    type SubTier,
 } from '@windy/types.d';
-import { ClientMessage } from '@plugins/offline/offline';
 
 export interface ExportedObj {
     default?: unknown;
@@ -125,8 +121,8 @@ export interface GeolocationInfo extends LatLon {
  * TODO: This is basically copied favorite
  */
 export interface HomeLocation extends LatLon {
+    id: FavId;
     title: string;
-    updated?: string;
 }
 
 export interface Alert {
@@ -167,6 +163,7 @@ export interface Alert {
     snow: {
         active: boolean;
         min: number;
+        max: number;
     };
 
     /**
@@ -176,6 +173,7 @@ export interface Alert {
     rain: {
         active: boolean;
         min: number;
+        max: number;
         hours: 3 | 6 | 12 | 24 | 48;
     };
 
@@ -255,142 +253,12 @@ export interface AlertProps {
     suspended?: boolean;
 }
 
-export interface Fav extends LatLon {
-    /** Unique ID of item */
-    id: string;
-
-    /* How many times was this item hit/used */
-    counter?: number;
-
-    /** Title of item */
-    title: string;
-
-    /** OBSOLETE DEPRACATED. Name was used till 2019, all should be refactored to `title` if it is safe */
-    name?: string;
-
-    /** Unique invented key, for access */
-    key?: string;
-
-    /** Type of item */
-    type: FavType | SearchType;
-
-    /** Airport ICAO code in case of airport */
-    icao?: string;
-
-    /** Weather station ID (if WX station) */
-    stationId?: string;
-
-    /** Webcam ID in case of webcam */
-    webcamId?: number;
-
-    /** For saved routes */
-    route?: string;
-}
-
-/** Search result payload as received from backend */
-export interface SearchResult extends Fav {
-    /** Localized Search result */
-    title: string;
-
-    /** Type of item */
-    type: SearchType;
-
-    /** Localized, human readable country name */
-    country?: string | null;
-
-    /** Lowercase ISO-2 CC */
-    cc?: string;
-
-    /** Localized, human readable region */
-    region?: string | null;
-
-    /** Localized, human readable state */
-    state?: string;
-
-    /** Stringified bounds of found item for case of island, country etc */
-    bounds?: string;
-
-    /**
-     * Added properties for purpose of recent searches
-     */
-
-    /** Creation date */
-    timestamp?: Timestamp;
-
-    /** Search query under which was item stored to recents */
-    query?: string;
-}
-
-export interface HttpSearchPayload {
-    header: {
-        type: 'search' | 'coordinates' | 'query-error' | '2airports';
-    };
-    data: SearchResult[];
-}
-
-export interface SavedFav extends Fav {
-    /** Title of item */
-    title: string;
-
-    /** Unique invented key, for access */
-    key: string;
-
-    /** Type of item */
-    type: FavType;
-
-    /** Alert settings (conditions, properties, ...) if any */
-    alert?: Alert;
-
-    /** Basic info about alert if any */
-    alertProps?: AlertProps;
-
-    /**
-     * Query params of the route needed for creating the route again
-     *
-     * @example car/50.43,21.49;48.14,20.61;49.18,21.41
-     */
-    route?: string;
-
-    /**
-     * 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;
-
-    overflowed?: boolean;
-
-    /** DEPRACATED !!! Use `title` instead. This property is presented only because of in localstorage saved old favs compatibility. */
-    name?: string;
-    /** Used for alerts to open slider on active timestamp */
-    moveToTimestamp?: boolean;
-}
-
-export interface UpcomingFav extends Fav {
-    // TODO - is it necessary? Isn't just some migration deprecated stuff?
-    name?: string;
-
-    /** Type of item */
-    type: FavType;
-
-    // TODO - is it necessary? Can unsaved fav has a route property?
-    route?: string;
-
-    // TODO - is it necessary? Can unsaved fav has an alert property?
-    alert?: Alert;
-
-    // TODO - is it necessary? Can unsaved fav has an updated property?
-    updated?: Timestamp;
-}
-
-export interface SavedAlertFav extends UpcomingFav {
-    _id?: string;
-    alert: Alert;
-}
-
 export interface WeatherParameters {
+    acRange: Timestamp;
     overlay: Overlays;
-    acTime: AcTimes;
     level: Levels;
-    isolines: Isolines;
+    isolinesType: Isolines;
+    isolinesOn: boolean;
     path: Path;
     product: Products;
 }
@@ -411,6 +279,8 @@ export interface LastSentDevice {
     platform: string;
     target: string;
     version: string;
+    subscription: SubTier;
+    cc: string;
     deactivated?: boolean;
     updated?: number;
     screen?: {
@@ -430,7 +300,7 @@ export interface Bounds {
 }
 
 /**
- * Leflet's tilePoint
+ * Leaflet's tilePoint
  */
 export interface TilePoint {
     x: number;
@@ -448,7 +318,7 @@ export interface Celestial {
     TZabbrev: string;
 
     /**
-     * Time zone name (for instance 'Europe/Luxemburg)
+     * Time zone name (for instance 'Europe/Luxembourg)
      */
     TZname: string;
 
@@ -468,12 +338,12 @@ export interface Celestial {
     TZoffsetMin: number;
 
     /**
-     * Type of TZ type t..terrestial, n..nautical
+     * Type of TZ type t..terrestrial, n..nautical
      */
     TZtype: 't' | 'n';
 
     /**
-     * Determines propability if the location is at sea or not as number from 1..0
+     * Determines probability if the location is at sea or not as number from 1..0
      */
     atSea: number;
 
@@ -494,7 +364,7 @@ export interface Celestial {
     night: ISODateString;
 
     /**
-     * Monet when, the data object was creted (for check of being obsolete)
+     * Monet when, the data object was created (for check of being obsolete)
      */
     nowObserved: ISODateString;
 
@@ -507,26 +377,36 @@ export interface Celestial {
 /**
  * Summary day as received from backend
  */
-export interface SummaryDay {
+export interface CalendarSummaryDay {
     /**
      * Identifier of the day
      */
     date: YearMonthDay;
 
     /**
-     * Day of the molnth (starting with 1)
+     * Day of the month (starting with 1)
      */
     day: number;
 
     /**
-     * Weather icon identifier (legacy version)
+     * Timestamp of midnight when the segment starts
      */
-    icon: number;
+    timestamp: Timestamp;
+
+    /**
+     * Translation string for weekday
+     */
+    weekday: Weekday;
+}
 
+/**
+ * Summary day as received from backend
+ */
+export interface SummaryDay extends CalendarSummaryDay {
     /**
      * Weather icon identifier
      */
-    icon2: number;
+    icon: number;
 
     /**
      * At which index, in the data table, the day starts
@@ -548,16 +428,6 @@ export interface SummaryDay {
      */
     tempMin: NumValue;
 
-    /**
-     * Timestamp of midnight when the segment starts
-     */
-    timestamp: Timestamp;
-
-    /**
-     * Translation string for weekday
-     */
-    weekday: Weekday;
-
     /**
      * Mean/Average Wind force
      */
@@ -569,9 +439,15 @@ export interface SummaryDay {
     windDir: NumValue;
 
     /**
-     * CAP Alert warning identifier as teo letter designstor
+     * CAP Alert warning identifier as two letter designator
      */
     warning?: string;
+
+    /**
+     * Indicates that these data are fake, just for purpose to
+     * show non-premium users how the extended fcst looks like
+     */
+    isFake?: boolean;
 }
 
 /**
@@ -584,7 +460,7 @@ export interface SummaryDataHash {
     mm: NumValue[];
 
     /**
-     * Is the preciptitaion in a form fo snow?
+     * Is the precipitation in a form fo snow?
      */
     snow: (1 | 0)[];
 
@@ -636,31 +512,16 @@ export interface DataHash extends SummaryDataHash, IsDay {
      */
     hour: number[];
 
-    /**
-     * Weather icon identifier (legacy version)
-     */
-    icon: number[];
-
     /**
      * Weather icon identifier
      */
-    icon2: number[];
+    icon: number[];
 
     /**
      * Moon phase icon identifier
      */
     moonPhase: number[];
 
-    /**
-     * Date of segment beggining
-     */
-    origDate: ISODateString[];
-
-    /**
-     * TS of segment beggining (seems same as ts)
-     */
-    origTs: Timestamp[];
-
     /**
      * ?????
      */
@@ -756,6 +617,11 @@ export interface DataHash extends SummaryDataHash, IsDay {
 
     turbulence?: NumValue[];
     icing?: NumValue[];
+
+    /**
+     * Indicates, that these data are fake, just for purpose to show non-premium users how the extended fcst looks like
+     */
+    isFake?: boolean[];
 }
 
 /**
@@ -763,7 +629,7 @@ export interface DataHash extends SummaryDataHash, IsDay {
  * Strict means the extension has to be from both sides.
  *
  * @example
- * PickDataHashPropsByType<string[]> = { date: ..., origDate: ..., weathercode: ... };
+ * PickDataHashPropsByType<string[]> = { date: ..., weathercode: ... };
  * PickDataHashPropsByType<string, false> even with `warnings`, because the could be undefined and undefined does not extend number[]
  */
 export type PickDataHashPropsByType<U, Strict = true> = Pick<
@@ -808,7 +674,7 @@ export interface NodeForecastHeader {
     /**
      * Number of available days in forecast
      */
-    daysAvail?: number;
+    daysAvail: number;
 
     /**
      * Served model
@@ -880,7 +746,7 @@ export interface NodeForecastHeader {
     /**
      * Elevation of model grid
      */
-    modelElevation: number;
+    modelElevation?: number;
 
     /**
      * UTC offset in hours
@@ -893,6 +759,18 @@ export interface NodeForecastHeader {
     sst?: number;
 }
 
+/**
+ * Forecasted weather data for NOW
+ */
+
+export interface WeatherDataNow {
+    icon: number;
+    temp: NumValue;
+    wind: NumValue;
+    windDir: NumValue;
+    moonPhase: NumValue;
+}
+
 /**
  * Weather data or Summary Weather data JSON as received from node-forecast
  */
@@ -901,19 +779,11 @@ export interface WeatherDataPayload<T extends DataHash | SummaryDataHash> {
     celestial: Celestial;
     summary: Record<YearMonthDay, SummaryDay>;
     data: T;
-    now?: T extends SummaryDataHash
-        ? {
-              icon: number;
-              temp: NumValue;
-              wind: NumValue;
-              windDir: NumValue;
-              moonPhase: NumValue;
-          }
-        : never;
+    now?: T extends SummaryDataHash ? WeatherDataNow : never;
 }
 
 /**
- * Minimsl rqrd options for RendererWeatherTable
+ * Minimal required options for RendererWeatherTable
  */
 export interface WeatherTableRenderingOptions {
     /**
@@ -970,15 +840,17 @@ export interface WeatherTableRenderingOptions {
      * Surface sea temperature if available
      */
     sst?: number;
-}
 
-// TS cannot extend from [] syntax, just create proxy type and use it in the next line
-type DetailPluginOpenParams = PluginsOpenParams['detail'];
+    /**
+     * Should backend interpolate values for 1h step
+     */
+    interpolate?: boolean;
+}
 
 /**
- * Parametrs used for displaying detail (poinr forecast)
+ * Parameters used for displaying detail (point forecast)
  */
-export interface DetailParams extends DetailPluginOpenParams, WeatherTableRenderingOptions {
+export interface DetailParams extends DetailOpenParams, WeatherTableRenderingOptions {
     display: DetailDisplayType;
     /**
      * Which kind of action led to displaying the detail
@@ -1019,12 +891,12 @@ export interface DetailParams extends DetailPluginOpenParams, WeatherTableRender
     id?: string;
 
     /**
-     * height of temperature bacground canvas
+     * height of temperature background canvas
      */
     tempBgH?: Pixel;
 
     /**
-     * Always incrementing synchornization number, that enables
+     * Always incrementing synchronization number, that enables
      * to cancel async tasks, if we will have new version of params
      * available
      */
@@ -1053,7 +925,7 @@ export interface MeteogramDataPayload {
 }
 
 /**
- * Particle animation paramters
+ * Particle animation parameters
  */
 export interface ExtendedRenderParams extends ExtendedTileParams, FullRenderParameters {
     canvas: HTMLCanvasElement;
@@ -1071,15 +943,6 @@ export interface ExtendedRenderParams extends ExtendedTileParams, FullRenderPara
     speed2pixel: number;
 }
 
-/**
- * Info about articles, user has already seen
- */
-export interface SeenArticle {
-    seen: Timestamp;
-    checked: Timestamp;
-    count: number;
-}
-
 /**
  * How good are observations by this AD or WX station?
  */
@@ -1090,102 +953,6 @@ export interface ObservationInfo {
     records: number;
 }
 
-export type ArticleImportances =
-    | 'extreme'
-    | 'severe'
-    | 'moderate'
-    | 'windyAnnounce'
-    | 'forecast'
-    | 'windyTutorial'
-    | 'educational'
-    | 'timeKilling'
-    | 'warning';
-
-export interface ArticleAuthor {
-    avatar: string;
-    profile: string;
-    reputation: number;
-    username: string;
-    userslug: string;
-}
-
-/**
- * This format is used backend payload for info on HP
- */
-export interface ArticleJson {
-    author: ArticleAuthor;
-    coverPhoto: {
-        desc: '' | string;
-        link: '' | string;
-        photo: '' | string;
-        showArticleCover: boolean;
-        src: string;
-    };
-    id: number;
-    importance: ArticleImportances;
-    language: SupportedLanguages;
-    ranking: number;
-    slug: string;
-    subtitle: '' | string;
-    title: string;
-    updated: ISODateString;
-
-    /**
-     * Monkey patched props
-     */
-    count: number;
-    checked: Timestamp | 0;
-    key: string;
-}
-
-/**
- * This format is used backend payload for list of articles
- */
-export interface ExtendedArticleJson extends ArticleJson {
-    countries: string | string[] | '';
-    licence: 'cc-by' | 'proprietary';
-    originalAuthor: {
-        name: string | '';
-        link: string | '';
-    };
-    perex: string | '';
-    platform: 'all' | 'ios' | 'android';
-    target: 'all' | 'index' | 'mobile';
-    device: 'all' | 'desktop' | 'mobile';
-    pid: number;
-    published: ISODateString;
-    expire: string;
-    publishedBy: number;
-    tags: string[];
-    expiration: ISODateString;
-    homepage: boolean;
-    type?: 'article' | 'video';
-}
-
-/**
- * This format is used backend payload for particular article in article list
- */
-export interface Article extends ExtendedArticleJson {
-    status: 'published' | 'unpublished' | 'expired';
-    upvotes: number;
-    viewcount: number;
-    internalUrl: {
-        url: string;
-        search: string;
-        path: string;
-        internal: boolean;
-    }[];
-    containsTwitter: boolean;
-    video?: string;
-    articleCoverPhoto: {
-        src: string;
-        photo: string;
-        desc: string;
-        link: string;
-    };
-    content: HTMLString;
-    version: string;
-}
 export interface ServiceGeoipResponse {
     country: string;
     region: `${number}`;
@@ -1198,7 +965,7 @@ export interface ServiceGeoipResponse {
     ip: string;
 
     /**
-     * Deprecated
+     * @deprecated
      */
     hash: 'oiurouoweruouoiuou';
 }
@@ -1348,7 +1115,7 @@ export interface IsAppleWatchPairedResult {
     value: boolean;
 }
 
-export interface IsAppleWatchCompanionAppIntalledResult {
+export interface IsAppleWatchCompanionAppInstalledResult {
     value: boolean;
 }
 
@@ -1368,14 +1135,14 @@ export interface WindyWatchPlugin {
      * Watch conditions for the alert
      */
     isPaired: () => Promise<IsAppleWatchPairedResult>;
-    isWatchAppInstalled: () => Promise<IsAppleWatchCompanionAppIntalledResult>;
+    isWatchAppInstalled: () => Promise<IsAppleWatchCompanionAppInstalledResult>;
     addWatchFace: () => Promise<unknown>;
 }
 
 export interface WindyServicePlugin {
     openSettings: () => Promise<void | string>;
-    getLocationPermnissions: () => Promise<LocationPrefecernces>;
-    getNotificationPermnissions: () => Promise<NoticicationPrefecernces>;
+    getLocationPermissions: () => Promise<LocationPreferences>;
+    getNotificationPermissions: () => Promise<NotificationPreferences>;
     openApplicationSettings: () => Promise<void | string>;
     isGpsEnabled: () => Promise<GpsPreferences>;
     getBatteryUsagePermissions: () => Promise<BatteryPreferences>;
@@ -1385,7 +1152,27 @@ export interface WindyServicePlugin {
     openWidgetNotificationSettings: () => Promise<void>;
     getBackgroundLocationPermission: () => Promise<GpsPreferences>;
     openBackgroundLocationSettings: () => Promise<void>;
+    logError: (arg: { moduleName: string; msg: string; error?: string }) => Promise<void>;
+    getId: () => Promise<{ identifier: string }>;
+    getAppsflyerCredentials: () => Promise<{ devKey: string | undefined; appId: string }>;
+    addWidget: (arg: WidgetType) => Promise<void>;
+}
+
+export interface NotificationLocationInfo {
+    locationEntityId: string;
+    deviceToken: string | null;
+    isRunning: boolean;
 }
+
+export interface WindyNotificationLocationPlugin {
+    getInfo: () => Promise<NotificationLocationInfo>;
+    startUpdateService: () => Promise<NotificationLocationInfo>;
+    stopUpdateService: () => Promise<NotificationLocationInfo>;
+    // Only for testing purposes
+    getDebugLog: () => Promise<{ lastLocationUpdates: string }>;
+    useCustomLocation: (arg: LatLon) => Promise<void>;
+}
+
 /**
  * A migration tool for transferring old Web View local storage to a new location.
  * This migration is necessary when the hostname is changed in the native Capacitor configuration.
@@ -1427,7 +1214,19 @@ export interface WindyMigrationPlugin {
     /**
      * Marks migration as completed and restart WebView from origin
      */
-    markMigrationCompleted: () => Promise<void>;
+    markMigrationCompleted: (opts: { reload: boolean }) => Promise<void>;
+    /**
+     * Returns migration status flag - either migrationNotPerformed or migratingData
+     */
+    getMigrationStatus: () => Promise<MigrationResult>;
+    /**
+     * Sends migration data to native layer
+     */
+    setMigrationData: (opts: { data: string }) => Promise<void>;
+    /**
+     * Returns old localStorage data (sent to native layer via setMigrationData function)
+     */
+    getOldLocalStorageDataAndroid: () => Promise<{ result: string | null }>;
 }
 
 export interface SocialLoginParams {
@@ -1458,25 +1257,12 @@ export interface ObservationSummaryRecord {
 
 export type ObservationSummaryHash = Record<YearMonthDay, ObservationSummaryRecord>;
 
-/**
- * Observation Weather data used in station plugin (so far IMHO used only to render mobile fragment)
- */
-export interface ObservationFragmentHash {
-    summary: ObservationSummaryHash;
-    data: {
-        temp: NumOrNull[];
-        wind: NumOrNull[];
-        mm: NumOrNull[];
-        snow: NumOrNull[];
-    };
-}
-
 /**
  * Opening options for Window class
  */
 export interface WindowOpeningOptions {
     /**
-     * Should we open the widnow without animation?
+     * Should we open the window without animation?
      */
     disableOpeningAnimation?: boolean;
 }
@@ -1578,18 +1364,6 @@ export interface LocationState {
     search: string;
 }
 
-export interface WindyOfflinePlugin {
-    // startOfflineMode: () => Promise<unknown>;
-    // stopOfflineMode: () => Promise<unknown>;
-    controlReadiness: () => Promise<{ value: boolean }>;
-    // fetchOfflineData: (payload: DownloadPayload) => Promise<unknown>;
-    postMessage: (message: ClientMessage) => Promise<unknown>;
-    addListener: (
-        eventName: 'offlineMessage',
-        callback: (message: { data: string }) => void,
-    ) => void;
-}
-
 /**
  * # Plugin configuration
  *
@@ -1735,6 +1509,12 @@ export interface ExternalPluginConfig {
      * space on the bottom of the screen.
      */
     mobileUI: 'fullscreen' | 'small';
+
+    /**
+     * The plugin has NO LINK in the main menu, can be open only programmatically
+     * and its installation is not persistent.
+     */
+    internal?: boolean;
 }
 
 export interface CompiledExternalPluginConfig extends ExternalPluginConfig {
@@ -1765,17 +1545,88 @@ export interface CompiledExternalPluginConfig extends ExternalPluginConfig {
  */
 export interface InstalledExternalPluginConfig extends CompiledExternalPluginConfig {
     /**
-     * URL of the plguin is used as unique identifier
+     * URL of the plugin is used as unique identifier
      */
     url: string;
 
     /**
      * From which process was plugin installed
      */
-    installedBy: 'dev' | 'gallery' | 'url';
+    installedBy: 'dev' | 'gallery' | 'url' | 'patch';
 
     /**
      * When was this plugin installed by specific user
      */
     installed: Timestamp;
 }
+
+interface PromoFilteringParams {
+    isLoggedIn: boolean;
+    sessionCounter: number;
+    isPremium: boolean;
+}
+
+/**
+ * Main promo object, used in `client-patch`
+ */
+interface PromoObj {
+    /**
+     * Main ID of the promo. This key is also used in `promo` object in localStorage
+     */
+    readonly id: string;
+
+    /**
+     * ISO date, when the promo expires
+     */
+    readonly end: string;
+
+    /**
+     * How many times display promo to the user (respective on one device)
+     */
+    counter: number;
+
+    /**
+     * How often to display promo on particular device (in ms)
+     */
+    delay: number;
+
+    /**
+     * Any others filters, deciding whether to display promo or not
+     */
+    filter: () => boolean;
+
+    /**
+     * Should we display HP articles together with promo
+     * @deprecated
+     */
+    loadArticles?: boolean;
+
+    /**
+     * Required method to be run, when promo is executed. In this stage we can also
+     * do some additional checks, if promo should be displayed or not, so we must
+     * call `promo.hitCounter()` method ourselves.
+     */
+    readonly run: () => void;
+
+    /**
+     * Optional HTML code to be used internally in `run` method
+     */
+    html?: string;
+}
+
+/**
+ * Client patch object
+ */
+interface ClientPatch {
+    __version: string;
+    __css: string;
+    exclusivePromos: PromoObj[];
+    otherPromos: PromoObj[];
+}
+
+/**
+ * Amount of active hurricanes as returnd from hurricane tracker backend
+ */
+export interface ActiveStormCountPayload {
+    activeStormCount: number;
+}