glitch-javascript-sdk 3.1.4 → 3.1.5

package/src/api/ServerOperations.ts

@@ -0,0 +1,16 @@
+import ServerOperationsRoute from "../routes/ServerOperationsRoute";
+import Requests from "../util/Requests";
+import Response from "../util/Response";
+import { AxiosPromise } from "axios";
+
+class ServerOperations {
+    public static listDeployments<T>(params?: Record<string, any>): AxiosPromise<Response<T>> {
+        return Requests.processRoute(ServerOperationsRoute.routes.listDeployments, undefined, undefined, params);
+    }
+
+    public static updatePolicy<T>(title_id: string, build_id: string, data: object): AxiosPromise<Response<T>> {
+        return Requests.processRoute(ServerOperationsRoute.routes.updatePolicy, data, { title_id, build_id });
+    }
+}
+
+export default ServerOperations;

package/src/api/Titles.ts

@@ -3,6 +3,45 @@ import Requests from "../util/Requests";
 import Response from "../util/Response";
 import { AxiosPromise } from "axios";
 
+export type GameReviewRecommendation = 'recommended' | 'not_recommended' | 'neutral';
+export type GameReviewSentiment = 'positive' | 'mixed' | 'negative';
+export type GameReviewVoteType = 'helpful' | 'funny' | 'detailed' | 'not_helpful';
+export type GameReviewReportReason = 'abuse' | 'spam' | 'off_topic' | 'manipulation' | 'hate' | 'personal_info' | 'other';
+
+export interface GameReviewRatings {
+    gameplay?: GameReviewSentiment;
+    performance?: GameReviewSentiment;
+    value?: GameReviewSentiment;
+    content?: GameReviewSentiment;
+    multiplayer?: GameReviewSentiment;
+    monetization?: GameReviewSentiment;
+    stability?: GameReviewSentiment;
+    localization?: GameReviewSentiment;
+    accessibility?: GameReviewSentiment;
+}
+
+export interface CreateGameReviewRequest {
+    recommendation: GameReviewRecommendation;
+    title: string;
+    body: string;
+    review_type?: 'first_impression' | 'full_review' | 'bug_performance_warning' | 'early_access_feedback' | 'multiplayer_community_feedback' | 'monetization_pricing_feedback' | 'changed_opinion_after_update';
+    liked?: string;
+    needs_work?: string;
+    audience?: string;
+    language?: string;
+    game_version?: string;
+    platform?: string;
+    acquisition_type?: 'purchased' | 'free_to_play' | 'free_copy' | 'promotional_key' | 'beta_key' | 'demo' | 'external_verified';
+    received_for_free?: boolean;
+    early_access?: boolean;
+    current_version_review?: boolean;
+    main_negative_reason?: 'bugs_crashes' | 'bad_performance' | 'not_enough_content' | 'misleading_marketing' | 'price_value' | 'monetization' | 'community_toxicity' | 'developer_business_decision' | 'localization' | 'server_network' | 'gameplay_design' | 'not_my_type' | 'other';
+    change_reason?: string;
+    ratings?: GameReviewRatings;
+}
+
+export type UpdateGameReviewRequest = Partial<CreateGameReviewRequest>;
+
 class Titles {
 
     /**
@@ -1318,6 +1357,76 @@ class Titles {
     public static wishlistDevices<T>(title_id: string, params?: Record<string, any>): AxiosPromise<Response<T>> {
         return Requests.processRoute(TitlesRoute.routes.wishlistDevices, undefined, { title_id }, params);
     }
+
+    /**
+     * List public reviews for a title.
+     *
+     * @param title_id The UUID of the title.
+     * @param params Optional filters: recommendation, language, current_version_only,
+     * verified_only, platform, acquisition_type, complaint, playtime, sort, per_page.
+     */
+    public static listReviews<T>(title_id: string, params?: Record<string, any>): AxiosPromise<Response<T>> {
+        return Requests.processRoute(TitlesRoute.routes.reviewsList, {}, { title_id }, params);
+    }
+
+    /**
+     * Get aggregate review scores and structured praise/complaint summaries.
+     */
+    public static reviewSummary<T>(title_id: string, params?: { language?: string }): AxiosPromise<Response<T>> {
+        return Requests.processRoute(TitlesRoute.routes.reviewsSummary, {}, { title_id }, params);
+    }
+
+    /**
+     * Create the current user's review for a title. The backend verifies play/purchase eligibility.
+     */
+    public static createReview<T>(title_id: string, data: CreateGameReviewRequest): AxiosPromise<Response<T>> {
+        return Requests.processRoute(TitlesRoute.routes.reviewsCreate, data, { title_id });
+    }
+
+    /**
+     * View a single review, including revision history when the backend includes it.
+     */
+    public static viewReview<T>(review_id: string, params?: Record<string, any>): AxiosPromise<Response<T>> {
+        return Requests.processRoute(TitlesRoute.routes.reviewsShow, {}, { review_id }, params);
+    }
+
+    /**
+     * Update the current user's review and preserve a backend revision trail.
+     */
+    public static updateReview<T>(review_id: string, data: UpdateGameReviewRequest): AxiosPromise<Response<T>> {
+        return Requests.processRoute(TitlesRoute.routes.reviewsUpdate, data, { review_id });
+    }
+
+    /**
+     * Delete the current user's review, or a title admin's moderated review.
+     */
+    public static deleteReview<T>(review_id: string): AxiosPromise<Response<T>> {
+        return Requests.processRoute(TitlesRoute.routes.reviewsDelete, {}, { review_id });
+    }
+
+    /**
+     * Vote on a review as helpful, funny, detailed, or not helpful.
+     */
+    public static voteReview<T>(review_id: string, vote_type: GameReviewVoteType): AxiosPromise<Response<T>> {
+        return Requests.processRoute(TitlesRoute.routes.reviewsVote, { vote_type }, { review_id });
+    }
+
+    /**
+     * Report a review for moderation.
+     */
+    public static reportReview<T>(review_id: string, data: { reason: GameReviewReportReason; notes?: string }): AxiosPromise<Response<T>> {
+        return Requests.processRoute(TitlesRoute.routes.reviewsReport, data, { review_id });
+    }
+
+    /**
+     * Create or update the title developer's official response to a review.
+     */
+    public static respondToReview<T>(
+        review_id: string,
+        data: { body: string; linked_patch_note_id?: string; issue_marked_fixed?: boolean }
+    ): AxiosPromise<Response<T>> {
+        return Requests.processRoute(TitlesRoute.routes.reviewsDeveloperResponse, data, { review_id });
+    }
 }
 
 export default Titles;

