@dendotdev/grunt 1.0.3 → 1.0.5

package/dist/index.mjs

@@ -949,6 +949,44 @@ var EconomyModule = class extends ModuleBase {
       `/hi/players/xuid(${player})/customization/appearance`
     );
   }
+  /**
+   * Get customization for multiple players.
+   *
+   * @param playerIds - List of player XUIDs
+   * @returns Player customization collection
+   */
+  getMultiplePlayersCustomization(playerIds) {
+    if (!playerIds.length) {
+      throw new Error("playerIds cannot be empty");
+    }
+    const formattedPlayers = playerIds.map((id) => `xuid(${id})`).join(",");
+    return this.get(`/hi/customization?players=${formattedPlayers}`);
+  }
+  // ─────────────────────────────────────────────────────────────────
+  // Cores
+  // ─────────────────────────────────────────────────────────────────
+  /**
+   * Get details about all owned cores for a player.
+   *
+   * @param player - Player's numeric XUID
+   * @returns All player cores
+   */
+  getAllOwnedCoresDetails(player) {
+    this.assertNotEmpty(player, "player");
+    return this.get(`/hi/players/xuid(${player})/cores`);
+  }
+  /**
+   * Get details about a specific owned core.
+   *
+   * @param player - Player's numeric XUID
+   * @param coreId - Core identifier
+   * @returns Core details
+   */
+  getOwnedCoreDetails(player, coreId) {
+    this.assertNotEmpty(player, "player");
+    this.assertNotEmpty(coreId, "coreId");
+    return this.get(`/hi/players/xuid(${player})/cores/${coreId}`);
+  }
   // ─────────────────────────────────────────────────────────────────
   // Stores
   // ─────────────────────────────────────────────────────────────────
@@ -1012,6 +1050,66 @@ var EconomyModule = class extends ModuleBase {
     this.assertNotEmpty(player, "player");
     return this.get(`/hi/players/xuid(${player})/stores/operations`);
   }
