glitch-javascript-sdk 1.8.4 → 1.8.6

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

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

package/dist/index.d.ts

@@ -893,6 +893,23 @@ declare class Ads {
      * GET /ads/reddit/targeting/third_party_audiences
      */
     static listRedditThirdPartyAudiences<T>(params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /**
+   * Sync an Ad Campaign with the remote platform
+   *
+   * @param campaign_id The UUID of the campaign to sync
+   * @param params Optional query parameters
+   * @returns The synced AdCampaign resource
+   */
+    static syncCampaign<T>(campaign_id: string, params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /**
+     * Sync an Ad Group with the remote platform
+     *
+     * @param campaign_id The UUID of the parent campaign
+     * @param group_id The UUID of the ad group to sync
+     * @param params Optional query parameters
+     * @returns The synced AdGroup resource
+     */
+    static syncGroup<T>(campaign_id: string, group_id: string, params?: Record<string, any>): AxiosPromise<Response<T>>;
 }
 
 declare class Communities {
@@ -2270,6 +2287,136 @@ declare class Events {
     static getStreamViewCounts<T>(event_id: string, params?: Record<string, any>): AxiosPromise<Response<T>>;
 }
 
+declare class Fingerprinting {
+    /**
+     * List identified user fingerprints with filtering options
+     *
+     * @param params Filtering options:
+     *   - title_id?: string - Filter by title ID
+     *   - device_id?: string - Filter by device ID
+     *   - user_install_id?: string - Filter by user install ID
+     *   - browser_fingerprint?: string - Filter by browser fingerprint hash
+     *   - device_fingerprint?: string - Filter by device fingerprint hash
+     *   - is_bot?: boolean - Filter by bot status
+     *   - start_date?: string - Start date (YYYY-MM-DD)
+     *   - end_date?: string - End date (YYYY-MM-DD)
+     *   - sort?: 'first_seen_at'|'last_seen_at'|'match_confidence' - Sort field
+     *   - order?: 'asc'|'desc' - Sort order
+     *   - per_page?: number - Items per page (max 100)
+     * @returns Promise with paginated fingerprints data
+     */
+    static listFingerprints<T>(params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /**
+     * Get cross-platform user journey reports
+     *
+     * @param params Report options:
+     *   - title_id: string - Required title ID
+     *   - fingerprint_id?: string - Specific fingerprint ID to analyze
+     *   - start_date?: string - Start date (YYYY-MM-DD)
+     *   - end_date?: string - End date (YYYY-MM-DD)
+     *   - platform?: 'web'|'ios'|'android'|'steam'|'console' - Filter by platform
+     *   - event_type?: string - Filter by event type
+     *   - group_by?: 'day'|'week'|'month'|'year' - Grouping period
+     *   - include_paths?: boolean - Include journey paths in response
+     * @returns Promise with user journey report data
+     */
+    static userJourneyReport<T>(params: Record<string, any>): AxiosPromise<Response<T>>;
+    /**
+     * Get cross-platform attribution reports
+     *
+     * @param params Report options:
+     *   - title_id: string - Required title ID
+     *   - start_date?: string - Start date (YYYY-MM-DD)
+     *   - end_date?: string - End date (YYYY-MM-DD)
+     *   - conversion_event?: 'game_install'|'game_purchase'|'web_event' - Conversion event to analyze
+     *   - attribution_model?: 'first_touch'|'last_touch'|'linear'|'time_decay'|'position_based' - Attribution model
+     * @returns Promise with attribution report data
+     */
+    static attributionReport<T>(params: Record<string, any>): AxiosPromise<Response<T>>;
+    /**
+     * Get cross-device identity clusters
+     *
+     * @param params Report options:
+     *   - title_id: string - Required title ID
+     *   - start_date?: string - Start date (YYYY-MM-DD)
+     *   - end_date?: string - End date (YYYY-MM-DD)
+     *   - min_confidence?: number - Minimum match confidence score (0-100)
+     * @returns Promise with device cluster report data
+     */
+    static deviceClusterReport<T>(params: Record<string, any>): AxiosPromise<Response<T>>;
+    /**
+     * Get combined identity clusters and user journey reports
+     *
+     * @param params Report options:
+     *   - title_id: string - Required title ID
+     *   - start_date?: string - Start date (YYYY-MM-DD)
+     *   - end_date?: string - End date (YYYY-MM-DD)
+     *   - min_confidence?: number - Minimum confidence score to include (0-100)
+     *   - platform?: string - Filter by platform
+     *   - include_journeys?: boolean - Include detailed journeys
+     * @returns Promise with identity cluster report data
+     */
+    static identityClusterReport<T>(params: Record<string, any>): AxiosPromise<Response<T>>;
+    /**
+     * Get combined attribution paths and conversion funnels
+     *
+     * @param params Report options:
+     *   - title_id: string - Required title ID
+     *   - start_date?: string - Start date (YYYY-MM-DD)
+     *   - end_date?: string - End date (YYYY-MM-DD)
+     *   - conversion_event?: string - Conversion event type
+     *   - attribution_model?: string - Attribution model
+     *   - funnel_steps?: string - Comma-separated funnel steps
+     * @returns Promise with attribution and funnel report data
+     */
+    static attributionFunnelReport<T>(params: Record<string, any>): AxiosPromise<Response<T>>;
+    /**
+     * Get device and environment breakdown reports
+     *
+     * @param params Report options:
+     *   - title_id: string - Required title ID
+     *   - start_date?: string - Start date (YYYY-MM-DD)
+     *   - end_date?: string - End date (YYYY-MM-DD)
+     *   - platform?: string - Filter by platform
+     *   - group_by?: 'device_type'|'os'|'browser'|'country_code' - Grouping field
+     * @returns Promise with device and environment report data
+     */
+    static deviceEnvironmentReport<T>(params: Record<string, any>): AxiosPromise<Response<T>>;
+    /**
+     * Get unique vs returning user metrics
+     *
+     * @param params Report options:
+     *   - title_id: string - Required title ID
+     *   - start_date?: string - Start date (YYYY-MM-DD)
+     *   - end_date?: string - End date (YYYY-MM-DD)
+     *   - retention_period?: number - Days to consider for retention
+     * @returns Promise with retention metrics data
+     */
+    static uniqueReturningReport<T>(params: Record<string, any>): AxiosPromise<Response<T>>;
+    /**
+     * Get fraud and bot detection metrics
+     *
+     * @param params Report options:
+     *   - title_id: string - Required title ID
+     *   - start_date?: string - Start date (YYYY-MM-DD)
+     *   - end_date?: string - End date (YYYY-MM-DD)
+     *   - min_confidence?: number - Minimum confidence score to flag (0-100)
+     * @returns Promise with fraud detection data
+     */
+    static fraudDetectionReport<T>(params: Record<string, any>): AxiosPromise<Response<T>>;
+    /**
+     * Get geolocation distribution of users
+     *
+     * @param params Report options:
+     *   - title_id: string - Required title ID
+     *   - start_date?: string - Start date (YYYY-MM-DD)
+     *   - end_date?: string - End date (YYYY-MM-DD)
+     *   - group_by?: 'country'|'region'|'city' - Grouping level
+     * @returns Promise with geolocation report data
+     */
+    static geolocationReport<T>(params: Record<string, any>): AxiosPromise<Response<T>>;
+}
+
 declare class Teams {
     /**
      * List all the teams
@@ -5510,6 +5657,7 @@ declare class Glitch {
         Funnel: typeof Funnel;
         SocialStats: typeof SocialStats;
         WebsiteAnalytics: typeof WebsiteAnalytics;
+        Fingerprinting: typeof Fingerprinting;
     };
     static util: {
         Requests: typeof Requests;

package/package.json

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

package/src/api/Ads.ts

@@ -480,86 +480,126 @@ class Ads {
    * Example usage:
    *   Ads.listRedditCarriers({ scheduler_id: 'uuid-of-scheduler', 'page.size': 50 })
    */
-  public static listRedditCarriers<T>(params?: Record<string, any>): AxiosPromise<Response<T>> {
-    return Requests.processRoute(
-      AdsRoute.routes.getRedditCarriers,
-      undefined,
-      undefined,
-      params
-    );
-  }
-
-  /**
-   * GET /ads/reddit/targeting/communities?names=sub1,sub2
-   */
-  public static listRedditCommunities<T>(params?: Record<string, any>): AxiosPromise<Response<T>> {
-    return Requests.processRoute(
-      AdsRoute.routes.getRedditCommunities,
-      undefined,
-      undefined,
-      params
-    );
-  }
-
-  /**
-   * GET /ads/reddit/targeting/communities/search?query=xyz
-   */
-  public static searchRedditCommunities<T>(params?: Record<string, any>): AxiosPromise<Response<T>> {
-    return Requests.processRoute(
-      AdsRoute.routes.searchRedditCommunities,
-      undefined,
-      undefined,
-      params
-    );
-  }
-
-  /**
-   * GET /ads/reddit/targeting/devices
-   */
-  public static listRedditDevices<T>(params?: Record<string, any>): AxiosPromise<Response<T>> {
-    return Requests.processRoute(
-      AdsRoute.routes.getRedditDevices,
-      undefined,
-      undefined,
-      params
-    );
-  }
-
-  /**
-   * GET /ads/reddit/targeting/geolocations
-   */
-  public static listRedditGeolocations<T>(params?: Record<string, any>): AxiosPromise<Response<T>> {
-    return Requests.processRoute(
-      AdsRoute.routes.getRedditGeolocations,
-      undefined,
-      undefined,
-      params
-    );
-  }
-
-  /**
-   * GET /ads/reddit/targeting/interests
-   */
-  public static listRedditInterests<T>(params?: Record<string, any>): AxiosPromise<Response<T>> {
-    return Requests.processRoute(
-      AdsRoute.routes.getRedditInterests,
-      undefined,
-      undefined,
-      params
-    );
-  }
-
-  /**
-   * GET /ads/reddit/targeting/third_party_audiences
+    public static listRedditCarriers<T>(params?: Record<string, any>): AxiosPromise<Response<T>> {
+        return Requests.processRoute(
+            AdsRoute.routes.getRedditCarriers,
+            undefined,
+            undefined,
+            params
+        );
+    }
+
+    /**
+     * GET /ads/reddit/targeting/communities?names=sub1,sub2
+     */
+    public static listRedditCommunities<T>(params?: Record<string, any>): AxiosPromise<Response<T>> {
+        return Requests.processRoute(
+            AdsRoute.routes.getRedditCommunities,
+            undefined,
+            undefined,
+            params
+        );
+    }
+
+    /**
+     * GET /ads/reddit/targeting/communities/search?query=xyz
+     */
+    public static searchRedditCommunities<T>(params?: Record<string, any>): AxiosPromise<Response<T>> {
+        return Requests.processRoute(
+            AdsRoute.routes.searchRedditCommunities,
+            undefined,
+            undefined,
+            params
+        );
+    }
+
+    /**
+     * GET /ads/reddit/targeting/devices
+     */
+    public static listRedditDevices<T>(params?: Record<string, any>): AxiosPromise<Response<T>> {
+        return Requests.processRoute(
+            AdsRoute.routes.getRedditDevices,
+            undefined,
+            undefined,
+            params
+        );
+    }
+
+    /**
+     * GET /ads/reddit/targeting/geolocations
+     */
+    public static listRedditGeolocations<T>(params?: Record<string, any>): AxiosPromise<Response<T>> {
+        return Requests.processRoute(
+            AdsRoute.routes.getRedditGeolocations,
+            undefined,
+            undefined,
+            params
+        );
+    }
+
+    /**
+     * GET /ads/reddit/targeting/interests
+     */
+    public static listRedditInterests<T>(params?: Record<string, any>): AxiosPromise<Response<T>> {
+        return Requests.processRoute(
+            AdsRoute.routes.getRedditInterests,
+            undefined,
+            undefined,
+            params
+        );
+    }
+
+    /**
+     * GET /ads/reddit/targeting/third_party_audiences
+     */
+    public static listRedditThirdPartyAudiences<T>(params?: Record<string, any>): AxiosPromise<Response<T>> {
+        return Requests.processRoute(
+            AdsRoute.routes.getRedditThirdPartyAudiences,
+            undefined,
+            undefined,
+            params
+        );
+    }
+
+    /**
+   * Sync an Ad Campaign with the remote platform
+   * 
+   * @param campaign_id The UUID of the campaign to sync
+   * @param params Optional query parameters
+   * @returns The synced AdCampaign resource
    */
-  public static listRedditThirdPartyAudiences<T>(params?: Record<string, any>): AxiosPromise<Response<T>> {
-    return Requests.processRoute(
-      AdsRoute.routes.getRedditThirdPartyAudiences,
-      undefined,
-      undefined,
-      params
-    );
-  }
+    public static syncCampaign<T>(
+        campaign_id: string,
+        params?: Record<string, any>
+    ): AxiosPromise<Response<T>> {
+        return Requests.processRoute(
+            AdsRoute.routes.syncCampaign,
+            undefined,
+            { campaign_id },
+            params
+        );
+    }
+
+    /**
+     * Sync an Ad Group with the remote platform
+     * 
+     * @param campaign_id The UUID of the parent campaign
+     * @param group_id The UUID of the ad group to sync
+     * @param params Optional query parameters
+     * @returns The synced AdGroup resource
+     */
+    public static syncGroup<T>(
+        campaign_id: string,
+        group_id: string,
+        params?: Record<string, any>
+    ): AxiosPromise<Response<T>> {
+        return Requests.processRoute(
+            AdsRoute.routes.syncGroup,
+            undefined,
+            { campaign_id, group_id },
+            params
+        );
+    }
 
 }
 

package/src/api/Fingerprinting.ts

@@ -0,0 +1,215 @@
+import FingerprintingRoute from "../routes/FingerprintingRoute";
+import Requests from "../util/Requests";
+import Response from "../util/Response";
+import { AxiosPromise } from "axios";
+
+class Fingerprinting {
+  /**
+   * List identified user fingerprints with filtering options
+   * 
+   * @param params Filtering options:
+   *   - title_id?: string - Filter by title ID
+   *   - device_id?: string - Filter by device ID
+   *   - user_install_id?: string - Filter by user install ID
+   *   - browser_fingerprint?: string - Filter by browser fingerprint hash
+   *   - device_fingerprint?: string - Filter by device fingerprint hash
+   *   - is_bot?: boolean - Filter by bot status
+   *   - start_date?: string - Start date (YYYY-MM-DD)
+   *   - end_date?: string - End date (YYYY-MM-DD)
+   *   - sort?: 'first_seen_at'|'last_seen_at'|'match_confidence' - Sort field
+   *   - order?: 'asc'|'desc' - Sort order
+   *   - per_page?: number - Items per page (max 100)
+   * @returns Promise with paginated fingerprints data
+   */
+  public static listFingerprints<T>(params?: Record<string, any>): AxiosPromise<Response<T>> {
+    return Requests.processRoute(
+      FingerprintingRoute.routes.listFingerprints,
+      {},
+      undefined,
+      params
+    );
+  }
+
+  /**
+   * Get cross-platform user journey reports
+   * 
+   * @param params Report options:
+   *   - title_id: string - Required title ID
+   *   - fingerprint_id?: string - Specific fingerprint ID to analyze
+   *   - start_date?: string - Start date (YYYY-MM-DD)
+   *   - end_date?: string - End date (YYYY-MM-DD)
+   *   - platform?: 'web'|'ios'|'android'|'steam'|'console' - Filter by platform
+   *   - event_type?: string - Filter by event type
+   *   - group_by?: 'day'|'week'|'month'|'year' - Grouping period
+   *   - include_paths?: boolean - Include journey paths in response
+   * @returns Promise with user journey report data
+   */
+  public static userJourneyReport<T>(params: Record<string, any>): AxiosPromise<Response<T>> {
+    return Requests.processRoute(
+      FingerprintingRoute.routes.userJourneyReport,
+      {},
+      undefined,
+      params
+    );
+  }
+
+  /**
+   * Get cross-platform attribution reports
+   * 
+   * @param params Report options:
+   *   - title_id: string - Required title ID
+   *   - start_date?: string - Start date (YYYY-MM-DD)
+   *   - end_date?: string - End date (YYYY-MM-DD)
+   *   - conversion_event?: 'game_install'|'game_purchase'|'web_event' - Conversion event to analyze
+   *   - attribution_model?: 'first_touch'|'last_touch'|'linear'|'time_decay'|'position_based' - Attribution model
+   * @returns Promise with attribution report data
+   */
+  public static attributionReport<T>(params: Record<string, any>): AxiosPromise<Response<T>> {
+    return Requests.processRoute(
+      FingerprintingRoute.routes.attributionReport,
+      {},
+      undefined,
+      params
+    );
+  }
+
+  /**
+   * Get cross-device identity clusters
+   * 
+   * @param params Report options:
+   *   - title_id: string - Required title ID
+   *   - start_date?: string - Start date (YYYY-MM-DD)
+   *   - end_date?: string - End date (YYYY-MM-DD)
+   *   - min_confidence?: number - Minimum match confidence score (0-100)
+   * @returns Promise with device cluster report data
+   */
+  public static deviceClusterReport<T>(params: Record<string, any>): AxiosPromise<Response<T>> {
+    return Requests.processRoute(
+      FingerprintingRoute.routes.deviceClusterReport,
+      {},
+      undefined,
+      params
+    );
+  }
+
+  /**
+   * Get combined identity clusters and user journey reports
+   * 
+   * @param params Report options:
+   *   - title_id: string - Required title ID
+   *   - start_date?: string - Start date (YYYY-MM-DD)
+   *   - end_date?: string - End date (YYYY-MM-DD)
+   *   - min_confidence?: number - Minimum confidence score to include (0-100)
+   *   - platform?: string - Filter by platform
+   *   - include_journeys?: boolean - Include detailed journeys
+   * @returns Promise with identity cluster report data
+   */
+  public static identityClusterReport<T>(params: Record<string, any>): AxiosPromise<Response<T>> {
+    return Requests.processRoute(
+      FingerprintingRoute.routes.identityClusterReport,
+      {},
+      undefined,
+      params
+    );
+  }
+
+  /**
+   * Get combined attribution paths and conversion funnels
+   * 
+   * @param params Report options:
+   *   - title_id: string - Required title ID
+   *   - start_date?: string - Start date (YYYY-MM-DD)
+   *   - end_date?: string - End date (YYYY-MM-DD)
+   *   - conversion_event?: string - Conversion event type
+   *   - attribution_model?: string - Attribution model
+   *   - funnel_steps?: string - Comma-separated funnel steps
+   * @returns Promise with attribution and funnel report data
+   */
+  public static attributionFunnelReport<T>(params: Record<string, any>): AxiosPromise<Response<T>> {
+    return Requests.processRoute(
+      FingerprintingRoute.routes.attributionFunnelReport,
+      {},
+      undefined,
+      params
+    );
+  }
+
+  /**
+   * Get device and environment breakdown reports
+   * 
+   * @param params Report options:
+   *   - title_id: string - Required title ID
+   *   - start_date?: string - Start date (YYYY-MM-DD)
+   *   - end_date?: string - End date (YYYY-MM-DD)
+   *   - platform?: string - Filter by platform
+   *   - group_by?: 'device_type'|'os'|'browser'|'country_code' - Grouping field
+   * @returns Promise with device and environment report data
+   */
+  public static deviceEnvironmentReport<T>(params: Record<string, any>): AxiosPromise<Response<T>> {
+    return Requests.processRoute(
+      FingerprintingRoute.routes.deviceEnvironmentReport,
+      {},
+      undefined,
+      params
+    );
+  }
+
+  /**
+   * Get unique vs returning user metrics
+   * 
+   * @param params Report options:
+   *   - title_id: string - Required title ID
+   *   - start_date?: string - Start date (YYYY-MM-DD)
+   *   - end_date?: string - End date (YYYY-MM-DD)
+   *   - retention_period?: number - Days to consider for retention
+   * @returns Promise with retention metrics data
+   */
+  public static uniqueReturningReport<T>(params: Record<string, any>): AxiosPromise<Response<T>> {
+    return Requests.processRoute(
+      FingerprintingRoute.routes.uniqueReturningReport,
+      {},
+      undefined,
+      params
+    );
+  }
+
+  /**
+   * Get fraud and bot detection metrics
+   * 
+   * @param params Report options:
+   *   - title_id: string - Required title ID
+   *   - start_date?: string - Start date (YYYY-MM-DD)
+   *   - end_date?: string - End date (YYYY-MM-DD)
+   *   - min_confidence?: number - Minimum confidence score to flag (0-100)
+   * @returns Promise with fraud detection data
+   */
+  public static fraudDetectionReport<T>(params: Record<string, any>): AxiosPromise<Response<T>> {
+    return Requests.processRoute(
+      FingerprintingRoute.routes.fraudDetectionReport,
+      {},
+      undefined,
+      params
+    );
+  }
+
+  /**
+   * Get geolocation distribution of users
+   * 
+   * @param params Report options:
+   *   - title_id: string - Required title ID
+   *   - start_date?: string - Start date (YYYY-MM-DD)
+   *   - end_date?: string - End date (YYYY-MM-DD)
+   *   - group_by?: 'country'|'region'|'city' - Grouping level
+   * @returns Promise with geolocation report data
+   */
+  public static geolocationReport<T>(params: Record<string, any>): AxiosPromise<Response<T>> {
+    return Requests.processRoute(
+      FingerprintingRoute.routes.geolocationReport,
+      {},
+      undefined,
+      params
+    );
+  }
+}
+
+export default Fingerprinting;

package/src/api/index.ts

@@ -4,6 +4,7 @@ import Competitions from "./Competitions";
 import Communities from "./Communities";
 import Users from "./Users";
 import Events from "./Events";
+import Fingerprinting from "./Fingerprinting";
 import Teams from "./Teams";
 import Waitlists from "./Waitlist";
 import Posts from "./Posts";
@@ -66,4 +67,5 @@ export {Scheduler};
 export {Funnel};
 export {SocialStats};
 export {Hashtags};
-export {WebsiteAnalytics};
+export {WebsiteAnalytics};
+export {Fingerprinting};

package/src/index.ts

@@ -36,6 +36,7 @@ import {Funnel} from "./api";
 import {SocialStats} from "./api";
 import {Hashtags} from "./api";
 import {WebsiteAnalytics} from "./api";
+import {Fingerprinting} from "./api";
 
 import Requests from "./util/Requests";
 import Parser from "./util/Parser";
@@ -100,7 +101,8 @@ class Glitch {
         Scheduler : Scheduler,
         Funnel: Funnel,
         SocialStats : SocialStats,
-        WebsiteAnalytics: WebsiteAnalytics
+        WebsiteAnalytics: WebsiteAnalytics,
+        Fingerprinting : Fingerprinting
     }
 
     public static util = {

package/src/routes/AdsRoute.ts

@@ -166,6 +166,15 @@ class AdsRoute {
             url: "/ads/reddit/targeting/third_party_audiences",
             method: HTTP_METHODS.GET,
         },
+        syncCampaign: {
+            url: "/ads/campaigns/{campaign_id}/sync",
+            method: HTTP_METHODS.POST,
+        },
+        
+        syncGroup: {
+            url: "/ads/campaigns/{campaign_id}/groups/{group_id}/sync",
+            method: HTTP_METHODS.POST,
+        },
     };
 }