package/src/api/index.ts

@@ -42,6 +42,8 @@ import Raffles from "./Raffles";
 import DiscordMarketplace from "./DiscordMarketplace";
 import Education from "./Education";
 import Crm from "./Crm";
+import Multiplayer from "./Multiplayer";
+import ServerOperations from "./ServerOperations";
 
 export {Ads};
 export {AccessKeys};
@@ -86,4 +88,6 @@ export {TwitchReporting};
 export {Raffles};
 export {DiscordMarketplace};
 export {Education};
-export {Crm};
+export {Crm};
+export {Multiplayer};
+export {ServerOperations};

package/src/constants/HttpMethods.ts

@@ -1,8 +1,9 @@
 const HTTP_METHODS = {
     GET: 'GET',
     POST: 'POST',
+    PATCH: 'PATCH',
     PUT: 'PUT',
     DELETE: 'DELETE',
   }  as const;
 
-  export default HTTP_METHODS;
+  export default HTTP_METHODS;

package/src/index.ts

@@ -46,6 +46,8 @@ import {Raffles} from './api'
 import {DiscordMarketplace} from './api';
 import {Education} from './api';
 import {Crm} from './api';
+import {Multiplayer} from './api';
+import {ServerOperations} from './api';
 
 import Requests from "./util/Requests";
 import Parser from "./util/Parser";
