glitch-javascript-sdk 1.9.3 → 1.9.5

package/dist/index.d.ts

@@ -1000,6 +1000,65 @@ declare class Ads {
     static twitterBatchTargetingCriteria<T>(data: object[], params?: Record<string, any>): AxiosPromise<Response<T>>;
     static lookupTwitterTargeting<T>(resource: string, params?: Record<string, any>): AxiosPromise<Response<T>>;
     static twitterTargetingSuggestions<T>(params: Record<string, any>): AxiosPromise<Response<T>>;
+    /**
+     * Deep-sync a campaign tree (campaign → groups → ads) with its remote platform.
+     *
+     * @param campaign_id UUID of the campaign to sync
+     * @param params      Optional query params
+     * @returns           Fully-hydrated AdCampaign resource
+     */
+    static syncCampaignTree<T>(campaign_id: string, params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /**
+    * Deep-sync all the campaigns for a scheduler.
+    *
+    * @param scheduler_id UUID of the campaign to sync
+    * @param params      Optional query params
+    * @returns           Fully-hydrated AdCampaign resource
+    */
+    static syncSchedulerCampaigns<T>(scheduler_id: string, params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /**
+     * Get campaign performance summary.
+     */
+    static getPerformanceSummary<T>(params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /**
+     * Get spend and delivery metrics over time.
+     */
+    static getSpendDeliveryReport<T>(params: {
+        start_date: string;
+        end_date: string;
+        group_by?: 'day' | 'week' | 'month';
+        community_id?: string;
+        platform?: string;
+    }): AxiosPromise<Response<T>>;
+    /**
+     * Compare performance across platforms.
+     */
+    static getPlatformComparisonReport<T>(params?: {
+        start_date?: string;
+        end_date?: string;
+        community_id?: string;
+    }): AxiosPromise<Response<T>>;
+    /**
+     * Get performance metrics for individual ad creatives.
+     */
+    static getCreativePerformanceReport<T>(params?: {
+        community_id?: string;
+        platform?: string;
+        start_date?: string;
+        end_date?: string;
+        limit?: number;
+        sort?: 'spend' | 'impressions' | 'clicks' | 'ctr' | 'cpm' | 'cpc';
+        order?: 'asc' | 'desc';
+    }): AxiosPromise<Response<T>>;
+    /**
+     * Get time-based performance metrics by hour and day of week.
+     */
+    static getTimePerformanceReport<T>(params: {
+        start_date: string;
+        end_date: string;
+        community_id?: string;
+        platform?: string;
+    }): AxiosPromise<Response<T>>;
 }
 
 declare class Communities {
@@ -4991,6 +5050,20 @@ declare class Scheduler {
     * @returns promise
     */
     static getDiscordChannels<T>(scheduler_id: string, params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /**
+     * Clear Google Ads OAuth credentials from a promotion schedule.
+     *
+     * @param scheduler_id The ID of the promotion schedule.
+     * @returns promise
+     */
+    static clearGoogleAdsAuth<T>(scheduler_id: string, params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /**
+     * Clear Tiktok Ads OAuth credentials from a promotion schedule.
+     *
+     * @param scheduler_id The ID of the promotion schedule.
+     * @returns promise
+     */
+    static clearTiktokAdsAuth<T>(scheduler_id: string, params?: Record<string, any>): AxiosPromise<Response<T>>;
     /**
      * Get aggregated reports for a promotion schedule.
      *

package/package.json

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

package/src/api/Ads.ts

@@ -744,60 +744,60 @@ class Ads {
     }
 
     // TikTok Uploads: FILE
-public static tiktokUploadImageFile<T>(
-    file: File,
-    data?: object,
-    params?: Record<string, any>,
-    onUploadProgress?: (progressEvent: AxiosProgressEvent) => void
-): AxiosPromise<Response<T>> {
-    return Requests.uploadFile(AdsRoute.routes.tiktokUploadImage.url, 'image_file', file, data, params, onUploadProgress);
-}
+    public static tiktokUploadImageFile<T>(
+        file: File,
+        data?: object,
+        params?: Record<string, any>,
+        onUploadProgress?: (progressEvent: AxiosProgressEvent) => void
+    ): AxiosPromise<Response<T>> {
+        return Requests.uploadFile(AdsRoute.routes.tiktokUploadImage.url, 'image_file', file, data, params, onUploadProgress);
+    }
 
-public static tiktokUploadVideoFile<T>(
-    file: File,
-    data?: object,
-    params?: Record<string, any>,
-    onUploadProgress?: (progressEvent: AxiosProgressEvent) => void
-): AxiosPromise<Response<T>> {
-    return Requests.uploadFile(AdsRoute.routes.tiktokUploadVideo.url, 'video_file', file, data, params, onUploadProgress);
-}
+    public static tiktokUploadVideoFile<T>(
+        file: File,
+        data?: object,
+        params?: Record<string, any>,
+        onUploadProgress?: (progressEvent: AxiosProgressEvent) => void
+    ): AxiosPromise<Response<T>> {
+        return Requests.uploadFile(AdsRoute.routes.tiktokUploadVideo.url, 'video_file', file, data, params, onUploadProgress);
+    }
 
-public static tiktokUploadMusicFile<T>(
-    file: File,
-    data?: object,
-    params?: Record<string, any>,
-    onUploadProgress?: (progressEvent: AxiosProgressEvent) => void
-): AxiosPromise<Response<T>> {
-    return Requests.uploadFile(AdsRoute.routes.tiktokUploadMusic.url, 'music_file', file, data, params, onUploadProgress);
-}
+    public static tiktokUploadMusicFile<T>(
+        file: File,
+        data?: object,
+        params?: Record<string, any>,
+        onUploadProgress?: (progressEvent: AxiosProgressEvent) => void
+    ): AxiosPromise<Response<T>> {
+        return Requests.uploadFile(AdsRoute.routes.tiktokUploadMusic.url, 'music_file', file, data, params, onUploadProgress);
+    }
 
-// TikTok Uploads: BLOB
-public static tiktokUploadImageBlob<T>(
-    blob: Blob,
-    data?: object,
-    params?: Record<string, any>,
-    onUploadProgress?: (progressEvent: AxiosProgressEvent) => void
-): AxiosPromise<Response<T>> {
-    return Requests.uploadBlob(AdsRoute.routes.tiktokUploadImage.url, 'image_file', blob, data, params, onUploadProgress);
-}
+    // TikTok Uploads: BLOB
+    public static tiktokUploadImageBlob<T>(
+        blob: Blob,
+        data?: object,
+        params?: Record<string, any>,
+        onUploadProgress?: (progressEvent: AxiosProgressEvent) => void
+    ): AxiosPromise<Response<T>> {
+        return Requests.uploadBlob(AdsRoute.routes.tiktokUploadImage.url, 'image_file', blob, data, params, onUploadProgress);
+    }
 
-public static tiktokUploadVideoBlob<T>(
-    blob: Blob,
-    data?: object,
-    params?: Record<string, any>,
-    onUploadProgress?: (progressEvent: AxiosProgressEvent) => void
-): AxiosPromise<Response<T>> {
-    return Requests.uploadBlob(AdsRoute.routes.tiktokUploadVideo.url, 'video_file', blob, data, params, onUploadProgress);
-}
+    public static tiktokUploadVideoBlob<T>(
+        blob: Blob,
+        data?: object,
+        params?: Record<string, any>,
+        onUploadProgress?: (progressEvent: AxiosProgressEvent) => void
+    ): AxiosPromise<Response<T>> {
+        return Requests.uploadBlob(AdsRoute.routes.tiktokUploadVideo.url, 'video_file', blob, data, params, onUploadProgress);
+    }
 
-public static tiktokUploadMusicBlob<T>(
-    blob: Blob,
-    data?: object,
-    params?: Record<string, any>,
-    onUploadProgress?: (progressEvent: AxiosProgressEvent) => void
-): AxiosPromise<Response<T>> {
-    return Requests.uploadBlob(AdsRoute.routes.tiktokUploadMusic.url, 'music_file', blob, data, params, onUploadProgress);
-}
+    public static tiktokUploadMusicBlob<T>(
+        blob: Blob,
+        data?: object,
+        params?: Record<string, any>,
+        onUploadProgress?: (progressEvent: AxiosProgressEvent) => void
+    ): AxiosPromise<Response<T>> {
+        return Requests.uploadBlob(AdsRoute.routes.tiktokUploadMusic.url, 'music_file', blob, data, params, onUploadProgress);
+    }
 
     public static tiktokGetMediaInfo<T>(params: Record<string, any>): AxiosPromise<Response<T>> {
         return Requests.processRoute(
@@ -989,6 +989,107 @@ public static tiktokUploadMusicBlob<T>(
         return Requests.processRoute(AdsRoute.routes.twitterTargetingSuggestions, undefined, undefined, params);
     }
 
+    /**
+     * Deep-sync a campaign tree (campaign → groups → ads) with its remote platform.
+     *
+     * @param campaign_id UUID of the campaign to sync
+     * @param params      Optional query params
+     * @returns           Fully-hydrated AdCampaign resource
+     */
+    public static syncCampaignTree<T>(
+        campaign_id: string,
+        params?: Record<string, any>
+    ): AxiosPromise<Response<T>> {
+        return Requests.processRoute(
+            AdsRoute.routes.syncCampaignTree,
+            undefined,
+            { campaign_id },
+            params
+        );
+    }
+
+
+    /**
+    * Deep-sync all the campaigns for a scheduler.
+    *
+    * @param scheduler_id UUID of the campaign to sync
+    * @param params      Optional query params
+    * @returns           Fully-hydrated AdCampaign resource
+    */
+    public static syncSchedulerCampaigns<T>(
+        scheduler_id: string,
+        params?: Record<string, any>
+    ): AxiosPromise<Response<T>> {
+        return Requests.processRoute(
+            AdsRoute.routes.syncSchedulerCampaigns,
+            undefined,
+            { scheduler_id },
+            params
+        );
+    }
+
+    // ----------------------------------------------------------------------
+    // AD REPORTS
+    // ----------------------------------------------------------------------
+
+    /**
+     * Get campaign performance summary.
+     */
+    public static getPerformanceSummary<T>(params?: Record<string, any>): AxiosPromise<Response<T>> {
+        return Requests.processRoute(AdsRoute.routes.getPerformanceSummary, undefined, undefined, params);
+    }
+
+    /**
+     * Get spend and delivery metrics over time.
+     */
+    public static getSpendDeliveryReport<T>(params: {
+        start_date: string;
+        end_date: string;
+        group_by?: 'day' | 'week' | 'month';
+        community_id?: string;
+        platform?: string;
+    }): AxiosPromise<Response<T>> {
+        return Requests.processRoute(AdsRoute.routes.getSpendDeliveryReport, undefined, undefined, params);
+    }
+
+    /**
+     * Compare performance across platforms.
+     */
+    public static getPlatformComparisonReport<T>(params?: {
+        start_date?: string;
+        end_date?: string;
+        community_id?: string;
+    }): AxiosPromise<Response<T>> {
+        return Requests.processRoute(AdsRoute.routes.getPlatformComparisonReport, undefined, undefined, params);
+    }
+
+    /**
+     * Get performance metrics for individual ad creatives.
+     */
+    public static getCreativePerformanceReport<T>(params?: {
+        community_id?: string;
+        platform?: string;
+        start_date?: string;
+        end_date?: string;
+        limit?: number;
+        sort?: 'spend' | 'impressions' | 'clicks' | 'ctr' | 'cpm' | 'cpc';
+        order?: 'asc' | 'desc';
+    }): AxiosPromise<Response<T>> {
+        return Requests.processRoute(AdsRoute.routes.getCreativePerformanceReport, undefined, undefined, params);
+    }
+
+    /**
+     * Get time-based performance metrics by hour and day of week.
+     */
+    public static getTimePerformanceReport<T>(params: {
+        start_date: string;
+        end_date: string;
+        community_id?: string;
+        platform?: string;
+    }): AxiosPromise<Response<T>> {
+        return Requests.processRoute(AdsRoute.routes.getTimePerformanceReport, undefined, undefined, params);
+    }
+
 
 
 }

package/src/api/Scheduler.ts

@@ -107,18 +107,18 @@ class Scheduler {
          *                     `{ id: '<media-uuid>' }`.
          * @returns Axios promise with `{ content, title? }`
          */
-        public static generateTitleContent<T>(
-            scheduler_id: string,
-            data: object,
-            params?: Record<string, any>
-        ): AxiosPromise<Response<T>> {
-            return Requests.processRoute(
-                SchedulerRoute.routes.generateContent,
-                data,                     // request body
-                { scheduler_id },         // path params
-                params                    // query params
-            );
-        }
+    public static generateTitleContent<T>(
+        scheduler_id: string,
+        data: object,
+        params?: Record<string, any>
+    ): AxiosPromise<Response<T>> {
+        return Requests.processRoute(
+            SchedulerRoute.routes.generateContent,
+            data,                     // request body
+            { scheduler_id },         // path params
+            params                    // query params
+        );
+    }
 
 
     /**
@@ -420,6 +420,42 @@ class Scheduler {
         return Requests.processRoute(SchedulerRoute.routes.getDiscordChannels, {}, { scheduler_id }, params);
     }
 
+    /**
+     * Clear Google Ads OAuth credentials from a promotion schedule.
+     *
+     * @param scheduler_id The ID of the promotion schedule.
+     * @returns promise
+     */
+    public static clearGoogleAdsAuth<T>(
+        scheduler_id: string,
+        params?: Record<string, any>
+    ): AxiosPromise<Response<T>> {
+        return Requests.processRoute(
+            SchedulerRoute.routes.clearGoogleAdsAuth,
+            {},                       // no body
+            { scheduler_id },         // path params
+            params                    // optional query params
+        );
+    }
+
+    /**
+     * Clear Tiktok Ads OAuth credentials from a promotion schedule.
+     *
+     * @param scheduler_id The ID of the promotion schedule.
+     * @returns promise
+     */
+    public static clearTiktokAdsAuth<T>(
+        scheduler_id: string,
+        params?: Record<string, any>
+    ): AxiosPromise<Response<T>> {
+        return Requests.processRoute(
+            SchedulerRoute.routes.clearTiktokAdsAuth,
+            {},                       // no body
+            { scheduler_id },         // path params
+            params                    // optional query params
+        );
+    }
+
     /**
      * Get aggregated reports for a promotion schedule.
      *

package/src/routes/AdsRoute.ts

@@ -365,6 +365,42 @@ class AdsRoute {
             url: "/ads/twitter/targeting/suggestions",
             method: HTTP_METHODS.GET,
         },
+        syncCampaignTree: {
+            url: "/ads/campaigns/{campaign_id}/sync_tree",
+            method: HTTP_METHODS.POST,
+        },
+        syncSchedulerCampaigns: {
+            url: "/ads/campaigns/scheduler/{scheduler_id}/syncAll",
+            method: HTTP_METHODS.POST,
+        },
+
+        // ----------------------------------------------------------------
+        // AD REPORTS
+        // ----------------------------------------------------------------
+        getPerformanceSummary: {
+            url: "/ads/reports/summary",
+            method: HTTP_METHODS.GET,
+        },
+
+        getSpendDeliveryReport: {
+            url: "/ads/reports/spend-delivery",
+            method: HTTP_METHODS.GET,
+        },
+
+        getPlatformComparisonReport: {
+            url: "/ads/reports/platform-comparison",
+            method: HTTP_METHODS.GET,
+        },
+
+        getCreativePerformanceReport: {
+            url: "/ads/reports/creative-performance",
+            method: HTTP_METHODS.GET,
+        },
+
+        getTimePerformanceReport: {
+            url: "/ads/reports/time-performance",
+            method: HTTP_METHODS.GET,
+        },
         
     };
 }

package/src/routes/SchedulerRoute.ts

@@ -40,6 +40,8 @@ class SchedulerRoute {
         clearSteamAuth: { url: '/schedulers/{scheduler_id}/clearSteamAuth', method: HTTP_METHODS.DELETE },
         clearDiscordAuth: { url: '/schedulers/{scheduler_id}/clearDiscordAuth', method: HTTP_METHODS.DELETE },
         clearBlueskyAuth: { url: '/schedulers/{scheduler_id}/clearBlueskyAuth', method: HTTP_METHODS.DELETE },
+        clearTiktokAdsAuth:    { url: '/schedulers/{scheduler_id}/clearTiktokAdsAuth',    method: HTTP_METHODS.DELETE },
+        clearGoogleAdsAuth:    { url: '/schedulers/{scheduler_id}/clearGoogleAdsAuth',    method: HTTP_METHODS.DELETE },
 
         //Social Utility Routes
         getFacebookGroups: { url: '/schedulers/{scheduler_id}/facebook/groups', method: HTTP_METHODS.GET },