koishi-plugin-warframe 1.13.0 → 1.14.0

package/README.md

@@ -38,7 +38,8 @@ Toolkit for Warframe. Provides Warframe Market prices, fissures, arbitrations, r
 | `arbitration` | `[day:number]` | `arbi`, `仲裁`, `仲裁表`                         | Query high-value arbitration missions. Optional `day` controls how many days to show (default: 3). |
 | `weekly`      |                | `周常`, `科研`, `时光科研`, `深层科研`, `执行官` | Query weekly missions (Archon Hunt, Deep Archimedea, Temporal Archimedea).                         |
 | `circuit`     |                | `灵化之源`, `灵化`                               | Query weekly circuit rewards (warframes and incarnon adapters).                                    |
-| `steelpath`   |                | `steel-path`, `teshin`, `钢铁精华`, `钢铁之路`   | Query this week's Steel Essence shop rotation (current offering, remaining time, upcoming).        |
+| `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).            |
 
 ### 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", "steelpath.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", "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,86 @@ 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/fissure" {
     import type { WFRegionShort } from "warframe/types/wf/region";
     export interface Fissure {
@@ -261,43 +341,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';
@@ -457,7 +500,7 @@ declare module "warframe/types/wf/sortie" {
         missions: SortieMission[];
     }
 }
-declare module "warframe/types/wf/steelpath" {
+declare module "warframe/types/wf/steelessence" {
     export interface RawSteelPathOffering {
         name?: string;
         cost?: number;
@@ -468,17 +511,17 @@ declare module "warframe/types/wf/steelpath" {
         expiry?: Date;
         rotation?: RawSteelPathOffering[];
     }
-    export interface SteelPathOfferingInfo {
+    export interface SteelEssenceOfferingInfo {
         name: string;
         cost: number;
     }
-    export interface SteelPathBoard {
+    export interface SteelEssenceBoard {
         title: string;
         costLabel: string;
         remaining: string;
         expiry: number;
-        current: SteelPathOfferingInfo;
-        upcoming: SteelPathOfferingInfo[];
+        current: SteelEssenceOfferingInfo;
+        upcoming: SteelEssenceOfferingInfo[];
     }
 }
 declare module "warframe/types/wf/voidtrader" {
@@ -526,6 +569,7 @@ 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 { 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";
@@ -533,7 +577,7 @@ declare module "warframe/types/index" {
     export type { ExternalRelic, ExternalRelicReward, OutputRelic, OutputRelicReward, Relic, RelicQuality, RelicReward, RelicRewardRarity, RelicTier, } from "warframe/types/wf/relic";
     export type { RivenStatAnalyzeResult, RivenStatAnalyzsis, RivenStatCountType, RivenStatFixFactor, RivenStatFixFactorMap, RivenStatResult, RivenWeaponDisposition, RivenWeaponType, } from "warframe/types/wf/riven";
     export type { RawSortie, RawSortieVariant, Sortie, SortieMission, } from "warframe/types/wf/sortie";
-    export type { RawSteelPathOffering, RawSteelPathOfferings, SteelPathBoard, SteelPathOfferingInfo, } from "warframe/types/wf/steelpath";
+    export type { RawSteelPathOffering, RawSteelPathOfferings, SteelEssenceBoard, SteelEssenceOfferingInfo, } from "warframe/types/wf/steelessence";
     export type { VoidTrader, VoidTraderItem } from "warframe/types/wf/voidtrader";
     export type { ArchiMedea, ArchiMedeaDebuff, ArchiMedeaMission, ArchonHunt, ArchonHuntMissions, } from "warframe/types/wf/weekly";
     export type { ClosedStatisticsEntry, Ducatnator, ItemShort, ItemStatisticsPoint, ItemStatisticsSummary, LiveStatisticsEntry, OrderWithUser, PrimedModHistoryItem, RivenAttribute, RivenAttributeShortInternal, RivenAttributeUnit, RivenItem, RivenOrder, RivenOrderInternal, StatisticsCollection, WFMLang, } from "warframe/types/wfm";
@@ -643,11 +687,12 @@ 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 } 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 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 +779,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 } from "warframe/types/index";
     type ParsedFissure = WorldState['fissures'][number];
     export function adaptFissure(fissure: ParsedFissure): Promise<Fissure>;
     export const globalWorldState: import("warframe").AsyncCache<{
@@ -743,6 +788,7 @@ declare module "warframe/data/wf/globalWorldState" {
         seasonInfoRaw: RawSeasonInfo | undefined;
         sortieRaw: import("warframe").RawSortie | undefined;
         invasionsRaw: import("warframe").RawInvasion[];
+        calendarRaw: RawCalendarSeason | undefined;
         fissures: Fissure[];
         spFissures: Fissure[];
         rjFissures: Fissure[];
@@ -923,13 +969,20 @@ 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" {
     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, SteelPathBoard, 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 function getRelic(input: string): Promise<WarframeResult<Relic>>;
     export function getArbitrations(day?: number): WarframeResult<Arbitration[]>;
@@ -996,13 +1049,19 @@ declare module "warframe/services/wf-service" {
         };
     }[], now?: number): Promise<AlertBoard>;
     export function getAlerts(): Promise<WarframeResult<AlertBoard>>;
-    export function adaptSteelPath(raw?: RawSteelPathOfferings, now?: number): Promise<SteelPathBoard>;
-    export function getSteelPathFrom(snapshot?: {
+    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?: {
             steelPath?: RawSteelPathOfferings;
         };
-    }, now?: number): Promise<WarframeResult<SteelPathBoard>>;
-    export function getSteelPath(): Promise<WarframeResult<SteelPathBoard>>;
+    }, now?: number): Promise<WarframeResult<SteelEssenceBoard>>;
+    export function getSteelEssence(): Promise<WarframeResult<SteelEssenceBoard>>;
     export function getFissures(): Promise<WarframeResult<Fissure[]>>;
     export function getSteelPathFissures(): Promise<WarframeResult<Fissure[]>>;
     export function getRailjackFissures(): Promise<WarframeResult<Fissure[]>>;
@@ -1216,7 +1275,8 @@ declare module "i18n" {
         readonly 'bounty.unavailable': "当前该地点暂无可用赏金";
         readonly 'invasion.unavailable': "当前没有入侵";
         readonly 'alert.unavailable': "当前没有警报";
-        readonly 'steelpath.unavailable': "钢铁精华商店获取失败";
+        readonly 'calendar.unavailable': "当前没有1999日历";
+        readonly 'steelEssence.unavailable': "钢铁精华商店获取失败";
         readonly 'nightwave.unavailable': "当前没有午夜电波";
         readonly 'sortie.unavailable': "当前没有突击";
         readonly 'voidTrader.drifting': "虚空商人仍在未知地带漂流...";
@@ -1281,7 +1341,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, SteelPathBoard, VoidTrader } from "warframe/index";
+    import type { AlertBoard, Arbitration, ArchiMedea, ArchonHunt, BountyBoard, CalendarBoard, 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,7 +1356,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 SteelPathComponent(board: SteelPathBoard): Element;
+    export function CalendarComponent(board: CalendarBoard): Element;
+    export function SteelEssenceComponent(board: SteelEssenceBoard): Element;
 }
 declare module "commands/wf" {
     import type { Argv, Dict } from 'koishi';
@@ -1308,7 +1369,8 @@ declare module "commands/wf" {
         fissureCommand: (_action: Argv) => Promise<string>;
         invasionCommand: (_action: Argv) => Promise<string>;
         alertCommand: (_action: Argv) => Promise<string>;
-        steelPathCommand: (_action: Argv) => Promise<string>;
+        calendarCommand: (_action: Argv) => Promise<string>;
+        steelEssenceCommand: (_action: Argv) => Promise<string>;
         steelPathFissureCommand: (_action: Argv) => Promise<string>;
         railjackFissureCommand: (_action: Argv) => Promise<string>;
         relicCommand: (_action: Argv, input: string) => Promise<string>;