@@ -121,6 +123,8 @@ class Glitch {
         DiscordMarketplace : DiscordMarketplace,
         Education: Education,
         Crm : Crm,
+        Multiplayer : Multiplayer,
+        ServerOperations : ServerOperations,
     }
 
     public static util = {
@@ -153,4 +157,4 @@ class Glitch {
 
 }
 
-export default Glitch;
+export default Glitch;

package/src/routes/MultiplayerRoute.ts

@@ -0,0 +1,46 @@
+import Route from "./interface";
+import HTTP_METHODS from "../constants/HttpMethods";
+
+class MultiplayerRoute {
+
+  public static routes: { [key: string]: Route } = {
+    searchLobbies: { url: '/titles/{title_id}/multiplayer/lobbies', method: HTTP_METHODS.GET },
+    createLobby: { url: '/titles/{title_id}/multiplayer/lobbies', method: HTTP_METHODS.POST },
+    showLobby: { url: '/titles/{title_id}/multiplayer/lobbies/{lobby_id}', method: HTTP_METHODS.GET },
+    updateLobby: { url: '/titles/{title_id}/multiplayer/lobbies/{lobby_id}', method: HTTP_METHODS.PUT },
+    joinLobby: { url: '/titles/{title_id}/multiplayer/lobbies/{lobby_id}/join', method: HTTP_METHODS.POST },
+    leaveLobby: { url: '/titles/{title_id}/multiplayer/lobbies/{lobby_id}/leave', method: HTTP_METHODS.POST },
+    setLobbyServer: { url: '/titles/{title_id}/multiplayer/lobbies/{lobby_id}/server', method: HTTP_METHODS.POST },
+    listLobbyMessages: { url: '/titles/{title_id}/multiplayer/lobbies/{lobby_id}/messages', method: HTTP_METHODS.GET },
+    sendLobbyMessage: { url: '/titles/{title_id}/multiplayer/lobbies/{lobby_id}/messages', method: HTTP_METHODS.POST },
+
+    listVoiceRooms: { url: '/titles/{title_id}/multiplayer/voice/rooms', method: HTTP_METHODS.GET },
+    createVoiceRoom: { url: '/titles/{title_id}/multiplayer/voice/rooms', method: HTTP_METHODS.POST },
+    showVoiceRoom: { url: '/titles/{title_id}/multiplayer/voice/rooms/{voice_room_id}', method: HTTP_METHODS.GET },
+    updateVoiceRoom: { url: '/titles/{title_id}/multiplayer/voice/rooms/{voice_room_id}', method: HTTP_METHODS.PUT },
+    joinVoiceRoom: { url: '/titles/{title_id}/multiplayer/voice/rooms/{voice_room_id}/join', method: HTTP_METHODS.POST },
+    heartbeatVoice: { url: '/multiplayer/voice/heartbeat', method: HTTP_METHODS.POST },
+    leaveVoice: { url: '/multiplayer/voice/leave', method: HTTP_METHODS.POST },
+    sendVoicePacket: { url: '/multiplayer/voice/packets', method: HTTP_METHODS.POST },
+    pollVoicePackets: { url: '/multiplayer/voice/poll', method: HTTP_METHODS.POST },
+
+    browseServers: { url: '/titles/{title_id}/multiplayer/servers', method: HTTP_METHODS.GET },
+    registerServer: { url: '/titles/{title_id}/multiplayer/servers', method: HTTP_METHODS.POST },
+    heartbeatServer: { url: '/titles/{title_id}/multiplayer/servers/{server_id}/heartbeat', method: HTTP_METHODS.POST },
+    reserveServer: { url: '/titles/{title_id}/multiplayer/servers/{server_id}/reserve', method: HTTP_METHODS.POST },
+
+    heartbeatSession: { url: '/multiplayer/sessions/heartbeat', method: HTTP_METHODS.POST },
+    releaseSession: { url: '/multiplayer/sessions/release', method: HTTP_METHODS.POST },
+
+    issueAuthTicket: { url: '/titles/{title_id}/multiplayer/auth-tickets', method: HTTP_METHODS.POST },
+    validateAuthTicket: { url: '/titles/{title_id}/multiplayer/auth-tickets/validate', method: HTTP_METHODS.POST },
+    validateAuthTicketForServer: { url: '/titles/{title_id}/multiplayer/servers/{server_id}/auth-tickets/validate', method: HTTP_METHODS.POST },
+
+    listFavorites: { url: '/titles/{title_id}/multiplayer/favorites', method: HTTP_METHODS.GET },
+    addFavorite: { url: '/titles/{title_id}/multiplayer/favorites', method: HTTP_METHODS.POST },
+    deleteFavorite: { url: '/titles/{title_id}/multiplayer/favorites/{favorite_id}', method: HTTP_METHODS.DELETE },
+  };
+
+}
+
+export default MultiplayerRoute;

package/src/routes/ServerOperationsRoute.ts

@@ -0,0 +1,17 @@
+import Route from "./interface";
+import HTTP_METHODS from "../constants/HttpMethods";
+
+class ServerOperationsRoute {
+  public static routes: { [key: string]: Route } = {
+    listDeployments: {
+      url: '/admin/server-operations/deployments',
+      method: HTTP_METHODS.GET
+    },
+    updatePolicy: {
+      url: '/admin/server-operations/titles/{title_id}/builds/{build_id}/policy',
+      method: HTTP_METHODS.PUT
+    },
+  };
+}
+
+export default ServerOperationsRoute;

package/src/routes/TitlesRoute.ts

@@ -301,8 +301,19 @@ class TitlesRoute {
     wishlistGeo: { url: '/titles/{title_id}/wishlist/geo', method: HTTP_METHODS.GET },
     wishlistDevices: { url: '/titles/{title_id}/wishlist/devices', method: HTTP_METHODS.GET },
 
+    // Game Reviews
+    reviewsList: { url: '/titles/{title_id}/reviews', method: HTTP_METHODS.GET },
+    reviewsSummary: { url: '/titles/{title_id}/review-summary', method: HTTP_METHODS.GET },
+    reviewsCreate: { url: '/titles/{title_id}/reviews', method: HTTP_METHODS.POST },
+    reviewsShow: { url: '/reviews/{review_id}', method: HTTP_METHODS.GET },
+    reviewsUpdate: { url: '/reviews/{review_id}', method: HTTP_METHODS.PATCH },
+    reviewsDelete: { url: '/reviews/{review_id}', method: HTTP_METHODS.DELETE },
+    reviewsVote: { url: '/reviews/{review_id}/vote', method: HTTP_METHODS.POST },
+    reviewsReport: { url: '/reviews/{review_id}/report', method: HTTP_METHODS.POST },
+    reviewsDeveloperResponse: { url: '/reviews/{review_id}/developer-response', method: HTTP_METHODS.POST },
+
   };
 
 }
 
