glitch-javascript-sdk 3.8.0 → 3.8.2

package/dist/index.d.ts

@@ -6966,6 +6966,155 @@ declare class Media {
     static process<T>(media_id: string, data: VideoProcessRequest): AxiosPromise<Response<T>>;
 }
 
+type DiscordMediaType = 'all' | 'image' | 'video' | 'gif';
+type DiscordMediaAuthorType = 'all' | 'user' | 'bot' | 'webhook';
+interface DiscordMediaSearchParams {
+    cursor?: string;
+    channel_id?: string;
+    search?: string;
+    search_scope?: 'content' | 'filename';
+    media_type?: DiscordMediaType;
+    author_type?: DiscordMediaAuthorType;
+    date_from?: string;
+    date_to?: string;
+    sort_order?: 'asc' | 'desc';
+    include_imported?: boolean;
+    include_unsupported?: boolean;
+    include_nsfw?: boolean;
+}
+interface DiscordMediaAttachment {
+    id: string;
+    filename: string;
+    title?: string | null;
+    description?: string | null;
+    mime_type: string;
+    media_type: 'image' | 'video';
+    size: number;
+    url?: string | null;
+    proxy_url?: string | null;
+    width?: number | null;
+    height?: number | null;
+    duration_secs?: number | null;
+    supported: boolean;
+    unsupported_reason?: string | null;
+    already_imported: boolean;
+    imported_title_update_id?: string | null;
+    imported_media_id?: string | null;
+    duplicate_import: boolean;
+}
+interface DiscordMediaMessage {
+    id: string;
+    channel_id: string;
+    content: string;
+    timestamp?: string | null;
+    edited_timestamp?: string | null;
+    jump_url: string;
+    author: {
+        id?: string | null;
+        username: string;
+        avatar?: string | null;
+        bot: boolean;
+    };
+    webhook_id?: string | null;
+    attachments: DiscordMediaAttachment[];
+}
+interface DiscordMediaSearchResponse {
+    items: DiscordMediaMessage[];
+    total_results: number;
+    next_cursor?: string | null;
+    indexing: boolean;
+    retry_after?: number | null;
+}
+interface DiscordMediaImportGroup {
+    channel_id: string;
+    message_id: string;
+    attachment_ids: string[];
+}
+interface DiscordMediaImportRequest {
+    groups: DiscordMediaImportGroup[];
+}
+interface DiscordMediaImportAttachmentResult {
+    status: 'imported' | 'duplicate' | 'failed';
+    channel_id: string;
+    message_id: string;
+    attachment_id: string;
+    media_id?: string;
+    title_update_id?: string;
+    reason?: string;
+}
+interface DiscordMediaImportResponse {
+    imported_count: number;
+    duplicate_count: number;
+    failed_count: number;
+    updates: Array<{
+        id: string;
+        title?: string | null;
+        scheduled_status: 'pending';
+        schedule_for_social: false;
+        media_count: number;
+    }>;
+    attachments: DiscordMediaImportAttachmentResult[];
+}
+interface DiscordUserCommandStatus {
+    linked: boolean;
+    linked_to_this_scheduler: boolean;
+    discord_username?: string | null;
+    destination_scheduler_id?: string | null;
+    destination_scheduler_name?: string | null;
+    installed_at?: string | null;
+    pending_count: number;
+    command_name: string;
+    setup_path: string;
+    configured: boolean;
+}
+type DiscordMediaCaptureStatus = 'processing' | 'ready' | 'complete' | 'failed' | 'expired';
+type DiscordMediaCaptureAttachmentStatus = 'processing' | 'ready' | 'duplicate' | 'unsupported' | 'failed' | 'imported';
+interface DiscordMediaCaptureAttachment {
+    id: string;
+    discord_attachment_id: string;
+    filename: string;
+    mime_type?: string | null;
+    media_type: 'image' | 'video';
+    size: number;
+    width?: number | null;
+    height?: number | null;
+    duration_secs?: number | null;
+    description?: string | null;
+    status: DiscordMediaCaptureAttachmentStatus;
+    failure_reason?: string | null;
+    preview_url?: string | null;
+    media_id?: string | null;
+    title_update_id?: string | null;
+}
+interface DiscordMediaCapture {
+    id: string;
+    status: DiscordMediaCaptureStatus;
+    content?: string | null;
+    author?: {
+        id?: string | null;
+        username: string;
+        avatar?: string | null;
+        bot: boolean;
+    } | null;
+    timestamp?: string | null;
+    jump_url?: string | null;
+    expires_at: string;
+    failure_reason?: string | null;
+    attachments: DiscordMediaCaptureAttachment[];
+}
+interface DiscordMediaCaptureListParams {
+    cursor?: string;
+    search?: string;
+    limit?: number;
+}
+interface DiscordMediaCaptureListResponse {
+    items: DiscordMediaCapture[];
+    next_cursor?: string | null;
+}
+interface DiscordMediaCaptureImportRequest {
+    capture_id: string;
+    attachment_ids: string[];
+}
 declare class Scheduler {
     /**
      * List promotion schedules.
@@ -7276,6 +7425,27 @@ declare class Scheduler {
     * @returns promise
     */
     static getDiscordChannels<T>(scheduler_id: string, params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /**
+     * Search image and video attachments in the connected Discord server.
+     * This call only returns remote candidates; it does not copy files into the
+     * Library and does not create or schedule social posts.
+     */
+    static searchDiscordMedia<T = DiscordMediaSearchResponse>(scheduler_id: string, params?: DiscordMediaSearchParams): AxiosPromise<Response<T>>;
+    /**
+     * Import explicitly selected Discord attachments as pending, unscheduled
+     * Library updates. Attachments selected from one message stay grouped.
+     */
+    static importDiscordMedia<T = DiscordMediaImportResponse>(scheduler_id: string, data: DiscordMediaImportRequest, params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /** Get the current user's personal Save to Glitch command setup state. */
+    static getDiscordUserCommandStatus<T = DiscordUserCommandStatus>(scheduler_id: string, params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /** Disconnect the current user's personal command from this Library. */
+    static disconnectDiscordUserCommand<T>(scheduler_id: string, params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /** List messages saved through the user-installed Discord command. */
+    static listDiscordMediaCaptures<T = DiscordMediaCaptureListResponse>(scheduler_id: string, params?: DiscordMediaCaptureListParams): AxiosPromise<Response<T>>;
+    /** Import selected staged attachments into pending Library content. */
+    static importDiscordMediaCapture<T = DiscordMediaImportResponse>(scheduler_id: string, data: DiscordMediaCaptureImportRequest, params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /** Dismiss one saved Discord message and delete its temporary staged files. */
+    static dismissDiscordMediaCapture<T>(scheduler_id: string, capture_id: string, params?: Record<string, any>): AxiosPromise<Response<T>>;
     /**
      * Clear Google Ads OAuth credentials from a promotion schedule.
      *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "glitch-javascript-sdk",
-  "version": "3.8.0",
+  "version": "3.8.2",
   "description": "Javascript SDK for Glitch",
   "publishConfig": {
     "access": "public"
@@ -13,7 +13,7 @@
   ],
   "types": "dist/index.d.ts",
   "scripts": {
-    "test": "node scripts/test-game-advertising-routes.cjs",
+    "test": "node scripts/test-game-advertising-routes.cjs && node scripts/test-discord-media-routes.cjs",
     "build": "rm -Rf dist && rollup -c --bundleConfigAsCjs",
     "build-docs": "rm  -rf docs && typedoc  --tsconfig tsconfig.json src/"
   },

package/src/api/Scheduler.ts

@@ -3,6 +3,171 @@ import Requests from "../util/Requests";
 import Response from "../util/Response";
 import { AxiosPromise } from "axios";
 
+export type DiscordMediaType = 'all' | 'image' | 'video' | 'gif';
+export type DiscordMediaAuthorType = 'all' | 'user' | 'bot' | 'webhook';
+
+export interface DiscordMediaSearchParams {
+    cursor?: string;
+    channel_id?: string;
+    search?: string;
+    search_scope?: 'content' | 'filename';
+    media_type?: DiscordMediaType;
+    author_type?: DiscordMediaAuthorType;
+    date_from?: string;
+    date_to?: string;
+    sort_order?: 'asc' | 'desc';
+    include_imported?: boolean;
+    include_unsupported?: boolean;
+    include_nsfw?: boolean;
+}
+
+export interface DiscordMediaAttachment {
+    id: string;
+    filename: string;
+    title?: string | null;
+    description?: string | null;
+    mime_type: string;
+    media_type: 'image' | 'video';
+    size: number;
+    url?: string | null;
+    proxy_url?: string | null;
+    width?: number | null;
+    height?: number | null;
+    duration_secs?: number | null;
+    supported: boolean;
+    unsupported_reason?: string | null;
+    already_imported: boolean;
+    imported_title_update_id?: string | null;
+    imported_media_id?: string | null;
+    duplicate_import: boolean;
+}
+
+export interface DiscordMediaMessage {
+    id: string;
+    channel_id: string;
+    content: string;
+    timestamp?: string | null;
+    edited_timestamp?: string | null;
+    jump_url: string;
+    author: {
+        id?: string | null;
+        username: string;
+        avatar?: string | null;
+        bot: boolean;
+    };
+    webhook_id?: string | null;
+    attachments: DiscordMediaAttachment[];
+}
+
+export interface DiscordMediaSearchResponse {
+    items: DiscordMediaMessage[];
+    total_results: number;
+    next_cursor?: string | null;
+    indexing: boolean;
+    retry_after?: number | null;
+}
+
+export interface DiscordMediaImportGroup {
+    channel_id: string;
+    message_id: string;
+    attachment_ids: string[];
+}
+
+export interface DiscordMediaImportRequest {
+    groups: DiscordMediaImportGroup[];
+}
+
+export interface DiscordMediaImportAttachmentResult {
+    status: 'imported' | 'duplicate' | 'failed';
+    channel_id: string;
+    message_id: string;
+    attachment_id: string;
+    media_id?: string;
+    title_update_id?: string;
+    reason?: string;
+}
+
+export interface DiscordMediaImportResponse {
+    imported_count: number;
+    duplicate_count: number;
+    failed_count: number;
+    updates: Array<{
+        id: string;
+        title?: string | null;
+        scheduled_status: 'pending';
+        schedule_for_social: false;
+        media_count: number;
+    }>;
+    attachments: DiscordMediaImportAttachmentResult[];
+}
+
+export interface DiscordUserCommandStatus {
+    linked: boolean;
+    linked_to_this_scheduler: boolean;
+    discord_username?: string | null;
+    destination_scheduler_id?: string | null;
+    destination_scheduler_name?: string | null;
+    installed_at?: string | null;
+    pending_count: number;
+    command_name: string;
+    setup_path: string;
+    configured: boolean;
+}
+
+export type DiscordMediaCaptureStatus = 'processing' | 'ready' | 'complete' | 'failed' | 'expired';
+export type DiscordMediaCaptureAttachmentStatus = 'processing' | 'ready' | 'duplicate' | 'unsupported' | 'failed' | 'imported';
+
+export interface DiscordMediaCaptureAttachment {
+    id: string;
+    discord_attachment_id: string;
+    filename: string;
+    mime_type?: string | null;
+    media_type: 'image' | 'video';
+    size: number;
+    width?: number | null;
+    height?: number | null;
+    duration_secs?: number | null;
+    description?: string | null;
+    status: DiscordMediaCaptureAttachmentStatus;
+    failure_reason?: string | null;
+    preview_url?: string | null;
+    media_id?: string | null;
+    title_update_id?: string | null;
+}
+
+export interface DiscordMediaCapture {
+    id: string;
+    status: DiscordMediaCaptureStatus;
+    content?: string | null;
+    author?: {
+        id?: string | null;
+        username: string;
+        avatar?: string | null;
+        bot: boolean;
+    } | null;
+    timestamp?: string | null;
+    jump_url?: string | null;
+    expires_at: string;
+    failure_reason?: string | null;
+    attachments: DiscordMediaCaptureAttachment[];
+}
+
+export interface DiscordMediaCaptureListParams {
+    cursor?: string;
+    search?: string;
+    limit?: number;
+}
+
+export interface DiscordMediaCaptureListResponse {
+    items: DiscordMediaCapture[];
+    next_cursor?: string | null;
+}
+
+export interface DiscordMediaCaptureImportRequest {
+    capture_id: string;
+    attachment_ids: string[];
+}
+
 class Scheduler {
     /**
      * List promotion schedules.
@@ -431,6 +596,72 @@ class Scheduler {
         return Requests.processRoute(SchedulerRoute.routes.getDiscordChannels, {}, { scheduler_id }, params);
     }
 
+    /**
+     * Search image and video attachments in the connected Discord server.
+     * This call only returns remote candidates; it does not copy files into the
+     * Library and does not create or schedule social posts.
+     */
+    public static searchDiscordMedia<T = DiscordMediaSearchResponse>(
+        scheduler_id: string,
+        params?: DiscordMediaSearchParams
+    ): AxiosPromise<Response<T>> {
+        return Requests.processRoute(SchedulerRoute.routes.searchDiscordMedia, {}, { scheduler_id }, params);
+    }
+
+    /**
+     * Import explicitly selected Discord attachments as pending, unscheduled
+     * Library updates. Attachments selected from one message stay grouped.
+     */
+    public static importDiscordMedia<T = DiscordMediaImportResponse>(
+        scheduler_id: string,
+        data: DiscordMediaImportRequest,
+        params?: Record<string, any>
+    ): AxiosPromise<Response<T>> {
+        return Requests.processRoute(SchedulerRoute.routes.importDiscordMedia, data, { scheduler_id }, params);
+    }
+
+    /** Get the current user's personal Save to Glitch command setup state. */
+    public static getDiscordUserCommandStatus<T = DiscordUserCommandStatus>(
+        scheduler_id: string,
+        params?: Record<string, any>
+    ): AxiosPromise<Response<T>> {
+        return Requests.processRoute(SchedulerRoute.routes.getDiscordUserCommandStatus, {}, { scheduler_id }, params);
+    }
+
+    /** Disconnect the current user's personal command from this Library. */
+    public static disconnectDiscordUserCommand<T>(
+        scheduler_id: string,
+        params?: Record<string, any>
+    ): AxiosPromise<Response<T>> {
+        return Requests.processRoute(SchedulerRoute.routes.disconnectDiscordUserCommand, {}, { scheduler_id }, params);
+    }
+
+    /** List messages saved through the user-installed Discord command. */
+    public static listDiscordMediaCaptures<T = DiscordMediaCaptureListResponse>(
+        scheduler_id: string,
+        params?: DiscordMediaCaptureListParams
+    ): AxiosPromise<Response<T>> {
+        return Requests.processRoute(SchedulerRoute.routes.listDiscordMediaCaptures, {}, { scheduler_id }, params);
+    }
+
+    /** Import selected staged attachments into pending Library content. */
+    public static importDiscordMediaCapture<T = DiscordMediaImportResponse>(
+        scheduler_id: string,
+        data: DiscordMediaCaptureImportRequest,
+        params?: Record<string, any>
+    ): AxiosPromise<Response<T>> {
+        return Requests.processRoute(SchedulerRoute.routes.importDiscordMediaCapture, data, { scheduler_id }, params);
+    }
+
+    /** Dismiss one saved Discord message and delete its temporary staged files. */
+    public static dismissDiscordMediaCapture<T>(
+        scheduler_id: string,
+        capture_id: string,
+        params?: Record<string, any>
+    ): AxiosPromise<Response<T>> {
+        return Requests.processRoute(SchedulerRoute.routes.dismissDiscordMediaCapture, {}, { scheduler_id, capture_id }, params);
+    }
+
     /**
      * Clear Google Ads OAuth credentials from a promotion schedule.
      *

package/src/routes/SchedulerRoute.ts

@@ -50,6 +50,13 @@ class SchedulerRoute {
         getRedditSubredditFlairs: { url: '/schedulers/{scheduler_id}/reddit/subreddits/{subreddit}/flairs', method: HTTP_METHODS.GET },
         getRedditSubredditRules: { url: '/schedulers/{scheduler_id}/reddit/subreddits/{subreddit}/rules', method: HTTP_METHODS.GET },
         getDiscordChannels: { url: '/schedulers/{scheduler_id}/discord/channels', method: HTTP_METHODS.GET },
+        searchDiscordMedia: { url: '/schedulers/{scheduler_id}/discord/media', method: HTTP_METHODS.GET },
+        importDiscordMedia: { url: '/schedulers/{scheduler_id}/discord/media/import', method: HTTP_METHODS.POST },
+        getDiscordUserCommandStatus: { url: '/schedulers/{scheduler_id}/discord/user-command', method: HTTP_METHODS.GET },
+        disconnectDiscordUserCommand: { url: '/schedulers/{scheduler_id}/discord/user-command', method: HTTP_METHODS.DELETE },
+        listDiscordMediaCaptures: { url: '/schedulers/{scheduler_id}/discord/captures', method: HTTP_METHODS.GET },
+        importDiscordMediaCapture: { url: '/schedulers/{scheduler_id}/discord/captures/import', method: HTTP_METHODS.POST },
+        dismissDiscordMediaCapture: { url: '/schedulers/{scheduler_id}/discord/captures/{capture_id}', method: HTTP_METHODS.DELETE },
 
         crossPromoteListRelationships: {
             url: '/schedulers/{scheduler_id}/crosspromote/relationships',