halo-infinite-api 1.0.5 → 1.1.1

package/dist/core/halo-infinite-client.d.ts

@@ -1,11 +1,13 @@
-import { PlaylistCsrContainer } from "../models/halo-infinite/playlist-csr-container";
-import { UserInfo } from "../models/halo-infinite/user-info";
-import { ServiceRecord } from "../models/halo-infinite/service-record";
-import { Playlist } from "../models/halo-infinite/playlist";
-import { MatchType } from "../models/halo-infinite/match-type";
+import { MatchSkill } from "../models/halo-infinite/match-skill";
 import { MatchStats } from "../models/halo-infinite/match-stats";
+import { MatchType } from "../models/halo-infinite/match-type";
 import { PlayerMatchHistory } from "../models/halo-infinite/player-match-history";
-import { MatchSkill } from "../models/halo-infinite/match-skill";
+import { Playlist } from "../models/halo-infinite/playlist";
+import { PlaylistCsrContainer } from "../models/halo-infinite/playlist-csr-container";
+import { ServiceRecord } from "../models/halo-infinite/service-record";
+import { UserInfo } from "../models/halo-infinite/user-info";
+import { MapAsset, UgcGameVariantAsset } from "../models/halo-infinite/asset";
+import { AssetKind } from "../models/halo-infinite/asset-kind";
 interface ResultContainer<TValue> {
     Id: string;
     ResultCode: number;
@@ -15,6 +17,10 @@ interface TokenPersister {
     load: <T>(tokenName: string) => Promise<T>;
     save: (tokenName: string, token: unknown) => Promise<void>;
 }
+type AssetKindTypeMap = {
+    [AssetKind.Map]: MapAsset;
+    [AssetKind.UgcGameVariant]: UgcGameVariantAsset;
+};
 export declare class HaloInfiniteClient {
     private readonly haloAuthClient;
     constructor(clientId: string, redirectUri: string, getAuthCode: (authorizeUrl: string) => Promise<string>, tokenPersister?: TokenPersister);
@@ -41,5 +47,9 @@ export declare class HaloInfiniteClient {
     getPlayerMatches: (playerXuid: string, type?: MatchType, count?: number, start?: number) => Promise<PlayerMatchHistory[]>;
     getMatchStats: (matchId: string) => Promise<MatchStats<import("..").GameVariantCategory>>;
     getMatchSkill: (matchId: string, playerIds: string[]) => Promise<ResultContainer<MatchSkill>[]>;
+    /** Gets authoring metadata about a specific asset. */
+    getAsset: <TAssetType extends keyof AssetKindTypeMap>(assetType: TAssetType, assetId: string) => Promise<AssetKindTypeMap[TAssetType]>;
+    /** Gets metadata related to a concrete version of a specified asset. */
+    getSpecificAssetVersion: <TAssetType extends keyof AssetKindTypeMap>(assetType: TAssetType, assetId: string, versionId: string) => Promise<AssetKindTypeMap[TAssetType]>;
 }
 export {};

package/dist/core/halo-infinite-client.js

@@ -1,9 +1,23 @@
 import axios, { AxiosHeaders } from "axios";
-import { HaloCoreEndpoints } from "../endpoints/halo-core-endpoints";
-import { GlobalConstants } from "../util/global-contants";
-import { RelyingParty, XboxAuthenticationClient, } from "../authentication/xbox-authentication-client";
 import { HaloAuthenticationClient } from "../authentication/halo-authentication-client";
+import { RelyingParty, XboxAuthenticationClient, } from "../authentication/xbox-authentication-client";
+import { HaloCoreEndpoints } from "../endpoints/halo-core-endpoints";
 import { MatchType } from "../models/halo-infinite/match-type";
+import { GlobalConstants } from "../util/global-contants";
+import { AssetKind } from "../models/halo-infinite/asset-kind";
+const assetKindUrlMap = {
+    [AssetKind.Map]: "Maps",
+    [AssetKind.UgcGameVariant]: "UgcGameVariants",
+};
+function wrapPlayerId(playerId) {
+    if (/^\w+(\d+)/) {
+        return playerId;
+    }
+    else {
+        // Assume xuid
+        return `xuid(${playerId})`;
+    }
+}
 export class HaloInfiniteClient {
     haloAuthClient;
     constructor(clientId, redirectUri, getAuthCode, tokenPersister) {
@@ -37,7 +51,7 @@ export class HaloInfiniteClient {
             }
         });
     }
-    async executeRequest(url, method, useSpartanToken = true, useClearance = false, userAgent = GlobalConstants.HALO_WAYPOINT_USER_AGENT) {
+    async executeRequest(url, method, useSpartanToken = true, useClearance = false, userAgent = GlobalConstants.HALO_WAYPOINT_USER_AGENT, throwOn404 = true) {
         const headers = new AxiosHeaders({
             "User-Agent": userAgent,
             Accept: "application/json",
@@ -52,11 +66,12 @@ export class HaloInfiniteClient {
             url,
             method,
             headers,
+            validateStatus: (status) => status < 400 || (status === 404 && !throwOn404),
         });
         return response.data;
     }
-    async executeResultsRequest(...args) {
-        const result = await this.executeRequest(...args);
+    async executeResultsRequest(url, method, useSpartanToken = true, useClearance = false, userAgent = GlobalConstants.HALO_WAYPOINT_USER_AGENT) {
+        const result = await this.executeRequest(url, method, useSpartanToken, useClearance, userAgent, false);
         return result.Value;
     }
     async executePaginationRequest(count, start, queryParameters, ...args) {
@@ -72,7 +87,9 @@ export class HaloInfiniteClient {
      * @param playlistId - Unique ID for the playlist.
      * @param playerIds - Array of player xuids.
      */
-    getPlaylistCsr = (playlistId, playerIds) => this.executeResultsRequest(`https://${HaloCoreEndpoints.SkillOrigin}.${HaloCoreEndpoints.ServiceDomain}/hi/playlist/${playlistId}/csrs?players=xuid(${playerIds.join("),xuid(")})`, "get");
+    getPlaylistCsr = (playlistId, playerIds) => this.executeResultsRequest(`https://${HaloCoreEndpoints.SkillOrigin}.${HaloCoreEndpoints.ServiceDomain}/hi/playlist/${playlistId}/csrs?players=${playerIds
+        .map(wrapPlayerId)
+        .join(",")}`, "get");
     /** Get gamertag info for a player.
      * @param gamerTag - Gamertag to lookup.
      */
@@ -85,8 +102,20 @@ export class HaloInfiniteClient {
      * @param playlistId - Unique ID for the playlist.
      */
     getPlaylist = (playlistId) => this.executeRequest(`https://${HaloCoreEndpoints.GameCmsOrigin}.${HaloCoreEndpoints.ServiceDomain}/hi/multiplayer/file/playlists/assets/${playlistId}.json`, "get");
-    getPlayerMatches = (playerXuid, type = MatchType.All, count = 25, start = 0) => this.executePaginationRequest(count, start, { type: type.toString() }, `https://${HaloCoreEndpoints.StatsOrigin}.${HaloCoreEndpoints.ServiceDomain}/hi/players/xuid(${playerXuid})/matches`, "get");
+    getPlayerMatches = (playerXuid, type = MatchType.All, count = 25, start = 0) => {
+        let params = {};
+        if (type !== MatchType.All) {
+            params.type = type.toString();
+        }
+        return this.executePaginationRequest(count, start, params, `https://${HaloCoreEndpoints.StatsOrigin}.${HaloCoreEndpoints.ServiceDomain}/hi/players/xuid(${wrapPlayerId(playerXuid)})/matches`, "get");
+    };
     getMatchStats = (matchId) => this.executeRequest(`https://${HaloCoreEndpoints.StatsOrigin}.${HaloCoreEndpoints.ServiceDomain}/hi/matches/${matchId}/stats`, "get");
-    getMatchSkill = (matchId, playerIds) => this.executeResultsRequest(`https://${HaloCoreEndpoints.SkillOrigin}.${HaloCoreEndpoints.ServiceDomain}/hi/matches/${matchId}/skill?players=xuid(${playerIds.join("),xuid(")})`, "get");
+    getMatchSkill = (matchId, playerIds) => this.executeResultsRequest(`https://${HaloCoreEndpoints.SkillOrigin}.${HaloCoreEndpoints.ServiceDomain}/hi/matches/${matchId}/skill?players=${playerIds
+        .map(wrapPlayerId)
+        .join(",")}`, "get");
+    /** Gets authoring metadata about a specific asset. */
+    getAsset = (assetType, assetId) => this.executeRequest(`https://${HaloCoreEndpoints.DiscoveryOrigin}.${HaloCoreEndpoints.ServiceDomain}/hi/${assetKindUrlMap[assetType]}/${assetId}`, "get");
+    /** Gets metadata related to a concrete version of a specified asset. */
+    getSpecificAssetVersion = (assetType, assetId, versionId) => this.executeRequest(`https://${HaloCoreEndpoints.DiscoveryOrigin}.${HaloCoreEndpoints.ServiceDomain}/hi/${assetKindUrlMap[assetType]}/${assetId}/versions/${versionId}`, "get");
 }
 //# sourceMappingURL=halo-infinite-client.js.map

package/dist/core/halo-infinite-client.js.map

@@ -1 +1 @@
-{"version":3,"file":"halo-infinite-client.js","sourceRoot":"","sources":["../../src/core/halo-infinite-client.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"halo-infinite-client.js","sourceRoot":"","sources":["../../src/core/halo-infinite-client.ts"],"names":[],"mappings":"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"}

package/dist/endpoints/halo-core-endpoints.d.ts

@@ -9,6 +9,8 @@ export declare const HaloCoreEndpoints: {
     StatsOrigin: string;
     /** Game CMS origin */
     GameCmsOrigin: string;
+    /** Discovery origin */
+    DiscoveryOrigin: string;
     /** Service domain */
     ServiceDomain: string;
 };

package/dist/endpoints/halo-core-endpoints.js

@@ -9,6 +9,8 @@ export const HaloCoreEndpoints = {
     StatsOrigin: "halostats",
     /** Game CMS origin */
     GameCmsOrigin: "gamecms-hacs",
+    /** Discovery origin */
+    DiscoveryOrigin: "discovery-infiniteugc",
     /** Service domain */
     ServiceDomain: "svc.halowaypoint.com:443",
 };

package/dist/endpoints/halo-core-endpoints.js.map

@@ -1 +1 @@
-{"version":3,"file":"halo-core-endpoints.js","sourceRoot":"","sources":["../../src/endpoints/halo-core-endpoints.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,kDAAkD;IAClD,oBAAoB,EAAE,qDAAqD;IAE3E,mBAAmB;IACnB,WAAW,EAAE,OAAO;IACpB,qBAAqB;IACrB,OAAO,EAAE,SAAS;IAClB,mBAAmB;IACnB,WAAW,EAAE,WAAW;IACxB,sBAAsB;IACtB,aAAa,EAAE,cAAc;IAE7B,qBAAqB;IACrB,aAAa,EAAE,0BAA0B;CAC1C,CAAC"}
+{"version":3,"file":"halo-core-endpoints.js","sourceRoot":"","sources":["../../src/endpoints/halo-core-endpoints.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,kDAAkD;IAClD,oBAAoB,EAAE,qDAAqD;IAE3E,mBAAmB;IACnB,WAAW,EAAE,OAAO;IACpB,qBAAqB;IACrB,OAAO,EAAE,SAAS;IAClB,mBAAmB;IACnB,WAAW,EAAE,WAAW;IACxB,sBAAsB;IACtB,aAAa,EAAE,cAAc;IAC7B,uBAAuB;IACvB,eAAe,EAAE,uBAAuB;IAExC,qBAAqB;IACrB,aAAa,EAAE,0BAA0B;CAC1C,CAAC"}

package/dist/index.d.ts

@@ -8,3 +8,5 @@ export { GameVariantCategory } from "./models/halo-infinite/game-variant-categor
 export { MatchStats } from "./models/halo-infinite/match-stats";
 export { PlayerMatchHistory } from "./models/halo-infinite/player-match-history";
 export { Stats } from "./models/halo-infinite/stats";
+export { MapAsset, UgcGameVariantAsset } from "./models/halo-infinite/asset";
+export { AssetKind } from "./models/halo-infinite/asset-kind";

package/dist/index.js

@@ -1,4 +1,5 @@
 export { HaloInfiniteClient } from "./core/halo-infinite-client";
 export { MatchType } from "./models/halo-infinite/match-type";
 export { GameVariantCategory } from "./models/halo-infinite/game-variant-category";
+export { AssetKind } from "./models/halo-infinite/asset-kind";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAKjE,OAAO,EAAE,SAAS,EAAE,MAAM,mCAAmC,CAAC;AAC9D,OAAO,EAAE,mBAAmB,EAAE,MAAM,8CAA8C,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAKjE,OAAO,EAAE,SAAS,EAAE,MAAM,mCAAmC,CAAC;AAC9D,OAAO,EAAE,mBAAmB,EAAE,MAAM,8CAA8C,CAAC;AAKnF,OAAO,EAAE,SAAS,EAAE,MAAM,mCAAmC,CAAC"}

package/dist/models/halo-infinite/api-formatted-date.d.ts

@@ -0,0 +1,3 @@
+export interface ApiFormattedDate {
+    ISO8601Date: string;
+}

package/dist/models/halo-infinite/api-formatted-date.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=api-formatted-date.js.map

package/dist/models/halo-infinite/api-formatted-date.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-formatted-date.js","sourceRoot":"","sources":["../../../src/models/halo-infinite/api-formatted-date.ts"],"names":[],"mappings":""}

package/dist/models/halo-infinite/asset-kind.d.ts

@@ -0,0 +1,12 @@
+export declare enum AssetKind {
+    Film = 0,
+    Map = 1,
+    Playlist = 2,
+    Prefab = 3,
+    TestAsset = 4,
+    UgcGameVariant = 5,
+    MapModePair = 6,
+    Project = 7,
+    Manifest = 8,
+    EngineGameVariant = 9
+}

package/dist/models/halo-infinite/asset-kind.js

@@ -0,0 +1,14 @@
+export var AssetKind;
+(function (AssetKind) {
+    AssetKind[AssetKind["Film"] = 0] = "Film";
+    AssetKind[AssetKind["Map"] = 1] = "Map";
+    AssetKind[AssetKind["Playlist"] = 2] = "Playlist";
+    AssetKind[AssetKind["Prefab"] = 3] = "Prefab";
+    AssetKind[AssetKind["TestAsset"] = 4] = "TestAsset";
+    AssetKind[AssetKind["UgcGameVariant"] = 5] = "UgcGameVariant";
+    AssetKind[AssetKind["MapModePair"] = 6] = "MapModePair";
+    AssetKind[AssetKind["Project"] = 7] = "Project";
+    AssetKind[AssetKind["Manifest"] = 8] = "Manifest";
+    AssetKind[AssetKind["EngineGameVariant"] = 9] = "EngineGameVariant";
+})(AssetKind || (AssetKind = {}));
+//# sourceMappingURL=asset-kind.js.map

package/dist/models/halo-infinite/asset-kind.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset-kind.js","sourceRoot":"","sources":["../../../src/models/halo-infinite/asset-kind.ts"],"names":[],"mappings":"AAAA,MAAM,CAAN,IAAY,SAWX;AAXD,WAAY,SAAS;IACnB,yCAAI,CAAA;IACJ,uCAAG,CAAA;IACH,iDAAQ,CAAA;IACR,6CAAM,CAAA;IACN,mDAAS,CAAA;IACT,6DAAc,CAAA;IACd,uDAAW,CAAA;IACX,+CAAO,CAAA;IACP,iDAAQ,CAAA;IACR,mEAAiB,CAAA;AACnB,CAAC,EAXW,SAAS,KAAT,SAAS,QAWpB"}

package/dist/models/halo-infinite/asset-version-link.d.ts

@@ -0,0 +1,6 @@
+import { AssetKind } from "./asset-kind";
+export interface AssetVersionLink {
+    AssetKind: AssetKind;
+    AssetId: string;
+    VersionId: string;
+}

package/dist/models/halo-infinite/asset-version-link.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=asset-version-link.js.map

package/dist/models/halo-infinite/asset-version-link.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset-version-link.js","sourceRoot":"","sources":["../../../src/models/halo-infinite/asset-version-link.ts"],"names":[],"mappings":""}

package/dist/models/halo-infinite/asset.d.ts

@@ -0,0 +1,56 @@
+import { ApiFormattedDate } from "./api-formatted-date";
+export interface Asset {
+    Tags: string[];
+    AssetId: string;
+    VersionId: string;
+    PublicName: string;
+    Description: string;
+    Files: {
+        Prefix: string;
+        FileRelativePaths: string[];
+        PrefixEndpoint: {
+            AuthorityId: string;
+            Path: string;
+            QueryString: any;
+            RetryPolicyId: string;
+            TopicName: string;
+            AcknowledgementTypeId: number;
+            AuthenticationLifetimeExtensionSupported: boolean;
+            ClearanceAware: boolean;
+        };
+    };
+    Contributors: string[];
+    AssetHome: number;
+    AssetStats: {
+        PlaysRecent: number;
+        PlaysAllTime: number;
+        Favorites: number;
+        Likes: number;
+        Bookmarks: number;
+        ParentAssetCount: number;
+        AverageRating: number;
+        NumberOfRatings: number;
+    };
+    InspectionResult: number;
+    CloneBehavior: number;
+    Order: number;
+    PublishedDate: ApiFormattedDate;
+    VersionNumber: number;
+    Admin: string;
+}
+export interface MapAsset extends Asset {
+    CustomData: {
+        NumOfObjectsOnMap: number;
+        TagLevelId: number;
+        IsBaked: boolean;
+        HasNodeGraph: boolean;
+    };
+    PrefabLinks: unknown[];
+}
+export interface UgcGameVariantAsset extends Asset {
+    CustomData: {
+        KeyValues: object;
+        HasNodeGraph: boolean;
+    };
+    EngineGameVariantLink?: Asset;
+}

package/dist/models/halo-infinite/asset.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=asset.js.map

package/dist/models/halo-infinite/asset.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset.js","sourceRoot":"","sources":["../../../src/models/halo-infinite/asset.ts"],"names":[],"mappings":""}

package/dist/models/halo-infinite/authoring-asset.d.ts

@@ -0,0 +1,56 @@
+import { ApiFormattedDate } from "./api-formatted-date";
+export interface Asset {
+    Tags: string[];
+    AssetId: string;
+    VersionId: string;
+    PublicName: string;
+    Description: string;
+    Files: {
+        Prefix: string;
+        FileRelativePaths: string[];
+        PrefixEndpoint: {
+            AuthorityId: string;
+            Path: string;
+            QueryString: any;
+            RetryPolicyId: string;
+            TopicName: string;
+            AcknowledgementTypeId: number;
+            AuthenticationLifetimeExtensionSupported: boolean;
+            ClearanceAware: boolean;
+        };
+    };
+    Contributors: string[];
+    AssetHome: number;
+    AssetStats: {
+        PlaysRecent: number;
+        PlaysAllTime: number;
+        Favorites: number;
+        Likes: number;
+        Bookmarks: number;
+        ParentAssetCount: number;
+        AverageRating: number;
+        NumberOfRatings: number;
+    };
+    InspectionResult: number;
+    CloneBehavior: number;
+    Order: number;
+    PublishedDate: ApiFormattedDate;
+    VersionNumber: number;
+    Admin: string;
+}
+export interface MapAsset extends Asset {
+    CustomData: {
+        NumOfObjectsOnMap: number;
+        TagLevelId: number;
+        IsBaked: boolean;
+        HasNodeGraph: boolean;
+    };
+    PrefabLinks: unknown[];
+}
+export interface UcgGameVariantAsset extends Asset {
+    CustomData: {
+        KeyValues: object;
+        HasNodeGraph: boolean;
+    };
+    EngineGameVariantLink?: Asset;
+}

package/dist/models/halo-infinite/authoring-asset.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=authoring-asset.js.map

package/dist/models/halo-infinite/authoring-asset.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"authoring-asset.js","sourceRoot":"","sources":["../../../src/models/halo-infinite/authoring-asset.ts"],"names":[],"mappings":""}

package/dist/models/halo-infinite/match-info.d.ts

@@ -1,3 +1,4 @@
+import { AssetVersionLink } from "./asset-version-link";
 import { GameVariantCategory } from "./game-variant-category";
 import { PlaylistExperience } from "./playlist-experience";
 export interface MatchInfo<TCategory extends GameVariantCategory = GameVariantCategory> {
@@ -7,28 +8,12 @@ export interface MatchInfo<TCategory extends GameVariantCategory = GameVariantCa
     LifecycleMode: number;
     GameVariantCategory: TCategory;
     LevelId: string;
-    MapVariant: {
-        AssetKind: number;
-        AssetId: string;
-        VersionId: string;
-    };
-    UgcGameVariant: {
-        AssetKind: number;
-        AssetId: string;
-        VersionId: string;
-    };
+    MapVariant: AssetVersionLink;
+    UgcGameVariant: AssetVersionLink;
     ClearanceId: string;
-    Playlist: {
-        AssetKind: number;
-        AssetId: string;
-        VersionId: string;
-    };
+    Playlist: AssetVersionLink;
     PlaylistExperience: PlaylistExperience;
-    PlaylistMapModePair: {
-        AssetKind: number;
-        AssetId: string;
-        VersionId: string;
-    };
+    PlaylistMapModePair: AssetVersionLink;
     SeasonId: string;
     PlayableDuration: string;
     TeamsEnabled: boolean;

package/dist/models/halo-infinite/match-outcome.d.ts

@@ -1,4 +1,6 @@
 export declare enum MatchOutcome {
+    Tie = 1,
     Win = 2,
-    Loss = 3
+    Loss = 3,
+    DidNotFinish = 4
 }

package/dist/models/halo-infinite/match-outcome.js

@@ -1,6 +1,8 @@
 export var MatchOutcome;
 (function (MatchOutcome) {
+    MatchOutcome[MatchOutcome["Tie"] = 1] = "Tie";
     MatchOutcome[MatchOutcome["Win"] = 2] = "Win";
     MatchOutcome[MatchOutcome["Loss"] = 3] = "Loss";
+    MatchOutcome[MatchOutcome["DidNotFinish"] = 4] = "DidNotFinish";
 })(MatchOutcome || (MatchOutcome = {}));
 //# sourceMappingURL=match-outcome.js.map

package/dist/models/halo-infinite/match-outcome.js.map

@@ -1 +1 @@
-{"version":3,"file":"match-outcome.js","sourceRoot":"","sources":["../../../src/models/halo-infinite/match-outcome.ts"],"names":[],"mappings":"AAAA,MAAM,CAAN,IAAY,YAGX;AAHD,WAAY,YAAY;IACtB,6CAAO,CAAA;IACP,+CAAQ,CAAA;AACV,CAAC,EAHW,YAAY,KAAZ,YAAY,QAGvB"}
+{"version":3,"file":"match-outcome.js","sourceRoot":"","sources":["../../../src/models/halo-infinite/match-outcome.ts"],"names":[],"mappings":"AAAA,MAAM,CAAN,IAAY,YAKX;AALD,WAAY,YAAY;IACtB,6CAAO,CAAA;IACP,6CAAO,CAAA;IACP,+CAAQ,CAAA;IACR,+DAAgB,CAAA;AAClB,CAAC,EALW,YAAY,KAAZ,YAAY,QAKvB"}

package/dist/models/halo-infinite/match-skill.d.ts

@@ -32,7 +32,7 @@ export interface MatchSkill {
         Deaths: StatPerformance;
     };
     Counterfactuals: {
-        SelfCounterfactual: Counterfactual;
+        SelfCounterfactuals: Counterfactual;
         TierCounterfactuals: {
             Bronze: Counterfactual;
             Silver: Counterfactual;

package/dist/models/spartan-token.d.ts

@@ -1,7 +1,6 @@
+import { ApiFormattedDate } from "./halo-infinite/api-formatted-date";
 export interface SpartanToken {
     SpartanToken: string;
-    ExpiresUtc: {
-        ISO8601Date: string;
-    };
+    ExpiresUtc: ApiFormattedDate;
     TokenDuration: string;
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "halo-infinite-api",
   "type": "module",
-  "version": "1.0.5",
+  "version": "1.1.1",
   "description": "An NPM package for accessing the official Halo Infinite API.",
   "main": "dist/index.js",
   "scripts": {

package/src/core/halo-infinite-client.ts

@@ -1,21 +1,21 @@
-import axios, { AxiosHeaders } from "axios";
-import { HaloCoreEndpoints } from "../endpoints/halo-core-endpoints";
-import { Method } from "axios";
-import { PlaylistCsrContainer } from "../models/halo-infinite/playlist-csr-container";
-import { GlobalConstants } from "../util/global-contants";
-import { UserInfo } from "../models/halo-infinite/user-info";
-import { ServiceRecord } from "../models/halo-infinite/service-record";
+import axios, { AxiosHeaders, Method } from "axios";
+import { HaloAuthenticationClient } from "../authentication/halo-authentication-client";
 import {
   RelyingParty,
   XboxAuthenticationClient,
-  XboxAuthenticationToken,
 } from "../authentication/xbox-authentication-client";
-import { HaloAuthenticationClient } from "../authentication/halo-authentication-client";
-import { Playlist } from "../models/halo-infinite/playlist";
-import { MatchType } from "../models/halo-infinite/match-type";
+import { HaloCoreEndpoints } from "../endpoints/halo-core-endpoints";
+import { MatchSkill } from "../models/halo-infinite/match-skill";
 import { MatchStats } from "../models/halo-infinite/match-stats";
+import { MatchType } from "../models/halo-infinite/match-type";
 import { PlayerMatchHistory } from "../models/halo-infinite/player-match-history";
-import { MatchSkill } from "../models/halo-infinite/match-skill";
+import { Playlist } from "../models/halo-infinite/playlist";
+import { PlaylistCsrContainer } from "../models/halo-infinite/playlist-csr-container";
+import { ServiceRecord } from "../models/halo-infinite/service-record";
+import { UserInfo } from "../models/halo-infinite/user-info";
+import { GlobalConstants } from "../util/global-contants";
+import { MapAsset, UgcGameVariantAsset } from "../models/halo-infinite/asset";
+import { AssetKind } from "../models/halo-infinite/asset-kind";
 
 interface ResultContainer<TValue> {
   Id: string;
@@ -39,6 +39,27 @@ interface TokenPersister {
   save: (tokenName: string, token: unknown) => Promise<void>;
 }
 
+type AssetKindTypeMap = {
+  [AssetKind.Map]: MapAsset;
+  [AssetKind.UgcGameVariant]: UgcGameVariantAsset;
+};
+
+const assetKindUrlMap = {
+  [AssetKind.Map]: "Maps",
+  [AssetKind.UgcGameVariant]: "UgcGameVariants",
+} satisfies {
+  [key in keyof AssetKindTypeMap]: string;
+};
+
+function wrapPlayerId(playerId: string) {
+  if (/^\w+(\d+)/) {
+    return playerId;
+  } else {
+    // Assume xuid
+    return `xuid(${playerId})`;
+  }
+}
+
 export class HaloInfiniteClient {
   private readonly haloAuthClient: HaloAuthenticationClient;
 
@@ -95,7 +116,8 @@ export class HaloInfiniteClient {
     method: Method,
     useSpartanToken = true,
     useClearance = false,
-    userAgent: string = GlobalConstants.HALO_WAYPOINT_USER_AGENT
+    userAgent: string = GlobalConstants.HALO_WAYPOINT_USER_AGENT,
+    throwOn404: boolean = true
   ) {
     const headers = new AxiosHeaders({
       "User-Agent": userAgent,
@@ -117,15 +139,28 @@ export class HaloInfiniteClient {
       url,
       method,
       headers,
+      validateStatus: (status) =>
+        status < 400 || (status === 404 && !throwOn404),
     });
 
     return response.data;
   }
 
   private async executeResultsRequest<T>(
-    ...args: Parameters<HaloInfiniteClient["executeRequest"]>
+    url: string,
+    method: Method,
+    useSpartanToken = true,
+    useClearance = false,
+    userAgent: string = GlobalConstants.HALO_WAYPOINT_USER_AGENT
   ) {
-    const result = await this.executeRequest<ResultsContainer<T>>(...args);
+    const result = await this.executeRequest<ResultsContainer<T>>(
+      url,
+      method,
+      useSpartanToken,
+      useClearance,
+      userAgent,
+      false
+    );
 
     return result.Value;
   }
@@ -157,9 +192,9 @@ export class HaloInfiniteClient {
     this.executeResultsRequest<PlaylistCsrContainer>(
       `https://${HaloCoreEndpoints.SkillOrigin}.${
         HaloCoreEndpoints.ServiceDomain
-      }/hi/playlist/${playlistId}/csrs?players=xuid(${playerIds.join(
-        "),xuid("
-      )})`,
+      }/hi/playlist/${playlistId}/csrs?players=${playerIds
+        .map(wrapPlayerId)
+        .join(",")}`,
       "get"
     );
 
@@ -195,14 +230,21 @@ export class HaloInfiniteClient {
     type: MatchType = MatchType.All,
     count: number = 25,
     start: number = 0
-  ) =>
-    this.executePaginationRequest<PlayerMatchHistory>(
+  ) => {
+    let params: Record<string, string> = {};
+    if (type !== MatchType.All) {
+      params.type = type.toString();
+    }
+    return this.executePaginationRequest<PlayerMatchHistory>(
       count,
       start,
-      { type: type.toString() },
-      `https://${HaloCoreEndpoints.StatsOrigin}.${HaloCoreEndpoints.ServiceDomain}/hi/players/xuid(${playerXuid})/matches`,
+      params,
+      `https://${HaloCoreEndpoints.StatsOrigin}.${
+        HaloCoreEndpoints.ServiceDomain
+      }/hi/players/xuid(${wrapPlayerId(playerXuid)})/matches`,
       "get"
     );
+  };
 
   public getMatchStats = (matchId: string) =>
     this.executeRequest<MatchStats>(
@@ -214,7 +256,30 @@ export class HaloInfiniteClient {
     this.executeResultsRequest<MatchSkill>(
       `https://${HaloCoreEndpoints.SkillOrigin}.${
         HaloCoreEndpoints.ServiceDomain
-      }/hi/matches/${matchId}/skill?players=xuid(${playerIds.join("),xuid(")})`,
+      }/hi/matches/${matchId}/skill?players=${playerIds
+        .map(wrapPlayerId)
+        .join(",")}`,
+      "get"
+    );
+
+  /** Gets authoring metadata about a specific asset. */
+  public getAsset = <TAssetType extends keyof AssetKindTypeMap>(
+    assetType: TAssetType,
+    assetId: string
+  ) =>
+    this.executeRequest<AssetKindTypeMap[TAssetType]>(
+      `https://${HaloCoreEndpoints.DiscoveryOrigin}.${HaloCoreEndpoints.ServiceDomain}/hi/${assetKindUrlMap[assetType]}/${assetId}`,
+      "get"
+    );
+
+  /** Gets metadata related to a concrete version of a specified asset. */
+  public getSpecificAssetVersion = <TAssetType extends keyof AssetKindTypeMap>(
+    assetType: TAssetType,
+    assetId: string,
+    versionId: string
+  ) =>
+    this.executeRequest<AssetKindTypeMap[TAssetType]>(
+      `https://${HaloCoreEndpoints.DiscoveryOrigin}.${HaloCoreEndpoints.ServiceDomain}/hi/${assetKindUrlMap[assetType]}/${assetId}/versions/${versionId}`,
       "get"
     );
 }

package/src/endpoints/halo-core-endpoints.ts

@@ -10,6 +10,8 @@ export const HaloCoreEndpoints = {
   StatsOrigin: "halostats",
   /** Game CMS origin */
   GameCmsOrigin: "gamecms-hacs",
+  /** Discovery origin */
+  DiscoveryOrigin: "discovery-infiniteugc",
 
   /** Service domain */
   ServiceDomain: "svc.halowaypoint.com:443",

package/src/index.ts

@@ -8,3 +8,5 @@ export { GameVariantCategory } from "./models/halo-infinite/game-variant-categor
 export { MatchStats } from "./models/halo-infinite/match-stats";
 export { PlayerMatchHistory } from "./models/halo-infinite/player-match-history";
 export { Stats } from "./models/halo-infinite/stats";
+export { MapAsset, UgcGameVariantAsset } from "./models/halo-infinite/asset";
+export { AssetKind } from "./models/halo-infinite/asset-kind";

package/src/models/halo-infinite/api-formatted-date.ts

@@ -0,0 +1,3 @@
+export interface ApiFormattedDate {
+  ISO8601Date: string;
+}

package/src/models/halo-infinite/asset-kind.ts

@@ -0,0 +1,12 @@
+export enum AssetKind {
+  Film,
+  Map,
+  Playlist,
+  Prefab,
+  TestAsset,
+  UgcGameVariant,
+  MapModePair,
+  Project,
+  Manifest,
+  EngineGameVariant,
+}

package/src/models/halo-infinite/asset-version-link.ts

@@ -0,0 +1,7 @@
+import { AssetKind } from "./asset-kind";
+
+export interface AssetVersionLink {
+  AssetKind: AssetKind;
+  AssetId: string;
+  VersionId: string;
+}

package/src/models/halo-infinite/asset.ts

@@ -0,0 +1,59 @@
+import { ApiFormattedDate } from "./api-formatted-date";
+
+export interface Asset {
+  Tags: string[];
+  AssetId: string;
+  VersionId: string;
+  PublicName: string;
+  Description: string;
+  Files: {
+    Prefix: string;
+    FileRelativePaths: string[];
+    PrefixEndpoint: {
+      AuthorityId: string;
+      Path: string;
+      QueryString: any;
+      RetryPolicyId: string;
+      TopicName: string;
+      AcknowledgementTypeId: number;
+      AuthenticationLifetimeExtensionSupported: boolean;
+      ClearanceAware: boolean;
+    };
+  };
+  Contributors: string[];
+  AssetHome: number;
+  AssetStats: {
+    PlaysRecent: number;
+    PlaysAllTime: number;
+    Favorites: number;
+    Likes: number;
+    Bookmarks: number;
+    ParentAssetCount: number;
+    AverageRating: number;
+    NumberOfRatings: number;
+  };
+  InspectionResult: number;
+  CloneBehavior: number;
+  Order: number;
+  PublishedDate: ApiFormattedDate;
+  VersionNumber: number;
+  Admin: string;
+}
+
+export interface MapAsset extends Asset {
+  CustomData: {
+    NumOfObjectsOnMap: number;
+    TagLevelId: number;
+    IsBaked: boolean;
+    HasNodeGraph: boolean;
+  };
+  PrefabLinks: unknown[];
+}
+
+export interface UgcGameVariantAsset extends Asset {
+  CustomData: {
+    KeyValues: object;
+    HasNodeGraph: boolean;
+  };
+  EngineGameVariantLink?: Asset;
+}

package/src/models/halo-infinite/match-info.ts

@@ -1,3 +1,4 @@
+import { AssetVersionLink } from "./asset-version-link";
 import { GameVariantCategory } from "./game-variant-category";
 import { PlaylistExperience } from "./playlist-experience";
 export interface MatchInfo<
@@ -9,28 +10,12 @@ export interface MatchInfo<
   LifecycleMode: number;
   GameVariantCategory: TCategory;
   LevelId: string;
-  MapVariant: {
-    AssetKind: number;
-    AssetId: string;
-    VersionId: string;
-  };
-  UgcGameVariant: {
-    AssetKind: number;
-    AssetId: string;
-    VersionId: string;
-  };
+  MapVariant: AssetVersionLink;
+  UgcGameVariant: AssetVersionLink;
   ClearanceId: string;
-  Playlist: {
-    AssetKind: number;
-    AssetId: string;
-    VersionId: string;
-  };
+  Playlist: AssetVersionLink;
   PlaylistExperience: PlaylistExperience;
-  PlaylistMapModePair: {
-    AssetKind: number;
-    AssetId: string;
-    VersionId: string;
-  };
+  PlaylistMapModePair: AssetVersionLink;
   SeasonId: string;
   PlayableDuration: string;
   TeamsEnabled: boolean;

package/src/models/halo-infinite/match-outcome.ts

@@ -1,4 +1,6 @@
 export enum MatchOutcome {
+  Tie = 1,
   Win = 2,
   Loss = 3,
+  DidNotFinish = 4,
 }

package/src/models/halo-infinite/match-skill.ts

@@ -35,7 +35,7 @@ export interface MatchSkill {
     Deaths: StatPerformance;
   };
   Counterfactuals: {
-    SelfCounterfactual: Counterfactual;
+    SelfCounterfactuals: Counterfactual;
     TierCounterfactuals: {
       Bronze: Counterfactual;
       Silver: Counterfactual;

package/src/models/spartan-token.ts

@@ -1,5 +1,7 @@
+import { ApiFormattedDate } from "./halo-infinite/api-formatted-date";
+
 export interface SpartanToken {
   SpartanToken: string;
-  ExpiresUtc: { ISO8601Date: string };
+  ExpiresUtc: ApiFormattedDate;
   TokenDuration: string;
 }