-export default TitlesRoute;
+export default TitlesRoute;

package/src/util/Requests.ts

@@ -29,7 +29,7 @@ class Requests {
   }
 
   private static request<T>(
-    method: 'GET' | 'POST' | 'PUT' | 'DELETE',
+    method: 'GET' | 'POST' | 'PATCH' | 'PUT' | 'DELETE',
     url: string,
     data?: any,
     fileData?: any
@@ -119,6 +119,24 @@ class Requests {
     return Requests.request<T>('PUT', url, data);
   }
 
+  public static patch<T>(url: string, data: any, params?: Record<string, any>): AxiosPromise<Response<T>> {
+    if (params && Object.keys(params).length > 0) {
+      const queryString = Object.entries(params)
+        .map(([key, value]) => `${key}=${encodeURIComponent(value)}`)
+        .join('&');
+      url = `${url}?${queryString}`;
+    }
+
+    if (Requests.community_id) {
+      data = {
+        ...data,
+        community_id: Requests.community_id,
+      };
+    }
+
+    return Requests.request<T>('PATCH', url, data);
+  }
+
   public static delete<T>(url: string, params?: Record<string, any>): AxiosPromise<Response<T>> {
     if (params && Object.keys(params).length > 0) {
       const queryString = Object.entries(params)
@@ -323,6 +341,8 @@ class Requests {
       return Requests.get(url, params);
     } else if (route.method == HTTP_METHODS.POST) {
       return Requests.post(url, data, params);
+    } else if (route.method == HTTP_METHODS.PATCH) {
+      return Requests.patch(url, data, params);
     } else if (route.method == HTTP_METHODS.PUT) {
       return Requests.put(url, data, params);
     } else if (route.method == HTTP_METHODS.DELETE) {