glitch-javascript-sdk 3.2.10 → 3.2.12

package/dist/esm/models/user.d.ts

@@ -23,6 +23,16 @@ interface User {
     twitch_handle?: string;
     youtube_handle?: string;
     paetron_handle?: string;
+    gmail_oauth_token?: string;
+    gmail_refresh_token?: string;
+    gmail_token_expiration?: number;
+    gmail_token_expires_at?: string;
+    gmail_id?: string;
+    gmail_name?: string;
+    gmail_email?: string;
+    gmail_avatar?: string;
+    gmail_scopes?: string[];
+    gmail_connected_at?: string;
     created_at?: string;
     updated_at?: string;
 }

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

@@ -0,0 +1,15 @@
+import Route from "./interface";
+/**
+ * Glitch MCP paid facade (/mcp/v1).
+ *
+ * Mirrors the routes served by McpAgentController. These endpoints authenticate
+ * with either a Glitch user JWT or a title-scoped MCP token and keep all planner,
+ * billing, and executor logic server-side. The public @glitch/mcp adapter calls
+ * the same endpoints; this SDK surface lets first-party TypeScript clients reuse them.
+ */
+declare class McpRoute {
+    static routes: {
+        [key: string]: Route;
+    };
+}
+export default McpRoute;

package/dist/esm/util/Requests.d.ts