+  /**
+   * Get the operation reward levels store.
+   *
+   * @param player - Player's numeric XUID
+   * @returns Store items
+   */
+  getOperationRewardLevelsStore(player) {
+    this.assertNotEmpty(player, "player");
+    return this.get(`/hi/players/xuid(${player})/stores/operationrewardlevels`);
+  }
+  /**
+   * Get the XP grants store.
+   *
+   * @param player - Player's numeric XUID
+   * @returns Store items
+   */
+  getXpGrantsStore(player) {
+    this.assertNotEmpty(player, "player");
+    return this.get(`/hi/players/xuid(${player})/stores/xpgrants`);
+  }
+  /**
+   * Get items from a credit sub-store.
+   *
+   * Credit sub-stores (0-5) contain different categories of items
+   * purchasable with credits.
+   *
+   * @param player - Player's numeric XUID
+   * @param storeIndex - Sub-store index (0-5)
+   * @returns Store items
+   */
+  getCreditSubStore(player, storeIndex) {
+    this.assertNotEmpty(player, "player");
+    if (storeIndex < 0 || storeIndex > 5) {
+      throw new Error("storeIndex must be between 0 and 5");
+    }
+    const paddedIndex = storeIndex.toString().padStart(2, "0");
+    return this.get(
+      `/hi/players/xuid(${player})/stores/creditsubstorefront${paddedIndex}`
+    );
+  }
+  /**
+   * Get items from a soft currency (Spartan Points) sub-store.
+   *
+   * Soft currency sub-stores (0-15) contain different categories of items
+   * purchasable with Spartan Points on The Exchange.
+   *
+   * @param player - Player's numeric XUID
+   * @param storeIndex - Sub-store index (0-15)
+   * @returns Store items
+   */
+  getSoftCurrencySubStore(player, storeIndex) {
+    this.assertNotEmpty(player, "player");
+    if (storeIndex < 0 || storeIndex > 15) {
+      throw new Error("storeIndex must be between 0 and 15");
+    }
+    const paddedIndex = storeIndex.toString().padStart(2, "0");
+    return this.get(
+      `/hi/players/xuid(${player})/stores/softcurrencysubstorefront${paddedIndex}`
+    );
+  }
   /**
    * Get scheduled storefront offerings.
    *
@@ -1268,7 +1366,7 @@ var GameCmsModule = class extends ModuleBase {
    * @returns Medal metadata
    */
   getMedalMetadata() {
-    return this.get("/hi/Progression/file/medals/metadata");
+    return this.get("/hi/Waypoint/file/medals/metadata.json");
   }
   /**
    * Get general game metadata.
@@ -1337,6 +1435,232 @@ var GameCmsModule = class extends ModuleBase {
     this.assertNotEmpty(filePath, "filePath");
     return this.get(`/hi/Progression/file/${filePath}`);
   }
+  // ─────────────────────────────────────────────────────────────────
+  // Achievements & Settings
+  // ─────────────────────────────────────────────────────────────────
+  /**
+   * Get all available achievements.
+   *
+   * @returns Achievement collection
+   */
+  getAchievements() {
+    return this.get("/hi/Multiplayer/file/Live/Achievements.json");
+  }
+  /**
+   * Get the Play Now button settings (fallback playlist).
+   *
+   * @returns Fallback playlist settings
+   */
+  getPlayNowButtonSettings() {
+    return this.get(
+      "/hi/Multiplayer/file/playlists/playNowButton/settings.json"
+    );
+  }
+  /**
+   * Get custom game default settings.
+   *
+   * @returns Custom game definition
+   */
+  getCustomGameDefaults() {
+    return this.get("/hi/Multiplayer/file/NonMatchmaking/customgame.json");
+  }
+  /**
+   * Get lobby error messages.
+   *
+   * @param flightId - Flight ID
+   * @returns Lobby error message list
+   */
+  getLobbyErrorMessages(flightId) {
+    this.assertNotEmpty(flightId, "flightId");
+    return this.get(
+      `/hi/Multiplayer/file/gameStartErrorMessages/LobbyHoppperErrorMessageList.json?flight=${flightId}`
+    );
+  }
+  /**
+   * Get network configuration.
+   *
+   * @param flightId - Flight ID
+   * @returns Network configuration
+   */
+  getNetworkConfiguration(flightId) {
+    this.assertNotEmpty(flightId, "flightId");
+    return this.get(
+      `/hi/Multiplayer/file/network/config.json?flight=${flightId}`
+    );
+  }
+  /**
+   * Get a multiplayer playlist configuration.
+   *
+   * @param playlistFile - Playlist file name (e.g., "uuid.json")
+   * @returns Playlist configuration
+   */
+  getMultiplayerPlaylistConfiguration(playlistFile) {
+    this.assertNotEmpty(playlistFile, "playlistFile");
+    return this.get(
+      `/hi/Multiplayer/file/playlists/assets/${playlistFile}`
+    );
+  }
+  // ─────────────────────────────────────────────────────────────────
+  // Graphics & Specs
+  // ─────────────────────────────────────────────────────────────────
+  /**
+   * Get async compute overrides.
+   *
+   * @returns Async compute override configuration
+   */
+  getAsyncComputeOverrides() {
+    return this.get("/hi/Specs/file/graphics/AsyncComputeOverrides.json");
+  }
+  /**
+   * Get CPU presets.
+   *
+   * @returns CPU preset configuration
+   */
+  getCpuPresets() {
+    return this.get("/hi/Specs/file/cpu/presets.json");
+  }
+  /**
+   * Get device preset overrides.
+   *
+   * @returns Device preset overrides
+   */
+  getDevicePresetOverrides() {
+    return this.get("/hi/Specs/file/graphics/DevicePresetOverrides.json");
+  }
+  /**
+   * Get graphics spec control overrides.
+   *
+   * @returns Graphics spec control overrides
+   */
+  getGraphicsSpecControlOverrides() {
+    return this.get(
+      "/hi/Specs/file/graphics/GraphicsSpecControlOverrides.json"
+    );
+  }
+  /**
+   * Get graphics specs/overrides.
+   *
+   * @returns Graphics overrides
+   */
+  getGraphicSpecs() {
+    return this.get("/hi/Specs/file/graphics/overrides.json");
+  }
+  /**
+   * Get recommended drivers.
+   *
+   * @returns Driver manifest
+   */
+  getRecommendedDrivers() {
+    return this.get("/hi/Specs/file/graphics/RecommendedDrivers.json");
+  }
+  // ─────────────────────────────────────────────────────────────────
+  // Title Authorization & Access
+  // ─────────────────────────────────────────────────────────────────
+  /**
+   * Get claw (clawback) access list.
+   *
+   * @param flightId - Flight ID
+   * @returns Claw access snapshot
+   */
+  getClawAccess(flightId) {
+    this.assertNotEmpty(flightId, "flightId");
+    return this.get(
+      `/hi/TitleAuthorization/file/claw/access.json?flight=${flightId}`
+    );
+  }
+  /**
+   * Get not allowed in title message.
+   *
+   * @returns OE configuration message
+   */
+  getNotAllowedInTitleMessage() {
+    const url = `https://${HALO_CORE_ENDPOINTS.GAME_CMS_ORIGIN}.${HALO_CORE_ENDPOINTS.SERVICE_DOMAIN}/branches/hi/OEConfiguration/data/authfail/Default.json`;
+    return this.getFullUrl(url, { useSpartanToken: false });
+  }
+  // ─────────────────────────────────────────────────────────────────
+  // Guides (File Listings)
+  // ─────────────────────────────────────────────────────────────────
+  /**
+   * Get guide for images files.
+   *
+   * @param flightId - Flight ID
+   * @returns Guide container with file listings
+   */
+  getGuideImages(flightId) {
+    this.assertNotEmpty(flightId, "flightId");
+    return this.get(`/hi/images/guide/xo?flight=${flightId}`);
+  }
+  /**
+   * Get guide for multiplayer files.
+   *
+   * @param flightId - Flight ID
+   * @returns Guide container with file listings
+   */
+  getGuideMultiplayer(flightId) {
+    this.assertNotEmpty(flightId, "flightId");
+    return this.get(`/hi/Multiplayer/guide/xo?flight=${flightId}`);
+  }
+  /**
+   * Get guide for news files.
+   *
+   * @param flightId - Flight ID
+   * @returns Guide container with file listings
+   */
+  getGuideNews(flightId) {
+    this.assertNotEmpty(flightId, "flightId");
+    return this.get(`/hi/News/guide/xo?flight=${flightId}`);
+  }
+  /**
+   * Get guide for progression files.
+   *
+   * @param flightId - Flight ID
+   * @returns Guide container with file listings
+   */
+  getGuideProgression(flightId) {
+    this.assertNotEmpty(flightId, "flightId");
+    return this.get(`/hi/Progression/guide/xo?flight=${flightId}`);
+  }
+  /**
+   * Get guide for spec files.
+   *
+   * @param flightId - Flight ID
+   * @returns Guide container with file listings
+   */
+  getGuideSpecs(flightId) {
+    this.assertNotEmpty(flightId, "flightId");
+    return this.get(`/hi/Specs/guide/xo?flight=${flightId}`);
+  }
+  /**
+   * Get guide for title authorization files.
+   *
+   * @param flightId - Flight ID
+   * @returns Guide container with file listings
+   */
+  getGuideTitleAuthorization(flightId) {
+    this.assertNotEmpty(flightId, "flightId");
+    return this.get(`/hi/TitleAuthorization/guide/xo?flight=${flightId}`);
+  }
+  // ─────────────────────────────────────────────────────────────────
+  // Waypoint Files
+  // ─────────────────────────────────────────────────────────────────
+  /**
+   * Get emblem mapping configuration.
+   *
+   * @returns Emblem mapping dictionary
+   */
+  getEmblemMapping() {
+    return this.get("/hi/Waypoint/file/images/emblems/mapping.json");
+  }
+  /**
+   * Get a generic file from Waypoint service.
+   *
+   * @param filePath - Path to the file
+   * @returns File data as bytes
+   */
+  getGenericWaypointFile(filePath) {
+    this.assertNotEmpty(filePath, "filePath");
+    return this.get(`/hi/Waypoint/file/${filePath}`, { returnRaw: true });
+  }
 };
 
 // src/modules/halo-infinite/lobby.module.ts
