koishi-plugin-warframe 1.13.1 → 1.15.0

package/README.md

@@ -39,6 +39,8 @@ Toolkit for Warframe. Provides Warframe Market prices, fissures, arbitrations, r
 | `weekly`      |                | `周常`, `科研`, `时光科研`, `深层科研`, `执行官` | Query weekly missions (Archon Hunt, Deep Archimedea, Temporal Archimedea).                         |
 | `circuit`     |                | `灵化之源`, `灵化`                               | Query weekly circuit rewards (warframes and incarnon adapters).                                    |
 | `steel-essence` |                | `钢铁精华`                                     | Query this week's Steel Essence shop rotation (current offering, remaining time, upcoming).        |
+| `1999calendar`  |                | `日历`, `1999日历`, `霍瓦尼亚日历`             | Query the current 1999 Höllvania calendar tagged days (challenges, overrides, rewards).            |
+| `event`         |                | `活动`, `事件`                                 | Query active world events (progress, rewards, remaining time).                                    |
 
 ### Open World Cycles
 

package/lib/index.d.ts

@@ -34,7 +34,7 @@ declare module "warframe/types/ocr" {
     }
 }
 declare module "warframe/types/warframe-result" {
-    export const warframeErrorCodes: readonly ["common.fetchFailed", "relic.invalidName", "relic.dataLoading", "relic.notFound", "arbitration.invalidDayRange", "bounty.unavailable", "invasion.unavailable", "alert.unavailable", "steelEssence.unavailable", "nightwave.unavailable", "sortie.unavailable", "voidTrader.drifting", "voidTrader.arriving", "riven.imageFetchFailed", "riven.imageParseFailed", "riven.weaponNotFound", "riven.dispositionError", "riven.weaponTypeError", "riven.statTypeError", "wfm.inputItemName", "wfm.itemNotFound", "wfm.itemAmbiguous", "wfm.orderFetchFailed", "wfm.noOnlineSeller", "wfm.rivenWeaponNotFound", "wfm.rivenOrderFetchFailed", "wfm.noOnlineRivenSeller", "miscs.hotRiven.noData", "miscs.hotRiven.fetchFailed"];
+    export const warframeErrorCodes: readonly ["common.fetchFailed", "relic.invalidName", "relic.dataLoading", "relic.notFound", "arbitration.invalidDayRange", "bounty.unavailable", "invasion.unavailable", "alert.unavailable", "event.unavailable", "calendar.unavailable", "steelEssence.unavailable", "nightwave.unavailable", "sortie.unavailable", "voidTrader.drifting", "voidTrader.arriving", "riven.imageFetchFailed", "riven.imageParseFailed", "riven.weaponNotFound", "riven.dispositionError", "riven.weaponTypeError", "riven.statTypeError", "wfm.inputItemName", "wfm.itemNotFound", "wfm.itemAmbiguous", "wfm.orderFetchFailed", "wfm.noOnlineSeller", "wfm.rivenWeaponNotFound", "wfm.rivenOrderFetchFailed", "wfm.noOnlineRivenSeller", "miscs.hotRiven.noData", "miscs.hotRiven.fetchFailed"];
     export type WarframeErrorCode = typeof warframeErrorCodes[number];
     export type WarframeErrorParams = Record<string, string | number>;
     export interface WarframeError {
@@ -186,6 +186,147 @@ declare module "warframe/types/wf/bounty" {
         zarimanFaction?: string;
     }
 }
+declare module "warframe/types/wf/nightwave" {
+    export interface RawMongoDate {
+        $date?: {
+            $numberLong?: string | number;
+        };
+    }
+    export interface RawNightwaveActiveChallenge {
+        Challenge: string;
+        Daily?: boolean;
+        Permanent?: boolean | number | string;
+        Activation?: RawMongoDate;
+        Expiry?: RawMongoDate;
+    }
+    export interface RawSeasonInfo {
+        Season: number;
+        Phase: number;
+        AffiliationTag: string;
+        Expiry?: RawMongoDate;
+        ActiveChallenges: RawNightwaveActiveChallenge[];
+    }
+    export type NightwaveChallengeKind = 'daily' | 'weekly' | 'elite' | 'permanent';
+    export interface NightwaveChallengeInfo {
+        name: string;
+        description: string;
+        kind: NightwaveChallengeKind;
+        remaining: string;
+        standing?: number;
+    }
+    export interface NightwaveBoard {
+        title: string;
+        season: number;
+        phase: number;
+        expiry: number;
+        remaining: string;
+        challenges: NightwaveChallengeInfo[];
+    }
+}
+declare module "warframe/types/wf/calendar" {
+    import type { RawMongoDate } from "warframe/types/wf/nightwave";
+    export interface RawCalendarEvent {
+        type?: string;
+        challenge?: string;
+        upgrade?: string;
+        reward?: string;
+        dialogueName?: string;
+        dialogueConvo?: string;
+    }
+    export interface RawCalendarDay {
+        day?: number;
+        events?: RawCalendarEvent[];
+    }
+    export interface RawCalendarSeason {
+        Activation?: RawMongoDate;
+        Expiry?: RawMongoDate;
+        Days?: RawCalendarDay[];
+        Season?: string;
+        YearIteration?: number;
+        Version?: number;
+        UpgradeAvaliabilityRequirements?: string[];
+    }
+    export type CalendarEventKind = 'challenge' | 'upgrade' | 'reward' | 'birthday' | 'other';
+    export interface CalendarEventInfo {
+        kind: CalendarEventKind;
+        kindLabel: string;
+        name: string;
+        description?: string;
+    }
+    export interface CalendarDayInfo {
+        day: number;
+        dateLabel: string;
+        events: CalendarEventInfo[];
+    }
+    export interface CalendarBoard {
+        title: string;
+        season: string;
+        remaining: string;
+        expiry: number;
+        days: CalendarDayInfo[];
+    }
+}
+declare module "warframe/types/wf/event" {
+    import type { RawMongoDate } from "warframe/types/wf/nightwave";
+    import type { WFRegionShort } from "warframe/types/wf/region";
+    export interface RawEventCountedItem {
+        ItemType?: string;
+        ItemCount?: number;
+        type?: string;
+        key?: string;
+        count?: number;
+    }
+    export interface RawEventReward {
+        items?: string[];
+        countedItems?: RawEventCountedItem[];
+        credits?: number;
+    }
+    export interface RawWorldEvent {
+        _id?: {
+            $oid?: string;
+            $id?: string;
+        };
+        Activation?: RawMongoDate;
+        Expiry?: RawMongoDate;
+        Node?: string;
+        Count?: number;
+        Goal?: number;
+        HealthPct?: number;
+        Desc?: string;
+        ToolTip?: string;
+        ScoreLocTag?: string;
+        Tag?: string;
+        Reward?: RawEventReward;
+        InterimGoals?: number[];
+        InterimRewards?: RawEventReward[];
+    }
+    export interface EventReward {
+        name: string;
+        count: number;
+    }
+    export interface EventInterimStep {
+        goal: number;
+        rewards: EventReward[];
+    }
+    export interface EventInfo {
+        id: string;
+        name: string;
+        description?: string;
+        scoreLabel?: string;
+        node?: WFRegionShort;
+        remaining?: string;
+        expiry: number;
+        currentScore: number;
+        maximumScore: number;
+        progress?: number;
+        rewards: EventReward[];
+        interimSteps: EventInterimStep[];
+    }
+    export interface EventBoard {
+        title: string;
+        events: EventInfo[];
+    }
+}
 declare module "warframe/types/wf/fissure" {
     import type { WFRegionShort } from "warframe/types/wf/region";
     export interface Fissure {
@@ -261,43 +402,6 @@ declare module "warframe/types/wf/invasion" {
         planets: InvasionPlanetGroup[];
     }
 }
-declare module "warframe/types/wf/nightwave" {
-    export interface RawMongoDate {
-        $date?: {
-            $numberLong?: string | number;
-        };
-    }
-    export interface RawNightwaveActiveChallenge {
-        Challenge: string;
-        Daily?: boolean;
-        Permanent?: boolean | number | string;
-        Activation?: RawMongoDate;
-        Expiry?: RawMongoDate;
-    }
-    export interface RawSeasonInfo {
-        Season: number;
-        Phase: number;
-        AffiliationTag: string;
-        Expiry?: RawMongoDate;
-        ActiveChallenges: RawNightwaveActiveChallenge[];
-    }
-    export type NightwaveChallengeKind = 'daily' | 'weekly' | 'elite' | 'permanent';
-    export interface NightwaveChallengeInfo {
-        name: string;
-        description: string;
-        kind: NightwaveChallengeKind;
-        remaining: string;
-        standing?: number;
-    }
-    export interface NightwaveBoard {
-        title: string;
-        season: number;
-        phase: number;
-        expiry: number;
-        remaining: string;
-        challenges: NightwaveChallengeInfo[];
-    }
-}
 declare module "warframe/types/wf/relic" {
     export type RelicTier = 'Lith' | 'Meso' | 'Neo' | 'Axi' | 'Requiem' | 'Vanguard';
     export type RelicQuality = 'Intact' | 'Exceptional' | 'Flawless' | 'Radiant';
@@ -526,6 +630,8 @@ declare module "warframe/types/index" {
     export type { AlertBoard, AlertInfo, AlertReward } from "warframe/types/wf/alert";
     export type { Arbitration, ArbitrationShort } from "warframe/types/wf/arbitration";
     export type { BountyBoard, BountyJob, BountyLocation, BountyReward, BountyRewardRarity, BountyStandingUnit, OracleBountyCycle, OracleBountyEntry, RawSyndicateJob, RawSyndicateMission, } from "warframe/types/wf/bounty";
+    export type { CalendarBoard, CalendarDayInfo, CalendarEventInfo, CalendarEventKind, RawCalendarDay, RawCalendarEvent, RawCalendarSeason, } from "warframe/types/wf/calendar";
+    export type { EventBoard, EventInfo, EventInterimStep, EventReward, RawEventCountedItem, RawEventReward, RawWorldEvent, } from "warframe/types/wf/event";
     export type { Fissure } from "warframe/types/wf/fissure";
     export type { Invasion, InvasionBoard, InvasionFactionTone, InvasionPlanetGroup, InvasionReward, InvasionSide, RawInvasion, RawInvasionCountedItem, RawInvasionMissionInfo, RawInvasionReward, } from "warframe/types/wf/invasion";
     export type { NightwaveBoard, NightwaveChallengeInfo, NightwaveChallengeKind, RawMongoDate, RawNightwaveActiveChallenge, RawSeasonInfo, } from "warframe/types/wf/nightwave";
@@ -643,11 +749,13 @@ declare module "warframe/data/wf/archonHunt" {
 }
 declare module "warframe/infrastructure/wf/wf-api" {
     import type WorldState from 'warframe-worldstate-parser';
-    import type { OracleBountyCycle, RawInvasion, RawSeasonInfo, RawSortie, RawSyndicateMission } from "warframe/types/index";
+    import type { OracleBountyCycle, RawCalendarSeason, RawInvasion, RawSeasonInfo, RawSortie, RawSyndicateMission, RawWorldEvent } from "warframe/types/index";
     export function extractSyndicateMissionsRaw(json: string): RawSyndicateMission[];
     export function extractSeasonInfoRaw(json: string): RawSeasonInfo | undefined;
     export function extractSortieRaw(json: string): RawSortie | undefined;
     export function extractInvasionsRaw(json: string): RawInvasion[];
+    export function extractEventsRaw(json: string): RawWorldEvent[];
+    export function extractCalendarRaw(json: string): RawCalendarSeason | undefined;
     export function fetchWorldStateJson(): Promise<string | undefined>;
     /** browse.wf Oracle bounty cycle (Zariman / Cavia / Hex). */
     export function fetchOracleBountyCycle(): Promise<OracleBountyCycle | undefined>;
@@ -734,7 +842,7 @@ declare module "warframe/infrastructure/wf/wfcd-adapter" {
 }
 declare module "warframe/data/wf/globalWorldState" {
     import type WorldState from 'warframe-worldstate-parser';
-    import type { Fissure, RawSeasonInfo, RawSyndicateMission } from "warframe/types/index";
+    import type { Fissure, RawCalendarSeason, RawSeasonInfo, RawSyndicateMission, RawWorldEvent } from "warframe/types/index";
     type ParsedFissure = WorldState['fissures'][number];
     export function adaptFissure(fissure: ParsedFissure): Promise<Fissure>;
     export const globalWorldState: import("warframe").AsyncCache<{
@@ -743,6 +851,8 @@ declare module "warframe/data/wf/globalWorldState" {
         seasonInfoRaw: RawSeasonInfo | undefined;
         sortieRaw: import("warframe").RawSortie | undefined;
         invasionsRaw: import("warframe").RawInvasion[];
+        calendarRaw: RawCalendarSeason | undefined;
+        eventsRaw: RawWorldEvent[];
         fissures: Fissure[];
         spFissures: Fissure[];
         rjFissures: Fissure[];
@@ -923,14 +1033,31 @@ declare module "warframe/infrastructure/wf/bounty-adapter" {
     export function formatOracleChallenge(challengePath: string): string;
     export function adaptOracleBountyBoard(location: 'zariman' | 'cavia' | 'hex', cycle: OracleBountyCycle | undefined): BountyBoard | undefined;
 }
+declare module "warframe/infrastructure/wf/calendar-adapter" {
+    import type { CalendarBoard, RawCalendarSeason, RawMongoDate } from "warframe/types/index";
+    export function calendarTimestampMs(value?: RawMongoDate): number;
+    /** Strip Lotus color pipes and HTML-like markup tags. */
+    export function stripLotusMarkup(text: string): string;
+    export function adaptCalendar(raw: RawCalendarSeason | undefined, now?: number): CalendarBoard;
+}
 declare module "warframe/infrastructure/wf/nightwave-adapter" {
     import type { NightwaveBoard, RawSeasonInfo } from "warframe/types/index";
     export function adaptNightwave(raw: RawSeasonInfo, now?: number): NightwaveBoard;
 }
-declare module "warframe/services/wf-service" {
+declare module "warframe/services/wf-service/wf-service.event" {
+    import type { EventBoard, RawWorldEvent, WarframeResult } from "warframe/types/index";
+    export function adaptEvents(rawEvents?: readonly RawWorldEvent[], now?: number): EventBoard;
+    export function getEventsFrom(snapshot?: {
+        raw?: unknown;
+        eventsRaw?: RawWorldEvent[];
+    }, now?: number): Promise<WarframeResult<EventBoard>>;
+    export function getEvents(): Promise<WarframeResult<EventBoard>>;
+}
+declare module "warframe/services/wf-service/index" {
     import type { WeeklyRiven } from 'warframe-weekly-rivens';
-    import type { AlertBoard, Arbitration, ArchiMedea, ArchonHunt, BountyBoard, BountyLocation, Fissure, InvasionBoard, NightwaveBoard, OcrAPISecret, RawInvasion, RawSeasonInfo, RawSortie, RawSteelPathOfferings, Relic, RivenAttribute, RivenStatAnalyzeResult, RivenStatResult, Sortie, SteelEssenceBoard, VoidTrader, WarframeResult } from "warframe/types/index";
+    import type { AlertBoard, Arbitration, ArchiMedea, ArchonHunt, BountyBoard, BountyLocation, CalendarBoard, Fissure, InvasionBoard, NightwaveBoard, OcrAPISecret, RawCalendarSeason, RawInvasion, RawSeasonInfo, RawSortie, RawSteelPathOfferings, Relic, RivenAttribute, RivenStatAnalyzeResult, RivenStatResult, Sortie, SteelEssenceBoard, VoidTrader, WarframeResult } from "warframe/types/index";
     import { weaponRivenDispositionDict } from "warframe/data/wf/rivenDisposition";
+    export { adaptEvents, getEvents, getEventsFrom } from "warframe/services/wf-service/wf-service.event";
     export function getRelic(input: string): Promise<WarframeResult<Relic>>;
     export function getArbitrations(day?: number): WarframeResult<Arbitration[]>;
     export function adaptArchonHunt(source: {
@@ -996,6 +1123,12 @@ declare module "warframe/services/wf-service" {
         };
     }[], now?: number): Promise<AlertBoard>;
     export function getAlerts(): Promise<WarframeResult<AlertBoard>>;
+    export function adaptCalendar(raw: RawCalendarSeason | undefined, now?: number): CalendarBoard;
+    export function getCalendarFrom(snapshot?: {
+        raw?: unknown;
+        calendarRaw?: RawCalendarSeason;
+    }, now?: number): Promise<WarframeResult<CalendarBoard>>;
+    export function getCalendar(): Promise<WarframeResult<CalendarBoard>>;
     export function adaptSteelEssence(raw?: RawSteelPathOfferings, now?: number): Promise<SteelEssenceBoard>;
     export function getSteelEssenceFrom(snapshot?: {
         raw?: {
@@ -1195,7 +1328,7 @@ declare module "warframe/services/world-state-refresh" {
 }
 declare module "warframe/services/index" {
     export * from "warframe/services/miscs-service";
-    export * from "warframe/services/wf-service";
+    export * from "warframe/services/wf-service/index";
     export * from "warframe/services/wfm-service/index";
     export * from "warframe/services/world-state-refresh";
 }
@@ -1216,6 +1349,8 @@ declare module "i18n" {
         readonly 'bounty.unavailable': "当前该地点暂无可用赏金";
         readonly 'invasion.unavailable': "当前没有入侵";
         readonly 'alert.unavailable': "当前没有警报";
+        readonly 'event.unavailable': "当前没有活动";
+        readonly 'calendar.unavailable': "当前没有1999日历";
         readonly 'steelEssence.unavailable': "钢铁精华商店获取失败";
         readonly 'nightwave.unavailable': "当前没有午夜电波";
         readonly 'sortie.unavailable': "当前没有突击";
@@ -1281,7 +1416,7 @@ declare module "utils/index" {
 declare module "components/wf" {
     import type { Element } from 'koishi';
     import type { WeeklyRiven } from 'warframe-weekly-rivens';
-    import type { AlertBoard, Arbitration, ArchiMedea, ArchonHunt, BountyBoard, Fissure, InvasionBoard, NightwaveBoard, OutputRelic, RivenStatAnalyzeResult, RivenStatResult, Sortie, SteelEssenceBoard, VoidTrader } from "warframe/index";
+    import type { AlertBoard, Arbitration, ArchiMedea, ArchonHunt, BountyBoard, CalendarBoard, EventBoard, Fissure, InvasionBoard, NightwaveBoard, OutputRelic, RivenStatAnalyzeResult, RivenStatResult, Sortie, SteelEssenceBoard, VoidTrader } from "warframe/index";
     export function ArbitrationComponent(arbi: Arbitration[]): Element;
     export function CircuitComponent(currentIncarnons: number, currentWarframes: number, allIncarnons: string[][], allWarframes: string[][]): Element;
     export function FissureComponent(fissures: Fissure[], type: 'fissure' | 'sp-fissure' | 'rj-fissure'): Element;
@@ -1296,6 +1431,8 @@ declare module "components/wf" {
     export function RivenStatComponent(data: RivenStatResult): Element;
     export function VoidTraderComponent(data: VoidTrader): Element;
     export function AlertComponent(board: AlertBoard): Element;
+    export function EventComponent(board: EventBoard): Element;
+    export function CalendarComponent(board: CalendarBoard): Element;
     export function SteelEssenceComponent(board: SteelEssenceBoard): Element;
 }
 declare module "commands/wf" {
@@ -1308,6 +1445,8 @@ declare module "commands/wf" {
         fissureCommand: (_action: Argv) => Promise<string>;
         invasionCommand: (_action: Argv) => Promise<string>;
         alertCommand: (_action: Argv) => Promise<string>;
+        eventCommand: (_action: Argv) => Promise<string>;
+        calendarCommand: (_action: Argv) => Promise<string>;
         steelEssenceCommand: (_action: Argv) => Promise<string>;
         steelPathFissureCommand: (_action: Argv) => Promise<string>;
         railjackFissureCommand: (_action: Argv) => Promise<string>;