glitch-javascript-sdk 2.7.7 → 2.8.0

package/dist/esm/api/Games.d.ts

@@ -1,5 +1,32 @@
 import Response from "../util/Response";
 import { AxiosPromise } from "axios";
+/**
+ * Interface for the Release Stats response to help developers
+ * understand the data structure returned by the optimizer.
+ */
+export interface ReleaseStatEntry {
+    date: string;
+    count: number;
+    intensity: 'low' | 'medium' | 'high' | 'extreme';
+    is_danger_zone: boolean;
+    recommendation: string;
+    events: Array<{
+        name: string;
+        type: 'nextfest' | 'sale';
+        start: string;
+        end: string;
+    }>;
+}
+export interface ReleaseStatsResponse {
+    data: ReleaseStatEntry[];
+    meta: {
+        user_status: 'authenticated' | 'guest';
+        lookahead_days: number;
+        start_date: string;
+        end_date: string;
+        global_events: any[];
+    };
+}
 declare class Games {
     /**
      * Get a list of Games available on he platform.
@@ -47,5 +74,28 @@ declare class Games {
      * @returns promise
      */
     static createGameScheduler<T>(game_id: string, data?: object, params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /**
+    * Get release competition statistics and Steam danger zones.
+    *
+    * This tool analyzes the 'ExternalGames' database to show how many other games
+    * are releasing around a specific date. It also overlays hard-coded Steam events
+    * like NextFest and Seasonal Sales.
+    *
+    * @see https://api.glitch.fun/api/documentation#/ExternalGames/getReleaseStats
+    *
+    * @param params Filtering options:
+    *   - precision: 'day' | 'month' | 'year' (Default: 'day'). Use 'month' for long-term planning.
+    *   - start_date: 'YYYY-MM-DD'. The date to begin the analysis from.
+    *
+    * @returns AxiosPromise<Response<ReleaseStatsResponse>>
+    *
+    * @example
+    * Games.getReleaseStats({ precision: 'day', start_date: '2025-06-01' })
+    *   .then(res => console.log(res.data.data));
+    */
+    static getReleaseStats<T = ReleaseStatsResponse>(params?: {
+        precision?: 'day' | 'month' | 'year';
+        start_date?: string;
+    }): AxiosPromise<Response<T>>;
 }
 export default Games;

package/dist/esm/api/Subscriptions.d.ts

@@ -81,5 +81,11 @@ declare class Subscriptions {
     * @param data { priceId, paymentMethod, custom_name, limits: { posts, enrichments, invites, ads }, metered_prices: [] }
     */
     static createCustomCommunitySubscription<T>(community_id: string, data: object, params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /**
+     * Purchase a permanent license or rent a game title.
+     * If a rental was active in the last 7 days, the fee is automatically deducted from the premium price.
+     * @param data { purchase_type: 'premium' | 'rental', payment_method_id: string }
+     */
+    static purchaseLicense<T>(title_id: string, data: object): AxiosPromise<Response<T>>;
 }
 export default Subscriptions;

package/dist/esm/api/Titles.d.ts

@@ -475,5 +475,31 @@ declare class Titles {
      * Delete a saved behavioral funnel definition.
      */
     static deleteBehavioralFunnel<T>(title_id: string, funnel_id: string): AxiosPromise<Response<T>>;
+    /**
+    * Generates a presigned S3 URL for uploading a game build ZIP.
+    */
+    static getDeploymentUploadUrl<T>(title_id: string): AxiosPromise<Response<T>>;
+    /**
+     * Confirms the upload and starts the automated deployment/extraction process.
+     * @param data { file_path: string, version_string: string, entry_point?: string }
+     */
+    static confirmDeployment<T>(title_id: string, data: object): AxiosPromise<Response<T>>;
+    /**
+     * Initializes a play session. Handles age-gating and license verification.
+     * Returns the CDN URL for WASM/iFrame or Signaling URL for Pixel Streaming.
+     */
+    static getPlaySession<T>(title_id: string): AxiosPromise<Response<T>>;
+    /**
+     * List all developer payouts for a title.
+     */
+    static listDeveloperPayouts<T>(title_id: string, params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /**
+     * View a specific payout record.
+     */
+    static viewDeveloperPayout<T>(title_id: string, payout_id: string): AxiosPromise<Response<T>>;
+    /**
+     * Get the total earnings and playtime summary for a title.
+     */
+    static getDeveloperPayoutSummary<T>(title_id: string): AxiosPromise<Response<T>>;
 }
 export default Titles;

package/dist/esm/index.js

@@ -11693,6 +11693,14 @@ var TitlesRoute = /** @class */ (function () {
         createBehavioralFunnel: { url: '/titles/{title_id}/behavioral-funnels', method: HTTP_METHODS.POST },
         behavioralFunnelReport: { url: '/titles/{title_id}/behavioral-funnels/{funnel_id}/report', method: HTTP_METHODS.GET },
         deleteBehavioralFunnel: { url: '/titles/{title_id}/behavioral-funnels/{funnel_id}', method: HTTP_METHODS.DELETE },
+        // Aegis Deployment
+        getDeploymentUploadUrl: { url: '/titles/{title_id}/deployments/presigned-url', method: HTTP_METHODS.POST },
+        confirmDeployment: { url: '/titles/{title_id}/deployments/confirm', method: HTTP_METHODS.POST },
+        getPlaySession: { url: '/titles/{title_id}/play', method: HTTP_METHODS.GET },
+        // Aegis Payouts
+        listDeveloperPayouts: { url: '/titles/{title_id}/payouts', method: HTTP_METHODS.GET },
+        viewDeveloperPayout: { url: '/titles/{title_id}/payouts/{payout_id}', method: HTTP_METHODS.GET },
+        developerPayoutSummary: { url: '/titles/{title_id}/payouts/summary', method: HTTP_METHODS.GET },
     };
     return TitlesRoute;
 }());
@@ -12312,6 +12320,44 @@ var Titles = /** @class */ (function () {
     Titles.deleteBehavioralFunnel = function (title_id, funnel_id) {
         return Requests.processRoute(TitlesRoute.routes.deleteBehavioralFunnel, {}, { title_id: title_id, funnel_id: funnel_id });
     };
+    /**
+    * Generates a presigned S3 URL for uploading a game build ZIP.
+    */
+    Titles.getDeploymentUploadUrl = function (title_id) {
+        return Requests.processRoute(TitlesRoute.routes.getDeploymentUploadUrl, {}, { title_id: title_id });
+    };
+    /**
+     * Confirms the upload and starts the automated deployment/extraction process.
+     * @param data { file_path: string, version_string: string, entry_point?: string }
+     */
+    Titles.confirmDeployment = function (title_id, data) {
+        return Requests.processRoute(TitlesRoute.routes.confirmDeployment, data, { title_id: title_id });
+    };
+    /**
+     * Initializes a play session. Handles age-gating and license verification.
+     * Returns the CDN URL for WASM/iFrame or Signaling URL for Pixel Streaming.
+     */
+    Titles.getPlaySession = function (title_id) {
+        return Requests.processRoute(TitlesRoute.routes.getPlaySession, {}, { title_id: title_id });
+    };
+    /**
+     * List all developer payouts for a title.
+     */
+    Titles.listDeveloperPayouts = function (title_id, params) {
+        return Requests.processRoute(TitlesRoute.routes.listDeveloperPayouts, undefined, { title_id: title_id }, params);
+    };
+    /**
+     * View a specific payout record.
+     */
+    Titles.viewDeveloperPayout = function (title_id, payout_id) {
+        return Requests.processRoute(TitlesRoute.routes.viewDeveloperPayout, {}, { title_id: title_id, payout_id: payout_id });
+    };
+    /**
+     * Get the total earnings and playtime summary for a title.
+     */
+    Titles.getDeveloperPayoutSummary = function (title_id) {
+        return Requests.processRoute(TitlesRoute.routes.developerPayoutSummary, {}, { title_id: title_id });
+    };
     return Titles;
 }());
 
@@ -13355,6 +13401,7 @@ var SubscriptionsRoute = /** @class */ (function () {
             url: '/subscriptions/communities/custom/{community_id}',
             method: HTTP_METHODS.POST
         },
+        purchaseLicense: { url: '/titles/{title_id}/purchase', method: HTTP_METHODS.POST },
     };
     return SubscriptionsRoute;
 }());
