glitch-javascript-sdk 3.2.31 → 3.2.32

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

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

package/dist/index.d.ts

@@ -10357,6 +10357,46 @@ declare class AdminReports {
     static steam<T>(params?: Record<string, any>): AxiosPromise<Response<T>>;
 }
 
+/**
+ * Site-administrator user management.
+ *
+ * These endpoints back the admin dashboard user directory. They require a
+ * site-admin auth token (Super Administrator or Administrator), and
+ * impersonation additionally requires a Super Administrator token.
+ */
+declare class AdminUsers {
+    /**
+     * List and search all users in the system.
+     *
+     * Supported params include `search` (matches name, username, email, or id),
+     * `is_site_admin`, `is_verified`, `sort_by`, `sort_order`, `per_page`, and
+     * `page`.
+     *
+     * @param params Optional query parameters.
+     * @returns promise
+     */
+    static list<T>(params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /**
+     * Retrieve a comprehensive profile for a single user, including communities,
+     * administered titles, games played, roles, billing status, social presence,
+     * and activity counts.
+     *
+     * @param user_id The id of the user to view.
+     * @param params Optional query parameters.
+     * @returns promise
+     */
+    static view<T>(user_id: string, params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /**
+     * Impersonate a user. Issues a JWT for the target account so a Super
+     * Administrator can operate as that user. Administrator accounts cannot be
+     * impersonated, and every call is written to the impersonation audit log.
+     *
+     * @param user_id The id of the user to impersonate.
+     * @returns promise resolving to an access token and the impersonated user summary.
+     */
+    static impersonate<T>(user_id: string): AxiosPromise<Response<T>>;
+}
+
 declare class MarketResearch {
     static access<T>(params?: Record<string, any>): AxiosPromise<Response<T>>;
     static filterOptions<T>(params?: Record<string, any>): AxiosPromise<Response<T>>;
@@ -10734,6 +10774,7 @@ declare class Glitch {
         Mcp: typeof Mcp;
         PrDirectory: typeof PrDirectory;
         AdminReports: typeof AdminReports;
+        AdminUsers: typeof AdminUsers;
         MarketResearch: typeof MarketResearch;
     };
     static util: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "glitch-javascript-sdk",
-  "version": "3.2.31",
+  "version": "3.2.32",
   "description": "Javascript SDK for Glitch",
   "publishConfig": {
     "access": "public"

package/src/api/AdminUsers.ts

@@ -0,0 +1,54 @@
+import AdminUsersRoute from "../routes/AdminUsersRoute";
+import Requests from "../util/Requests";
+import Response from "../util/Response";
+import { AxiosPromise } from "axios";
+
+/**
+ * Site-administrator user management.
+ *
+ * These endpoints back the admin dashboard user directory. They require a
+ * site-admin auth token (Super Administrator or Administrator), and
+ * impersonation additionally requires a Super Administrator token.
+ */
+class AdminUsers {
+    /**
+     * List and search all users in the system.
+     *
+     * Supported params include `search` (matches name, username, email, or id),
+     * `is_site_admin`, `is_verified`, `sort_by`, `sort_order`, `per_page`, and
+     * `page`.
+     *
+     * @param params Optional query parameters.
+     * @returns promise
+     */
+    public static list<T>(params?: Record<string, any>): AxiosPromise<Response<T>> {
+        return Requests.processRoute(AdminUsersRoute.routes.list, undefined, undefined, params);
+    }
+
+    /**
+     * Retrieve a comprehensive profile for a single user, including communities,
+     * administered titles, games played, roles, billing status, social presence,
+     * and activity counts.
+     *
+     * @param user_id The id of the user to view.
+     * @param params Optional query parameters.
+     * @returns promise
+     */
+    public static view<T>(user_id: string, params?: Record<string, any>): AxiosPromise<Response<T>> {
+        return Requests.processRoute(AdminUsersRoute.routes.view, undefined, { user_id: user_id }, params);
+    }
+
+    /**
+     * Impersonate a user. Issues a JWT for the target account so a Super
+     * Administrator can operate as that user. Administrator accounts cannot be
+     * impersonated, and every call is written to the impersonation audit log.
+     *
+     * @param user_id The id of the user to impersonate.
+     * @returns promise resolving to an access token and the impersonated user summary.
+     */
+    public static impersonate<T>(user_id: string): AxiosPromise<Response<T>> {
+        return Requests.processRoute(AdminUsersRoute.routes.impersonate, { user_id: user_id });
+    }
+}
+
+export default AdminUsers;

package/src/api/index.ts

@@ -49,6 +49,7 @@ import Agents from "./Agents";
 import Mcp from "./Mcp";
 import PrDirectory from "./PrDirectory";
 import AdminReports from "./AdminReports";
+import AdminUsers from "./AdminUsers";
 import MarketResearch from "./MarketResearch";
 
 export {Ads};
@@ -102,4 +103,5 @@ export {Agents};
 export {Mcp};
 export {PrDirectory};
 export {AdminReports};
+export {AdminUsers};
 export {MarketResearch};

package/src/index.ts

@@ -53,6 +53,7 @@ import {Agents} from './api';
 import {Mcp} from './api';
 import {PrDirectory} from './api';
 import {AdminReports} from './api';
+import {AdminUsers} from './api';
 import {MarketResearch} from './api';
 
 import Requests from "./util/Requests";
@@ -136,6 +137,7 @@ class Glitch {
         Mcp : Mcp,
         PrDirectory : PrDirectory,
         AdminReports : AdminReports,
+        AdminUsers : AdminUsers,
         MarketResearch : MarketResearch,
     }
 

package/src/routes/AdminUsersRoute.ts

@@ -0,0 +1,24 @@
+import Route from "./interface";
+import HTTP_METHODS from "../constants/HttpMethods";
+
+class AdminUsersRoute {
+  public static routes: { [key: string]: Route } = {
+    // List and search every user in the system (site admin only).
+    list: {
+      url: '/admin/users',
+      method: HTTP_METHODS.GET
+    },
+    // Full profile for a single user (site admin only).
+    view: {
+      url: '/admin/users/{user_id}',
+      method: HTTP_METHODS.GET
+    },
+    // Securely impersonate a user (super admin only, audited).
+    impersonate: {
+      url: '/admin/users/impersonate',
+      method: HTTP_METHODS.POST
+    },
+  };
+}
+
+export default AdminUsersRoute;