glitch-javascript-sdk 2.7.7 → 2.8.0

package/dist/index.d.ts

@@ -4263,6 +4263,32 @@ 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>>;
 }
 
 declare class Campaigns {
@@ -5117,6 +5143,12 @@ 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>>;
 }
 
 declare class Messages {
@@ -5303,6 +5335,33 @@ declare class Influencers {
     static workbook<T>(data?: object, params?: Record<string, any>): AxiosPromise<Response<T>>;
 }
 
+/**
+ * Interface for the Release Stats response to help developers
+ * understand the data structure returned by the optimizer.
+ */
+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;
+    }>;
+}
+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.
@@ -5350,6 +5409,29 @@ 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>>;
 }
 
 declare class Publications {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "glitch-javascript-sdk",
-  "version": "2.7.7",
+  "version": "2.8.0",
   "description": "Javascript SDK for Glitch",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",

package/src/api/Games.ts

@@ -3,6 +3,35 @@ import Requests from "../util/Requests";
 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[];
+    };
+}
+
 class Games {
 
     /**
@@ -12,7 +41,7 @@ class Games {
      * 
      * @returns promise
      */
-    public static listGames<T>(params?: Record<string, any>) :  AxiosPromise<Response<T>> {
+    public static listGames<T>(params?: Record<string, any>): AxiosPromise<Response<T>> {
         return Requests.processRoute(GamesRoutes.routes.listGames, undefined, undefined, params);
     }
 
@@ -23,8 +52,8 @@ class Games {
      * 
      * @returns promise
      */
-    public static viewGame<T>(game_id : string, params?: Record<string, any>) :  AxiosPromise<Response<T>> {
-        return Requests.processRoute(GamesRoutes.routes.viewGame, undefined, {game_id : game_id}, params);
+    public static viewGame<T>(game_id: string, params?: Record<string, any>): AxiosPromise<Response<T>> {
+        return Requests.processRoute(GamesRoutes.routes.viewGame, undefined, { game_id: game_id }, params);
     }
 
     /**
@@ -34,8 +63,8 @@ class Games {
      * 
      * @returns promise
      */
-    public static createCampaignData<T>(game_id : string, data?: object, params?: Record<string, any>) :  AxiosPromise<Response<T>> {
-        return Requests.processRoute(GamesRoutes.routes.createCampaignData, data, {game_id : game_id}, params);
+    public static createCampaignData<T>(game_id: string, data?: object, params?: Record<string, any>): AxiosPromise<Response<T>> {
+        return Requests.processRoute(GamesRoutes.routes.createCampaignData, data, { game_id: game_id }, params);
     }
 
     /**
@@ -43,8 +72,8 @@ class Games {
      * 
      * @returns promise
      */
-    public static createCampaignWithTitle<T>(game_id : string, data?: object, params?: Record<string, any>) :  AxiosPromise<Response<T>> {
-        return Requests.processRoute(GamesRoutes.routes.createCampaignWithTitle, data, {game_id : game_id}, params);
+    public static createCampaignWithTitle<T>(game_id: string, data?: object, params?: Record<string, any>): AxiosPromise<Response<T>> {
+        return Requests.processRoute(GamesRoutes.routes.createCampaignWithTitle, data, { game_id: game_id }, params);
     }
 
     /**
@@ -54,8 +83,8 @@ class Games {
      * 
      * @returns promise
      */
-    public static createGameTitle<T>(game_id : string, data?: object, params?: Record<string, any>) :  AxiosPromise<Response<T>> {
-        return Requests.processRoute(GamesRoutes.routes.createGameTitle, data, {game_id : game_id}, params);
+    public static createGameTitle<T>(game_id: string, data?: object, params?: Record<string, any>): AxiosPromise<Response<T>> {
+        return Requests.processRoute(GamesRoutes.routes.createGameTitle, data, { game_id: game_id }, params);
     }
 
     /**
@@ -65,8 +94,45 @@ class Games {
      * 
      * @returns promise
      */
-    public static createGameScheduler<T>(game_id : string, data?: object, params?: Record<string, any>) :  AxiosPromise<Response<T>> {
-        return Requests.processRoute(GamesRoutes.routes.createGameScheduler, data, {game_id : game_id}, params);
+    public static createGameScheduler<T>(game_id: string, data?: object, params?: Record<string, any>): AxiosPromise<Response<T>> {
+        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));
+    */
+    public static getReleaseStats<T = ReleaseStatsResponse>(params?: {
+        precision?: 'day' | 'month' | 'year',
+        start_date?: string
+    }): AxiosPromise<Response<T>> {
+
+        // Defensive check: ensure precision is valid if provided
+        if (params?.precision && !['day', 'month', 'year'].includes(params.precision)) {
+            console.warn(`Invalid precision '${params.precision}' passed to getReleaseStats. Defaulting to 'day'.`);
+        }
+
+        return Requests.processRoute(
+            GamesRoutes.routes.releaseStats,
+            undefined,
+            undefined,
+            params
+        );
     }
 
 }

package/src/api/Subscriptions.ts

@@ -115,6 +115,15 @@ class Subscriptions {
         return Requests.processRoute(SubscriptionsRoute.routes.createCustomCommunitySubscription, data, { 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 }
+     */
+    public static purchaseLicense<T>(title_id: string, data: object): AxiosPromise<Response<T>> {
+        return Requests.processRoute(SubscriptionsRoute.routes.purchaseLicense, data, { title_id });
+    }
+
 
 }
 

package/src/api/Titles.ts

@@ -932,6 +932,50 @@ class Titles {
     public static deleteBehavioralFunnel<T>(title_id: string, funnel_id: string): AxiosPromise<Response<T>> {
         return Requests.processRoute(TitlesRoute.routes.deleteBehavioralFunnel, {}, { title_id, funnel_id });
     }
+
+     /**
+     * Generates a presigned S3 URL for uploading a game build ZIP.
+     */
+    public static getDeploymentUploadUrl<T>(title_id: string): AxiosPromise<Response<T>> {
+        return Requests.processRoute(TitlesRoute.routes.getDeploymentUploadUrl, {}, { title_id });
+    }
+
+    /**
+     * Confirms the upload and starts the automated deployment/extraction process.
+     * @param data { file_path: string, version_string: string, entry_point?: string }
+     */
+    public static confirmDeployment<T>(title_id: string, data: object): AxiosPromise<Response<T>> {
+        return Requests.processRoute(TitlesRoute.routes.confirmDeployment, data, { 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.
+     */
+    public static getPlaySession<T>(title_id: string): AxiosPromise<Response<T>> {
+        return Requests.processRoute(TitlesRoute.routes.getPlaySession, {}, { title_id });
+    }
+
+    /**
+     * List all developer payouts for a title.
+     */
+    public static listDeveloperPayouts<T>(title_id: string, params?: Record<string, any>): AxiosPromise<Response<T>> {
+        return Requests.processRoute(TitlesRoute.routes.listDeveloperPayouts, undefined, { title_id }, params);
+    }
+
+    /**
+     * View a specific payout record.
+     */
+    public static viewDeveloperPayout<T>(title_id: string, payout_id: string): AxiosPromise<Response<T>> {
+        return Requests.processRoute(TitlesRoute.routes.viewDeveloperPayout, {}, { title_id, payout_id });
+    }
+
+    /**
+     * Get the total earnings and playtime summary for a title.
+     */
+    public static getDeveloperPayoutSummary<T>(title_id: string): AxiosPromise<Response<T>> {
+        return Requests.processRoute(TitlesRoute.routes.developerPayoutSummary, {}, { title_id });
+    }
 }
 
 export default Titles;

package/src/routes/GamesRoutes.ts

@@ -10,7 +10,7 @@ class GamesRoutes {
     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 },
   };
 
 }

package/src/routes/SubscriptionsRoute.ts

@@ -19,6 +19,9 @@ class SubscriptionsRoute {
             url: '/subscriptions/communities/custom/{community_id}', 
             method: HTTP_METHODS.POST 
         },
+
+        purchaseLicense: { url: '/titles/{title_id}/purchase', method: HTTP_METHODS.POST },
+
     };
 
   }

package/src/routes/TitlesRoute.ts

@@ -180,6 +180,16 @@ class TitlesRoute {
     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 },
+
   };
 
 }