glitch-javascript-sdk 2.1.1 → 2.1.3

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

@@ -150,5 +150,16 @@ declare class Fingerprinting {
      * @returns Promise with geolocation report data
      */
     static installJourneyReport<T>(params: Record<string, any>): AxiosPromise<Response<T>>;
+    /**
+     * Get how the ad campaigns are performing and turning into installs
+     *
+     * @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 adCampaignPerformanceReport<T>(params: Record<string, any>): AxiosPromise<Response<T>>;
 }
 export default Fingerprinting;

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

@@ -1,5 +1,51 @@
 import Response from "../util/Response";
 import { AxiosProgressEvent, AxiosPromise } from "axios";
+export interface SteamCapsuleCropRequest {
+    media_id: string;
+    capsule_type: 'header' | 'small' | 'main' | 'vertical' | 'library' | 'library_header' | 'library_hero' | 'page_background';
+    crop_x?: number;
+    crop_y?: number;
+    crop_width?: number;
+    crop_height?: number;
+}
+export interface SteamCapsuleAnalysisRequest {
+    media_id: string;
+    capsule_type: 'header' | 'small' | 'main' | 'vertical' | 'library' | 'library_header' | 'library_hero' | 'page_background';
+    game_name?: string;
+    game_genre?: string;
+}
+export interface SteamCapsuleDimensions {
+    width: number;
+    height: number;
+}
+export interface SteamCapsuleCropResponse {
+    media: any;
+    download_url: string;
+    dimensions: SteamCapsuleDimensions;
+    capsule_type: string;
+}
+export interface CategoryScores {
+    visual_hierarchy: number;
+    title_readability: number;
+    genre_communication: number;
+    brand_identity: number;
+    composition_balance: number;
+    art_style: number;
+    emotional_impact: number;
+    steam_compliance: number;
+}
+export interface SteamCapsuleAnalysisResponse {
+    media_id: string;
+    capsule_type: string;
+    dimensions: SteamCapsuleDimensions;
+    overall_score: number;
+    category_scores: CategoryScores;
+    strengths: string[];
+    improvements: string[];
+    recommendations: string[];
+    ai_description: string;
+    guidelines: any;
+}
 declare class Media {
     /**
      * Upload media content using a File object.
@@ -33,5 +79,39 @@ declare class Media {
      * @returns promise
      */
     static get<T>(media_id: string, params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /**
+    * Crop and resize an image to Steam capsule dimensions.
+    *
+    * @param request The crop request parameters.
+    * @param params Additional query parameters.
+    *
+    * @returns promise
+    */
+    static cropSteamCapsule(request: SteamCapsuleCropRequest, params?: Record<string, any>): AxiosPromise<Response<SteamCapsuleCropResponse>>;
+    /**
+     * Analyze a Steam capsule image using AI.
+     *
+     * @param request The analysis request parameters.
+     * @param params Additional query parameters.
+     *
+     * @returns promise
+     */
+    static analyzeSteamCapsule(request: SteamCapsuleAnalysisRequest, params?: Record<string, any>): AxiosPromise<Response<SteamCapsuleAnalysisResponse>>;
+    /**
+     * Get Steam capsule dimensions for a specific type.
+     *
+     * @param capsuleType The type of Steam capsule.
+     *
+     * @returns The dimensions object or null if invalid type.
+     */
+    static getSteamCapsuleDimensions(capsuleType: string): SteamCapsuleDimensions | null;
+    /**
+     * Get Steam capsule type information and requirements.
+     *
+     * @param capsuleType The type of Steam capsule.
+     *
+     * @returns Information about the capsule type.
+     */
+    static getSteamCapsuleInfo(capsuleType: string): any;
 }
 export default Media;

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

@@ -135,5 +135,73 @@ declare class SocialPosts {
     * @returns promise
     */
     static shortLinkReports<T>(params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /**
+     * List comments for a social media post.
+     *
+     * @param post_id The ID of the social media post.
+     * @param params Optional query parameters for filtering and sorting.
+     * @returns A promise
+     */
+    static listComments<T>(post_id: string, params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /**
+     * Sync comments from the social media platform for a specific post.
+     *
+     * @param post_id The ID of the social media post.
+     * @param params Optional query parameters (e.g., limit).
+     * @returns A promise
+     */
+    static syncComments<T>(post_id: string, params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /**
+     * Get a list of all comments that are pending a response.
+     *
+     * @param params Optional query parameters for filtering.
+     * @returns A promise
+     */
+    static listPendingResponses<T>(params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /**
+     * Retrieve a single comment by its ID.
+     *
+     * @param comment_id The ID of the comment.
+     * @param params Optional query parameters (e.g., include_thread).
+     * @returns A promise
+     */
+    static viewComment<T>(comment_id: string, params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /**
+     * Post a reply to a comment.
+     *
+     * @param comment_id The ID of the comment to reply to.
+     * @param data The content of the reply.
+     * @returns A promise
+     */
+    static replyToComment<T>(comment_id: string, data: object): AxiosPromise<Response<T>>;
+    /**
+     * Moderate a comment (approve, reject, spam, hide, show).
+     *
+     * @param comment_id The ID of the comment to moderate.
+     * @param data The moderation action and optional reason.
+     * @returns A promise
+     */
+    static moderateComment<T>(comment_id: string, data: object): AxiosPromise<Response<T>>;
+    /**
+     * Mark a comment as needing a response.
+     *
+     * @param comment_id The ID of the comment.
+     * @returns A promise
+     */
+    static markCommentForResponse<T>(comment_id: string): AxiosPromise<Response<T>>;
+    /**
+     * Get the full thread for a given comment.
+     *
+     * @param comment_id The ID of a comment within the thread.
+     * @returns A promise
+     */
+    static getCommentThread<T>(comment_id: string): AxiosPromise<Response<T>>;
+    /**
+     * Trigger a manual update of a comment's metrics from its platform.
+     *
+     * @param comment_id The ID of the comment to update.
+     * @returns A promise
+     */
+    static updateCommentMetrics<T>(comment_id: string): AxiosPromise<Response<T>>;
 }
 export default SocialPosts;

package/dist/esm/index.js

@@ -9737,6 +9737,10 @@ var FingerprintingRoute = /** @class */ (function () {
             url: '/reports/fingerprinting/install-journey',
             method: HTTP_METHODS.GET
         },
+        adCampaignPerformanceReport: {
+            url: '/reports/fingerprinting/ad-campaign-performance',
+            method: HTTP_METHODS.GET
+        },
     };
     return FingerprintingRoute;
 }());
@@ -9917,6 +9921,19 @@ var Fingerprinting = /** @class */ (function () {
     Fingerprinting.installJourneyReport = function (params) {
         return Requests.processRoute(FingerprintingRoute.routes.installJourneyReport, {}, undefined, params);
     };
+    /**
+     * Get how the ad campaigns are performing and turning into installs
+     *
+     * @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
+     */
+    Fingerprinting.adCampaignPerformanceReport = function (params) {
+        return Requests.processRoute(FingerprintingRoute.routes.adCampaignPerformanceReport, {}, undefined, params);
+    };
     return Fingerprinting;
 }());
 
@@ -10919,6 +10936,16 @@ var SocialPostsRoute = /** @class */ (function () {
         reports: { url: '/socialposts/{post_id}/reports', method: HTTP_METHODS.GET },
         updatePostImpressions: { url: '/socialposts/{post_id}/impressions', method: HTTP_METHODS.PUT },
         shortLinkReports: { url: '/socialposts/shortlinks/reports', method: HTTP_METHODS.GET },
+        // New Comment Routes
+        listComments: { url: '/socialposts/{post_id}/comments', method: HTTP_METHODS.GET },
+        syncComments: { url: '/socialposts/{post_id}/sync-comments', method: HTTP_METHODS.POST },
+        listPendingResponses: { url: '/socialposts/comments/pending-responses', method: HTTP_METHODS.GET },
+        viewComment: { url: '/socialposts/comments/{comment_id}', method: HTTP_METHODS.GET },
+        replyToComment: { url: '/socialposts/comments/{comment_id}/reply', method: HTTP_METHODS.POST },
+        moderateComment: { url: '/socialposts/comments/{comment_id}/moderate', method: HTTP_METHODS.PUT },
+        markCommentForResponse: { url: '/socialposts/comments/{comment_id}/mark-for-response', method: HTTP_METHODS.PUT },
+        getCommentThread: { url: '/socialposts/comments/{comment_id}/thread', method: HTTP_METHODS.GET },
+        updateCommentMetrics: { url: '/socialposts/comments/{comment_id}/update-metrics', method: HTTP_METHODS.PUT },
     };
     return SocialPostsRoute;
 }());
@@ -11088,6 +11115,92 @@ var SocialPosts = /** @class */ (function () {
     SocialPosts.shortLinkReports = function (params) {
         return Requests.processRoute(SocialPostsRoute.routes.shortLinkReports, undefined, undefined, params);
     };
+    /**
+     * List comments for a social media post.
+     *
+     * @param post_id The ID of the social media post.
+     * @param params Optional query parameters for filtering and sorting.
+     * @returns A promise
+     */
+    SocialPosts.listComments = function (post_id, params) {
+        return Requests.processRoute(SocialPostsRoute.routes.listComments, undefined, { post_id: post_id }, params);
+    };
+    /**
+     * Sync comments from the social media platform for a specific post.
+     *
+     * @param post_id The ID of the social media post.
+     * @param params Optional query parameters (e.g., limit).
+     * @returns A promise
+     */
+    SocialPosts.syncComments = function (post_id, params) {
+        return Requests.processRoute(SocialPostsRoute.routes.syncComments, undefined, { post_id: post_id }, params);
+    };
+    /**
+     * Get a list of all comments that are pending a response.
+     *
+     * @param params Optional query parameters for filtering.
+     * @returns A promise
+     */
+    SocialPosts.listPendingResponses = function (params) {
+        return Requests.processRoute(SocialPostsRoute.routes.listPendingResponses, undefined, undefined, params);
+    };
+    /**
+     * Retrieve a single comment by its ID.
+     *
+     * @param comment_id The ID of the comment.
+     * @param params Optional query parameters (e.g., include_thread).
+     * @returns A promise
+     */
+    SocialPosts.viewComment = function (comment_id, params) {
+        return Requests.processRoute(SocialPostsRoute.routes.viewComment, undefined, { comment_id: comment_id }, params);
+    };
+    /**
+     * Post a reply to a comment.
+     *
+     * @param comment_id The ID of the comment to reply to.
+     * @param data The content of the reply.
+     * @returns A promise
+     */
+    SocialPosts.replyToComment = function (comment_id, data) {
+        return Requests.processRoute(SocialPostsRoute.routes.replyToComment, data, { comment_id: comment_id });
+    };
+    /**
+     * Moderate a comment (approve, reject, spam, hide, show).
+     *
+     * @param comment_id The ID of the comment to moderate.
+     * @param data The moderation action and optional reason.
+     * @returns A promise
+     */
+    SocialPosts.moderateComment = function (comment_id, data) {
+        return Requests.processRoute(SocialPostsRoute.routes.moderateComment, data, { comment_id: comment_id });
+    };
+    /**
+     * Mark a comment as needing a response.
+     *
+     * @param comment_id The ID of the comment.
+     * @returns A promise
+     */
+    SocialPosts.markCommentForResponse = function (comment_id) {
+        return Requests.processRoute(SocialPostsRoute.routes.markCommentForResponse, undefined, { comment_id: comment_id });
+    };
+    /**
+     * Get the full thread for a given comment.
+     *
+     * @param comment_id The ID of a comment within the thread.
+     * @returns A promise
+     */
+    SocialPosts.getCommentThread = function (comment_id) {
+        return Requests.processRoute(SocialPostsRoute.routes.getCommentThread, undefined, { comment_id: comment_id });
+    };
+    /**
+     * Trigger a manual update of a comment's metrics from its platform.
+     *
+     * @param comment_id The ID of the comment to update.
+     * @returns A promise
+     */
+    SocialPosts.updateCommentMetrics = function (comment_id) {
+        return Requests.processRoute(SocialPostsRoute.routes.updateCommentMetrics, undefined, { comment_id: comment_id });
+    };
     return SocialPosts;
 }());
 
@@ -13441,6 +13554,8 @@ var MediaRoute = /** @class */ (function () {
     MediaRoute.routes = {
         upload: { url: '/media', method: HTTP_METHODS.POST },
         getMedia: { url: '/media/{media_id}', method: HTTP_METHODS.GET },
+        cropSteamCapsule: { url: '/media/crop-steam-capsule', method: HTTP_METHODS.POST },
+        analyzeSteamCapsule: { url: '/media/analyze-steam-capsule', method: HTTP_METHODS.POST },
     };
     return MediaRoute;
 }());
@@ -13486,6 +13601,108 @@ var Media = /** @class */ (function () {
     Media.get = function (media_id, params) {
         return Requests.processRoute(MediaRoute.routes.getMedia, {}, { media_id: media_id }, params);
     };
+    /**
+    * Crop and resize an image to Steam capsule dimensions.
+    *
+    * @param request The crop request parameters.
+    * @param params Additional query parameters.
+    *
+    * @returns promise
+    */
+    Media.cropSteamCapsule = function (request, params) {
+        return Requests.processRoute(MediaRoute.routes.cropSteamCapsule, request, {}, params);
+    };
+    /**
+     * Analyze a Steam capsule image using AI.
+     *
+     * @param request The analysis request parameters.
+     * @param params Additional query parameters.
+     *
+     * @returns promise
+     */
+    Media.analyzeSteamCapsule = function (request, params) {
+        return Requests.processRoute(MediaRoute.routes.analyzeSteamCapsule, request, {}, params);
+    };
+    /**
+     * Get Steam capsule dimensions for a specific type.
+     *
+     * @param capsuleType The type of Steam capsule.
+     *
+     * @returns The dimensions object or null if invalid type.
+     */
+    Media.getSteamCapsuleDimensions = function (capsuleType) {
+        var dimensions = {
+            'header': { width: 920, height: 430 },
+            'small': { width: 462, height: 174 },
+            'main': { width: 1232, height: 706 },
+            'vertical': { width: 748, height: 896 },
+            'library': { width: 600, height: 900 },
+            'library_header': { width: 920, height: 430 },
+            'library_hero': { width: 3840, height: 1240 },
+            'page_background': { width: 1438, height: 810 }
+        };
+        return dimensions[capsuleType] || null;
+    };
+    /**
+     * Get Steam capsule type information and requirements.
+     *
+     * @param capsuleType The type of Steam capsule.
+     *
+     * @returns Information about the capsule type.
+     */
+    Media.getSteamCapsuleInfo = function (capsuleType) {
+        var info = {
+            'header': {
+                name: 'Header Capsule',
+                purpose: 'Appears at the top of store page, in recommended sections, grid view in libraries',
+                textRequirement: 'Logo must be clearly legible',
+                designFocus: 'Focus on branding of your product'
+            },
+            'small': {
+                name: 'Small Capsule',
+                purpose: 'Used for all lists throughout Steam: search results, top-sellers, new releases',
+                textRequirement: 'Logo should nearly fill the small capsule for readability',
+                designFocus: 'Focus on making logo clearly legible at smallest size'
+            },
+            'main': {
+                name: 'Main Capsule',
+                purpose: 'Appears at top of front page in featured and recommended carousel',
+                textRequirement: 'Logo should be prominent and readable',
+                designFocus: 'Designed to market the product with key art and logo'
+            },
+            'vertical': {
+                name: 'Vertical Capsule',
+                purpose: 'Can appear at top of front page during seasonal sales',
+                textRequirement: 'Logo should be clearly visible',
+                designFocus: 'Vertical asset designed to market your game'
+            },
+            'library': {
+                name: 'Library Capsule',
+                purpose: 'Used in library overview and collection views',
+                textRequirement: 'Game name/logo should be easily legible against background',
+                designFocus: 'Graphically-centric to give user sense of experience'
+            },
+            'library_header': {
+                name: 'Library Header',
+                purpose: 'Appears in various places in Steam Client Library',
+                textRequirement: 'Logo must be clearly legible',
+                designFocus: 'Focus on branding, similar to Library Capsule'
+            },
+            'library_hero': {
+                name: 'Library Hero',
+                purpose: 'Appears at top of user\'s library details page',
+                textRequirement: 'Should NOT contain any text or logos',
+                designFocus: 'Visually rich, easily recognizable key art'
+            },
+            'page_background': {
+                name: 'Page Background',
+                purpose: 'Background image for store page',
+                textRequirement: 'Minimal or no text',
+                designFocus: 'Should be ambient, not compete with page content'
+            }
+        };
+        return info[capsuleType] || null;
+    };
     return Media;
 }());