@@ -1420,6 +1744,100 @@ var SettingsModule = class extends ModuleBase {
       useSpartanToken: true
     });
   }
+  /**
+   * Get a list of features enabled for a given flight.
+   *
+   * @param flightId - Clearance ID/flight that is being used
+   * @returns Flighted feature flags
+   */
+  getFlightedFeatureFlags(flightId) {
+    this.assertNotEmpty(flightId, "flightId");
+    return this.get(`/featureflags/hi?flight=${flightId}`);
+  }
+  /**
+   * Get the currently active clearance.
+   *
+   * @param release - Release identifier (e.g., "1.4", "1.5", "1.6")
+   * @returns Player clearance data
+   */
+  getActiveClearance(release) {
+    this.assertNotEmpty(release, "release");
+    return this.get(`/hi/clearances/active?release=${release}`, {
+      useSpartanToken: false
+    });
+  }
+  /**
+   * Get the currently active flight.
+   *
+   * @param sandbox - Sandbox identifier (typically "UNUSED")
+   * @param buildNumber - Game build number (e.g., "211755.22.01.23.0549-0")
+   * @param release - Release identifier (e.g., "1.4", "1.5")
+   * @returns Player clearance data
+   */
+  getActiveFlight(sandbox, buildNumber, release) {
+    this.assertNotEmpty(sandbox, "sandbox");
+    this.assertNotEmpty(buildNumber, "buildNumber");
+    this.assertNotEmpty(release, "release");
+    return this.get(
+      `/oban/flight-configurations/titles/hi/audiences/RETAIL/active?sandbox=${sandbox}&build=${buildNumber}&release=${release}`
+    );
+  }
+  /**
+   * Get the clearance/flight ID for a specific audience.
+   *
+   * @param audience - Audience targeting (e.g., "RETAIL")
+   * @param sandbox - Sandbox identifier (typically "UNUSED")
+   * @param buildNumber - Game build number
+   * @param release - Release identifier
+   * @returns Player clearance data
+   */
+  getClearance(audience, sandbox, buildNumber, release) {
+    this.assertNotEmpty(audience, "audience");
+    this.assertNotEmpty(sandbox, "sandbox");
+    this.assertNotEmpty(buildNumber, "buildNumber");
+    this.assertNotEmpty(release, "release");
+    return this.get(
+      `/oban/flight-configurations/titles/hi/audiences/${audience}/active?sandbox=${sandbox}&build=${buildNumber}&release=${release}`
+    );
+  }
+  /**
+   * Get the player clearance/flight ID for a specific audience.
+   *
+   * @param audience - Audience targeting (e.g., "RETAIL")
+   * @param player - Player XUID
+   * @param sandbox - Sandbox identifier (typically "UNUSED")
+   * @param buildNumber - Game build number
+   * @param release - Release identifier
+   * @returns Player clearance data
+   */
+  getPlayerClearance(audience, player, sandbox, buildNumber, release) {
+    this.assertNotEmpty(audience, "audience");
+    this.assertNotEmpty(player, "player");
+    this.assertNotEmpty(sandbox, "sandbox");
+    this.assertNotEmpty(buildNumber, "buildNumber");
+    this.assertNotEmpty(release, "release");
+    return this.get(
+      `/oban/flight-configurations/titles/hi/audiences/${audience}/players/xuid(${player})/active?sandbox=${sandbox}&build=${buildNumber}&release=${release}`
+    );
+  }
+  /**
+   * Get the player clearance/flight ID for RETAIL audience.
+   *
+   * @param player - Player XUID
+   * @param sandbox - Sandbox identifier (typically "UNUSED")
+   * @param buildNumber - Game build number
+   * @param release - Release identifier
+   * @returns Player clearance data
+   */
+  getPlayerClearanceRetail(player, sandbox, buildNumber, release) {
+    this.assertNotEmpty(player, "player");
+    this.assertNotEmpty(sandbox, "sandbox");
+    this.assertNotEmpty(buildNumber, "buildNumber");
+    this.assertNotEmpty(release, "release");
+    return this.get(
+      `/oban/flight-configurations/titles/hi/audiences/RETAIL/players/xuid(${player})/active?sandbox=${sandbox}&build=${buildNumber}&release=${release}`
+    );
+  }
 };
 
 // src/modules/halo-infinite/skill.module.ts
