glitch-javascript-sdk 2.4.6 → 2.4.8

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

@@ -214,5 +214,12 @@ declare class Media {
         requirement: string;
         content: string;
     };
+    /**
+     * Upload an audio file to TikTok's asset library via our Media controller.
+     *
+     * @param file The audio file (mp3).
+     * @param scheduler_id The ID of the scheduler to provide OAuth context.
+     */
+    static uploadTikTokMusic<T>(file: File, scheduler_id: string): AxiosPromise<Response<T>>;
 }
 export default Media;

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

@@ -546,5 +546,20 @@ declare class Scheduler {
      * @returns promise
      */
     static generateHashtags<T>(scheduler_id: string, data: object, params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /**
+ * Get TikTok hashtag suggestions based on a keyword.
+ *
+ * @param scheduler_id The ID of the promotion schedule.
+ * @param params { keyword: string }
+ */
+    static getTikTokHashtags<T>(scheduler_id: string, params: {
+        keyword: string;
+    }): AxiosPromise<Response<T>>;
+    /**
+     * Get trending commercial music from TikTok's library.
+     *
+     * @param scheduler_id The ID of the promotion schedule.
+     */
+    static getTikTokMusic<T>(scheduler_id: string, params?: Record<string, any>): AxiosPromise<Response<T>>;
 }
 export default Scheduler;

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

@@ -309,5 +309,14 @@ declare class SocialPosts {
      * @returns promise
      */
     static sendSocialMessage<T>(data: object): AxiosPromise<Response<T>>;
+    /**
+     * Reply to a high-intent TikTok comment via Direct Message.
+     *
+     * @param comment_id The ID of the comment.
+     * @param data { message: string }
+     */
+    static replyViaDm<T>(comment_id: string, data: {
+        message: string;
+    }): AxiosPromise<Response<T>>;
 }
 export default SocialPosts;

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

@@ -429,5 +429,51 @@ 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>>;
 }
 export default Titles;

package/dist/esm/index.js

@@ -10960,6 +10960,7 @@ var SocialPostsRoute = /** @class */ (function () {
         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 },
+        replyViaDm: { url: '/socialposts/comments/{comment_id}/reply-via-dm', method: HTTP_METHODS.POST },
     };
     return SocialPostsRoute;
 }());
@@ -11347,6 +11348,15 @@ var SocialPosts = /** @class */ (function () {
     SocialPosts.sendSocialMessage = function (data) {
         return Requests.processRoute(SocialPostsRoute.routes.sendSocialMessage, data);
     };
+    /**
+     * Reply to a high-intent TikTok comment via Direct Message.
+     *
+     * @param comment_id The ID of the comment.
+     * @param data { message: string }
+     */
+    SocialPosts.replyViaDm = function (comment_id, data) {
+        return Requests.processRoute(SocialPostsRoute.routes.replyViaDm, data, { comment_id: comment_id });
+    };
     return SocialPosts;
 }());
 
@@ -11501,6 +11511,18 @@ var TitlesRoute = /** @class */ (function () {
         generateLandingPageAiContent: { url: '/landing-pages/{landing_page_id}/generate-ai-content', method: HTTP_METHODS.POST },
         saveLandingPageTranslation: { url: '/landing-pages/{landing_page_id}/translations', method: HTTP_METHODS.POST },
         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 },
     };
     return TitlesRoute;
 }());
