glitch-javascript-sdk 1.9.4 → 1.9.6

package/dist/esm/routes/AIUsageRoute.d.ts

@@ -0,0 +1,7 @@
+import Route from "./interface";
+declare class AIUsageRoute {
+    static routes: {
+        [key: string]: Route;
+    };
+}
+export default AIUsageRoute;

package/dist/esm/routes/ShortLinksRoute.d.ts

@@ -0,0 +1,7 @@
+import Route from "./interface";
+declare class ShortLinksRoute {
+    static routes: {
+        [key: string]: Route;
+    };
+}
+export default ShortLinksRoute;

package/dist/index.d.ts

@@ -1016,6 +1016,49 @@ declare class Ads {
     * @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 {
@@ -3566,6 +3609,22 @@ declare class Titles {
      * @returns AxiosPromise
      */
     static analyzeUtmAnalytics<T>(title_id: string, params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /**
+     * List all chat sessions for a title.
+     */
+    static chatListSessions<T>(title_id: string, params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /**
+     * Get a specific chat session and its messages.
+     */
+    static chatShowSession<T>(title_id: string, session_id: string, params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /**
+     * Search messages across all sessions of a title.
+     */
+    static chatListMessages<T>(title_id: string, params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /**
+     * Update a specific chat message.
+     */
+    static chatUpdateMessage<T>(title_id: string, message_id: string, data: object): AxiosPromise<Response<T>>;
 }
 
 declare class Campaigns {
@@ -5449,6 +5508,46 @@ declare class WebsiteAnalytics {
     static utmPerformance<T>(params?: Record<string, any>): AxiosPromise<Response<T>>;
 }
 
+declare class ShortLinks {
+    /**
+     * List all short links with optional filters
+     */
+    static list<T>(params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /**
+     * Create a new short link
+     */
+    static create<T>(data: object, params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /**
+     * Get a specific short link by ID
+     */
+    static view<T>(id: string, params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /**
+     * Update a short link
+     */
+    static update<T>(id: string, data: object, params?: Record<string, any>): AxiosPromise<Response<T>>;
+}
+
+declare class AIUsage {
+    /**
+     * List all AI usage entries with optional filters (date range, service, model, etc.).
+     *
+     * @see https://api.glitch.fun/api/documentation#/AI%20Usage/getAIUsage
+     *
+     * @param params Query parameters for filtering and grouping
+     * @returns AxiosPromise
+     */
+    static list<T>(params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /**
+     * Get summarized AI usage statistics (token totals, cost, grouped by service/model).
+     *
+     * @see https://api.glitch.fun/api/documentation#/AI%20Usage/getAIUsageSummary
+     *
+     * @param params Query parameters for filtering by date range
+     * @returns AxiosPromise
+     */
+    static summary<T>(params?: Record<string, any>): AxiosPromise<Response<T>>;
+}
+
 interface Route {
     url: string;
     method: string;
@@ -5791,6 +5890,8 @@ declare class Glitch {
         SocialStats: typeof SocialStats;
         WebsiteAnalytics: typeof WebsiteAnalytics;
         Fingerprinting: typeof Fingerprinting;
+        ShortLinks: typeof ShortLinks;
+        AIUsage: typeof AIUsage;
     };
     static util: {
         Requests: typeof Requests;

package/package.json

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

package/src/api/AIUsage.ts

@@ -0,0 +1,32 @@
+import AIUsageRoute from "../routes/AIUsageRoute";
+import Requests from "../util/Requests";
+import Response from "../util/Response";
+import { AxiosPromise } from "axios";
+
+class AIUsage {
+  /**
+   * List all AI usage entries with optional filters (date range, service, model, etc.).
+   * 
+   * @see https://api.glitch.fun/api/documentation#/AI%20Usage/getAIUsage
+   * 
+   * @param params Query parameters for filtering and grouping
+   * @returns AxiosPromise
+   */
+  public static list<T>(params?: Record<string, any>): AxiosPromise<Response<T>> {
+    return Requests.processRoute(AIUsageRoute.routes.listUsage, undefined, undefined, params);
+  }
+
+  /**
+   * Get summarized AI usage statistics (token totals, cost, grouped by service/model).
+   * 
+   * @see https://api.glitch.fun/api/documentation#/AI%20Usage/getAIUsageSummary
+   * 
+   * @param params Query parameters for filtering by date range
+   * @returns AxiosPromise
+   */
+  public static summary<T>(params?: Record<string, any>): AxiosPromise<Response<T>> {
+    return Requests.processRoute(AIUsageRoute.routes.summaryUsage, undefined, undefined, params);
+  }
+}
+
+export default AIUsage;

package/src/api/Ads.ts

@@ -1028,6 +1028,69 @@ class Ads {
         );
     }
 
+    // ----------------------------------------------------------------------
+    // 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/ShortLinks.ts

@@ -0,0 +1,41 @@
+import ShortLinksRoute from "../routes/ShortLinksRoute";
+import Requests from "../util/Requests";
+import Response from "../util/Response";
+import { AxiosPromise } from "axios";
+
+class ShortLinks {
+  /**
+   * List all short links with optional filters
+   */
+  public static list<T>(params?: Record<string, any>): AxiosPromise<Response<T>> {
+    return Requests.processRoute(ShortLinksRoute.routes.listShortLinks, undefined, undefined, params);
+  }
+
+  /**
+   * Create a new short link
+   */
+  public static create<T>(data: object, params?: Record<string, any>): AxiosPromise<Response<T>> {
+    return Requests.processRoute(ShortLinksRoute.routes.createShortLink, data, {}, params);
+  }
+
+  /**
+   * Get a specific short link by ID
+   */
+  public static view<T>(id: string, params?: Record<string, any>): AxiosPromise<Response<T>> {
+    return Requests.processRoute(ShortLinksRoute.routes.viewShortLink, {}, { id }, params);
+  }
+
+  /**
+   * Update a short link
+   */
+  public static update<T>(id: string, data: object, params?: Record<string, any>): AxiosPromise<Response<T>> {
+    return Requests.processRoute(ShortLinksRoute.routes.updateShortLink, data, { id }, params);
+  }
+
+  // Uncomment when delete is supported
+  // public static delete<T>(id: string, params?: Record<string, any>): AxiosPromise<Response<T>> {
+  //   return Requests.processRoute(ShortLinksRoute.routes.deleteShortLink, {}, { id }, params);
+  // }
+}
+
+export default ShortLinks;

package/src/api/Titles.ts

@@ -409,15 +409,15 @@ class Titles {
         );
     }
 
-  /**
-   * Upload a CSV/Excel file containing daily UTM analytics for a specific title.
-   * 
-   * @param title_id The UUID of the title
-   * @param file The CSV or Excel file
-   * @param data Optional form fields (if needed)
-   * @param params Optional query parameters
-   * @returns AxiosPromise
-   */
+    /**
+     * Upload a CSV/Excel file containing daily UTM analytics for a specific title.
+     * 
+     * @param title_id The UUID of the title
+     * @param file The CSV or Excel file
+     * @param data Optional form fields (if needed)
+     * @param params Optional query parameters
+     * @returns AxiosPromise
+     */
     public static importUtmAnalytics<T>(
         title_id: string,
         file: File | Blob,
@@ -491,6 +491,68 @@ class Titles {
         );
     }
 
+    /**
+     * List all chat sessions for a title.
+     */
+    public static chatListSessions<T>(
+        title_id: string,
+        params?: Record<string, any>
+    ): AxiosPromise<Response<T>> {
+        return Requests.processRoute(
+            TitlesRoute.routes.chatListSessions,
+            {},
+            { title_id },
+            params
+        );
+    }
+
+    /**
+     * Get a specific chat session and its messages.
+     */
+    public static chatShowSession<T>(
+        title_id: string,
+        session_id: string,
+        params?: Record<string, any>
+    ): AxiosPromise<Response<T>> {
+        return Requests.processRoute(
+            TitlesRoute.routes.chatShowSession,
+            {},
+            { title_id, session_id },
+            params
+        );
+    }
+
+    /**
+     * Search messages across all sessions of a title.
+     */
+    public static chatListMessages<T>(
+        title_id: string,
+        params?: Record<string, any>
+    ): AxiosPromise<Response<T>> {
+        return Requests.processRoute(
+            TitlesRoute.routes.chatListMessages,
+            {},
+            { title_id },
+            params
+        );
+    }
+
+    /**
+     * Update a specific chat message.
+     */
+    public static chatUpdateMessage<T>(
+        title_id: string,
+        message_id: string,
+        data: object
+    ): AxiosPromise<Response<T>> {
+        return Requests.processRoute(
+            TitlesRoute.routes.chatUpdateMessage,
+            data,
+            { title_id, message_id }
+        );
+    }
+
+
 
 }
 

package/src/api/index.ts

@@ -33,6 +33,8 @@ import Funnel from "./Funnel";
 import SocialStats from "./SocialStats";
 import Hashtags from "./Hashtags";
 import WebsiteAnalytics from "./WebsiteAnalytics";
+import ShortLinks from "./ShortLinks";
+import AIUsage from "./AIUsage";
 
 export {Ads};
 export {Auth};
@@ -68,4 +70,6 @@ export {Funnel};
 export {SocialStats};
 export {Hashtags};
 export {WebsiteAnalytics};
-export {Fingerprinting};
+export {Fingerprinting};
+export {ShortLinks};
+export {AIUsage};

package/src/index.ts

@@ -37,6 +37,8 @@ import {SocialStats} from "./api";
 import {Hashtags} from "./api";
 import {WebsiteAnalytics} from "./api";
 import {Fingerprinting} from "./api";
+import {ShortLinks} from "./api";
+import {AIUsage} from "./api";
 
 import Requests from "./util/Requests";
 import Parser from "./util/Parser";
@@ -102,7 +104,9 @@ class Glitch {
         Funnel: Funnel,
         SocialStats : SocialStats,
         WebsiteAnalytics: WebsiteAnalytics,
-        Fingerprinting : Fingerprinting
+        Fingerprinting : Fingerprinting,
+        ShortLinks : ShortLinks,
+        AIUsage : AIUsage
     }
 
     public static util = {

package/src/routes/AIUsageRoute.ts

@@ -0,0 +1,11 @@
+import Route from "./interface";
+import HTTP_METHODS from "../constants/HttpMethods";
+
+class AIUsageRoute {
+  public static routes: { [key: string]: Route } = {
+    listUsage: { url: '/billing/ai-usage', method: HTTP_METHODS.GET },
+    summaryUsage: { url: '/billing/ai-usage/summary', method: HTTP_METHODS.GET }
+  };
+}
+
+export default AIUsageRoute;

package/src/routes/AdsRoute.ts

@@ -373,6 +373,34 @@ class AdsRoute {
             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/ShortLinksRoute.ts

@@ -0,0 +1,15 @@
+import Route from "./interface";
+import HTTP_METHODS from "../constants/HttpMethods";
+
+class ShortLinksRoute {
+  public static routes: { [key: string]: Route } = {
+    listShortLinks:    { url: '/shortlinks', method: HTTP_METHODS.GET },
+    createShortLink:   { url: '/shortlinks', method: HTTP_METHODS.POST },
+    viewShortLink:     { url: '/shortlinks/{id}', method: HTTP_METHODS.GET },
+    updateShortLink:   { url: '/shortlinks/{id}', method: HTTP_METHODS.PUT },
+    // Delete can be added if supported
+    // deleteShortLink:   { url: '/shortlinks/{id}', method: HTTP_METHODS.DELETE }
+  };
+}
+
+export default ShortLinksRoute;

package/src/routes/TitlesRoute.ts

@@ -76,6 +76,23 @@ class TitlesRoute {
       method: HTTP_METHODS.GET,
     },
 
+    chatListSessions: {
+      url: '/titles/{title_id}/chat/sessions',
+      method: HTTP_METHODS.GET
+    },
+    chatShowSession: {
+      url: '/titles/{title_id}/chat/sessions/{session_id}',
+      method: HTTP_METHODS.GET
+    },
+    chatListMessages: {
+      url: '/titles/{title_id}/chat/messages',
+      method: HTTP_METHODS.GET
+    },
+    chatUpdateMessage: {
+      url: '/titles/{title_id}/chat/messages/{message_id}',
+      method: HTTP_METHODS.PUT
+    },
+
   };
 
 }