@@ -1601,6 +2019,28 @@ var TextModerationModule = class extends ModuleBase {
   getModerationKey() {
     return this.get("/hi/moderation/key");
   }
+  /**
+   * Get a specific moderation proof signing key.
+   *
+   * @param keyId - Key ID (can be obtained from getSigningKeys)
+   * @returns Signing key data
+   */
+  getSigningKey(keyId) {
+    this.assertNotEmpty(keyId, "keyId");
+    return this.get(`/hi/moderation-proof-keys/${keyId}`, {
+      useSpartanToken: false
+    });
+  }
+  /**
+   * Get all available moderation proof signing keys.
+   *
+   * @returns Container with all signing keys
+   */
+  getSigningKeys() {
+    return this.get("/hi/moderation-proof-keys", {
+      useSpartanToken: false
+    });
+  }
 };
 
 // src/modules/halo-infinite/ugc.module.ts
@@ -1637,6 +2077,18 @@ var UgcModule = class extends ModuleBase {
     this.assertNotEmpty(assetId, "assetId");
     return this.get(`/${title}/${assetType}/${assetId}/versions/latest`);
   }
+  /**
+   * Get the latest version of a film asset.
+   *
+   * @param title - Game title
+   * @param assetId - Film asset GUID
+   * @returns Latest film asset version
+   */
+  getLatestAssetVersionFilm(title, assetId) {
+    this.assertNotEmpty(title, "title");
+    this.assertNotEmpty(assetId, "assetId");
+    return this.get(`/${title}/films/${assetId}/versions/latest`);
+  }
   /**
    * Get a specific version of an asset.
    *
@@ -1812,18 +2264,31 @@ var UgcModule = class extends ModuleBase {
   // Asset Management
   // ─────────────────────────────────────────────────────────────────
   /**
-   * Delete an asset and all its versions.
+   * Delete an asset.
    *
    * @param title - Game title
    * @param assetType - Type of asset
    * @param assetId - Asset GUID
    * @returns Success status
    */
