glitch-javascript-sdk 2.4.5 → 2.4.7

package/dist/index.d.ts

@@ -3640,6 +3640,52 @@ declare class SocialPosts {
      * Get ad creative performance matrix.
      */
     static creativePerformance<T>(params: Record<string, any>): AxiosPromise<Response<T>>;
+    /**
+    * List social media conversations.
+    *
+    * @see https://api.glitch.fun/api/documentation#/Social%20Messaging/listSocialConversations
+    *
+    * @param params Query parameters (scheduler_id, platform, page, per_page).
+    * @returns promise
+    */
+    static listConversations<T>(params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /**
+     * Sync conversations from external platform.
+     *
+     * @see https://api.glitch.fun/api/documentation#/Social%20Messaging/syncSocialConversations
+     *
+     * @param data Body parameters (platform, scheduler_id).
+     * @returns promise
+     */
+    static syncConversations<T>(data: object): AxiosPromise<Response<T>>;
+    /**
+     * Get a specific conversation.
+     *
+     * @see https://api.glitch.fun/api/documentation#/Social%20Messaging/getSocialConversation
+     *
+     * @param conversation_id The ID of the conversation.
+     * @returns promise
+     */
+    static getConversation<T>(conversation_id: string): AxiosPromise<Response<T>>;
+    /**
+     * List messages in a conversation.
+     *
+     * @see https://api.glitch.fun/api/documentation#/Social%20Messaging/listSocialMessages
+     *
+     * @param conversation_id The ID of the conversation.
+     * @param params Query parameters (sync, page, per_page).
+     * @returns promise
+     */
+    static getConversationMessages<T>(conversation_id: string, params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /**
+     * Send a Direct Message.
+     *
+     * @see https://api.glitch.fun/api/documentation#/Social%20Messaging/sendSocialMessage
+     *
+     * @param data Body parameters (message, conversation_id, recipient_id, platform, scheduler_id, media_ids).
+     * @returns promise
+     */
+    static sendSocialMessage<T>(data: object): AxiosPromise<Response<T>>;
 }
 
 declare class Titles {
@@ -4071,6 +4117,52 @@ declare class Titles {
         group_by: 'platform' | 'status' | 'event_type';
         unique_clicks?: boolean;
     }): AxiosPromise<Response<T>>;
+    /**
+     * Get a geographical distribution report for installs.
+     * @param params e.g., { group_by: 'country_code', start_date: '2025-01-01' }
+     */
+    static geoReport<T>(title_id: string, params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /**
+     * List and filter raw game events (telemetry).
+     */
+    static listEvents<T>(title_id: string, params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /**
+     * Record a single in-game action.
+     */
+    static createEvent<T>(title_id: string, data: object): AxiosPromise<Response<T>>;
+    /**
+     * Record multiple events in one request (Batching).
+     * @param data { events: Array<{game_install_id, step_key, action_key, metadata?}> }
+     */
+    static bulkCreateEvents<T>(title_id: string, data: {
+        events: object[];
+    }): AxiosPromise<Response<T>>;
+    /**
+     * Get a summary of actions per step.
+     */
+    static eventSummary<T>(title_id: string, params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /**
+     * Get all unique step and action keys used in this title.
+     */
+    static eventDistinctKeys<T>(title_id: string): AxiosPromise<Response<T>>;
+    /**
+     * List all saved behavioral funnel definitions.
+     */
+    static listBehavioralFunnels<T>(title_id: string): AxiosPromise<Response<T>>;
+    /**
+     * Create and save a new behavioral funnel definition.
+     * @param data { name: string, description?: string, steps: string[] }
+     */
+    static createBehavioralFunnel<T>(title_id: string, data: object): AxiosPromise<Response<T>>;
+    /**
+     * Generate the drop-off report for a specific behavioral funnel.
+     * @param params { start_date?: string, end_date?: string }
+     */
+    static behavioralFunnelReport<T>(title_id: string, funnel_id: string, params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /**
+     * Delete a saved behavioral funnel definition.
+     */
+    static deleteBehavioralFunnel<T>(title_id: string, funnel_id: string): AxiosPromise<Response<T>>;
 }
 
 declare class Campaigns {

package/package.json

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

package/src/api/SocialPosts.ts

@@ -369,6 +369,67 @@ class SocialPosts {
     public static creativePerformance<T>(params: Record<string, any>): AxiosPromise<Response<T>> {
         return Requests.processRoute(SocialPostsRoute.routes.creativePerformance, {}, {}, params);
     }
+
+     /**
+     * List social media conversations.
+     * 
+     * @see https://api.glitch.fun/api/documentation#/Social%20Messaging/listSocialConversations
+     * 
+     * @param params Query parameters (scheduler_id, platform, page, per_page).
+     * @returns promise
+     */
+    public static listConversations<T>(params?: Record<string, any>): AxiosPromise<Response<T>> {
+        return Requests.processRoute(SocialPostsRoute.routes.listConversations, undefined, undefined, params);
+    }
+
+    /**
+     * Sync conversations from external platform.
+     * 
+     * @see https://api.glitch.fun/api/documentation#/Social%20Messaging/syncSocialConversations
+     * 
+     * @param data Body parameters (platform, scheduler_id).
+     * @returns promise
+     */
+    public static syncConversations<T>(data: object): AxiosPromise<Response<T>> {
+        return Requests.processRoute(SocialPostsRoute.routes.syncConversations, data);
+    }
+
+    /**
+     * Get a specific conversation.
+     * 
+     * @see https://api.glitch.fun/api/documentation#/Social%20Messaging/getSocialConversation
+     * 
+     * @param conversation_id The ID of the conversation.
+     * @returns promise
+     */
+    public static getConversation<T>(conversation_id: string): AxiosPromise<Response<T>> {
+        return Requests.processRoute(SocialPostsRoute.routes.getConversation, undefined, { conversation_id });
+    }
+
+    /**
+     * List messages in a conversation.
+     * 
+     * @see https://api.glitch.fun/api/documentation#/Social%20Messaging/listSocialMessages
+     * 
+     * @param conversation_id The ID of the conversation.
+     * @param params Query parameters (sync, page, per_page).
+     * @returns promise
+     */
+    public static getConversationMessages<T>(conversation_id: string, params?: Record<string, any>): AxiosPromise<Response<T>> {
+        return Requests.processRoute(SocialPostsRoute.routes.getConversationMessages, undefined, { conversation_id }, params);
+    }
+
+    /**
+     * Send a Direct Message.
+     * 
+     * @see https://api.glitch.fun/api/documentation#/Social%20Messaging/sendSocialMessage
+     * 
+     * @param data Body parameters (message, conversation_id, recipient_id, platform, scheduler_id, media_ids).
+     * @returns promise
+     */
+    public static sendSocialMessage<T>(data: object): AxiosPromise<Response<T>> {
+        return Requests.processRoute(SocialPostsRoute.routes.sendSocialMessage, data);
+    }
 }
 
 export default SocialPosts;

package/src/api/Titles.ts

@@ -858,6 +858,80 @@ class Titles {
             params
         );
     }
+
+    /**
+     * Get a geographical distribution report for installs.
+     * @param params e.g., { group_by: 'country_code', start_date: '2025-01-01' }
+     */
+    public static geoReport<T>(title_id: string, params?: Record<string, any>): AxiosPromise<Response<T>> {
+        return Requests.processRoute(TitlesRoute.routes.geoReport, {}, { title_id }, params);
+    }
+
+    /**
+     * List and filter raw game events (telemetry).
+     */
+    public static listEvents<T>(title_id: string, params?: Record<string, any>): AxiosPromise<Response<T>> {
+        return Requests.processRoute(TitlesRoute.routes.listEvents, {}, { title_id }, params);
+    }
+
+    /**
+     * Record a single in-game action.
+     */
+    public static createEvent<T>(title_id: string, data: object): AxiosPromise<Response<T>> {
+        return Requests.processRoute(TitlesRoute.routes.createEvent, data, { title_id });
+    }
+
+    /**
+     * Record multiple events in one request (Batching).
+     * @param data { events: Array<{game_install_id, step_key, action_key, metadata?}> }
+     */
+    public static bulkCreateEvents<T>(title_id: string, data: { events: object[] }): AxiosPromise<Response<T>> {
+        return Requests.processRoute(TitlesRoute.routes.bulkCreateEvents, data, { title_id });
+    }
+
+    /**
+     * Get a summary of actions per step.
+     */
+    public static eventSummary<T>(title_id: string, params?: Record<string, any>): AxiosPromise<Response<T>> {
+        return Requests.processRoute(TitlesRoute.routes.eventSummary, {}, { title_id }, params);
+    }
+
+    /**
+     * Get all unique step and action keys used in this title.
+     */
+    public static eventDistinctKeys<T>(title_id: string): AxiosPromise<Response<T>> {
+        return Requests.processRoute(TitlesRoute.routes.eventDistinctKeys, {}, { title_id });
+    }
+
+    /**
+     * List all saved behavioral funnel definitions.
+     */
+    public static listBehavioralFunnels<T>(title_id: string): AxiosPromise<Response<T>> {
+        return Requests.processRoute(TitlesRoute.routes.listBehavioralFunnels, {}, { title_id });
+    }
+
+    /**
+     * Create and save a new behavioral funnel definition.
+     * @param data { name: string, description?: string, steps: string[] }
+     */
+    public static createBehavioralFunnel<T>(title_id: string, data: object): AxiosPromise<Response<T>> {
+        return Requests.processRoute(TitlesRoute.routes.createBehavioralFunnel, data, { title_id });
+    }
+
+    /**
+     * Generate the drop-off report for a specific behavioral funnel.
+     * @param params { start_date?: string, end_date?: string }
+     */
+    public static behavioralFunnelReport<T>(title_id: string, funnel_id: string, params?: Record<string, any>): AxiosPromise<Response<T>> {
+        return Requests.processRoute(TitlesRoute.routes.behavioralFunnelReport, {}, { title_id, funnel_id }, params);
+    }
+
+    /**
+     * Delete a saved behavioral funnel definition.
+     */
+    public static deleteBehavioralFunnel<T>(title_id: string, funnel_id: string): AxiosPromise<Response<T>> {
+        return Requests.processRoute(TitlesRoute.routes.deleteBehavioralFunnel, {}, { title_id, funnel_id });
+    }
 }
 
 export default Titles;

package/src/routes/SocialPostsRoute.ts

@@ -41,6 +41,13 @@ class SocialPostsRoute {
 
         creativePerformance: { url: '/socialposts/creative-performance', method: HTTP_METHODS.GET },
 
+         // Social Messaging (DM) Routes
+        listConversations: { url: '/social/conversations', method: HTTP_METHODS.GET },
+        syncConversations: { url: '/social/conversations/sync', method: HTTP_METHODS.POST },
+        getConversation: { url: '/social/conversations/{conversation_id}', method: HTTP_METHODS.GET },
+        getConversationMessages: { url: '/social/conversations/{conversation_id}/messages', method: HTTP_METHODS.GET },
+        sendSocialMessage: { url: '/social/messages', method: HTTP_METHODS.POST },
+
     };
 
 }

package/src/routes/TitlesRoute.ts

@@ -165,6 +165,21 @@ class TitlesRoute {
 
     cohorts: { url: '/titles/{title_id}/installs/cohorts', method: HTTP_METHODS.GET },
 
+    geoReport: { url: '/titles/{title_id}/installs/geo-report', method: HTTP_METHODS.GET },
+
+    // Game Events (Behavioral Telemetry)
+    listEvents: { url: '/titles/{title_id}/events', method: HTTP_METHODS.GET },
+    createEvent: { url: '/titles/{title_id}/events', method: HTTP_METHODS.POST },
+    bulkCreateEvents: { url: '/titles/{title_id}/events/bulk', method: HTTP_METHODS.POST },
+    eventSummary: { url: '/titles/{title_id}/events/summary', method: HTTP_METHODS.GET },
+    eventDistinctKeys: { url: '/titles/{title_id}/events/distinct-keys', method: HTTP_METHODS.GET },
+
+    // Behavioral Funnels
+    listBehavioralFunnels: { url: '/titles/{title_id}/behavioral-funnels', method: HTTP_METHODS.GET },
+    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 },
+
   };
 
 }