@@ -12056,6 +12078,70 @@ var Titles = /** @class */ (function () {
     Titles.getAdConversionEventsReport = function (title_id, params) {
         return Requests.processRoute(TitlesRoute.routes.getAdConversionEventsReport, {}, { title_id: title_id }, params);
     };
+    /**
+     * Get a geographical distribution report for installs.
+     * @param params e.g., { group_by: 'country_code', start_date: '2025-01-01' }
+     */
+    Titles.geoReport = function (title_id, params) {
+        return Requests.processRoute(TitlesRoute.routes.geoReport, {}, { title_id: title_id }, params);
+    };
+    /**
+     * List and filter raw game events (telemetry).
+     */
+    Titles.listEvents = function (title_id, params) {
+        return Requests.processRoute(TitlesRoute.routes.listEvents, {}, { title_id: title_id }, params);
+    };
+    /**
+     * Record a single in-game action.
+     */
+    Titles.createEvent = function (title_id, data) {
+        return Requests.processRoute(TitlesRoute.routes.createEvent, data, { title_id: title_id });
+    };
+    /**
+     * Record multiple events in one request (Batching).
+     * @param data { events: Array<{game_install_id, step_key, action_key, metadata?}> }
+     */
+    Titles.bulkCreateEvents = function (title_id, data) {
+        return Requests.processRoute(TitlesRoute.routes.bulkCreateEvents, data, { title_id: title_id });
+    };
+    /**
+     * Get a summary of actions per step.
+     */
+    Titles.eventSummary = function (title_id, params) {
+        return Requests.processRoute(TitlesRoute.routes.eventSummary, {}, { title_id: title_id }, params);
+    };
+    /**
+     * Get all unique step and action keys used in this title.
+     */
+    Titles.eventDistinctKeys = function (title_id) {
+        return Requests.processRoute(TitlesRoute.routes.eventDistinctKeys, {}, { title_id: title_id });
+    };
+    /**
+     * List all saved behavioral funnel definitions.
+     */
+    Titles.listBehavioralFunnels = function (title_id) {
+        return Requests.processRoute(TitlesRoute.routes.listBehavioralFunnels, {}, { title_id: title_id });
+    };
+    /**
+     * Create and save a new behavioral funnel definition.
+     * @param data { name: string, description?: string, steps: string[] }
+     */
+    Titles.createBehavioralFunnel = function (title_id, data) {
+        return Requests.processRoute(TitlesRoute.routes.createBehavioralFunnel, data, { title_id: title_id });
+    };
+    /**
+     * Generate the drop-off report for a specific behavioral funnel.
+     * @param params { start_date?: string, end_date?: string }
+     */
+    Titles.behavioralFunnelReport = function (title_id, funnel_id, params) {
+        return Requests.processRoute(TitlesRoute.routes.behavioralFunnelReport, {}, { title_id: title_id, funnel_id: funnel_id }, params);
+    };
+    /**
+     * Delete a saved behavioral funnel definition.
+     */
+    Titles.deleteBehavioralFunnel = function (title_id, funnel_id) {
+        return Requests.processRoute(TitlesRoute.routes.deleteBehavioralFunnel, {}, { title_id: title_id, funnel_id: funnel_id });
+    };
     return Titles;
 }());
 
@@ -13933,6 +14019,7 @@ var MediaRoute = /** @class */ (function () {
         removeBackgroundAI: { url: '/media/remove-background-ai', method: HTTP_METHODS.POST },
         createLibraryLogo: { url: '/media/create-library-logo', method: HTTP_METHODS.POST },
         validateScreenshot: { url: '/media/validate-screenshot', method: HTTP_METHODS.POST },
+        uploadTikTokMusic: { url: '/media/tiktok/music', method: HTTP_METHODS.POST },
     };
     return MediaRoute;
 }());
@@ -14153,6 +14240,16 @@ var Media = /** @class */ (function () {
             content: 'Logo only, should be legible against any background'
         };
     };
+    /**
+     * Upload an audio file to TikTok's asset library via our Media controller.
+     *
+     * @param file The audio file (mp3).
+     * @param scheduler_id The ID of the scheduler to provide OAuth context.
+     */
+    Media.uploadTikTokMusic = function (file, scheduler_id) {
+        // We use the raw URL here as it's a specialized upload path
+        return Requests.uploadFile('/media/tiktok/music', 'audio', file, { scheduler_id: scheduler_id });
+    };
     return Media;
 }());
 
@@ -14273,6 +14370,8 @@ var SchedulerRoute = /** @class */ (function () {
             url: '/schedulers/{scheduler_id}/generateHashtags',
             method: HTTP_METHODS.POST
         },
+        getTikTokHashtags: { url: '/schedulers/{scheduler_id}/tiktok/discovery/hashtags', method: HTTP_METHODS.GET },
+        getTikTokMusic: { url: '/schedulers/{scheduler_id}/tiktok/discovery/music', method: HTTP_METHODS.GET },
     };
     return SchedulerRoute;
 }());
@@ -14963,6 +15062,23 @@ var Scheduler = /** @class */ (function () {
     Scheduler.generateHashtags = function (scheduler_id, data, params) {
         return Requests.processRoute(SchedulerRoute.routes.generateHashtags, data, { scheduler_id: scheduler_id }, params);
     };
+    /**
+ * Get TikTok hashtag suggestions based on a keyword.
+ *
+ * @param scheduler_id The ID of the promotion schedule.
+ * @param params { keyword: string }
+ */
+    Scheduler.getTikTokHashtags = function (scheduler_id, params) {
+        return Requests.processRoute(SchedulerRoute.routes.getTikTokHashtags, {}, { scheduler_id: scheduler_id }, params);
+    };
+    /**
+     * Get trending commercial music from TikTok's library.
+     *
+     * @param scheduler_id The ID of the promotion schedule.
+     */
+    Scheduler.getTikTokMusic = function (scheduler_id, params) {
+        return Requests.processRoute(SchedulerRoute.routes.getTikTokMusic, {}, { scheduler_id: scheduler_id }, params);
+    };
     return Scheduler;
 }());