-  deleteAllVersions(title, assetType, assetId) {
+  deleteAsset(title, assetType, assetId) {
     this.assertNotEmpty(title, "title");
     this.assertNotEmpty(assetId, "assetId");
     return this.delete(`/${title}/${assetType}/${assetId}`);
   }
+  /**
+   * Delete all versions of an asset.
+   *
+   * @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}/versions`);
+  }
   /**
    * Delete a specific version of an asset.
    *
@@ -1839,6 +2304,34 @@ var UgcModule = class extends ModuleBase {
     this.assertNotEmpty(versionId, "versionId");
     return this.delete(`/${title}/${assetType}/${assetId}/versions/${versionId}`);
   }
+  /**
+   * Undelete a previously deleted asset.
+   *
+   * @param title - Game title
+   * @param assetType - Type of asset
+   * @param assetId - Asset GUID
+   * @returns Success status
+   */
+  undeleteAsset(title, assetType, assetId) {
+    this.assertNotEmpty(title, "title");
+    this.assertNotEmpty(assetId, "assetId");
+    return this.post(`/${title}/${assetType}/${assetId}/recover`);
+  }
+  /**
+   * Undelete a previously deleted asset version.
+   *
+   * @param title - Game title
+   * @param assetType - Type of asset
+   * @param assetId - Asset GUID
+   * @param versionId - Version GUID
+   * @returns Success status
+   */
+  undeleteVersion(title, assetType, assetId, versionId) {
+    this.assertNotEmpty(title, "title");
+    this.assertNotEmpty(assetId, "assetId");
+    this.assertNotEmpty(versionId, "versionId");
+    return this.post(`/${title}/${assetType}/${assetId}/versions/${versionId}/recover`);
+  }
   /**
    * Publish an asset version.
    *
@@ -1937,6 +2430,21 @@ var UgcModule = class extends ModuleBase {
     this.assertNotEmpty(assetId, "assetId");
     return this.delete(`/${title}/${assetType}/${assetId}/sessions`);
   }
+  /**
+   * Spawn (create) a new asset.
+   *
+   * @param title - Game title
+   * @param assetType - Type of asset (e.g., "UgcGameVariants", "Maps", "Prefabs")
+   * @param asset - Asset definition
+   * @returns Created asset
+   */
+  spawnAsset(title, assetType, asset) {
+    this.assertNotEmpty(title, "title");
+    return this.postJson(
+      `/${title}/${assetType}`,
+      asset
+    );
+  }
   /**
    * Create a new asset version.
    *
@@ -1994,6 +2502,9 @@ var UgcDiscoveryModule = class extends ModuleBase {
   constructor(client) {
     super(client, HALO_CORE_ENDPOINTS.DISCOVERY_ORIGIN);
   }
+  // ─────────────────────────────────────────────────────────────────
+  // Search & Browse
+  // ─────────────────────────────────────────────────────────────────
   /**
    * Search for user-generated content.
    *
@@ -2030,6 +2541,27 @@ var UgcDiscoveryModule = class extends ModuleBase {
     if (params.start !== void 0) {
       queryParts.push(`start=${params.start}`);
     }
+    if (params.averageRatingMin !== void 0) {
+      queryParts.push(`averageRatingMin=${params.averageRatingMin}`);
+    }
+    if (params.fromDateCreatedUtc) {
+      queryParts.push(`fromDateCreatedUtc=${encodeURIComponent(params.fromDateCreatedUtc.toISOString())}`);
+    }
+    if (params.toDateCreatedUtc) {
+      queryParts.push(`toDateCreatedUtc=${encodeURIComponent(params.toDateCreatedUtc.toISOString())}`);
+    }
+    if (params.fromDateModifiedUtc) {
+      queryParts.push(`fromDateModifiedUtc=${encodeURIComponent(params.fromDateModifiedUtc.toISOString())}`);
+    }
+    if (params.toDateModifiedUtc) {
+      queryParts.push(`toDateModifiedUtc=${encodeURIComponent(params.toDateModifiedUtc.toISOString())}`);
+    }
+    if (params.fromDatePublishedUtc) {
+      queryParts.push(`fromDatePublishedUtc=${encodeURIComponent(params.fromDatePublishedUtc.toISOString())}`);
+    }
+    if (params.toDatePublishedUtc) {
+      queryParts.push(`toDatePublishedUtc=${encodeURIComponent(params.toDatePublishedUtc.toISOString())}`);
+    }
     const queryString = queryParts.length > 0 ? `?${queryParts.join("&")}` : "";
     return this.get(`/hi/search${queryString}`);
   }
@@ -2109,15 +2641,298 @@ var UgcDiscoveryModule = class extends ModuleBase {
     return this.get(`/hi/${assetKind}/${assetId}`);
   }
   /**
-   * Get film asset for a match.
+   * Get tags information.
+   *
+   * @returns Available tags info
+   */
+  getTagsInfo() {
+    return this.get("/hi/info/tags");
+  }
+  // ─────────────────────────────────────────────────────────────────
+  // Manifests
+  // ─────────────────────────────────────────────────────────────────
+  /**
+   * Get the game manifest by build GUID.
+   *
+   * @param buildGuid - Build GUID
+   * @returns Manifest data
+   */
+  getManifestByBuildGuid(buildGuid) {
+    this.assertNotEmpty(buildGuid, "buildGuid");
+    return this.get(`/hi/manifests/guids/${buildGuid}/game`);
+  }
+  /**
+   * Get the game manifest by build number.
+   *
+   * @param buildNumber - Build number (e.g., "6.10022.10499")
+   * @returns Manifest data
+   */
+  getManifestByBuild(buildNumber) {
+    this.assertNotEmpty(buildNumber, "buildNumber");
+    return this.get(`/hi/manifests/builds/${buildNumber}/game`);
+  }
+  /**
+   * Get a specific manifest version.
+   *
+   * @param assetId - Manifest asset ID
+   * @param versionId - Manifest version ID
+   * @param clearanceId - Active flight clearance ID
+   * @returns Manifest data
+   */
+  getManifest(assetId, versionId, clearanceId) {
+    this.assertNotEmpty(assetId, "assetId");
+    this.assertNotEmpty(versionId, "versionId");
+    return this.get(
+      `/hi/manifests/${assetId}/versions/${versionId}?clearanceId=${clearanceId}`
+    );
+  }
+  // ─────────────────────────────────────────────────────────────────
+  // Maps
+  // ─────────────────────────────────────────────────────────────────
+  /**
+   * Get a specific map version.
+   *
+   * @param assetId - Map asset ID
+   * @param versionId - Map version ID
+   * @returns Map data
+   */
+  getMap(assetId, versionId) {
+    this.assertNotEmpty(assetId, "assetId");
+    this.assertNotEmpty(versionId, "versionId");
+    return this.get(`/hi/maps/${assetId}/versions/${versionId}`);
+  }
+  /**
+   * Get a map without specifying version (returns latest).
+   *
+   * @param assetId - Map asset ID
+   * @returns Map data
+   */
+  getMapWithoutVersion(assetId) {
+    this.assertNotEmpty(assetId, "assetId");
+    return this.get(`/hi/maps/${assetId}`);
+  }
+  // ─────────────────────────────────────────────────────────────────
+  // Map Mode Pairs
+  // ─────────────────────────────────────────────────────────────────
+  /**
+   * Get a specific map mode pair version.
+   *
+   * @param assetId - Map mode pair asset ID
+   * @param versionId - Version ID
+   * @param clearanceId - Active flight clearance ID
+   * @returns Map mode pair data
+   */
+  getMapModePair(assetId, versionId, clearanceId) {
+    this.assertNotEmpty(assetId, "assetId");
+    this.assertNotEmpty(versionId, "versionId");
+    return this.get(
+      `/hi/mapModePairs/${assetId}/versions/${versionId}?clearanceId=${clearanceId}`
+    );
+  }
+  /**
+   * Get a map mode pair without specifying version.
+   *
+   * @param assetId - Map mode pair asset ID
+   * @returns Map mode pair data
+   */
+  getMapModePairWithoutVersion(assetId) {
+    this.assertNotEmpty(assetId, "assetId");
+    return this.get(`/hi/mapModePairs/${assetId}`);
+  }
+  // ─────────────────────────────────────────────────────────────────
+  // Playlists
+  // ─────────────────────────────────────────────────────────────────
+  /**
+   * Get a specific playlist version.
+   *
+   * @param assetId - Playlist asset ID
+   * @param versionId - Version ID
+   * @param clearanceId - Active flight clearance ID
+   * @returns Playlist data
+   */
+  getPlaylist(assetId, versionId, clearanceId) {
+    this.assertNotEmpty(assetId, "assetId");
+    this.assertNotEmpty(versionId, "versionId");
+    return this.get(
+      `/hi/playlists/${assetId}/versions/${versionId}?clearanceId=${clearanceId}`
+    );
+  }
+  /**
+   * Get a playlist without specifying version.
+   *
+   * @param assetId - Playlist asset ID
+   * @returns Playlist data
+   */
+  getPlaylistWithoutVersion(assetId) {
+    this.assertNotEmpty(assetId, "assetId");
+    return this.get(`/hi/playlists/${assetId}`);
+  }
+  // ─────────────────────────────────────────────────────────────────
+  // Prefabs
+  // ─────────────────────────────────────────────────────────────────
+  /**
+   * Get a specific prefab version.
+   *
+   * @param assetId - Prefab asset ID
+   * @param versionId - Version ID
+   * @returns Prefab data
+   */
+  getPrefab(assetId, versionId) {
+    this.assertNotEmpty(assetId, "assetId");
+    this.assertNotEmpty(versionId, "versionId");
+    return this.get(`/hi/prefabs/${assetId}/versions/${versionId}`);
+  }
+  /**
+   * Get a prefab without specifying version.
+   *
+   * @param assetId - Prefab asset ID
+   * @returns Prefab data
+   */
+  getPrefabWithoutVersion(assetId) {
+    this.assertNotEmpty(assetId, "assetId");
+    return this.get(`/hi/prefabs/${assetId}`);
+  }
+  // ─────────────────────────────────────────────────────────────────
+  // Projects
+  // ─────────────────────────────────────────────────────────────────
+  /**
+   * Get a specific project version.
+   *
+   * @param assetId - Project asset ID
+   * @param versionId - Version ID
+   * @returns Project data
+   */
+  getProject(assetId, versionId) {
+    this.assertNotEmpty(assetId, "assetId");
+    this.assertNotEmpty(versionId, "versionId");
+    return this.get(`/hi/projects/${assetId}/versions/${versionId}`);
+  }
+  /**
+   * Get a project without specifying version.
+   *
+   * @param assetId - Project asset ID
+   * @returns Project data
+   */
+  getProjectWithoutVersion(assetId) {
+    this.assertNotEmpty(assetId, "assetId");
+    return this.get(`/hi/projects/${assetId}`);
+  }
+  /**
+   * Get the Forge templates (canvases).
+   *
+   * @returns Forge templates project
+   */
+  getForgeTemplates() {
+    return this.get("/hi/projects/bf0e9bab-6fed-47a4-8bf7-bfd4422ee552");
+  }
+  /**
+   * Get the Forge mode categories.
+   *
+   * @returns Forge mode categories project
+   */
+  getForgeModeCategories() {
+    return this.get("/hi/projects/aff73c44-0771-468f-b9cf-5c52eee7ab4c");
+  }
+  /**
+   * Get the community tab assets.
+   *
+   * @returns Community tab project
+   */
+  getCommunityTab() {
+    return this.get("/hi/projects/90f9e508-99ce-411c-bf88-7bf12b5e9f52");
+  }
+  /**
+   * Get 343 recommended assets.
+   *
+   * @returns 343 recommended project
+   */
+  get343Recommended() {
+    return this.get("/hi/projects/712add52-f989-48e1-b3bb-ac7cd8a1c17a");
+  }
+  // ─────────────────────────────────────────────────────────────────
+  // Game Variants
+  // ─────────────────────────────────────────────────────────────────
+  /**
+   * Get a specific engine game variant version.
+   *
+   * @param assetId - Engine game variant asset ID
+   * @param versionId - Version ID
+   * @returns Engine game variant data
+   */
+  getEngineGameVariant(assetId, versionId) {
+    this.assertNotEmpty(assetId, "assetId");
+    this.assertNotEmpty(versionId, "versionId");
+    return this.get(
+      `/hi/engineGameVariants/${assetId}/versions/${versionId}`
+    );
+  }
+  /**
+   * Get an engine game variant without specifying version.
+   *
+   * @param assetId - Engine game variant asset ID
+   * @returns Engine game variant data
+   */
+  getEngineGameVariantWithoutVersion(assetId) {
+    this.assertNotEmpty(assetId, "assetId");
+    return this.get(`/hi/engineGameVariants/${assetId}`);
+  }
+  /**
+   * Get a specific UGC game variant version.
+   *
+   * @param assetId - UGC game variant asset ID
+   * @param versionId - Version ID
+   * @returns UGC game variant data
+   */
+  getUgcGameVariant(assetId, versionId) {
+    this.assertNotEmpty(assetId, "assetId");
+    this.assertNotEmpty(versionId, "versionId");
+    return this.get(
+      `/hi/ugcGameVariants/${assetId}/versions/${versionId}`
+    );
+  }
+  /**
+   * Get a UGC game variant without specifying version.
+   *
+   * @param assetId - UGC game variant asset ID
+   * @returns UGC game variant data
+   */
+  getUgcGameVariantWithoutVersion(assetId) {
+    this.assertNotEmpty(assetId, "assetId");
+    return this.get(`/hi/ugcGameVariants/${assetId}`);
+  }
+  // ─────────────────────────────────────────────────────────────────
+  // Films
+  // ─────────────────────────────────────────────────────────────────
+  /**
+   * Get a film by asset ID.
+   *
+   * @param assetId - Film asset ID
+   * @returns Film data
+   */
+  getFilm(assetId) {
+    this.assertNotEmpty(assetId, "assetId");
+    return this.get(`/hi/films/${assetId}`);
+  }
+  /**
+   * Get film asset for a match (spectate).
    *
    * @param matchId - Match GUID
    * @returns Film asset if available
    */
-  getFilmByMatchId(matchId) {
+  spectateByMatchId(matchId) {
     this.assertNotEmpty(matchId, "matchId");
     return this.get(`/hi/films/matches/${matchId}/spectate`);
   }
+  /**
+   * Get film asset for a match.
+   *
+   * @param matchId - Match GUID
+   * @returns Film asset if available
+   * @deprecated Use spectateByMatchId instead
+   */
+  getFilmByMatchId(matchId) {
+    return this.spectateByMatchId(matchId);
+  }
 };
 
 // src/clients/halo-infinite-client.ts