glitch-javascript-sdk 2.9.3 → 2.9.5

package/dist/index.d.ts

@@ -2255,6 +2255,26 @@ declare class Users {
      * Includes playtime and last played timestamps.
      */
     static playedGames<T>(params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /**
+     * Get all stats for a user, optionally filtered by title_id.
+     */
+    static getProgressionStats<T>(user_id: string, params?: {
+        title_id?: string;
+    }): AxiosPromise<Response<T>>;
+    /**
+     * Get all achievements for a user.
+     */
+    static getProgressionAchievements<T>(user_id: string, params?: {
+        title_id?: string;
+        status?: string;
+    }): AxiosPromise<Response<T>>;
+    /**
+     * Get the raw gameplay history (Run Records) for a user.
+     */
+    static getProgressionHistory<T>(user_id: string, params?: {
+        title_id?: string;
+        page?: number;
+    }): AxiosPromise<Response<T>>;
 }
 
 declare class Events {
@@ -4401,7 +4421,21 @@ declare class Titles {
  * @param title_id The UUID of the game title.
  * @returns AxiosPromise containing { signallingServer: string }
  */
-    static getMatchmakerServer<T>(title_id: string): AxiosPromise<Response<T>>;
+    static getMatchmakerServer<T>(title_id: string, params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /**
+     * Send a session heartbeat to keep the dedicated instance claimed.
+     * Called every 30s during active gameplay.
+     */
+    static matchmakerSessionHeartbeat<T>(title_id: string, data: {
+        sessionId: string;
+    }): AxiosPromise<Response<T>>;
+    /**
+     * Release the session (starts reclaim countdown).
+     * Called on beforeunload or explicit navigation away.
+     */
+    static matchmakerSessionRelease<T>(title_id: string, data: {
+        sessionId: string;
+    }): AxiosPromise<Response<T>>;
     /**
     * Initiates a resumable S3 multipart upload for large files.
     */
@@ -4414,6 +4448,27 @@ declare class Titles {
      * Stitch together all uploaded chunks to complete the file in S3.
      */
     static completeMultipartUpload<T>(title_id: string, data: object): AxiosPromise<Response<T>>;
+    static listProgressionStats<T>(title_id: string): AxiosPromise<Response<T>>;
+    static createProgressionStat<T>(title_id: string, data: object): AxiosPromise<Response<T>>;
+    static deleteProgressionStat<T>(title_id: string, id: string): AxiosPromise<Response<T>>;
+    static listProgressionAchievements<T>(title_id: string): AxiosPromise<Response<T>>;
+    static createProgressionAchievement<T>(title_id: string, data: object): AxiosPromise<Response<T>>;
+    static listProgressionLeaderboards<T>(title_id: string): AxiosPromise<Response<T>>;
+    static createProgressionLeaderboard<T>(title_id: string, data: object): AxiosPromise<Response<T>>;
+    static listProgressionSeasons<T>(title_id: string): AxiosPromise<Response<T>>;
+    static createProgressionSeason<T>(title_id: string, data: object): AxiosPromise<Response<T>>;
+    /**
+     * Submit a gameplay run. Updates stats and scores using the install_id for privacy.
+     * @param data { idempotency_key: string, payload: { stats: {}, scores: {} } }
+     */
+    static submitProgressionRun<T>(title_id: string, install_id: string, data: object): AxiosPromise<Response<T>>;
+    static getProgressionPlayerStats<T>(title_id: string, install_id: string): AxiosPromise<Response<T>>;
+    static getProgressionPlayerAchievements<T>(title_id: string, install_id: string): AxiosPromise<Response<T>>;
+    /**
+     * View leaderboard rankings.
+     * @param params Optional filters like { around_me: true, install_id: 'uuid', season_id: 'uuid' }
+     */
+    static getProgressionLeaderboard<T>(title_id: string, api_key: string, params?: Record<string, any>): AxiosPromise<Response<T>>;
 }
 
 declare class Campaigns {

package/package.json

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

package/src/api/Titles.ts

@@ -1100,10 +1100,35 @@ class Titles {
  * @param title_id The UUID of the game title.
  * @returns AxiosPromise containing { signallingServer: string }
  */
-    public static getMatchmakerServer<T>(title_id: string): AxiosPromise<Response<T>> {
+    public static getMatchmakerServer<T>(title_id: string, params?: Record<string, any>): AxiosPromise<Response<T>> {
         return Requests.processRoute(
             TitlesRoute.routes.getMatchmakerServer,
             {},
+            { title_id },
+            params    // ← passes as ?sessionId=xxx via Requests.get()
+        );
+    }
+
+    /**
+     * Send a session heartbeat to keep the dedicated instance claimed.
+     * Called every 30s during active gameplay.
+     */
+    public static matchmakerSessionHeartbeat<T>(title_id: string, data: { sessionId: string }): AxiosPromise<Response<T>> {
+        return Requests.processRoute(
+            TitlesRoute.routes.matchmakerSessionHeartbeat,
+            data,
+            { title_id }
+        );
+    }
+
+    /**
+     * Release the session (starts reclaim countdown).
+     * Called on beforeunload or explicit navigation away.
+     */
+    public static matchmakerSessionRelease<T>(title_id: string, data: { sessionId: string }): AxiosPromise<Response<T>> {
+        return Requests.processRoute(
+            TitlesRoute.routes.matchmakerSessionRelease,
+            data,
             { title_id }
         );
     }
@@ -1128,6 +1153,68 @@ class Titles {
     public static completeMultipartUpload<T>(title_id: string, data: object): AxiosPromise<Response<T>> {
         return Requests.processRoute(TitlesRoute.routes.completeMultipartUpload, data, { title_id });
     }
+
+     // --- Developer Definition Methods ---
+
+    public static listProgressionStats<T>(title_id: string): AxiosPromise<Response<T>> {
+        return Requests.processRoute(TitlesRoute.routes.progressionStatsList, undefined, { title_id });
+    }
+
+    public static createProgressionStat<T>(title_id: string, data: object): AxiosPromise<Response<T>> {
+        return Requests.processRoute(TitlesRoute.routes.progressionStatsStore, data, { title_id });
+    }
+
+    public static deleteProgressionStat<T>(title_id: string, id: string): AxiosPromise<Response<T>> {
+        return Requests.processRoute(TitlesRoute.routes.progressionStatsDelete, undefined, { title_id, id });
+    }
+
+    public static listProgressionAchievements<T>(title_id: string): AxiosPromise<Response<T>> {
+        return Requests.processRoute(TitlesRoute.routes.progressionAchievementsList, undefined, { title_id });
+    }
+
+    public static createProgressionAchievement<T>(title_id: string, data: object): AxiosPromise<Response<T>> {
+        return Requests.processRoute(TitlesRoute.routes.progressionAchievementsStore, data, { title_id });
+    }
+
+    public static listProgressionLeaderboards<T>(title_id: string): AxiosPromise<Response<T>> {
+        return Requests.processRoute(TitlesRoute.routes.progressionLeaderboardsList, undefined, { title_id });
+    }
+
+    public static createProgressionLeaderboard<T>(title_id: string, data: object): AxiosPromise<Response<T>> {
+        return Requests.processRoute(TitlesRoute.routes.progressionLeaderboardsStore, data, { title_id });
+    }
+
+    public static listProgressionSeasons<T>(title_id: string): AxiosPromise<Response<T>> {
+        return Requests.processRoute(TitlesRoute.routes.progressionSeasonsList, undefined, { title_id });
+    }
+
+    public static createProgressionSeason<T>(title_id: string, data: object): AxiosPromise<Response<T>> {
+        return Requests.processRoute(TitlesRoute.routes.progressionSeasonsStore, data, { title_id });
+    }
+
+    /**
+     * Submit a gameplay run. Updates stats and scores using the install_id for privacy.
+     * @param data { idempotency_key: string, payload: { stats: {}, scores: {} } }
+     */
+    public static submitProgressionRun<T>(title_id: string, install_id: string, data: object): AxiosPromise<Response<T>> {
+        return Requests.processRoute(TitlesRoute.routes.progressionSubmit, data, { title_id, install_id });
+    }
+
+    public static getProgressionPlayerStats<T>(title_id: string, install_id: string): AxiosPromise<Response<T>> {
+        return Requests.processRoute(TitlesRoute.routes.progressionPlayerStats, undefined, { title_id, install_id });
+    }
+
+    public static getProgressionPlayerAchievements<T>(title_id: string, install_id: string): AxiosPromise<Response<T>> {
+        return Requests.processRoute(TitlesRoute.routes.progressionPlayerAchievements, undefined, { title_id, install_id });
+    }
+
+    /**
+     * View leaderboard rankings.
+     * @param params Optional filters like { around_me: true, install_id: 'uuid', season_id: 'uuid' }
+     */
+    public static getProgressionLeaderboard<T>(title_id: string, api_key: string, params?: Record<string, any>): AxiosPromise<Response<T>> {
+        return Requests.processRoute(TitlesRoute.routes.progressionLeaderboardView, undefined, { title_id, api_key }, params);
+    }
 }
 
 export default Titles;

package/src/api/Users.ts

@@ -572,6 +572,27 @@ class Users {
         return Requests.processRoute(UserRoutes.routes.playedGames, undefined, undefined, params);
     }
 
+    /**
+     * Get all stats for a user, optionally filtered by title_id.
+     */
+    public static getProgressionStats<T>(user_id: string, params?: { title_id?: string }): AxiosPromise<Response<T>> {
+        return Requests.processRoute(UserRoutes.routes.userProgressionStats, undefined, { user_id }, params);
+    }
+
+    /**
+     * Get all achievements for a user.
+     */
+    public static getProgressionAchievements<T>(user_id: string, params?: { title_id?: string, status?: string }): AxiosPromise<Response<T>> {
+        return Requests.processRoute(UserRoutes.routes.userProgressionAchievements, undefined, { user_id }, params);
+    }
+
+    /**
+     * Get the raw gameplay history (Run Records) for a user.
+     */
+    public static getProgressionHistory<T>(user_id: string, params?: { title_id?: string, page?: number }): AxiosPromise<Response<T>> {
+        return Requests.processRoute(UserRoutes.routes.userProgressionHistory, undefined, { user_id }, params);
+    }
+
 
 }
 

package/src/routes/TitlesRoute.ts

@@ -243,7 +243,36 @@ class TitlesRoute {
       method: HTTP_METHODS.GET
     },
 
-    
+    matchmakerSessionHeartbeat: {
+      url: '/titles/{title_id}/matchmaker/session/heartbeat',
+      method: HTTP_METHODS.POST
+    },
+    matchmakerSessionRelease: {
+      url: '/titles/{title_id}/matchmaker/session/release',
+      method: HTTP_METHODS.POST
+    },
+
+
+    // --- Title Progression Definitions (Developer API) ---
+    progressionStatsList: { url: '/titles/{title_id}/progression/stats', method: HTTP_METHODS.GET },
+    progressionStatsStore: { url: '/titles/{title_id}/progression/stats', method: HTTP_METHODS.POST },
+    progressionStatsDelete: { url: '/titles/{title_id}/progression/stats/{id}', method: HTTP_METHODS.DELETE },
+
+    progressionAchievementsList: { url: '/titles/{title_id}/progression/achievements', method: HTTP_METHODS.GET },
+    progressionAchievementsStore: { url: '/titles/{title_id}/progression/achievements', method: HTTP_METHODS.POST },
+
+    progressionLeaderboardsList: { url: '/titles/{title_id}/progression/leaderboards', method: HTTP_METHODS.GET },
+    progressionLeaderboardsStore: { url: '/titles/{title_id}/progression/leaderboards', method: HTTP_METHODS.POST },
+
+    progressionSeasonsList: { url: '/titles/{title_id}/progression/seasons', method: HTTP_METHODS.GET },
+    progressionSeasonsStore: { url: '/titles/{title_id}/progression/seasons', method: HTTP_METHODS.POST },
+
+    // --- In-Game Progression (Client API) ---
+    progressionSubmit: { url: '/titles/{title_id}/installs/{install_id}/submit', method: HTTP_METHODS.POST },
+    progressionPlayerStats: { url: '/titles/{title_id}/installs/{install_id}/stats', method: HTTP_METHODS.GET },
+    progressionPlayerAchievements: { url: '/titles/{title_id}/installs/{install_id}/achievements', method: HTTP_METHODS.GET },
+    progressionLeaderboardView: { url: '/titles/{title_id}/leaderboards/{api_key}', method: HTTP_METHODS.GET },
+
 
   };
 

package/src/routes/UserRoutes.ts

@@ -53,6 +53,11 @@ class UserRoutes {
     playedGames: { url: '/users/me/played-games', method: HTTP_METHODS.GET },
 
 
+    userProgressionStats: { url: '/users/{user_id}/progression/stats', method: HTTP_METHODS.GET },
+    userProgressionAchievements: { url: '/users/{user_id}/progression/achievements', method: HTTP_METHODS.GET },
+    userProgressionHistory: { url: '/users/{user_id}/progression/history', method: HTTP_METHODS.GET },
+
+
   };
 
 }