glitch-javascript-sdk 2.4.7 → 2.4.9

package/dist/index.d.ts

@@ -3686,6 +3686,15 @@ 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>>;
 }
 
 declare class Titles {
@@ -5691,6 +5700,13 @@ 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>>;
 }
 
 declare class Scheduler {
@@ -6239,6 +6255,36 @@ 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>>;
+    /**
+ * Get TikTok Music List with advanced filtering (Keyword, Recommendations, Liked).
+ * @param params { music_scene: 'CREATIVE_ASSET'|'CAROUSEL_ADS', search_type: string, filtering: object }
+ */
+    static getTikTokMusicList<T>(scheduler_id: string, params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /**
+     * Get the top 200 trending hashtags on TikTok.
+     * @param params { country_code: string, category_name: string, date_range: string }
+     */
+    static getTikTokTrendingHashtags<T>(scheduler_id: string, params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /**
+     * Get trending search keywords on TikTok.
+     * @param params { is_personalized: boolean }
+     */
+    static getTikTokTrendingKeywords<T>(scheduler_id: string, params?: Record<string, any>): AxiosPromise<Response<T>>;
 }
 
 declare class Funnel {

package/package.json

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

package/src/api/Media.ts

@@ -331,6 +331,17 @@ class Media {
             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.
+     */
+    public static uploadTikTokMusic<T>(file: File, scheduler_id: string): AxiosPromise<Response<T>> {
+        // We use the raw URL here as it's a specialized upload path
+        return Requests.uploadFile('/media/tiktok/music', 'audio', file, { scheduler_id });
+    }
 }
 
 export default Media;

package/src/api/Scheduler.ts

@@ -839,6 +839,49 @@ class Scheduler {
         return Requests.processRoute(SchedulerRoute.routes.generateHashtags, data, { scheduler_id }, params);
     }
 
+    /**
+ * Get TikTok hashtag suggestions based on a keyword.
+ * 
+ * @param scheduler_id The ID of the promotion schedule.
+ * @param params { keyword: string }
+ */
+    public static getTikTokHashtags<T>(scheduler_id: string, params: { keyword: string }): AxiosPromise<Response<T>> {
+        return Requests.processRoute(SchedulerRoute.routes.getTikTokHashtags, {}, { scheduler_id }, params);
+    }
+
+    /**
+     * Get trending commercial music from TikTok's library.
+     * 
+     * @param scheduler_id The ID of the promotion schedule.
+     */
+    public static getTikTokMusic<T>(scheduler_id: string, params?: Record<string, any>): AxiosPromise<Response<T>> {
+        return Requests.processRoute(SchedulerRoute.routes.getTikTokMusic, {}, { scheduler_id }, params);
+    }
+
+    /**
+ * Get TikTok Music List with advanced filtering (Keyword, Recommendations, Liked).
+ * @param params { music_scene: 'CREATIVE_ASSET'|'CAROUSEL_ADS', search_type: string, filtering: object }
+ */
+    public static getTikTokMusicList<T>(scheduler_id: string, params?: Record<string, any>): AxiosPromise<Response<T>> {
+        return Requests.processRoute(SchedulerRoute.routes.getTikTokMusicList, {}, { scheduler_id }, params);
+    }
+
+    /**
+     * Get the top 200 trending hashtags on TikTok.
+     * @param params { country_code: string, category_name: string, date_range: string }
+     */
+    public static getTikTokTrendingHashtags<T>(scheduler_id: string, params?: Record<string, any>): AxiosPromise<Response<T>> {
+        return Requests.processRoute(SchedulerRoute.routes.getTikTokTrendingHashtags, {}, { scheduler_id }, params);
+    }
+
+    /**
+     * Get trending search keywords on TikTok.
+     * @param params { is_personalized: boolean }
+     */
+    public static getTikTokTrendingKeywords<T>(scheduler_id: string, params?: Record<string, any>): AxiosPromise<Response<T>> {
+        return Requests.processRoute(SchedulerRoute.routes.getTikTokTrendingKeywords, {}, { scheduler_id }, params);
+    }
+
 }
 
 export default Scheduler;

package/src/api/SocialPosts.ts

@@ -430,6 +430,16 @@ class SocialPosts {
     public static sendSocialMessage<T>(data: object): AxiosPromise<Response<T>> {
         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 }
+     */
+    public static replyViaDm<T>(comment_id: string, data: { message: string }): AxiosPromise<Response<T>> {
+        return Requests.processRoute(SocialPostsRoute.routes.replyViaDm, data, { comment_id });
+    }
 }
 
 export default SocialPosts;

package/src/routes/MediaRoute.ts

@@ -11,6 +11,7 @@ class MediaRoute {
         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 },
     };
 }
 

package/src/routes/SchedulerRoute.ts

@@ -131,6 +131,13 @@ class SchedulerRoute {
             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 },
+        getTikTokMusicList: { url: '/schedulers/{scheduler_id}/tiktok/music', method: HTTP_METHODS.GET },
+        getTikTokTrendingHashtags: { url: '/schedulers/{scheduler_id}/tiktok/discovery/hashtags/trending', method: HTTP_METHODS.GET },
+        getTikTokHashtagDetail: { url: '/schedulers/{scheduler_id}/tiktok/discovery/hashtags/detail', method: HTTP_METHODS.GET },
+        getTikTokTrendingKeywords: { url: '/schedulers/{scheduler_id}/tiktok/discovery/search-keywords', method: HTTP_METHODS.GET },
+
     };
 }
 

package/src/routes/SocialPostsRoute.ts

@@ -47,6 +47,7 @@ class SocialPostsRoute {
         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 },
 
     };