glitch-javascript-sdk 2.8.1 → 2.8.3

package/dist/index.d.ts

@@ -4289,6 +4289,19 @@ declare class Titles {
      * Get the total earnings and playtime summary for a title.
      */
     static getDeveloperPayoutSummary<T>(title_id: string): AxiosPromise<Response<T>>;
+    /**
+     * The Aegis Handshake: Verify if a player is allowed to play.
+     *
+     * This is used by the game engine (Unity/Unreal) to confirm that the
+     * current session is valid and the user has a proper license.
+     *
+     * @see https://api.glitch.fun/api/documentation#/Aegis%20Security/validateGameSession
+     *
+     * @param title_id The UUID of the game title.
+     * @param install_id The UUID of the specific install/session.
+     * @returns AxiosPromise containing { valid: boolean, user_name: string, license_type: string }
+     */
+    static validateInstall<T>(title_id: string, install_id: string): AxiosPromise<Response<T>>;
 }
 
 declare class Campaigns {
@@ -6957,6 +6970,17 @@ declare class WebsiteAnalytics {
      * @returns Promise with a unified timeline of the user’s journey, in chronological order.
      */
     static userJourney<T>(params: Record<string, any>): AxiosPromise<Response<T>>;
+    /**
+   * Get a detailed marketing report for the game's landing page.
+   * Includes scroll depth, video watch time distribution, and CTA performance.
+   *
+   * @param params
+   *   - title_id: string (Required)
+   *   - start_date?: string (YYYY-MM-DD)
+   *   - end_date?: string (YYYY-MM-DD)
+   *   - group_by?: 'country' | 'device'
+   */
+    static landingPageReport<T>(params: Record<string, any>): AxiosPromise<Response<T>>;
 }
 
 declare class ShortLinks {

package/package.json

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

package/src/api/Titles.ts

@@ -976,6 +976,26 @@ class Titles {
     public static getDeveloperPayoutSummary<T>(title_id: string): AxiosPromise<Response<T>> {
         return Requests.processRoute(TitlesRoute.routes.developerPayoutSummary, {}, { title_id });
     }
+
+    /**
+     * The Aegis Handshake: Verify if a player is allowed to play.
+     * 
+     * This is used by the game engine (Unity/Unreal) to confirm that the 
+     * current session is valid and the user has a proper license.
+     * 
+     * @see https://api.glitch.fun/api/documentation#/Aegis%20Security/validateGameSession
+     * 
+     * @param title_id The UUID of the game title.
+     * @param install_id The UUID of the specific install/session.
+     * @returns AxiosPromise containing { valid: boolean, user_name: string, license_type: string }
+     */
+    public static validateInstall<T>(title_id: string, install_id: string): AxiosPromise<Response<T>> {
+        return Requests.processRoute(
+            TitlesRoute.routes.validateInstall, 
+            {}, 
+            { title_id: title_id, install_id: install_id }
+        );
+    }
 }
 
 export default Titles;

package/src/api/WebsiteAnalytics.ts

@@ -319,15 +319,34 @@ class WebsiteAnalytics {
    *   - end_date?: string                 Optional. End date (YYYY-MM-DD) if your API supports time limiting  
    *  
    * @returns Promise with a unified timeline of the user’s journey, in chronological order.  
-   */  
-  public static userJourney<T>(params: Record<string, any>): AxiosPromise<Response<T>> {  
-    return Requests.processRoute(  
+   */
+  public static userJourney<T>(params: Record<string, any>): AxiosPromise<Response<T>> {
+    return Requests.processRoute(
       WebsiteAnalyticsRoute.routes.journey, // references our new route definition  
       {}, // no body data (GET request)  
-      undefined,  
-      params  
-    );  
-  }  
+      undefined,
+      params
+    );
+  }
+
+  /**
+ * Get a detailed marketing report for the game's landing page.
+ * Includes scroll depth, video watch time distribution, and CTA performance.
+ * 
+ * @param params 
+ *   - title_id: string (Required)
+ *   - start_date?: string (YYYY-MM-DD)
+ *   - end_date?: string (YYYY-MM-DD)
+ *   - group_by?: 'country' | 'device'
+ */
+  public static landingPageReport<T>(params: Record<string, any>): AxiosPromise<Response<T>> {
+    return Requests.processRoute(
+      WebsiteAnalyticsRoute.routes.landingPageReport,
+      {},
+      undefined,
+      params
+    );
+  }
 }
 
 export default WebsiteAnalytics;

package/src/routes/TitlesRoute.ts

@@ -190,6 +190,15 @@ class TitlesRoute {
     viewDeveloperPayout: { url: '/titles/{title_id}/payouts/{payout_id}', method: HTTP_METHODS.GET },
     developerPayoutSummary: { url: '/titles/{title_id}/payouts/summary', method: HTTP_METHODS.GET },
 
+     /**
+     * The Aegis Handshake: Validates if a specific install/session is authorized to play.
+     * POST /titles/{title_id}/installs/{install_id}/validate
+     */
+    validateInstall: { 
+      url: '/titles/{title_id}/installs/{install_id}/validate', 
+      method: HTTP_METHODS.POST 
+    },
+
   };
 
 }

package/src/routes/WebsiteAnalyticsRoute.ts

@@ -63,11 +63,15 @@ class WebsiteAnalyticsRoute {
       url: '/analytics/utm-performance',
       method: HTTP_METHODS.GET
     },
-    journey: {  
-      url: '/analytics/journey',  
-      method: HTTP_METHODS.GET  
-    }
-    
+    journey: {
+      url: '/analytics/journey',
+      method: HTTP_METHODS.GET
+    },
+    landingPageReport: {
+      url: '/analytics/reports/landing-page',
+      method: HTTP_METHODS.GET
+    },
+
   };
 }