glitch-javascript-sdk 2.5.0 → 2.5.1

package/dist/index.d.ts

@@ -6963,92 +6963,98 @@ declare class TwitchReporting {
 
 declare class Raffles {
     /**
-     * List all raffles.
-     * @param params Filter by title_id, community_id, or status.
+     * List all raffles with optional filters.
      */
     static list<T>(params?: Record<string, any>): AxiosPromise<Response<T>>;
     /**
-     * Create a new raffle for a specific title.
+     * Create a new raffle (Game Owner).
      */
     static create<T>(data: object): AxiosPromise<Response<T>>;
     /**
-     * Get full details of a raffle.
+     * Retrieve details for a specific raffle.
      */
-    static view<T>(raffle_id: string): AxiosPromise<Response<T>>;
+    static view<T>(id: string): AxiosPromise<Response<T>>;
     /**
-     * Update raffle settings (Draft/Active status, dates, etc).
+     * Enter a raffle (User/Player). Requires Steam ID.
      */
-    static update<T>(raffle_id: string, data: object): AxiosPromise<Response<T>>;
+    static enter<T>(id: string, data: {
+        referral_code?: string;
+        device_fingerprint?: string;
+        opt_in_playtesting?: boolean;
+    }): AxiosPromise<Response<T>>;
     /**
-     * Delete a raffle.
+     * Get the authenticated user's entry status for a specific raffle.
      */
-    static delete<T>(raffle_id: string): AxiosPromise<Response<T>>;
+    static me<T>(id: string): AxiosPromise<Response<T>>;
     /**
-     * Enter the authenticated user into the raffle.
-     * @param data { referral_code?, device_fingerprint? }
+     * Record a viral action (e.g., Steam Wishlist, Social Share).
      */
-    static enter<T>(raffle_id: string, data?: object): AxiosPromise<Response<T>>;
+    static performAction<T>(id: string, data: {
+        action_type: string;
+        platform?: string;
+        reference_id?: string;
+    }): AxiosPromise<Response<T>>;
     /**
-     * Record a viral action (Steam Wishlist, Social Share) to earn more tickets.
-     * @param data { action_type: 'steam_wishlist'|'social_share', platform?, reference_id? }
+     * Post raffle content to social media via Glitch API.
      */
-    static performAction<T>(raffle_id: string, data: object): AxiosPromise<Response<T>>;
+    static shareSocially<T>(id: string, data: {
+        platform: string;
+        content: string;
+    }): AxiosPromise<Response<T>>;
     /**
-     * Get the authenticated user's specific entry status for this raffle.
+     * Send an invitation email to a friend.
      */
-    static me<T>(raffle_id: string): AxiosPromise<Response<T>>;
+    static inviteFriend<T>(id: string, data: {
+        email: string;
+    }): AxiosPromise<Response<T>>;
     /**
-     * Submit shipping address for a winning entry.
-     * @param entry_id The UUID of the RaffleEntry.
+     * Add a prize tier to a raffle (Game Owner).
      */
-    static updateAddress<T>(entry_id: string, data: object): AxiosPromise<Response<T>>;
+    static addPrize<T>(id: string, data: object): AxiosPromise<Response<T>>;
     /**
-     * Invite a friend via email to join the raffle.
+     * Trigger the automated drawing process (Game Owner).
      */
-    static inviteFriend<T>(raffle_id: string, data: {
-        email: string;
-    }): AxiosPromise<Response<T>>;
+    static drawWinners<T>(id: string): AxiosPromise<Response<T>>;
     /**
-     * Get the public list of winners (only available if raffle is completed).
+     * Manually select a winner for a specific prize (Live Event Mode).
      */
-    static winners<T>(raffle_id: string): AxiosPromise<Response<T>>;
+    static pickWinner<T>(id: string, data: {
+        entry_id: string;
+        prize_id: string;
+    }): AxiosPromise<Response<T>>;
     /**
-     * Add a prize tier (quantity, value, description) to the raffle.
+     * Get the public list of winners for a completed raffle.
      */
-    static addPrize<T>(raffle_id: string, data: object): AxiosPromise<Response<T>>;
+    static winners<T>(id: string): AxiosPromise<Response<T>>;
     /**
-     * Randomly draw winners for all prize tiers based on ticket weights.
+     * List all participants/entries for a raffle (Game Owner).
      */
-    static drawWinners<T>(raffle_id: string): AxiosPromise<Response<T>>;
+    static participants<T>(id: string, params?: Record<string, any>): AxiosPromise<Response<T>>;
     /**
-     * Manually assign a specific user to a specific prize (Live Event Mode).
-     * @param data { entry_id, prize_id }
+     * Update shipping/tracking info for a prize (Game Owner).
      */
-    static pickWinner<T>(raffle_id: string, data: object): AxiosPromise<Response<T>>;
+    static fulfillPrize<T>(entry_id: string, data: {
+        tracking_number: string;
+        shipping_carrier: string;
+    }): AxiosPromise<Response<T>>;
     /**
-     * Provide shipping/tracking info for a prize fulfillment.
-     * @param entry_id The UUID of the RaffleEntry.
+     * Submit shipping address for a won prize (User/Winner).
      */
-    static fulfillPrize<T>(entry_id: string, data: object): AxiosPromise<Response<T>>;
+    static updateAddress<T>(entry_id: string, data: object): AxiosPromise<Response<T>>;
     /**
-     * Disqualify an entry for fraud or rule violations.
+     * Disqualify a specific entry (Game Owner).
      */
-    static disqualify<T>(raffle_id: string, entry_id: string, data: {
+    static disqualify<T>(id: string, entry_id: string, data: {
         reason: string;
     }): AxiosPromise<Response<T>>;
-    /**
-     * List all participants/entries for management.
-     * @param params { opt_in_playtesting?, page?, per_page? }
-     */
-    static listParticipants<T>(raffle_id: string, params?: Record<string, any>): AxiosPromise<Response<T>>;
     /**
      * Check if the raffle is fully funded in the community ledger.
      */
-    static escrowStatus<T>(raffle_id: string): AxiosPromise<Response<T>>;
+    static escrowStatus<T>(id: string): AxiosPromise<Response<T>>;
     /**
-     * Get viral loop analytics (K-factor, Cost Per Entry).
+     * Get viral loop analytics (K-Factor, Cost Per Entry).
      */
-    static analytics<T>(raffle_id: string): AxiosPromise<Response<T>>;
+    static analytics<T>(id: string): AxiosPromise<Response<T>>;
 }
 
 interface Route {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "glitch-javascript-sdk",
-  "version": "2.5.0",
+  "version": "2.5.1",
   "description": "Javascript SDK for Glitch",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",

package/src/api/Raffles.ts

@@ -4,145 +4,130 @@ import Response from "../util/Response";
 import { AxiosPromise } from "axios";
 
 class Raffles {
-
     /**
-     * List all raffles.
-     * @param params Filter by title_id, community_id, or status.
+     * List all raffles with optional filters.
      */
     public static list<T>(params?: Record<string, any>): AxiosPromise<Response<T>> {
         return Requests.processRoute(RafflesRoute.routes.list, undefined, undefined, params);
     }
 
     /**
-     * Create a new raffle for a specific title.
+     * Create a new raffle (Game Owner).
      */
     public static create<T>(data: object): AxiosPromise<Response<T>> {
         return Requests.processRoute(RafflesRoute.routes.create, data);
     }
 
     /**
-     * Get full details of a raffle.
+     * Retrieve details for a specific raffle.
      */
-    public static view<T>(raffle_id: string): AxiosPromise<Response<T>> {
-        return Requests.processRoute(RafflesRoute.routes.view, {}, { raffle_id });
+    public static view<T>(id: string): AxiosPromise<Response<T>> {
+        return Requests.processRoute(RafflesRoute.routes.view, {}, { id });
     }
 
     /**
-     * Update raffle settings (Draft/Active status, dates, etc).
+     * Enter a raffle (User/Player). Requires Steam ID.
      */
-    public static update<T>(raffle_id: string, data: object): AxiosPromise<Response<T>> {
-        return Requests.processRoute(RafflesRoute.routes.update, data, { raffle_id });
+    public static enter<T>(id: string, data: { referral_code?: string, device_fingerprint?: string, opt_in_playtesting?: boolean }): AxiosPromise<Response<T>> {
+        return Requests.processRoute(RafflesRoute.routes.enter, data, { id });
     }
 
     /**
-     * Delete a raffle.
+     * Get the authenticated user's entry status for a specific raffle.
      */
-    public static delete<T>(raffle_id: string): AxiosPromise<Response<T>> {
-        return Requests.processRoute(RafflesRoute.routes.delete, {}, { raffle_id });
+    public static me<T>(id: string): AxiosPromise<Response<T>> {
+        return Requests.processRoute(RafflesRoute.routes.me, {}, { id });
     }
 
     /**
-     * Enter the authenticated user into the raffle.
-     * @param data { referral_code?, device_fingerprint? }
+     * Record a viral action (e.g., Steam Wishlist, Social Share).
      */
-    public static enter<T>(raffle_id: string, data?: object): AxiosPromise<Response<T>> {
-        return Requests.processRoute(RafflesRoute.routes.enter, data, { raffle_id });
+    public static performAction<T>(id: string, data: { action_type: string, platform?: string, reference_id?: string }): AxiosPromise<Response<T>> {
+        return Requests.processRoute(RafflesRoute.routes.performAction, data, { id });
     }
 
     /**
-     * Record a viral action (Steam Wishlist, Social Share) to earn more tickets.
-     * @param data { action_type: 'steam_wishlist'|'social_share', platform?, reference_id? }
+     * Post raffle content to social media via Glitch API.
      */
-    public static performAction<T>(raffle_id: string, data: object): AxiosPromise<Response<T>> {
-        return Requests.processRoute(RafflesRoute.routes.performAction, data, { raffle_id });
+    public static shareSocially<T>(id: string, data: { platform: string, content: string }): AxiosPromise<Response<T>> {
+        return Requests.processRoute(RafflesRoute.routes.shareSocially, data, { id });
     }
 
     /**
-     * Get the authenticated user's specific entry status for this raffle.
+     * Send an invitation email to a friend.
      */
-    public static me<T>(raffle_id: string): AxiosPromise<Response<T>> {
-        return Requests.processRoute(RafflesRoute.routes.me, {}, { raffle_id });
+    public static inviteFriend<T>(id: string, data: { email: string }): AxiosPromise<Response<T>> {
+        return Requests.processRoute(RafflesRoute.routes.inviteFriend, data, { id });
     }
 
     /**
-     * Submit shipping address for a winning entry.
-     * @param entry_id The UUID of the RaffleEntry.
+     * Add a prize tier to a raffle (Game Owner).
      */
-    public static updateAddress<T>(entry_id: string, data: object): AxiosPromise<Response<T>> {
-        return Requests.processRoute(RafflesRoute.routes.updateAddress, data, { entry_id });
+    public static addPrize<T>(id: string, data: object): AxiosPromise<Response<T>> {
+        return Requests.processRoute(RafflesRoute.routes.addPrize, data, { id });
     }
 
     /**
-     * Invite a friend via email to join the raffle.
+     * Trigger the automated drawing process (Game Owner).
      */
-    public static inviteFriend<T>(raffle_id: string, data: { email: string }): AxiosPromise<Response<T>> {
-        return Requests.processRoute(RafflesRoute.routes.inviteFriend, data, { raffle_id });
+    public static drawWinners<T>(id: string): AxiosPromise<Response<T>> {
+        return Requests.processRoute(RafflesRoute.routes.drawWinners, {}, { id });
     }
 
     /**
-     * Get the public list of winners (only available if raffle is completed).
+     * Manually select a winner for a specific prize (Live Event Mode).
      */
-    public static winners<T>(raffle_id: string): AxiosPromise<Response<T>> {
-        return Requests.processRoute(RafflesRoute.routes.winners, {}, { raffle_id });
+    public static pickWinner<T>(id: string, data: { entry_id: string, prize_id: string }): AxiosPromise<Response<T>> {
+        return Requests.processRoute(RafflesRoute.routes.pickWinner, data, { id });
     }
 
     /**
-     * Add a prize tier (quantity, value, description) to the raffle.
+     * Get the public list of winners for a completed raffle.
      */
-    public static addPrize<T>(raffle_id: string, data: object): AxiosPromise<Response<T>> {
-        return Requests.processRoute(RafflesRoute.routes.addPrize, data, { raffle_id });
+    public static winners<T>(id: string): AxiosPromise<Response<T>> {
+        return Requests.processRoute(RafflesRoute.routes.winners, {}, { id });
     }
 
     /**
-     * Randomly draw winners for all prize tiers based on ticket weights.
+     * List all participants/entries for a raffle (Game Owner).
      */
-    public static drawWinners<T>(raffle_id: string): AxiosPromise<Response<T>> {
-        return Requests.processRoute(RafflesRoute.routes.drawWinners, {}, { raffle_id });
+    public static participants<T>(id: string, params?: Record<string, any>): AxiosPromise<Response<T>> {
+        return Requests.processRoute(RafflesRoute.routes.participants, {}, { id }, params);
     }
 
     /**
-     * Manually assign a specific user to a specific prize (Live Event Mode).
-     * @param data { entry_id, prize_id }
+     * Update shipping/tracking info for a prize (Game Owner).
      */
-    public static pickWinner<T>(raffle_id: string, data: object): AxiosPromise<Response<T>> {
-        return Requests.processRoute(RafflesRoute.routes.pickWinner, data, { raffle_id });
-    }
-
-    /**
-     * Provide shipping/tracking info for a prize fulfillment.
-     * @param entry_id The UUID of the RaffleEntry.
-     */
-    public static fulfillPrize<T>(entry_id: string, data: object): AxiosPromise<Response<T>> {
+    public static fulfillPrize<T>(entry_id: string, data: { tracking_number: string, shipping_carrier: string }): AxiosPromise<Response<T>> {
         return Requests.processRoute(RafflesRoute.routes.fulfillPrize, data, { entry_id });
     }
 
     /**
-     * Disqualify an entry for fraud or rule violations.
+     * Submit shipping address for a won prize (User/Winner).
      */
-    public static disqualify<T>(raffle_id: string, entry_id: string, data: { reason: string }): AxiosPromise<Response<T>> {
-        return Requests.processRoute(RafflesRoute.routes.disqualify, data, { raffle_id, entry_id });
+    public static updateAddress<T>(entry_id: string, data: object): AxiosPromise<Response<T>> {
+        return Requests.processRoute(RafflesRoute.routes.updateAddress, data, { entry_id });
     }
 
     /**
-     * List all participants/entries for management.
-     * @param params { opt_in_playtesting?, page?, per_page? }
+     * Disqualify a specific entry (Game Owner).
      */
-    public static listParticipants<T>(raffle_id: string, params?: Record<string, any>): AxiosPromise<Response<T>> {
-        return Requests.processRoute(RafflesRoute.routes.participants, {}, { raffle_id }, params);
+    public static disqualify<T>(id: string, entry_id: string, data: { reason: string }): AxiosPromise<Response<T>> {
+        return Requests.processRoute(RafflesRoute.routes.disqualify, data, { id, entry_id });
     }
 
     /**
      * Check if the raffle is fully funded in the community ledger.
      */
-    public static escrowStatus<T>(raffle_id: string): AxiosPromise<Response<T>> {
-        return Requests.processRoute(RafflesRoute.routes.escrowStatus, {}, { raffle_id });
+    public static escrowStatus<T>(id: string): AxiosPromise<Response<T>> {
+        return Requests.processRoute(RafflesRoute.routes.escrowStatus, {}, { id });
     }
 
     /**
-     * Get viral loop analytics (K-factor, Cost Per Entry).
+     * Get viral loop analytics (K-Factor, Cost Per Entry).
      */
-    public static analytics<T>(raffle_id: string): AxiosPromise<Response<T>> {
-        return Requests.processRoute(RafflesRoute.routes.analytics, {}, { raffle_id });
+    public static analytics<T>(id: string): AxiosPromise<Response<T>> {
+        return Requests.processRoute(RafflesRoute.routes.analytics, {}, { id });
     }
 }
 

package/src/routes/RafflesRoute.ts

@@ -2,34 +2,34 @@ import Route from "./interface";
 import HTTP_METHODS from "../constants/HttpMethods";
 
 class RafflesRoute {
-
-  public static routes: { [key: string]: Route } = {
-    // CRUD
-    list: { url: '/raffles', method: HTTP_METHODS.GET },
-    create: { url: '/raffles', method: HTTP_METHODS.POST },
-    view: { url: '/raffles/{raffle_id}', method: HTTP_METHODS.GET },
-    update: { url: '/raffles/{raffle_id}', method: HTTP_METHODS.PUT },
-    delete: { url: '/raffles/{raffle_id}', method: HTTP_METHODS.DELETE },
-
-    // User/Player Actions
-    enter: { url: '/raffles/{raffle_id}/enter', method: HTTP_METHODS.POST },
-    performAction: { url: '/raffles/{raffle_id}/actions', method: HTTP_METHODS.POST },
-    me: { url: '/raffles/{raffle_id}/me', method: HTTP_METHODS.GET },
-    updateAddress: { url: '/raffles/entries/{entry_id}/address', method: HTTP_METHODS.PUT },
-    inviteFriend: { url: '/raffles/{raffle_id}/invite-friend', method: HTTP_METHODS.POST },
-    winners: { url: '/raffles/{raffle_id}/winners', method: HTTP_METHODS.GET },
-
-    // Admin/Developer Actions
-    addPrize: { url: '/raffles/{raffle_id}/prizes', method: HTTP_METHODS.POST },
-    drawWinners: { url: '/raffles/{raffle_id}/draw', method: HTTP_METHODS.POST },
-    pickWinner: { url: '/raffles/{raffle_id}/pick-winner', method: HTTP_METHODS.POST },
-    fulfillPrize: { url: '/raffles/entries/{entry_id}/fulfill', method: HTTP_METHODS.PUT },
-    disqualify: { url: '/raffles/{raffle_id}/disqualify/{entry_id}', method: HTTP_METHODS.POST },
-    participants: { url: '/raffles/{raffle_id}/participants', method: HTTP_METHODS.GET },
-    escrowStatus: { url: '/raffles/{raffle_id}/escrow', method: HTTP_METHODS.GET },
-    analytics: { url: '/raffles/{raffle_id}/analytics', method: HTTP_METHODS.GET },
-  };
-
+    public static routes: { [key: string]: Route } = {
+        list: { url: '/raffles', method: HTTP_METHODS.GET },
+        create: { url: '/raffles', method: HTTP_METHODS.POST },
+        view: { url: '/raffles/{id}', method: HTTP_METHODS.GET },
+        enter: { url: '/raffles/{id}/enter', method: HTTP_METHODS.POST },
+        me: { url: '/raffles/{id}/me', method: HTTP_METHODS.GET },
+        performAction: { url: '/raffles/{id}/actions', method: HTTP_METHODS.POST },
+        shareSocially: { url: '/raffles/{id}/share', method: HTTP_METHODS.POST },
+        inviteFriend: { url: '/raffles/{id}/invite-friend', method: HTTP_METHODS.POST },
+        
+        // Prize Management
+        addPrize: { url: '/raffles/{id}/prizes', method: HTTP_METHODS.POST },
+        
+        // Drawing & Winners
+        drawWinners: { url: '/raffles/{id}/draw', method: HTTP_METHODS.POST },
+        pickWinner: { url: '/raffles/{id}/pick-winner', method: HTTP_METHODS.POST },
+        winners: { url: '/raffles/{id}/winners', method: HTTP_METHODS.GET },
+        
+        // Participant & Fulfillment Management
+        participants: { url: '/raffles/{id}/participants', method: HTTP_METHODS.GET },
+        fulfillPrize: { url: '/raffles/entries/{entry_id}/fulfill', method: HTTP_METHODS.PUT },
+        updateAddress: { url: '/raffles/entries/{entry_id}/address', method: HTTP_METHODS.PUT },
+        disqualify: { url: '/raffles/{id}/disqualify/{entry_id}', method: HTTP_METHODS.POST },
+        
+        // Analytics & Finance
+        escrowStatus: { url: '/raffles/{id}/escrow', method: HTTP_METHODS.GET },
+        analytics: { url: '/raffles/{id}/analytics', method: HTTP_METHODS.GET },
+    };
 }
 
 export default RafflesRoute;