koishi-plugin-warframe 1.7.10 → 1.8.0

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", "voidTrader.drifting", "voidTrader.arriving", "riven.imageFetchFailed", "riven.imageParseFailed", "riven.weaponNotFound", "riven.dispositionError", "riven.weaponTypeError", "riven.statTypeError", "wfm.inputItemName", "wfm.itemNotFound", "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", "voidTrader.drifting", "voidTrader.arriving", "riven.imageFetchFailed", "riven.imageParseFailed", "riven.weaponNotFound", "riven.dispositionError", "riven.weaponTypeError", "riven.statTypeError", "wfm.inputItemName", "wfm.itemNotFound", "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 {
@@ -92,6 +92,81 @@ declare module "warframe/types/wf/arbitration" {
         rewards: number;
     }
 }
+declare module "warframe/types/wf/bounty" {
+    export type BountyLocation = 'cetus' | 'fortuna' | 'deimos' | 'zariman' | 'cavia' | 'hex';
+    /** 掉落稀有度：probability 同阶段内最高→铜，中间→银，最低→金 */
+    export type BountyRewardRarity = 'bronze' | 'silver' | 'gold';
+    export type BountyStandingUnit = 'standing' | 'vq';
+    export interface RawSyndicateJob {
+        jobType?: string;
+        rewards: string;
+        masteryReq?: number;
+        minEnemyLevel: number;
+        maxEnemyLevel: number;
+        xpAmounts: number[];
+        isVault?: boolean;
+        locationTag?: string;
+    }
+    export interface RawSyndicateMission {
+        Tag: string;
+        Activation?: {
+            $date?: {
+                $numberLong?: string;
+            };
+        };
+        Expiry?: {
+            $date?: {
+                $numberLong?: string;
+            };
+        };
+        Jobs?: RawSyndicateJob[];
+    }
+    /** browse.wf Oracle `/bounty-cycle` response */
+    export interface OracleBountyEntry {
+        node: string;
+        challenge: string;
+        ally?: string;
+    }
+    export interface OracleBountyCycle {
+        expiry: number;
+        rot: string;
+        vaultRot: string;
+        zarimanFaction: string;
+        bounties: Record<string, OracleBountyEntry[]>;
+    }
+    export interface BountyReward {
+        name: string;
+        rarity: BountyRewardRarity;
+    }
+    export interface BountyJob {
+        name: string;
+        enemyLevels: [number, number];
+        standingStages: number[];
+        minMR: number;
+        isVault?: boolean;
+        locationTag?: string;
+        isNarmer?: boolean;
+        /** 各阶段奖励池（对应 ExportRewards 的各层）；Oracle 赏金无此信息 */
+        stages: BountyReward[][];
+        /** Oracle 挑战描述 */
+        challenge?: string;
+        /** Hex 盟友显示名 */
+        ally?: string;
+        /** 声望单位：扎里曼为虚空余烬(VQ) */
+        standingUnit?: BountyStandingUnit;
+    }
+    export interface BountyBoard {
+        location: BountyLocation;
+        title: string;
+        expiry: number;
+        jobs: BountyJob[];
+        /** worldstate Jobs vs browse.wf Oracle */
+        source?: 'worldstate' | 'oracle';
+        rotation?: string;
+        vaultRotation?: string;
+        zarimanFaction?: string;
+    }
+}
 declare module "warframe/types/wf/fissure" {
     import type { WFRegionShort } from "warframe/types/wf/region";
     export interface Fissure {
@@ -168,7 +243,7 @@ declare module "warframe/types/wfm" {
         onlineMin: number;
     }
     export type RivenAttributeShortInternal = RivenOrder['item']['attributes'][number] & {
-        attribute: RivenAttribute;
+        attribute?: RivenAttribute;
     };
     export type RivenOrderInternal = Omit<RivenOrder, 'item'> & {
         item: Omit<RivenOrder['item'], 'attributes'> & {
@@ -272,6 +347,7 @@ declare module "warframe/types/index" {
     export type { OcrAPISecret } from "warframe/types/ocr";
     export type { WarframeError, WarframeErrorCode, WarframeErrorParams, WarframeFailure, WarframeResult, } from "warframe/types/warframe-result";
     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 { Fissure } from "warframe/types/wf/fissure";
     export type { WFRegion, WFRegionShort } from "warframe/types/wf/region";
     export type { ExternalRelic, ExternalRelicReward, OutputRelic, OutputRelicReward, Relic, RelicQuality, RelicReward, RelicRewardRarity, RelicTier, } from "warframe/types/wf/relic";
@@ -378,6 +454,11 @@ declare module "warframe/data/wf/arbitrationSchedule" {
 }
 declare module "warframe/infrastructure/wf/wf-api" {
     import type WorldState from 'warframe-worldstate-parser';
+    import type { OracleBountyCycle, RawSyndicateMission } from "warframe/types/index";
+    export function extractSyndicateMissionsRaw(json: string): RawSyndicateMission[];
+    export function fetchWorldStateJson(): Promise<string | undefined>;
+    /** browse.wf Oracle bounty cycle (Zariman / Cavia / Hex). */
+    export function fetchOracleBountyCycle(): Promise<OracleBountyCycle | undefined>;
     export function getWorldState(json?: string): Promise<WorldState>;
     export function getVoidTraderHistory(data?: string): Promise<VoidTraderData | undefined>;
     interface VoidTraderItem {
@@ -395,6 +476,11 @@ declare module "warframe/infrastructure/wf/wf-api" {
         [itemName: string]: VoidTraderItem;
     }
 }
+declare module "warframe/data/wf/globalOracleBountyCycle" {
+    import type { AsyncCache, OracleBountyCycle } from "warframe/types/index";
+    export let globalOracleBountyCycle: AsyncCache<OracleBountyCycle | undefined>;
+    export function overrideGlobalOracleBountyCycle(cache: AsyncCache<OracleBountyCycle | undefined>): void;
+}
 declare module "warframe/infrastructure/wf/wf-export-adapter" {
     import type { IRegion } from 'warframe-public-export-plus';
     import type { RelicQuality, WFRegionShort } from "warframe/types/index";
@@ -440,11 +526,12 @@ declare module "warframe/infrastructure/wf/wfcd-adapter" {
 }
 declare module "warframe/data/wf/globalWorldState" {
     import type WorldState from 'warframe-worldstate-parser';
-    import type { Fissure } from "warframe/types/index";
+    import type { Fissure, RawSyndicateMission } from "warframe/types/index";
     type ParsedFissure = WorldState['fissures'][number];
     export function adaptFissure(fissure: ParsedFissure): Promise<Fissure>;
     export const globalWorldState: import("warframe").AsyncCache<{
         raw: WorldState;
+        syndicateMissionsRaw: RawSyndicateMission[];
         fissures: Fissure[];
         spFissures: Fissure[];
         rjFissures: Fissure[];
@@ -466,23 +553,92 @@ declare module "warframe/data/wf/rivenStatData" {
     export const rivenStatFixFactor: RivenStatFixFactorMap;
 }
 declare module "warframe/infrastructure/wfm-client" {
+    import type { WfmApiClient, WfmFetcher, WfmPlugin } from 'wfm-api-client';
+    /** Warframe-local: map request failures to `undefined` (not part of upstream client). */
+    export function softFailPlugin(): WfmPlugin;
+    /** `fetcher` is a test injection seam only; production uses the client default. */
+    export function createPluginWfmClient(fetcher?: WfmFetcher): WfmApiClient;
     export const wfmClient: {
-        items: {
-            getList: () => Promise<import("wfm-api-client").ItemShort[] | undefined>;
-            getStatistics: (itemId: string) => Promise<import("wfm-api-client").StatisticsCollection | undefined>;
-            getOrders: (itemId: string) => Promise<import("wfm-api-client").OrderWithUser[] | undefined>;
-        };
-        rivens: {
-            getItems: () => Promise<import("wfm-api-client").RivenItem[] | undefined>;
-            getOrders: (itemId: string) => Promise<import("wfm-api-client").RivenOrder[] | undefined>;
-            getAttributes: () => Promise<import("wfm-api-client").RivenAttribute[] | undefined>;
-        };
-        tools: {
-            getDucatnator: () => Promise<{
+        auth: ReturnType<(request: import("wfm-api-client").WfmRequest, hooks?: {
+            onTokens?: (tokens: import("wfm-api-client").AuthTokens) => void;
+            onSignOut?: () => void;
+        }) => ReturnType<(request: import("wfm-api-client").WfmRequest, hooks?: {
+            onTokens?: (tokens: import("wfm-api-client").AuthTokens) => void;
+            onSignOut?: () => void;
+        }) => {
+            refresh: (body: import("wfm-api-client").RefreshSessionBody, options?: import("wfm-api-client").RefreshSessionOptions) => Promise<import("wfm-api-client").AuthTokens>;
+            signOut: (options?: import("wfm-api-client").CallOptions) => Promise<void>;
+        }>>;
+        items: ReturnType<(request: import("wfm-api-client").WfmRequest) => ReturnType<(request: import("wfm-api-client").WfmRequest) => {
+            list: (options?: import("wfm-api-client").CallOptions) => Promise<import("wfm-api-client").Item[]>;
+            get: (ref: import("wfm-api-client").ItemRef, options?: import("wfm-api-client").CallOptions) => Promise<import("wfm-api-client").Item>;
+            getSet: (ref: import("wfm-api-client").ItemRef, options?: import("wfm-api-client").CallOptions) => Promise<import("wfm-api-client").ItemSet>;
+        }> & ReturnType<(request: import("wfm-api-client").WfmRequest) => {
+            getStatistics: (slug: string, options?: import("wfm-api-client").CallOptions) => Promise<import("wfm-api-client").StatisticsCollection>;
+        }>>;
+        rivens: ReturnType<(request: import("wfm-api-client").WfmRequest) => ReturnType<(request: import("wfm-api-client").WfmRequest) => {
+            listWeapons: (options?: import("wfm-api-client").CallOptions) => Promise<import("wfm-api-client").RivenItem[]>;
+            getWeapon: (slug: string, options?: import("wfm-api-client").CallOptions) => Promise<import("wfm-api-client").RivenItem>;
+            listAttributes: (options?: import("wfm-api-client").CallOptions) => Promise<import("wfm-api-client").RivenAttribute[]>;
+        }> & ReturnType<(request: import("wfm-api-client").WfmRequest) => {
+            getOrders: (weaponUrlName: string, options?: import("wfm-api-client").CallOptions) => Promise<import("wfm-api-client").RivenOrder[]>;
+        }>>;
+        orders: ReturnType<(request: import("wfm-api-client").WfmRequest) => ReturnType<(request: import("wfm-api-client").WfmRequest) => {
+            getRecent: (options?: import("wfm-api-client").CallOptions) => Promise<import("wfm-api-client").Order[]>;
+            listByItem: (ref: import("wfm-api-client").ItemRef, options?: import("wfm-api-client").CallOptions) => Promise<import("wfm-api-client").Order[]>;
+            getTopByItem: (ref: import("wfm-api-client").ItemRef, query?: import("wfm-api-client").TopOrdersQuery, options?: import("wfm-api-client").CallOptions) => Promise<import("wfm-api-client").TopOrders>;
+            listByUser: (ref: import("wfm-api-client").UserRef, options?: import("wfm-api-client").CallOptions) => Promise<import("wfm-api-client").Order[]>;
+            listMine: (options?: import("wfm-api-client").CallOptions) => Promise<import("wfm-api-client").Order[]>;
+            get: (id: string, options?: import("wfm-api-client").CallOptions) => Promise<import("wfm-api-client").Order>;
+            create: (body: import("wfm-api-client").CreateOrderBody, options?: import("wfm-api-client").CallOptions) => Promise<import("wfm-api-client").Order>;
+            update: (id: string, body: import("wfm-api-client").UpdateOrderBody, options?: import("wfm-api-client").CallOptions) => Promise<import("wfm-api-client").Order>;
+            delete: (id: string, options?: import("wfm-api-client").CallOptions) => Promise<import("wfm-api-client").Order>;
+            close: (id: string, body: import("wfm-api-client").CloseOrderBody, options?: import("wfm-api-client").CallOptions) => Promise<import("wfm-api-client").Transaction>;
+            updateGroupVisibility: (id: string, body: import("wfm-api-client").UpdateOrderGroupVisibilityBody, options?: import("wfm-api-client").CallOptions) => Promise<{
+                updated: number;
+            }>;
+        }>>;
+        users: ReturnType<(request: import("wfm-api-client").WfmRequest) => ReturnType<(request: import("wfm-api-client").WfmRequest) => {
+            getMe: (options?: import("wfm-api-client").CallOptions) => Promise<import("wfm-api-client").UserPrivate>;
+            updateMe: (body: import("wfm-api-client").UpdateMeBody, options?: import("wfm-api-client").CallOptions) => Promise<import("wfm-api-client").UserPrivate>;
+            uploadAvatar: (file: import("wfm-api-client").UploadBody, filename?: string, options?: import("wfm-api-client").CallOptions) => Promise<import("wfm-api-client").UserPrivate>;
+            uploadBackground: (file: import("wfm-api-client").UploadBody, filename?: string, options?: import("wfm-api-client").CallOptions) => Promise<import("wfm-api-client").UserPrivate>;
+            get: (ref: import("wfm-api-client").UserRef, options?: import("wfm-api-client").CallOptions) => Promise<import("wfm-api-client").User>;
+        }>>;
+        liches: ReturnType<(request: import("wfm-api-client").WfmRequest) => ReturnType<(request: import("wfm-api-client").WfmRequest) => {
+            listWeapons: (options?: import("wfm-api-client").CallOptions) => Promise<import("wfm-api-client").LichWeapon[]>;
+            getWeapon: (slug: string, options?: import("wfm-api-client").CallOptions) => Promise<import("wfm-api-client").LichWeapon>;
+            listEphemeras: (options?: import("wfm-api-client").CallOptions) => Promise<import("wfm-api-client").LichEphemera[]>;
+            listQuirks: (options?: import("wfm-api-client").CallOptions) => Promise<import("wfm-api-client").LichQuirk[]>;
+        }>>;
+        sisters: ReturnType<(request: import("wfm-api-client").WfmRequest) => ReturnType<(request: import("wfm-api-client").WfmRequest) => {
+            listWeapons: (options?: import("wfm-api-client").CallOptions) => Promise<import("wfm-api-client").SisterWeapon[]>;
+            getWeapon: (slug: string, options?: import("wfm-api-client").CallOptions) => Promise<import("wfm-api-client").SisterWeapon>;
+            listEphemeras: (options?: import("wfm-api-client").CallOptions) => Promise<import("wfm-api-client").SisterEphemera[]>;
+            listQuirks: (options?: import("wfm-api-client").CallOptions) => Promise<import("wfm-api-client").SisterQuirk[]>;
+        }>>;
+        manifests: ReturnType<(request: import("wfm-api-client").WfmRequest) => ReturnType<(request: import("wfm-api-client").WfmRequest) => {
+            getVersions: (options?: import("wfm-api-client").CallOptions) => Promise<import("wfm-api-client").Versions>;
+            listLocations: (options?: import("wfm-api-client").CallOptions) => Promise<import("wfm-api-client").Location[]>;
+            listNpcs: (options?: import("wfm-api-client").CallOptions) => Promise<import("wfm-api-client").Npc[]>;
+            listMissions: (options?: import("wfm-api-client").CallOptions) => Promise<import("wfm-api-client").Mission[]>;
+        }>>;
+        achievements: ReturnType<(request: import("wfm-api-client").WfmRequest) => ReturnType<(request: import("wfm-api-client").WfmRequest) => {
+            list: (options?: import("wfm-api-client").CallOptions) => Promise<import("wfm-api-client").Achievement[]>;
+            listByUser: (ref: import("wfm-api-client").UserRef, query?: {
+                featured?: boolean;
+            }, options?: import("wfm-api-client").CallOptions) => Promise<import("wfm-api-client").Achievement[]>;
+        }>>;
+        dashboard: ReturnType<(request: import("wfm-api-client").WfmRequest) => ReturnType<(request: import("wfm-api-client").WfmRequest) => {
+            getShowcase: (options?: import("wfm-api-client").CallOptions) => Promise<import("wfm-api-client").DashboardShowcase>;
+        }>>;
+        tools: ReturnType<(request: import("wfm-api-client").WfmRequest) => ReturnType<(request: import("wfm-api-client").WfmRequest) => {
+            getDucatnator: (options?: import("wfm-api-client").CallOptions) => Promise<{
                 day: import("wfm-api-client").Ducatnator[];
                 hour: import("wfm-api-client").Ducatnator[];
-            } | undefined>;
-        };
+            }>;
+        }>>;
+        setAccessToken: (token: string | undefined) => void;
     };
 }
 declare module "warframe/data/wfm/globalRivenAttribute" {
@@ -532,9 +688,26 @@ declare module "warframe/infrastructure/ocr-api" {
     import type { OcrAPISecret } from "warframe/types/index";
     export function extractTextFromImage(image: string | Blob, secret: OcrAPISecret): Promise<string[] | undefined>;
 }
+declare module "warframe/infrastructure/wf/bounty-adapter" {
+    import type { BountyBoard, BountyLocation, BountyRewardRarity, OracleBountyCycle, RawSyndicateMission } from "warframe/types/index";
+    export const bountyLocationTag: Record<BountyLocation, string>;
+    /** Locations whose Jobs are empty in official WorldState; use browse.wf Oracle. */
+    export const oracleBountyLocations: Set<BountyLocation>;
+    /**
+     * Map drop probability to 铜/银/金 within one stage.
+     * Highest unique probability → bronze, lowest → gold, middle → silver.
+     * With only two buckets: highest → bronze, lower → silver.
+     */
+    export function rarityFromStageProbabilities(probability: number, uniqueSortedDesc: number[]): BountyRewardRarity;
+    export function resolveExportItemNameZh(sourceKey: string): string;
+    export function adaptBountyBoard(location: BountyLocation, mission: RawSyndicateMission | undefined): BountyBoard | undefined;
+    export function findRawSyndicateMission(missions: RawSyndicateMission[], location: BountyLocation): RawSyndicateMission | undefined;
+    export function formatOracleChallenge(challengePath: string): string;
+    export function adaptOracleBountyBoard(location: 'zariman' | 'cavia' | 'hex', cycle: OracleBountyCycle | undefined): BountyBoard | undefined;
+}
 declare module "warframe/services/wf-service" {
     import type { WeeklyRiven } from 'warframe-weekly-rivens';
-    import type { Arbitration, ArchiMedea, ArchonHunt, Fissure, OcrAPISecret, Relic, RivenAttribute, RivenStatAnalyzeResult, RivenStatResult, VoidTrader, WarframeResult } from "warframe/types/index";
+    import type { Arbitration, ArchiMedea, ArchonHunt, BountyBoard, BountyLocation, Fissure, OcrAPISecret, Relic, RivenAttribute, RivenStatAnalyzeResult, RivenStatResult, 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[]>;
@@ -544,6 +717,7 @@ declare module "warframe/services/wf-service" {
         temporalArchimedea: ArchiMedea;
     }>>;
     export function getEnvironment(): Promise<string>;
+    export function getBounty(location: BountyLocation): Promise<WarframeResult<BountyBoard>>;
     export function getCircuitWeek(): {
         currentIncarnons: number;
         currentWarframes: number;
@@ -758,6 +932,7 @@ declare module "i18n" {
         readonly 'relic.dataLoading': "遗物数据未加载完成，请稍后再试";
         readonly 'relic.notFound': "未找到对应遗物信息";
         readonly 'arbitration.invalidDayRange': "天数需小于等于14且大于0";
+        readonly 'bounty.unavailable': "当前该地点暂无可用赏金";
         readonly 'voidTrader.drifting': "虚空商人仍在未知地带漂流...";
         readonly 'voidTrader.arriving': "距离虚空商人到达还有: {time}";
         readonly 'riven.imageNotFound': "未检测到图片";
@@ -819,10 +994,11 @@ declare module "utils/index" {
 declare module "components/wf" {
     import type { Element } from 'koishi';
     import type { WeeklyRiven } from 'warframe-weekly-rivens';
-    import type { Arbitration, ArchiMedea, ArchonHunt, Fissure, OutputRelic, RivenStatAnalyzeResult, RivenStatResult, VoidTrader } from "warframe/index";
+    import type { Arbitration, ArchiMedea, ArchonHunt, BountyBoard, Fissure, OutputRelic, RivenStatAnalyzeResult, RivenStatResult, 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;
+    export function BountyComponent(board: BountyBoard): Element;
     export function WeeklyRivenComponent(items: WeeklyRiven[], minPrice: number): Element;
     export function WeeklyComponent(archon: ArchonHunt, deepArchimedea: ArchiMedea, temporalArchimedea: ArchiMedea): Element;
     export function RelicComponent(relic: OutputRelic): Element;
@@ -846,6 +1022,12 @@ declare module "commands/wf" {
         weeklyCommand: (_action: Argv) => Promise<string>;
         weeklyRivenCommand: (_action: Argv, minPrice?: number) => Promise<string>;
         environmentCommand: () => Promise<string>;
+        bountyCetusCommand: () => Promise<string>;
+        bountyFortunaCommand: () => Promise<string>;
+        bountyDeimosCommand: () => Promise<string>;
+        bountyZarimanCommand: () => Promise<string>;
+        bountyCaviaCommand: () => Promise<string>;
+        bountyHexCommand: () => Promise<string>;
     };
 }
 declare module "components/render" {