@dendotdev/grunt 1.0.0

package/dist/index.mjs

@@ -0,0 +1,2873 @@
+import { LRUCache } from 'lru-cache';
+
+// src/core/cache/cache-manager.ts
+var DEFAULT_TTL_MS = 60 * 60 * 1e3;
+var DEFAULT_MAX_SIZE = 1e3;
+var CacheManager = class {
+  cache;
+  /**
+   * Creates a new cache manager.
+   *
+   * @param ttlMs - Time-to-live for cached entries in milliseconds
+   * @param maxSize - Maximum number of entries to cache
+   */
+  constructor(ttlMs = DEFAULT_TTL_MS, maxSize = DEFAULT_MAX_SIZE) {
+    this.cache = new LRUCache({
+      max: maxSize,
+      ttl: ttlMs,
+      // Calculate size based on content length for memory management
+      sizeCalculation: (value) => {
+        return value.content.length + (value.etag?.length ?? 0);
+      },
+      // 50MB max memory for cache
+      maxSize: 50 * 1024 * 1024
+    });
+  }
+  /**
+   * Get a cached response if it exists and hasn't expired.
+   *
+   * @param key - Cache key (typically the request URL)
+   * @returns Cached response or null if not found/expired
+   */
+  get(key) {
+    return this.cache.get(key) ?? null;
+  }
+  /**
+   * Store a response in the cache.
+   *
+   * @param key - Cache key (typically the request URL)
+   * @param response - Response to cache
+   */
+  set(key, response) {
+    this.cache.set(key, response);
+  }
+  /**
+   * Check if a key exists in the cache without updating its recency.
+   *
+   * @param key - Cache key to check
+   * @returns true if the key exists and hasn't expired
+   */
+  has(key) {
+    return this.cache.has(key);
+  }
+  /**
+   * Remove a specific entry from the cache.
+   *
+   * @param key - Cache key to remove
+   * @returns true if an entry was removed
+   */
+  delete(key) {
+    return this.cache.delete(key);
+  }
+  /**
+   * Clear all cached entries.
+   */
+  clear() {
+    this.cache.clear();
+  }
+  /**
+   * Get the current number of cached entries.
+   */
+  get size() {
+    return this.cache.size;
+  }
+  /**
+   * Manually trigger cleanup of expired entries.
+   * This is called automatically by the LRU cache, but can be
+   * invoked manually if needed.
+   */
+  prune() {
+    this.cache.purgeStale();
+  }
+};
+
+// src/core/http/retry-policy.ts
+var DEFAULT_RETRY_OPTIONS = {
+  maxRetries: 3,
+  retryDelays: [200, 500, 1e3]
+};
+var TRANSIENT_STATUS_CODES = /* @__PURE__ */ new Set([
+  408,
+  // Request Timeout
+  429,
+  // Too Many Requests
+  500,
+  // Internal Server Error
+  502,
+  // Bad Gateway
+  503,
+  // Service Unavailable
+  504
+  // Gateway Timeout
+]);
+var RetryPolicy = class {
+  options;
+  /**
+   * Creates a new retry policy.
+   *
+   * @param options - Configuration options
+   */
+  constructor(options = {}) {
+    this.options = {
+      maxRetries: options.maxRetries ?? DEFAULT_RETRY_OPTIONS.maxRetries,
+      retryDelays: options.retryDelays ?? DEFAULT_RETRY_OPTIONS.retryDelays
+    };
+  }
+  /**
+   * Execute a function with retry logic.
+   *
+   * The function is called immediately. If it fails with a retryable error,
+   * it will be retried up to maxRetries times with delays between attempts.
+   *
+   * @param fn - Async function that returns a Response
+   * @returns The successful Response
+   * @throws The last error if all retries are exhausted
+   */
+  async execute(fn) {
+    let lastError = null;
+    for (let attempt = 0; attempt <= this.options.maxRetries; attempt++) {
+      try {
+        const response = await fn();
+        if (this.isTransientError(response)) {
+          lastError = new Error(
+            `HTTP ${response.status}: ${response.statusText}`
+          );
+          if (attempt < this.options.maxRetries) {
+            await this.delay(attempt);
+            continue;
+          }
+        }
+        return response;
+      } catch (error) {
+        lastError = error instanceof Error ? error : new Error(String(error));
+        if (!this.isRetryableError(error) || attempt >= this.options.maxRetries) {
+          throw lastError;
+        }
+        await this.delay(attempt);
+      }
+    }
+    throw lastError ?? new Error("Retry exhausted");
+  }
+  /**
+   * Check if a response indicates a transient server error.
+   */
+  isTransientError(response) {
+    return TRANSIENT_STATUS_CODES.has(response.status);
+  }
+  /**
+   * Check if an error is worth retrying.
+   * Network errors (TypeError from fetch) are retryable.
+   */
+  isRetryableError(error) {
+    if (error instanceof TypeError) {
+      return true;
+    }
+    return false;
+  }
+  /**
+   * Wait for the appropriate delay before the next retry.
+   */
+  delay(attempt) {
+    const delays = this.options.retryDelays;
+    const delayMs = delays[attempt] ?? delays[delays.length - 1] ?? 1e3;
+    return new Promise((resolve) => setTimeout(resolve, delayMs));
+  }
+};
+
+// src/models/common/api-content-type.ts
+var ApiContentType = {
+  /** Standard JSON content type */
+  Json: "json",
+  /** Bond compact binary format for binary data */
+  BondCompactBinary: "bond"
+};
+function getContentTypeHeader(contentType) {
+  switch (contentType) {
+    case ApiContentType.Json:
+      return "application/json";
+    case ApiContentType.BondCompactBinary:
+      return "application/x-bond-compact-binary";
+    default:
+      return "application/json";
+  }
+}
+
+// src/utils/constants.ts
+var USER_AGENTS = {
+  /**
+   * User-Agent for Halo PC client requests.
+   */
+  HALO_PC: "SHIVA-2043073184/6.10025.12948.0 (release; PC)",
+  /**
+   * User-Agent for Halo Waypoint app requests.
+   */
+  HALO_WAYPOINT: "HaloWaypoint/2021112313511900 CFNetwork/1327.0.4 Darwin/21.2.0",
+  /**
+   * Standard web browser User-Agent.
+   */
+  WEB: "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36"
+};
+var DEFAULT_AUTH_SCOPES = [
+  "Xboxlive.signin",
+  "Xboxlive.offline_access"
+];
+var HEADERS = {
+  /** Spartan token authentication header */
+  SPARTAN_AUTH: "x-343-authorization-spartan",
+  /** Clearance/flight token header */
+  CLEARANCE: "343-clearance",
+  /** Standard Content-Type header */
+  CONTENT_TYPE: "Content-Type",
+  /** Standard Accept header */
+  ACCEPT: "Accept",
+  /** Standard User-Agent header */
+  USER_AGENT: "User-Agent",
+  /** ETag header for caching */
+  ETAG: "ETag",
+  /** If-None-Match header for conditional requests */
+  IF_NONE_MATCH: "If-None-Match"
+};
+var DEFAULT_TIMEOUT_MS = 3e4;
+var DEFAULT_CACHE_TTL_MS = 60 * 60 * 1e3;
+var DEFAULT_MAX_RETRIES = 3;
+
+// src/clients/base/client-base.ts
+var ClientBase = class {
+  /**
+   * Fetch function used for HTTP requests.
+   * Can be overridden for testing or custom environments.
+   */
+  fetchFn;
+  /**
+   * Cache manager for ETag-based response caching.
+   */
+  cache;
+  /**
+   * Retry policy for handling transient failures.
+   */
+  retryPolicy;
+  /**
+   * Spartan token for API authentication.
+   * Obtained through Xbox Live XSTS token exchange.
+   */
+  spartanToken = "";
+  /**
+   * Xbox User ID in numeric format.
+   * Used for player-specific API requests.
+   */
+  xuid = "";
+  /**
+   * Clearance/flight token for accessing flighted content.
+   */
+  clearanceToken = "";
+  /**
+   * Whether to include raw request/response data in results.
+   * Useful for debugging but adds overhead.
+   */
+  includeRawResponses = false;
+  /**
+   * Custom User-Agent header value.
+   */
+  userAgent = "";
+  /**
+   * Creates a new ClientBase instance.
+   *
+   * @param options - Configuration options
+   */
+  constructor(options) {
+    this.fetchFn = options?.fetchFn ?? globalThis.fetch.bind(globalThis);
+    this.cache = new CacheManager(options?.cacheTtlMs ?? DEFAULT_CACHE_TTL_MS);
+    this.retryPolicy = new RetryPolicy({
+      maxRetries: options?.maxRetries ?? DEFAULT_MAX_RETRIES
+    });
+  }
+  /**
+   * Execute an API request with caching, retry, and response handling.
+   *
+   * This is the core method that all module methods call. It handles:
+   * - Building the request with appropriate headers
+   * - ETag-based caching and 304 Not Modified responses
+   * - Retry logic for transient failures
+   * - Response deserialization
+   * - Raw response capture (when enabled)
+   *
+   * @template T - Expected response data type
+   * @param endpoint - Full URL for the request
+   * @param method - HTTP method to use
+   * @param options - Request configuration options
+   * @returns Promise resolving to the API result
+   */
+  async executeRequest(endpoint, method, options = {}) {
+    const result = {
+      result: null,
+      response: { code: 0 }
+    };
+    const headers = this.buildHeaders(options);
+    const requestInit = {
+      method,
+      headers
+    };
+    if (options.body) {
+      requestInit.body = options.body;
+    }
+    if (this.includeRawResponses) {
+      result.response.requestUrl = endpoint;
+      result.response.requestMethod = method;
+      result.response.requestHeaders = Object.fromEntries(headers.entries());
+      if (typeof options.body === "string") {
+        result.response.requestBody = options.body;
+      }
+    }
+    try {
+      const cacheKey = method === "GET" ? endpoint : null;
+      const cached = cacheKey ? this.cache.get(cacheKey) : null;
+      if (cached?.etag) {
+        headers.set(HEADERS.IF_NONE_MATCH, cached.etag);
+      }
+      const response = await this.retryPolicy.execute(async () => {
+        return this.fetchFn(endpoint, requestInit);
+      });
+      result.response.code = response.status;
+      if (this.includeRawResponses) {
+        result.response.responseHeaders = Object.fromEntries(
+          response.headers.entries()
+        );
+      }
+      if (response.status === 304 && cached) {
+        result.result = this.deserializeResponse(cached.content);
+        result.response.message = "304 Not Modified - using cached response";
+        return result;
+      }
+      const bodyBuffer = await response.arrayBuffer();
+      const bodyBytes = new Uint8Array(bodyBuffer);
+      if (cacheKey && response.ok) {
+        const etag = response.headers.get(HEADERS.ETAG) ?? void 0;
+        this.cache.set(cacheKey, { etag, content: bodyBytes });
+      }
+      const bodyText = new TextDecoder().decode(bodyBytes);
+      result.response.message = bodyText;
+      if (response.ok || options.enforceSuccess !== false) {
+        result.result = this.deserializeResponse(bodyBytes);
+      }
+    } catch (error) {
+      result.response.code = 0;
+      result.response.message = error instanceof Error ? error.message : String(error);
+    }
+    return result;
+  }
+  /**
+   * Build request headers based on options.
+   */
+  buildHeaders(options) {
+    const headers = new Headers();
+    headers.set(HEADERS.ACCEPT, "application/json");
+    if (options.body !== void 0) {
+      const contentType = getContentTypeHeader(
+        options.contentType ?? ApiContentType.Json
+      );
+      headers.set(HEADERS.CONTENT_TYPE, contentType);
+    }
+    if (options.useSpartanToken !== false && this.spartanToken) {
+      headers.set(HEADERS.SPARTAN_AUTH, this.spartanToken);
+    }
+    if (options.useClearance && this.clearanceToken) {
+      headers.set(HEADERS.CLEARANCE, this.clearanceToken);
+    }
+    if (this.userAgent) {
+      headers.set(HEADERS.USER_AGENT, this.userAgent);
+    }
+    if (options.customHeaders) {
+      for (const [key, value] of Object.entries(options.customHeaders)) {
+        headers.set(key, value);
+      }
+    }
+    return headers;
+  }
+  /**
+   * Deserialize response bytes to the expected type.
+   */
+  deserializeResponse(data) {
+    if (data.length === 0) {
+      return null;
+    }
+    const text = new TextDecoder().decode(data);
+    if (text === "true") {
+      return true;
+    }
+    if (text === "false") {
+      return false;
+    }
+    try {
+      return JSON.parse(text);
+    } catch {
+      return text;
+    }
+  }
+  /**
+   * Clear the response cache.
+   * Useful when you know data has changed.
+   */
+  clearCache() {
+    this.cache.clear();
+  }
+};
+
+// src/endpoints/halo-core-endpoints.ts
+var HALO_CORE_ENDPOINTS = {
+  /**
+   * Base service domain for all Halo Waypoint services.
+   */
+  SERVICE_DOMAIN: "svc.halowaypoint.com",
+  // ─────────────────────────────────────────────────────────────────
+  // Service Origins (prepended to SERVICE_DOMAIN)
+  // ─────────────────────────────────────────────────────────────────
+  /** Game CMS for static content (challenges, items, etc.) */
+  GAME_CMS_ORIGIN: "gamecms-hacs",
+  /** Economy service for stores, inventory, customization */
+  ECONOMY_ORIGIN: "economy",
+  /** UGC authoring service for creating/editing user content */
+  AUTHORING_ORIGIN: "authoring-infiniteugc",
+  /** UGC discovery service for searching user content */
+  DISCOVERY_ORIGIN: "discovery-infiniteugc",
+  /** Lobby service for multiplayer lobbies and presence */
+  LOBBY_ORIGIN: "lobby-hi",
+  /** Settings and configuration service */
+  SETTINGS_ORIGIN: "settings",
+  /** Skill and CSR rating service */
+  SKILL_ORIGIN: "skill",
+  /** Ban processor service */
+  BAN_PROCESSOR_ORIGIN: "banprocessor",
+  /** Stats service for match history and service records */
+  STATS_ORIGIN: "halostats",
+  /** Text moderation service */
+  TEXT_ORIGIN: "text",
+  /** Content service for articles and news */
+  CONTENT_ORIGIN: "content-hacs",
+  // ─────────────────────────────────────────────────────────────────
+  // Authentication Endpoints
+  // ─────────────────────────────────────────────────────────────────
+  /**
+   * Endpoint for obtaining a Spartan token from an XSTS token.
+   */
+  SPARTAN_TOKEN_ENDPOINT: "https://settings.svc.halowaypoint.com/spartan-token",
+  /**
+   * Endpoint for discovering available Halo Infinite API endpoints.
+   * Returns configuration for all available services.
+   */
+  HALO_INFINITE_SETTINGS: "https://settings.svc.halowaypoint.com/settings/hipc/e2a0a7c6-6efe-42af-9283-c2ab73250c48",
+  // ─────────────────────────────────────────────────────────────────
+  // Xbox Live / XSTS Configuration
+  // ─────────────────────────────────────────────────────────────────
+  /**
+   * Relying party URL for XSTS token exchange.
+   * Use this when requesting an XSTS token for Halo Waypoint.
+   */
+  HALO_WAYPOINT_XSTS_RELYING_PARTY: "https://prod.xsts.halowaypoint.com/",
+  // ─────────────────────────────────────────────────────────────────
+  // Blob Storage
+  // ─────────────────────────────────────────────────────────────────
+  /**
+   * Base URL for UGC blob storage (maps, game variants, etc.)
+   */
+  BLOBS_ORIGIN: "blobs-infiniteugc"
+};
+var WAYPOINT_ENDPOINTS = {
+  /**
+   * Base domain for Halo Waypoint web services.
+   */
+  WEB_DOMAIN: "www.halowaypoint.com",
+  /**
+   * API subdomain for Waypoint services.
+   */
+  API_DOMAIN: "api.halowaypoint.com",
+  /**
+   * Profile API origin.
+   */
+  PROFILE_ORIGIN: "profile",
+  /**
+   * Redemption API origin for code redemption.
+   */
+  REDEMPTION_ORIGIN: "redemption"
+};
+function buildServiceUrl(origin, path) {
+  return `https://${origin}.${HALO_CORE_ENDPOINTS.SERVICE_DOMAIN}${path}`;
+}
+
+// src/modules/base/module-base.ts
+var ModuleBase = class {
+  /**
+   * Reference to the parent client for making HTTP requests.
+   */
+  client;
+  /**
+   * Service origin for this module (e.g., 'halostats', 'economy').
+   */
+  origin;
+  /**
+   * Creates a new module instance.
+   *
+   * @param client - Parent client instance
+   * @param origin - Service origin for URL building
+   */
+  constructor(client, origin) {
+    this.client = client;
+    this.origin = origin;
+  }
+  /**
+   * Build a full URL from a relative path using this module's origin.
+   *
+   * @param path - API path starting with /
+   * @returns Full HTTPS URL
+   */
+  buildUrl(path) {
+    return buildServiceUrl(this.origin, path);
+  }
+  /**
+   * Execute a GET request to this module's service.
+   *
+   * @template T - Expected response type
+   * @param path - API path (e.g., '/hi/players/xuid(...)/matches')
+   * @param options - Request options
+   * @returns Promise with the API result
+   */
+  get(path, options = {}) {
+    return this.client.executeRequest(this.buildUrl(path), "GET", {
+      useSpartanToken: options.useSpartanToken ?? true,
+      useClearance: options.useClearance ?? false,
+      customHeaders: options.customHeaders
+    });
+  }
+  /**
+   * Execute a GET request to an absolute URL.
+   *
+   * Used when the URL doesn't follow the standard origin pattern
+   * (e.g., blob storage URLs).
+   *
+   * @template T - Expected response type
+   * @param fullUrl - Complete URL to request
+   * @param options - Request options
+   * @returns Promise with the API result
+   */
+  getFullUrl(fullUrl, options = {}) {
+    return this.client.executeRequest(fullUrl, "GET", {
+      useSpartanToken: options.useSpartanToken ?? true,
+      useClearance: options.useClearance ?? false,
+      customHeaders: options.customHeaders,
+      enforceSuccess: options.enforceSuccess ?? true
+    });
+  }
+  /**
+   * Execute a POST request to this module's service.
+   *
+   * @template T - Expected response type
+   * @param path - API path
+   * @param body - Optional request body as string
+   * @param options - Request options
+   * @returns Promise with the API result
+   */
+  post(path, body, options = {}) {
+    return this.client.executeRequest(this.buildUrl(path), "POST", {
+      useSpartanToken: options.useSpartanToken ?? true,
+      useClearance: options.useClearance ?? false,
+      body,
+      customHeaders: options.customHeaders
+    });
+  }
+  /**
+   * Execute a POST request with a JSON body.
+   *
+   * @template T - Expected response type
+   * @template TBody - Request body type
+   * @param path - API path
+   * @param body - Request body (will be serialized to JSON)
+   * @param options - Request options
+   * @returns Promise with the API result
+   */
+  postJson(path, body, options = {}) {
+    return this.client.executeRequest(this.buildUrl(path), "POST", {
+      useSpartanToken: options.useSpartanToken ?? true,
+      useClearance: options.useClearance ?? false,
+      body: JSON.stringify(body),
+      contentType: options.contentType ?? ApiContentType.Json,
+      customHeaders: options.customHeaders
+    });
+  }
+  /**
+   * Execute a PUT request with a JSON body.
+   *
+   * @template T - Expected response type
+   * @template TBody - Request body type
+   * @param path - API path
+   * @param body - Request body (will be serialized to JSON)
+   * @param options - Request options
+   * @returns Promise with the API result
+   */
+  putJson(path, body, options = {}) {
+    return this.client.executeRequest(this.buildUrl(path), "PUT", {
+      useSpartanToken: options.useSpartanToken ?? true,
+      useClearance: options.useClearance ?? false,
+      body: JSON.stringify(body),
+      customHeaders: options.customHeaders
+    });
+  }
+  /**
+   * Execute a PATCH request with a JSON body.
+   *
+   * @template T - Expected response type
+   * @template TBody - Request body type
+   * @param path - API path
+   * @param body - Request body (will be serialized to JSON)
+   * @param options - Request options
+   * @returns Promise with the API result
+   */
+  patchJson(path, body, options = {}) {
+    return this.client.executeRequest(this.buildUrl(path), "PATCH", {
+      useSpartanToken: options.useSpartanToken ?? true,
+      useClearance: options.useClearance ?? false,
+      body: JSON.stringify(body),
+      customHeaders: options.customHeaders
+    });
+  }
+  /**
+   * Execute a DELETE request.
+   *
+   * @template T - Expected response type
+   * @param path - API path
+   * @param options - Request options
+   * @returns Promise with the API result
+   */
+  delete(path, options = {}) {
+    return this.client.executeRequest(this.buildUrl(path), "DELETE", {
+      useSpartanToken: options.useSpartanToken ?? true,
+      useClearance: options.useClearance ?? false,
+      customHeaders: options.customHeaders
+    });
+  }
+  /**
+   * Validate that a parameter is not null or undefined.
+   *
+   * @param value - Value to check
+   * @param paramName - Parameter name for error message
+   * @throws Error if value is null or undefined
+   */
+  assertNotNull(value, paramName) {
+    if (value == null) {
+      throw new Error(`${paramName} cannot be null or undefined`);
+    }
+  }
+  /**
+   * Validate that a number is within a range.
+   *
+   * @param value - Value to check
+   * @param min - Minimum allowed value (inclusive)
+   * @param max - Maximum allowed value (inclusive)
+   * @param paramName - Parameter name for error message
+   * @throws RangeError if value is out of range
+   */
+  assertRange(value, min, max, paramName) {
+    if (value < min || value > max) {
+      throw new RangeError(`${paramName} must be between ${min} and ${max}`);
+    }
+  }
+  /**
+   * Validate that a string is not empty.
+   *
+   * @param value - Value to check
+   * @param paramName - Parameter name for error message
+   * @throws Error if value is empty
+   */
+  assertNotEmpty(value, paramName) {
+    if (!value || value.trim().length === 0) {
+      throw new Error(`${paramName} cannot be empty`);
+    }
+  }
+};
+
+// src/modules/halo-infinite/academy.module.ts
+var AcademyModule = class extends ModuleBase {
+  constructor(client) {
+    super(client, HALO_CORE_ENDPOINTS.GAME_CMS_ORIGIN);
+  }
+  /**
+   * Get bot customization data.
+   *
+   * @param flightId - Flight/clearance ID
+   * @returns Bot customization options
+   */
+  getBotCustomization(flightId) {
+    const flightParam = flightId ? `?flight=${flightId}` : "";
+    return this.get(`/hi/academy/botcustomization${flightParam}`, {
+      useClearance: !!flightId
+    });
+  }
+  /**
+   * Get academy content manifest.
+   *
+   * @returns Academy client manifest
+   */
+  getContent() {
+    return this.get("/hi/academy/content");
+  }
+  /**
+   * Get test academy content (for flighted builds).
+   *
+   * @param clearanceId - Clearance identifier
+   * @returns Test academy manifest
+   */
+  getContentTest(clearanceId) {
+    this.assertNotEmpty(clearanceId, "clearanceId");
+    return this.get(`/hi/academy/content/test?clearanceId=${clearanceId}`, {
+      useClearance: true
+    });
+  }
+  /**
+   * Get star/scoring definitions for academy drills.
+   *
+   * @returns Star definitions
+   */
+  getStarDefinitions() {
+    return this.get("/hi/Progression/file/academy/stars");
+  }
+};
+
+// src/modules/halo-infinite/ban-processor.module.ts
+var BanProcessorModule = class extends ModuleBase {
+  constructor(client) {
+    super(client, HALO_CORE_ENDPOINTS.BAN_PROCESSOR_ORIGIN);
+  }
+  /**
+   * Get ban summary for a list of players.
+   *
+   * @param targetList - List of player XUIDs to check
+   * @returns Ban summary results
+   */
+  banSummary(targetList) {
+    if (!targetList.length) {
+      throw new Error("targetList cannot be empty");
+    }
+    const playersQuery = targetList.map((id) => `targetXuids=${id}`).join("&");
+    return this.get(`/hi/bans/summary?${playersQuery}`);
+  }
+};
+
+// src/modules/halo-infinite/configuration.module.ts
+var ConfigurationModule = class extends ModuleBase {
+  constructor(client) {
+    super(client, HALO_CORE_ENDPOINTS.SETTINGS_ORIGIN);
+  }
+  /**
+   * Get the API settings/configuration container.
+   *
+   * Returns the list of all available API endpoints and their configurations.
+   *
+   * @returns API configuration
+   */
+  getApiSettingsContainer() {
+    return this.getFullUrl(HALO_CORE_ENDPOINTS.HALO_INFINITE_SETTINGS, {
+      useSpartanToken: false
+    });
+  }
+};
+
+// src/modules/halo-infinite/economy.module.ts
+var EconomyModule = class extends ModuleBase {
+  constructor(client) {
+    super(client, HALO_CORE_ENDPOINTS.ECONOMY_ORIGIN);
+  }
+  // ─────────────────────────────────────────────────────────────────
+  // Inventory & Currency
+  // ─────────────────────────────────────────────────────────────────
+  /**
+   * Get all inventory items for a player.
+   *
+   * @param player - Player's numeric XUID
+   * @returns Player inventory
+   */
+  getInventoryItems(player) {
+    this.assertNotEmpty(player, "player");
+    return this.get(`/hi/players/xuid(${player})/inventory`);
+  }
+  /**
+   * Get virtual currency balances for a player.
+   *
+   * @param player - Player's numeric XUID
+   * @returns Currency balances
+   */
+  getVirtualCurrencyBalances(player) {
+    this.assertNotEmpty(player, "player");
+    return this.get(`/hi/players/xuid(${player})/currencies`);
+  }
+  /**
+   * Post a currency transaction.
+   *
+   * @param player - Player's numeric XUID
+   * @param currencyId - Currency identifier
+   * @returns Transaction result
+   */
+  postCurrencyTransaction(player, currencyId) {
+    this.assertNotEmpty(player, "player");
+    this.assertNotEmpty(currencyId, "currencyId");
+    return this.post(
+      `/hi/players/xuid(${player})/currencies/${currencyId}/transactions`
+    );
+  }
+  // ─────────────────────────────────────────────────────────────────
+  // Customization
+  // ─────────────────────────────────────────────────────────────────
+  /**
+   * Get full player customization data.
+   *
+   * @param player - Player's numeric XUID
+   * @param viewType - View type (e.g., 'public', 'private')
+   * @returns Complete customization data
+   */
+  getPlayerCustomization(player, viewType = "public") {
+    this.assertNotEmpty(player, "player");
+    return this.get(
+      `/hi/players/xuid(${player})/customization?view=${viewType}`
+    );
+  }
+  /**
+   * Get all armor cores for a player.
+   *
+   * @param player - Player's numeric XUID
+   * @returns Armor core collection
+   */
+  armorCoresCustomization(player) {
+    this.assertNotEmpty(player, "player");
+    return this.get(`/hi/players/xuid(${player})/customization/armors`);
+  }
+  /**
+   * Get a specific armor core for a player.
+   *
+   * @param player - Player's numeric XUID
+   * @param coreId - Core identifier
+   * @returns Armor core details
+   */
+  armorCoreCustomization(player, coreId) {
+    this.assertNotEmpty(player, "player");
+    this.assertNotEmpty(coreId, "coreId");
+    return this.get(`/hi/players/xuid(${player})/customization/armors/${coreId}`);
+  }
+  /**
+   * Get all weapon cores for a player.
+   *
+   * @param player - Player's numeric XUID
+   * @returns Weapon core collection
+   */
+  weaponCoresCustomization(player) {
+    this.assertNotEmpty(player, "player");
+    return this.get(`/hi/players/xuid(${player})/customization/weapons`);
+  }
+  /**
+   * Get a specific weapon core for a player.
+   *
+   * @param player - Player's numeric XUID
+   * @param coreId - Core identifier
+   * @returns Weapon core details
+   */
+  weaponCoreCustomization(player, coreId) {
+    this.assertNotEmpty(player, "player");
+    this.assertNotEmpty(coreId, "coreId");
+    return this.get(`/hi/players/xuid(${player})/customization/weapons/${coreId}`);
+  }
+  /**
+   * Get all vehicle cores for a player.
+   *
+   * @param player - Player's numeric XUID
+   * @returns Vehicle core collection
+   */
+  vehicleCoresCustomization(player) {
+    this.assertNotEmpty(player, "player");
+    return this.get(`/hi/players/xuid(${player})/customization/vehicles`);
+  }
+  /**
+   * Get a specific vehicle core for a player.
+   *
+   * @param player - Player's numeric XUID
+   * @param coreId - Core identifier
+   * @returns Vehicle core details
+   */
+  vehicleCoreCustomization(player, coreId) {
+    this.assertNotEmpty(player, "player");
+    this.assertNotEmpty(coreId, "coreId");
+    return this.get(`/hi/players/xuid(${player})/customization/vehicles/${coreId}`);
+  }
+  /**
+   * Get all AI cores for a player.
+   *
+   * @param player - Player's numeric XUID
+   * @returns AI core container
+   */
+  aiCoresCustomization(player) {
+    this.assertNotEmpty(player, "player");
+    return this.get(`/hi/players/xuid(${player})/customization/ais`);
+  }
+  /**
+   * Get a specific AI core for a player.
+   *
+   * @param player - Player's numeric XUID
+   * @param coreId - Core identifier
+   * @returns AI core details
+   */
+  aiCoreCustomization(player, coreId) {
+    this.assertNotEmpty(player, "player");
+    this.assertNotEmpty(coreId, "coreId");
+    return this.get(`/hi/players/xuid(${player})/customization/ais/${coreId}`);
+  }
+  /**
+   * Get Spartan body customization for a player.
+   *
+   * @param player - Player's numeric XUID
+   * @returns Spartan body configuration
+   */
+  spartanBodyCustomization(player) {
+    this.assertNotEmpty(player, "player");
+    return this.get(`/hi/players/xuid(${player})/customization/spartanbody`);
+  }
+  /**
+   * Get appearance customization for a player.
+   *
+   * @param player - Player's numeric XUID
+   * @returns Appearance configuration
+   */
+  playerAppearanceCustomization(player) {
+    this.assertNotEmpty(player, "player");
+    return this.get(
+      `/hi/players/xuid(${player})/customization/appearance`
+    );
+  }
+  // ─────────────────────────────────────────────────────────────────
+  // Stores
+  // ─────────────────────────────────────────────────────────────────
+  /**
+   * Get the main store offerings.
+   *
+   * @param player - Player's numeric XUID
+   * @returns Store items
+   */
+  getMainStore(player) {
+    this.assertNotEmpty(player, "player");
+    return this.get(`/hi/players/xuid(${player})/stores/main`);
+  }
+  /**
+   * Get the HCS (esports) store offerings.
+   *
+   * @param player - Player's numeric XUID
+   * @returns Store items
+   */
+  getHcsStore(player) {
+    this.assertNotEmpty(player, "player");
+    return this.get(`/hi/players/xuid(${player})/stores/hcs`);
+  }
+  /**
+   * Get the boosts store offerings.
+   *
+   * @param player - Player's numeric XUID
+   * @returns Store items
+   */
+  getBoostsStore(player) {
+    this.assertNotEmpty(player, "player");
+    return this.get(`/hi/players/xuid(${player})/stores/boosts`);
+  }
+  /**
+   * Get the soft currency (Spartan Points) store.
+   *
+   * @param player - Player's numeric XUID
+   * @returns Store items
+   */
+  getSoftCurrencyStore(player) {
+    this.assertNotEmpty(player, "player");
+    return this.get(`/hi/players/xuid(${player})/stores/softcurrency`);
+  }
+  /**
+   * Get the customization store offerings.
+   *
+   * @param player - Player's numeric XUID
+   * @returns Store items
+   */
+  getCustomizationStore(player) {
+    this.assertNotEmpty(player, "player");
+    return this.get(`/hi/players/xuid(${player})/stores/customization`);
+  }
+  /**
+   * Get the operations store offerings.
+   *
+   * @param player - Player's numeric XUID
+   * @returns Store items
+   */
+  getOperationsStore(player) {
+    this.assertNotEmpty(player, "player");
+    return this.get(`/hi/players/xuid(${player})/stores/operations`);
+  }
+  /**
+   * Get scheduled storefront offerings.
+   *
+   * @param player - Player's numeric XUID
+   * @param storeId - Store identifier
+   * @returns Scheduled store items
+   */
+  getScheduledStorefrontOfferings(player, storeId) {
+    this.assertNotEmpty(player, "player");
+    this.assertNotEmpty(storeId, "storeId");
+    return this.get(
+      `/hi/players/xuid(${player})/stores/${storeId}/scheduled`
+    );
+  }
+  // ─────────────────────────────────────────────────────────────────
+  // Boosts & Rewards
+  // ─────────────────────────────────────────────────────────────────
+  /**
+   * Get active boosts for a player.
+   *
+   * @param player - Player's numeric XUID
+   * @returns Active boosts container
+   */
+  getActiveBoosts(player) {
+    this.assertNotEmpty(player, "player");
+    return this.get(`/hi/players/xuid(${player})/boosts`);
+  }
+  /**
+   * Get awarded rewards for a player.
+   *
+   * @param player - Player's numeric XUID
+   * @param rewardId - Reward identifier
+   * @returns Reward snapshot
+   */
+  getAwardedRewards(player, rewardId) {
+    this.assertNotEmpty(player, "player");
+    this.assertNotEmpty(rewardId, "rewardId");
+    return this.get(
+      `/hi/players/xuid(${player})/rewards/${rewardId}`
+    );
+  }
+  /**
+   * Get giveaway rewards for a player.
+   *
+   * @param player - Player's numeric XUID
+   * @returns Available giveaways
+   */
+  getGiveawayRewards(player) {
+    this.assertNotEmpty(player, "player");
+    return this.get(`/hi/players/xuid(${player})/giveaways`);
+  }
+  // ─────────────────────────────────────────────────────────────────
+  // Reward Tracks / Operations
+  // ─────────────────────────────────────────────────────────────────
+  /**
+   * Get reward track progress for a player.
+   *
+   * @param player - Player's numeric XUID
+   * @param rewardTrackType - Type of reward track
+   * @param trackId - Track identifier
+   * @returns Reward track details
+   */
+  getRewardTrack(player, rewardTrackType, trackId) {
+    this.assertNotEmpty(player, "player");
+    this.assertNotEmpty(rewardTrackType, "rewardTrackType");
+    this.assertNotEmpty(trackId, "trackId");
+    return this.get(
+      `/hi/players/xuid(${player})/rewardtracks/${rewardTrackType}/${trackId}`
+    );
+  }
+  /**
+   * Get operation progress for a player.
+   *
+   * @param player - Player's numeric XUID
+   * @returns Operation reward track snapshot
+   */
+  getPlayerOperations(player) {
+    this.assertNotEmpty(player, "player");
+    return this.get(
+      `/hi/players/xuid(${player})/operations`,
+      { useClearance: true }
+    );
+  }
+  /**
+   * Get career rank for players.
+   *
+   * @param playerIds - List of player XUIDs
+   * @param careerPathId - Career path identifier
+   * @returns Career rank results
+   */
+  getPlayerCareerRank(playerIds, careerPathId) {
+    if (!playerIds.length) {
+      throw new Error("playerIds cannot be empty");
+    }
+    this.assertNotEmpty(careerPathId, "careerPathId");
+    const playersQuery = playerIds.map((id) => `players=xuid(${id})`).join("&");
+    return this.get(
+      `/hi/careerranks/${careerPathId}?${playersQuery}`
+    );
+  }
+};
+
+// src/modules/halo-infinite/game-cms.module.ts
+var GameCmsModule = class extends ModuleBase {
+  constructor(client) {
+    super(client, HALO_CORE_ENDPOINTS.GAME_CMS_ORIGIN);
+  }
+  // ─────────────────────────────────────────────────────────────────
+  // Items & Inventory
+  // ─────────────────────────────────────────────────────────────────
+  /**
+   * Get an item definition by path.
+   *
+   * @param itemPath - Path to the item
+   * @param flightId - Flight ID for clearance
+   * @returns Item definition
+   */
+  getItem(itemPath, flightId) {
+    this.assertNotEmpty(itemPath, "itemPath");
+    const flightParam = flightId ? `?flight=${flightId}` : "";
+    return this.get(`/hi/Progression/file/${itemPath}${flightParam}`, {
+      useClearance: !!flightId
+    });
+  }
+  /**
+   * Get the customization catalog/inventory definitions.
+   *
+   * @param flightId - Optional flight ID for flighted content
+   * @returns Inventory definition
+   */
+  getCustomizationCatalog(flightId) {
+    const flightParam = flightId ? `?flight=${flightId}` : "";
+    return this.get(`/hi/Progression/file/inventory/catalog${flightParam}`, {
+      useClearance: !!flightId
+    });
+  }
+  /**
+   * Get a store offering definition.
+   *
+   * @param offeringPath - Path to the offering
+   * @returns Store offering
+   */
+  getStoreOffering(offeringPath) {
+    this.assertNotEmpty(offeringPath, "offeringPath");
+    return this.get(`/hi/Progression/file/${offeringPath}`);
+  }
+  /**
+   * Get a currency definition.
+   *
+   * @param currencyPath - Path to the currency
+   * @param flightId - Optional flight ID
+   * @returns Currency definition
+   */
+  getCurrency(currencyPath, flightId) {
+    this.assertNotEmpty(currencyPath, "currencyPath");
+    const flightParam = flightId ? `?flight=${flightId}` : "";
+    return this.get(`/hi/Progression/file/${currencyPath}${flightParam}`);
+  }
+  // ─────────────────────────────────────────────────────────────────
+  // Challenges & Events
+  // ─────────────────────────────────────────────────────────────────
+  /**
+   * Get a challenge definition.
+   *
+   * @param challengePath - Path to the challenge
+   * @param flightId - Optional flight ID
+   * @returns Challenge definition
+   */
+  getChallenge(challengePath, flightId) {
+    this.assertNotEmpty(challengePath, "challengePath");
+    const flightParam = flightId ? `?flight=${flightId}` : "";
+    return this.get(`/hi/Progression/file/${challengePath}${flightParam}`, {
+      useClearance: !!flightId
+    });
+  }
+  /**
+   * Get a challenge deck definition.
+   *
+   * @param challengeDeckPath - Path to the challenge deck
+   * @param flightId - Optional flight ID
+   * @returns Challenge deck definition
+   */
+  getChallengeDeck(challengeDeckPath, flightId) {
+    this.assertNotEmpty(challengeDeckPath, "challengeDeckPath");
+    const flightParam = flightId ? `?flight=${flightId}` : "";
+    return this.get(
+      `/hi/Progression/file/${challengeDeckPath}${flightParam}`,
+      { useClearance: !!flightId }
+    );
+  }
+  /**
+   * Get an event/reward track definition.
+   *
+   * @param eventPath - Path to the event
+   * @param flightId - Optional flight ID
+   * @returns Reward track metadata
+   */
+  getEvent(eventPath, flightId) {
+    this.assertNotEmpty(eventPath, "eventPath");
+    const flightParam = flightId ? `?flight=${flightId}` : "";
+    return this.get(`/hi/Progression/file/${eventPath}${flightParam}`, {
+      useClearance: !!flightId
+    });
+  }
+  // ─────────────────────────────────────────────────────────────────
+  // Career & Seasons
+  // ─────────────────────────────────────────────────────────────────
+  /**
+   * Get career rank definitions.
+   *
+   * @param careerPathId - Career path identifier
+   * @returns Career track container
+   */
+  getCareerRanks(careerPathId) {
+    this.assertNotEmpty(careerPathId, "careerPathId");
+    return this.get(`/hi/Progression/file/careerranks/${careerPathId}`);
+  }
+  /**
+   * Get the season calendar.
+   *
+   * @returns Season calendar
+   */
+  getSeasonCalendar() {
+    return this.get("/hi/Progression/file/calendars/seasons");
+  }
+  /**
+   * Get the CSR/ranked season calendar.
+   *
+   * @returns CSR season calendar
+   */
+  getCsrCalendar() {
+    return this.get("/hi/Progression/file/calendars/csrseasons");
+  }
+  /**
+   * Get a season reward track definition.
+   *
+   * @param seasonPath - Path to the season
+   * @param flightId - Optional flight ID
+   * @returns Season reward track
+   */
+  getSeasonRewardTrack(seasonPath, flightId) {
+    this.assertNotEmpty(seasonPath, "seasonPath");
+    const flightParam = flightId ? `?flight=${flightId}` : "";
+    return this.get(`/hi/Progression/file/${seasonPath}${flightParam}`, {
+      useClearance: !!flightId
+    });
+  }
+  // ─────────────────────────────────────────────────────────────────
+  // Medals & Metadata
+  // ─────────────────────────────────────────────────────────────────
+  /**
+   * Get medal metadata and definitions.
+   *
+   * @returns Medal metadata
+   */
+  getMedalMetadata() {
+    return this.get("/hi/Progression/file/medals/metadata");
+  }
+  /**
+   * Get general game metadata.
+   *
+   * @param flightId - Optional flight ID
+   * @returns Metadata
+   */
+  getMetadata(flightId) {
+    const flightParam = flightId ? `?flight=${flightId}` : "";
+    return this.get(`/hi/Progression/file/metadata${flightParam}`, {
+      useClearance: !!flightId
+    });
+  }
+  // ─────────────────────────────────────────────────────────────────
+  // News & Guides
+  // ─────────────────────────────────────────────────────────────────
+  /**
+   * Get news articles.
+   *
+   * @param filePath - Path to news file
+   * @returns News collection
+   */
+  getNews(filePath) {
+    this.assertNotEmpty(filePath, "filePath");
+    return this.get(`/hi/news/${filePath}`);
+  }
+  /**
+   * Get academy star definitions.
+   *
+   * @returns Star definitions
+   */
+  getAcademyStarDefinitions() {
+    return this.get("/hi/Progression/file/academy/stars");
+  }
+  // ─────────────────────────────────────────────────────────────────
+  // Raw Files & Images
+  // ─────────────────────────────────────────────────────────────────
+  /**
+   * Get an image file from the CMS.
+   *
+   * @param filePath - Path to the image
+   * @returns Image data as bytes
+   */
+  getImage(filePath) {
+    this.assertNotEmpty(filePath, "filePath");
+    return this.get(`/hi/images/file/${filePath}`);
+  }
+  /**
+   * Get a generic file from the CMS.
+   *
+   * @param filePath - Path to the file
+   * @returns File data as bytes
+   */
+  getGenericFile(filePath) {
+    this.assertNotEmpty(filePath, "filePath");
+    return this.get(`/hi/Progression/file/${filePath}`);
+  }
+  /**
+   * Get a raw progression file with custom type.
+   *
+   * @template T - Expected return type
+   * @param filePath - Path to the file
+   * @returns Typed file contents
+   */
+  getProgressionFile(filePath) {
+    this.assertNotEmpty(filePath, "filePath");
+    return this.get(`/hi/Progression/file/${filePath}`);
+  }
+};
+
+// src/modules/halo-infinite/lobby.module.ts
+var LobbyModule = class extends ModuleBase {
+  constructor(client) {
+    super(client, HALO_CORE_ENDPOINTS.LOBBY_ORIGIN);
+  }
+  /**
+   * Get available QoS (Quality of Service) servers.
+   *
+   * @returns List of servers
+   */
+  getQosServers() {
+    return this.get("/hi/qosservers");
+  }
+  /**
+   * Check presence for players in lobbies.
+   *
+   * @param presenceRequest - Presence request container
+   * @returns Presence results
+   */
+  presence(presenceRequest) {
+    return this.postJson(
+      "/hi/presence",
+      presenceRequest
+    );
+  }
+  /**
+   * Get a third-party join handle for a lobby.
+   *
+   * @param lobbyId - Lobby identifier
+   * @param player - Player XUID
+   * @param handleAudience - Handle audience
+   * @param handlePlatform - Handle platform
+   * @returns Join handle
+   */
+  getThirdPartyJoinHandle(lobbyId, player, handleAudience, handlePlatform) {
+    this.assertNotEmpty(lobbyId, "lobbyId");
+    this.assertNotEmpty(player, "player");
+    return this.get(
+      `/hi/lobbies/${lobbyId}/players/xuid(${player})/joinhandle?handleAudience=${handleAudience}&handlePlatform=${handlePlatform}`
+    );
+  }
+  /**
+   * Join a lobby.
+   *
+   * @param lobbyId - Lobby identifier
+   * @param player - Player XUID
+   * @param auth - Auth string
+   * @param lobbyBootstrapPayload - Bootstrap payload
+   * @returns Join response
+   */
+  joinLobby(lobbyId, player, auth, lobbyBootstrapPayload) {
+    this.assertNotEmpty(lobbyId, "lobbyId");
+    this.assertNotEmpty(player, "player");
+    return this.client.executeRequest(
+      this.buildUrl(`/hi/lobbies/${lobbyId}/players/xuid(${player})?auth=${auth}`),
+      "POST",
+      {
+        body: lobbyBootstrapPayload,
+        contentType: "bond"
+      }
+    );
+  }
+};
+
+// src/modules/halo-infinite/settings.module.ts
+var SettingsModule = class extends ModuleBase {
+  constructor(client) {
+    super(client, HALO_CORE_ENDPOINTS.SETTINGS_ORIGIN);
+  }
+  /**
+   * Get the clearance level for the current player.
+   *
+   * Returns feature flags and flight IDs the player has access to.
+   *
+   * @returns Flighted feature flags
+   */
+  getClearanceLevel() {
+    return this.get("/hi/clearance", {
+      useSpartanToken: true
+    });
+  }
+};
+
+// src/modules/halo-infinite/skill.module.ts
+var SkillModule = class extends ModuleBase {
+  constructor(client) {
+    super(client, HALO_CORE_ENDPOINTS.SKILL_ORIGIN);
+  }
+  /**
+   * Get skill/CSR changes for players in a specific match.
+   *
+   * @param matchId - Match ID in GUID format
+   * @param playerIds - List of player XUIDs to query
+   * @returns Skill info for each player
+   */
+  getMatchPlayerResult(matchId, playerIds) {
+    this.assertNotEmpty(matchId, "matchId");
+    if (!playerIds.length) {
+      throw new Error("playerIds cannot be empty");
+    }
+    const playersQuery = playerIds.map((id) => `players=xuid(${id})`).join("&");
+    return this.get(
+      `/hi/matches/${matchId}/skill?${playersQuery}`
+    );
+  }
+  /**
+   * Get current CSR for players in a specific playlist.
+   *
+   * @param playlistId - Playlist ID in GUID format
+   * @param playerIds - List of player XUIDs to query
+   * @param seasonId - Optional season ID for season-specific CSR
+   * @returns CSR results for each player
+   */
+  getPlaylistCsr(playlistId, playerIds, seasonId) {
+    this.assertNotEmpty(playlistId, "playlistId");
+    if (!playerIds.length) {
+      throw new Error("playerIds cannot be empty");
+    }
+    const playersQuery = playerIds.map((id) => `players=xuid(${id})`).join("&");
+    const seasonParam = seasonId ? `&seasonId=${seasonId}` : "";
+    return this.get(
+      `/hi/playlist/${playlistId}/csrs?${playersQuery}${seasonParam}`
+    );
+  }
+};
+
+// src/modules/halo-infinite/stats.module.ts
+var StatsModule = class extends ModuleBase {
+  constructor(client) {
+    super(client, HALO_CORE_ENDPOINTS.STATS_ORIGIN);
+  }
+  /**
+   * Get challenge decks available for a player.
+   *
+   * @param player - Player's numeric XUID
+   * @returns Challenge decks response
+   */
+  getChallengeDecks(player) {
+    this.assertNotEmpty(player, "player");
+    return this.get(`/hi/players/xuid(${player})/decks`);
+  }
+  /**
+   * Get match count summary for a player.
+   *
+   * @param player - Player's numeric XUID
+   * @returns Match count breakdown by type
+   */
+  getMatchCount(player) {
+    this.assertNotEmpty(player, "player");
+    return this.get(`/hi/players/xuid(${player})/matches/count`);
+  }
+  /**
+   * Get match history for a player.
+   *
+   * @param player - Player's numeric XUID
+   * @param start - Starting index for pagination (0-based)
+   * @param count - Number of matches to return (max 25)
+   * @param type - Type of matches to query
+   * @returns Paginated match history
+   */
+  getMatchHistory(player, start, count, type) {
+    this.assertNotEmpty(player, "player");
+    this.assertRange(count, 1, 25, "count");
+    this.assertRange(start, 0, Number.MAX_SAFE_INTEGER, "start");
+    return this.get(
+      `/hi/players/xuid(${player})/matches?start=${start}&count=${count}&type=${type}`
+    );
+  }
+  /**
+   * Get detailed statistics for a specific match.
+   *
+   * @param matchId - Match ID in GUID format
+   * @returns Complete match statistics
+   */
+  getMatchStats(matchId) {
+    this.assertNotEmpty(matchId, "matchId");
+    return this.get(`/hi/matches/${matchId}/stats`);
+  }
+  /**
+   * Get challenge progression for a player in a specific match.
+   *
+   * @param player - Player's numeric XUID
+   * @param matchId - Match ID in GUID format
+   * @returns Match progression details
+   */
+  getPlayerMatchProgression(player, matchId) {
+    this.assertNotEmpty(player, "player");
+    this.assertNotEmpty(matchId, "matchId");
+    return this.get(
+      `/hi/players/xuid(${player})/matches/${matchId}/progression`
+    );
+  }
+  /**
+   * Get match privacy settings for a player.
+   *
+   * @param player - Player's numeric XUID
+   * @returns Privacy settings
+   */
+  getMatchPrivacy(player) {
+    this.assertNotEmpty(player, "player");
+    return this.get(`/hi/players/xuid(${player})/matches-privacy`);
+  }
+  /**
+   * Get service record for a player by XUID.
+   *
+   * The service record contains aggregate career statistics.
+   *
+   * @param xuid - Player's numeric XUID
+   * @param mode - Lifecycle mode (matchmade, custom, local)
+   * @param seasonId - Optional season ID for season-specific stats
+   * @returns Player service record
+   */
+  getPlayerServiceRecordByXuid(xuid, mode, seasonId) {
+    this.assertNotEmpty(xuid, "xuid");
+    const seasonParam = seasonId ? `?seasonId=${seasonId}` : "";
+    return this.get(
+      `/hi/players/xuid(${xuid})/${mode}/servicerecord${seasonParam}`
+    );
+  }
+  /**
+   * Get service record for a player by gamertag.
+   *
+   * @param gamertag - Player's gamertag
+   * @param mode - Lifecycle mode (matchmade, custom, local)
+   * @param seasonId - Optional season ID for season-specific stats
+   * @returns Player service record
+   */
+  getPlayerServiceRecordByGamertag(gamertag, mode, seasonId) {
+    this.assertNotEmpty(gamertag, "gamertag");
+    const encodedGamertag = encodeURIComponent(gamertag);
+    const seasonParam = seasonId ? `?seasonId=${seasonId}` : "";
+    return this.get(
+      `/hi/players/${encodedGamertag}/${mode}/servicerecord${seasonParam}`
+    );
+  }
+  /**
+   * Get daily custom game XP for a player.
+   *
+   * @param player - Player's numeric XUID
+   * @returns Daily custom experience info
+   */
+  getPlayerDailyCustomExperience(player) {
+    this.assertNotEmpty(player, "player");
+    return this.get(
+      `/hi/players/xuid(${player})/customexperience`
+    );
+  }
+};
+
+// src/modules/halo-infinite/text-moderation.module.ts
+var TextModerationModule = class extends ModuleBase {
+  constructor(client) {
+    super(client, HALO_CORE_ENDPOINTS.TEXT_ORIGIN);
+  }
+  /**
+   * Get a moderation key for text validation.
+   *
+   * @returns Moderation key
+   */
+  getModerationKey() {
+    return this.get("/hi/moderation/key");
+  }
+};
+
+// src/modules/halo-infinite/ugc.module.ts
+var UgcModule = class extends ModuleBase {
+  constructor(client) {
+    super(client, HALO_CORE_ENDPOINTS.AUTHORING_ORIGIN);
+  }
+  // ─────────────────────────────────────────────────────────────────
+  // Asset Retrieval
+  // ─────────────────────────────────────────────────────────────────
+  /**
+   * Get an asset by ID.
+   *
+   * @param title - Game title (e.g., 'hi' for Halo Infinite)
+   * @param assetType - Type of asset
+   * @param assetId - Asset GUID
+   * @returns Asset details
+   */
+  getAsset(title, assetType, assetId) {
+    this.assertNotEmpty(title, "title");
+    this.assertNotEmpty(assetId, "assetId");
+    return this.get(`/${title}/${assetType}/${assetId}`);
+  }
+  /**
+   * Get the latest version of an asset.
+   *
+   * @param title - Game title
+   * @param assetType - Type of asset
+   * @param assetId - Asset GUID
+   * @returns Latest asset version
+   */
+  getLatestAssetVersion(title, assetType, assetId) {
+    this.assertNotEmpty(title, "title");
+    this.assertNotEmpty(assetId, "assetId");
+    return this.get(`/${title}/${assetType}/${assetId}/versions/latest`);
+  }
+  /**
+   * Get a specific version of an asset.
+   *
+   * @param title - Game title
+   * @param assetType - Type of asset
+   * @param assetId - Asset GUID
+   * @param versionId - Version GUID
+   * @returns Asset version
+   */
+  getSpecificAssetVersion(title, assetType, assetId, versionId) {
+    this.assertNotEmpty(title, "title");
+    this.assertNotEmpty(assetId, "assetId");
+    this.assertNotEmpty(versionId, "versionId");
+    return this.get(
+      `/${title}/${assetType}/${assetId}/versions/${versionId}`
+    );
+  }
+  /**
+   * Get the published version of an asset.
+   *
+   * @param title - Game title
+   * @param assetType - Type of asset
+   * @param assetId - Asset GUID
+   * @returns Published asset version
+   */
+  getPublishedVersion(title, assetType, assetId) {
+    this.assertNotEmpty(title, "title");
+    this.assertNotEmpty(assetId, "assetId");
+    return this.get(`/${title}/${assetType}/${assetId}/versions/published`);
+  }
+  /**
+   * List all versions of an asset.
+   *
+   * @param title - Game title
+   * @param assetType - Type of asset
+   * @param assetId - Asset GUID
+   * @returns All asset versions
+   */
+  listAllVersions(title, assetType, assetId) {
+    this.assertNotEmpty(title, "title");
+    this.assertNotEmpty(assetId, "assetId");
+    return this.get(`/${title}/${assetType}/${assetId}/versions`);
+  }
+  /**
+   * List assets created by a player.
+   *
+   * @param title - Game title
+   * @param player - Player XUID
+   * @param assetType - Type of asset
+   * @param start - Starting offset
+   * @param count - Number of results
+   * @returns Player's assets
+   */
+  listPlayerAssets(title, player, assetType, start = 0, count = 25) {
+    this.assertNotEmpty(title, "title");
+    this.assertNotEmpty(player, "player");
+    return this.get(
+      `/${title}/players/xuid(${player})/${assetType}?start=${start}&count=${count}`
+    );
+  }
+  // ─────────────────────────────────────────────────────────────────
+  // Favorites
+  // ─────────────────────────────────────────────────────────────────
+  /**
+   * Favorite an asset.
+   *
+   * @param player - Player XUID
+   * @param assetType - Type of asset
+   * @param assetId - Asset GUID
+   * @returns Favorite result
+   */
+  favoriteAnAsset(player, assetType, assetId) {
+    this.assertNotEmpty(player, "player");
+    this.assertNotEmpty(assetId, "assetId");
+    return this.postJson(
+      `/hi/players/xuid(${player})/favorites`,
+      { assetId, assetKind: assetType }
+    );
+  }
+  /**
+   * Check if a player has bookmarked an asset.
+   *
+   * @param title - Game title
+   * @param player - Player XUID
+   * @param assetType - Type of asset
+   * @param assetId - Asset GUID
+   * @returns Favorite status
+   */
+  checkAssetPlayerBookmark(title, player, assetType, assetId) {
+    this.assertNotEmpty(title, "title");
+    this.assertNotEmpty(player, "player");
+    this.assertNotEmpty(assetId, "assetId");
+    return this.get(
+      `/${title}/players/xuid(${player})/favorites/${assetType}/${assetId}`
+    );
+  }
+  /**
+   * List player's favorite assets of a specific type.
+   *
+   * @param player - Player XUID
+   * @param assetType - Type of asset
+   * @returns Favorites container
+   */
+  listPlayerFavorites(player, assetType) {
+    this.assertNotEmpty(player, "player");
+    return this.get(
+      `/hi/players/xuid(${player})/favorites/${assetType}`
+    );
+  }
+  /**
+   * List all of a player's favorite assets.
+   *
+   * @param player - Player XUID
+   * @returns All favorites
+   */
+  listPlayerFavoritesAgnostic(player) {
+    this.assertNotEmpty(player, "player");
+    return this.get(`/hi/players/xuid(${player})/favorites`);
+  }
+  // ─────────────────────────────────────────────────────────────────
+  // Ratings & Reports
+  // ─────────────────────────────────────────────────────────────────
+  /**
+   * Get a player's rating for an asset.
+   *
+   * @param player - Player XUID
+   * @param assetType - Type of asset
+   * @param assetId - Asset GUID
+   * @returns Rating info
+   */
+  getAssetRatings(player, assetType, assetId) {
+    this.assertNotEmpty(player, "player");
+    this.assertNotEmpty(assetId, "assetId");
+    return this.get(
+      `/hi/players/xuid(${player})/ratings/${assetType}/${assetId}`
+    );
+  }
+  /**
+   * Rate an asset.
+   *
+   * @param player - Player XUID
+   * @param assetType - Type of asset
+   * @param assetId - Asset GUID
+   * @param rating - Rating to submit
+   * @returns Updated rating
+   */
+  rateAnAsset(player, assetType, assetId, rating) {
+    this.assertNotEmpty(player, "player");
+    this.assertNotEmpty(assetId, "assetId");
+    return this.putJson(
+      `/hi/players/xuid(${player})/ratings/${assetType}/${assetId}`,
+      rating
+    );
+  }
+  /**
+   * Report an asset for moderation.
+   *
+   * @param player - Player XUID
+   * @param assetType - Type of asset
+   * @param assetId - Asset GUID
+   * @param report - Report details
+   * @returns Report result
+   */
+  reportAnAsset(player, assetType, assetId, report) {
+    this.assertNotEmpty(player, "player");
+    this.assertNotEmpty(assetId, "assetId");
+    return this.postJson(
+      `/hi/players/xuid(${player})/reports/${assetType}/${assetId}`,
+      report
+    );
+  }
+  // ─────────────────────────────────────────────────────────────────
+  // Asset Management
+  // ─────────────────────────────────────────────────────────────────
+  /**
+   * Delete an asset and all its versions.
+   *
+   * @param title - Game title
+   * @param assetType - Type of asset
+   * @param assetId - Asset GUID
+   * @returns Success status
+   */
+  deleteAllVersions(title, assetType, assetId) {
+    this.assertNotEmpty(title, "title");
+    this.assertNotEmpty(assetId, "assetId");
+    return this.delete(`/${title}/${assetType}/${assetId}`);
+  }
+  /**
+   * Delete a specific version of an asset.
+   *
+   * @param title - Game title
+   * @param assetType - Type of asset
+   * @param assetId - Asset GUID
+   * @param versionId - Version GUID
+   * @returns Success status
+   */
+  deleteVersion(title, assetType, assetId, versionId) {
+    this.assertNotEmpty(title, "title");
+    this.assertNotEmpty(assetId, "assetId");
+    this.assertNotEmpty(versionId, "versionId");
+    return this.delete(`/${title}/${assetType}/${assetId}/versions/${versionId}`);
+  }
+  /**
+   * Publish an asset version.
+   *
+   * @param assetType - Type of asset
+   * @param assetId - Asset GUID
+   * @param versionId - Version GUID
+   * @param clearanceId - Clearance ID
+   * @returns Success status
+   */
+  publishAssetVersion(assetType, assetId, versionId, clearanceId) {
+    this.assertNotEmpty(assetId, "assetId");
+    this.assertNotEmpty(versionId, "versionId");
+    return this.post(
+      `/hi/${assetType}/${assetId}/versions/${versionId}/publish?clearanceId=${clearanceId}`
+    );
+  }
+  /**
+   * Unpublish an asset.
+   *
+   * @param assetType - Type of asset
+   * @param assetId - Asset GUID
+   * @returns Success status
+   */
+  unpublishAsset(assetType, assetId) {
+    this.assertNotEmpty(assetId, "assetId");
+    return this.post(`/hi/${assetType}/${assetId}/unpublish`);
+  }
+  // ─────────────────────────────────────────────────────────────────
+  // Permissions
+  // ─────────────────────────────────────────────────────────────────
+  /**
+   * Grant or revoke permissions for an asset.
+   *
+   * @param title - Game title
+   * @param assetType - Type of asset
+   * @param assetId - Asset GUID
+   * @param player - Player XUID to grant/revoke
+   * @param permission - Permission details
+   * @returns Updated permission
+   */
+  grantOrRevokePermissions(title, assetType, assetId, player, permission) {
+    this.assertNotEmpty(title, "title");
+    this.assertNotEmpty(assetId, "assetId");
+    this.assertNotEmpty(player, "player");
+    return this.putJson(
+      `/${title}/${assetType}/${assetId}/permissions/xuid(${player})`,
+      permission
+    );
+  }
+  // ─────────────────────────────────────────────────────────────────
+  // Sessions
+  // ─────────────────────────────────────────────────────────────────
+  /**
+   * Start an authoring session for an asset.
+   *
+   * @param title - Game title
+   * @param assetType - Type of asset
+   * @param assetId - Asset GUID
+   * @param includeContainerSas - Include container SAS URL
+   * @returns Session details
+   */
+  startSession(title, assetType, assetId, includeContainerSas = false) {
+    this.assertNotEmpty(title, "title");
+    this.assertNotEmpty(assetId, "assetId");
+    return this.post(
+      `/${title}/${assetType}/${assetId}/sessions?includeContainerSas=${includeContainerSas}`
+    );
+  }
+  /**
+   * Extend an authoring session.
+   *
+   * @param title - Game title
+   * @param assetType - Type of asset
+   * @param assetId - Asset GUID
+   * @param includeContainerSas - Include container SAS URL
+   * @returns Extended session
+   */
+  extendSession(title, assetType, assetId, includeContainerSas = false) {
+    this.assertNotEmpty(title, "title");
+    this.assertNotEmpty(assetId, "assetId");
+    return this.putJson(
+      `/${title}/${assetType}/${assetId}/sessions?includeContainerSas=${includeContainerSas}`,
+      {}
+    );
+  }
+  /**
+   * End an authoring session.
+   *
+   * @param title - Game title
+   * @param assetType - Type of asset
+   * @param assetId - Asset GUID
+   * @returns Success status
+   */
+  endSession(title, assetType, assetId) {
+    this.assertNotEmpty(title, "title");
+    this.assertNotEmpty(assetId, "assetId");
+    return this.delete(`/${title}/${assetType}/${assetId}/sessions`);
+  }
+  /**
+   * Create a new asset version.
+   *
+   * @param title - Game title
+   * @param assetType - Type of asset
+   * @param assetId - Asset GUID
+   * @param starter - Source asset to clone from
+   * @returns New asset version
+   */
+  createAssetVersion(title, assetType, assetId, starter) {
+    this.assertNotEmpty(title, "title");
+    this.assertNotEmpty(assetId, "assetId");
+    return this.postJson(
+      `/${title}/${assetType}/${assetId}/versions`,
+      starter
+    );
+  }
+  /**
+   * Patch an asset version.
+   *
+   * @param title - Game title
+   * @param assetType - Type of asset
+   * @param assetId - Asset GUID
+   * @param versionId - Version GUID
+   * @param patchedAsset - Updated asset data
+   * @returns Updated asset version
+   */
+  patchAssetVersion(title, assetType, assetId, versionId, patchedAsset) {
+    this.assertNotEmpty(title, "title");
+    this.assertNotEmpty(assetId, "assetId");
+    this.assertNotEmpty(versionId, "versionId");
+    return this.patchJson(
+      `/${title}/${assetType}/${assetId}/versions/${versionId}`,
+      patchedAsset
+    );
+  }
+  // ─────────────────────────────────────────────────────────────────
+  // Blob Storage
+  // ─────────────────────────────────────────────────────────────────
+  /**
+   * Get a blob from UGC storage.
+   *
+   * @param blobPath - Path to the blob
+   * @returns Blob data as bytes
+   */
+  getBlob(blobPath) {
+    this.assertNotEmpty(blobPath, "blobPath");
+    const blobUrl = `https://${HALO_CORE_ENDPOINTS.BLOBS_ORIGIN}.${HALO_CORE_ENDPOINTS.SERVICE_DOMAIN}${blobPath}`;
+    return this.getFullUrl(blobUrl, { useSpartanToken: false });
+  }
+};
+
+// src/modules/halo-infinite/ugc-discovery.module.ts
+var UgcDiscoveryModule = class extends ModuleBase {
+  constructor(client) {
+    super(client, HALO_CORE_ENDPOINTS.DISCOVERY_ORIGIN);
+  }
+  /**
+   * Search for user-generated content.
+   *
+   * @param params - Search parameters
+   * @returns Search results
+   */
+  search(params) {
+    const queryParts = [];
+    if (params.term) {
+      queryParts.push(`term=${encodeURIComponent(params.term)}`);
+    }
+    if (params.assetKinds?.length) {
+      params.assetKinds.forEach((kind) => {
+        queryParts.push(`assetKind=${kind}`);
+      });
+    }
+    if (params.tags?.length) {
+      params.tags.forEach((tag) => {
+        queryParts.push(`tags=${encodeURIComponent(tag)}`);
+      });
+    }
+    if (params.author) {
+      queryParts.push(`author=xuid(${params.author})`);
+    }
+    if (params.sort) {
+      queryParts.push(`sort=${params.sort}`);
+    }
+    if (params.order) {
+      queryParts.push(`order=${params.order}`);
+    }
+    if (params.count !== void 0) {
+      queryParts.push(`count=${params.count}`);
+    }
+    if (params.start !== void 0) {
+      queryParts.push(`start=${params.start}`);
+    }
+    const queryString = queryParts.length > 0 ? `?${queryParts.join("&")}` : "";
+    return this.get(`/hi/search${queryString}`);
+  }
+  /**
+   * Get featured content of a specific type.
+   *
+   * @param assetKind - Type of asset
+   * @returns Featured assets
+   */
+  getFeatured(assetKind) {
+    return this.get(`/hi/featured/${assetKind}`);
+  }
+  /**
+   * Get popular content of a specific type.
+   *
+   * @param assetKind - Type of asset
+   * @param start - Starting offset
+   * @param count - Number of results
+   * @returns Popular assets
+   */
+  getPopular(assetKind, start = 0, count = 25) {
+    return this.get(
+      `/hi/popular/${assetKind}?start=${start}&count=${count}`
+    );
+  }
+  /**
+   * Get recent content of a specific type.
+   *
+   * @param assetKind - Type of asset
+   * @param start - Starting offset
+   * @param count - Number of results
+   * @returns Recent assets
+   */
+  getRecent(assetKind, start = 0, count = 25) {
+    return this.get(
+      `/hi/recent/${assetKind}?start=${start}&count=${count}`
+    );
+  }
+  /**
+   * Get recommended content for a player.
+   *
+   * @param player - Player XUID
+   * @param assetKind - Type of asset
+   * @param count - Number of results
+   * @returns Recommended assets
+   */
+  getRecommended(player, assetKind, count = 10) {
+    this.assertNotEmpty(player, "player");
+    return this.get(
+      `/hi/players/xuid(${player})/recommendations/${assetKind}?count=${count}`
+    );
+  }
+  /**
+   * Browse content by tag.
+   *
+   * @param assetKind - Type of asset
+   * @param tag - Tag to filter by
+   * @param start - Starting offset
+   * @param count - Number of results
+   * @returns Tagged assets
+   */
+  browseByTag(assetKind, tag, start = 0, count = 25) {
+    this.assertNotEmpty(tag, "tag");
+    return this.get(
+      `/hi/tags/${encodeURIComponent(tag)}/${assetKind}?start=${start}&count=${count}`
+    );
+  }
+  /**
+   * Get asset details for discovery purposes.
+   *
+   * @param assetKind - Type of asset
+   * @param assetId - Asset GUID
+   * @returns Asset details
+   */
+  getAssetDetails(assetKind, assetId) {
+    this.assertNotEmpty(assetId, "assetId");
+    return this.get(`/hi/${assetKind}/${assetId}`);
+  }
+  /**
+   * Get film asset for a match.
+   *
+   * @param matchId - Match GUID
+   * @returns Film asset if available
+   */
+  getFilmByMatchId(matchId) {
+    this.assertNotEmpty(matchId, "matchId");
+    return this.get(`/hi/films/matches/${matchId}`);
+  }
+};
+
+// src/clients/halo-infinite-client.ts
+var HaloInfiniteClient = class extends ClientBase {
+  // Lazy-loaded module instances
+  _academy;
+  _banProcessor;
+  _configuration;
+  _economy;
+  _gameCms;
+  _lobby;
+  _settings;
+  _skill;
+  _stats;
+  _textModeration;
+  _ugc;
+  _ugcDiscovery;
+  /**
+   * Creates a new HaloInfiniteClient instance.
+   *
+   * @param options - Client configuration options
+   *
+   * @example
+   * ```typescript
+   * const client = new HaloInfiniteClient({
+   *   spartanToken: 'your-spartan-token',
+   *   xuid: '2533274855333605',
+   *   includeRawResponses: true, // Enable for debugging
+   * });
+   * ```
+   */
+  constructor(options) {
+    super({
+      fetchFn: options.fetchFn,
+      cacheTtlMs: options.cacheTtlMs,
+      maxRetries: options.maxRetries
+    });
+    this.spartanToken = options.spartanToken;
+    this.xuid = options.xuid ?? "";
+    this.clearanceToken = options.clearanceToken ?? "";
+    this.includeRawResponses = options.includeRawResponses ?? false;
+    this.userAgent = options.userAgent ?? "";
+  }
+  /**
+   * Academy module for bot customization and drill-related APIs.
+   *
+   * Provides access to:
+   * - Bot customization options
+   * - Academy content manifest
+   * - Star/scoring definitions for drills
+   */
+  get academy() {
+    return this._academy ??= new AcademyModule(this);
+  }
+  /**
+   * Ban Processor module for ban-related APIs.
+   *
+   * Provides access to:
+   * - Ban summary queries for players
+   */
+  get banProcessor() {
+    return this._banProcessor ??= new BanProcessorModule(this);
+  }
+  /**
+   * Configuration module for endpoint discovery APIs.
+   *
+   * Provides access to:
+   * - API settings and endpoint configuration
+   */
+  get configuration() {
+    return this._configuration ??= new ConfigurationModule(this);
+  }
+  /**
+   * Economy module for player customization, stores, and inventory APIs.
+   *
+   * Provides access to:
+   * - Player inventory and currency balances
+   * - Customization (armor, weapons, vehicles, AI)
+   * - In-game stores and offerings
+   * - Active boosts and rewards
+   * - Operation/battle pass progress
+   */
+  get economy() {
+    return this._economy ??= new EconomyModule(this);
+  }
+  /**
+   * Game CMS module for static content and definitions.
+   *
+   * Provides access to:
+   * - Item definitions
+   * - Challenge definitions
+   * - Season and career metadata
+   * - Medal information
+   * - News and guides
+   */
+  get gameCms() {
+    return this._gameCms ??= new GameCmsModule(this);
+  }
+  /**
+   * Lobby module for multiplayer lobby and presence APIs.
+   *
+   * Provides access to:
+   * - QoS servers
+   * - Player presence in lobbies
+   * - Join handles and lobby joining
+   */
+  get lobby() {
+    return this._lobby ??= new LobbyModule(this);
+  }
+  /**
+   * Settings module for clearance and flight configuration APIs.
+   *
+   * Provides access to:
+   * - Clearance levels and feature flags
+   */
+  get settings() {
+    return this._settings ??= new SettingsModule(this);
+  }
+  /**
+   * Skill module for CSR (Competitive Skill Rank) APIs.
+   *
+   * Provides access to:
+   * - Match skill results (CSR changes after a match)
+   * - Playlist CSR for players
+   */
+  get skill() {
+    return this._skill ??= new SkillModule(this);
+  }
+  /**
+   * Stats module for match history and service record APIs.
+   *
+   * Provides access to:
+   * - Match history for players
+   * - Individual match statistics
+   * - Player service records (career stats)
+   * - Challenge decks and progression
+   */
+  get stats() {
+    return this._stats ??= new StatsModule(this);
+  }
+  /**
+   * Text Moderation module for moderation-related APIs.
+   *
+   * Provides access to:
+   * - Moderation keys for text validation
+   */
+  get textModeration() {
+    return this._textModeration ??= new TextModerationModule(this);
+  }
+  /**
+   * UGC (User Generated Content) module for authoring operations.
+   *
+   * Provides access to:
+   * - Creating, editing, and deleting user content
+   * - Managing asset permissions
+   * - Rating and favoriting assets
+   * - Publishing and unpublishing assets
+   */
+  get ugc() {
+    return this._ugc ??= new UgcModule(this);
+  }
+  /**
+   * UGC Discovery module for searching and browsing user content.
+   *
+   * Provides access to:
+   * - Searching for maps, game variants, and other content
+   * - Browsing featured and popular content
+   * - Getting recommended content
+   */
+  get ugcDiscovery() {
+    return this._ugcDiscovery ??= new UgcDiscoveryModule(this);
+  }
+};
+
+// src/modules/base/waypoint-module-base.ts
+var WaypointModuleBase = class {
+  /**
+   * Reference to the parent client for making HTTP requests.
+   */
+  client;
+  /**
+   * Creates a new Waypoint module instance.
+   *
+   * @param client - Parent client instance
+   */
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * Build a Waypoint API URL.
+   *
+   * @param path - API path starting with /
+   * @returns Full HTTPS URL
+   */
+  buildUrl(path) {
+    return `https://${WAYPOINT_ENDPOINTS.API_DOMAIN}${path}`;
+  }
+  /**
+   * Build a Waypoint web URL.
+   *
+   * @param path - Path starting with /
+   * @returns Full HTTPS URL
+   */
+  buildWebUrl(path) {
+    return `https://${WAYPOINT_ENDPOINTS.WEB_DOMAIN}${path}`;
+  }
+  /**
+   * Execute a GET request to the Waypoint API.
+   */
+  get(path, options = {}) {
+    return this.client.executeRequest(this.buildUrl(path), "GET", {
+      useSpartanToken: options.useSpartanToken ?? true,
+      customHeaders: options.customHeaders
+    });
+  }
+  /**
+   * Execute a POST request to the Waypoint API.
+   */
+  post(path, body, options = {}) {
+    return this.client.executeRequest(this.buildUrl(path), "POST", {
+      useSpartanToken: options.useSpartanToken ?? true,
+      body,
+      customHeaders: options.customHeaders
+    });
+  }
+  /**
+   * Execute a POST request with a JSON body.
+   */
+  postJson(path, body, options = {}) {
+    return this.client.executeRequest(this.buildUrl(path), "POST", {
+      useSpartanToken: options.useSpartanToken ?? true,
+      body: JSON.stringify(body),
+      customHeaders: options.customHeaders
+    });
+  }
+  /**
+   * Execute a PUT request with a JSON body.
+   */
+  putJson(path, body, options = {}) {
+    return this.client.executeRequest(this.buildUrl(path), "PUT", {
+      useSpartanToken: options.useSpartanToken ?? true,
+      body: JSON.stringify(body),
+      customHeaders: options.customHeaders
+    });
+  }
+  /**
+   * Validate that a parameter is not null or undefined.
+   */
+  assertNotNull(value, paramName) {
+    if (value == null) {
+      throw new Error(`${paramName} cannot be null or undefined`);
+    }
+  }
+  /**
+   * Validate that a string is not empty.
+   */
+  assertNotEmpty(value, paramName) {
+    if (!value || value.trim().length === 0) {
+      throw new Error(`${paramName} cannot be empty`);
+    }
+  }
+};
+
+// src/modules/waypoint/profile.module.ts
+var ProfileModule = class extends WaypointModuleBase {
+  constructor(client) {
+    super(client);
+  }
+  /**
+   * Get the current user's settings.
+   *
+   * @returns User settings
+   */
+  getUserSettings() {
+    return this.get("/hi/users/me/settings");
+  }
+  /**
+   * Get the current user's profile.
+   *
+   * @returns User profile
+   */
+  getMyProfile() {
+    return this.get("/hi/users/me");
+  }
+  /**
+   * Get a user's profile by XUID or gamertag.
+   *
+   * @param userId - XUID or gamertag
+   * @param isXuid - Whether userId is an XUID (true) or gamertag (false)
+   * @returns User profile
+   */
+  getUserProfile(userId, isXuid = false) {
+    this.assertNotEmpty(userId, "userId");
+    const identifier = isXuid ? `xuid(${userId})` : encodeURIComponent(userId);
+    return this.get(`/hi/users/${identifier}`);
+  }
+  /**
+   * Get service awards for the current user.
+   *
+   * @returns Service award snapshot
+   */
+  getServiceAwards() {
+    return this.get("/hi/users/me/serviceawards");
+  }
+  /**
+   * Update featured service awards for the current user.
+   *
+   * @param awards - Awards to feature
+   * @returns Updated awards
+   */
+  putFeaturedServiceAwards(awards) {
+    return this.putJson(
+      "/hi/users/me/serviceawards/featured",
+      awards
+    );
+  }
+};
+
+// src/modules/waypoint/redemption.module.ts
+var RedemptionModule = class extends WaypointModuleBase {
+  constructor(client) {
+    super(client);
+  }
+  /**
+   * Redeem a promotional code.
+   *
+   * @param code - The code to redeem
+   * @returns Redemption result
+   */
+  redeemCode(code) {
+    this.assertNotEmpty(code, "code");
+    return this.postJson(
+      "/hi/redemption/code",
+      { code }
+    );
+  }
+};
+
+// src/modules/waypoint/content.module.ts
+var ContentModule = class extends WaypointModuleBase {
+  constructor(client) {
+    super(client);
+  }
+  /**
+   * Get articles from Halo Waypoint.
+   *
+   * @param page - Page number (1-based)
+   * @param perPage - Articles per page
+   * @param category - Optional category filter
+   * @returns Articles response
+   */
+  getArticles(page = 1, perPage = 10, category) {
+    const categoryParam = category !== void 0 ? `&category=${category}` : "";
+    return this.get(
+      `/hi/articles?page=${page}&per_page=${perPage}${categoryParam}`,
+      { useSpartanToken: false }
+    );
+  }
+  /**
+   * Get a specific article by slug.
+   *
+   * @param slug - Article URL slug
+   * @returns Article details
+   */
+  getArticle(slug) {
+    this.assertNotEmpty(slug, "slug");
+    return this.get(`/hi/articles/${encodeURIComponent(slug)}`, {
+      useSpartanToken: false
+    });
+  }
+  /**
+   * Get article categories.
+   *
+   * @returns List of categories
+   */
+  getCategories() {
+    return this.get("/hi/articles/categories", {
+      useSpartanToken: false
+    });
+  }
+};
+
+// src/modules/waypoint/comms.module.ts
+var CommsModule = class extends WaypointModuleBase {
+  constructor(client) {
+    super(client);
+  }
+  /**
+   * Get notifications for the current user.
+   *
+   * @returns Notifications response
+   */
+  getNotifications() {
+    return this.get("/hi/users/me/notifications");
+  }
+  /**
+   * Mark notifications as read.
+   *
+   * @param notificationIds - IDs of notifications to mark as read
+   * @returns Result of the operation
+   */
+  markNotificationsAsRead(notificationIds) {
+    if (!notificationIds.length) {
+      throw new Error("notificationIds cannot be empty");
+    }
+    return this.postJson(
+      "/hi/users/me/notifications/read",
+      { notificationIds }
+    );
+  }
+  /**
+   * Delete a notification.
+   *
+   * @param notificationId - ID of notification to delete
+   * @returns Success status
+   */
+  deleteNotification(notificationId) {
+    this.assertNotEmpty(notificationId, "notificationId");
+    return this.client.executeRequest(
+      this.buildUrl(`/hi/users/me/notifications/${notificationId}`),
+      "DELETE",
+      { useSpartanToken: true }
+    );
+  }
+};
+
+// src/clients/waypoint-client.ts
+var WaypointClient = class extends ClientBase {
+  // Lazy-loaded module instances
+  _profile;
+  _redemption;
+  _content;
+  _comms;
+  /**
+   * Creates a new WaypointClient instance.
+   *
+   * Some endpoints (like news articles) don't require authentication,
+   * so spartanToken is optional.
+   *
+   * @param options - Client configuration options (optional)
+   *
+   * @example
+   * ```typescript
+   * // With authentication
+   * const authClient = new WaypointClient({
+   *   spartanToken: 'your-spartan-token',
+   * });
+   *
+   * // Without authentication (for public endpoints)
+   * const publicClient = new WaypointClient();
+   * ```
+   */
+  constructor(options = {}) {
+    super({
+      fetchFn: options.fetchFn,
+      cacheTtlMs: options.cacheTtlMs,
+      maxRetries: options.maxRetries
+    });
+    this.spartanToken = options.spartanToken ?? "";
+    this.xuid = options.xuid ?? "";
+    this.clearanceToken = options.clearanceToken ?? "";
+    this.userAgent = options.userAgent ?? "";
+  }
+  /**
+   * Profile module for user profile and settings APIs.
+   *
+   * Provides access to:
+   * - User profiles (self and others)
+   * - User settings
+   * - Service awards
+   */
+  get profile() {
+    return this._profile ??= new ProfileModule(this);
+  }
+  /**
+   * Redemption module for code redemption APIs.
+   *
+   * Provides access to:
+   * - Promotional code redemption
+   */
+  get redemption() {
+    return this._redemption ??= new RedemptionModule(this);
+  }
+  /**
+   * Content module for articles and news APIs.
+   *
+   * Provides access to:
+   * - News articles
+   * - Article categories
+   *
+   * Note: Most content endpoints don't require authentication.
+   */
+  get content() {
+    return this._content ??= new ContentModule(this);
+  }
+  /**
+   * Comms module for notifications and communications APIs.
+   *
+   * Provides access to:
+   * - User notifications
+   * - Marking notifications as read
+   */
+  get comms() {
+    return this._comms ??= new CommsModule(this);
+  }
+};
+
+// src/auth/halo-auth-client.ts
+var HaloAuthenticationClient = class {
+  fetchFn;
+  /**
+   * Creates a new HaloAuthenticationClient instance.
+   *
+   * @param fetchFn - Custom fetch implementation (optional)
+   */
+  constructor(fetchFn) {
+    this.fetchFn = fetchFn ?? globalThis.fetch.bind(globalThis);
+  }
+  /**
+   * Exchange an XSTS token for a Halo Spartan token.
+   *
+   * The XSTS token must be obtained through Xbox Live authentication
+   * using the Halo Waypoint relying party.
+   *
+   * @param xstsToken - Xbox Live XSTS token
+   * @param version - Spartan token version (4 for Halo Infinite, 3 for Halo 5)
+   * @returns Spartan token or null if exchange failed
+   *
+   * @example
+   * ```typescript
+   * // Version 4 is for Halo Infinite (default)
+   * const spartanToken = await authClient.getSpartanToken(xstsToken);
+   *
+   * // Version 3 is for Halo 5
+   * const halo5Token = await authClient.getSpartanToken(xstsToken, 3);
+   * ```
+   */
+  async getSpartanToken(xstsToken, version = 4) {
+    if (!xstsToken) {
+      throw new Error("xstsToken is required");
+    }
+    const tokenProof = {
+      token: xstsToken,
+      tokenType: "Xbox_XSTSv3"
+    };
+    const requestBody = {
+      audience: "urn:343:s3:services",
+      minVersion: version.toString(),
+      proof: [tokenProof]
+    };
+    try {
+      const response = await this.fetchFn(HALO_CORE_ENDPOINTS.SPARTAN_TOKEN_ENDPOINT, {
+        method: "POST",
+        headers: {
+          [HEADERS.CONTENT_TYPE]: "application/json",
+          [HEADERS.ACCEPT]: "application/json"
+        },
+        body: JSON.stringify(requestBody)
+      });
+      if (!response.ok) {
+        console.error(
+          `Failed to get Spartan token: ${response.status} ${response.statusText}`
+        );
+        return null;
+      }
+      const data = await response.json();
+      return {
+        token: data.SpartanToken ?? data.spartanToken ?? data.token,
+        expiresUtc: data.ExpiresUtc ?? data.expiresUtc,
+        tokenDuration: data.TokenDuration ?? data.tokenDuration
+      };
+    } catch (error) {
+      console.error("Error getting Spartan token:", error);
+      return null;
+    }
+  }
+  /**
+   * Check if a Spartan token is expired or about to expire.
+   *
+   * @param token - The Spartan token to check
+   * @param bufferMinutes - Minutes before expiration to consider "about to expire"
+   * @returns true if the token is expired or will expire within the buffer time
+   */
+  isTokenExpired(token, bufferMinutes = 5) {
+    if (!token.expiresUtc) {
+      return true;
+    }
+    const expiresAt = new Date(token.expiresUtc);
+    const now = /* @__PURE__ */ new Date();
+    const bufferMs = bufferMinutes * 60 * 1e3;
+    return now.getTime() + bufferMs >= expiresAt.getTime();
+  }
+  /**
+   * Get the Halo Waypoint XSTS relying party URL.
+   *
+   * Use this when requesting an XSTS token from Xbox Live.
+   *
+   * @returns The relying party URL
+   */
+  static getRelyingParty() {
+    return HALO_CORE_ENDPOINTS.HALO_WAYPOINT_XSTS_RELYING_PARTY;
+  }
+};
+
+// src/models/common/api-result.ts
+function isSuccess(result) {
+  return result.result !== null && result.response.code >= 200 && result.response.code < 300;
+}
+function isNotModified(result) {
+  return result.response.code === 304;
+}
+function isClientError(result) {
+  return result.response.code >= 400 && result.response.code < 500;
+}
+function isServerError(result) {
+  return result.response.code >= 500;
+}
+
+// src/models/halo-infinite/enums/match-type.ts
+var MatchType = {
+  /** Return all match types */
+  All: "all",
+  /** Return only matchmaking matches */
+  Matchmaking: "matchmaking",
+  /** Return only custom games */
+  Custom: "custom",
+  /** Return only local/offline matches */
+  Local: "local"
+};
+
+// src/models/halo-infinite/enums/lifecycle-mode.ts
+var LifecycleMode = {
+  /** Matchmade multiplayer games */
+  Matchmade: "matchmade",
+  /** Custom games */
+  Custom: "custom",
+  /** Local/offline games */
+  Local: "local"
+};
+
+// src/models/halo-infinite/enums/asset-kind.ts
+var AssetKind = {
+  /** Film/theater recording */
+  Film: "Film",
+  /** Custom map/forge creation */
+  Map: "Map",
+  /** Prefabricated object collection */
+  Prefab: "Prefab",
+  /** User-created game variant */
+  UgcGameVariant: "UgcGameVariant",
+  /** Map-mode pairing */
+  MapModePair: "MapModePair",
+  /** Playlist definition */
+  Playlist: "Playlist",
+  /** Engine game variant */
+  EngineGameVariant: "EngineGameVariant",
+  /** Project (forge project) */
+  Project: "Project"
+};
+
+// src/models/halo-infinite/enums/player-type.ts
+var PlayerType = {
+  /** Human player */
+  Human: "Human",
+  /** Bot/AI player */
+  Bot: "Bot"
+};
+
+// src/models/halo-infinite/enums/outcome.ts
+var Outcome = {
+  /** Won the match */
+  Win: "Win",
+  /** Lost the match */
+  Loss: "Loss",
+  /** Match ended in a tie */
+  Tie: "Tie",
+  /** Did not finish the match */
+  DidNotFinish: "DidNotFinish"
+};
+
+// src/models/halo-infinite/enums/result-order.ts
+var ResultOrder = {
+  /** Sort in ascending order */
+  Ascending: "asc",
+  /** Sort in descending order */
+  Descending: "desc"
+};
+
+// src/errors/halo-api-error.ts
+var HaloApiError = class _HaloApiError extends Error {
+  /**
+   * HTTP status code from the response.
+   */
+  statusCode;
+  /**
+   * Full raw response details.
+   */
+  response;
+  /**
+   * Creates a new HaloApiError.
+   *
+   * @param message - Error message
+   * @param statusCode - HTTP status code
+   * @param response - Full raw response
+   */
+  constructor(message, statusCode, response) {
+    super(message);
+    this.name = "HaloApiError";
+    this.statusCode = statusCode;
+    this.response = response;
+    if (Error.captureStackTrace) {
+      Error.captureStackTrace(this, _HaloApiError);
+    }
+  }
+  /**
+   * Creates a HaloApiError from a raw response.
+   *
+   * @param response - The raw response to convert to an error
+   * @returns A new HaloApiError instance
+   */
+  static fromResponse(response) {
+    const message = response.message ?? `HTTP Error ${response.code}`;
+    return new _HaloApiError(message, response.code, response);
+  }
+  /**
+   * Check if this is a client error (4xx).
+   */
+  get isClientError() {
+    return this.statusCode >= 400 && this.statusCode < 500;
+  }
+  /**
+   * Check if this is a server error (5xx).
+   */
+  get isServerError() {
+    return this.statusCode >= 500;
+  }
+  /**
+   * Check if this is a "not found" error (404).
+   */
+  get isNotFound() {
+    return this.statusCode === 404;
+  }
+  /**
+   * Check if this is an "unauthorized" error (401).
+   */
+  get isUnauthorized() {
+    return this.statusCode === 401;
+  }
+  /**
+   * Check if this is a "forbidden" error (403).
+   */
+  get isForbidden() {
+    return this.statusCode === 403;
+  }
+  /**
+   * Check if this is a "rate limited" error (429).
+   */
+  get isRateLimited() {
+    return this.statusCode === 429;
+  }
+};
+
+export { ApiContentType, AssetKind, DEFAULT_AUTH_SCOPES, DEFAULT_CACHE_TTL_MS, DEFAULT_MAX_RETRIES, DEFAULT_TIMEOUT_MS, HALO_CORE_ENDPOINTS, HEADERS, HaloApiError, HaloAuthenticationClient, HaloInfiniteClient, LifecycleMode, MatchType, Outcome, PlayerType, ResultOrder, USER_AGENTS, WAYPOINT_ENDPOINTS, WaypointClient, buildServiceUrl, getContentTypeHeader, isClientError, isNotModified, isServerError, isSuccess };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map