@fireballgg/sdk 0.0.1

package/dist/index.d.ts

@@ -0,0 +1,1691 @@
+import { E as EffectTriggerType, D as DungeonModel, a as DungeonType, L as LootSubType, F as FishingType, b as FishingModel, c as LootType, A as ActiveEffectType, Q as QuestItemType, d as AvailableDungeonsResponse, e as EnergyResponse, f as FishingStateResponse, G as GameAction, g as FishingCard, R as Rarity, C as Checkpoint, h as DungeonLegacyType, i as DungeonPreset, j as EggType, k as Faction, l as FishMoveStrategy, m as GameType, J as JobStatus, N as Node, n as NotificationType, o as RomMemory, p as RomTier, S as SparkTransactionType, q as GameInventoryEntity, r as GigaverseApi, s as ResourceType, t as RomEntity, u as ServiceType } from './index-D5hv4Edu.js';
+export { v as Action, w as ActionType, x as DungeonGearSlot, y as EffectPlayerType, z as FishingAction, B as FishingGearSlot, H as GameOutcome, I as GearSlot, K as GearType, M as GigaverseApi, O as ItemType, P as LogLevel, T as LogType, U as LootAction, V as OtherAction, W as PetType, X as QuestType, Y as Scroll, Z as Skill, _ as SkillId, $ as StatusEffectType, a0 as ToolGearSlot } from './index-D5hv4Edu.js';
+import { z } from 'zod';
+import { Logger } from './logger/index.js';
+export { i as FireballApi } from './index-DO_0xTs_.js';
+export { i as JuicedSubgraph } from './index-BPihDahL.js';
+export { i as JuicedApi } from './index-DKZ1Igbv.js';
+import 'exponential-backoff';
+import 'pino';
+import 'pino-pretty';
+import '@graphql-typed-document-node/core';
+import 'graphql';
+import 'graphql-request';
+
+declare const GIGAVERSE_ENDPOINT = "https://gigaverse.io/api";
+declare const SQS_ENDPOINT = "https://sqs.eu-central-1.amazonaws.com/260123625827/fireball-job-runner-prod";
+declare const SQS_DLQ_ENDPOINT = "https://sqs.eu-central-1.amazonaws.com/260123625827/fireball-job-runner-dlq-prod";
+declare const SQS_TEST_ENDPOINT = "https://sqs.eu-central-1.amazonaws.com/260123625827/fireball-job-runner-dev";
+declare const DISCORD_URL = "https://discord.gg/fireball";
+declare const ROMS_CONTRACT_ADDRESS = "0x59eec556cef447e13edf4bfd3d4433d8dad8a7a5";
+declare const PETS_CONTRACT_ADDRESS = "0xd320831c876190c7ef79376ffcc889756f038e04";
+declare const SPARKS_CONTRACT_ADDRESS = "0x13a59f08f11e38e4766bf206a31473a510c83475";
+declare const SPARK_PRICE: bigint;
+declare const SPARK_PRICE_IN_ETH = 0.000003;
+declare const REFERRAL_PERCENTAGE: bigint;
+declare const FIVE_MINUTES_FROM_NOW: number;
+declare const TEN_MINUTES_FROM_NOW: number;
+declare const FIFTEEN_MINUTES_FROM_NOW: number;
+declare const DAILY_RESET_HOUR_UTC = 18;
+declare const DAILY_RESET_MINUTE_UTC = 0;
+declare const LEVEL_THRESHOLD = 26;
+declare const DEFAULT_CRIT_PROTECTION = 5;
+declare const MIN_CRIT_PROTECTION = 0;
+declare const MAX_CRIT_PROTECTION = 50;
+declare const CRIT_DAMAGE_MULTIPLIER = 2;
+declare const DEFAULT_NERF_THRESHOLD = 20;
+declare const MIN_NERF_THRESHOLD = -50;
+declare const MAX_NERF_THRESHOLD = 50;
+declare const RESTORE_CONSUMABLES_IDS: number[];
+declare const HEALING_CONSUMABLES_IDS: number[];
+declare const ARMOR_CONSUMABLES_IDS: number[];
+declare const WEAK_CONSUMABLES_IDS: number[];
+declare const VULNERABLE_CONSUMABLES_IDS: number[];
+declare const BOOM_CONSUMABLES_IDS: number[];
+declare const SEAWEED_ITEM_ID = 333;
+declare const FACTION_DUST_ITEM_IDS: {
+    readonly CRUSADER: 73;
+    readonly OVERSEER: 74;
+    readonly ATHENA: 75;
+    readonly ARCHON: 76;
+    readonly FOXGLOVE: 77;
+    readonly SUMMONER: 78;
+    readonly CHOBO: 79;
+    readonly GIGUS: 101;
+};
+declare const NOOB_CHEST_RECIPE_ID = "700000";
+declare const BLUE_POT_RECIPE_ID = "700001";
+declare const TAN_POT_RECIPE_ID = "700002";
+declare const JUICED_CHEST_RECIPE_ID = "700003";
+declare const PAPER_HANDS_RECIPE_ID = "50234";
+declare const ROCK_HANDS_RECIPE_ID = "50235";
+declare const PAPER_HANDS_ID = 234;
+declare const ROCK_HANDS_ID = 235;
+declare const CHIMPU_LURE_ID = 573;
+declare const DURABILITY_PER_USE = 2;
+declare const PAPER_HANDS_BASE_DURABILITY = 12;
+declare const ROCK_HANDS_BASE_DURABILITY = 24;
+declare const MAX_REPAIRS_BEFORE_RESET = 1;
+declare const RECIPE_LOOT_COUNTS: Record<string, number>;
+declare const HATCHERY_FUEL_ITEM_ID = 576;
+declare const HATCHERY_COMFORT_ITEM_ID = 578;
+declare const GAME_ACTION_DELAY_MS = 100;
+declare const GEAR_REPAIR_DELAY_MS = 5000;
+
+type Recipe = {
+    docId: string;
+    ID_CID: string;
+    NAME_CID: string;
+    FACTION_CID_array: number[];
+    GEAR_TYPE_CID: number;
+    DURABILITY_CID: number;
+    TIER_CID: number;
+    UINT256_CID: number;
+    INPUT_NAMES_CID_array: string[];
+    INPUT_ID_CID_array: number[];
+    INPUT_AMOUNT_CID_array: number[];
+    LOOT_ID_CID_array: number[];
+    LOOT_AMOUNT_CID_array: number[];
+    LOOT_FULFILLER_ID_CID_array: string[];
+    TIME_BETWEEN_CID: number;
+    TAG_CID_array: string[];
+    SUCCESS_RATE_CID: number;
+    COOLDOWN_CID: number;
+    MAX_COMPLETIONS_CID: number;
+    ENERGY_CID: number;
+    IS_JUICED_CID: boolean;
+    JUICED_MULTIPLIER_CID: number;
+    IS_DAILY_CID: boolean;
+    IS_WEEKLY_CID: boolean;
+};
+type CheckpointType = {
+    docId: string;
+    ID_CID: string;
+    NAME_CID: string;
+    DESCRIPTION_CID: string;
+    INPUT_ID_CID_array: number[];
+    INPUT_AMOUNT_CID_array: number[];
+    UINT256_CID_array: number[];
+    MAX_COMPLETIONS_CID: number;
+};
+interface Gear {
+    id: number;
+    slot: number;
+    rarity: number;
+    durability: number;
+    docId: string;
+    repairCount?: number;
+    isGear?: boolean;
+}
+interface JobMessage {
+    id: string;
+    accountId: string;
+    completedRuns: number;
+    totalRuns: number;
+    type: number;
+    model: number;
+    isAutoclaimOn: boolean;
+    isAutorepairOn: boolean;
+    isJuiced: boolean;
+    consumables: number[] | null;
+    equipment?: string[];
+}
+interface Loot {
+    id: number;
+    id_array: number[];
+    rarity: number;
+    val1: number;
+    val2: number;
+    name: LootType;
+}
+type EquipmentOptimized = [
+    number,
+    number,
+    number,
+    LootSubType
+];
+interface DungeonJobOptions {
+    model: DungeonModel;
+    type: DungeonType;
+    autorepair: boolean;
+    critProtection?: number;
+    nerfThreshold?: number;
+    skipLastRoom?: boolean;
+    isJuiced: boolean;
+    consumables: number[] | null;
+    tier?: number;
+    equipment?: string[];
+    aggression?: number;
+}
+interface FishingJobOptions {
+    type: FishingType;
+    model: FishingModel;
+    autorepair: boolean;
+    useJebaitor?: boolean;
+}
+type JobOptions = DungeonJobOptions | FishingJobOptions;
+interface QuestItemScroll {
+    type: QuestItemType.SCROLL;
+    id: number;
+    amount: number;
+}
+interface QuestItemXP {
+    type: QuestItemType.XP;
+    amount: number;
+}
+type QuestItem = QuestItemScroll | QuestItemXP;
+interface SparksUserData {
+    totalSparksPurchased: bigint | null;
+    periodSparksPurchased: bigint | null;
+    lastPeriodStart: bigint | null;
+}
+interface SparksContractData {
+    paused: boolean | null;
+    treasury: string | null;
+    periodSparkLimit: bigint | null;
+    limitPeriodDuration: bigint | null;
+    totalSparksSold: bigint | null;
+    totalEthReceived: bigint | null;
+    totalPayments: number | null;
+}
+declare const ALLOWED_TRIGGER_TYPES: readonly [EffectTriggerType.ON_DEATH, EffectTriggerType.ON_DAMAGE];
+type AllowedTriggerType = (typeof ALLOWED_TRIGGER_TYPES)[number];
+type OptimizedActiveEffect = [string, string, [ActiveEffectType, number][]];
+
+declare const getDungeonNameWithEmoji: (dungeonType: DungeonType) => string;
+/**
+ * Helper method to get the index of a GameAction in the values array
+ * @param action The GameAction to find the index for
+ * @returns The index (0 for ROCK, 1 for PAPER, 2 for SCISSOR) or -1 if not found
+ */
+declare const getActionIndex: (action: GameAction) => number;
+/**
+ * Helper method to get an enemy by its ID
+ * @param id The ID of the enemy to find
+ * @returns The enemy object or undefined if not found
+ */
+declare const getEnemyById: (id: number) => {
+    docId: string;
+    ID_CID: string;
+    EQUIPMENT_HEAD_CID: number;
+    EQUIPMENT_BODY_CID: number;
+    NAME_CID: string;
+    LOOT_ID_CID: number;
+    MOVE_STATS_CID_array: number[];
+} | undefined;
+/**
+ * Helper method to get an enemy name by its ID
+ * @param id The ID of the enemy to find
+ * @returns The enemy name or "unknown enemy" if not found
+ */
+declare const getEnemyNameById: (id: number) => string;
+/**
+ * Returns the appropriate suffix (ATK or DEF) for upgrade loot types
+ * based on which value is non-zero
+ *
+ * @param lootType The type of loot
+ * @param val1 First value (typically ATK)
+ * @param val2 Second value (typically DEF)
+ * @returns The appropriate suffix string
+ */
+declare function getLootTypeSuffix(lootType: LootType, val1: number, val2: number): string;
+declare function getLootTypeSuffixOptimized(lootType: LootType, subType: LootSubType): string;
+/**
+ * Formats a loot name with the appropriate name and suffix
+ *
+ * @param lootType The type of loot
+ * @param val1 First value (typically ATK)
+ * @param val2 Second value (typically DEF)
+ * @returns Formatted string representing the loot name
+ */
+declare function formatLootName(lootType: LootType, val1: number, val2: number, minified?: boolean): string;
+declare function formatLootNameOptimized(lootTypeIndex: number, subType: LootSubType): string;
+declare function getLootSubType(lootType: LootType, val1: number): LootSubType;
+/**
+ * Capitalizes the first letter of a string
+ *
+ * @param str The string to capitalize
+ * @returns The capitalized string
+ */
+declare function capitalize(str: string): string;
+/**
+ * Helper method to get an item by its ID
+ * @param id The ID of the item to find
+ * @returns The item object or undefined if not found
+ */
+declare const getItemById: (id: number) => {
+    ID_CID: number;
+    docId: string;
+    NAME_CID: string;
+    DESCRIPTION_CID: string;
+    RARITY_CID: number;
+    RARITY_NAME: string;
+    IMG_URL_CID: string;
+    ICON_URL_CID: string;
+    TYPE_CID: string;
+    GUIDE_CID?: undefined;
+    SPRITE_SHEET_URL_CID?: undefined;
+    CARD_CID_array?: undefined;
+    itemEffect?: undefined;
+    SIZE_CID?: undefined;
+    START_TIMESTAMP_CID?: undefined;
+    END_TIMESTAMP_CID?: undefined;
+    VFX?: undefined;
+    IS_WEEKLY_CID?: undefined;
+    LOOT_TABLE_CID?: undefined;
+} | {
+    ID_CID: number;
+    docId: string;
+    NAME_CID: string;
+    DESCRIPTION_CID: string;
+    RARITY_CID: number;
+    RARITY_NAME: string;
+    IMG_URL_CID: string;
+    ICON_URL_CID: string;
+    TYPE_CID: string;
+    GUIDE_CID: string;
+    SPRITE_SHEET_URL_CID?: undefined;
+    CARD_CID_array?: undefined;
+    itemEffect?: undefined;
+    SIZE_CID?: undefined;
+    START_TIMESTAMP_CID?: undefined;
+    END_TIMESTAMP_CID?: undefined;
+    VFX?: undefined;
+    IS_WEEKLY_CID?: undefined;
+    LOOT_TABLE_CID?: undefined;
+} | {
+    ID_CID: number;
+    docId: string;
+    NAME_CID: string;
+    DESCRIPTION_CID: string;
+    RARITY_CID: number;
+    RARITY_NAME: string;
+    IMG_URL_CID: string;
+    ICON_URL_CID: string;
+    TYPE_CID: string;
+    SPRITE_SHEET_URL_CID: string;
+    GUIDE_CID?: undefined;
+    CARD_CID_array?: undefined;
+    itemEffect?: undefined;
+    SIZE_CID?: undefined;
+    START_TIMESTAMP_CID?: undefined;
+    END_TIMESTAMP_CID?: undefined;
+    VFX?: undefined;
+    IS_WEEKLY_CID?: undefined;
+    LOOT_TABLE_CID?: undefined;
+} | {
+    ID_CID: number;
+    docId: string;
+    NAME_CID: string;
+    DESCRIPTION_CID: string;
+    RARITY_CID: number;
+    RARITY_NAME: string;
+    IMG_URL_CID: string;
+    ICON_URL_CID: string;
+    TYPE_CID: string;
+    CARD_CID_array: number[];
+    GUIDE_CID: string;
+    SPRITE_SHEET_URL_CID?: undefined;
+    itemEffect?: undefined;
+    SIZE_CID?: undefined;
+    START_TIMESTAMP_CID?: undefined;
+    END_TIMESTAMP_CID?: undefined;
+    VFX?: undefined;
+    IS_WEEKLY_CID?: undefined;
+    LOOT_TABLE_CID?: undefined;
+} | {
+    ID_CID: number;
+    docId: string;
+    NAME_CID: string;
+    DESCRIPTION_CID: string;
+    RARITY_CID: number;
+    RARITY_NAME: string;
+    IMG_URL_CID: string;
+    ICON_URL_CID: string;
+    TYPE_CID: string;
+    GUIDE_CID: string;
+    itemEffect: {
+        effects: {
+            triggerType: string;
+            effects: {
+                type: string;
+                amount: number;
+                playerType: string;
+                statusType: string;
+            }[];
+            durabilityChange: number;
+            playerType: string;
+        }[];
+    };
+    SPRITE_SHEET_URL_CID?: undefined;
+    CARD_CID_array?: undefined;
+    SIZE_CID?: undefined;
+    START_TIMESTAMP_CID?: undefined;
+    END_TIMESTAMP_CID?: undefined;
+    VFX?: undefined;
+    IS_WEEKLY_CID?: undefined;
+    LOOT_TABLE_CID?: undefined;
+} | {
+    ID_CID: number;
+    docId: string;
+    NAME_CID: string;
+    DESCRIPTION_CID: string;
+    RARITY_CID: number;
+    RARITY_NAME: string;
+    IMG_URL_CID: string;
+    ICON_URL_CID: string;
+    GUIDE_CID: string;
+    TYPE_CID?: undefined;
+    SPRITE_SHEET_URL_CID?: undefined;
+    CARD_CID_array?: undefined;
+    itemEffect?: undefined;
+    SIZE_CID?: undefined;
+    START_TIMESTAMP_CID?: undefined;
+    END_TIMESTAMP_CID?: undefined;
+    VFX?: undefined;
+    IS_WEEKLY_CID?: undefined;
+    LOOT_TABLE_CID?: undefined;
+} | {
+    ID_CID: number;
+    docId: string;
+    NAME_CID: string;
+    RARITY_CID: number;
+    RARITY_NAME: string;
+    IMG_URL_CID: string;
+    ICON_URL_CID: string;
+    TYPE_CID: string;
+    DESCRIPTION_CID?: undefined;
+    GUIDE_CID?: undefined;
+    SPRITE_SHEET_URL_CID?: undefined;
+    CARD_CID_array?: undefined;
+    itemEffect?: undefined;
+    SIZE_CID?: undefined;
+    START_TIMESTAMP_CID?: undefined;
+    END_TIMESTAMP_CID?: undefined;
+    VFX?: undefined;
+    IS_WEEKLY_CID?: undefined;
+    LOOT_TABLE_CID?: undefined;
+} | {
+    ID_CID: number;
+    docId: string;
+    NAME_CID: string;
+    RARITY_CID: number;
+    SPRITE_SHEET_URL_CID: string;
+    DESCRIPTION_CID?: undefined;
+    RARITY_NAME?: undefined;
+    IMG_URL_CID?: undefined;
+    ICON_URL_CID?: undefined;
+    TYPE_CID?: undefined;
+    GUIDE_CID?: undefined;
+    CARD_CID_array?: undefined;
+    itemEffect?: undefined;
+    SIZE_CID?: undefined;
+    START_TIMESTAMP_CID?: undefined;
+    END_TIMESTAMP_CID?: undefined;
+    VFX?: undefined;
+    IS_WEEKLY_CID?: undefined;
+    LOOT_TABLE_CID?: undefined;
+} | {
+    ID_CID: number;
+    docId: string;
+    NAME_CID: string;
+    RARITY_CID: number;
+    RARITY_NAME: string;
+    IMG_URL_CID: string;
+    ICON_URL_CID: string;
+    TYPE_CID: string;
+    SIZE_CID: string;
+    GUIDE_CID: string;
+    DESCRIPTION_CID?: undefined;
+    SPRITE_SHEET_URL_CID?: undefined;
+    CARD_CID_array?: undefined;
+    itemEffect?: undefined;
+    START_TIMESTAMP_CID?: undefined;
+    END_TIMESTAMP_CID?: undefined;
+    VFX?: undefined;
+    IS_WEEKLY_CID?: undefined;
+    LOOT_TABLE_CID?: undefined;
+} | {
+    ID_CID: number;
+    docId: string;
+    NAME_CID: string;
+    RARITY_CID: number;
+    RARITY_NAME: string;
+    IMG_URL_CID: string;
+    ICON_URL_CID: string;
+    TYPE_CID: string;
+    SIZE_CID: string;
+    START_TIMESTAMP_CID: number;
+    GUIDE_CID: string;
+    DESCRIPTION_CID?: undefined;
+    SPRITE_SHEET_URL_CID?: undefined;
+    CARD_CID_array?: undefined;
+    itemEffect?: undefined;
+    END_TIMESTAMP_CID?: undefined;
+    VFX?: undefined;
+    IS_WEEKLY_CID?: undefined;
+    LOOT_TABLE_CID?: undefined;
+} | {
+    ID_CID: number;
+    docId: string;
+    NAME_CID: string;
+    RARITY_CID: number;
+    RARITY_NAME: string;
+    IMG_URL_CID: string;
+    ICON_URL_CID: string;
+    TYPE_CID: string;
+    SIZE_CID: string;
+    START_TIMESTAMP_CID: number;
+    END_TIMESTAMP_CID: number;
+    GUIDE_CID: string;
+    DESCRIPTION_CID?: undefined;
+    SPRITE_SHEET_URL_CID?: undefined;
+    CARD_CID_array?: undefined;
+    itemEffect?: undefined;
+    VFX?: undefined;
+    IS_WEEKLY_CID?: undefined;
+    LOOT_TABLE_CID?: undefined;
+} | {
+    ID_CID: number;
+    docId: string;
+    NAME_CID: string;
+    RARITY_CID: number;
+    IMG_URL_CID: string;
+    ICON_URL_CID: string;
+    TYPE_CID: string;
+    SPRITE_SHEET_URL_CID: string;
+    DESCRIPTION_CID?: undefined;
+    RARITY_NAME?: undefined;
+    GUIDE_CID?: undefined;
+    CARD_CID_array?: undefined;
+    itemEffect?: undefined;
+    SIZE_CID?: undefined;
+    START_TIMESTAMP_CID?: undefined;
+    END_TIMESTAMP_CID?: undefined;
+    VFX?: undefined;
+    IS_WEEKLY_CID?: undefined;
+    LOOT_TABLE_CID?: undefined;
+} | {
+    ID_CID: number;
+    docId: string;
+    NAME_CID: string;
+    RARITY_CID: number;
+    RARITY_NAME: string;
+    IMG_URL_CID: string;
+    ICON_URL_CID: string;
+    TYPE_CID: string;
+    SPRITE_SHEET_URL_CID: string;
+    DESCRIPTION_CID?: undefined;
+    GUIDE_CID?: undefined;
+    CARD_CID_array?: undefined;
+    itemEffect?: undefined;
+    SIZE_CID?: undefined;
+    START_TIMESTAMP_CID?: undefined;
+    END_TIMESTAMP_CID?: undefined;
+    VFX?: undefined;
+    IS_WEEKLY_CID?: undefined;
+    LOOT_TABLE_CID?: undefined;
+} | {
+    ID_CID: number;
+    docId: string;
+    NAME_CID: string;
+    DESCRIPTION_CID: string;
+    RARITY_CID: number;
+    RARITY_NAME: string;
+    IMG_URL_CID: string;
+    ICON_URL_CID: string;
+    TYPE_CID: string;
+    CARD_CID_array: number[];
+    GUIDE_CID?: undefined;
+    SPRITE_SHEET_URL_CID?: undefined;
+    itemEffect?: undefined;
+    SIZE_CID?: undefined;
+    START_TIMESTAMP_CID?: undefined;
+    END_TIMESTAMP_CID?: undefined;
+    VFX?: undefined;
+    IS_WEEKLY_CID?: undefined;
+    LOOT_TABLE_CID?: undefined;
+} | {
+    ID_CID: number;
+    docId: string;
+    NAME_CID: string;
+    DESCRIPTION_CID: string;
+    RARITY_CID: number;
+    IMG_URL_CID: string;
+    ICON_URL_CID: string;
+    TYPE_CID: string;
+    VFX: string;
+    SPRITE_SHEET_URL_CID: string;
+    RARITY_NAME?: undefined;
+    GUIDE_CID?: undefined;
+    CARD_CID_array?: undefined;
+    itemEffect?: undefined;
+    SIZE_CID?: undefined;
+    START_TIMESTAMP_CID?: undefined;
+    END_TIMESTAMP_CID?: undefined;
+    IS_WEEKLY_CID?: undefined;
+    LOOT_TABLE_CID?: undefined;
+} | {
+    ID_CID: number;
+    docId: string;
+    NAME_CID: string;
+    DESCRIPTION_CID: string;
+    RARITY_CID: number;
+    RARITY_NAME: string;
+    IMG_URL_CID: string;
+    ICON_URL_CID: string;
+    TYPE_CID: string;
+    VFX: string;
+    SPRITE_SHEET_URL_CID: string;
+    GUIDE_CID?: undefined;
+    CARD_CID_array?: undefined;
+    itemEffect?: undefined;
+    SIZE_CID?: undefined;
+    START_TIMESTAMP_CID?: undefined;
+    END_TIMESTAMP_CID?: undefined;
+    IS_WEEKLY_CID?: undefined;
+    LOOT_TABLE_CID?: undefined;
+} | {
+    ID_CID: number;
+    docId: string;
+    NAME_CID: string;
+    DESCRIPTION_CID: string;
+    RARITY_CID: number;
+    RARITY_NAME: string;
+    IMG_URL_CID: string;
+    ICON_URL_CID: string;
+    TYPE_CID: string;
+    IS_WEEKLY_CID: boolean;
+    GUIDE_CID: string;
+    SPRITE_SHEET_URL_CID?: undefined;
+    CARD_CID_array?: undefined;
+    itemEffect?: undefined;
+    SIZE_CID?: undefined;
+    START_TIMESTAMP_CID?: undefined;
+    END_TIMESTAMP_CID?: undefined;
+    VFX?: undefined;
+    LOOT_TABLE_CID?: undefined;
+} | {
+    ID_CID: number;
+    docId: string;
+    NAME_CID: string;
+    RARITY_CID: number;
+    RARITY_NAME: string;
+    IMG_URL_CID: string;
+    ICON_URL_CID: string;
+    DESCRIPTION_CID?: undefined;
+    TYPE_CID?: undefined;
+    GUIDE_CID?: undefined;
+    SPRITE_SHEET_URL_CID?: undefined;
+    CARD_CID_array?: undefined;
+    itemEffect?: undefined;
+    SIZE_CID?: undefined;
+    START_TIMESTAMP_CID?: undefined;
+    END_TIMESTAMP_CID?: undefined;
+    VFX?: undefined;
+    IS_WEEKLY_CID?: undefined;
+    LOOT_TABLE_CID?: undefined;
+} | {
+    ID_CID: number;
+    docId: string;
+    NAME_CID: string;
+    DESCRIPTION_CID: string;
+    RARITY_CID: number;
+    RARITY_NAME: string;
+    IMG_URL_CID: string;
+    ICON_URL_CID: string;
+    TYPE_CID: string;
+    LOOT_TABLE_CID: number;
+    GUIDE_CID: string;
+    SPRITE_SHEET_URL_CID?: undefined;
+    CARD_CID_array?: undefined;
+    itemEffect?: undefined;
+    SIZE_CID?: undefined;
+    START_TIMESTAMP_CID?: undefined;
+    END_TIMESTAMP_CID?: undefined;
+    VFX?: undefined;
+    IS_WEEKLY_CID?: undefined;
+} | {
+    ID_CID: number;
+    docId: string;
+    NAME_CID: string;
+    DESCRIPTION_CID: string;
+    RARITY_CID: number;
+    RARITY_NAME: string;
+    IMG_URL_CID: string;
+    ICON_URL_CID: string;
+    TYPE_CID: string;
+    LOOT_TABLE_CID: number;
+    GUIDE_CID?: undefined;
+    SPRITE_SHEET_URL_CID?: undefined;
+    CARD_CID_array?: undefined;
+    itemEffect?: undefined;
+    SIZE_CID?: undefined;
+    START_TIMESTAMP_CID?: undefined;
+    END_TIMESTAMP_CID?: undefined;
+    VFX?: undefined;
+    IS_WEEKLY_CID?: undefined;
+} | {
+    ID_CID: number;
+    docId: string;
+    NAME_CID: string;
+    RARITY_CID: number;
+    RARITY_NAME: string;
+    IMG_URL_CID: string;
+    ICON_URL_CID: string;
+    TYPE_CID: string;
+    LOOT_TABLE_CID: number;
+    DESCRIPTION_CID?: undefined;
+    GUIDE_CID?: undefined;
+    SPRITE_SHEET_URL_CID?: undefined;
+    CARD_CID_array?: undefined;
+    itemEffect?: undefined;
+    SIZE_CID?: undefined;
+    START_TIMESTAMP_CID?: undefined;
+    END_TIMESTAMP_CID?: undefined;
+    VFX?: undefined;
+    IS_WEEKLY_CID?: undefined;
+} | {
+    ID_CID: number;
+    docId: string;
+    NAME_CID: string;
+    RARITY_CID: number;
+    RARITY_NAME: string;
+    IMG_URL_CID: string;
+    ICON_URL_CID: string;
+    TYPE_CID: string;
+    SPRITE_SHEET_URL_CID: string;
+    GUIDE_CID: string;
+    DESCRIPTION_CID?: undefined;
+    CARD_CID_array?: undefined;
+    itemEffect?: undefined;
+    SIZE_CID?: undefined;
+    START_TIMESTAMP_CID?: undefined;
+    END_TIMESTAMP_CID?: undefined;
+    VFX?: undefined;
+    IS_WEEKLY_CID?: undefined;
+    LOOT_TABLE_CID?: undefined;
+} | {
+    ID_CID: number;
+    docId: string;
+    NAME_CID: string;
+    DESCRIPTION_CID: string;
+    RARITY_CID: number;
+    RARITY_NAME: string;
+    IMG_URL_CID: string;
+    ICON_URL_CID: string;
+    TYPE_CID: string;
+    SIZE_CID: string;
+    START_TIMESTAMP_CID: number;
+    END_TIMESTAMP_CID: number;
+    GUIDE_CID?: undefined;
+    SPRITE_SHEET_URL_CID?: undefined;
+    CARD_CID_array?: undefined;
+    itemEffect?: undefined;
+    VFX?: undefined;
+    IS_WEEKLY_CID?: undefined;
+    LOOT_TABLE_CID?: undefined;
+} | {
+    ID_CID: number;
+    docId: string;
+    NAME_CID: string;
+    DESCRIPTION_CID: string;
+    RARITY_CID: number;
+    RARITY_NAME: string;
+    IMG_URL_CID: string;
+    ICON_URL_CID: string;
+    TYPE_CID?: undefined;
+    GUIDE_CID?: undefined;
+    SPRITE_SHEET_URL_CID?: undefined;
+    CARD_CID_array?: undefined;
+    itemEffect?: undefined;
+    SIZE_CID?: undefined;
+    START_TIMESTAMP_CID?: undefined;
+    END_TIMESTAMP_CID?: undefined;
+    VFX?: undefined;
+    IS_WEEKLY_CID?: undefined;
+    LOOT_TABLE_CID?: undefined;
+} | {
+    ID_CID: number;
+    docId: string;
+    NAME_CID: string;
+    DESCRIPTION_CID: string;
+    RARITY_CID: number;
+    RARITY_NAME: string;
+    IMG_URL_CID: string;
+    ICON_URL_CID: string;
+    TYPE_CID: string;
+    SPRITE_SHEET_URL_CID: string;
+    GUIDE_CID: string;
+    CARD_CID_array?: undefined;
+    itemEffect?: undefined;
+    SIZE_CID?: undefined;
+    START_TIMESTAMP_CID?: undefined;
+    END_TIMESTAMP_CID?: undefined;
+    VFX?: undefined;
+    IS_WEEKLY_CID?: undefined;
+    LOOT_TABLE_CID?: undefined;
+} | {
+    ID_CID: number;
+    docId: string;
+    NAME_CID: string;
+    RARITY_CID: number;
+    RARITY_NAME: string;
+    IMG_URL_CID: string;
+    ICON_URL_CID: string;
+    TYPE_CID: string;
+    GUIDE_CID: string;
+    DESCRIPTION_CID?: undefined;
+    SPRITE_SHEET_URL_CID?: undefined;
+    CARD_CID_array?: undefined;
+    itemEffect?: undefined;
+    SIZE_CID?: undefined;
+    START_TIMESTAMP_CID?: undefined;
+    END_TIMESTAMP_CID?: undefined;
+    VFX?: undefined;
+    IS_WEEKLY_CID?: undefined;
+    LOOT_TABLE_CID?: undefined;
+} | undefined;
+/**
+ * Helper method to get an item ID by its name
+/**
+ * @param name The name of the item to find
+ * @returns The item ID or -1 if not found
+ */
+declare const getItemIdByName: (name: string) => number;
+/**
+ * Helper method to get an item name by its ID
+ * @param id The ID of the item to find
+ * @returns The item name or "unknown" if not found
+ */
+declare const getItemNameById: (id: number) => string;
+/**
+ * Helper method to format item with icon and name
+ * @param id The ID of the item
+ * @returns Formatted string with icon (if available) and name
+ */
+declare const getItemIconById: (id: number) => string;
+declare const getGearById: (id: number) => {
+    GAME_ITEM_ID_CID: number;
+    NAME_CID: string;
+    GEAR_TYPE_CID: number;
+    TIER_CID: number;
+    EQUIPPABLE_TO_CID: number;
+    DURABILITY_CID_array: number[];
+    itemEffects: {
+        effects: {
+            triggerType: string;
+            effects: {
+                type: string;
+                amount: number;
+                playerType: string;
+                statusType: string;
+            }[];
+            durabilityChange: number;
+            playerType: string;
+        }[];
+    }[];
+    repairCost: {
+        INPUT_ID_CID_array: number[];
+        INPUT_AMOUNT_CID_array: number[];
+        RESET_INPUT_ID_CID_array: number[];
+        RESET_INPUT_AMOUNT_CID_array: number[];
+    };
+    REPAIR_COUNT_CID: number;
+    LOOT_ID_CID: number;
+    LOOT_AMOUNT_CID: number;
+    TYPE_CID?: undefined;
+} | {
+    GAME_ITEM_ID_CID: number;
+    NAME_CID: string;
+    TYPE_CID: number;
+    EQUIPPABLE_TO_CID: number;
+    DURABILITY_CID_array: number[];
+    itemEffects: {
+        effects: {
+            triggerType: string;
+            effects: {
+                type: string;
+                amount: number;
+                playerType: string;
+                statusType: string;
+            }[];
+            durabilityChange: number;
+            playerType: string;
+        }[];
+    }[];
+    repairCost: {
+        INPUT_ID_CID_array: number[];
+        INPUT_AMOUNT_CID_array: number[];
+        RESET_INPUT_ID_CID_array: number[];
+        RESET_INPUT_AMOUNT_CID_array: number[];
+    };
+    REPAIR_COUNT_CID: number;
+    GEAR_TYPE_CID?: undefined;
+    TIER_CID?: undefined;
+    LOOT_ID_CID?: undefined;
+    LOOT_AMOUNT_CID?: undefined;
+} | {
+    GAME_ITEM_ID_CID: number;
+    NAME_CID: string;
+    GEAR_TYPE_CID: number;
+    TIER_CID: number;
+    EQUIPPABLE_TO_CID: number;
+    DURABILITY_CID_array: number[];
+    itemEffects: {
+        effects: {
+            triggerType: string;
+            effects: {
+                type: string;
+                amount: number;
+                playerType: string;
+                statusType: string;
+            }[];
+            durabilityChange: number;
+            playerType: string;
+        }[];
+    }[];
+    repairCost: never[];
+    REPAIR_COUNT_CID: number;
+    LOOT_ID_CID: number;
+    LOOT_AMOUNT_CID: number;
+    TYPE_CID?: undefined;
+} | undefined;
+/** Transform gear from raw DB array format [id, slot, rarity, durability, repairCount] to typed objects */
+declare function parseGear(gear?: Gear[] | number[][]): Gear[];
+/**
+ * Helper method to get the rarity of an item by its ID
+ * @param id The ID of the item
+ * @returns The rarity of the item
+ */
+declare const getItemRarity: (id: number) => Rarity;
+/**
+ * Delays execution for a specified number of milliseconds
+ * @param ms The number of milliseconds to delay
+ * @returns A promise that resolves after the specified delay
+ */
+declare function delay(ms: number): Promise<void>;
+/**
+ * Validates environment variables against a Zod schema
+ * @param schema The Zod schema to validate against
+ * @param env The environment object to validate (defaults to process.env)
+ * @returns The validated environment variables
+ */
+declare function validateEnv<T extends z.ZodTypeAny>(schema: T, env?: NodeJS.ProcessEnv): z.infer<T>;
+/**
+ * Checks if a noob has enough energy and hasn't reached daily limit for a dungeon type
+ * @param dungeons The dungeons data from legacyClient.getAvailableDungeons()
+ * @param energy The energy data from legacyClient.getNoobEnergy()
+ * @param dungeonType The dungeon type ID to check
+ * @returns Object with success status, message, energy info and progress info
+ */
+declare function checkDungeonEligibility(dungeons: AvailableDungeonsResponse, energy: EnergyResponse, dungeonType: number, isJuiced?: boolean, isJuicedRun?: boolean): {
+    success: boolean;
+    message: string;
+    energyInfo: {
+        current: number;
+        max: number;
+        entryFee: number;
+    };
+    progressInfo: {
+        current: number;
+        max: number;
+    };
+};
+declare function checkFishingEligibility(state: FishingStateResponse, energy: EnergyResponse, type: FishingType, isJuiced?: boolean): {
+    success: boolean;
+    message: string;
+    energyInfo: {
+        current: number;
+        max: number;
+        entryFee: number;
+    };
+    progressInfo: {
+        current: number;
+        max: number;
+    };
+};
+declare const getRoomData: (currentRoom: number) => {
+    floor: number;
+    room: number;
+    normalized: string;
+};
+declare function getRecipe(id: number): Recipe;
+declare function getCheckpoint(id: number): CheckpointType;
+declare function getEnemyLevel(id: number, room: number): number;
+declare function getEnemyLootId(id: number): number;
+declare const getDungeonModelData: (model: DungeonModel) => {
+    name: string;
+};
+declare const getFishingModelData: (model: FishingModel) => {
+    name: string;
+};
+declare const getModelData: (model: DungeonModel | FishingModel) => {
+    name: string;
+};
+/**
+ * Helper method to get a fishing card by its ID
+ * @param id The ID of the fishing card to find
+ * @returns The fishing card object or undefined if not found
+ */
+declare const getFishingCardById: (id: number) => FishingCard | undefined;
+/**
+ * Calculates the total catch value for fishing drops in seaweed currency
+ * Uses fishing exchange rates and applies a multiplier for non-seaweed items
+ *
+ * @param drops Array of drops with itemId and amount
+ * @param options Optional configuration
+ * @param options.ratesMultiplier Multiplier applied to non-seaweed items (default: 1.5)
+ * @returns Total catch value in seaweed currency
+ *
+ * @example
+ * const drops = [
+ *   { itemId: 333, amount: 50 },  // Seaweed
+ *   { itemId: 123, amount: 2 }    // Some fish
+ * ];
+ * const value = calculateFishingCatchValue(drops);
+ * // Returns: seaweed amount + (fish baseVal * amount * multiplier)
+ */
+declare const calculateFishingCatchValue: (drops: {
+    itemId: number;
+    amount: number;
+}[], options?: {
+    ratesMultiplier?: number;
+}) => number;
+/**
+ * Get the base seaweed value for a fish item
+ * @param itemId The fish item ID
+ * @returns The base seaweed value, or null if not found
+ */
+declare const getFishBaseSeaweedValue: (itemId: number) => number | null;
+/**
+ * Get SQS endpoint URL, checking env first then falling back to hardcoded value
+ */
+declare const getSqsEndpoint: () => string;
+/**
+ * Get SQS DLQ endpoint URL, checking env first then falling back to hardcoded value
+ */
+declare const getSqsDlqEndpoint: () => string;
+/**
+ * Get SQS test endpoint URL, checking env first then falling back to hardcoded value
+ */
+declare const getSqsTestEndpoint: () => string;
+/**
+ * Get active SQS endpoint based on USE_TEST_SQS env var
+ */
+declare const getActiveSqsEndpoint: () => string;
+
+declare const GameActionIndexLookup: Record<GameAction, number>;
+declare const DungeonTypeNameLookup: Record<DungeonType, string>;
+declare const FishingTypeNameLookup: Record<FishingType, string>;
+declare const SparkTransactionTypeNameLookup: Record<SparkTransactionType, string>;
+declare const DungeonTypeMaxRoomLookup: Record<DungeonType, number>;
+declare const DungeonTypeMaxRunsLookup: Record<DungeonType, number>;
+declare const DungeonTypeJuicedMaxRunsLookup: Record<DungeonType, number>;
+declare const DungeonTypeEmojiLookup: Record<DungeonType, string>;
+declare const DungeonPresetAggressionLookup: Record<DungeonPreset, number>;
+declare const DungeonTypeCostLookup: Record<DungeonType, number>;
+declare const DungeonTypeLegacyLookup: Record<DungeonType, DungeonLegacyType>;
+declare const DungeonTypeCheckpointLookup: Record<DungeonType, Checkpoint | null>;
+declare const DungeonTypeJuicedLookup: Record<DungeonType, boolean>;
+declare const DungeonLegacyTypeNameLookup: Record<DungeonLegacyType, string>;
+declare const DungeonStatsNameLookup: Record<DungeonLegacyType, Record<number, string>>;
+declare const DungeonModelNameLookup: Record<DungeonModel, string>;
+declare const FishingModelNameLookup: Record<FishingModel, string>;
+declare const DungeonModelVersionLookup: Record<DungeonModel, number>;
+declare const FishingModelVersionLookup: Record<FishingModel, number>;
+declare const GameTypeNameLookup: Record<GameType, string>;
+declare const JobStatusNameLookup: Record<JobStatus, string>;
+declare const FishingTypeCostLookup: Record<FishingType, number>;
+declare const FishingTypeMaxRunsLookup: Record<FishingType, number>;
+declare const FishingTypeJuicedMaxRunsLookup: Record<FishingType, number>;
+declare const FishMoveStrategyNameLookup: Record<FishMoveStrategy, string>;
+declare const RomTierNameIndexLookup: Record<RomTier, number>;
+declare const RomMemoryIndexLookup: Record<RomMemory, number>;
+declare const RarityNameLookup: Record<Rarity, string>;
+declare const RarityShortLookup: Record<Rarity, string>;
+declare const LootTypeNameLookup: Record<LootType, string>;
+declare const LootTypeIndexLookup: Record<LootType, number>;
+declare const LootIndexTypeLookup: Record<number, LootType>;
+declare const GameActionNameLookup: Record<GameAction, string>;
+declare const NodeRecipeIdLookup: Record<Node, string>;
+declare const CheckpointRecipeIdLookup: Record<Checkpoint, string>;
+declare const FactionNameIdLookup: Record<string, Faction>;
+declare const FactionIdNameLookup: Record<Faction, string>;
+declare const FactionDustItemIdLookup: Record<Faction, number | null>;
+declare const EggRarityOrderLookup: Record<EggType, number>;
+declare const EggTypeLookup: Record<EggType, string>;
+declare const StatusEffectModifiers: {
+    readonly Weak: {
+        readonly attackReduction: 0.25;
+    };
+    readonly Vulnerable: {
+        readonly damageIncrease: 0.25;
+    };
+    readonly Burn: {};
+};
+declare const NotificationTypeMetadataLookup: Record<NotificationType, {
+    name: string;
+    description: string;
+}>;
+declare const VoidStatsDescriptionLookup: Record<number, {
+    name: string;
+    description: string;
+}>;
+
+/**
+ * Type definitions for loadout items
+ */
+type GearLoadoutItem = [number, number, number];
+type ConsumableLoadoutItem = [number];
+type LoadoutItem = GearLoadoutItem | ConsumableLoadoutItem;
+
+/**
+ * Auth-related shared types
+ */
+/**
+ * JWT payload for Discord OAuth state
+ * Used for CSRF protection during the OAuth flow
+ */
+interface DiscordOAuthStatePayload {
+    /** Account ID (wallet address) */
+    sub: string;
+    /** Purpose claim to prevent token reuse */
+    purpose: "discord_oauth";
+    /** Issued at timestamp */
+    iat: number;
+    /** Expiration timestamp */
+    exp: number;
+}
+
+/**
+ * Fishing skill progression mappings and utilities
+ */
+declare const FISHING_FIRST_SKILL_SP_TO_LEVEL: Record<number, number>;
+declare const FISHING_OTHER_SKILLS_SP_TO_LEVEL: Record<number, number>;
+declare const FISHING_FIRST_SKILL_SP_REQUIREMENTS: number[];
+declare const FISHING_OTHER_SKILLS_SP_REQUIREMENTS: number[];
+/**
+ * Get the actual level from skill points for fishing skills
+ * @param skillPoints The number of skill points spent
+ * @param isFirstSkill Whether this is the first skill (index 0)
+ * @returns The actual level (0-10)
+ */
+declare const getFishingLevelFromSP: (skillPoints: number, isFirstSkill: boolean) => number;
+/**
+ * Get progress info for current fishing skill level
+ * @param skillPoints The number of skill points spent
+ * @param isFirstSkill Whether this is the first skill (index 0)
+ * @returns Progress information including current level, next level, and progress percentage
+ */
+declare const getFishingLevelProgress: (skillPoints: number, isFirstSkill: boolean) => {
+    currentLevel: number;
+    nextLevel: number;
+    currentSP: number;
+    requiredSP: number;
+    progressPercent: number;
+};
+declare const FISHING_SKILL_INDICES: {
+    readonly STAMINA: 0;
+    readonly ROD_CONTROL: 1;
+    readonly JEBAITOR: 2;
+    readonly WEED_DEALER: 3;
+    readonly TASTE: 4;
+    readonly INTUITION: 5;
+    readonly LUCK: 6;
+    readonly STEADY_HANDS: 7;
+};
+
+/**
+ * Shared fishing utilities for selling fish across client, worker, and service
+ */
+
+declare const DEFAULT_VALUE_THRESHOLD_MULTIPLIER = 1.5;
+declare const DEFAULT_PRESERVE_FISH_AMOUNT = 1;
+/**
+ * Fish with calculated selling information
+ */
+interface FishToSell {
+    id: number;
+    name: string;
+    quantity: number;
+    rawValue: number;
+    valueWithBonus: number;
+    optimalBatchSize: number;
+    estimatedTotal: number;
+    tier?: number;
+    baseExchangeValue: number;
+    currentExchangeValue: number;
+    meetsThreshold: boolean;
+}
+/**
+ * Result of analyzing fish inventory
+ */
+interface FishInventoryAnalysis {
+    fishToSell: FishToSell[];
+    skippedFish: Array<{
+        id: number;
+        name: string;
+        reason: "zero_value" | "below_threshold" | "preserved";
+        currentValue: number;
+        baseValue: number;
+    }>;
+    totalEstimatedValue: number;
+    totalFishCount: number;
+    weedDealerLevel: number;
+    weedDealerBonus: number;
+}
+/**
+ * Exchange rate data from fishing state
+ */
+interface ExchangeRate {
+    id: number;
+    value: number;
+    baseVal: number;
+    tier?: number;
+}
+/**
+ * Calculate the Weed Dealer bonus from fishing skills
+ * @param skills Array of skill data from Gigaverse API
+ * @returns Object with level and bonus multiplier
+ */
+declare function calculateWeedDealerBonus(skills: any[]): {
+    level: number;
+    bonus: number;
+};
+/**
+ * Find the optimal batch size for selling fish to maximize value through rounding
+ * @param valuePerFish The value per fish with Weed Dealer bonus
+ * @param totalQuantity Total quantity available
+ * @returns Optimal batch size and total value
+ */
+declare function findOptimalBatchSize(valuePerFish: number, totalQuantity: number): {
+    batchSize: number;
+    totalValue: number;
+};
+/**
+ * Filter inventory for fish items with balance > 0
+ * @param inventory Game inventory entities
+ * @returns Array of fish items
+ */
+declare function filterFishFromInventory(inventory: GameInventoryEntity[]): GameInventoryEntity[];
+/**
+ * Analyze fish inventory and determine what to sell
+ * @param fishInventory Fish items from inventory
+ * @param exchangeRates Exchange rate data from fishing state
+ * @param weedDealerBonus Weed Dealer skill bonus multiplier
+ * @param valueThresholdMultiplier Multiplier for determining if fish value is high enough to sell
+ * @param preserveRarities Array of numbers indicating how many fish to preserve for each rarity. Pass empty array to sell all. 0 = sell all, >0 = preserve that amount.
+ * @returns Analysis of what fish to sell
+ */
+declare function analyzeFishInventory(fishInventory: GameInventoryEntity[], exchangeRates: ExchangeRate[], weedDealerBonus: number, valueThresholdMultiplier: number, preserveRarities: number[]): FishInventoryAnalysis;
+/**
+ * Prepare fish batches for selling
+ * @param fish Fish to sell with optimal batch size
+ * @returns Array of batches to sell
+ */
+declare function prepareFishBatches(fish: FishToSell): Array<{
+    amount: number;
+    expectedValue: number;
+}>;
+/**
+ * Extract seaweed earned from sell response
+ * @param gameItemBalanceChanges Array of item balance changes from sell response
+ * @returns Amount of seaweed earned
+ */
+declare function extractSeaweedEarned(gameItemBalanceChanges: any[]): number;
+/**
+ * Calculate estimated fish inventory for display (simplified version for UI)
+ * @param inventory Game inventory entities
+ * @param exchangeRates Exchange rates from fishing state (required for accurate calculation)
+ * @param skills Account skills array for calculating Weed Dealer bonus
+ * @param preserveRarities Array of numbers indicating how many fish to preserve for each rarity. Pass empty array to sell all. 0 = sell all, >0 = preserve that amount.
+ * @returns Simplified inventory info for UI display
+ */
+declare function calculateFishInventoryDisplay(inventory: GameInventoryEntity[], exchangeRates: ExchangeRate[], skills?: any[], preserveRarities?: number[]): {
+    hasSellableFish: boolean;
+    totalFish: number;
+    totalSellableFish: number;
+    estimatedSeaweed: number;
+    message: string;
+};
+/**
+ * Result of selling fish
+ */
+interface SellFishResult {
+    success: boolean;
+    fishId: number;
+    amount: number;
+    seaweed?: number;
+}
+/**
+ * Complete result of selling all fish
+ */
+interface SellAllFishResult {
+    success: boolean;
+    totalFishSold: number;
+    totalSeaweedEarned: number;
+    sellResults: SellFishResult[];
+    analysis: FishInventoryAnalysis;
+}
+/**
+ * Execute the complete fish selling flow
+ *
+ * NOTE: This function does NOT check spark balance or scroll access.
+ * Access control (sparks, scrolls) is handled by the UseService GraphQL mutation
+ * which is called after fish are sold.
+ *
+ * @param gigaverse Gigaverse API instance
+ * @param accountId Account ID (wallet address)
+ * @param jwt JWT token for authentication
+ * @param tokenId Token ID for skill calculation
+ * @param preserveRarities Array of numbers indicating how many fish to preserve for each rarity. Pass empty array to sell all. 0 = sell all, >0 = preserve that amount.
+ * @returns Complete selling result
+ */
+declare function executeFishSelling(gigaverse: GigaverseApi, accountId: string, jwt: string, tokenId: number, preserveRarities: number[]): Promise<SellAllFishResult>;
+
+/**
+ * Fish movement strategy detection
+ *
+ * Determines the fish movement pattern (CARDINAL, CORNERS, or PLUS)
+ * based on observing the fish's previous and current positions.
+ *
+ * Used by both the fishing bot and the hint system (via API).
+ */
+
+/**
+ * Determine fish movement strategy from observed positions.
+ * Returns undefined if fish didn't move (can't determine from no movement).
+ */
+declare function determineFishStrategy(prev: [number, number], current: [number, number]): FishMoveStrategy | undefined;
+
+type ClaimResourceFunction = (params: {
+    romId: string;
+    resourceId: ResourceType;
+    accountJwt: string;
+}) => Promise<{
+    success: boolean;
+}>;
+interface EnergyData {
+    currentEnergy: number;
+    maxEnergy: number;
+    romsEnergy: number;
+    activeRoms: RomEntity[];
+}
+interface EnergyClaimOptions {
+    gigaverseApi: GigaverseApi;
+    accountId: string;
+    accountJwt: string;
+    energyRequired: number;
+    claimResourceFunction?: ClaimResourceFunction;
+    energyData?: EnergyData;
+}
+interface EnergyClaimResult {
+    success: boolean;
+    message: string;
+    currentEnergy: number;
+    romsEnergy: number;
+    energyClaimed: number;
+}
+/**
+ * Claims energy from ROMs if needed to meet the energy requirement
+ * @param options Energy claiming configuration
+ * @param options.energyData Optional energy data to avoid API calls if already available
+ * @returns Result of the energy claiming operation
+ */
+declare function claimEnergyIfNeeded(options: EnergyClaimOptions): Promise<EnergyClaimResult>;
+
+declare const DUNGEON_SKILL_1_SP_TO_LEVEL: Record<number, number>;
+declare const DUNGEON_SKILL_2_SP_TO_LEVEL: Record<number, number>;
+declare const DUNGEON_SP_TO_LEVEL: Record<number, number>;
+declare const DUNGEON_SKILL_1_SP_REQUIREMENTS: number[];
+declare const DUNGEON_SKILL_2_SP_REQUIREMENTS: number[];
+declare const DUNGEON_SP_REQUIREMENTS: number[];
+declare const VOID_MAX_STATS_SP_TO_LEVEL: Record<number, number>;
+declare const VOID_MAX_STATS_SP_REQUIREMENTS: number[];
+/**
+ * Get the actual level from skill points for dungeon skills
+ * @param skillPoints - Total skill points allocated
+ * @param skillId - Optional skill ID (1 for FIVE_THOUSAND, 2 for UNDERHAUL, 4 for VOID)
+ * @param statIndex - Optional stat index (for VOID: 6,7 are Max HP/Armor, 0-5 are special stats)
+ * @returns The calculated level (0-25 for most, 0-15 for Void Max HP/Armor)
+ */
+declare const getDungeonLevelFromSP: (skillPoints: number, skillId?: number, statIndex?: number) => number;
+/**
+ * Get progress info for current dungeon level
+ * @param skillPoints - Total skill points allocated
+ * @param skillId - Optional skill ID (1 for FIVE_THOUSAND, 2 for UNDERHAUL, 4 for VOID)
+ * @param statIndex - Optional stat index (for VOID: 6,7 are Max HP/Armor, 0-5 are special stats)
+ * @returns Progress information including current level, next level, current SP, required SP, and progress percentage
+ */
+declare const getDungeonLevelProgress: (skillPoints: number, skillId?: number, statIndex?: number) => {
+    currentLevel: number;
+    nextLevel: number;
+    currentSP: number;
+    requiredSP: number;
+    progressPercent: number;
+};
+/**
+ * Get winrate for a specific skill/game type
+ * @param skillId - The game/skill ID (1 for FIVE_THOUSAND, 2 for UNDERHAUL, 3 for FISHING)
+ * @param stats - Stats object containing winrate fields
+ * @returns The winrate as a number (0-100)
+ */
+declare const getWinrate: (skillId: number, stats: {
+    game1Winrate?: number | null;
+    game2Winrate?: number | null;
+    game3Winrate?: number | null;
+} | null | undefined) => number;
+/**
+ * Get game count for a specific skill/game type
+ * @param skillId - The game/skill ID (1 for FIVE_THOUSAND, 2 for UNDERHAUL, 3 for FISHING)
+ * @param stats - Stats object containing game count fields
+ * @returns The number of games played
+ */
+declare const getGameCount: (skillId: number, stats: {
+    game1Count?: number | null;
+    game2Count?: number | null;
+    game3Count?: number | null;
+} | null | undefined) => number;
+
+/**
+ * Hatchery Cost Calculator
+ * Calculates estimated costs and time for egg hatching based on materials per tier
+ */
+declare const HATCHERY_CRAFTING_RECIPES: {
+    readonly 576: {
+        readonly outputItemId: 576;
+        readonly outputAmount: 3;
+        readonly inputItemId: 21;
+        readonly inputAmount: 3;
+        readonly inputName: "Wood";
+    };
+    readonly 577: {
+        readonly outputItemId: 577;
+        readonly outputAmount: 3;
+        readonly inputItemId: 61;
+        readonly inputAmount: 3;
+        readonly inputName: "Coal";
+    };
+    readonly 578: {
+        readonly outputItemId: 578;
+        readonly outputAmount: 1;
+        readonly inputItemId: 23;
+        readonly inputAmount: 2;
+        readonly inputName: "Bone";
+    };
+    readonly 579: {
+        readonly outputItemId: 579;
+        readonly outputAmount: 1;
+        readonly inputItemId: 22;
+        readonly inputAmount: 2;
+        readonly inputName: "Fiber";
+    };
+    readonly 580: {
+        readonly outputItemId: 580;
+        readonly outputAmount: 1;
+        readonly inputItemId: 25;
+        readonly inputAmount: 5;
+        readonly inputName: "Stone";
+    };
+};
+interface MaterialCost {
+    itemId: number;
+    itemName: string;
+    amount: number;
+    craftingInputId?: number;
+    craftingInputName?: string;
+    craftingInputAmount?: number;
+}
+interface FateCost {
+    factionId: number;
+    dustItemId: number;
+    totalDust: number;
+    levels: number[];
+}
+interface HatcheryCostEstimate {
+    estimatedDays: number;
+    temperatureCosts: MaterialCost[];
+    comfortCosts: MaterialCost[];
+    fateCosts: FateCost | null;
+    totalRawMaterials: Map<number, {
+        name: string;
+        amount: number;
+    }>;
+}
+/**
+ * Calculate dust needed for a specific fate level
+ * Starts at 5 dust for level 1, increases by 1 each level
+ * Level 1: 5, Level 2: 6, Level 3: 7, ... Level 20: 24
+ */
+declare function calculateFateDustForLevel(level: number): number;
+/**
+ * Calculate total dust needed from current level to target level (single faction)
+ */
+declare function calculateTotalFateDust(currentLevel: number, targetLevel: number): number;
+/**
+ * Result for multi-faction cycling dust calculation
+ */
+interface MultiFactionDustCost {
+    /** Total dust needed across all factions */
+    totalDust: number;
+    /** Dust needed per faction, keyed by faction ID */
+    dustPerFaction: Map<number, {
+        factionId: number;
+        dustItemId: number;
+        amount: number;
+    }>;
+    /** Number of remaining fate levels to reach target */
+    remainingLevels: number;
+}
+/**
+ * Calculate dust needed with multi-faction cycling optimization.
+ *
+ * The hatchery handler now selects factions based on lowest dust cost, cycling through
+ * configured factions to minimize total dust consumption. Each faction's cost starts at 5
+ * and increases by 1 for each use of that specific faction.
+ *
+ * With cycling, factions are used evenly (lowest cost first):
+ * - Example: 3 factions configured to reach fate 20 from 0
+ *   - Single faction: 5+6+7+...+24 = 290 dust
+ *   - 3 factions cycling: each faction used ~7 times at costs 5,6,7,8,9,10,11 = ~168 dust total
+ *
+ * Selection logic (matching backend `selectFactionByDust`):
+ * - Primary: Pick faction with lowest current level (lowest dust cost)
+ * - Tie-breaker: Pick faction with highest inventory
+ *
+ * @param currentFateByFaction - Array of current fate level per faction (index = faction index, 0 = none)
+ * @param targetFate - Target total fate level
+ * @param factionPriorities - Array of faction IDs in priority order
+ * @param factionDustItemIdLookup - Lookup from faction ID to dust item ID
+ * @param inventoryByFaction - Optional inventory amounts per faction (keyed by faction ID). Used as tie-breaker when costs are equal.
+ */
+declare function calculateMultiFactionDustCost(currentFateByFaction: number[], targetFate: number, factionPriorities: number[], factionDustItemIdLookup: Record<number, number | null>, inventoryByFaction?: Record<number, number>): MultiFactionDustCost;
+/**
+ * Calculate materials needed to reach a specific temperature tier (one-time cost)
+ */
+declare function calculateTemperatureMaterials(currentTemp: number, targetTemp: number): MaterialCost[];
+/**
+ * Calculate materials needed to reach a specific comfort tier (one-time cost)
+ */
+declare function calculateComfortMaterials(currentComfort: number, targetComfort: number): MaterialCost[];
+/**
+ * Calculate estimated cost for hatching an egg to completion
+ * Includes both one-time costs (to reach thresholds) and recurring costs (to maintain them)
+ */
+declare function calculateHatcheryCost(currentProgress: number, currentTemp: number, currentComfort: number, currentFate: number, targetTemp: number, targetComfort: number, targetFate: number, progressDailyRate: number, factionId?: number, dustItemId?: number): HatcheryCostEstimate;
+
+declare const ROM_CLAIM_THRESHOLD = 0.9;
+interface RomServiceOptions {
+    shouldConvertEnergy?: boolean;
+    energyThreshold?: number;
+}
+interface LootCollectorServiceOptions {
+}
+interface FishingServiceOptions {
+    preserveRarities?: number[];
+}
+interface EggThresholds {
+    temperature: number;
+    comfort: number;
+    fate: number;
+    factionId?: number;
+}
+type EggThresholdArray = [number, number, number, number, number[] | number | null];
+interface HatchingServiceOptions {
+    eggThresholds?: EggThresholdArray[];
+    defaultThresholds?: EggThresholds;
+    maxRawMaterialsPerDay?: {
+        wood?: number;
+        coal?: number;
+        bones?: number;
+        fibre?: number;
+        stone?: number;
+    };
+}
+type ServiceOptions = RomServiceOptions | LootCollectorServiceOptions | FishingServiceOptions | HatchingServiceOptions;
+declare enum ServiceAction {
+    SUBSCRIBE = "subscribe",
+    UNSUBSCRIBE = "unsubscribe",
+    UPDATE_OPTIONS = "updateOptions",
+    REVEAL = "reveal"
+}
+interface ServiceMetadata {
+    service_id?: number;
+    operations?: number[][];
+    /** True for manual user actions (e.g., clicking Sell button) - won't trigger reveal */
+    manual?: boolean;
+    /** True when Scroll of Fire provided free access for this transaction */
+    free_access?: boolean;
+}
+declare const ServiceTypeNameLookup: Record<ServiceType, string>;
+
+declare class AbortedError extends Error {
+    constructor(message?: string);
+}
+
+declare class InvalidMessageError extends Error {
+    readonly metadata: Record<string, unknown>;
+    constructor(message?: string, metadata?: Record<string, unknown>);
+}
+
+type MessageId = string;
+type Primitive = string | number | boolean;
+type MessageMetadata = Record<string, Primitive>;
+type IMessageMetadata = {
+    id: MessageId;
+    metadata: MessageMetadata;
+    correlationId?: string;
+};
+type IRawMessage = IMessageMetadata & {
+    data: string;
+};
+type IMessage<TData> = IMessageMetadata & {
+    data: TData;
+};
+
+type MessageReceiveOptions = {
+    maxNumberOfMessages: number;
+    waitTimeSeconds: number;
+};
+type MessageVisibilityOptions = {
+    messageId: MessageId;
+    visibilityTimeoutInSeconds: number;
+};
+type MessageSendOptions = {
+    data: string;
+    delaySeconds?: number;
+};
+interface IQueue {
+    receiveMessages(options?: MessageReceiveOptions): Promise<IRawMessage[]>;
+    changeMessageVisibility(options: MessageVisibilityOptions): Promise<void>;
+    deleteMessage(id: MessageId): Promise<void>;
+    sendMessage(options: MessageSendOptions): Promise<void>;
+}
+
+type ParseResult<T> = ValidParseResult<T> | InvalidParseResult;
+type ValidParseResult<T> = {
+    success: true;
+    data: T;
+};
+type InvalidParseResult = {
+    success: false;
+    errors: unknown[];
+};
+interface IMessageParser<T> {
+    parse(message: string): ParseResult<T>;
+}
+declare function valid<T>(data: T): ValidParseResult<T>;
+declare function invalid(errors: unknown[]): InvalidParseResult;
+
+type RawMessageHandleRequest = {
+    message: IRawMessage;
+    abortSignal: AbortSignal;
+};
+type MessageHandleRequest<T> = {
+    message: IMessage<T>;
+    abortSignal: AbortSignal;
+};
+interface IMessageHandler {
+    handle(request: RawMessageHandleRequest): Promise<void>;
+}
+declare abstract class MessageHandler<T> implements IMessageHandler {
+    protected readonly logger: Logger;
+    protected readonly parser: IMessageParser<T>;
+    protected constructor(logger: Logger, parser: IMessageParser<T>);
+    handle(request: RawMessageHandleRequest): Promise<void>;
+    private tryHandle;
+    protected abstract handleMessage(message: MessageHandleRequest<T>): Promise<void>;
+    protected getMessageContext(message: IMessage<T>): Record<string, Primitive>;
+    private mapRawMessageToTypedMessage;
+}
+
+type SqsQueueOptions = {
+    region: string;
+    queueUrl: string;
+    /** Optional custom endpoint URL (e.g., for LocalStack) */
+    endpoint?: string;
+};
+/**
+ * SQS implementation of the IQueue interface.
+ * Maps SQS messages to the standard IMessage format.
+ */
+declare class SqsQueue implements IQueue {
+    private readonly options;
+    private readonly client;
+    constructor(options: SqsQueueOptions);
+    /**
+     * Receive messages from the SQS queue
+     * @param options - Message receive options including max messages and wait time
+     * @returns Array of messages in IMessage format
+     */
+    receiveMessages(options?: MessageReceiveOptions): Promise<IRawMessage[]>;
+    /**
+     * Change the visibility timeout of a message
+     * @param options - Message visibility options including message ID and visibility timeout in seconds
+     */
+    changeMessageVisibility(options: MessageVisibilityOptions): Promise<void>;
+    /**
+     * Delete a message from the queue
+     * @param id - Message ID (receipt handle)
+     */
+    deleteMessage(id: MessageId): Promise<void>;
+    /**
+     * Send a message to the queue
+     * @param options - Message send options including data and optional delay
+     */
+    sendMessage(options: MessageSendOptions): Promise<void>;
+    /**
+     * Map an SQS message to the IMessage format
+     * The message ID is used as the ID, and the receipt handle is stored in metadata
+     */
+    private mapToMessage;
+}
+
+declare class ZodMessageParser<T> implements IMessageParser<T> {
+    private readonly schema;
+    constructor(schema: z.Schema<T>);
+    parse(message: string): ParseResult<T>;
+}
+
+export { ALLOWED_TRIGGER_TYPES, ARMOR_CONSUMABLES_IDS, AbortedError, ActiveEffectType, type AllowedTriggerType, BLUE_POT_RECIPE_ID, BOOM_CONSUMABLES_IDS, CHIMPU_LURE_ID, CRIT_DAMAGE_MULTIPLIER, Checkpoint, CheckpointRecipeIdLookup, type CheckpointType, type ClaimResourceFunction, type ConsumableLoadoutItem, DAILY_RESET_HOUR_UTC, DAILY_RESET_MINUTE_UTC, DEFAULT_CRIT_PROTECTION, DEFAULT_NERF_THRESHOLD, DEFAULT_PRESERVE_FISH_AMOUNT, DEFAULT_VALUE_THRESHOLD_MULTIPLIER, DISCORD_URL, DUNGEON_SKILL_1_SP_REQUIREMENTS, DUNGEON_SKILL_1_SP_TO_LEVEL, DUNGEON_SKILL_2_SP_REQUIREMENTS, DUNGEON_SKILL_2_SP_TO_LEVEL, DUNGEON_SP_REQUIREMENTS, DUNGEON_SP_TO_LEVEL, DURABILITY_PER_USE, type DiscordOAuthStatePayload, type DungeonJobOptions, DungeonLegacyType, DungeonLegacyTypeNameLookup, DungeonModel, DungeonModelNameLookup, DungeonModelVersionLookup, DungeonPreset, DungeonPresetAggressionLookup, DungeonStatsNameLookup, DungeonType, DungeonTypeCheckpointLookup, DungeonTypeCostLookup, DungeonTypeEmojiLookup, DungeonTypeJuicedLookup, DungeonTypeJuicedMaxRunsLookup, DungeonTypeLegacyLookup, DungeonTypeMaxRoomLookup, DungeonTypeMaxRunsLookup, DungeonTypeNameLookup, EffectTriggerType, EggRarityOrderLookup, type EggThresholdArray, type EggThresholds, EggType, EggTypeLookup, type EnergyClaimOptions, type EnergyClaimResult, type EnergyData, type EquipmentOptimized, type ExchangeRate, FACTION_DUST_ITEM_IDS, FIFTEEN_MINUTES_FROM_NOW, FISHING_FIRST_SKILL_SP_REQUIREMENTS, FISHING_FIRST_SKILL_SP_TO_LEVEL, FISHING_OTHER_SKILLS_SP_REQUIREMENTS, FISHING_OTHER_SKILLS_SP_TO_LEVEL, FISHING_SKILL_INDICES, FIVE_MINUTES_FROM_NOW, Faction, FactionDustItemIdLookup, FactionIdNameLookup, FactionNameIdLookup, type FishInventoryAnalysis, FishMoveStrategy, FishMoveStrategyNameLookup, type FishToSell, type FishingJobOptions, FishingModel, FishingModelNameLookup, FishingModelVersionLookup, type FishingServiceOptions, FishingType, FishingTypeCostLookup, FishingTypeJuicedMaxRunsLookup, FishingTypeMaxRunsLookup, FishingTypeNameLookup, GAME_ACTION_DELAY_MS, GEAR_REPAIR_DELAY_MS, GIGAVERSE_ENDPOINT, GameAction, GameActionIndexLookup, GameActionNameLookup, GameType, GameTypeNameLookup, type Gear, type GearLoadoutItem, HATCHERY_COMFORT_ITEM_ID, HATCHERY_CRAFTING_RECIPES, HATCHERY_FUEL_ITEM_ID, HEALING_CONSUMABLES_IDS, type HatchingServiceOptions, type IMessage, type IMessageHandler, type IMessageMetadata, type IMessageParser, type IQueue, type IRawMessage, InvalidMessageError, type InvalidParseResult, JUICED_CHEST_RECIPE_ID, type JobMessage, type JobOptions, JobStatus, JobStatusNameLookup, LEVEL_THRESHOLD, type LoadoutItem, type Loot, type LootCollectorServiceOptions, LootIndexTypeLookup, LootSubType, LootType, LootTypeIndexLookup, LootTypeNameLookup, MAX_CRIT_PROTECTION, MAX_NERF_THRESHOLD, MAX_REPAIRS_BEFORE_RESET, MIN_CRIT_PROTECTION, MIN_NERF_THRESHOLD, type MessageHandleRequest, MessageHandler, type MessageId, type MessageMetadata, type MessageReceiveOptions, type MessageSendOptions, type MessageVisibilityOptions, type MultiFactionDustCost, NOOB_CHEST_RECIPE_ID, Node, NodeRecipeIdLookup, NotificationType, NotificationTypeMetadataLookup, type OptimizedActiveEffect, PAPER_HANDS_BASE_DURABILITY, PAPER_HANDS_ID, PAPER_HANDS_RECIPE_ID, PETS_CONTRACT_ADDRESS, type ParseResult, type Primitive, type QuestItem, type QuestItemScroll, QuestItemType, type QuestItemXP, RECIPE_LOOT_COUNTS, REFERRAL_PERCENTAGE, RESTORE_CONSUMABLES_IDS, ROCK_HANDS_BASE_DURABILITY, ROCK_HANDS_ID, ROCK_HANDS_RECIPE_ID, ROMS_CONTRACT_ADDRESS, ROM_CLAIM_THRESHOLD, Rarity, RarityNameLookup, RarityShortLookup, type RawMessageHandleRequest, type Recipe, ResourceType, RomMemory, RomMemoryIndexLookup, type RomServiceOptions, RomTier, RomTierNameIndexLookup, SEAWEED_ITEM_ID, SPARKS_CONTRACT_ADDRESS, SPARK_PRICE, SPARK_PRICE_IN_ETH, SQS_DLQ_ENDPOINT, SQS_ENDPOINT, SQS_TEST_ENDPOINT, type SellAllFishResult, type SellFishResult, ServiceAction, type ServiceMetadata, type ServiceOptions, ServiceType, ServiceTypeNameLookup, SparkTransactionType, SparkTransactionTypeNameLookup, type SparksContractData, type SparksUserData, SqsQueue, type SqsQueueOptions, StatusEffectModifiers, TAN_POT_RECIPE_ID, TEN_MINUTES_FROM_NOW, VOID_MAX_STATS_SP_REQUIREMENTS, VOID_MAX_STATS_SP_TO_LEVEL, VULNERABLE_CONSUMABLES_IDS, type ValidParseResult, VoidStatsDescriptionLookup, WEAK_CONSUMABLES_IDS, ZodMessageParser, analyzeFishInventory, calculateComfortMaterials, calculateFateDustForLevel, calculateFishInventoryDisplay, calculateFishingCatchValue, calculateHatcheryCost, calculateMultiFactionDustCost, calculateTemperatureMaterials, calculateTotalFateDust, calculateWeedDealerBonus, capitalize, checkDungeonEligibility, checkFishingEligibility, claimEnergyIfNeeded, delay, determineFishStrategy, executeFishSelling, extractSeaweedEarned, filterFishFromInventory, findOptimalBatchSize, formatLootName, formatLootNameOptimized, getActionIndex, getActiveSqsEndpoint, getCheckpoint, getDungeonLevelFromSP, getDungeonLevelProgress, getDungeonModelData, getDungeonNameWithEmoji, getEnemyById, getEnemyLevel, getEnemyLootId, getEnemyNameById, getFishBaseSeaweedValue, getFishingCardById, getFishingLevelFromSP, getFishingLevelProgress, getFishingModelData, getGameCount, getGearById, getItemById, getItemIconById, getItemIdByName, getItemNameById, getItemRarity, getLootSubType, getLootTypeSuffix, getLootTypeSuffixOptimized, getModelData, getRecipe, getRoomData, getSqsDlqEndpoint, getSqsEndpoint, getSqsTestEndpoint, getWinrate, invalid, parseGear, prepareFishBatches, valid, validateEnv };