@wynnjs/api 3.0.0

package/dist/index.cjs

@@ -0,0 +1,1804 @@
+'use strict';
+
+var axios = require('axios');
+var zod = require('zod');
+
+function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
+
+var axios__default = /*#__PURE__*/_interopDefault(axios);
+
+// src/client.ts
+
+// src/auth.ts
+function authHeaders(auth) {
+  if (!auth) {
+    return {};
+  }
+  switch (auth.type) {
+    case "token":
+      return { Authorization: `Bearer ${auth.token}` };
+    case "oauth":
+      return { Authorization: `Bearer ${auth.accessToken}` };
+    case "session":
+      return { Cookie: auth.cookie };
+  }
+}
+
+// src/constants.ts
+var API_BASE_URL = "https://api.wynncraft.com/v3";
+var WYNNCRAFT_API_VERSION = "3.7.2";
+var CDN_BASE_URL = "https://cdn.wynncraft.com";
+function assetUrl(path) {
+  return `${CDN_BASE_URL}/${path.replace(/^\//, "")}`;
+}
+var MultipleObjectsEntrySchema = zod.z.object({
+  username: zod.z.string().optional(),
+  name: zod.z.string().optional(),
+  prefix: zod.z.string().optional(),
+  uuid: zod.z.uuid().optional(),
+  rank: zod.z.string().optional(),
+  supportRank: zod.z.string().nullable().optional(),
+  shortenedRank: zod.z.string().nullable().optional(),
+  legacyRankColour: zod.z.object({
+    main: zod.z.string(),
+    sub: zod.z.string()
+  }).optional(),
+  rankBadge: zod.z.string().optional()
+}).passthrough();
+var MultipleObjectsMapSchema = zod.z.record(zod.z.string(), MultipleObjectsEntrySchema);
+var MultipleObjectsReturnedBodySchema = zod.z.object({
+  error: zod.z.literal("MultipleObjectsReturned"),
+  detail: zod.z.string(),
+  code: zod.z.literal(300),
+  identifier: zod.z.string().optional(),
+  objects: MultipleObjectsMapSchema
+});
+
+// src/errors.ts
+var WynnApiErrorBodySchema = zod.z.object({
+  error: zod.z.string(),
+  detail: zod.z.string(),
+  code: zod.z.number(),
+  identifier: zod.z.string().optional(),
+  objects: MultipleObjectsMapSchema.optional()
+});
+exports.WynnApiError = class WynnApiError extends Error {
+  name = "WynnApiError";
+  /** Machine-readable error name from the API, e.g. `NotFound`. */
+  error;
+  /** Human-readable error message from the API. */
+  detail;
+  /** Wynncraft error code. */
+  code;
+  /** Optional identifier for the resource that caused the error. */
+  identifier;
+  /** Present on {@link WynnApiError.MultipleObjectsReturned} errors. */
+  objects;
+  /** HTTP status code from the response. */
+  status;
+  /**
+   * @param body - Parsed Wynncraft error response body.
+   * @param status - HTTP status code from the response.
+   */
+  constructor(body, status) {
+    super(body.detail);
+    this.error = body.error;
+    this.detail = body.detail;
+    this.code = body.code;
+    this.identifier = body.identifier;
+    this.objects = body.objects;
+    this.status = status;
+  }
+};
+function wynnErrorClass(errorName) {
+  return class extends exports.WynnApiError {
+    name = errorName;
+  };
+}
+var MultipleObjectsReturnedError = class extends exports.WynnApiError {
+  name = "MultipleObjectsReturned";
+  objects;
+  constructor(body, status) {
+    super(body, status);
+    this.objects = body.objects;
+  }
+};
+((WynnApiError2) => {
+  WynnApiError2.MultipleObjectsReturned = MultipleObjectsReturnedError;
+  WynnApiError2.InvalidFormError = wynnErrorClass("InvalidFormError");
+  WynnApiError2.InvalidQueryParamsError = wynnErrorClass("InvalidQueryParamsError");
+  WynnApiError2.MalformedPayload = wynnErrorClass("MalformedPayload");
+  WynnApiError2.MalformedTokenError = wynnErrorClass("MalformedTokenError");
+  WynnApiError2.CSRFError = wynnErrorClass("CSRFError");
+  WynnApiError2.InvalidTokenError = wynnErrorClass("InvalidTokenError");
+  WynnApiError2.PaginationError = wynnErrorClass("PaginationError");
+  WynnApiError2.Forbidden = wynnErrorClass("Forbidden");
+  WynnApiError2.NotFound = wynnErrorClass("NotFound");
+  WynnApiError2.MethodNotAllowed = wynnErrorClass("MethodNotAllowed");
+  WynnApiError2.TooManyRequest = wynnErrorClass("TooManyRequest");
+  WynnApiError2.InternalError = wynnErrorClass("InternalError");
+  WynnApiError2.InvalidCharacterUUID = wynnErrorClass("InvalidCharacterUUID");
+  WynnApiError2.NoCharacterFound = wynnErrorClass("NoCharacterFound");
+  WynnApiError2.MalformedPrefixError = wynnErrorClass("MalformedPrefixError");
+  WynnApiError2.InvalidTree = wynnErrorClass("InvalidTree");
+})(exports.WynnApiError || (exports.WynnApiError = {}));
+var WYNN_ERROR_REGISTRY = {
+  MultipleObjectsReturned: exports.WynnApiError.MultipleObjectsReturned,
+  InvalidFormError: exports.WynnApiError.InvalidFormError,
+  InvalidQueryParamsError: exports.WynnApiError.InvalidQueryParamsError,
+  MalformedPayload: exports.WynnApiError.MalformedPayload,
+  MalformedTokenError: exports.WynnApiError.MalformedTokenError,
+  CSRFError: exports.WynnApiError.CSRFError,
+  InvalidTokenError: exports.WynnApiError.InvalidTokenError,
+  PaginationError: exports.WynnApiError.PaginationError,
+  Forbidden: exports.WynnApiError.Forbidden,
+  NotFound: exports.WynnApiError.NotFound,
+  MethodNotAllowed: exports.WynnApiError.MethodNotAllowed,
+  TooManyRequest: exports.WynnApiError.TooManyRequest,
+  InternalError: exports.WynnApiError.InternalError,
+  InvalidCharacterUUID: exports.WynnApiError.InvalidCharacterUUID,
+  NoCharacterFound: exports.WynnApiError.NoCharacterFound,
+  MalformedPrefixError: exports.WynnApiError.MalformedPrefixError,
+  InvalidTree: exports.WynnApiError.InvalidTree
+};
+function createWynnApiError(body, status) {
+  if (body.error === "MultipleObjectsReturned") {
+    const parsed = MultipleObjectsReturnedBodySchema.safeParse(body);
+    if (parsed.success) {
+      return new exports.WynnApiError.MultipleObjectsReturned(parsed.data, status);
+    }
+  }
+  const ErrorClass = WYNN_ERROR_REGISTRY[body.error] ?? exports.WynnApiError;
+  return new ErrorClass(body, status);
+}
+function toWynnApiError(error) {
+  if (!axios__default.default.isAxiosError(error) || !error.response) {
+    return null;
+  }
+  const parsed = WynnApiErrorBodySchema.safeParse(error.response.data);
+  if (!parsed.success) {
+    return null;
+  }
+  return createWynnApiError(parsed.data, error.response.status);
+}
+
+// src/http.ts
+function serializeRequestParams(params, presenceParams) {
+  const searchParams = new URLSearchParams();
+  if (params != null && typeof params === "object" && !Array.isArray(params)) {
+    for (const [key, value] of Object.entries(params)) {
+      if (value !== void 0) {
+        searchParams.set(key, String(value));
+      }
+    }
+  }
+  const baseQuery = searchParams.toString();
+  if (!presenceParams?.length) {
+    return baseQuery;
+  }
+  const presenceQuery = presenceParams.map((param) => encodeURIComponent(param)).join("&");
+  return baseQuery ? `${baseQuery}&${presenceQuery}` : presenceQuery;
+}
+function toAxiosRequestConfig(config) {
+  const hasPresence = Boolean(config.presenceParams?.length);
+  return {
+    method: config.method ?? "GET",
+    url: config.path,
+    params: hasPresence ? config.params ?? {} : config.params,
+    paramsSerializer: hasPresence ? (params) => serializeRequestParams(params, config.presenceParams) : void 0,
+    data: config.data,
+    headers: config.headers
+  };
+}
+function parseRateLimit(headers) {
+  const bucket = headers.get("ratelimit-bucket");
+  const limit = headers.get("ratelimit-limit");
+  const remaining = headers.get("ratelimit-remaining");
+  const reset = headers.get("ratelimit-reset");
+  if (!bucket || !limit || !remaining || !reset) {
+    return null;
+  }
+  return {
+    bucket: String(bucket),
+    limit: Number(limit),
+    remaining: Number(remaining),
+    reset: Number(reset)
+  };
+}
+var ClassTreeSchema = zod.z.enum(["archer", "warrior", "assassin", "mage", "shaman"]);
+var AbilityIconValueCustomModelDataSchema = zod.z.object({
+  rangeDispatch: zod.z.array(zod.z.number())
+});
+var AbilityIconValueSchema = zod.z.object({
+  id: zod.z.string(),
+  name: zod.z.string(),
+  customModelData: AbilityIconValueCustomModelDataSchema
+});
+var AbilityIconSchema = zod.z.object({
+  name: zod.z.string().optional(),
+  value: AbilityIconValueSchema,
+  format: zod.z.string()
+});
+var AbilityMapNodeCoordinatesSchema = zod.z.object({
+  x: zod.z.number(),
+  y: zod.z.number()
+});
+var AbilityMapNodeMetaIconSchema = zod.z.union([AbilityIconSchema, zod.z.string()]);
+var AbilityMapNodeMetaSchema = zod.z.object({
+  icon: AbilityMapNodeMetaIconSchema.optional(),
+  page: zod.z.number(),
+  id: zod.z.string().optional()
+});
+var AbilityMapNodeSchema = zod.z.object({
+  type: zod.z.enum(["ability", "connector"]),
+  coordinates: AbilityMapNodeCoordinatesSchema,
+  meta: AbilityMapNodeMetaSchema,
+  family: zod.z.array(zod.z.string())
+});
+var AbilityMapPagesSchema = zod.z.record(zod.z.string(), zod.z.array(AbilityMapNodeSchema));
+
+// src/schemas/ability/get-ability-map.ts
+var GetAbilityMapResultSchema = AbilityMapPagesSchema;
+var AbilityTreeArchetypeSchema = zod.z.object({
+  name: zod.z.string(),
+  description: zod.z.string(),
+  shortDescription: zod.z.string(),
+  icon: AbilityIconSchema,
+  slot: zod.z.number()
+});
+var AbilityDefinitionSchema = zod.z.object({
+  name: zod.z.string(),
+  icon: AbilityIconSchema,
+  slot: zod.z.number(),
+  coordinates: zod.z.object({
+    x: zod.z.number(),
+    y: zod.z.number()
+  }),
+  description: zod.z.array(zod.z.string()),
+  requirements: zod.z.record(zod.z.string(), zod.z.number()),
+  links: zod.z.array(zod.z.string()),
+  locks: zod.z.array(zod.z.string()).nullable(),
+  page: zod.z.number()
+});
+var GetAbilityTreeResultSchema = zod.z.object({
+  archetypes: zod.z.record(zod.z.string(), AbilityTreeArchetypeSchema),
+  pages: zod.z.record(zod.z.string(), zod.z.record(zod.z.string(), AbilityDefinitionSchema))
+});
+var AspectTierSchema = zod.z.object({
+  threshold: zod.z.number(),
+  description: zod.z.array(zod.z.string())
+});
+var AspectSchema = zod.z.object({
+  name: zod.z.string(),
+  internalName: zod.z.string(),
+  icon: AbilityIconSchema,
+  rarity: zod.z.string(),
+  requiredClass: zod.z.string(),
+  tiers: zod.z.record(zod.z.string(), AspectTierSchema)
+});
+var ListAspectsResultSchema = zod.z.array(AspectSchema);
+
+// src/modules/ability.ts
+var AbilityModule = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  /**
+   * Fetch the ability tree layout for a class.
+   *
+   * @param tree - Class tree: `archer`, `warrior`, `assassin`, `mage`, or `shaman`.
+   * @returns Ability tree nodes and connections.
+   */
+  async getTree(tree) {
+    return this.client.request({
+      path: `/ability/tree/${encodeURIComponent(tree)}`
+    });
+  }
+  /**
+   * Fetch the ability map for a class.
+   *
+   * @param tree - Class tree: `archer`, `warrior`, `assassin`, `mage`, or `shaman`.
+   * @returns Ability map keyed by page.
+   */
+  async getMap(tree) {
+    return this.client.request({
+      path: `/ability/map/${encodeURIComponent(tree)}`
+    });
+  }
+  /**
+   * List all aspects for a class tree.
+   *
+   * @param tree - Class tree: `archer`, `warrior`, `assassin`, `mage`, or `shaman`.
+   * @returns Aspect definitions for the given tree.
+   */
+  async listAspects(tree) {
+    return this.client.request({
+      path: `/aspects/${encodeURIComponent(tree)}`
+    });
+  }
+};
+var ClassNameSchema = ClassTreeSchema;
+var ClassArchetypeSchema = zod.z.object({
+  name: zod.z.string(),
+  difficulty: zod.z.number(),
+  max: zod.z.number(),
+  icon: zod.z.string(),
+  damage: zod.z.number(),
+  defence: zod.z.number(),
+  range: zod.z.number(),
+  speed: zod.z.number()
+});
+var GetClassResultSchema = zod.z.object({
+  id: zod.z.string(),
+  name: zod.z.string(),
+  lore: zod.z.string(),
+  overallDifficulty: zod.z.number(),
+  overallMax: zod.z.number(),
+  archetypes: zod.z.record(zod.z.string(), ClassArchetypeSchema)
+});
+var ClassSummarySchema = zod.z.object({
+  name: zod.z.string(),
+  overallDifficulty: zod.z.number()
+});
+var ListClassesResultSchema = zod.z.record(zod.z.string(), ClassSummarySchema);
+
+// src/modules/classes.ts
+var ClassesModule = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  /** @returns All playable classes. */
+  async list() {
+    return this.client.request({
+      path: "/classes"
+    });
+  }
+  /**
+   * Fetch metadata for a single class.
+   *
+   * @param className - Class identifier, e.g. `mage` or `warrior`.
+   * @returns Class stats, archetypes, and weapon types.
+   */
+  async getClass(className) {
+    return this.client.request({
+      path: `/classes/${encodeURIComponent(className)}`
+    });
+  }
+};
+var GetGuildOptionsSchema = zod.z.object({
+  identifier: zod.z.enum(["username", "uuid"]).optional()
+});
+var CountListSchema = zod.z.object({
+  total: zod.z.number(),
+  list: zod.z.record(zod.z.string(), zod.z.number())
+});
+var PvpStatsSchema = zod.z.object({
+  kills: zod.z.number().optional(),
+  deaths: zod.z.number().optional()
+});
+var GuildMemberWeeklySchema = zod.z.object({
+  completed: zod.z.boolean().optional(),
+  streak: zod.z.number().optional()
+});
+var GuildMemberGlobalDataSchema = zod.z.object({
+  contentCompletion: zod.z.number(),
+  wars: zod.z.number(),
+  totalLevel: zod.z.number(),
+  mobsKilled: zod.z.number(),
+  chestsFound: zod.z.number(),
+  dungeons: CountListSchema,
+  raids: CountListSchema,
+  worldEvents: zod.z.number(),
+  lootruns: zod.z.number(),
+  caves: zod.z.number(),
+  completedQuests: zod.z.number(),
+  pvp: PvpStatsSchema,
+  currentGuildRaids: CountListSchema.nullable().optional(),
+  guildRaids: CountListSchema.nullable().optional(),
+  playtime: zod.z.number().optional()
+});
+var GuildMemberRestrictionsSchema = zod.z.object({
+  online_status: zod.z.boolean().optional(),
+  main_access: zod.z.boolean().optional(),
+  guild_high_ranked_access: zod.z.boolean().optional()
+});
+var GuildMemberSchema = zod.z.object({
+  uuid: zod.z.uuid().optional(),
+  username: zod.z.string().optional(),
+  online: zod.z.boolean(),
+  lastJoin: zod.z.string().nullable(),
+  server: zod.z.string().nullable(),
+  contributed: zod.z.number(),
+  contributionRank: zod.z.number(),
+  joined: zod.z.string(),
+  weekly: GuildMemberWeeklySchema,
+  globalData: GuildMemberGlobalDataSchema,
+  restrictions: GuildMemberRestrictionsSchema
+});
+var GuildMembersSchema = zod.z.object({
+  total: zod.z.number(),
+  owner: zod.z.record(zod.z.string(), GuildMemberSchema).optional(),
+  chief: zod.z.record(zod.z.string(), GuildMemberSchema).optional(),
+  strategist: zod.z.record(zod.z.string(), GuildMemberSchema).optional(),
+  recruiter: zod.z.record(zod.z.string(), GuildMemberSchema).optional(),
+  recruit: zod.z.record(zod.z.string(), GuildMemberSchema).optional()
+});
+var BannerLayerSchema = zod.z.object({
+  color: zod.z.string(),
+  pattern: zod.z.string()
+});
+var GuildBannerSchema = zod.z.object({
+  base: zod.z.string(),
+  tier: zod.z.number(),
+  structure: zod.z.string(),
+  layers: zod.z.array(BannerLayerSchema)
+});
+var GuildSeasonRankSchema = zod.z.object({
+  rating: zod.z.number(),
+  finalTerritories: zod.z.number()
+});
+var GuildResultSchema = zod.z.object({
+  uuid: zod.z.uuid(),
+  name: zod.z.string(),
+  prefix: zod.z.string(),
+  level: zod.z.number(),
+  xpPercent: zod.z.number(),
+  territories: zod.z.number(),
+  wars: zod.z.number(),
+  raids: zod.z.number(),
+  created: zod.z.string(),
+  members: GuildMembersSchema,
+  online: zod.z.number(),
+  banner: GuildBannerSchema,
+  seasonRanks: zod.z.record(zod.z.string(), GuildSeasonRankSchema),
+  ranking: zod.z.record(zod.z.string(), zod.z.number())
+});
+var ListGuildsOptionsSchema = zod.z.object({
+  identifier: zod.z.enum(["username", "uuid"]).optional()
+});
+var GuildListEntryByNameSchema = zod.z.object({
+  uuid: zod.z.uuid(),
+  prefix: zod.z.string()
+});
+var GuildListEntryByUuidSchema = zod.z.object({
+  name: zod.z.string(),
+  prefix: zod.z.string()
+});
+var ListGuildsByNameResultSchema = zod.z.record(zod.z.string(), GuildListEntryByNameSchema);
+var ListGuildsByUuidResultSchema = zod.z.record(zod.z.uuid(), GuildListEntryByUuidSchema);
+var GuildSeasonRewardConditionSchema = zod.z.object({
+  type: zod.z.enum(["SR", "LEADERBOARD_POSITION"]),
+  value: zod.z.number()
+});
+var GuildSeasonRewardSchema = zod.z.object({
+  condition: GuildSeasonRewardConditionSchema,
+  type: zod.z.enum([
+    "BADGE",
+    "EFFECT",
+    "COSMETIC",
+    "EMERALD",
+    "PRIVATE_BANK_SLOT",
+    "PUBLIC_BANK_SLOT",
+    "GUILD_TOME",
+    "STRUCTURE"
+  ]),
+  value: zod.z.union([zod.z.number(), zod.z.string()]).nullable(),
+  expires: zod.z.string().nullable()
+});
+var GuildSeasonDefinitionSchema = zod.z.object({
+  initDate: zod.z.string().nullable().optional(),
+  endDate: zod.z.string().nullable().optional(),
+  territoryHoldingSrPerHour: zod.z.number(),
+  srPerWar: zod.z.number(),
+  ratingRewards: zod.z.array(GuildSeasonRewardSchema),
+  leaderboardRewards: zod.z.array(GuildSeasonRewardSchema)
+});
+var ListGuildSeasonsResultSchema = zod.z.record(zod.z.string(), GuildSeasonDefinitionSchema);
+var TerritoryGuildReferenceSchema = zod.z.object({
+  uuid: zod.z.uuid(),
+  name: zod.z.string(),
+  prefix: zod.z.string(),
+  hq: zod.z.string()
+});
+var TerritoryResourceSchema = zod.z.object({
+  type: zod.z.enum(["EMERALD", "ORE", "WOOD", "FISH", "CROP"]),
+  generation: zod.z.number(),
+  stored: zod.z.number(),
+  limit: zod.z.number()
+});
+var TerritoryLocationSchema = zod.z.object({
+  start: zod.z.array(zod.z.number()),
+  end: zod.z.array(zod.z.number())
+});
+var TerritorySchema = zod.z.object({
+  guild: TerritoryGuildReferenceSchema,
+  acquired: zod.z.string(),
+  hq: zod.z.boolean(),
+  resources: zod.z.array(TerritoryResourceSchema),
+  links: zod.z.array(zod.z.string()),
+  treasury: zod.z.enum(["VERY_LOW", "LOW", "MEDIUM", "HIGH", "VERY_HIGH"]),
+  defences: zod.z.enum(["VERY_LOW", "LOW", "MEDIUM", "HIGH", "VERY_HIGH"]),
+  location: TerritoryLocationSchema
+});
+var ListGuildTerritoriesResultSchema = zod.z.record(zod.z.string(), TerritorySchema);
+
+// src/modules/guild.ts
+var GuildModule = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  /**
+   * List guilds with optional filters.
+   *
+   * @param options.identifier - Lookup key for list entries: `username` or `uuid`.
+   * @returns Guild list keyed by the chosen identifier.
+   */
+  async listGuilds(options = {}) {
+    return this.client.request({
+      path: "/guild/list/guild",
+      params: options
+    });
+  }
+  /** @returns All guild territories. */
+  async listTerritories() {
+    return this.client.request({
+      path: "/guild/list/territory"
+    });
+  }
+  /** @returns Guild season history. */
+  async listSeasons() {
+    return this.client.request({
+      path: "/guild/seasons"
+    });
+  }
+  /**
+   * Fetch a guild by name.
+   *
+   * @param name - Guild name.
+   * @param options.identifier - Response key for members: `username` or `uuid`.
+   * @returns Guild profile and member data.
+   */
+  async getGuild(name, options = {}) {
+    return this.client.request({
+      path: `/guild/${encodeURIComponent(name)}`,
+      params: options
+    });
+  }
+  /**
+   * Fetch a guild by tag prefix.
+   *
+   * @param prefix - Guild tag prefix, e.g. `ABC`.
+   * @param options.identifier - Response key for members: `username` or `uuid`.
+   * @returns Guild profile and member data.
+   */
+  async getGuildByPrefix(prefix, options = {}) {
+    return this.client.request({
+      path: `/guild/prefix/${encodeURIComponent(prefix)}`,
+      params: options
+    });
+  }
+  /**
+   * Fetch a guild by UUID.
+   *
+   * @param uuid - Guild UUID.
+   * @param options.identifier - Response key for members: `username` or `uuid`.
+   * @returns Guild profile and member data.
+   */
+  async getGuildByUuid(uuid, options = {}) {
+    return this.client.request({
+      path: `/guild/uuid/${encodeURIComponent(uuid)}`,
+      params: options
+    });
+  }
+};
+var GetItemMetadataOptionsSchema = zod.z.object({
+  static: zod.z.boolean().optional()
+});
+var ItemStaticValueMapSchema = zod.z.record(zod.z.string(), zod.z.number());
+var ItemMetadataSchema = zod.z.object({
+  filters: zod.z.object({
+    type: zod.z.array(zod.z.string()),
+    advanced: zod.z.record(zod.z.string(), zod.z.array(zod.z.string())),
+    tier: zod.z.record(zod.z.string(), zod.z.array(zod.z.string())),
+    identifications: zod.z.array(zod.z.string()),
+    majorIds: zod.z.array(zod.z.string()),
+    levelRange: zod.z.array(zod.z.number())
+  }),
+  static: ItemStaticValueMapSchema
+});
+var ItemStaticMetadataSchema = zod.z.object({
+  attackSpeed: ItemStaticValueMapSchema,
+  emblem: ItemStaticValueMapSchema,
+  gathering: ItemStaticValueMapSchema,
+  identifications: ItemStaticValueMapSchema,
+  majorIds: ItemStaticValueMapSchema,
+  set: ItemStaticValueMapSchema,
+  subType: ItemStaticValueMapSchema,
+  tier: ItemStaticValueMapSchema,
+  type: ItemStaticValueMapSchema
+});
+var PaginationControllerSchema = zod.z.object({
+  count: zod.z.number(),
+  current_count: zod.z.number(),
+  pages: zod.z.number(),
+  prev: zod.z.number().nullable(),
+  current: zod.z.number(),
+  next: zod.z.number().nullable()
+});
+var PaginatedQueryOptionsSchema = zod.z.object({
+  page: zod.z.number().optional(),
+  fullResult: zod.z.boolean().optional()
+});
+var PaginatedItemQueryOptionsSchema = PaginatedQueryOptionsSchema;
+var PaginatedRecipeQueryOptionsSchema = PaginatedQueryOptionsSchema;
+
+// src/schemas/item/item.ts
+var IdentificationRangeSchema = zod.z.object({
+  min: zod.z.number(),
+  raw: zod.z.number(),
+  max: zod.z.number()
+});
+var IdentificationValueSchema = zod.z.union([zod.z.number(), IdentificationRangeSchema]);
+var ItemSchema = zod.z.object({
+  displayName: zod.z.string(),
+  internalName: zod.z.string(),
+  type: zod.z.string(),
+  subType: zod.z.string(),
+  icon: zod.z.object({
+    value: zod.z.object({
+      id: zod.z.string(),
+      name: zod.z.string(),
+      customModelData: zod.z.object({
+        rangeDispatch: zod.z.array(zod.z.number())
+      })
+    }),
+    format: zod.z.string()
+  }),
+  emblem: zod.z.string(),
+  tier: zod.z.string(),
+  attackSpeed: zod.z.string().optional(),
+  averageDps: zod.z.number().optional(),
+  restriction: zod.z.string().optional(),
+  dropRestriction: zod.z.string().optional(),
+  gathering: zod.z.string().optional(),
+  set: zod.z.string().optional(),
+  elements: zod.z.array(zod.z.string()).optional(),
+  requirements: zod.z.object({
+    level: zod.z.number().optional(),
+    classRequirement: zod.z.string().optional(),
+    strength: zod.z.number().optional(),
+    dexterity: zod.z.number().optional(),
+    intelligence: zod.z.number().optional(),
+    defence: zod.z.number().optional(),
+    agility: zod.z.number().optional()
+  }).optional(),
+  majorIds: zod.z.record(zod.z.string(), zod.z.string()).optional(),
+  powderSlots: zod.z.number().optional(),
+  lore: zod.z.string().optional(),
+  identifications: zod.z.record(zod.z.string(), IdentificationValueSchema).optional(),
+  base: zod.z.record(zod.z.string(), IdentificationValueSchema).optional()
+});
+var ItemListSchema = zod.z.array(ItemSchema);
+var PaginatedItemResponseSchema = zod.z.object({
+  controller: PaginationControllerSchema,
+  results: ItemListSchema
+});
+
+// src/schemas/item/list-items.ts
+var ListItemsOptionsSchema = PaginatedItemQueryOptionsSchema;
+var ListItemsResultSchema = PaginatedItemResponseSchema;
+var ItemSetBonusSchema = zod.z.object({
+  major: zod.z.array(zod.z.string()),
+  minor: zod.z.record(zod.z.string(), zod.z.union([zod.z.number(), zod.z.string()]))
+});
+var ItemSetSchema = zod.z.object({
+  internalName: zod.z.string(),
+  bonuses: zod.z.record(zod.z.string(), ItemSetBonusSchema),
+  parts: zod.z.array(zod.z.string())
+});
+var ListItemSetsResultSchema = zod.z.record(zod.z.string(), ItemSetSchema);
+var IntegerRangeSchema = zod.z.object({
+  minimum: zod.z.number(),
+  maximum: zod.z.number()
+});
+var RecipeSchema = zod.z.object({
+  internalName: zod.z.string(),
+  type: zod.z.string(),
+  skill: zod.z.string(),
+  level: IntegerRangeSchema,
+  durability: IntegerRangeSchema.optional(),
+  materials: zod.z.array(
+    zod.z.object({
+      item: zod.z.string(),
+      amount: zod.z.number()
+    })
+  ),
+  healthOrDamage: IntegerRangeSchema,
+  duration: IntegerRangeSchema.optional(),
+  basicDuration: IntegerRangeSchema.optional(),
+  sprites: zod.z.record(
+    zod.z.string(),
+    zod.z.object({
+      format: zod.z.string(),
+      value: zod.z.object({
+        id: zod.z.string(),
+        customModelData: zod.z.number(),
+        name: zod.z.string()
+      }),
+      name: zod.z.string()
+    })
+  ),
+  xp: zod.z.number()
+});
+var RecipeListSchema = zod.z.array(RecipeSchema);
+var PaginatedRecipeResponseSchema = zod.z.object({
+  controller: PaginationControllerSchema,
+  results: RecipeListSchema
+});
+
+// src/schemas/item/list-recipes.ts
+var ListRecipesOptionsSchema = PaginatedRecipeQueryOptionsSchema;
+var ListRecipesResultSchema = PaginatedRecipeResponseSchema;
+var QuickSearchItemsResultSchema = ItemListSchema;
+var ScalarOrListSchema = zod.z.union([zod.z.string(), zod.z.array(zod.z.string())]);
+var ItemSearchRequestSchema = zod.z.object({
+  query: zod.z.string().nullable().optional(),
+  type: ScalarOrListSchema.optional(),
+  tier: ScalarOrListSchema.optional(),
+  attackSpeed: ScalarOrListSchema.optional(),
+  levelRange: zod.z.union([zod.z.number(), zod.z.array(zod.z.number())]).optional(),
+  professions: ScalarOrListSchema.optional(),
+  identifications: ScalarOrListSchema.optional(),
+  majorIds: ScalarOrListSchema.optional()
+});
+var SearchItemsOptionsSchema = PaginatedItemQueryOptionsSchema;
+var SearchItemsResultSchema = PaginatedItemResponseSchema;
+var ScalarOrListSchema2 = zod.z.union([zod.z.string(), zod.z.array(zod.z.string())]);
+var RecipeSearchRequestSchema = zod.z.object({
+  query: ScalarOrListSchema2.optional(),
+  xp: zod.z.union([zod.z.number(), zod.z.array(zod.z.number())]).optional(),
+  type: ScalarOrListSchema2.optional(),
+  skill: ScalarOrListSchema2.optional(),
+  materials: ScalarOrListSchema2.optional(),
+  level: zod.z.union([zod.z.number(), zod.z.array(zod.z.number())]).optional(),
+  durability: zod.z.union([zod.z.number(), zod.z.array(zod.z.number())]).optional(),
+  healthOrDamage: zod.z.union([zod.z.number(), zod.z.array(zod.z.number())]).optional(),
+  duration: zod.z.union([zod.z.number(), zod.z.array(zod.z.number())]).optional(),
+  basicDuration: zod.z.union([zod.z.number(), zod.z.array(zod.z.number())]).optional()
+});
+var SearchRecipesOptionsSchema = PaginatedRecipeQueryOptionsSchema;
+var SearchRecipesResultSchema = PaginatedRecipeResponseSchema;
+
+// src/modules/item.ts
+var ItemModule = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  /**
+   * List items from the item database.
+   *
+   * @param options.page - Page number for paginated results.
+   * @param options.fullResult - Include full item data when `true`.
+   * @returns Paginated item list.
+   */
+  async listItems(options = {}) {
+    const { page, fullResult } = options;
+    return this.client.request({
+      path: "/item/database",
+      params: page !== void 0 ? { page } : void 0,
+      presenceParams: fullResult ? ["fullResult"] : void 0
+    });
+  }
+  /**
+   * Search items with structured filters.
+   *
+   * @param filters - Search criteria such as `type`, `tier`, `levelRange`, and `identifications`.
+   * @param options.page - Page number for paginated results.
+   * @param options.fullResult - Include full item data when `true`.
+   * @returns Paginated matching items.
+   */
+  async searchItems(filters = {}, options = {}) {
+    const { page, fullResult } = options;
+    return this.client.request({
+      method: "POST",
+      path: "/item/search",
+      params: page !== void 0 ? { page } : void 0,
+      presenceParams: fullResult ? ["fullResult"] : void 0,
+      data: filters
+    });
+  }
+  /**
+   * Quick text search for items by name.
+   *
+   * @param query - Free-text item name query.
+   * @returns Matching items keyed by internal name.
+   */
+  async quickSearchItems(query) {
+    return this.client.request({
+      path: `/item/search/${encodeURIComponent(query)}`
+    });
+  }
+  /**
+   * List recipes from the recipe database.
+   *
+   * @param options.page - Page number for paginated results.
+   * @param options.fullResult - Include full recipe data when `true`.
+   * @returns Paginated recipe list.
+   */
+  async listRecipes(options = {}) {
+    const { page, fullResult } = options;
+    return this.client.request({
+      path: "/item/recipe/database",
+      params: page !== void 0 ? { page } : void 0,
+      presenceParams: fullResult ? ["full_result"] : void 0
+    });
+  }
+  /**
+   * Search recipes with structured filters.
+   *
+   * @param filters - Search criteria such as `type`, `skill`, `materials`, and `level`.
+   * @param options.page - Page number for paginated results.
+   * @param options.fullResult - Include full recipe data when `true`.
+   * @returns Paginated matching recipes.
+   */
+  async searchRecipes(filters = {}, options = {}) {
+    const { page, fullResult } = options;
+    return this.client.request({
+      method: "POST",
+      path: "/item/recipe/search",
+      params: page !== void 0 ? { page } : void 0,
+      presenceParams: fullResult ? ["full_result"] : void 0,
+      data: filters
+    });
+  }
+  /**
+   * Fetch item metadata.
+   *
+   * @param options.static - Include static value maps when `true`.
+   * @returns Filter definitions, tiers, and identification metadata.
+   */
+  async getMetadata(options = {}) {
+    return this.client.request({
+      path: "/item/metadata",
+      presenceParams: options.static ? ["static"] : void 0
+    });
+  }
+  /** @returns All item sets. */
+  async listSets() {
+    return this.client.request({
+      path: "/item/sets"
+    });
+  }
+};
+var GuildBannerLayerSchema = zod.z.object({
+  color: zod.z.string().optional(),
+  colour: zod.z.string().optional(),
+  pattern: zod.z.string()
+}).passthrough();
+var GuildBannerSchema2 = zod.z.object({
+  base: zod.z.string(),
+  tier: zod.z.number(),
+  structure: zod.z.string(),
+  layers: zod.z.array(GuildBannerLayerSchema)
+}).passthrough();
+var LeaderboardEntrySchema = zod.z.object({
+  metaScore: zod.z.number().optional(),
+  name: zod.z.string(),
+  uuid: zod.z.uuid().optional(),
+  prefix: zod.z.string().optional(),
+  score: zod.z.number().optional(),
+  metadata: zod.z.record(zod.z.string(), zod.z.unknown()).optional(),
+  banner: GuildBannerSchema2.optional(),
+  previousRanking: zod.z.number().optional(),
+  level: zod.z.number().optional(),
+  xp: zod.z.number().optional(),
+  territories: zod.z.number().optional(),
+  wars: zod.z.number().optional(),
+  created: zod.z.string().optional(),
+  characterUuid: zod.z.uuid().optional(),
+  characterType: zod.z.string().optional(),
+  characterData: zod.z.record(zod.z.string(), zod.z.unknown()).optional(),
+  rank: zod.z.string().optional(),
+  supportRank: zod.z.string().nullable().optional(),
+  shortenedRank: zod.z.string().nullable().optional(),
+  legacyRankColour: zod.z.object({
+    main: zod.z.string(),
+    sub: zod.z.string()
+  }).optional(),
+  rankBadge: zod.z.string().optional(),
+  restricted: zod.z.boolean().optional()
+}).passthrough();
+var GetLeaderboardOptionsSchema = zod.z.object({
+  resultLimit: zod.z.number().optional()
+});
+var GetLeaderboardResultSchema = zod.z.record(zod.z.string(), LeaderboardEntrySchema);
+var ListLeaderboardTypesResultSchema = zod.z.array(zod.z.string());
+
+// src/modules/leaderboards.ts
+var LeaderboardsModule = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  /** @returns Available leaderboard type identifiers. */
+  async listTypes() {
+    return this.client.request({
+      path: "/leaderboards/types"
+    });
+  }
+  /**
+   * Fetch entries for a leaderboard type.
+   *
+   * @param lbType - Leaderboard type slug from {@link LeaderboardsModule.listTypes}.
+   * @param options.resultLimit - Maximum number of entries to return.
+   * @returns Leaderboard entries keyed by rank position.
+   */
+  async get(lbType, options = {}) {
+    const { resultLimit } = options;
+    return this.client.request({
+      path: `/leaderboards/${encodeURIComponent(lbType)}`,
+      params: resultLimit !== void 0 ? { resultLimit } : void 0
+    });
+  }
+};
+var GetQuestCountResultSchema = zod.z.object({
+  quests: zod.z.number()
+});
+var MapCoordinate3DSchema = zod.z.object({
+  x: zod.z.number(),
+  y: zod.z.number(),
+  z: zod.z.number()
+});
+
+// src/schemas/map/map.ts
+var WorldEventRequirementSchema = zod.z.object({
+  type: zod.z.string(),
+  value: zod.z.union([zod.z.number(), zod.z.string()])
+});
+var LootPoolRewardSchema = zod.z.object({
+  name: zod.z.string(),
+  type: zod.z.string(),
+  amount: zod.z.number(),
+  always: zod.z.boolean(),
+  tier: zod.z.string().nullable().optional(),
+  shiny: zod.z.boolean().optional()
+});
+var MapLootPoolQueryOptionsSchema = zod.z.object({
+  level: zod.z.number().optional()
+});
+var MapLootPoolContentSchema = zod.z.object({
+  name: zod.z.string(),
+  internalName: zod.z.string(),
+  type: zod.z.string(),
+  lore: zod.z.string().nullable(),
+  difficulty: zod.z.string().nullable(),
+  level: zod.z.number().nullable(),
+  length: zod.z.string().nullable(),
+  requirements: zod.z.array(WorldEventRequirementSchema).nullable(),
+  location: MapCoordinate3DSchema.nullable(),
+  rewards: zod.z.array(LootPoolRewardSchema)
+});
+var LootPoolSchema = zod.z.object({
+  name: zod.z.string(),
+  internalName: zod.z.string(),
+  type: zod.z.string(),
+  rewards: zod.z.array(LootPoolRewardSchema)
+});
+var WorldEventLocationSchema = zod.z.object({
+  event: zod.z.union([MapCoordinate3DSchema, zod.z.null()]),
+  spawn: zod.z.union([MapCoordinate3DSchema, zod.z.null()]),
+  reward: zod.z.union([MapCoordinate3DSchema, zod.z.null()]),
+  radius: zod.z.number().nullable(),
+  spawnRadius: zod.z.number().nullable()
+});
+var WorldEventSchema = zod.z.object({
+  name: zod.z.string(),
+  internalName: zod.z.string(),
+  lore: zod.z.string(),
+  difficulty: zod.z.string().nullable(),
+  level: zod.z.number().nullable(),
+  length: zod.z.string().nullable(),
+  rewardPerLevel: zod.z.record(zod.z.string(), zod.z.array(zod.z.string())).nullable(),
+  requirements: zod.z.array(WorldEventRequirementSchema).nullable(),
+  location: zod.z.array(WorldEventLocationSchema),
+  schedule: zod.z.string().nullable()
+});
+var PlayerLocationMemberSchema = zod.z.object({
+  uuid: zod.z.uuid(),
+  name: zod.z.string(),
+  nickname: zod.z.string().nullable(),
+  character: zod.z.uuid(),
+  server: zod.z.string().nullable(),
+  x: zod.z.number(),
+  y: zod.z.number(),
+  z: zod.z.number()
+});
+var PlayerLocationSchema = zod.z.object({
+  uuid: zod.z.uuid(),
+  name: zod.z.string(),
+  nickname: zod.z.string().nullable(),
+  character: zod.z.uuid(),
+  server: zod.z.string().nullable(),
+  x: zod.z.number(),
+  y: zod.z.number(),
+  z: zod.z.number(),
+  friends: zod.z.array(PlayerLocationMemberSchema),
+  party: zod.z.array(PlayerLocationMemberSchema),
+  guild: zod.z.array(PlayerLocationMemberSchema)
+});
+var GatheringNodeSchema = zod.z.object({
+  x: zod.z.number(),
+  y: zod.z.number(),
+  z: zod.z.number(),
+  angle: zod.z.number(),
+  type: zod.z.enum(["NODE", "WALL", "CORNER"]),
+  resource: zod.z.string(),
+  level: zod.z.number()
+});
+var MapMarkerSchema = zod.z.object({
+  name: zod.z.string(),
+  icon: zod.z.string(),
+  x: zod.z.string(),
+  y: zod.z.string(),
+  z: zod.z.string()
+});
+
+// src/schemas/map/list-gathering-nodes.ts
+var ListGatheringNodesResultSchema = zod.z.array(GatheringNodeSchema);
+var ListMapMarkersResultSchema = zod.z.array(MapMarkerSchema);
+var ListMapCampsOptionsSchema = MapLootPoolQueryOptionsSchema;
+var ListMapCampsResultSchema = zod.z.array(MapLootPoolContentSchema);
+var ListMapLootPoolsOptionsSchema = MapLootPoolQueryOptionsSchema;
+var ListMapLootPoolsResultSchema = zod.z.array(LootPoolSchema);
+var ListMapRaidsOptionsSchema = MapLootPoolQueryOptionsSchema;
+var ListMapRaidsResultSchema = zod.z.array(MapLootPoolContentSchema);
+var ListPlayerLocationsResultSchema = zod.z.array(PlayerLocationSchema);
+var ListWorldEventsResultSchema = zod.z.array(WorldEventSchema);
+
+// src/modules/map.ts
+var MapModule = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  /** @returns Live player locations on the world map. */
+  async listPlayerLocations() {
+    return this.client.request({
+      path: "/map/locations/player"
+    });
+  }
+  /** @returns Map markers such as NPCs, dungeons, and points of interest. */
+  async listMarkers() {
+    return this.client.request({
+      path: "/map/locations/markers"
+    });
+  }
+  /** @returns Currently active world events. */
+  async listWorldEvents() {
+    return this.client.request({
+      path: "/map/world-events"
+    });
+  }
+  /**
+   * List camps.
+   *
+   * @param options.level - Filter to camps at a specific combat level.
+   * @returns Camp definitions and loot pool contents.
+   */
+  async listCamps(options = {}) {
+    const { level } = options;
+    return this.client.request({
+      path: "/map/camps",
+      params: level !== void 0 ? { level } : void 0
+    });
+  }
+  /**
+   * List raids.
+   *
+   * @param options.level - Filter to raids at a specific combat level.
+   * @returns Raid definitions and loot pool contents.
+   */
+  async listRaids(options = {}) {
+    const { level } = options;
+    return this.client.request({
+      path: "/map/raids",
+      params: level !== void 0 ? { level } : void 0
+    });
+  }
+  /**
+   * List loot pools.
+   *
+   * @param options.level - Filter to loot pools at a specific combat level.
+   * @returns Loot pool definitions and contents.
+   */
+  async listLootPools(options = {}) {
+    const { level } = options;
+    return this.client.request({
+      path: "/map/loot-pools",
+      params: level !== void 0 ? { level } : void 0
+    });
+  }
+  /** @returns Gathering node locations across the map. */
+  async listGatheringNodes() {
+    return this.client.request({
+      path: "/map/gathering-nodes"
+    });
+  }
+  /** @returns Quest completion counts across the map. */
+  async getQuestCount() {
+    return this.client.request({
+      path: "/map/quests"
+    });
+  }
+};
+var PublisherArticleTypeSchema = zod.z.enum(["blog", "event", "giveaway", "article", "poll"]);
+var PublisherPollRequirementSchema = zod.z.object({
+  type: zod.z.string(),
+  subType: zod.z.string().nullable(),
+  value: zod.z.number()
+});
+var PublisherPollQuestionSchema = zod.z.object({
+  answers: zod.z.record(zod.z.string(), zod.z.string()),
+  override: zod.z.boolean(),
+  question: zod.z.string(),
+  requirements: zod.z.array(PublisherPollRequirementSchema)
+});
+var PublisherArticleContentBlockSchema = zod.z.object({
+  id: zod.z.string(),
+  type: zod.z.string(),
+  focus: zod.z.boolean(),
+  content: zod.z.union([zod.z.string(), PublisherPollQuestionSchema]),
+  discord: zod.z.boolean(),
+  website: zod.z.boolean()
+});
+var PublisherArticleSchema = zod.z.object({
+  id: zod.z.number(),
+  type: PublisherArticleTypeSchema,
+  created_by: zod.z.string(),
+  discord_messages: zod.z.record(zod.z.string(), zod.z.string()),
+  discord_recap: zod.z.boolean(),
+  allow_discord: zod.z.boolean(),
+  destination: zod.z.string(),
+  published: zod.z.boolean(),
+  pinned: zod.z.boolean(),
+  visible: zod.z.boolean(),
+  content: zod.z.array(PublisherArticleContentBlockSchema),
+  start_date: zod.z.string(),
+  end_date: zod.z.string().nullable(),
+  recap: zod.z.string(),
+  title: zod.z.string(),
+  banner: zod.z.string(),
+  banner_zoom: zod.z.boolean(),
+  likes: zod.z.number(),
+  published_at: zod.z.string(),
+  require_discord: zod.z.boolean(),
+  require_clan: zod.z.boolean(),
+  poll_settings: zod.z.array(PublisherPollRequirementSchema).optional(),
+  poll_public: zod.z.boolean().optional(),
+  votes: zod.z.record(zod.z.string(), zod.z.unknown()).nullable().optional()
+}).passthrough();
+var PublisherArticleSummarySchema = zod.z.object({
+  pk: zod.z.number(),
+  title: zod.z.string(),
+  type: PublisherArticleTypeSchema,
+  banner: zod.z.string(),
+  banner_zoom: zod.z.boolean(),
+  recap: zod.z.string(),
+  visible: zod.z.boolean(),
+  start_date: zod.z.string(),
+  end_date: zod.z.string().nullable(),
+  pinned: zod.z.boolean(),
+  has_content: zod.z.boolean(),
+  published_at: zod.z.string()
+});
+var FetchPublisherArticleResultSchema = PublisherArticleSchema;
+var LatestNewsEntrySchema = zod.z.object({
+  title: zod.z.string(),
+  date: zod.z.string(),
+  forumThread: zod.z.string(),
+  author: zod.z.string(),
+  content: zod.z.string(),
+  comments: zod.z.string()
+});
+var ListLatestNewsResultSchema = zod.z.array(LatestNewsEntrySchema);
+var ListPublisherArticlesOptionsSchema = zod.z.object({
+  page: zod.z.number().optional()
+});
+var ListPublisherArticlesResultSchema = zod.z.object({
+  controller: PaginationControllerSchema,
+  results: zod.z.record(zod.z.string(), PublisherArticleSummarySchema)
+});
+var ListPublisherVideosResultSchema = zod.z.record(zod.z.string(), zod.z.string());
+
+// src/modules/news.ts
+var NewsModule = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  /**
+   * Fetch a single publisher article.
+   *
+   * @param articleType - Article category: `blog`, `event`, `giveaway`, `article`, or `poll`.
+   * @param pk - Article primary key (numeric ID or slug).
+   * @returns Full article content and metadata.
+   */
+  async fetchArticle(articleType, pk) {
+    return this.client.request({
+      path: `/publisher/articles/fetch/${encodeURIComponent(articleType)}/${encodeURIComponent(String(pk))}`
+    });
+  }
+  /**
+   * List publisher articles of a given type.
+   *
+   * @param articleType - Article category: `blog`, `event`, `giveaway`, `article`, or `poll`.
+   * @param options.page - Page number for paginated results.
+   * @returns Paginated article summaries.
+   */
+  async listArticles(articleType, options = {}) {
+    const { page } = options;
+    return this.client.request({
+      path: `/publisher/articles/list/${encodeURIComponent(articleType)}`,
+      params: page !== void 0 ? { page } : void 0
+    });
+  }
+  /** @returns Publisher video listings. */
+  async listVideos() {
+    return this.client.request({
+      path: "/publisher/videos/list"
+    });
+  }
+  /** @returns Latest news feed entries. */
+  async listLatestNews() {
+    return this.client.request({
+      path: "/latest-news"
+    });
+  }
+};
+var ExchangeOAuthTokenOptionsSchema = zod.z.object({
+  code: zod.z.string(),
+  redirectUri: zod.z.string(),
+  clientId: zod.z.string(),
+  clientSecret: zod.z.string().optional(),
+  codeVerifier: zod.z.string().optional()
+});
+var ExchangeOAuthTokenResultSchema = zod.z.object({
+  access_token: zod.z.string(),
+  token_type: zod.z.literal("bearer"),
+  scope: zod.z.string()
+});
+function toOAuthTokenFormBody(options) {
+  const body = new URLSearchParams();
+  body.set("grant_type", "authorization_code");
+  body.set("code", options.code);
+  body.set("redirect_uri", options.redirectUri);
+  body.set("client_id", options.clientId);
+  if (options.clientSecret) {
+    body.set("client_secret", options.clientSecret);
+  }
+  if (options.codeVerifier) {
+    body.set("code_verifier", options.codeVerifier);
+  }
+  return body;
+}
+var LegacyRankColourSchema = zod.z.object({
+  main: zod.z.string(),
+  sub: zod.z.string()
+});
+var PlayerIdentitySchema = zod.z.object({
+  username: zod.z.string(),
+  online: zod.z.boolean(),
+  nickname: zod.z.string().nullable(),
+  rank: zod.z.string(),
+  supportRank: zod.z.string().nullable(),
+  shortenedRank: zod.z.string().nullable(),
+  legacyRankColour: LegacyRankColourSchema,
+  rankBadge: zod.z.string()
+});
+var WhoAmIResultSchema = zod.z.record(zod.z.uuid(), PlayerIdentitySchema);
+
+// src/schemas/oauth/get-oauth-identity.ts
+var OAuthApplicationSchema = zod.z.object({
+  client_id: zod.z.string(),
+  scopes: zod.z.array(zod.z.string())
+});
+var OAuthProfileSchema = zod.z.object({
+  username: zod.z.string(),
+  primary: zod.z.boolean(),
+  rank: zod.z.string(),
+  supportRank: zod.z.string().nullable(),
+  shortenedRank: zod.z.string().nullable(),
+  legacyRankColour: LegacyRankColourSchema,
+  rankBadge: zod.z.string(),
+  accessRules: zod.z.record(zod.z.string(), zod.z.string())
+});
+var GetOAuthIdentityResultSchema = zod.z.object({
+  application: OAuthApplicationSchema,
+  profiles: zod.z.record(zod.z.uuid(), OAuthProfileSchema)
+});
+
+// src/modules/oauth.ts
+var OAuthModule = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  /**
+   * Fetch the authenticated OAuth user's identity.
+   *
+   * Requires `{ type: "oauth", accessToken }` credentials on the client.
+   *
+   * @returns OAuth user profile and linked Wynncraft account.
+   */
+  async me() {
+    return this.client.request({
+      path: "/oauth/me"
+    });
+  }
+  /**
+   * Exchange an authorization code for access tokens.
+   *
+   * @param options.code - Authorization code from the OAuth redirect.
+   * @param options.redirectUri - Redirect URI registered with the OAuth app.
+   * @param options.clientId - OAuth application client ID.
+   * @param options.clientSecret - OAuth application client secret (confidential clients).
+   * @param options.codeVerifier - PKCE code verifier, if the flow used PKCE.
+   * @returns Access token and granted scopes.
+   */
+  async exchangeToken(options) {
+    return this.client.request({
+      method: "POST",
+      path: "/oauth/token",
+      data: toOAuthTokenFormBody(options),
+      headers: {
+        "Content-Type": "application/x-www-form-urlencoded"
+      }
+    });
+  }
+};
+var LightCharacterMetaSchema = zod.z.object({
+  died: zod.z.boolean()
+});
+var LightCharacterSchema = zod.z.object({
+  type: zod.z.string(),
+  reskin: zod.z.string().nullable(),
+  nickname: zod.z.string().nullable(),
+  level: zod.z.number(),
+  xp: zod.z.number(),
+  xpPercent: zod.z.number(),
+  totalLevel: zod.z.number(),
+  gamemode: zod.z.array(zod.z.string()),
+  meta: LightCharacterMetaSchema
+});
+var ListPlayerCharactersResultSchema = zod.z.record(zod.z.uuid(), LightCharacterSchema);
+var GetCharacterAbilitiesResultSchema = AbilityMapPagesSchema;
+var GetPlayerOptionsSchema = zod.z.object({
+  fullResult: zod.z.boolean().optional()
+});
+var GuildReferenceSchema = zod.z.object({
+  uuid: zod.z.uuid(),
+  name: zod.z.string(),
+  prefix: zod.z.string(),
+  rank: zod.z.string().nullable().optional(),
+  rankStars: zod.z.string().nullable().optional()
+});
+var RankMapSchema = zod.z.record(zod.z.string(), zod.z.number());
+var CountListSchema2 = zod.z.object({
+  total: zod.z.number(),
+  list: zod.z.record(zod.z.string(), zod.z.number())
+});
+var RaidStatsSchema = zod.z.object({
+  damageTaken: zod.z.number(),
+  damageDealt: zod.z.number(),
+  healthHealed: zod.z.number(),
+  deaths: zod.z.number(),
+  buffsTaken: zod.z.number(),
+  gambitsUsed: zod.z.number()
+});
+var PvpStatsSchema2 = zod.z.object({
+  kills: zod.z.number().optional(),
+  deaths: zod.z.number().optional()
+});
+var PlayerGlobalDataSchema = zod.z.object({
+  contentCompletion: zod.z.number(),
+  wars: zod.z.number(),
+  totalLevel: zod.z.number(),
+  mobsKilled: zod.z.number(),
+  chestsFound: zod.z.number(),
+  dungeons: CountListSchema2,
+  raids: CountListSchema2,
+  worldEvents: zod.z.number(),
+  lootruns: zod.z.number(),
+  caves: zod.z.number(),
+  completedQuests: zod.z.number(),
+  guildRaids: CountListSchema2.nullable(),
+  raidStats: RaidStatsSchema.nullable(),
+  pvp: PvpStatsSchema2
+});
+var ProfessionProgressSchema = zod.z.object({
+  level: zod.z.number(),
+  xpPercent: zod.z.number()
+});
+var ProfessionsSchema = zod.z.object({
+  fishing: ProfessionProgressSchema.optional(),
+  woodcutting: ProfessionProgressSchema.optional(),
+  mining: ProfessionProgressSchema.optional(),
+  farming: ProfessionProgressSchema.optional(),
+  scribing: ProfessionProgressSchema.optional(),
+  jeweling: ProfessionProgressSchema.optional(),
+  alchemism: ProfessionProgressSchema.optional(),
+  cooking: ProfessionProgressSchema.optional(),
+  weaponsmithing: ProfessionProgressSchema.optional(),
+  tailoring: ProfessionProgressSchema.optional(),
+  woodworking: ProfessionProgressSchema.optional(),
+  armouring: ProfessionProgressSchema.optional()
+});
+var CharacterSchema = zod.z.object({
+  type: zod.z.string(),
+  reskin: zod.z.string().nullable(),
+  nickname: zod.z.string().nullable(),
+  level: zod.z.number(),
+  xp: zod.z.number(),
+  xpPercent: zod.z.number(),
+  totalLevel: zod.z.number(),
+  preEconomy: zod.z.boolean().nullable(),
+  gamemode: zod.z.array(zod.z.string()),
+  contentCompletion: zod.z.number(),
+  wars: zod.z.number(),
+  playtime: zod.z.number(),
+  mobsKilled: zod.z.number(),
+  chestsFound: zod.z.number(),
+  itemsIdentified: zod.z.number(),
+  blocksWalked: zod.z.number(),
+  logins: zod.z.number(),
+  deaths: zod.z.number(),
+  discoveries: zod.z.number(),
+  pvp: PvpStatsSchema2,
+  skillPoints: zod.z.record(zod.z.string(), zod.z.number()).nullable(),
+  professions: ProfessionsSchema,
+  dungeons: CountListSchema2.nullable(),
+  raids: CountListSchema2.nullable(),
+  worldEvents: zod.z.number(),
+  lootruns: zod.z.number(),
+  caves: zod.z.number(),
+  quests: zod.z.array(zod.z.string()),
+  restrictions: zod.z.record(zod.z.string(), zod.z.boolean()),
+  removedStat: zod.z.array(zod.z.string())
+});
+var GetPlayerResultSchema = zod.z.object({
+  username: zod.z.string(),
+  online: zod.z.boolean(),
+  server: zod.z.string().nullable(),
+  activeCharacter: zod.z.uuid().nullable(),
+  nickname: zod.z.string().nullable(),
+  uuid: zod.z.uuid(),
+  rank: zod.z.string(),
+  rankBadge: zod.z.string(),
+  legacyRankColour: LegacyRankColourSchema,
+  shortenedRank: zod.z.string().nullable(),
+  supportRank: zod.z.string().nullable(),
+  veteran: zod.z.boolean(),
+  lastJoin: zod.z.string(),
+  guild: GuildReferenceSchema.nullable(),
+  ranking: RankMapSchema,
+  previousRanking: RankMapSchema,
+  firstJoin: zod.z.string(),
+  playtime: zod.z.number(),
+  globalData: PlayerGlobalDataSchema,
+  featuredStats: zod.z.record(zod.z.string(), zod.z.union([zod.z.string(), zod.z.number()])),
+  wallpaper: zod.z.string(),
+  avatar: zod.z.string(),
+  restrictions: zod.z.record(zod.z.string(), zod.z.boolean()),
+  characters: zod.z.record(zod.z.uuid(), CharacterSchema).optional()
+});
+var ListOnlinePlayersOptionsSchema = zod.z.object({
+  identifier: zod.z.union([zod.z.string(), zod.z.uuid()]).optional(),
+  server: zod.z.union([zod.z.string(), zod.z.number()]).optional()
+});
+var ListOnlinePlayersResultSchema = zod.z.object({
+  total: zod.z.number(),
+  players: zod.z.record(zod.z.string(), zod.z.string())
+});
+
+// src/modules/player.ts
+var PlayerModule = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  /**
+   * List currently online players.
+   *
+   * @param options.identifier - Filter by username or UUID.
+   * @param options.server - Filter by server name or number.
+   * @returns Online player count and username-to-server map.
+   */
+  async listOnlinePlayers(options = {}) {
+    return this.client.request({
+      path: "/player",
+      params: options
+    });
+  }
+  /**
+   * Fetch the authenticated player's profile.
+   *
+   * Requires credentials on the client.
+   *
+   * @returns UUID-keyed map of {@link PlayerIdentity}. The API returns a
+   * single entry for the authenticated account.
+   *
+   * @example
+   * ```ts
+   * const { data } = await client.player.whoAmI();
+   * const profile = Object.values(data)[0]!;
+   * ```
+   */
+  async whoAmI() {
+    return this.client.request({
+      path: "/player/whoami"
+    });
+  }
+  /**
+   * Fetch a player profile by username.
+   *
+   * @param username - Wynncraft username.
+   * @param options.fullResult - Include extended character data when `true`.
+   * @returns Player profile and character summaries.
+   */
+  async getPlayer(username, options = {}) {
+    return this.client.request({
+      path: `/player/${encodeURIComponent(username)}`,
+      presenceParams: options.fullResult ? ["fullResult"] : void 0
+    });
+  }
+  /**
+   * List characters for a player.
+   *
+   * @param username - Wynncraft username.
+   * @returns Character list keyed by UUID.
+   */
+  async listCharacters(username) {
+    return this.client.request({
+      path: `/player/${encodeURIComponent(username)}/characters`
+    });
+  }
+  /**
+   * Fetch ability assignments for a specific character.
+   *
+   * @param username - Wynncraft username.
+   * @param characterUuid - Character UUID from {@link PlayerModule.listCharacters}.
+   * @returns Ability map keyed by page.
+   */
+  async getCharacterAbilities(username, characterUuid) {
+    return this.client.request({
+      path: `/player/${encodeURIComponent(username)}/characters/${encodeURIComponent(characterUuid)}/abilities`
+    });
+  }
+};
+var SearchGuildResultSchema = zod.z.object({
+  name: zod.z.string(),
+  prefix: zod.z.string()
+});
+var SearchAreaResultSchema = zod.z.object({
+  start: zod.z.array(zod.z.unknown()),
+  end: zod.z.array(zod.z.unknown())
+});
+var GlobalSearchOptionsSchema = zod.z.object({
+  only: zod.z.string().optional()
+});
+var GlobalSearchResultSchema = zod.z.object({
+  query: zod.z.string(),
+  players: zod.z.record(zod.z.string(), zod.z.string()).optional(),
+  guilds: zod.z.record(zod.z.string(), SearchGuildResultSchema).optional(),
+  items: ItemListSchema.optional(),
+  guildsPrefix: zod.z.record(zod.z.string(), SearchGuildResultSchema).optional(),
+  territories: zod.z.record(zod.z.string(), SearchAreaResultSchema).optional(),
+  discoveries: zod.z.record(zod.z.string(), SearchAreaResultSchema).optional()
+});
+
+// src/modules/search.ts
+var SearchModule = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  /**
+   * Search across Wynncraft resources.
+   *
+   * @param query - Free-text search query.
+   * @param options.only - Limit results to a resource type, e.g. `player`, `guild`, or `item`.
+   * @returns Matching players, guilds, items, and related entities.
+   */
+  async search(query, options = {}) {
+    const { only } = options;
+    return this.client.request({
+      path: `/search/${encodeURIComponent(query)}`,
+      params: only !== void 0 ? { only } : void 0
+    });
+  }
+};
+
+// src/client.ts
+var WynnClient = class {
+  /** Player profiles, characters, and online status. */
+  player;
+  /** Guild listings, seasons, and territory data. */
+  guild;
+  /** Item database, search, recipes, and metadata. */
+  item;
+  /** Ability trees, maps, and aspects. */
+  ability;
+  /** Playable classes and their metadata. */
+  classes;
+  /** Map markers, raids, camps, and world events. */
+  map;
+  /** Leaderboard types and rankings. */
+  leaderboards;
+  /** Publisher articles, videos, and latest news. */
+  news;
+  /** Global search across players, guilds, and items. */
+  search;
+  /** OAuth identity and token exchange. */
+  oauth;
+  http;
+  auth;
+  /**
+   * @param options - Client configuration. All fields are optional.
+   * @param options.baseUrl - API base URL. Defaults to {@link API_BASE_URL}.
+   * @param options.auth - Credentials for authenticated endpoints.
+   * @param options.http - Custom Axios instance, e.g. for mocking in tests.
+   */
+  constructor(options = {}) {
+    this.auth = options.auth;
+    this.http = options.http ?? axios__default.default.create({
+      baseURL: options.baseUrl ?? API_BASE_URL,
+      headers: {
+        "Content-Type": "application/json",
+        ...authHeaders(this.auth)
+      }
+    });
+    this.http.interceptors.response.use(
+      (response) => response,
+      (error) => Promise.reject(toWynnApiError(error) ?? error)
+    );
+    this.player = new PlayerModule(this);
+    this.guild = new GuildModule(this);
+    this.item = new ItemModule(this);
+    this.ability = new AbilityModule(this);
+    this.classes = new ClassesModule(this);
+    this.map = new MapModule(this);
+    this.leaderboards = new LeaderboardsModule(this);
+    this.news = new NewsModule(this);
+    this.search = new SearchModule(this);
+    this.oauth = new OAuthModule(this);
+  }
+  /**
+   * Low-level request helper. Prefer module methods when available.
+   *
+   * @param config.path - API route path, e.g. `/player/foo`.
+   * @param config.method - HTTP method. Defaults to `GET`.
+   * @param config.params - Standard query parameters.
+   * @param config.presenceParams - Wynncraft presence flags without values, e.g. `fullResult`.
+   * @param config.data - Request body for `POST`/`PUT` requests.
+   * @param config.headers - Additional request headers.
+   * @returns Parsed response body and rate-limit metadata.
+   */
+  async request(config) {
+    const response = await this.http.request(toAxiosRequestConfig(config));
+    return {
+      data: response.data,
+      rateLimit: parseRateLimit(response.headers)
+    };
+  }
+  /** Return the credentials passed at construction, if any. */
+  getAuth() {
+    return this.auth;
+  }
+};
+
+exports.API_BASE_URL = API_BASE_URL;
+exports.AbilityIconSchema = AbilityIconSchema;
+exports.AbilityMapNodeSchema = AbilityMapNodeSchema;
+exports.AbilityMapPagesSchema = AbilityMapPagesSchema;
+exports.CDN_BASE_URL = CDN_BASE_URL;
+exports.ClassNameSchema = ClassNameSchema;
+exports.ClassTreeSchema = ClassTreeSchema;
+exports.ExchangeOAuthTokenOptionsSchema = ExchangeOAuthTokenOptionsSchema;
+exports.ExchangeOAuthTokenResultSchema = ExchangeOAuthTokenResultSchema;
+exports.FetchPublisherArticleResultSchema = FetchPublisherArticleResultSchema;
+exports.GatheringNodeSchema = GatheringNodeSchema;
+exports.GetAbilityMapResultSchema = GetAbilityMapResultSchema;
+exports.GetAbilityTreeResultSchema = GetAbilityTreeResultSchema;
+exports.GetCharacterAbilitiesResultSchema = GetCharacterAbilitiesResultSchema;
+exports.GetClassResultSchema = GetClassResultSchema;
+exports.GetGuildOptionsSchema = GetGuildOptionsSchema;
+exports.GetItemMetadataOptionsSchema = GetItemMetadataOptionsSchema;
+exports.GetLeaderboardOptionsSchema = GetLeaderboardOptionsSchema;
+exports.GetLeaderboardResultSchema = GetLeaderboardResultSchema;
+exports.GetOAuthIdentityResultSchema = GetOAuthIdentityResultSchema;
+exports.GetPlayerOptionsSchema = GetPlayerOptionsSchema;
+exports.GetPlayerResultSchema = GetPlayerResultSchema;
+exports.GetQuestCountResultSchema = GetQuestCountResultSchema;
+exports.GlobalSearchOptionsSchema = GlobalSearchOptionsSchema;
+exports.GlobalSearchResultSchema = GlobalSearchResultSchema;
+exports.GuildResultSchema = GuildResultSchema;
+exports.IdentificationValueSchema = IdentificationValueSchema;
+exports.ItemListSchema = ItemListSchema;
+exports.ItemMetadataSchema = ItemMetadataSchema;
+exports.ItemSchema = ItemSchema;
+exports.ItemSearchRequestSchema = ItemSearchRequestSchema;
+exports.ItemStaticMetadataSchema = ItemStaticMetadataSchema;
+exports.LeaderboardEntrySchema = LeaderboardEntrySchema;
+exports.LegacyRankColourSchema = LegacyRankColourSchema;
+exports.ListAspectsResultSchema = ListAspectsResultSchema;
+exports.ListClassesResultSchema = ListClassesResultSchema;
+exports.ListGatheringNodesResultSchema = ListGatheringNodesResultSchema;
+exports.ListGuildSeasonsResultSchema = ListGuildSeasonsResultSchema;
+exports.ListGuildTerritoriesResultSchema = ListGuildTerritoriesResultSchema;
+exports.ListGuildsByNameResultSchema = ListGuildsByNameResultSchema;
+exports.ListGuildsByUuidResultSchema = ListGuildsByUuidResultSchema;
+exports.ListGuildsOptionsSchema = ListGuildsOptionsSchema;
+exports.ListItemSetsResultSchema = ListItemSetsResultSchema;
+exports.ListItemsOptionsSchema = ListItemsOptionsSchema;
+exports.ListItemsResultSchema = ListItemsResultSchema;
+exports.ListLatestNewsResultSchema = ListLatestNewsResultSchema;
+exports.ListLeaderboardTypesResultSchema = ListLeaderboardTypesResultSchema;
+exports.ListMapCampsOptionsSchema = ListMapCampsOptionsSchema;
+exports.ListMapCampsResultSchema = ListMapCampsResultSchema;
+exports.ListMapLootPoolsOptionsSchema = ListMapLootPoolsOptionsSchema;
+exports.ListMapLootPoolsResultSchema = ListMapLootPoolsResultSchema;
+exports.ListMapMarkersResultSchema = ListMapMarkersResultSchema;
+exports.ListMapRaidsOptionsSchema = ListMapRaidsOptionsSchema;
+exports.ListMapRaidsResultSchema = ListMapRaidsResultSchema;
+exports.ListOnlinePlayersOptionsSchema = ListOnlinePlayersOptionsSchema;
+exports.ListOnlinePlayersResultSchema = ListOnlinePlayersResultSchema;
+exports.ListPlayerCharactersResultSchema = ListPlayerCharactersResultSchema;
+exports.ListPlayerLocationsResultSchema = ListPlayerLocationsResultSchema;
+exports.ListPublisherArticlesOptionsSchema = ListPublisherArticlesOptionsSchema;
+exports.ListPublisherArticlesResultSchema = ListPublisherArticlesResultSchema;
+exports.ListPublisherVideosResultSchema = ListPublisherVideosResultSchema;
+exports.ListRecipesOptionsSchema = ListRecipesOptionsSchema;
+exports.ListRecipesResultSchema = ListRecipesResultSchema;
+exports.ListWorldEventsResultSchema = ListWorldEventsResultSchema;
+exports.LootPoolRewardSchema = LootPoolRewardSchema;
+exports.LootPoolSchema = LootPoolSchema;
+exports.MapCoordinate3DSchema = MapCoordinate3DSchema;
+exports.MapLootPoolContentSchema = MapLootPoolContentSchema;
+exports.MapLootPoolQueryOptionsSchema = MapLootPoolQueryOptionsSchema;
+exports.MapMarkerSchema = MapMarkerSchema;
+exports.MultipleObjectsEntrySchema = MultipleObjectsEntrySchema;
+exports.MultipleObjectsMapSchema = MultipleObjectsMapSchema;
+exports.MultipleObjectsReturnedBodySchema = MultipleObjectsReturnedBodySchema;
+exports.PaginatedItemQueryOptionsSchema = PaginatedItemQueryOptionsSchema;
+exports.PaginatedItemResponseSchema = PaginatedItemResponseSchema;
+exports.PaginatedQueryOptionsSchema = PaginatedQueryOptionsSchema;
+exports.PaginatedRecipeQueryOptionsSchema = PaginatedRecipeQueryOptionsSchema;
+exports.PaginatedRecipeResponseSchema = PaginatedRecipeResponseSchema;
+exports.PaginationControllerSchema = PaginationControllerSchema;
+exports.PlayerIdentitySchema = PlayerIdentitySchema;
+exports.PlayerLocationMemberSchema = PlayerLocationMemberSchema;
+exports.PlayerLocationSchema = PlayerLocationSchema;
+exports.PublisherArticleSchema = PublisherArticleSchema;
+exports.PublisherArticleSummarySchema = PublisherArticleSummarySchema;
+exports.PublisherArticleTypeSchema = PublisherArticleTypeSchema;
+exports.QuickSearchItemsResultSchema = QuickSearchItemsResultSchema;
+exports.RecipeListSchema = RecipeListSchema;
+exports.RecipeSchema = RecipeSchema;
+exports.RecipeSearchRequestSchema = RecipeSearchRequestSchema;
+exports.SearchItemsOptionsSchema = SearchItemsOptionsSchema;
+exports.SearchItemsResultSchema = SearchItemsResultSchema;
+exports.SearchRecipesOptionsSchema = SearchRecipesOptionsSchema;
+exports.SearchRecipesResultSchema = SearchRecipesResultSchema;
+exports.WYNNCRAFT_API_VERSION = WYNNCRAFT_API_VERSION;
+exports.WhoAmIResultSchema = WhoAmIResultSchema;
+exports.WorldEventRequirementSchema = WorldEventRequirementSchema;
+exports.WorldEventSchema = WorldEventSchema;
+exports.WynnClient = WynnClient;
+exports.assetUrl = assetUrl;
+exports.toOAuthTokenFormBody = toOAuthTokenFormBody;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map