@@ -11,6 +11,13 @@ declare class Requests {
     static setBaseUrl(url: string): void;
     static setAuthToken(token: string): void;
     static setCommunityID(community_id: string | undefined): void;
+    /**
+     * Build an absolute API URL using the currently configured base URL.
+     *
+     * This is useful for browser primitives such as EventSource that need a URL
+     * string instead of an Axios request wrapper.
+     */
+    static buildUrl(url: string, params?: Record<string, any>): string;
     private static request;
     static get<T>(url: string, params?: Record<string, any>): AxiosPromise<Response<T>>;
     static post<T>(url: string, data: any, params?: Record<string, any>): AxiosPromise<Response<T>>;

package/dist/index.d.ts

@@ -2060,6 +2060,14 @@ declare class Users {
      * @returns promise
      */
     static clearGoogleAuth<T>(): AxiosPromise<Response<T>>;
+    /**
+     * Clear Gmail Workspace authentication information from the current user.
+     *
+     * @see https://api.glitch.fun/api/documentation#/Users%20Route/clearGmailAuth
+     *
+     * @returns promise
+     */
+    static clearGmailAuth<T>(): AxiosPromise<Response<T>>;
     /**
      * Clear Stripe authentication information from the current user.
      *
@@ -9305,6 +9313,10 @@ declare class Agents {
      * Answer a guidance request and write structured agent memory.
      */
     static answerGuidance<T>(title_id: string, guidance_id: string, data?: object, params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /**
+     * Rewrite an editable agent draft for review without executing the parent action.
+     */
+    static rewriteAgentDraft<T>(title_id: string, data?: object, params?: Record<string, any>): AxiosPromise<Response<T>>;
     /**
      * List structured agent memories for a title.
      */
@@ -9349,6 +9361,77 @@ declare class Agents {
     static agencyInbox<T>(params?: Record<string, any>): AxiosPromise<Response<T>>;
 }
 
+interface McpStartRunRequest {
+    agent_id?: string | null;
+    initial_message?: string | null;
+    prompt?: string | null;
+    run_type?: string;
+    trigger_source?: string;
+    background?: boolean;
+    live_mode?: boolean;
+    attachment_ids?: string[];
+    [key: string]: any;
+}
+/**
+ * Client for the Glitch MCP paid facade (/mcp/v1).
+ *
+ * Authenticate with a Glitch user JWT or a title-scoped MCP token. The facade
+ * enforces subscription, title permissions, scope, and approval guardrails on
+ * every call; this client only forwards requests.
+ */
+declare class Mcp {
+    /** Health/auth probe. Returns authenticated=false (200) when no credential is set. */
+    static authStatus<T>(params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /** List titles visible to the current user token or title-scoped MCP token. */
+    static listTitles<T>(params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /** Fetch safe, subscription-gated workspace context for a title. */
+    static titleContext<T>(title_id: string, params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /** Check subscription, trial, plan, and credit state for a title. */
+    static billing<T>(title_id: string, params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /** Start a paid Glitch Agent run for a title. */
+    static startRun<T>(title_id: string, data?: McpStartRunRequest, params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /** Fetch a durable run with status, actions, guidance, events, files, and report. */
+    static viewRun<T>(title_id: string, run_id: string, params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /** List user-visible timeline events for a run. */
+    static runEvents<T>(title_id: string, run_id: string, params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /** Fetch the human-friendly final or partial report for a run. */
+    static finalReport<T>(title_id: string, run_id: string, params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /**
+     * Server-Sent Events URL for a run's live event stream.
+     *
+     * Returns the absolute URL to open with an EventSource/fetch reader; the
+     * endpoint emits `status`, `run_event`, and a terminal `settled`/`timeout` event.
+     */
+    static runStreamUrl(title_id: string, run_id: string, params?: Record<string, any>): string;
+    /** List downloadable files and hosted report artifacts for a run. */
+    static artifacts<T>(title_id: string, run_id: string, params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /** List proposed/guidance/approval/executed actions for a title. */
+    static listActions<T>(title_id: string, params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /** Approve a reviewable action. Execution remains guarded server-side. */
+    static approveAction<T>(title_id: string, action_id: string, data?: object, params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /** Reject a proposed or approval-needed action. */
+    static rejectAction<T>(title_id: string, action_id: string, data?: object, params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /** Execute an approved action. Public/paid/creator-facing work stays guarded. */
+    static executeAction<T>(title_id: string, action_id: string, data?: object, params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /** List open or answered guidance requests for a title or run. */
+    static listGuidance<T>(title_id: string, params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /** Answer a guidance request and resume the server-side workflow when possible. */
+    static answerGuidance<T>(title_id: string, guidance_id: string, data?: object, params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /** Get instructions for uploading a file (points at uploadFile below). */
+    static createUpload<T>(title_id: string, data?: object, params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /**
+     * Upload a file (image, video, or document) to a title or run as multipart/form-data.
+     * The facade re-checks the title scope, subscription, and allowed mime types.
+     */
+    static uploadFile<T>(title_id: string, file: File | Blob, data?: object, params?: Record<string, any>, onUploadProgress?: (progressEvent: AxiosProgressEvent) => void): AxiosPromise<Response<T>>;
+    /** List MCP title tokens (user JWT only). */
+    static listTokens<T>(title_id: string, params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /** Create a revocable title-scoped MCP token (user JWT only). */
+    static createToken<T>(title_id: string, data?: object, params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /** Revoke a title-scoped MCP token (user JWT only). */
+    static revokeToken<T>(title_id: string, token_id: string, params?: Record<string, any>): AxiosPromise<Response<T>>;
+}
+
 /**
  * Allowed outlet types in the PR directory.
  */
@@ -9747,6 +9830,13 @@ declare class Requests {
     static setBaseUrl(url: string): void;
     static setAuthToken(token: string): void;
     static setCommunityID(community_id: string | undefined): void;
+    /**
+     * Build an absolute API URL using the currently configured base URL.
+     *
+     * This is useful for browser primitives such as EventSource that need a URL
+     * string instead of an Axios request wrapper.
+     */
+    static buildUrl(url: string, params?: Record<string, any>): string;
     private static request;
     static get<T>(url: string, params?: Record<string, any>): AxiosPromise<Response<T>>;
     static post<T>(url: string, data: any, params?: Record<string, any>): AxiosPromise<Response<T>>;
@@ -10089,6 +10179,7 @@ declare class Glitch {
         Multiplayer: typeof Multiplayer;
         ServerOperations: typeof ServerOperations;
         Agents: typeof Agents;
+        Mcp: typeof Mcp;
         PrDirectory: typeof PrDirectory;
     };
     static util: {

package/package.json

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

package/src/api/Agents.ts

@@ -196,6 +196,13 @@ class Agents {
     return Requests.processRoute(AgentsRoute.routes.answerGuidance, data, { title_id, guidance_id }, params);
   }
 
+  /**
+   * Rewrite an editable agent draft for review without executing the parent action.
+   */
+  public static rewriteAgentDraft<T>(title_id: string, data?: object, params?: Record<string, any>): AxiosPromise<Response<T>> {
+    return Requests.processRoute(AgentsRoute.routes.rewriteAgentDraft, data, { title_id }, params);
+  }
+
   /**
    * List structured agent memories for a title.
    */

package/src/api/Mcp.ts

@@ -0,0 +1,150 @@
+import McpRoute from "../routes/McpRoute";
+import Requests from "../util/Requests";
+import Response from "../util/Response";
+import { AxiosPromise, AxiosProgressEvent } from "axios";
+
+export interface McpStartRunRequest {
+  agent_id?: string | null;
+  initial_message?: string | null;
+  prompt?: string | null;
+  run_type?: string;
+  trigger_source?: string;
+  background?: boolean;
+  live_mode?: boolean;
+  attachment_ids?: string[];
+  [key: string]: any;
+}
+
+/**
+ * Client for the Glitch MCP paid facade (/mcp/v1).
+ *
+ * Authenticate with a Glitch user JWT or a title-scoped MCP token. The facade
+ * enforces subscription, title permissions, scope, and approval guardrails on
+ * every call; this client only forwards requests.
+ */
+class Mcp {
+  /** Health/auth probe. Returns authenticated=false (200) when no credential is set. */
+  public static authStatus<T>(params?: Record<string, any>): AxiosPromise<Response<T>> {
+    return Requests.processRoute(McpRoute.routes.authStatus, {}, {}, params);
+  }
+
+  /** List titles visible to the current user token or title-scoped MCP token. */
+  public static listTitles<T>(params?: Record<string, any>): AxiosPromise<Response<T>> {
+    return Requests.processRoute(McpRoute.routes.listTitles, {}, {}, params);
+  }
+
+  /** Fetch safe, subscription-gated workspace context for a title. */
+  public static titleContext<T>(title_id: string, params?: Record<string, any>): AxiosPromise<Response<T>> {
+    return Requests.processRoute(McpRoute.routes.titleContext, {}, { title_id }, params);
+  }
+
+  /** Check subscription, trial, plan, and credit state for a title. */
+  public static billing<T>(title_id: string, params?: Record<string, any>): AxiosPromise<Response<T>> {
+    return Requests.processRoute(McpRoute.routes.billing, {}, { title_id }, params);
+  }
+
+  /** Start a paid Glitch Agent run for a title. */
+  public static startRun<T>(title_id: string, data?: McpStartRunRequest, params?: Record<string, any>): AxiosPromise<Response<T>> {
+    return Requests.processRoute(McpRoute.routes.startRun, data ?? {}, { title_id }, params);
+  }
+
+  /** Fetch a durable run with status, actions, guidance, events, files, and report. */
+  public static viewRun<T>(title_id: string, run_id: string, params?: Record<string, any>): AxiosPromise<Response<T>> {
+    return Requests.processRoute(McpRoute.routes.viewRun, {}, { title_id, run_id }, params);
+  }
+
+  /** List user-visible timeline events for a run. */
+  public static runEvents<T>(title_id: string, run_id: string, params?: Record<string, any>): AxiosPromise<Response<T>> {
+    return Requests.processRoute(McpRoute.routes.runEvents, {}, { title_id, run_id }, params);
+  }
+
+  /** Fetch the human-friendly final or partial report for a run. */
+  public static finalReport<T>(title_id: string, run_id: string, params?: Record<string, any>): AxiosPromise<Response<T>> {
+    return Requests.processRoute(McpRoute.routes.finalReport, {}, { title_id, run_id }, params);
+  }
+
+  /**
+   * Server-Sent Events URL for a run's live event stream.
+   *
+   * Returns the absolute URL to open with an EventSource/fetch reader; the
+   * endpoint emits `status`, `run_event`, and a terminal `settled`/`timeout` event.
+   */
+  public static runStreamUrl(title_id: string, run_id: string, params?: Record<string, any>): string {
+    const url = McpRoute.routes.streamRun.url
+      .replace("{title_id}", encodeURIComponent(title_id))
+      .replace("{run_id}", encodeURIComponent(run_id));
+    return Requests.buildUrl(url, params);
+  }
+
+  /** List downloadable files and hosted report artifacts for a run. */
+  public static artifacts<T>(title_id: string, run_id: string, params?: Record<string, any>): AxiosPromise<Response<T>> {
+    return Requests.processRoute(McpRoute.routes.artifacts, {}, { title_id, run_id }, params);
+  }
+
+  /** List proposed/guidance/approval/executed actions for a title. */
+  public static listActions<T>(title_id: string, params?: Record<string, any>): AxiosPromise<Response<T>> {
+    return Requests.processRoute(McpRoute.routes.listActions, {}, { title_id }, params);
+  }
+
+  /** Approve a reviewable action. Execution remains guarded server-side. */
+  public static approveAction<T>(title_id: string, action_id: string, data?: object, params?: Record<string, any>): AxiosPromise<Response<T>> {
+    return Requests.processRoute(McpRoute.routes.approveAction, data ?? {}, { title_id, action_id }, params);
+  }
+
+  /** Reject a proposed or approval-needed action. */
+  public static rejectAction<T>(title_id: string, action_id: string, data?: object, params?: Record<string, any>): AxiosPromise<Response<T>> {
+    return Requests.processRoute(McpRoute.routes.rejectAction, data ?? {}, { title_id, action_id }, params);
+  }
+
+  /** Execute an approved action. Public/paid/creator-facing work stays guarded. */
+  public static executeAction<T>(title_id: string, action_id: string, data?: object, params?: Record<string, any>): AxiosPromise<Response<T>> {
+    return Requests.processRoute(McpRoute.routes.executeAction, data ?? {}, { title_id, action_id }, params);
+  }
+
+  /** List open or answered guidance requests for a title or run. */
+  public static listGuidance<T>(title_id: string, params?: Record<string, any>): AxiosPromise<Response<T>> {
+    return Requests.processRoute(McpRoute.routes.listGuidance, {}, { title_id }, params);
+  }
+
+  /** Answer a guidance request and resume the server-side workflow when possible. */
+  public static answerGuidance<T>(title_id: string, guidance_id: string, data?: object, params?: Record<string, any>): AxiosPromise<Response<T>> {
+    return Requests.processRoute(McpRoute.routes.answerGuidance, data ?? {}, { title_id, guidance_id }, params);
+  }
+
+  /** Get instructions for uploading a file (points at uploadFile below). */
+  public static createUpload<T>(title_id: string, data?: object, params?: Record<string, any>): AxiosPromise<Response<T>> {
+    return Requests.processRoute(McpRoute.routes.createUpload, data ?? {}, { title_id }, params);
+  }
+
+  /**
+   * Upload a file (image, video, or document) to a title or run as multipart/form-data.
+   * The facade re-checks the title scope, subscription, and allowed mime types.
+   */
+  public static uploadFile<T>(
+    title_id: string,
+    file: File | Blob,
+    data?: object,
+    params?: Record<string, any>,
+    onUploadProgress?: (progressEvent: AxiosProgressEvent) => void
+  ): AxiosPromise<Response<T>> {
+    const url = McpRoute.routes.uploadFile.url.replace("{title_id}", title_id);
+    return Requests.uploadFile(url, "file", file, data, params, onUploadProgress);
+  }
+
+  /** List MCP title tokens (user JWT only). */
+  public static listTokens<T>(title_id: string, params?: Record<string, any>): AxiosPromise<Response<T>> {
+    return Requests.processRoute(McpRoute.routes.listTokens, {}, { title_id }, params);
+  }
+
+  /** Create a revocable title-scoped MCP token (user JWT only). */
+  public static createToken<T>(title_id: string, data?: object, params?: Record<string, any>): AxiosPromise<Response<T>> {
+    return Requests.processRoute(McpRoute.routes.createToken, data ?? {}, { title_id }, params);
+  }
+
+  /** Revoke a title-scoped MCP token (user JWT only). */
+  public static revokeToken<T>(title_id: string, token_id: string, params?: Record<string, any>): AxiosPromise<Response<T>> {
+    return Requests.processRoute(McpRoute.routes.revokeToken, {}, { title_id, token_id }, params);
+  }
+}
+
+export default Mcp;

package/src/api/Users.ts

@@ -256,6 +256,18 @@ class Users {
         return Requests.processRoute(UserRoutes.routes.clearGoogleAuth, {});
     }
 
+    /**
+     * Clear Gmail Workspace authentication information from the current user.
+     *
+     * @see https://api.glitch.fun/api/documentation#/Users%20Route/clearGmailAuth
+     *
+     * @returns promise
+     */
+    public static clearGmailAuth<T>(): AxiosPromise<Response<T>> {
+
+        return Requests.processRoute(UserRoutes.routes.clearGmailAuth, {});
+    }
+
     /**
      * Clear Stripe authentication information from the current user.
      * 
@@ -699,4 +711,4 @@ class Users {
 
 }
 
-export default Users;
+export default Users;

package/src/api/index.ts

@@ -46,6 +46,7 @@ import Crm from "./Crm";
 import Multiplayer from "./Multiplayer";
 import ServerOperations from "./ServerOperations";
 import Agents from "./Agents";
+import Mcp from "./Mcp";
 import PrDirectory from "./PrDirectory";
 
 export {Ads};
@@ -96,4 +97,5 @@ export {Crm};
 export {Multiplayer};
 export {ServerOperations};
 export {Agents};
+export {Mcp};
 export {PrDirectory};

package/src/index.ts

@@ -50,6 +50,7 @@ import {Crm} from './api';
 import {Multiplayer} from './api';
 import {ServerOperations} from './api';
 import {Agents} from './api';
+import {Mcp} from './api';
 import {PrDirectory} from './api';
 
 import Requests from "./util/Requests";
@@ -130,6 +131,7 @@ class Glitch {
         Multiplayer : Multiplayer,
         ServerOperations : ServerOperations,
         Agents : Agents,
+        Mcp : Mcp,
         PrDirectory : PrDirectory,
     }
 

package/src/models/user.ts

@@ -23,9 +23,18 @@ interface User {
     twitch_handle?: string;
     youtube_handle?: string;
     paetron_handle?: string;
+    gmail_oauth_token?: string;
+    gmail_refresh_token?: string;
+    gmail_token_expiration?: number;
+    gmail_token_expires_at?: string;
+    gmail_id?: string;
+    gmail_name?: string;
+    gmail_email?: string;
+    gmail_avatar?: string;
+    gmail_scopes?: string[];
+    gmail_connected_at?: string;
     created_at?: string;
     updated_at?: string;
   }
 
   export default User;
-  

package/src/routes/AgentsRoute.ts

@@ -25,6 +25,7 @@ class AgentsRoute {
     executeAction: { url: "/agents/titles/{title_id}/actions/{action_id}/execute", method: HTTP_METHODS.POST },
     listGuidance: { url: "/agents/titles/{title_id}/guidance", method: HTTP_METHODS.GET },
     answerGuidance: { url: "/agents/titles/{title_id}/guidance/{guidance_id}/answer", method: HTTP_METHODS.POST },
+    rewriteAgentDraft: { url: "/agents/titles/{title_id}/drafts/rewrite", method: HTTP_METHODS.POST },
     listMemories: { url: "/agents/titles/{title_id}/memories", method: HTTP_METHODS.GET },
     results: { url: "/agents/titles/{title_id}/results", method: HTTP_METHODS.GET },
     usage: { url: "/agents/titles/{title_id}/usage", method: HTTP_METHODS.GET },

package/src/routes/McpRoute.ts

@@ -0,0 +1,38 @@
+import Route from "./interface";
+import HTTP_METHODS from "../constants/HttpMethods";
+
+/**
+ * Glitch MCP paid facade (/mcp/v1).
+ *
+ * Mirrors the routes served by McpAgentController. These endpoints authenticate
+ * with either a Glitch user JWT or a title-scoped MCP token and keep all planner,
+ * billing, and executor logic server-side. The public @glitch/mcp adapter calls
+ * the same endpoints; this SDK surface lets first-party TypeScript clients reuse them.
+ */
+class McpRoute {
+  public static routes: { [key: string]: Route } = {
+    authStatus: { url: "/mcp/v1/auth/status", method: HTTP_METHODS.GET },
+    listTitles: { url: "/mcp/v1/titles", method: HTTP_METHODS.GET },
+    titleContext: { url: "/mcp/v1/titles/{title_id}/context", method: HTTP_METHODS.GET },
+    billing: { url: "/mcp/v1/titles/{title_id}/billing", method: HTTP_METHODS.GET },
+    startRun: { url: "/mcp/v1/titles/{title_id}/runs", method: HTTP_METHODS.POST },
+    viewRun: { url: "/mcp/v1/titles/{title_id}/runs/{run_id}", method: HTTP_METHODS.GET },
+    runEvents: { url: "/mcp/v1/titles/{title_id}/runs/{run_id}/events", method: HTTP_METHODS.GET },
+    streamRun: { url: "/mcp/v1/titles/{title_id}/runs/{run_id}/stream", method: HTTP_METHODS.GET },
+    finalReport: { url: "/mcp/v1/titles/{title_id}/runs/{run_id}/report", method: HTTP_METHODS.GET },
+    artifacts: { url: "/mcp/v1/titles/{title_id}/runs/{run_id}/artifacts", method: HTTP_METHODS.GET },
+    listActions: { url: "/mcp/v1/titles/{title_id}/actions", method: HTTP_METHODS.GET },
+    approveAction: { url: "/mcp/v1/titles/{title_id}/actions/{action_id}/approve", method: HTTP_METHODS.POST },
+    rejectAction: { url: "/mcp/v1/titles/{title_id}/actions/{action_id}/reject", method: HTTP_METHODS.POST },
+    executeAction: { url: "/mcp/v1/titles/{title_id}/actions/{action_id}/execute", method: HTTP_METHODS.POST },
+    listGuidance: { url: "/mcp/v1/titles/{title_id}/guidance", method: HTTP_METHODS.GET },
+    answerGuidance: { url: "/mcp/v1/titles/{title_id}/guidance/{guidance_id}/answer", method: HTTP_METHODS.POST },
+    createUpload: { url: "/mcp/v1/titles/{title_id}/uploads", method: HTTP_METHODS.POST },
+    uploadFile: { url: "/mcp/v1/titles/{title_id}/files", method: HTTP_METHODS.POST },
+    listTokens: { url: "/mcp/v1/titles/{title_id}/tokens", method: HTTP_METHODS.GET },
+    createToken: { url: "/mcp/v1/titles/{title_id}/tokens", method: HTTP_METHODS.POST },
+    revokeToken: { url: "/mcp/v1/titles/{title_id}/tokens/{token_id}", method: HTTP_METHODS.DELETE },
+  };
+}
+
+export default McpRoute;

package/src/routes/UserRoutes.ts

@@ -18,6 +18,7 @@ class UserRoutes {
     clearTwitchAuth: { url: '/users/clearTwitchAuth', method: HTTP_METHODS.DELETE },
     clearFacebookAuth: { url: '/users/clearFacebookAuth', method: HTTP_METHODS.DELETE },
     clearGoogleAuth: { url: '/users/clearGoogleAuth', method: HTTP_METHODS.DELETE },
+    clearGmailAuth: { url: '/users/clearGmailAuth', method: HTTP_METHODS.DELETE },
     clearStripeAuth: { url: '/users/clearStripeAuth', method: HTTP_METHODS.DELETE },
     clearTikTokAuth: { url: '/users/clearTikTokAuth', method: HTTP_METHODS.DELETE },
     clearYoutubeAuth: { url: '/users/clearYoutubeAuth', method: HTTP_METHODS.DELETE },
@@ -75,4 +76,4 @@ class UserRoutes {
 
 }
 
-export default UserRoutes;
+export default UserRoutes;

package/src/util/Requests.ts

@@ -28,6 +28,35 @@ class Requests {
     Requests.community_id = community_id;
   }
 
+  /**
+   * Build an absolute API URL using the currently configured base URL.
+   *
+   * This is useful for browser primitives such as EventSource that need a URL
+   * string instead of an Axios request wrapper.
+   */
+  public static buildUrl(url: string, params?: Record<string, any>): string {
+    let path = url;
+
+    if (params && Object.keys(params).length > 0) {
+      const queryString = Object.entries(params)
+        .filter(([, value]) => value !== undefined && value !== null && value !== '')
+        .map(([key, value]) => {
+          if (Array.isArray(value)) {
+            return value.map((item) => `${key}[]=${encodeURIComponent(item)}`).join('&');
+          }
+          return `${key}=${encodeURIComponent(value)}`;
+        })
+        .filter(Boolean)
+        .join('&');
+
+      if (queryString) {
+        path = `${path}${path.includes('?') ? '&' : '?'}${queryString}`;
+      }
+    }
+
+    return Requests.baseUrl.replace(/\/+$/, '') + '/' + path.replace(/^\/+/, '');
+  }
+
   private static request<T>(
     method: 'GET' | 'POST' | 'PATCH' | 'PUT' | 'DELETE',
     url: string,