@@ -13462,6 +13509,14 @@ var Subscriptions = /** @class */ (function () {
     Subscriptions.createCustomCommunitySubscription = function (community_id, data, params) {
         return Requests.processRoute(SubscriptionsRoute.routes.createCustomCommunitySubscription, data, { community_id: community_id }, params);
     };
+    /**
+     * Purchase a permanent license or rent a game title.
+     * If a rental was active in the last 7 days, the fee is automatically deducted from the premium price.
+     * @param data { purchase_type: 'premium' | 'rental', payment_method_id: string }
+     */
+    Subscriptions.purchaseLicense = function (title_id, data) {
+        return Requests.processRoute(SubscriptionsRoute.routes.purchaseLicense, data, { title_id: title_id });
+    };
     return Subscriptions;
 }());
 
@@ -13755,6 +13810,7 @@ var GamesRoutes = /** @class */ (function () {
         createCampaignWithTitle: { url: '/games/{game_id}/generateCampaignWithTitle', method: HTTP_METHODS.POST },
         createGameTitle: { url: '/games/{game_id}/generateTitle', method: HTTP_METHODS.POST },
         createGameScheduler: { url: '/games/{game_id}/generateScheduler', method: HTTP_METHODS.POST },
+        releaseStats: { url: '/games/release-stats', method: HTTP_METHODS.GET },
     };
     return GamesRoutes;
 }());
@@ -13820,6 +13876,32 @@ var Games = /** @class */ (function () {
     Games.createGameScheduler = function (game_id, data, params) {
         return Requests.processRoute(GamesRoutes.routes.createGameScheduler, data, { game_id: game_id }, params);
     };
+    /**
+    * Get release competition statistics and Steam danger zones.
+    *
+    * This tool analyzes the 'ExternalGames' database to show how many other games
+    * are releasing around a specific date. It also overlays hard-coded Steam events
+    * like NextFest and Seasonal Sales.
+    *
+    * @see https://api.glitch.fun/api/documentation#/ExternalGames/getReleaseStats
+    *
+    * @param params Filtering options:
+    *   - precision: 'day' | 'month' | 'year' (Default: 'day'). Use 'month' for long-term planning.
+    *   - start_date: 'YYYY-MM-DD'. The date to begin the analysis from.
+    *
+    * @returns AxiosPromise<Response<ReleaseStatsResponse>>
+    *
+    * @example
+    * Games.getReleaseStats({ precision: 'day', start_date: '2025-06-01' })
+    *   .then(res => console.log(res.data.data));
+    */
+    Games.getReleaseStats = function (params) {
+        // Defensive check: ensure precision is valid if provided
+        if ((params === null || params === void 0 ? void 0 : params.precision) && !['day', 'month', 'year'].includes(params.precision)) {
+            console.warn("Invalid precision '".concat(params.precision, "' passed to getReleaseStats. Defaulting to 'day'."));
+        }
+        return Requests.processRoute(GamesRoutes.routes.releaseStats, undefined, undefined, params);
+    };
     return Games;
 }());